WHCandCursor
e853abac5e
Login claims the chair, writes a session ticket, and starts a background service for discovery plus revision-based context sync. Password Realm opens require --login (or CST_REALM_PASSWORD); --service/--service-stop manage the resident agent. Co-authored-by: Cursor <cursoragent@cursor.com>
74 lines
2.8 KiB
C
74 lines
2.8 KiB
C
#ifndef CST_PARLIAMENT_H
|
|
#define CST_PARLIAMENT_H
|
|
|
|
#include "cst_realm.h"
|
|
|
|
#include <stddef.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/* Parliament is one shared whole across agents. Password unlock claims the
|
|
* single chair on the logging-in device; peers sync the same context. A new
|
|
* project replaces all parliament context. */
|
|
|
|
typedef struct {
|
|
char parliament_id[64];
|
|
char project_id[64];
|
|
char chair_instance[64];
|
|
char chair_device[128];
|
|
unsigned long revision;
|
|
char status[32]; /* idle | open | dissolved */
|
|
} cst_parliament_meta_t;
|
|
|
|
int cst_parliament_path(char *out, size_t n);
|
|
int cst_parliament_load(cst_parliament_meta_t *m);
|
|
int cst_parliament_save(const cst_parliament_meta_t *m);
|
|
|
|
/* Login: unlock Realm with password, enroll/ensure instance, claim chair,
|
|
* return handover summary (malloc'd) or NULL. */
|
|
char *cst_parliament_login(const char *password, const char *instance_id,
|
|
const char *device_label, char *err, size_t err_sz);
|
|
|
|
/* Only one chair: previous chair is demoted; handover notes left in meta. */
|
|
int cst_parliament_claim_chair(const char *instance_id, const char *device_label);
|
|
|
|
/* Probe local environment as device-private context (malloc'd text). */
|
|
char *cst_parliament_device_context(void);
|
|
|
|
/* New project: wipe shared parliament context; keep Realm keys. */
|
|
int cst_parliament_new_project(const char *project_id);
|
|
|
|
/* Append/replace synchronized context blob (all agents share this file). */
|
|
int cst_parliament_context_put(const char *text);
|
|
char *cst_parliament_context_get(void);
|
|
|
|
/* Local login ticket: opens require a fresh chair session (or password env). */
|
|
int cst_parliament_session_write(const char *instance_id);
|
|
int cst_parliament_session_ok(char *instance_id_out, size_t n);
|
|
void cst_parliament_session_clear(void);
|
|
|
|
/* Apply a peer sync bundle (higher revision already selected by caller). */
|
|
int cst_parliament_apply_sync(unsigned long revision, const char *parliament_id,
|
|
const char *project_id, const char *chair,
|
|
const char *context);
|
|
|
|
/* Background parliament service: discover + peer listen + context sync. */
|
|
int cst_parliament_daemon_pidfile(char *out, size_t n);
|
|
int cst_parliament_daemon_running(void);
|
|
/* Start in background (Unix fork). password unlocks Realm in the child.
|
|
* Returns 0 and writes pid. If already running, returns 0. */
|
|
int cst_parliament_daemon_start(const char *password, const char *instance_id,
|
|
int peer_port, char *err, size_t err_sz);
|
|
int cst_parliament_daemon_stop(void);
|
|
/* Foreground service loop (used by --service and the forked child). */
|
|
int cst_parliament_daemon_run(const char *password, const char *instance_id,
|
|
int peer_port, char *err, size_t err_sz);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif
|