@songsid/agend 2.3.4-beta.6 → 2.3.5-alpha.2

package/dist/native-pane-lifecycle.d.ts

@@ -0,0 +1,65 @@
+import type { CliBackend } from "./backend/types.js";
+import type { Pane, PaneHost, PaneObservation } from "./pane-port.js";
+import { RuntimePanePort, RuntimePaneHostPort, RuntimePaneObservation, type PaneEndpoint } from "./runtime-pane-port.js";
+import { RuntimeTranscriptDeltaReader } from "./runtime-transcript-delta-reader.js";
+import { type RuntimeTranscriptReference } from "./runtime-pane-transcript-protocol.js";
+import type { TranscriptSource } from "./transcript-sources.js";
+import type { TranscriptNeedle } from "./transcript-needles.js";
+import type { RuntimePaneLaunch, RuntimePaneSnapshot } from "./runtime-pane-protocol.js";
+export interface NativePaneAcquisition {
+    pane: Pane;
+    source: TranscriptSource;
+    disposition: "reattached" | "resumed" | "fresh";
+}
+export interface NativePaneLifecycle {
+    bindDaemon?(daemon: import("./daemon.js").Daemon): void;
+    readonly host: PaneHost;
+    readonly observation: PaneObservation;
+    readonly backend: CliBackend;
+    acquire(assertCurrent: () => void): Promise<NativePaneAcquisition>;
+    release(intent: "detach" | "close"): Promise<void>;
+    proofReader(reference: RuntimeTranscriptReference, needle: TranscriptNeedle): RuntimeTranscriptDeltaReader;
+    current(reference?: RuntimeTranscriptReference): boolean;
+    mcpProof(): "alive" | "dead" | "unknown";
+    checkpointSession(): void;
+    snapshot?(): RuntimePaneSnapshot | null;
+}
+export interface NativePaneLifecycleOptions {
+    endpoint: PaneEndpoint;
+    receiptFile: string;
+    launch: RuntimePaneLaunch;
+    /** Codex fresh intent keeps its previous pin until this launch reports an identity. */
+    freshPrevious?: RuntimePaneSnapshot;
+    /** Checks switches, exact audited provider version, configuration, and the current daemon admission. */
+    admit(): void;
+    /** Must reserve the legacy profile activeId before the first remote spawn. */
+    reserve(launchId: string): void;
+    pin(launchId: string, sessionId: string): void;
+    exited(snapshot: RuntimePaneSnapshot): void;
+    mcpProof(): "alive" | "dead" | "unknown";
+    releaseAuthority(): void;
+    acquired?(): void | Promise<void>;
+    bindDaemon?(daemon: import("./daemon.js").Daemon): void;
+}
+export declare class RuntimeNativePaneLifecycle implements NativePaneLifecycle {
+    private options;
+    readonly port: RuntimePanePort;
+    readonly host: RuntimePaneHostPort;
+    readonly observation: RuntimePaneObservation;
+    readonly backend: CliBackend;
+    private detached;
+    private releasedExit;
+    private source;
+    private readonly transcriptPort;
+    constructor(options: NativePaneLifecycleOptions);
+    bindDaemon(daemon: import("./daemon.js").Daemon): void;
+    current(reference?: RuntimeTranscriptReference): boolean;
+    snapshot(): RuntimePaneSnapshot | null;
+    mcpProof(): "alive" | "dead" | "unknown";
+    checkpointSession(): void;
+    private ready;
+    private codexIdentity;
+    acquire(assertCurrent: () => void): Promise<NativePaneAcquisition>;
+    proofReader(reference: RuntimeTranscriptReference, needle: TranscriptNeedle): RuntimeTranscriptDeltaReader;
+    release(intent: "detach" | "close"): Promise<void>;
+}

package/dist/native-pane-lifecycle.js

