@allin-ai/agent-client 0.1.0

package/dist/cli/main.d.ts

@@ -0,0 +1,2 @@
+export declare function main(args?: string[]): Promise<void>;
+//# sourceMappingURL=main.d.ts.map

package/dist/cli/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":"AAEA,wBAAsB,IAAI,CAAC,IAAI,WAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGtE"}

package/dist/cli/main.js

@@ -0,0 +1,7 @@
+import { runCli } from "./commands.js";
+export async function main(args = process.argv.slice(2)) {
+    const result = await runCli(args);
+    if (result.exitCode !== 0)
+        process.exitCode = result.exitCode;
+}
+//# sourceMappingURL=main.js.map

package/dist/cli/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC;QAAE,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;AAChE,CAAC"}

package/dist/client/state-store.d.ts

@@ -0,0 +1,80 @@
+import type { ClientCommand, ClientEvent } from "./types.js";
+import type { ActivePluginSnapshot, PluginStateStore, StoredPluginState } from "../plugins/types.js";
+export declare const EXECUTION_STATES: readonly ["received", "awaiting_approval", "running", "rejected", "done", "failed", "cancelled", "recovery_required"];
+export type ExecutionState = (typeof EXECUTION_STATES)[number];
+export type StoredExecution = {
+    executionId: string;
+    command: ClientCommand;
+    state: ExecutionState;
+    attempt: number;
+    admittedAt: string;
+    updatedAt: string;
+    lastEventSeq: number;
+    pluginSnapshot: ActivePluginSnapshot[];
+};
+export type AdmissionResult = {
+    disposition: "inserted" | "duplicate";
+    execution: StoredExecution;
+};
+export type AdmissionOptions = {
+    pluginSnapshot?: ActivePluginSnapshot[];
+};
+export type EventToAppend = Omit<ClientEvent, "eventSeq"> & {
+    eventSeq?: number;
+};
+/**
+ * Durable local inbox/outbox for one Agent Client daemon.
+ *
+ * `last_event_seq` deliberately lives with the execution rather than the
+ * outbox: acknowledged rows are deleted, but a later event must never reuse
+ * their sequence number.
+ */
+export declare class ClientStateStore implements PluginStateStore {
+    private readonly db;
+    constructor(dbPath: string);
+    close(): void;
+    /**
+     * Atomically writes the inbox command and its initial received event. A
+     * redelivered execution returns the existing row without adding an event.
+     */
+    admit(command: ClientCommand, options?: AdmissionOptions): AdmissionResult;
+    getExecution(executionId: string): StoredExecution | null;
+    listExecutions(): StoredExecution[];
+    /**
+     * Changes execution state and commits the matching state event in the same
+     * transaction. Callers cannot report a durable state without a durable
+     * outbox record for it.
+     */
+    transition(executionId: string, nextState: ExecutionState, payload?: Record<string, unknown>): ClientEvent;
+    /**
+     * Appends a non-state runtime event supplied by the caller. If no sequence is
+     * supplied, this store allocates the next sequence. Explicit sequences are
+     * accepted only when they are the next sequence, preventing acknowledgement
+     * watermarks from skipping an event.
+     */
+    appendEvent(event: EventToAppend): ClientEvent;
+    listUnackedEvents(executionId?: string): ClientEvent[];
+    /** Deletes only events at or below the Hub's acknowledgement watermark. */
+    acknowledge(executionId: string, eventSeqWatermark: number): number;
+    /**
+     * On daemon boot, no in-process runner can be trusted to still exist. Mark
+     * every persisted running execution (or one selected execution) as needing
+     * recovery and enqueue a matching state event.
+     */
+    markRecoveryRequired(executionId?: string): ClientEvent[];
+    private initialize;
+    private transaction;
+    private getExecutionRow;
+    private requireExecutionRow;
+    private toExecution;
+    getLastPluginSyncRevision(): string | null;
+    recordPluginSyncSuccess(revision: string): void;
+    listPluginStates(): StoredPluginState[];
+    savePluginState(state: StoredPluginState): void;
+    private assertLegalTransition;
+    private transitionRow;
+    private insertOutboxEvent;
+    private parseStoredEvent;
+    private assertValidEvent;
+}
+//# sourceMappingURL=state-store.d.ts.map

