@termlink/cli 0.1.0

package/dist/session/manager.js

@@ -0,0 +1,282 @@
+import { realpath, stat } from "node:fs/promises";
+import path from "node:path";
+import { HostError, errorMessage } from "../errors.js";
+import { newId } from "../util/id.js";
+import { AgentSession } from "./session.js";
+import { TerminalSession } from "./terminal-session.js";
+const PERSIST_DELAY_MS = 100;
+const DEFAULT_COLS = 80;
+const DEFAULT_ROWS = 24;
+/** Owns all sessions on this host and fans host-channel events out to every connection. */
+export class SessionManager {
+    #providers = new Map();
+    #sessions = new Map();
+    #hostListeners = new Set();
+    #logCapacity;
+    #roots;
+    #store;
+    #autoApprove;
+    #flow;
+    #persistTimer = null;
+    #stopping = false;
+    constructor(options) {
+        for (const provider of options.providers)
+            this.#providers.set(provider.id, provider);
+        this.#logCapacity = options.logCapacity;
+        this.#roots = options.allowedRoots?.map((root) => path.resolve(root));
+        this.#store = options.store;
+        this.#autoApprove = options.autoApprove ?? "off";
+        this.#flow = options.flow ?? {};
+    }
+    /** Folders sessions may be opened in, or undefined when unrestricted. */
+    get roots() {
+        return this.#roots ? [...this.#roots] : undefined;
+    }
+    onHostEvent(listener) {
+        this.#hostListeners.add(listener);
+        return () => this.#hostListeners.delete(listener);
+    }
+    async providerStatuses() {
+        return Promise.all([...this.#providers.values()].map(async (provider) => {
+            const identity = { id: provider.id, kind: provider.kind, label: provider.label };
+            try {
+                return { ...identity, ...(await provider.probe()) };
+            }
+            catch (err) {
+                return { ...identity, available: false, version: null, detail: errorMessage(err) };
+            }
+        }));
+    }
+    list() {
+        return [...this.#sessions.values()].map((s) => s.info);
+    }
+    get(sessionId) {
+        const session = this.#sessions.get(sessionId);
+        if (!session)
+            throw new HostError("not_found", `no session ${sessionId}`);
+        return session;
+    }
+    /** The session, if it is an agent session; commands for turns and approvals need one. */
+    agent(sessionId) {
+        const session = this.get(sessionId);
+        if (!(session instanceof AgentSession))
+            throw new HostError("unsupported", `${sessionId} is a terminal session`);
+        return session;
+    }
+    terminal(sessionId) {
+        const session = this.get(sessionId);
+        if (!(session instanceof TerminalSession))
+            throw new HostError("unsupported", `${sessionId} is not a terminal session`);
+        return session;
+    }
+    async create(options) {
+        const provider = this.#providers.get(options.provider);
+        if (!provider)
+            throw new HostError("unsupported", `provider ${options.provider} is not enabled on this host`);
+        const cwd = await this.#resolveCwd(options.cwd);
+        return provider.kind === "terminal"
+            ? this.#createTerminal(provider, cwd, options)
+            : this.#createAgent(provider, cwd, options);
+    }
+    /** create() for callers that need an agent session, such as tests. */
+    async createAgent(options) {
+        const session = await this.create(options);
+        if (!(session instanceof AgentSession)) {
+            await this.close(session.id, "not an agent session");
+            throw new HostError("unsupported", `${options.provider} opens terminal sessions`);
+        }
+        return session;
+    }
+    /** create() for callers that need a terminal session. */
+    async createTerminal(options) {
+        const session = await this.create(options);
+        if (!(session instanceof TerminalSession)) {
+            await this.close(session.id, "not a terminal session");
+            throw new HostError("unsupported", `${options.provider} opens agent sessions`);
+        }
+        return session;
+    }
+    async #createAgent(provider, cwd, options) {
+        const now = Date.now();
+        const session = new AgentSession({
+            id: newId("ag"),
+            kind: "agent",
+            provider: provider.id,
+            providerSessionId: null,
+            cwd,
+            title: options.title ?? null,
+            status: "starting",
+            createdAt: now,
+            updatedAt: now,
+            lastSeq: 0,
+            autoApprove: options.autoApprove ?? this.#autoApprove,
+        }, this.#broadcast, this.#logCapacity);
+        this.#sessions.set(session.id, session);
+        session.announce();
+        try {
+            session.bind(await provider.start({ sessionId: session.id, cwd }, session.sink));
+        }
+        catch (err) {
+            await this.close(session.id, `failed to start: ${errorMessage(err)}`);
+            throw new HostError("internal", `failed to start ${provider.id}: ${errorMessage(err)}`);
+        }
+        return session;
+    }
+    async #createTerminal(provider, cwd, options) {
+        const now = Date.now();
+        const cols = options.cols ?? DEFAULT_COLS;
+        const rows = options.rows ?? DEFAULT_ROWS;
+        const session = new TerminalSession({
+            id: newId("tm"),
+            kind: "terminal",
+            provider: provider.id,
+            providerSessionId: null,
+            cwd,
+            title: options.title ?? null,
+            status: "starting",
+            createdAt: now,
+            updatedAt: now,
+            lastSeq: 0,
+            cols,
+            rows,
+        }, this.#broadcast, this.#flow);
+        this.#sessions.set(session.id, session);
+        session.announce();
+        try {
+            session.bind(await provider.open({ sessionId: session.id, cwd, cols, rows }));
+        }
+        catch (err) {
+            await this.close(session.id, `failed to start: ${errorMessage(err)}`);
+            throw new HostError("internal", `failed to start a terminal: ${errorMessage(err)}`);
+        }
+        return session;
+    }
+    /**
+     * Brings back the agent sessions the store remembers, with their recent history read
+     * from each provider's transcript. Providers resume on first use. Returns how many came back.
+     * Terminal sessions are never remembered: their shell died with the previous host.
+     */
+    async restore() {
+        if (!this.#store)
+            return 0;
+        let restored = 0;
+        for (const record of await this.#store.load()) {
+            const provider = this.#providers.get(record.provider);
+            if (provider?.kind !== "agent" || !provider.resumable || this.#sessions.has(record.id))
+                continue;
+            let cwd;
+            try {
+                cwd = await this.#resolveCwd(record.cwd);
+            }
+            catch {
+                continue; // The folder is gone or no longer allowed.
+            }
+            const session = new AgentSession({
+                id: record.id,
+                kind: "agent",
+                provider: provider.id,
+                providerSessionId: record.providerSessionId,
+                cwd,
+                title: record.title,
+                status: "starting",
+                createdAt: record.createdAt,
+                updatedAt: record.updatedAt,
+                lastSeq: 0,
+                autoApprove: record.autoApprove ?? this.#autoApprove,
+            }, this.#broadcast, this.#logCapacity);
+            if (provider.history) {
+                // History is a convenience; a session without it can still be resumed.
+                const turns = await provider.history(record.providerSessionId, cwd).catch(() => []);
+                session.importHistory(turns);
+            }
+            this.#sessions.set(session.id, session);
+            session.announce();
+            session.bindLazy(() => provider.start({ sessionId: session.id, cwd, resumeProviderSessionId: record.providerSessionId }, session.sink));
+            restored++;
+        }
+        return restored;
+    }
+    /** Closed by a client: the session is forgotten and will not come back after a restart. */
+    async close(sessionId, reason = null) {
+        const session = this.get(sessionId);
+        this.#sessions.delete(sessionId);
+        await session.close(reason);
+        this.#persistSoon();
+    }
+    async closeAll(reason = null) {
+        await Promise.all([...this.#sessions.keys()].map((id) => this.close(id, reason)));
+    }
+    /**
+     * Stops the host: saves resumable sessions, closes everything, then releases provider
+     * resources such as the Codex app-server. Unlike close(), agent sessions stay remembered.
+     */
+    async shutdown(reason = null) {
+        this.#stopping = true;
+        if (this.#persistTimer)
+            clearTimeout(this.#persistTimer);
+        await this.#persistNow();
+        await this.closeAll(reason);
+        await Promise.all([...this.#providers.values()].map((p) => (p.kind === "agent" ? p.dispose?.().catch(() => { }) : undefined)));
+    }
+    #persistSoon() {
+        if (!this.#store || this.#stopping)
+            return;
+        if (this.#persistTimer)
+            clearTimeout(this.#persistTimer);
+        this.#persistTimer = setTimeout(() => void this.#persistNow(), PERSIST_DELAY_MS);
+    }
+    async #persistNow() {
+        this.#persistTimer = null;
+        if (!this.#store)
+            return;
+        const records = [];
+        for (const session of this.#sessions.values()) {
+            if (!(session instanceof AgentSession))
+                continue;
+            const info = session.info;
+            const provider = this.#providers.get(info.provider);
+            // Only sessions with a conversation to go back to.
+            if (provider?.kind !== "agent" || !provider.resumable || !info.providerSessionId || info.lastSeq === 0)
+                continue;
+            records.push({
+                id: info.id,
+                provider: info.provider,
+                providerSessionId: info.providerSessionId,
+                cwd: info.cwd,
+                title: info.title,
+                createdAt: info.createdAt,
+                updatedAt: info.updatedAt,
+                ...(info.autoApprove ? { autoApprove: info.autoApprove } : {}),
+            });
+        }
+        await this.#store.save(records);
+    }
+    // Remote clients choose the folder, so it is checked after resolving symlinks.
+    async #resolveCwd(requested) {
+        const resolved = path.resolve(this.#roots?.[0] ?? process.cwd(), requested);
+        const real = await realpath(resolved).catch(() => null);
+        const stats = real ? await stat(real).catch(() => null) : null;
+        if (!real || !stats?.isDirectory())
+            throw new HostError("bad_request", `not a directory: ${resolved}`);
+        if (this.#roots) {
+            const roots = await Promise.all(this.#roots.map((root) => realpath(root).catch(() => root)));
+            if (!roots.some((root) => isInside(real, root))) {
+                throw new HostError("forbidden", `${resolved} is outside the folders this host allows`);
+            }
+        }
+        return real;
+    }
+    #broadcast = (event) => {
+        // A session that ended on its own (a shell that exited) is forgotten like a closed one.
+        if (event.type === "session.closed" && event.sessionId)
+            this.#sessions.delete(event.sessionId);
+        for (const listener of this.#hostListeners)
+            listener(event);
+        this.#persistSoon();
+    };
+}
+function isInside(child, root) {
+    const relative = path.relative(root, child);
+    return relative === "" || (relative.split(path.sep)[0] !== ".." && !path.isAbsolute(relative));
+}
+//# sourceMappingURL=manager.js.map

package/dist/session/manager.js.map

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

package/dist/session/session.d.ts

@@ -0,0 +1,43 @@
+import { type AgentEvent, type AutoApprove, type SessionInfo } from "@termlink/protocol";
+import type { EventSink, HistoryTurn, ProviderSession, UserInput } from "../providers/types.js";
+import { EventLog } from "./event-log.js";
+export type Listener = (event: AgentEvent) => void;
+export interface Attachment {
+    /** Deliver right after the attach response: missed durable events, then catch-up snapshots. */
+    replay: AgentEvent[];
+    gap: boolean;
+    oldestSeq: number;
+    detach: () => void;
+}
+/**
+ * One agent session. Owns the seq counter, the replay log, the pending input
+ * requests and the status derived from them. Providers only see its sink.
+ */
+export declare class AgentSession {
+    #private;
+    readonly id: string;
+    readonly log: EventLog;
+    constructor(info: SessionInfo, onLifecycle: Listener, logCapacity?: number);
+    get info(): SessionInfo;
+    get closed(): boolean;
+    readonly sink: EventSink;
+    announce(): void;
+    bind(provider: ProviderSession): void;
+    /** Binds a provider that is only started when the session is next used. */
+    bindLazy(start: () => Promise<ProviderSession>): void;
+    /** Changes session settings; a new autoApprove mode also answers approvals already waiting. */
+    configure(settings: {
+        autoApprove?: AutoApprove | undefined;
+    }): void;
+    /**
+     * Replays turns from the provider's transcript into this session's log, so a
+     * client attaching after a host restart sees the conversation so far.
+     */
+    importHistory(turns: HistoryTurn[]): void;
+    attach(listener: Listener, afterSeq?: number): Attachment;
+    send(input: UserInput): Promise<void>;
+    interrupt(): Promise<void>;
+    respond(requestId: string, decisionId: string, answers?: Record<string, string>): void;
+    close(reason: string | null): Promise<void>;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/session/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,WAAW,EAOhB,KAAK,WAAW,EAEjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAiB,eAAe,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAE/G,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,MAAM,QAAQ,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;AAEnD,MAAM,WAAW,UAAU;IACzB,+FAA+F;IAC/F,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,GAAG,EAAE,OAAO,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAcD;;;GAGG;AACH,qBAAa,YAAY;;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IAiBvB,YAAY,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,CAAC,EAAE,MAAM,EAKzE;IAED,IAAI,IAAI,IAAI,WAAW,CAEtB;IAED,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,QAAQ,CAAC,IAAI,EAAE,SAAS,CAOtB;IAEF,QAAQ,IAAI,IAAI,CAEf;IAED,IAAI,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAGpC;IAED,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI,CAGpD;IAED,+FAA+F;IAC/F,SAAS,CAAC,QAAQ,EAAE;QAAE,WAAW,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;KAAE,GAAG,IAAI,CAOnE;IAED;;;OAGG;IACH,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,IAAI,CAcxC;IAED,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,SAAI,GAAG,UAAU,CAoBnD;IAEK,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CA2B1C;IAEK,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAG/B;IAED,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAMrF;IAEK,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBhD;CAkIF"}

package/dist/session/session.js

@@ -0,0 +1,310 @@
+import { PROTOCOL_VERSION, applyDelta, isDurableEvent, } from "@termlink/protocol";
+import { HostError, errorMessage } from "../errors.js";
+import { newId } from "../util/id.js";
+import { EventLog } from "./event-log.js";
+/** Approval kinds each autoApprove mode answers. Questions and plans are never on this list. */
+const AUTO_KINDS = {
+    off: [],
+    edits: ["file_approval"],
+    all: ["command_approval", "file_approval", "tool_approval"],
+};
+/**
+ * One agent session. Owns the seq counter, the replay log, the pending input
+ * requests and the status derived from them. Providers only see its sink.
+ */
+export class AgentSession {
+    id;
+    log;
+    #info;
+    #onLifecycle;
+    #listeners = new Set();
+    #openItems = new Map();
+    #pending = new Map();
+    #seq = 0;
+    #turnActive = false;
+    #provider = null;
+    /** For a restored session: starts (resumes) the provider on first use. */
+    #starter = null;
+    #starting = null;
+    /** The user message waiting for its turn.started, which will name it. */
+    #pendingUserItemId = null;
+    /** Set while importing history, so replayed turns do not announce status changes. */
+    #quiet = false;
+    constructor(info, onLifecycle, logCapacity) {
+        this.id = info.id;
+        this.#info = { autoApprove: "off", ...info };
+        this.#onLifecycle = onLifecycle;
+        this.log = new EventLog(logCapacity);
+    }
+    get info() {
+        return { ...this.#info, lastSeq: this.#seq };
+    }
+    get closed() {
+        return this.#info.status === "closed";
+    }
+    sink = {
+        emit: (type, payload) => this.#emit(type, payload),
+        requestInput: (request, signal) => this.#requestInput(request, signal),
+        setProviderSessionId: (id) => {
+            this.#info.providerSessionId = id;
+            this.#announce("session.updated");
+        },
+    };
+    announce() {
+        this.#announce("session.created");
+    }
+    bind(provider) {
+        this.#provider = provider;
+        this.#setStatus("idle");
+    }
+    /** Binds a provider that is only started when the session is next used. */
+    bindLazy(start) {
+        this.#starter = start;
+        this.#setStatus("idle");
+    }
+    /** Changes session settings; a new autoApprove mode also answers approvals already waiting. */
+    configure(settings) {
+        if (this.closed)
+            throw new HostError("conflict", "session is closed");
+        if (settings.autoApprove && settings.autoApprove !== this.#info.autoApprove) {
+            this.#info.autoApprove = settings.autoApprove;
+            this.#announce("session.updated");
+            for (const [requestId, pending] of [...this.#pending])
+                this.#applyPolicy(requestId, pending);
+        }
+    }
+    /**
+     * Replays turns from the provider's transcript into this session's log, so a
+     * client attaching after a host restart sees the conversation so far.
+     */
+    importHistory(turns) {
+        this.#quiet = true;
+        try {
+            for (const turn of turns) {
+                const [first, ...rest] = turn.items;
+                const user = first?.kind === "message" && first.role === "user" ? first : undefined;
+                if (user)
+                    this.#emit("item.completed", { turnId: null, item: user });
+                this.#emit("turn.started", { turnId: turn.turnId, ...(user ? { userItemId: user.id } : {}) });
+                for (const item of user ? rest : turn.items)
+                    this.#emit("item.completed", { turnId: turn.turnId, item });
+                this.#emit("turn.completed", { turnId: turn.turnId, status: turn.status });
+            }
+        }
+        finally {
+            this.#quiet = false;
+        }
+    }
+    attach(listener, afterSeq = 0) {
+        if (this.closed)
+            throw new HostError("conflict", "session is closed");
+        // A client ahead of this log saw an earlier run of the host (seq restarts after a
+        // restore). Its view is stale, so it gets everything and is told to redraw.
+        const from = afterSeq > this.#seq ? 0 : afterSeq;
+        const { events, gap: evicted, oldestSeq } = this.log.since(from);
+        const gap = evicted || from !== afterSeq;
+        const replay = [...events];
+        for (const item of this.#openItems.values())
+            replay.push(this.#event("item.updated", { item }));
+        if (gap) {
+            // The input.required for a still-pending request may have been evicted.
+            for (const { request } of this.#pending.values()) {
+                const replayed = events.some((e) => e.type === "input.required" && e.payload.request.requestId === request.requestId);
+                if (!replayed)
+                    replay.push(this.#event("input.required", { request }));
+            }
+        }
+        this.#listeners.add(listener);
+        return { replay, gap, oldestSeq, detach: () => this.#listeners.delete(listener) };
+    }
+    async send(input) {
+        if (this.closed)
+            throw new HostError("conflict", "session is closed");
+        if (this.#turnActive)
+            throw new HostError("conflict", "a turn is already running");
+        // Reserve the turn before any await, so a second send cannot slip in while a restored provider resumes.
+        this.#turnActive = true;
+        let provider;
+        try {
+            provider = await this.#ensureProvider();
+        }
+        catch (err) {
+            this.#turnActive = false;
+            throw err;
+        }
+        const userItemId = newId("it");
+        this.#emit("item.completed", {
+            turnId: null,
+            item: { id: userItemId, kind: "message", role: "user", text: input.text, status: "completed" },
+        });
+        this.#pendingUserItemId = userItemId;
+        this.#refreshStatus();
+        try {
+            await provider.send(input);
+        }
+        catch (err) {
+            this.#pendingUserItemId = null;
+            this.#turnActive = false;
+            this.#refreshStatus();
+            throw err;
+        }
+    }
+    async interrupt() {
+        if (this.closed)
+            throw new HostError("conflict", "session is closed");
+        if (this.#turnActive && this.#provider)
+            await this.#provider.interrupt();
+    }
+    respond(requestId, decisionId, answers) {
+        const pending = this.#pending.get(requestId);
+        if (!pending)
+            throw new HostError("not_found", `no pending input request ${requestId}`);
+        const decision = pending.request.decisions.find((d) => d.id === decisionId);
+        if (!decision)
+            throw new HostError("bad_request", `unknown decision ${decisionId}`);
+        this.#resolve(requestId, pending, decision, "user", answers);
+    }
+    async close(reason) {
+        if (this.closed)
+            return;
+        for (const [requestId, pending] of this.#pending) {
+            this.#pending.delete(requestId);
+            this.#emit("input.resolved", { requestId, decisionId: null, effect: "cancel", by: "host" });
+            pending.settle({ decisionId: null, effect: "cancel" });
+        }
+        try {
+            const provider = this.#provider ?? (this.#starting ? await this.#starting.catch(() => null) : null);
+            await provider?.close();
+        }
+        catch {
+            // The session is going away either way.
+        }
+        this.#turnActive = false;
+        this.#info.status = "closed";
+        this.#info.updatedAt = Date.now();
+        this.#onLifecycle(this.#event("session.closed", { session: this.info, reason }));
+        this.#listeners.clear();
+    }
+    async #ensureProvider() {
+        if (this.#provider)
+            return this.#provider;
+        if (!this.#starter)
+            throw new HostError("conflict", "session is still starting");
+        this.#starting ??= this.#starter().then((provider) => {
+            this.#provider = provider;
+            return provider;
+        }, (err) => {
+            this.#starting = null;
+            throw new HostError("internal", `could not resume the ${this.#info.provider} session: ${errorMessage(err)}`);
+        });
+        return this.#starting;
+    }
+    #requestInput(input, signal) {
+        if (this.closed)
+            return Promise.resolve({ decisionId: null, effect: "cancel" });
+        if (signal?.aborted)
+            return Promise.reject(signal.reason);
+        const request = { ...input, requestId: newId("in") };
+        return new Promise((resolve, reject) => {
+            const onAbort = () => {
+                if (!this.#pending.delete(request.requestId))
+                    return;
+                this.#emit("input.resolved", { requestId: request.requestId, decisionId: null, effect: "cancel", by: "host" });
+                this.#refreshStatus();
+                reject(signal?.reason);
+            };
+            signal?.addEventListener("abort", onAbort, { once: true });
+            const pending = {
+                request,
+                settle: (response) => {
+                    signal?.removeEventListener("abort", onAbort);
+                    resolve(response);
+                },
+            };
+            this.#pending.set(request.requestId, pending);
+            // The request is always recorded, even when the policy answers it at once.
+            this.#emit("input.required", { request });
+            this.#refreshStatus();
+            this.#applyPolicy(request.requestId, pending);
+        });
+    }
+    #applyPolicy(requestId, pending) {
+        const mode = this.#info.autoApprove ?? "off";
+        if (!AUTO_KINDS[mode].includes(pending.request.kind))
+            return;
+        // Plain allow only: the policy never widens scope with allow_session.
+        const decision = pending.request.decisions.find((d) => d.effect === "allow");
+        if (decision)
+            this.#resolve(requestId, pending, decision, "policy");
+    }
+    #resolve(requestId, pending, decision, by, answers) {
+        this.#pending.delete(requestId);
+        this.#emit("input.resolved", { requestId, decisionId: decision.id, effect: decision.effect, by });
+        this.#refreshStatus();
+        pending.settle(answers ? { decisionId: decision.id, effect: decision.effect, answers } : { decisionId: decision.id, effect: decision.effect });
+    }
+    #event(type, payload) {
+        return { v: PROTOCOL_VERSION, kind: "evt", type, ts: Date.now(), sessionId: this.id, payload };
+    }
+    #emit(type, payload) {
+        if (this.closed)
+            return;
+        const event = this.#event(type, payload);
+        if (event.type === "turn.started" && this.#pendingUserItemId) {
+            event.payload = { ...event.payload, userItemId: this.#pendingUserItemId };
+            this.#pendingUserItemId = null;
+        }
+        this.#track(event);
+        if (isDurableEvent(type)) {
+            event.seq = ++this.#seq;
+            this.log.append(event);
+        }
+        for (const listener of this.#listeners)
+            listener(event);
+    }
+    #track(event) {
+        switch (event.type) {
+            case "turn.started":
+                this.#turnActive = true;
+                this.#refreshStatus();
+                break;
+            case "turn.completed":
+                this.#turnActive = false;
+                this.#refreshStatus();
+                break;
+            case "item.started":
+                this.#openItems.set(event.payload.item.id, event.payload.item);
+                break;
+            case "item.updated":
+                if (this.#openItems.has(event.payload.item.id))
+                    this.#openItems.set(event.payload.item.id, event.payload.item);
+                break;
+            case "item.delta": {
+                const { itemId, field, delta } = event.payload;
+                const item = this.#openItems.get(itemId);
+                if (item)
+                    this.#openItems.set(itemId, applyDelta(item, field, delta));
+                break;
+            }
+            case "item.completed":
+                this.#openItems.delete(event.payload.item.id);
+                break;
+        }
+    }
+    #refreshStatus() {
+        this.#setStatus(this.#pending.size > 0 ? "waiting_input" : this.#turnActive ? "running" : "idle");
+    }
+    #setStatus(status) {
+        if (this.closed || this.#info.status === status)
+            return;
+        this.#info.status = status;
+        this.#announce("session.updated");
+    }
+    #announce(type) {
+        if (this.#quiet)
+            return;
+        this.#info.updatedAt = Date.now();
+        this.#onLifecycle(this.#event(type, { session: this.info }));
+    }
+}
+//# sourceMappingURL=session.js.map