@@ -0,0 +1,227 @@
+/** Optional native adapter for the ordinary Daemon. The runner retains processes across coordinator detach. */
+import { NativePaneRecoveryError } from "./native-pane-recovery.js";
+import { createNativePaneBackend } from "./backend/native-pane.js";
+import { RuntimePanePort, RuntimePaneHostPort, RuntimePaneObservation } from "./runtime-pane-port.js";
+import { RuntimeTranscriptSource } from "./runtime-transcript-source.js";
+import { RuntimeTranscriptDeltaReader } from "./runtime-transcript-delta-reader.js";
+import { PANE_TRANSCRIPT_EMPTY_ANCHOR } from "./runtime-pane-transcript-protocol.js";
+export class RuntimeNativePaneLifecycle {
+    options;
+    port;
+    host;
+    observation;
+    backend;
+    detached = false;
+    releasedExit = false;
+    source;
+    transcriptPort;
+    constructor(options) {
+        this.options = options;
+        if (!options.launch.launchId)
+            throw Error("Native daemon requires a reserved launch identity");
+        this.port = new RuntimePanePort(options.endpoint, options.receiptFile, options.launch, screen => {
+            const backend = this.backend;
+            if ([...(backend.getStartupDialogs?.() ?? []), ...(backend.getRuntimeDialogs?.() ?? [])].some(dialog => dialog.pattern.test(screen) && (!dialog.isActive || dialog.isActive(screen))))
+                return false;
+            // Composer-only callers retain the structural reader. Daemon delivery and explicit human answers carry separate proofs.
+            return backend.readInputRow ? backend.readInputRow(screen) != null
+                : backend.isDeliveryInputReadyPane?.(screen) === true || backend.ownsComposerRows?.(screen) === true;
+        });
+        this.transcriptPort = { isTranscriptObservationCurrent: reference => this.current(reference),
+            readTranscriptBaseline: (cursor, current) => this.port.readTranscriptBaseline(cursor, () => !this.detached && (current?.() ?? true)),
+            readTranscript: (cursor, current) => this.port.readTranscript(cursor, () => !this.detached && (current?.() ?? true)) };
+        this.host = new RuntimePaneHostPort(this.port, options.endpoint);
+        this.observation = new RuntimePaneObservation(options.endpoint, () => this.port.ownedSnapshot());
+        this.backend = createNativePaneBackend(options.launch.cli, () => ({ sessionId: this.port.ownedSnapshot()?.sessionId ?? null,
+            cwd: options.launch.cwd, contextPercentage: null, statusLineItems: ["context-remaining"], resumes: !!options.launch.sessionId || !!this.port.ownedSnapshot()?.sessionId }));
+    }
+    bindDaemon(daemon) { this.options.bindDaemon?.(daemon); }
+    current(reference) {
+        if (this.detached || !this.options.endpoint.online())
+            return false;
+        if (reference)
+            return this.port.isTranscriptObservationCurrent(reference);
+        return this.port.observedSnapshot()?.state === "running";
+    }
+    snapshot() { return this.port.observedSnapshot(); }
+    mcpProof() { return this.current() ? this.options.mcpProof() : "unknown"; }
+    checkpointSession() {
+        const pane = this.port.ownedSnapshot();
+        if (pane?.sessionId && !this.releasedExit)
+            this.options.pin(pane.launchId, pane.sessionId);
+    }
+    ready(text) {
+        const backend = this.backend;
+        return (backend.isDeliveryInputReadyPane?.(text) ?? backend.getReadyPattern().test(text)) && !backend.getBusyPattern?.()?.test(text)
+            && ![...(backend.getStartupDialogs?.() ?? []), ...(backend.getRuntimeDialogs?.() ?? [])].some(dialog => dialog.pattern.test(text) && (!dialog.isActive || dialog.isActive(text)));
+    }
+    async codexIdentity(assertCurrent, reattached) {
+        const expected = this.port.ownedSnapshot()?.sessionId;
+        // A reattached live pane may be busy. Its durable pin is already tied to that same launch: never type /status into it.
+        if (reattached) {
+            if (expected)
+                return;
+            throw Error("Reattached native conversation is unconfirmed; retained status needs inspection, no startup input was sent");
+        }
+        // Output can invalidate a capture while the VT parser is settling. Retrying a read cannot replay input;
+        // admission, the exact pane owner and the original wall-clock deadline still apply to every attempt.
+        const observe = async (deadline, history = false) => {
+            for (;;) {
+                assertCurrent();
+                this.options.admit();
+                try {
+                    const text = history ? await this.port.capturePaneJoined(200) : await this.port.capturePane();
+                    assertCurrent();
+                    return text;
+                }
+                catch (error) {
+                    assertCurrent();
+                    this.options.admit();
+                    if (!this.current() || performance.now() >= deadline)
+                        throw error;
+                }
+                await new Promise(resolve => setTimeout(resolve, 250));
+            }
+        };
+        let text = "", until = performance.now() + 120_000;
+        while (true) {
+            text = await observe(until);
+            if (this.ready(text))
+                break;
+            if ((await this.port.getPaneStatus())?.alive === false)
+                throw Error("Native Codex composer needs attention before conversation verification");
+            if (performance.now() >= until)
+                throw Error("Native Codex composer needs attention before conversation verification");
+            await new Promise(resolve => setTimeout(resolve, 250));
+        }
+        const readId = (pane) => {
+            const matches = [...pane.matchAll(/\bSession:\s*([a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})\b/gi)];
+            return matches.length === 1 ? matches[0][1] : null;
+        };
+        let id = null;
+        if (await this.port.beginStatusRequest()) {
+            assertCurrent();
+            // This fixed CLI command must be typed: a bracketed slash-command paste is literal prompt text in Codex.
+            // Only a positive zero-input refusal admits another attempt; a lost response keeps the durable one-shot hold.
+            const send = async (write, message) => {
+                for (let attempt = 0; attempt < 4; attempt++) {
+                    assertCurrent();
+                    this.options.admit();
+                    if (!this.current())
+                        throw Error(message);
+                    if (await write())
+                        return;
+                    if (!this.port.lastInputWasNotSent() || attempt === 3)
+                        throw Error(message);
+                    await new Promise(resolve => setTimeout(resolve, 250));
+                }
+            };
+            await send(() => this.port.sendKeys("/status"), "Native status input is unconfirmed");
+            await new Promise(resolve => setTimeout(resolve, 500));
+            assertCurrent();
+            this.options.admit();
+            await send(async () => {
+                // The typed /status may still be painting: re-read the same pane (typing nothing) until it shows the exact
+                // composer or the bound expires. Only a positively verified screen reaches Enter.
+                const deadline = performance.now() + 15_000;
+                for (;;) {
+                    const screen = await observe(deadline);
+                    assertCurrent();
+                    this.options.admit();
+                    if (this.ready(screen) && /^[ \t]*[>›][ \t]*\/status[ \t]*$/m.test(screen)) {
+                        return this.port.sendSpecialKey("Enter", undefined, { kind: "composer", screen });
+                    }
+                    if (performance.now() >= deadline)
+                        throw Error("Native status composer changed; no Enter was sent");
+                    await new Promise(resolve => setTimeout(resolve, 250));
+                }
+            }, "Native status submission is unconfirmed");
+            until = performance.now() + 15_000;
+            while (true) {
+                text = await observe(until, true);
+                id = readId(text);
+                if (id && this.ready(text))
+                    break;
+                if (performance.now() >= until)
+                    throw Error("Native session status identity was not confirmed; no second Enter was sent");
+                await new Promise(resolve => setTimeout(resolve, 250));
+            }
+        }
+        else {
+            id = readId(await observe(performance.now() + 15_000, true));
+            assertCurrent();
+            if (!id)
+                throw Error("Native session status request is retained; inspect its outcome before another input");
+        }
+        if (expected && id !== expected)
+            throw Error("Native resume displayed a different conversation; its original pin is retained");
+        await this.port.bindConversation(id);
+        assertCurrent();
+    }
+    async acquire(assertCurrent) {
+        if (this.detached)
+            throw Error("Native daemon lease was detached");
+        assertCurrent();
+        this.options.admit();
+        this.options.reserve(this.options.launch.launchId);
+        const opened = await this.port.open();
+        assertCurrent();
+        this.options.admit();
+        this.observation.start();
+        await this.observation.registerWindow(opened.windowId);
+        assertCurrent();
+        if (this.options.launch.cli === "codex") {
+            try {
+                await this.codexIdentity(assertCurrent, opened.reattached);
+            }
+            catch (error) {
+                assertCurrent();
+                this.options.admit();
+                if (!this.port.ownedSnapshot()?.sessionId && (this.options.freshPrevious || this.port.ownedSnapshot()?.state === "exited")) {
+                    // End only this exact owned attempt before exposing an admin decision. Unknown close evidence keeps its slot.
+                    await this.release("close");
+                    throw new NativePaneRecoveryError({ kind: "session-unconfirmed", provider: "codex", launchId: this.options.launch.launchId, sessionId: this.options.freshPrevious?.sessionId });
+                }
+                throw error;
+            }
+        }
+        this.checkpointSession();
+        assertCurrent();
+        const pane = this.port.ownedSnapshot();
+        if (!pane?.sessionId)
+            throw Error("Native conversation is not pinned");
+        this.source ??= new RuntimeTranscriptSource(this.transcriptPort, this.port.runtimeTranscriptReference({ sessionId: pane.sessionId, offset: 0, fileId: null, anchor: PANE_TRANSCRIPT_EMPTY_ANCHOR }), !this.options.launch.sessionId);
+        await this.options.acquired?.();
+        assertCurrent();
+        return { pane: this.port, source: this.source, disposition: opened.reattached ? "reattached" : this.options.launch.sessionId ? "resumed" : "fresh" };
+    }
+    proofReader(reference, needle) {
+        if (!this.current(reference))
+            throw Error("Native delivery transcript owner is unavailable");
+        return new RuntimeTranscriptDeltaReader(this.transcriptPort, reference, needle);
+    }
+    async release(intent) {
+        if (this.detached) {
+            if (intent === "close" && !this.releasedExit)
+                throw Error("Native close lease was detached; refresh its current owner first");
+            return;
+        }
+        // Detaching revokes coordinator tool authority but preserves the runner, its helper and the profile reservation.
+        if (intent === "close") {
+            const pane = this.port.ownedSnapshot() ?? await this.port.inspectRetained();
+            if (pane.state !== "exited" && !await this.port.killWindowConfirmed())
+                throw Error("Native pane exit is unconfirmed; its reservation is retained");
+            const exited = this.port.ownedSnapshot();
+            if (exited && !this.releasedExit) {
+                this.options.exited(exited);
+                this.releasedExit = true;
+            }
+        }
+        this.detached = true;
+        this.port.closeOutput();
+        this.source?.close();
+        this.observation.stop();
+        this.options.releaseAuthority();
+    }
+}
+//# sourceMappingURL=native-pane-lifecycle.js.map