package/dist/client/state-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-store.d.ts","sourceRoot":"","sources":["../../src/client/state-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAmB,MAAM,YAAY,CAAC;AAE9E,OAAO,KAAK,EACV,oBAAoB,EAEpB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAE7B,eAAO,MAAM,gBAAgB,uHASnB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,MAAM,MAAM,eAAe,GAAG;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,cAAc,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,oBAAoB,EAAE,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,WAAW,EAAE,UAAU,GAAG,WAAW,CAAC;IACtC,SAAS,EAAE,eAAe,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,cAAc,CAAC,EAAE,oBAAoB,EAAE,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,GAAG;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAmHF;;;;;;GAMG;AACH,qBAAa,gBAAiB,YAAW,gBAAgB;IACvD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAe;gBAEtB,MAAM,EAAE,MAAM;IAK1B,KAAK,IAAI,IAAI;IAIb;;;OAGG;IACH,KAAK,CACH,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE,gBAAqB,GAC7B,eAAe;IAwDlB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAKzD,cAAc,IAAI,eAAe,EAAE;IAWnC;;;;OAIG;IACH,UAAU,CACR,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,cAAc,EACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,WAAW;IAQd;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,WAAW;IAgC9C,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE;IAoBtD,2EAA2E;IAC3E,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,MAAM;IAenE;;;;OAIG;IACH,oBAAoB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE;IAuBzD,OAAO,CAAC,UAAU;IA4ClB,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,WAAW;IAwBnB,yBAAyB,IAAI,MAAM,GAAG,IAAI;IAO1C,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAa/C,gBAAgB,IAAI,iBAAiB,EAAE;IAYvC,eAAe,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAkB/C,OAAO,CAAC,qBAAqB;IAgB7B,OAAO,CAAC,aAAa;IAyBrB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,gBAAgB;CAUzB"}

package/dist/client/state-store.js

