@timurproko/a1 0.1.8-dev.472 → 0.1.8-dev.508

package/dist/foundation/storage/control-store.js

@@ -2,14 +2,34 @@ import { DatabaseSync } from "node:sqlite";
 import { mkdirSync } from "node:fs";
 import { dirname } from "node:path";
 import { PRODUCT_IDENTITY } from "../../product-identity.js";
-import { assertManagedAgentDescriptor, assertRecoveryAuthority, assertTerminalSessionLaunch, assertTerminalTopologySnapshot, } from "../../contracts/workspace/index.js";
 import { assertLaunchInstance, assertLaunchInstanceOutcome, assertNativeProcessIdentity, assertProcessContainmentIdentity, } from "../lifecycle/index.js";
-export const DEFAULT_WORKSPACE_ID = "workspace-default";
-const INITIAL_WORKSPACE_ID = DEFAULT_WORKSPACE_ID;
+const CONTROL_SCHEMA_VERSION = 7;
+const LAUNCH_INSTANCES_TABLE = `
+  CREATE TABLE launch_instances (
+    id TEXT PRIMARY KEY,
+    owner_client_id TEXT NOT NULL,
+    profile_id TEXT NOT NULL CHECK (profile_id IN ('a1', 'pi')),
+    state TEXT NOT NULL CHECK (state IN ('requested', 'active', 'stopping', 'completed', 'interrupted')),
+    shutdown_policy TEXT NOT NULL CHECK (shutdown_policy = 'terminate-tree-on-close'),
+    guardian_identity_json TEXT NOT NULL CHECK (json_valid(guardian_identity_json)),
+    root_identity_json TEXT CHECK (root_identity_json IS NULL OR json_valid(root_identity_json)),
+    containment_identity_json TEXT CHECK (containment_identity_json IS NULL OR json_valid(containment_identity_json)),
+    created_at TEXT NOT NULL,
+    activated_at TEXT,
+    stopping_at TEXT,
+    completed_at TEXT,
+    outcome_json TEXT CHECK (outcome_json IS NULL OR json_valid(outcome_json)),
+    owner_boot_nonce TEXT NOT NULL,
+    CHECK ((state = 'requested' AND root_identity_json IS NULL AND containment_identity_json IS NULL AND activated_at IS NULL AND stopping_at IS NULL AND completed_at IS NULL AND outcome_json IS NULL)
+      OR (state = 'active' AND root_identity_json IS NOT NULL AND containment_identity_json IS NOT NULL AND activated_at IS NOT NULL AND stopping_at IS NULL AND completed_at IS NULL AND outcome_json IS NULL)
+      OR (state = 'stopping' AND root_identity_json IS NOT NULL AND containment_identity_json IS NOT NULL AND activated_at IS NOT NULL AND stopping_at IS NOT NULL AND completed_at IS NULL AND outcome_json IS NULL)
+      OR (state IN ('completed', 'interrupted') AND completed_at IS NOT NULL AND outcome_json IS NOT NULL))
+  );
+`;
 /** Owns WAL-backed control persistence and reconciles prior-boot records before current use. */
 export class ControlStore {
-    bootNonce;
     database;
+    bootNonce;
     constructor(path, bootNonce = null) {
         this.bootNonce = bootNonce;
         mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
@@ -18,10 +38,8 @@ export class ControlStore {
             this.database.exec("PRAGMA journal_mode = WAL");
             this.database.exec("PRAGMA foreign_keys = ON");
             this.migrate();
-            if (bootNonce !== null) {
-                this.reconcilePriorBootGenerations(bootNonce);
+            if (bootNonce !== null)
                 this.reconcilePriorBootLaunchInstances(bootNonce);
-            }
         }
         catch (error) {
             this.database.close();
@@ -31,58 +49,24 @@ export class ControlStore {
     migrate() {
         const versionRow = this.database.prepare("PRAGMA user_version").get();
         const version = versionRow.user_version;
-        if (version > 6)
-            throw new Error(`control database version ${version} is newer than supported version 6`);
+        if (version > CONTROL_SCHEMA_VERSION)
+            throw new Error(`control database version ${version} is newer than supported version ${CONTROL_SCHEMA_VERSION}`);
         if (version !== 0)
             this.#assertCurrentControlSchema();
         if (version === 0) {
+            // Rationale: a new database gets only the live schema; the historical chain below exists for
+            // databases created by earlier releases and ends by dropping the retired workspace tables.
             this.database.exec(`
         BEGIN IMMEDIATE;
-        CREATE TABLE workspaces (
-          id TEXT PRIMARY KEY,
-          name TEXT NOT NULL,
-          selected_agent_id TEXT,
-          created_at TEXT NOT NULL
-        );
-        CREATE TABLE driver_profiles (
-          id TEXT PRIMARY KEY,
-          kind TEXT NOT NULL,
-          profile_json TEXT NOT NULL,
-          created_at TEXT NOT NULL
-        );
-        CREATE TABLE terminal_agents (
-          id TEXT PRIMARY KEY,
-          workspace_id TEXT NOT NULL REFERENCES workspaces(id) ON DELETE CASCADE,
-          name TEXT NOT NULL,
-          profile_id TEXT NOT NULL REFERENCES driver_profiles(id),
-          profile_json TEXT NOT NULL,
-          surface_json TEXT,
-          created_at TEXT NOT NULL
-        );
-        CREATE TABLE process_generations (
-          id TEXT PRIMARY KEY,
-          agent_id TEXT NOT NULL REFERENCES terminal_agents(id) ON DELETE CASCADE,
-          sequence INTEGER NOT NULL,
-          profile_id TEXT NOT NULL REFERENCES driver_profiles(id),
-          state TEXT NOT NULL,
-          capabilities_json TEXT NOT NULL,
-          started_at TEXT NOT NULL,
-          exited_at TEXT,
-          exit_code INTEGER,
-          signal INTEGER,
-          error TEXT,
-          owner_boot_nonce TEXT,
-          UNIQUE(agent_id, sequence)
-        );
-        CREATE INDEX idx_agents_workspace ON terminal_agents(workspace_id, created_at);
-        CREATE INDEX idx_generations_agent ON process_generations(agent_id, sequence DESC);
-        CREATE INDEX idx_generations_owner_boot ON process_generations(owner_boot_nonce, state);
-        PRAGMA user_version = 1;
+        ${LAUNCH_INSTANCES_TABLE}
+        CREATE INDEX idx_launch_instances_owner ON launch_instances(owner_client_id, state);
+        CREATE INDEX idx_launch_instances_boot ON launch_instances(owner_boot_nonce, state);
+        CREATE TABLE product_identity (schema TEXT PRIMARY KEY NOT NULL);
+        PRAGMA user_version = ${CONTROL_SCHEMA_VERSION};
         COMMIT;
       `);
-            const now = new Date().toISOString();
-            this.database.prepare("INSERT INTO workspaces (id, name, selected_agent_id, created_at) VALUES (?, ?, NULL, ?)")
-                .run(INITIAL_WORKSPACE_ID, "Workspace", now);
+            this.database.prepare("INSERT INTO product_identity (schema) VALUES (?)").run(PRODUCT_IDENTITY.protocol.controlStoreSchema);
+            return;
         }
         if (version <= 1) {
             const columns = this.database.prepare("PRAGMA table_info(process_generations)").all();
@@ -217,26 +201,7 @@ export class ControlStore {
         ALTER TABLE launch_instances RENAME TO launch_instances_v5;
         DROP INDEX idx_launch_instances_owner;
         DROP INDEX idx_launch_instances_boot;
-        CREATE TABLE launch_instances (
-          id TEXT PRIMARY KEY,
-          owner_client_id TEXT NOT NULL,
-          profile_id TEXT NOT NULL CHECK (profile_id IN ('a1', 'pi')),
-          state TEXT NOT NULL CHECK (state IN ('requested', 'active', 'stopping', 'completed', 'interrupted')),
-          shutdown_policy TEXT NOT NULL CHECK (shutdown_policy = 'terminate-tree-on-close'),
-          guardian_identity_json TEXT NOT NULL CHECK (json_valid(guardian_identity_json)),
-          root_identity_json TEXT CHECK (root_identity_json IS NULL OR json_valid(root_identity_json)),
-          containment_identity_json TEXT CHECK (containment_identity_json IS NULL OR json_valid(containment_identity_json)),
-          created_at TEXT NOT NULL,
-          activated_at TEXT,
-          stopping_at TEXT,
-          completed_at TEXT,
-          outcome_json TEXT CHECK (outcome_json IS NULL OR json_valid(outcome_json)),
-          owner_boot_nonce TEXT NOT NULL,
-          CHECK ((state = 'requested' AND root_identity_json IS NULL AND containment_identity_json IS NULL AND activated_at IS NULL AND stopping_at IS NULL AND completed_at IS NULL AND outcome_json IS NULL)
-            OR (state = 'active' AND root_identity_json IS NOT NULL AND containment_identity_json IS NOT NULL AND activated_at IS NOT NULL AND stopping_at IS NULL AND completed_at IS NULL AND outcome_json IS NULL)
-            OR (state = 'stopping' AND root_identity_json IS NOT NULL AND containment_identity_json IS NOT NULL AND activated_at IS NOT NULL AND stopping_at IS NOT NULL AND completed_at IS NULL AND outcome_json IS NULL)
-            OR (state IN ('completed', 'interrupted') AND completed_at IS NOT NULL AND outcome_json IS NOT NULL))
-        );
+        ${LAUNCH_INSTANCES_TABLE}
         INSERT INTO launch_instances SELECT * FROM launch_instances_v5 WHERE profile_id IN ('a1', 'pi');
         DROP TABLE launch_instances_v5;
         CREATE INDEX idx_launch_instances_owner ON launch_instances(owner_client_id, state);
@@ -245,9 +210,23 @@ export class ControlStore {
         COMMIT;
       `);
         }
-        if (version === 0) {
-            this.database.exec("CREATE TABLE product_identity (schema TEXT PRIMARY KEY NOT NULL)");
-            this.database.prepare("INSERT INTO product_identity (schema) VALUES (?)").run(PRODUCT_IDENTITY.protocol.controlStoreSchema);
+        if (version <= 6) {
+            // Rationale: the multi-agent workspace, terminal-host topology, and recovery tables never had a
+            // production writer; children go before parents so foreign keys never see an orphan.
+            this.database.exec(`
+        BEGIN IMMEDIATE;
+        DROP TABLE IF EXISTS recovery_references;
+        DROP TABLE IF EXISTS terminal_sessions;
+        DROP TABLE IF EXISTS native_host_topology;
+        DROP TABLE IF EXISTS workspace_agents;
+        DROP TABLE IF EXISTS process_generations;
+        DROP TABLE IF EXISTS terminal_agents;
+        DROP TABLE IF EXISTS driver_profiles;
+        DROP TABLE IF EXISTS workspaces;
+        DROP TABLE IF EXISTS foreground_terminal_leases;
+        PRAGMA user_version = ${CONTROL_SCHEMA_VERSION};
+        COMMIT;
+      `);
         }
     }
     #assertCurrentControlSchema() {
@@ -259,17 +238,6 @@ export class ControlStore {
             throw new Error(`control database schema ${String(identity?.schema)} is unsupported; expected ${PRODUCT_IDENTITY.protocol.controlStoreSchema}`);
         }
     }
-    reconcilePriorBootGenerations(bootNonce) {
-        const now = new Date().toISOString();
-        return this.#transaction(() => {
-            const result = this.database.prepare(`UPDATE process_generations
-        SET state = 'interrupted', exited_at = ?, error = COALESCE(error, 'supervisor ownership ended before a terminal outcome')
-        WHERE state NOT IN ('exited', 'stopped', 'interrupted', 'error')
-          AND (owner_boot_nonce IS NULL OR owner_boot_nonce <> ?)`)
-                .run(now, bootNonce);
-            return Number(result.changes);
-        });
-    }
     createLaunchInstance(instance) {
         if (this.bootNonce === null)
             throw new Error("launch instance storage requires a supervisor boot identity");
@@ -337,161 +305,6 @@ export class ControlStore {
             .run(reconciledAt, JSON.stringify(outcome), bootNonce);
         return Number(result.changes);
     }
-    persistWorkspaceAgent(agent, updatedAt = new Date().toISOString()) {
-        const existing = this.loadWorkspaceAgentRecord(agent.id);
-        this.persistWorkspaceAgentRecord({
-            agent,
-            presentation: existing?.presentation ?? { unreadActivity: 0, attention: false, failure: null },
-        }, updatedAt);
-    }
-    persistWorkspaceAgentRecord(record, updatedAt = new Date().toISOString()) {
-        assertManagedAgentDescriptor(record.agent);
-        assertWorkspaceAgentPresentation(record.presentation);
-        this.#upsertWorkspaceAgentRecord(record, updatedAt);
-    }
-    replaceWorkspaceAgentRecords(records, selectedAgentId, revision, updatedAt = new Date().toISOString()) {
-        if (!Number.isSafeInteger(revision) || revision < 0)
-            throw new RangeError("workspace revision must be a non-negative safe integer");
-        const ids = new Set();
-        for (const record of records) {
-            assertManagedAgentDescriptor(record.agent);
-            assertWorkspaceAgentPresentation(record.presentation);
-            if (ids.has(record.agent.id))
-                throw new TypeError(`duplicate workspace agent id: ${record.agent.id}`);
-            ids.add(record.agent.id);
-        }
-        if (selectedAgentId !== null && !ids.has(selectedAgentId))
-            throw new TypeError("selected workspace agent must exist in the replacement set");
-        this.#transaction(() => {
-            if (records.length === 0)
-                this.database.prepare("DELETE FROM workspace_agents").run();
-            else {
-                const placeholders = records.map(() => "?").join(", ");
-                this.database.prepare(`DELETE FROM workspace_agents WHERE id NOT IN (${placeholders})`).run(...records.map(record => record.agent.id));
-            }
-            for (const record of records)
-                this.#upsertWorkspaceAgentRecord(record, updatedAt);
-            this.database.prepare("UPDATE workspaces SET selected_agent_id = ?, revision = ? WHERE id = ?").run(selectedAgentId, revision, INITIAL_WORKSPACE_ID);
-        });
-    }
-    loadWorkspaceAgents() {
-        return this.loadWorkspaceAgentRecords().map(record => record.agent);
-    }
-    loadWorkspaceAgentRecord(agentId) {
-        const row = this.database.prepare("SELECT * FROM workspace_agents WHERE id = ?").get(agentId);
-        return row ? workspaceAgentFromRow(row) : null;
-    }
-    loadWorkspaceAgentRecords() {
-        const rows = this.database.prepare("SELECT * FROM workspace_agents ORDER BY created_at, id").all();
-        return rows.map(workspaceAgentFromRow);
-    }
-    loadSelectedWorkspaceAgentId() {
-        const row = this.database.prepare("SELECT selected_agent_id FROM workspaces WHERE id = ?").get(INITIAL_WORKSPACE_ID);
-        return row?.selected_agent_id ?? null;
-    }
-    loadWorkspaceRevision() {
-        const row = this.database.prepare("SELECT revision FROM workspaces WHERE id = ?").get(INITIAL_WORKSPACE_ID);
-        return row?.revision ?? 0;
-    }
-    #upsertWorkspaceAgentRecord(record, updatedAt) {
-        const agent = record.agent;
-        this.database.prepare(`INSERT INTO workspace_agents
-      (id, workspace_id, display_name, adapter_id, runtime_kind, lifecycle, capability_json, recovery_reference_id, unread_count, attention, failure_json, created_at, updated_at)
-      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-      ON CONFLICT(id) DO UPDATE SET
-        workspace_id = excluded.workspace_id,
-        display_name = excluded.display_name,
-        adapter_id = excluded.adapter_id,
-        runtime_kind = excluded.runtime_kind,
-        lifecycle = excluded.lifecycle,
-        capability_json = excluded.capability_json,
-        recovery_reference_id = excluded.recovery_reference_id,
-        unread_count = excluded.unread_count,
-        attention = excluded.attention,
-        failure_json = excluded.failure_json,
-        updated_at = excluded.updated_at`)
-            .run(agent.id, INITIAL_WORKSPACE_ID, agent.displayName, agent.adapterId, agent.runtime, agent.lifecycle, JSON.stringify(agent.capability), agent.recoveryReferenceId, record.presentation.unreadActivity, record.presentation.attention ? 1 : 0, record.presentation.failure === null ? null : JSON.stringify(record.presentation.failure), agent.createdAt, updatedAt);
-    }
-    saveNativeHostTopology(topology, rollbackTopology, updatedAt = new Date().toISOString()) {
-        assertTerminalTopologySnapshot(topology);
-        if (rollbackTopology !== null)
-            assertTerminalTopologySnapshot(rollbackTopology);
-        if (rollbackTopology !== null && rollbackTopology.hostInstanceId !== topology.hostInstanceId) {
-            throw new TypeError("topology rollback metadata must identify the same native host");
-        }
-        const prior = this.loadNativeHostTopology(topology.hostInstanceId);
-        if (prior !== null && topology.revision < prior.topology.revision) {
-            throw new RangeError(`stale native-host topology revision ${topology.revision}; persisted revision is ${prior.topology.revision}`);
-        }
-        if (rollbackTopology !== null && rollbackTopology.revision > topology.revision) {
-            throw new RangeError("topology rollback revision cannot be newer than the persisted topology");
-        }
-        const rollbackJson = rollbackTopology === null
-            ? JSON.stringify({ contractVersion: 1, reason: "initial native-host topology", topology: null })
-            : JSON.stringify({ contractVersion: 1, reason: "backward-readable prior authoritative topology", topology: rollbackTopology });
-        this.database.prepare(`INSERT INTO native_host_topology
-      (host_instance_id, protocol_version, revision, topology_json, rollback_json, updated_at)
-      VALUES (?, 1, ?, ?, ?, ?)
-      ON CONFLICT(host_instance_id) DO UPDATE SET
-        revision = excluded.revision,
-        topology_json = excluded.topology_json,
-        rollback_json = excluded.rollback_json,
-        updated_at = excluded.updated_at`)
-            .run(topology.hostInstanceId, topology.revision, JSON.stringify(topology), rollbackJson, updatedAt);
-    }
-    loadNativeHostTopology(hostInstanceId) {
-        const row = this.database.prepare("SELECT * FROM native_host_topology WHERE host_instance_id = ?").get(hostInstanceId);
-        if (!row)
-            return null;
-        const topology = JSON.parse(row.topology_json);
-        assertTerminalTopologySnapshot(topology);
-        return { topology, rollback: JSON.parse(row.rollback_json), updatedAt: row.updated_at };
-    }
-    persistTerminalSession(session, hostInstanceId, paneId, lifecycle, recoveryReferenceId, updatedAt = new Date().toISOString()) {
-        assertTerminalSessionLaunch(session);
-        this.database.prepare(`INSERT INTO terminal_sessions
-      (id, host_instance_id, pane_id, lifecycle, launch_json, recovery_reference_id, updated_at)
-      VALUES (?, ?, ?, ?, ?, ?, ?)
-      ON CONFLICT(id) DO UPDATE SET
-        host_instance_id = excluded.host_instance_id,
-        pane_id = excluded.pane_id,
-        lifecycle = excluded.lifecycle,
-        launch_json = excluded.launch_json,
-        recovery_reference_id = excluded.recovery_reference_id,
-        updated_at = excluded.updated_at`)
-            .run(session.id, hostInstanceId, paneId, lifecycle, JSON.stringify(session), recoveryReferenceId, updatedAt);
-    }
-    loadTerminalSessions() {
-        const rows = this.database.prepare("SELECT * FROM terminal_sessions ORDER BY id").all();
-        return rows.map(row => {
-            const session = JSON.parse(row.launch_json);
-            assertTerminalSessionLaunch(session);
-            return { session, hostInstanceId: row.host_instance_id, paneId: row.pane_id, lifecycle: row.lifecycle, recoveryReferenceId: row.recovery_reference_id };
-        });
-    }
-    persistRecoveryReference(authority, status, rollbackMetadata, updatedAt = new Date().toISOString()) {
-        assertRecoveryAuthority(authority);
-        const createdAt = typeof rollbackMetadata.createdAt === "string" ? rollbackMetadata.createdAt : updatedAt;
-        const rollbackJson = JSON.stringify({ contractVersion: 1, ...rollbackMetadata });
-        this.database.prepare(`INSERT INTO recovery_references
-      (id, agent_id, authority_json, status, rollback_json, created_at, updated_at)
-      VALUES (?, ?, ?, ?, ?, ?, ?)
-      ON CONFLICT(id) DO UPDATE SET
-        agent_id = excluded.agent_id,
-        authority_json = excluded.authority_json,
-        status = excluded.status,
-        rollback_json = excluded.rollback_json,
-        updated_at = excluded.updated_at`)
-            .run(authority.referenceId, authority.agentId, JSON.stringify(authority), status, rollbackJson, createdAt, updatedAt);
-    }
-    loadRecoveryReference(id) {
-        const row = this.database.prepare("SELECT * FROM recovery_references WHERE id = ?").get(id);
-        if (!row)
-            return null;
-        const authority = JSON.parse(row.authority_json);
-        assertRecoveryAuthority(authority);
-        return { authority, status: row.status, rollback: JSON.parse(row.rollback_json), updatedAt: row.updated_at };
-    }
     close() {
         this.database.close();
     }
@@ -508,42 +321,6 @@ export class ControlStore {
         }
     }
 }
-function workspaceAgentFromRow(row) {
-    const descriptor = {
-        id: row.id,
-        displayName: row.display_name,
-        adapterId: row.adapter_id,
-        runtime: row.runtime_kind,
-        lifecycle: row.lifecycle,
-        capability: JSON.parse(row.capability_json),
-        createdAt: row.created_at,
-        recoveryReferenceId: row.recovery_reference_id,
-    };
-    assertManagedAgentDescriptor(descriptor);
-    const failure = row.failure_json === null ? null : JSON.parse(row.failure_json);
-    const presentation = {
-        unreadActivity: row.unread_count,
-        attention: row.attention === 1,
-        failure,
-    };
-    assertWorkspaceAgentPresentation(presentation);
-    return { agent: descriptor, presentation };
-}
-function assertWorkspaceAgentPresentation(presentation) {
-    if (!Number.isSafeInteger(presentation.unreadActivity) || presentation.unreadActivity < 0) {
-        throw new RangeError("workspace unread activity must be a non-negative safe integer");
-    }
-    if (typeof presentation.attention !== "boolean")
-        throw new TypeError("workspace attention must be boolean");
-    if (presentation.failure !== null) {
-        if (!presentation.failure.code || presentation.failure.code.length > 128 || presentation.failure.code.includes("\0")) {
-            throw new TypeError("workspace failure code is invalid");
-        }
-        if (!presentation.failure.message || presentation.failure.message.length > 4_096 || presentation.failure.message.includes("\0")) {
-            throw new TypeError("workspace failure message is invalid");
-        }
-    }
-}
 function launchInstanceFromRow(row) {
     const instance = {
         id: row.id,

package/dist/foundation/storage/index.d.ts

@@ -1 +1 @@
-export * from "./control-store.js";
+export { ControlStore } from "./control-store.js";

package/dist/foundation/storage/index.js

@@ -1 +1 @@
-export * from "./control-store.js";
+export { ControlStore } from "./control-store.js";

package/dist/foundation/supervision/index.d.ts

@@ -1,3 +1,3 @@
-export * from "./main.js";
-export * from "./server.js";
+export { runSupervisor } from "./main.js";
+export { SupervisorServer, commitEndpointMetadata } from "./server.js";
 export { resolveCohortEndpoint, resolveProductPaths, type CohortEndpointPaths, type ProductPaths } from "../lifecycle/index.js";

package/dist/foundation/supervision/index.js

@@ -1,3 +1,3 @@
-export * from "./main.js";
-export * from "./server.js";
+export { runSupervisor } from "./main.js";
+export { SupervisorServer, commitEndpointMetadata } from "./server.js";
 export { resolveCohortEndpoint, resolveProductPaths } from "../lifecycle/index.js";

package/dist/foundation/supervision/server.d.ts

@@ -15,23 +15,18 @@ export declare function commitEndpointMetadata(path: string, source: string, ope
 /** Owns one release-cohort endpoint and the authenticated launch instances registered through it. */
 export declare class SupervisorServer {
     #private;
+    readonly id: `${string}-${string}-${string}-${string}-${string}`;
+    readonly bootNonce: string;
+    readonly pidStartIdentity: string;
+    readonly startedAt: string;
+    readonly paths: ProductPaths;
     readonly store: ControlStore;
     readonly release: MaterializedRelease;
     readonly terminateProcess: (code: number) => void;
     readonly reconciliationDeadlineMs: number;
     readonly shutdownDeadlineMs: number;
-    /**
-     * Which release new sessions start on. A cohort that is no longer that release keeps
-     * serving the instances it already has, takes no new ones, and exits when its last one
-     * leaves. Absent, this supervisor never considers itself superseded.
-     */
     readonly readActiveReleaseId: (() => Promise<string | null>) | null;
     readonly supersededPollMs: number;
-    readonly id: `${string}-${string}-${string}-${string}-${string}`;
-    readonly bootNonce: string;
-    readonly pidStartIdentity: string;
-    readonly startedAt: string;
-    readonly paths: ProductPaths;
     constructor(store: ControlStore, paths: ProductPaths | undefined, release: MaterializedRelease, bootNonce?: string, terminateProcess?: (code: number) => void, reconciliationDeadlineMs?: number, shutdownDeadlineMs?: number, 
     /**
      * Which release new sessions start on. A cohort that is no longer that release keeps

package/dist/foundation/supervision/server.js

@@ -41,13 +41,6 @@ export async function commitEndpointMetadata(path, source, operations = {}) {
 }
 /** Owns one release-cohort endpoint and the authenticated launch instances registered through it. */
 export class SupervisorServer {
-    store;
-    release;
-    terminateProcess;
-    reconciliationDeadlineMs;
-    shutdownDeadlineMs;
-    readActiveReleaseId;
-    supersededPollMs;
     id = randomUUID();
     bootNonce;
     pidStartIdentity = `${process.pid}:${Math.floor(Date.now() - process.uptime() * 1_000)}`;
@@ -68,6 +61,13 @@ export class SupervisorServer {
     #closing = false;
     #superseded = false;
     #supersededPoll = null;
+    store;
+    release;
+    terminateProcess;
+    reconciliationDeadlineMs;
+    shutdownDeadlineMs;
+    readActiveReleaseId;
+    supersededPollMs;
     constructor(store, paths = resolveProductPaths(), release, bootNonce = randomUUID(), terminateProcess = code => process.exit(code), reconciliationDeadlineMs = 3_000, shutdownDeadlineMs = 1_500, 
     /**
      * Which release new sessions start on. A cohort that is no longer that release keeps

package/dist/foundation/terminal-cleanup/index.d.ts

@@ -1,2 +1,3 @@
-export * from "./terminal-reset.js";
-export * from "./fatal-exit.js";
+export { EMERGENCY_TERMINAL_RESET, boundedCleanup, restoreAfterOwnedExit, restoreProcessTerminal } from "./terminal-reset.js";
+export { installFatalExit, writeFatalDiagnostic } from "./fatal-exit.js";
+export type { FatalExitOptions } from "./fatal-exit.js";

package/dist/foundation/terminal-cleanup/index.js

@@ -1,2 +1,2 @@
-export * from "./terminal-reset.js";
-export * from "./fatal-exit.js";
+export { EMERGENCY_TERMINAL_RESET, boundedCleanup, restoreAfterOwnedExit, restoreProcessTerminal } from "./terminal-reset.js";
+export { installFatalExit, writeFatalDiagnostic } from "./fatal-exit.js";

package/dist/integrations/pi/components/editor-interaction.d.ts

@@ -1,4 +1,4 @@
-import type { Editor } from "#pi-tui";
+import type { Editor } from "@earendil-works/pi-tui";
 export interface EditorInteractionState {
     lines: string[];
     cursorLine: number;

package/dist/integrations/pi/components/history-editor-loader.d.ts

@@ -1,5 +1,5 @@
 import { type ShellEditorInstance, type OwnedEditorOptions } from "./upstream/components/owned-editor.js";
-import type { EditorTheme, TUI } from "#pi-tui";
+import type { EditorTheme, TUI } from "@earendil-works/pi-tui";
 import type { KeybindingsManager } from "./upstream/adjacent/core/keybindings.js";
 export type HistoryEditorConstructor = new (tui: TUI, theme: EditorTheme, keybindings: KeybindingsManager, options?: OwnedEditorOptions) => ShellEditorInstance;
 export declare function loadHistoryEditor(): Promise<HistoryEditorConstructor>;

package/dist/integrations/pi/components/index.d.ts

@@ -1,14 +1,21 @@
-export * from "./components.js";
+export { adaptPiAssistantMessage, adaptPiToolExecution, adaptPiUserMessage } from "./components.js";
 export { loadHistoryEditor, type HistoryEditorConstructor } from "./history-editor-loader.js";
-export * from "./conformance.js";
-export * from "./shell-components.js";
-export * from "./theme.js";
-export * from "./upstream/theme/theme-controller.js";
-export { applyConfiguredPiTheme, getAvailablePiThemes, onPiThemeChange } from "./upstream/theme/theme.js";
-export * from "./upstream/components/countdown-timer.js";
-export * from "./upstream/components/extension-editor.js";
-export * from "./upstream/components/session-selector.js";
-export * from "./upstream/components/session-selector-search.js";
-export * from "./upstream/components/status-indicator.js";
-export * from "./upstream/components/tree-selector.js";
-export * from "./upstream/adjacent/core/keybindings.js";
+export { PiComponentConformanceError, runPiComponentConformance } from "./conformance.js";
+export type { PiComponentConformanceReport, PiComponentConformanceResult } from "./conformance.js";
+export { PINNED_PI_BUILTIN_SLASH_COMMANDS, componentFromPort, componentPort, createPiExtensionUiBridge, createPiQueuedInputStatus, createPiShellArmin, createPiShellAuthProviderSelector, createPiShellChangelog, createPiShellCollapsedChangelog, createPiShellDaxnuts, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellEditor, createPiShellExtensionSelector, createPiShellFooter, createPiShellHeader, createPiShellHotkeys, createPiShellLoadedResources, createPiShellLoginDialog, createPiShellModelSelector, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionInfo, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellShowImagesSelector, createPiShellStatus, createPiShellThemeSelector, createPiShellThinkingSelector, createPiShellTranscriptComponent, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, createTuiFacade, ensureTheme, formatSessionTokens, isAutocompleteProvider, isPiPromptStyleCompaction, isRecord, paintPiSubmittedPromptTimestamp, piShellHyperlink, piShellTruncateToWidth, piShellVisibleWidth, renderPiShellCommandMessage, renderPiShellPackageUpdateNotice, renderPiShellStartupDiagnostic, renderPiShellStatusText, renderPiShellTranscriptBlock, validatedAssistantMessage, } from "./shell-components.js";
+export type { PiExtensionUiBridge, PiExtensionUiBridgeHost, PiShellAuthProviderOption, PiShellAutocompleteCommand, PiShellClipboardContent, PiShellCommandMessagePresentation, PiShellComponentPort, PiShellEditorBodyGeometry, PiShellEditorOptions, PiShellEditorPointerEvent, PiShellEditorPort, PiShellEditorTextRange, PiShellExtensionRendererResolver, PiShellHeaderOptions, PiShellHeaderPort, PiShellImageAssetResolver, PiShellLoadedResourcesPort, PiShellLoginDialogPort, PiShellModelSelectorOptions, PiShellOperationLoaderPort, PiShellPasteReservation, PiShellQueuedInputPort, PiShellResourceEntry, PiShellResourceSection, PiShellScopedModelDescriptor, PiShellScopedModelsSelectorOptions, PiShellScopedModelsSelectorPort, PiShellSelectorOption, PiShellSelectorOptions, PiShellSessionInfoPresentation, PiShellSettingsSelectorOptions, PiShellStartupNotice, PiShellStatusPlacement, PiShellStatusPort, PiShellSubmittedPromptComposer, PiShellTranscriptComponentPort, PiShellViewComponentPort, } from "./shell-components.js";
+export { PINNED_PI_LAYOUT, applyConfiguredPiTheme, applyPiTheme, applyPiThemeInstance, currentPiThemeName, detectPiTerminalBackgroundFromEnv, detectPiTerminalBackgroundTheme, detectPiTerminalThemeForAuto, ensurePiTheme, getAvailablePiThemes, loadPiTheme, onPiThemeChange, parsePiAutoThemeSetting, piTheme, resolvePiThemeSetting, stopPiThemeWatcher, } from "./theme.js";
+export type { PiColorMode, PiTerminalTheme, PiTerminalThemeDetection, PiTerminalThemeDetector, PiThemeBackground, PiThemeResult } from "./theme.js";
+export { OwnedPiThemeController } from "./upstream/theme/theme-controller.js";
+export type { PiThemeRuntimePort, PiThemeSettingsPort } from "./upstream/theme/theme-controller.js";
+export { CountdownTimer } from "./upstream/components/countdown-timer.js";
+export { ExtensionEditorComponent } from "./upstream/components/extension-editor.js";
+export { SessionSelectorComponent } from "./upstream/components/session-selector.js";
+export { filterAndSortSessions, hasSessionName, matchSession, parseSearchQuery } from "./upstream/components/session-selector-search.js";
+export type { MatchResult, NameFilter, ParsedSearchQuery, SortMode } from "./upstream/components/session-selector-search.js";
+export { BranchSummaryStatusIndicator, CompactionStatusIndicator, IdleStatus, RetryStatusIndicator, StatusIndicator, WorkingStatusIndicator, } from "./upstream/components/status-indicator.js";
+export type { CompactionStatusReason, StatusIndicatorKind } from "./upstream/components/status-indicator.js";
+export { TreeSelectorComponent } from "./upstream/components/tree-selector.js";
+export type { FilterMode } from "./upstream/components/tree-selector.js";
+export { KEYBINDINGS, KeybindingsManager, migrateKeybindingsConfig } from "./upstream/adjacent/core/keybindings.js";
+export type { AppKeybinding, AppKeybindings, KeyId, Keybinding, KeybindingsConfig } from "./upstream/adjacent/core/keybindings.js";

package/dist/integrations/pi/components/index.js

@@ -1,14 +1,13 @@
-export * from "./components.js";
+export { adaptPiAssistantMessage, adaptPiToolExecution, adaptPiUserMessage } from "./components.js";
 export { loadHistoryEditor } from "./history-editor-loader.js";
-export * from "./conformance.js";
-export * from "./shell-components.js";
-export * from "./theme.js";
-export * from "./upstream/theme/theme-controller.js";
-export { applyConfiguredPiTheme, getAvailablePiThemes, onPiThemeChange } from "./upstream/theme/theme.js";
-export * from "./upstream/components/countdown-timer.js";
-export * from "./upstream/components/extension-editor.js";
-export * from "./upstream/components/session-selector.js";
-export * from "./upstream/components/session-selector-search.js";
-export * from "./upstream/components/status-indicator.js";
-export * from "./upstream/components/tree-selector.js";
-export * from "./upstream/adjacent/core/keybindings.js";
+export { PiComponentConformanceError, runPiComponentConformance } from "./conformance.js";
+export { PINNED_PI_BUILTIN_SLASH_COMMANDS, componentFromPort, componentPort, createPiExtensionUiBridge, createPiQueuedInputStatus, createPiShellArmin, createPiShellAuthProviderSelector, createPiShellChangelog, createPiShellCollapsedChangelog, createPiShellDaxnuts, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellEditor, createPiShellExtensionSelector, createPiShellFooter, createPiShellHeader, createPiShellHotkeys, createPiShellLoadedResources, createPiShellLoginDialog, createPiShellModelSelector, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionInfo, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellShowImagesSelector, createPiShellStatus, createPiShellThemeSelector, createPiShellThinkingSelector, createPiShellTranscriptComponent, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, createTuiFacade, ensureTheme, formatSessionTokens, isAutocompleteProvider, isPiPromptStyleCompaction, isRecord, paintPiSubmittedPromptTimestamp, piShellHyperlink, piShellTruncateToWidth, piShellVisibleWidth, renderPiShellCommandMessage, renderPiShellPackageUpdateNotice, renderPiShellStartupDiagnostic, renderPiShellStatusText, renderPiShellTranscriptBlock, validatedAssistantMessage, } from "./shell-components.js";
+export { PINNED_PI_LAYOUT, applyConfiguredPiTheme, applyPiTheme, applyPiThemeInstance, currentPiThemeName, detectPiTerminalBackgroundFromEnv, detectPiTerminalBackgroundTheme, detectPiTerminalThemeForAuto, ensurePiTheme, getAvailablePiThemes, loadPiTheme, onPiThemeChange, parsePiAutoThemeSetting, piTheme, resolvePiThemeSetting, stopPiThemeWatcher, } from "./theme.js";
+export { OwnedPiThemeController } from "./upstream/theme/theme-controller.js";
+export { CountdownTimer } from "./upstream/components/countdown-timer.js";
+export { ExtensionEditorComponent } from "./upstream/components/extension-editor.js";
+export { SessionSelectorComponent } from "./upstream/components/session-selector.js";
+export { filterAndSortSessions, hasSessionName, matchSession, parseSearchQuery } from "./upstream/components/session-selector-search.js";
+export { BranchSummaryStatusIndicator, CompactionStatusIndicator, IdleStatus, RetryStatusIndicator, StatusIndicator, WorkingStatusIndicator, } from "./upstream/components/status-indicator.js";
+export { TreeSelectorComponent } from "./upstream/components/tree-selector.js";
+export { KEYBINDINGS, KeybindingsManager, migrateKeybindingsConfig } from "./upstream/adjacent/core/keybindings.js";

package/dist/integrations/pi/components/owned-editor-ux.js

@@ -1,13 +1,10 @@
 import { ImageAttachmentError, MAX_CLIPBOARD_TEXT_BYTES } from "../../../contracts/owned-ui/index.js";
-import { CURSOR_MARKER, decodeKittyPrintable, visibleWidth, } from "#pi-tui";
+import { CURSOR_MARKER, decodeKittyPrintable, visibleWidth, } from "@earendil-works/pi-tui";
 import { promptPathWordRanges } from "./path-word-ranges.js";
 export class OwnedEditorUxInterception {
     interceptors;
     fallback;
-    constructor(interceptors, fallback) {
-        this.interceptors = interceptors;
-        this.fallback = fallback;
-    }
+    constructor(interceptors, fallback) { this.interceptors = interceptors; this.fallback = fallback; }
     handleInput(data) {
         const invoke = (index, input) => {
             const interceptor = this.interceptors[index];
@@ -57,9 +54,6 @@ export function createPromptSelectionInterceptor(editor, keybindings, options) {
     return new PromptSelectionInterceptor(editor, keybindings, options);
 }
 class PromptSelectionInterceptor {
-    editor;
-    keybindings;
-    options;
     #selection;
     #pointerSelecting = false;
     #lastClick;
@@ -69,6 +63,9 @@ class PromptSelectionInterceptor {
     #terminalPaste;
     #wordDirection;
     #geometry;
+    editor;
+    keybindings;
+    options;
     constructor(editor, keybindings, options) {
         this.editor = editor;
         this.keybindings = keybindings;