package/dist/native-pane-lifecycle.js.map

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

package/dist/native-pane-manager.d.ts

@@ -0,0 +1,58 @@
+import { RuntimeNativePaneLifecycle } from "./native-pane-lifecycle.js";
+import { type PaneMcpBody } from "./runtime-pane-mcp-protocol.js";
+import type { PaneEndpoint } from "./runtime-pane-port.js";
+import type { WindowsAgent, WindowsAgents } from "./windows-agents.js";
+import type { InstanceConfig } from "./types.js";
+import type { Daemon } from "./daemon.js";
+export interface NativeMachineEndpoint extends PaneEndpoint {
+    epoch(): string | null;
+    version(provider: string): string | null;
+}
+export interface NativePaneManagerOptions {
+    home: string;
+    store: WindowsAgents;
+    config(name: string): InstanceConfig | undefined;
+    endpoint(agent: WindowsAgent, cleanup?: boolean): Promise<NativeMachineEndpoint>;
+    admit(name: string, config: InstanceConfig): void;
+    instructions(name: string, config: InstanceConfig): string;
+    menu(name: string): Array<{
+        name: string;
+        [key: string]: unknown;
+    }>;
+    allowed(name: string, tool: string, args: Record<string, unknown>): boolean;
+    published(name: string, daemon: Daemon): boolean;
+    freshNotice?(name: string, provider?: "codex" | "claude-code"): Promise<void> | void;
+    invoke(daemon: Daemon, input: {
+        tool: string;
+        args: Record<string, unknown>;
+        operationId: string;
+    }, current: () => boolean, name: string): Promise<{
+        result: unknown;
+        error?: string;
+    }>;
+}
+export declare class NativePaneManager {
+    private options;
+    private bindings;
+    private preparing;
+    constructor(options: NativePaneManagerOptions);
+    private directory;
+    private load;
+    private save;
+    private configurationHash;
+    private newManifest;
+    private freshIntent;
+    private bindFreshCodex;
+    private recordExit;
+    private sessionState;
+    /** Prepare metadata and helper authority first; acquire() alone may reserve and spawn. */
+    prepare(name: string, config: InstanceConfig, assertCurrent: () => void): Promise<RuntimeNativePaneLifecycle>;
+    private prepareOwned;
+    /** Administrator chooses a new conversation for this exact stopped, held pin. No provider files are changed. */
+    startFresh(name: string, config: InstanceConfig, launchId: string, sessionId: string | null, assertCurrent: () => void): Promise<void>;
+    /** Explicit admin attestation, bound to the held launch; no keys, tool calls or process signals. */
+    recover(name: string, config: InstanceConfig, launchId: string, confirmedStopped: boolean, assertCurrent: () => void): Promise<void>;
+    /** Close only the retained exact launch. Offline, missing, or unknown exit remains reserved. */
+    closeRetained(name: string, config: InstanceConfig, assertCurrent: () => void): Promise<void>;
+    handle(machineId: string, raw: PaneMcpBody, transport: () => boolean): Promise<unknown>;
+}