@@ -0,0 +1,422 @@
+import { DatabaseSync } from "node:sqlite";
+import { parseClientCommand, parseClientEventBatch } from "./wire.js";
+export const EXECUTION_STATES = [
+    "received",
+    "awaiting_approval",
+    "running",
+    "rejected",
+    "done",
+    "failed",
+    "cancelled",
+    "recovery_required",
+];
+const LEGAL_TRANSITIONS = {
+    received: ["awaiting_approval", "running", "rejected", "cancelled"],
+    awaiting_approval: ["running", "rejected", "cancelled"],
+    running: ["done", "failed", "cancelled", "recovery_required"],
+    rejected: [],
+    done: [],
+    failed: [],
+    cancelled: [],
+    recovery_required: [],
+};
+function isExecutionState(value) {
+    return EXECUTION_STATES.includes(value);
+}
+function now() {
+    return new Date().toISOString();
+}
+function commandAttempt(command) {
+    return command.kind === "cancel" ? 0 : command.attempt;
+}
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function normalizePluginSnapshot(value) {
+    const seen = new Set();
+    return value.map((plugin) => {
+        if (!plugin ||
+            typeof plugin.id !== "string" ||
+            !plugin.id ||
+            typeof plugin.resolvedCommit !== "string" ||
+            !/^[0-9a-f]{40}$/i.test(plugin.resolvedCommit) ||
+            seen.has(plugin.id)) {
+            throw new TypeError("Plugin snapshot must contain unique full commits");
+        }
+        seen.add(plugin.id);
+        return {
+            id: plugin.id,
+            resolvedCommit: plugin.resolvedCommit.toLowerCase(),
+        };
+    });
+}
+function parsePluginSnapshot(value) {
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch {
+        throw new TypeError("Stored plugin snapshot is invalid JSON");
+    }
+    if (!Array.isArray(parsed))
+        throw new TypeError("Stored plugin snapshot is invalid");
+    return normalizePluginSnapshot(parsed);
+}
+function assertInstalledPlugin(value) {
+    if (!isPlainObject(value) ||
+        typeof value.id !== "string" ||
+        !value.id ||
+        typeof value.gitUrl !== "string" ||
+        !value.gitUrl ||
+        typeof value.enabled !== "boolean" ||
+        typeof value.resolvedCommit !== "string" ||
+        !value.resolvedCommit ||
+        typeof value.installedAt !== "string" ||
+        !value.installedAt ||
+        !["active", "blocked", "failed"].includes(value.status)) {
+        throw new TypeError("Plugin installation record is invalid");
+    }
+}
+function parseInstalledPlugin(value) {
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch {
+        throw new TypeError("Stored plugin record is invalid JSON");
+    }
+    assertInstalledPlugin(parsed);
+    return parsed;
+}
+/**
+ * Durable local inbox/outbox for one Agent Client daemon.
+ *
+ * `last_event_seq` deliberately lives with the execution rather than the
+ * outbox: acknowledged rows are deleted, but a later event must never reuse
+ * their sequence number.
+ */
+export class ClientStateStore {
+    db;
+    constructor(dbPath) {
+        this.db = new DatabaseSync(dbPath);
+        this.initialize();
+    }
+    close() {
+        this.db.close();
+    }
+    /**
+     * Atomically writes the inbox command and its initial received event. A
+     * redelivered execution returns the existing row without adding an event.
+     */
+    admit(command, options = {}) {
+        return this.transaction(() => {
+            const previous = this.getExecutionRow(command.executionId);
+            if (previous) {
+                return {
+                    disposition: "duplicate",
+                    execution: this.toExecution(previous),
+                };
+            }
+            const admittedAt = now();
+            const pluginSnapshot = normalizePluginSnapshot(options.pluginSnapshot ?? []);
+            const received = {
+                executionId: command.executionId,
+                eventSeq: 1,
+                type: "received",
+                occurredAt: admittedAt,
+            };
+            if (pluginSnapshot.length > 0)
+                received.payload = { pluginSnapshot };
+            this.db
+                .prepare(`INSERT INTO executions (
+            execution_id, command_json, state, attempt, admitted_at, updated_at, last_event_seq, plugin_snapshot_json
+          ) VALUES (?, ?, ?, ?, ?, ?, ?, ?)`)
+                .run(command.executionId, JSON.stringify(command), "received", commandAttempt(command), admittedAt, admittedAt, received.eventSeq, JSON.stringify(pluginSnapshot));
+            this.insertOutboxEvent(received);
+            return {
+                disposition: "inserted",
+                execution: {
+                    executionId: command.executionId,
+                    command,
+                    state: "received",
+                    attempt: commandAttempt(command),
+                    admittedAt,
+                    updatedAt: admittedAt,
+                    lastEventSeq: received.eventSeq,
+                    pluginSnapshot,
+                },
+            };
+        });
+    }
+    getExecution(executionId) {
+        const row = this.getExecutionRow(executionId);
+        return row ? this.toExecution(row) : null;
+    }
+    listExecutions() {
+        const rows = this.db
+            .prepare(`SELECT execution_id, command_json, state, attempt, admitted_at, updated_at, last_event_seq, plugin_snapshot_json
+         FROM executions
+         ORDER BY admitted_at ASC, execution_id ASC`)
+            .all();
+        return rows.map((row) => this.toExecution(row));
+    }
+    /**
+     * Changes execution state and commits the matching state event in the same
+     * transaction. Callers cannot report a durable state without a durable
+     * outbox record for it.
+     */
+    transition(executionId, nextState, payload) {
+        return this.transaction(() => {
+            const current = this.requireExecutionRow(executionId);
+            this.assertLegalTransition(current, nextState);
+            return this.transitionRow(current, nextState, payload);
+        });
+    }
+    /**
+     * Appends a non-state runtime event supplied by the caller. If no sequence is
+     * supplied, this store allocates the next sequence. Explicit sequences are
+     * accepted only when they are the next sequence, preventing acknowledgement
+     * watermarks from skipping an event.
+     */
+    appendEvent(event) {
+        if (event.type !== "progress") {
+            throw new TypeError("Only progress events may be appended directly; state events must use transition");
+        }
+        return this.transaction(() => {
+            const current = this.requireExecutionRow(event.executionId);
+            const eventSeq = event.eventSeq ?? current.last_event_seq + 1;
+            if (!Number.isSafeInteger(eventSeq) ||
+                eventSeq !== current.last_event_seq + 1) {
+                throw new RangeError(`Event sequence for ${event.executionId} must be ${current.last_event_seq + 1}`);
+            }
+            const storedEvent = { ...event, eventSeq };
+            this.assertValidEvent(storedEvent);
+            this.insertOutboxEvent(storedEvent);
+            this.db
+                .prepare(`UPDATE executions
+           SET last_event_seq = ?, updated_at = ?
+           WHERE execution_id = ?`)
+                .run(storedEvent.eventSeq, now(), storedEvent.executionId);
+            return storedEvent;
+        });
+    }
+    listUnackedEvents(executionId) {
+        const rows = executionId
+            ? this.db
+                .prepare(`SELECT event_json FROM outbox
+             WHERE execution_id = ?
+             ORDER BY event_seq ASC`)
+                .all(executionId)
+            : this.db
+                .prepare(`SELECT event_json FROM outbox
+             ORDER BY execution_id ASC, event_seq ASC`)
+                .all();
+        return rows.map(({ event_json: eventJson }) => this.parseStoredEvent(eventJson));
+    }
+    /** Deletes only events at or below the Hub's acknowledgement watermark. */
+    acknowledge(executionId, eventSeqWatermark) {
+        if (!Number.isSafeInteger(eventSeqWatermark) || eventSeqWatermark < 0) {
+            throw new RangeError("Acknowledgement watermark must be a non-negative safe integer");
+        }
+        const result = this.db
+            .prepare(`DELETE FROM outbox
+         WHERE execution_id = ? AND event_seq <= ?`)
+            .run(executionId, eventSeqWatermark);
+        return Number(result.changes);
+    }
+    /**
+     * On daemon boot, no in-process runner can be trusted to still exist. Mark
+     * every persisted running execution (or one selected execution) as needing
+     * recovery and enqueue a matching state event.
+     */
+    markRecoveryRequired(executionId) {
+        return this.transaction(() => {
+            const rows = executionId
+                ? this.db
+                    .prepare(`SELECT execution_id, command_json, state, attempt, admitted_at, updated_at, last_event_seq, plugin_snapshot_json
+               FROM executions
+               WHERE execution_id = ? AND state = 'running'`)
+                    .all(executionId)
+                : this.db
+                    .prepare(`SELECT execution_id, command_json, state, attempt, admitted_at, updated_at, last_event_seq, plugin_snapshot_json
+               FROM executions
+               WHERE state = 'running'
+               ORDER BY admitted_at ASC, execution_id ASC`)
+                    .all();
+            return rows.map((row) => this.transitionRow(row, "recovery_required"));
+        });
+    }
+    initialize() {
+        this.transaction(() => {
+            this.db.exec(`
+        CREATE TABLE IF NOT EXISTS executions (
+          execution_id TEXT PRIMARY KEY,
+          command_json TEXT NOT NULL,
+          state TEXT NOT NULL,
+          attempt INTEGER NOT NULL,
+          admitted_at TEXT NOT NULL,
+          updated_at TEXT NOT NULL,
+          last_event_seq INTEGER NOT NULL DEFAULT 0,
+          plugin_snapshot_json TEXT NOT NULL DEFAULT '[]'
+        );
+
+        CREATE TABLE IF NOT EXISTS outbox (
+          execution_id TEXT NOT NULL,
+          event_seq INTEGER NOT NULL,
+          event_json TEXT NOT NULL,
+          PRIMARY KEY (execution_id, event_seq)
+        );
+
+        CREATE TABLE IF NOT EXISTS plugin_states (
+          plugin_id TEXT PRIMARY KEY,
+          plugin_json TEXT NOT NULL,
+          active_json TEXT
+        );
+
+        CREATE TABLE IF NOT EXISTS plugin_sync_state (
+          singleton INTEGER PRIMARY KEY CHECK (singleton = 1),
+          revision TEXT NOT NULL,
+          synced_at TEXT NOT NULL
+        );
+      `);
+            const columns = this.db
+                .prepare("PRAGMA table_info(executions)")
+                .all();
+            if (!columns.some((column) => column.name === "plugin_snapshot_json")) {
+                this.db.exec("ALTER TABLE executions ADD COLUMN plugin_snapshot_json TEXT NOT NULL DEFAULT '[]'");
+            }
+        });
+    }
+    transaction(fn) {
+        this.db.exec("BEGIN IMMEDIATE");
+        try {
+            const result = fn();
+            this.db.exec("COMMIT");
+            return result;
+        }
+        catch (error) {
+            this.db.exec("ROLLBACK");
+            throw error;
+        }
+    }
+    getExecutionRow(executionId) {
+        return (this.db
+            .prepare(`SELECT execution_id, command_json, state, attempt, admitted_at, updated_at, last_event_seq, plugin_snapshot_json
+         FROM executions
+         WHERE execution_id = ?`)
+            .get(executionId) ?? null);
+    }
+    requireExecutionRow(executionId) {
+        const row = this.getExecutionRow(executionId);
+        if (!row)
+            throw new Error(`Unknown execution ${executionId}`);
+        return row;
+    }
+    toExecution(row) {
+        if (!isExecutionState(row.state)) {
+            throw new TypeError(`Stored execution ${row.execution_id} has invalid state ${row.state}`);
+        }
+        const command = parseClientCommand(JSON.parse(row.command_json));
+        if (!command) {
+            throw new TypeError(`Stored execution ${row.execution_id} has an invalid command`);
+        }
+        return {
+            executionId: row.execution_id,
+            command,
+            state: row.state,
+            attempt: row.attempt,
+            admittedAt: row.admitted_at,
+            updatedAt: row.updated_at,
+            lastEventSeq: row.last_event_seq,
+            pluginSnapshot: parsePluginSnapshot(row.plugin_snapshot_json),
+        };
+    }
+    getLastPluginSyncRevision() {
+        const row = this.db
+            .prepare("SELECT revision FROM plugin_sync_state WHERE singleton = 1")
+            .get();
+        return row?.revision ?? null;
+    }
+    recordPluginSyncSuccess(revision) {
+        if (typeof revision !== "string" || revision.trim().length === 0) {
+            throw new TypeError("Plugin sync revision must be a nonempty string");
+        }
+        this.db
+            .prepare(`INSERT INTO plugin_sync_state (singleton, revision, synced_at)
+         VALUES (1, ?, ?)
+         ON CONFLICT(singleton) DO UPDATE SET revision = excluded.revision, synced_at = excluded.synced_at`)
+            .run(revision, now());
+    }
+    listPluginStates() {
+        const rows = this.db
+            .prepare("SELECT plugin_json, active_json FROM plugin_states ORDER BY plugin_id ASC")
+            .all();
+        return rows.map((row) => ({
+            plugin: parseInstalledPlugin(row.plugin_json),
+            active: row.active_json ? parseInstalledPlugin(row.active_json) : null,
+        }));
+    }
+    savePluginState(state) {
+        assertInstalledPlugin(state.plugin);
+        if (state.active)
+            assertInstalledPlugin(state.active);
+        this.db
+            .prepare(`INSERT INTO plugin_states (plugin_id, plugin_json, active_json)
+         VALUES (?, ?, ?)
+         ON CONFLICT(plugin_id) DO UPDATE SET
+           plugin_json = excluded.plugin_json,
+           active_json = excluded.active_json`)
+            .run(state.plugin.id, JSON.stringify(state.plugin), state.active ? JSON.stringify(state.active) : null);
+    }
+    assertLegalTransition(current, nextState) {
+        if (!isExecutionState(current.state)) {
+            throw new TypeError(`Stored execution ${current.execution_id} has invalid state ${current.state}`);
+        }
+        if (!LEGAL_TRANSITIONS[current.state].includes(nextState)) {
+            throw new Error(`Cannot transition execution ${current.execution_id} from ${current.state} to ${nextState}`);
+        }
+    }
+    transitionRow(current, nextState, payload) {
+        const occurredAt = now();
+        const event = {
+            executionId: current.execution_id,
+            eventSeq: current.last_event_seq + 1,
+            type: nextState,
+            occurredAt,
+        };
+        if (payload)
+            event.payload = payload;
+        this.db
+            .prepare(`UPDATE executions
+         SET state = ?, updated_at = ?, last_event_seq = ?
+         WHERE execution_id = ?`)
+            .run(nextState, occurredAt, event.eventSeq, current.execution_id);
+        this.insertOutboxEvent(event);
+        return event;
+    }
+    insertOutboxEvent(event) {
+        this.db
+            .prepare(`INSERT INTO outbox (execution_id, event_seq, event_json)
+         VALUES (?, ?, ?)`)
+            .run(event.executionId, event.eventSeq, JSON.stringify(event));
+    }
+    parseStoredEvent(eventJson) {
+        const parsed = parseClientEventBatch({
+            type: "event.push",
+            events: [JSON.parse(eventJson)],
+        });
+        if (!parsed) {
+            throw new TypeError("Stored outbox event is invalid");
+        }
+        return parsed[0];
+    }
+    assertValidEvent(event) {
+        if (!parseClientEventBatch({
+            type: "event.push",
+            events: [event],
+        })) {
+            throw new TypeError("Cannot append an invalid client event");
+        }
+    }
+}
+//# sourceMappingURL=state-store.js.map

