borgmcp-server 0.1.1 → 0.1.5

package/dist/store.d.ts

@@ -1,10 +1,13 @@
+import type { MessageTaxonomy } from "borgmcp-shared/domain";
 import { type Principal } from "./principal.js";
+import { type RoleSectionPatchOp } from "./role-section.js";
 export type CubeAccess = "read" | "write" | "manage";
 export interface CubeRecord {
     readonly id: string;
     readonly ownerId: string;
     readonly name: string;
     readonly directive: string;
+    readonly messageTaxonomy: MessageTaxonomy | null;
     readonly createdAt: string;
     readonly updatedAt: string;
 }
@@ -32,6 +35,19 @@ export interface EnrichedActivityRecord {
     readonly role_name: string | null;
     readonly recipient_drone_ids: string[];
 }
+export type ActivityNotificationRecord = EnrichedActivityRecord & ({
+    readonly kind: "ack" | "claim";
+    readonly log_entry_id: string;
+    readonly ack_kind: "ack" | "claim";
+    readonly ack_at: string;
+    readonly entry_preview: string;
+    readonly author_drone_id?: string;
+    readonly claimant_drone_id?: string;
+    readonly claimant_role?: string | null;
+} | {
+    readonly kind: "heartbeat_ping";
+});
+export type ActivityStreamRecord = EnrichedActivityRecord | ActivityNotificationRecord;
 export interface ClaimRecord {
     readonly log_entry_id: string;
     readonly claimant_drone_id: string;
@@ -63,8 +79,12 @@ export interface RoleRecord {
     readonly cube_id: string;
     readonly name: string;
     readonly short_description: string;
+    readonly detailed_description: string;
     readonly is_default: boolean;
+    readonly is_mandatory: boolean;
     readonly is_human_seat: boolean;
+    readonly can_broadcast: boolean;
+    readonly receives_all_direct: boolean;
     readonly role_class: "queen" | "worker";
     readonly created_at: string;
 }
@@ -75,7 +95,10 @@ export interface DroneRecord {
     readonly label: string;
     readonly last_seen: string;
     readonly hostname: string | null;
+    readonly posture: "observer" | "participant";
     readonly created_at: string;
+    readonly last_log_post_at?: string | null;
+    readonly seen_since?: boolean;
 }
 export interface StoreDiagnostics {
     readonly journalMode: string;
@@ -89,6 +112,7 @@ export interface OpenStoreOptions {
     readonly capacityProbe?: () => StorageCapacity;
     readonly cubeLimits?: CubeLimits;
     readonly mutationHook?: (phase: string) => void;
+    readonly migrationMode?: "apply" | "require-current";
 }
 export interface CubeLimits {
     readonly maxCubesPerClient: number;
@@ -109,9 +133,17 @@ export interface StoreRuntime {
     readonly forPrincipal: (principal: Principal) => ScopedStore;
     readonly maintenance: MaintenanceStore;
     readonly credentials: CredentialStore;
+    readonly liveness: LivenessStore;
     readonly diagnostics: () => StoreDiagnostics;
     readonly close: () => void;
 }
+export interface LivenessStore {
+    readonly scan: (options?: {
+        readonly silentMs?: number;
+        readonly cooldownMs?: number;
+        readonly limit?: number;
+    }) => ActivityNotificationRecord[];
+}
 export interface DigestPair {
     readonly lookup: Buffer;
     readonly verifier: Buffer;
@@ -126,6 +158,19 @@ export interface StoredSecretDigest extends DigestPair {
 export interface StoredInvitationDigest extends StoredSecretDigest {
     readonly purpose: "owner" | "client";
     readonly ownerEpoch: number | null;
+    readonly cubeId: string | null;
+    readonly access: CubeAccess | null;
+}
+export interface InvitationCubeScope {
+    readonly cubeId: string;
+    readonly cubeName: string;
+    readonly access: CubeAccess;
+}
+export declare class InvitationCubeNotFoundError extends Error {
+}
+export declare class InvitationCubeAmbiguousError extends Error {
+    readonly candidateIds: readonly string[];
+    constructor(candidateIds: readonly string[]);
 }
 export interface EnrollmentClaimResult {
     readonly purpose: "owner" | "client";
@@ -138,6 +183,7 @@ export interface StoredDroneSessionDigest extends StoredSecretDigest {
     readonly cubeId: string;
     readonly droneId: string;
     readonly expiresAt: string;
+    readonly evictedAt: string | null;
 }
 export interface CredentialStore {
     readonly createRecoveryCredential: (id: string, digest: DigestPair) => void;
@@ -147,7 +193,12 @@ export interface CredentialStore {
         readonly digest: DigestPair;
         readonly expiresAt: string;
         readonly purpose: "owner" | "client";
-    }) => void;
+        readonly cubeSelector?: {
+            readonly kind: "id" | "name";
+            readonly value: string;
+        };
+        readonly access?: CubeAccess;
+    }) => InvitationCubeScope | null;
     readonly findInvitation: (lookup: Buffer) => StoredInvitationDigest | null;
     readonly claimInvitation: (input: {
         readonly invitationId: string;
@@ -161,6 +212,7 @@ export interface CredentialStore {
     readonly clientExists: (clientId: string) => boolean;
     readonly clientIsActive: (clientId: string) => boolean;
     readonly findDroneSessionCredential: (lookup: Buffer) => StoredDroneSessionDigest | null;
+    readonly findActiveDroneSessionExpiry: (sessionId: string) => string | null;
     readonly rotateClientCredential: (input: {
         readonly clientId: string;
         readonly credentialId: string;
@@ -172,11 +224,19 @@ export interface ScopedStore {
     readonly createCube: (input: CreateCubeInput) => CreateCubeRecord;
     readonly listCubes: () => CubeRecord[];
     readonly getCube: (cubeId: string) => CubeRecord | null;
+    readonly updateCube: (cubeId: string, input: UpdateCubeInput) => CubeRecord;
     readonly updateDirective: (cubeId: string, directive: string) => void;
     readonly appendActivity: (cubeId: string, message: string) => ActivityRecord;
     readonly readActivity: (cubeId: string, limit: number) => ActivityRecord[];
     readonly listRoles: (cubeId: string) => RoleRecord[];
+    readonly createRole: (cubeId: string, input: CreateRoleInput) => RoleRecord;
+    readonly updateRole: (cubeId: string, roleId: string, input: UpdateRoleInput) => RoleRecord;
+    readonly patchRoleSection: (cubeId: string, roleId: string, input: RoleSectionPatchOp) => RoleRecord;
     readonly listDrones: (cubeId: string) => DroneRecord[];
+    readonly listDronesSince: (cubeId: string, since: string) => {
+        readonly drones: DroneRecord[];
+        readonly since: string;
+    };
     readonly appendLog: (cubeId: string, input: {
         readonly message: string;
         readonly visibility?: "broadcast" | "direct";
@@ -190,9 +250,35 @@ export interface ScopedStore {
         readonly rationale?: string;
     }) => DecisionRecord;
     readonly listDecisions: (cubeId: string) => DecisionRecord[];
-    readonly subscribeActivity: (cubeId: string, listener: (entry: EnrichedActivityRecord) => void) => (() => void);
+    readonly subscribeActivity: (cubeId: string, listener: (entry: ActivityStreamRecord) => void) => (() => void);
     readonly attachSeat: (input: SeatAttachInput) => SeatAttachRecord;
 }
+export interface CreateRoleInput {
+    readonly name: string;
+    readonly shortDescription?: string;
+    readonly detailedDescription?: string;
+    readonly isDefault?: boolean;
+    readonly isMandatory?: boolean;
+    readonly isHumanSeat?: boolean;
+    readonly canBroadcast?: boolean;
+    readonly receivesAllDirect?: boolean;
+    readonly roleClass?: "queen" | "worker";
+}
+export interface UpdateRoleInput {
+    readonly name?: string;
+    readonly shortDescription?: string;
+    readonly detailedDescription?: string;
+    readonly isDefault?: boolean;
+    readonly isMandatory?: boolean;
+    readonly isHumanSeat?: boolean;
+    readonly canBroadcast?: boolean;
+    readonly receivesAllDirect?: boolean;
+    readonly roleClass?: "queen" | "worker";
+}
+export interface UpdateCubeInput {
+    readonly directive?: string;
+    readonly messageTaxonomy?: MessageTaxonomy | null;
+}
 export interface CreateCubeInput {
     readonly retryKey: string;
     readonly name: string;
@@ -207,7 +293,6 @@ export interface CreateCubeRecord {
 export interface SeatAttachInput {
     readonly cubeId: string;
     readonly roleId: string;
-    readonly retryKey: string;
     readonly priorDroneId?: string;
     readonly droneId: string;
     readonly sessionId: string;
@@ -232,9 +317,7 @@ export interface SeatAttachRecord {
     };
     readonly sessionId: string;
     readonly expiresAt: string;
-    readonly generation: number;
-    readonly reattached: boolean;
-    readonly revokedSessionIds: readonly string[];
+    readonly result: "created" | "reused";
 }
 export interface MaintenanceStore {
     readonly createClient: (input: {
@@ -304,12 +387,24 @@ export declare class ScopedStoreError extends Error {
     readonly code = "NOT_FOUND";
     constructor();
 }
+export declare class RoleConflictError extends Error {
+    readonly code = "ROLE_ALREADY_EXISTS";
+    constructor();
+}
+export declare class DefaultRoleRequiredError extends Error {
+    readonly code = "DEFAULT_ROLE_REQUIRED";
+    constructor();
+}
+export declare class RoleSectionConflictError extends Error {
+    readonly code = "ROLE_SECTION_CONFLICT";
+    constructor();
+}
 export declare class CursorExpiredError extends Error {
     readonly code = "CURSOR_EXPIRED";
     constructor();
 }
-export declare class AttachConflictError extends Error {
-    readonly code = "ATTACH_CONFLICT";
+export declare class AttachSessionRejectedError extends Error {
+    readonly code = "SESSION_REJECTED";
     constructor();
 }
 export declare class StorageCapacityError extends Error {
@@ -325,3 +420,6 @@ export declare class CreateCubeConflictError extends Error {
     constructor();
 }
 export declare function openStore(options: OpenStoreOptions): Promise<StoreRuntime>;
+export declare function preparePrivateDataDirectory(path: string): Promise<string>;
+export declare const MAX_ROLE_DETAILED_DESCRIPTION_CHARS = 51200;
+export declare function assertRoleTextWriteAllowed(value: string, previous?: string): void;