package/dist/client/state-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-store.js","sourceRoot":"","sources":["../../src/client/state-store.ts"],"names":[],"mappings":"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"}

package/dist/client/supervisor.d.ts

@@ -0,0 +1,118 @@
+import { ClientStateStore } from "./state-store.js";
+import type { ClientCommand } from "./types.js";
+import type { ClientTransport } from "./transport.js";
+import type { ActivePluginSnapshot, InstalledPlugin, PluginConfig } from "../plugins/types.js";
+import { type LocalContextSource } from "../capabilities/context.js";
+import { type CapabilityLocalPolicy } from "../capabilities/policy.js";
+import type { CapabilityEvent } from "../capabilities/shell-wire.js";
+import type { ShellCapability } from "../capabilities/types.js";
+import type { RunnerManager } from "../runtime/types.js";
+type AgentRunCommand = Extract<ClientCommand, {
+    kind: "agent.run";
+}>;
+type CapabilityInvokeCommand = Extract<ClientCommand, {
+    kind: "capability.invoke";
+}>;
+export declare const LOCAL_POLICY_DECISIONS: readonly ["auto", "approval", "deny"];
+export type LocalPolicyDecision = (typeof LOCAL_POLICY_DECISIONS)[number];
+/**
+ * The local daemon decides whether an admitted remote run may launch. The
+ * default is deny: receiving a Hub command must not implicitly execute an
+ * agent until a local policy has been deliberately configured.
+ */
+export type LocalPolicy = (command: AgentRunCommand) => LocalPolicyDecision | Promise<LocalPolicyDecision>;
+export type ClientSupervisorOptions = {
+    store: ClientStateStore;
+    transport: ClientTransport;
+    runner: RunnerManager;
+    /** Maximum simultaneous local executions. Overflow is durably rejected. */
+    maxConcurrentRuns?: number;
+    policy?: LocalPolicy;
+    plugins?: PluginManagerPort;
+    capabilityHost?: CapabilityHostPort;
+    capabilityPolicy?: CapabilityLocalPolicy;
+    capabilityContext?: CapabilityContextResolver;
+};
+export type PluginManagerPort = {
+    sync(desired: PluginConfig[]): Promise<InstalledPlugin[]>;
+    snapshotActivePlugins(runtime?: AgentRunCommand["runtime"]): ActivePluginSnapshot[];
+};
+/** A locally validated capability plus the exact immutable plugin root it owns. */
+export type ResolvedActiveCapability = {
+    plugin: InstalledPlugin;
+    capability: ShellCapability;
+    pluginRoot: string;
+};
+/**
+ * The Supervisor only knows how to resolve an active, local declaration and
+ * consume structured events. It cannot name an executable or provide argv.
+ */
+export type CapabilityHostPort = {
+    resolveActiveCapability(capabilityId: string): Promise<ResolvedActiveCapability | null>;
+    invoke(resolved: ResolvedActiveCapability, input: unknown, context: Record<string, unknown>, signal: AbortSignal): AsyncIterable<CapabilityEvent>;
+};
+/** Supplies only local metadata. Hub command fields are never spread into it. */
+export type CapabilityContextResolver = (command: CapabilityInvokeCommand, resolved: ResolvedActiveCapability) => LocalContextSource;
+/**
+ * Coordinates durable task admission, local execution policy, and outbox
+ * delivery. Vendor runtimes and shell hosts remain outside this class.
+ */
+export declare class ClientSupervisor {
+    private readonly options;
+    private readonly policy;
+    private readonly capabilityContext;
+    private readonly maxConcurrentRuns;
+    private readonly pluginSyncInFlight;
+    private readonly capabilityAbortControllers;
+    private readonly runnerConsumptionTasks;
+    private readonly capabilityConsumptionTasks;
+    private started;
+    private shuttingDown;
+    constructor(options: ClientSupervisorOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /**
+     * Service shutdown has a stricter lifecycle than an ordinary transport
+     * disconnect: persist cancellation and signal every locally owned child
+     * before the socket and state store are released.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Approval only resumes the exact persisted structured command. It never
+     * accepts a replacement command, entrypoint, or argument vector.
+     */
+    approve(executionId: string): Promise<void>;
+    /**
+     * Pushes durable outbox rows and removes only the watermark each execution
+     * actually received. A failed push does not touch local state, so reconnect
+     * replay remains possible.
+     */
+    flush(): Promise<void>;
+    private handleCommand;
+    private decide;
+    private handleCapabilityCommand;
+    private startApprovedCapability;
+    private resolveActiveCapability;
+    private validateCapabilityInput;
+    private startPersistedCapability;
+    private consumeCapabilityEvents;
+    /**
+     * Plugin desired state is independent of task admission. A failure records no
+     * successful revision, reports a typed rejection if the transport supports
+     * it, and deliberately leaves all in-flight runners untouched.
+     */
+    private handlePluginSync;
+    private syncPluginRevision;
+    private reportPluginSync;
+    private startPersistedAgentRun;
+    private cancelActiveExecution;
+    private consumeRunnerEvents;
+    private hasCapacity;
+    private trackConsumptionTask;
+    private waitForConsumptionTasks;
+    private appendProgressIfRunning;
+    private transitionRunningExecution;
+    private requireExecution;
+}
+export {};
+//# sourceMappingURL=supervisor.d.ts.map

package/dist/client/supervisor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor.d.ts","sourceRoot":"","sources":["../../src/client/supervisor.ts"],"names":[],"mappings":"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"}