@jini-ai/daemon 0.1.0

package/dist/run-lifecycle.js

@@ -0,0 +1,451 @@
+/**
+ * `RunLifecycle` — start/stream/cancel/resume a run keyed on an opaque
+ * `contextRef` (extraction-plan §2.1: runs key on an opaque `contextRef`,
+ * never a product-record identifier), generalized from OD's `design.runs` service
+ * (`apps/daemon/src/runtimes/runs.ts` + the terminal-decision half of
+ * `apps/daemon/src/runtimes/start-chat-run.ts`, `arch/server-startserver-endgame`
+ * branch — see `source-map.md` for exact line citations).
+ *
+ * Scope boundary: this module owns the run *state machine* and its event
+ * log — create, transition, emit, replay, cancellation-intent propagation,
+ * idempotent start/finish, resume. It does not spawn or signal a subprocess;
+ * that is `@jini-ai/agent-runtime`'s job (extraction-plan task 7). A driver
+ * (today: this package's tests; later: agent-runtime) calls `emit()` for
+ * agent/stdout/stderr/error events, observes cancellation via
+ * `onCancelRequested`, and calls `finish()` once it knows the real outcome.
+ */
+import { randomUUID } from 'node:crypto';
+import { RUN_PROTOCOL_VERSION, isTerminalRunState } from '@jini-ai/protocol';
+import { createInactivityWatchdog } from './close-status.js';
+/** Vocabulary-firewall bridge: `RunState` uses `'cancelled'` (extraction-plan §12 C5's own cited canary), `RunEndPayload.status` uses `'canceled'`. Both live in `@jini-ai/protocol`, which is out of scope for this task — bridged here rather than fixed upstream. */
+const TERMINAL_OUTCOME_TO_END_STATUS = {
+    succeeded: 'succeeded',
+    failed: 'failed',
+    cancelled: 'canceled',
+};
+function toPublicStatus(record) {
+    const status = {
+        id: record.status.id,
+        state: record.status.state,
+        startedAt: record.status.startedAt,
+        updatedAt: record.status.updatedAt,
+    };
+    if (record.status.endedAt !== undefined) {
+        return { ...status, endedAt: record.status.endedAt };
+    }
+    return status;
+}
+/**
+ * Bridges `@jini-ai/daemon`'s own `EventLogEntry` (`{id, event, data, recordedAt}`) to
+ * `@jini-ai/protocol`'s canonical `RunEvent` envelope. `EventLogEntry` carries no `runId` of its
+ * own (the log is already scoped by the `runId` parameter every `EventLog` method takes), so
+ * this is the one place that stamps it onto the outgoing envelope.
+ */
+function toRunEvent(runId, entry) {
+    return {
+        runId,
+        eventId: `${runId}:${entry.id}`,
+        opaqueCursor: entry.id,
+        protocolVersion: RUN_PROTOCOL_VERSION,
+        ts: entry.recordedAt,
+        kind: entry.event,
+        payload: entry.data,
+        durability: 'durable',
+    };
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function terminalStateFromEndEntry(entry) {
+    if (!isRecord(entry.data))
+        return { state: 'failed', resumable: false };
+    const status = entry.data.status;
+    const state = status === 'succeeded' ? 'succeeded' : status === 'canceled' ? 'cancelled' : 'failed';
+    return { state, resumable: entry.data.resumable === true };
+}
+/**
+ * Creates the in-process `RunLifecycle` reference implementation.
+ *
+ * @param input.eventLog - The durable `EventLog` port this lifecycle appends to and replays from.
+ * @returns A `RunLifecycle` backed by an in-memory run registry plus the injected `EventLog`.
+ * @complexity Per-call complexities documented on each method; the registry itself is a `Map` keyed by `runId` (O(1) lookup).
+ * @overallScore 100/100
+ */
+export function createRunLifecycle(input) {
+    const { eventLog } = input;
+    const runs = new Map();
+    const idempotencyIndex = new Map();
+    let hydration = null;
+    function requireRun(runId) {
+        const record = runs.get(runId);
+        if (!record) {
+            throw new Error(`RunLifecycle: unknown run "${runId}"`);
+        }
+        return record;
+    }
+    /**
+     * A subscriber is a transport-owned callback (e.g. an SSE writer) outside this module's
+     * control. One subscriber throwing (a dead socket, a broken client) must never abort the
+     * fan-out to the others, nor propagate out through `emit()`/`finish()` into driver code that
+     * has nothing to do with that transport — see CR-R1 in
+     * `ADS-memory/reports/code-review/CR-backend-coverage-push-2026-07-20.md`.
+     */
+    function notifySubscribers(record, event) {
+        for (const subscriber of record.subscribers) {
+            try {
+                subscriber(event);
+            }
+            catch {
+                // Isolated by design — see the function doc above.
+            }
+        }
+    }
+    async function appendEvent(runId, record, event, data) {
+        const entry = await eventLog.append({ runId, event, data });
+        const runEvent = toRunEvent(runId, entry);
+        notifySubscribers(record, runEvent);
+        return runEvent;
+    }
+    function resolveTerminalWaiters(record) {
+        const waiters = record.terminalWaiters.splice(0, record.terminalWaiters.length);
+        const status = toPublicStatus(record);
+        for (const resolve of waiters) {
+            resolve(status);
+        }
+    }
+    /**
+     * Fires when a run's inactivity watchdog times out with no intervening
+     * `emit()`/`finish()`. Classified as a resumable failure (`code: null,
+     * signal: null`), mirroring OD's own timeout/inactivity classification
+     * (`isResumableFailure` in the researched `run-failure-classification.ts`
+     * treats timeout/inactivity as one of only two resumable categories).
+     * A run that already reached a terminal state before the timer fired
+     * (a normal race with `finish()`) is left untouched.
+     */
+    async function handleInactivityTimeout(runId) {
+        const record = runs.get(runId);
+        if (!record || isTerminalRunState(record.status.state)) {
+            return;
+        }
+        try {
+            await lifecycle.finish({ runId, status: 'failed', code: null, signal: null, resumable: true });
+        }
+        catch (error) {
+            const context = { source: 'inactivity-timeout', runId, error };
+            try {
+                if (input.onInternalError) {
+                    input.onInternalError(context);
+                }
+                else {
+                    // eslint-disable-next-line no-console
+                    console.error(`[@jini-ai/daemon] internal error (inactivity-timeout, runId=${runId})`, error);
+                }
+            }
+            catch (sinkError) {
+                // A diagnostic sink must not turn a contained timer failure into another unhandled
+                // rejection.
+                // eslint-disable-next-line no-console
+                console.error(`[@jini-ai/daemon] internal error sink failed (inactivity-timeout, runId=${runId})`, sinkError);
+            }
+        }
+    }
+    const lifecycle = {
+        async rehydrate() {
+            if (hydration)
+                return hydration;
+            hydration = (async () => {
+                const rehydratedNonTerminalRunIds = [];
+                for (const runId of await eventLog.listRunIds()) {
+                    if (runs.has(runId))
+                        continue;
+                    const replay = await eventLog.replay(runId, null);
+                    if (replay.kind !== 'ok' || replay.entries.length === 0)
+                        continue;
+                    const entries = replay.entries;
+                    const startEntry = entries.find((entry) => entry.event === 'start');
+                    const endEntry = [...entries].reverse().find((entry) => entry.event === 'end');
+                    const startData = startEntry && isRecord(startEntry.data) ? startEntry.data : null;
+                    const firstEntry = entries[0];
+                    const lastEntry = entries[entries.length - 1];
+                    const terminal = endEntry === undefined ? null : terminalStateFromEndEntry(endEntry);
+                    const contextRef = typeof startData?.contextRef === 'string' ? startData.contextRef : undefined;
+                    const idempotencyKey = typeof startData?.idempotencyKey === 'string' ? startData.idempotencyKey : undefined;
+                    const record = {
+                        contextRef,
+                        status: {
+                            id: runId,
+                            state: terminal?.state ?? 'running',
+                            startedAt: startEntry?.recordedAt ?? firstEntry.recordedAt,
+                            updatedAt: lastEntry.recordedAt,
+                            endedAt: endEntry?.recordedAt,
+                        },
+                        resumable: terminal?.resumable ?? false,
+                        cancelRequested: false,
+                        lastCancelRequest: undefined,
+                        cancelListeners: new Set(),
+                        subscribers: new Set(),
+                        terminalWaiters: [],
+                        terminalEndEntry: endEntry,
+                        watchdog: undefined,
+                        startPromise: undefined,
+                        finishPromise: undefined,
+                    };
+                    runs.set(runId, record);
+                    if (idempotencyKey !== undefined)
+                        idempotencyIndex.set(idempotencyKey, runId);
+                    if (terminal === null)
+                        rehydratedNonTerminalRunIds.push(runId);
+                }
+                // A process restart cannot retain an in-memory child process or cancellation listener.
+                // Persist an honest terminal outcome instead of advertising an orphaned run as still live.
+                for (const runId of rehydratedNonTerminalRunIds) {
+                    await lifecycle.finish({ runId, status: 'failed', code: null, signal: null, resumable: true });
+                }
+            })();
+            return hydration;
+        },
+        async start(startInput) {
+            if (startInput.idempotencyKey !== undefined) {
+                const existingRunId = idempotencyIndex.get(startInput.idempotencyKey);
+                if (existingRunId) {
+                    const existing = requireRun(existingRunId);
+                    await existing.startPromise;
+                    return { run: toPublicStatus(existing), started: false };
+                }
+            }
+            const runId = startInput.runId ?? randomUUID();
+            if (runs.has(runId)) {
+                throw new Error(`RunLifecycle: run "${runId}" already exists`);
+            }
+            const now = Date.now();
+            const record = {
+                contextRef: startInput.contextRef,
+                status: { id: runId, state: 'running', startedAt: now, updatedAt: now, endedAt: undefined },
+                resumable: false,
+                cancelRequested: false,
+                lastCancelRequest: undefined,
+                cancelListeners: new Set(),
+                subscribers: new Set(),
+                terminalWaiters: [],
+                terminalEndEntry: undefined,
+                watchdog: undefined,
+                startPromise: undefined,
+                finishPromise: undefined,
+            };
+            runs.set(runId, record);
+            if (startInput.idempotencyKey !== undefined) {
+                idempotencyIndex.set(startInput.idempotencyKey, runId);
+            }
+            const startPayload = {
+                runId,
+                contextRef: startInput.contextRef,
+                ...(startInput.agentId !== undefined ? { agentId: startInput.agentId } : {}),
+                ...(startInput.idempotencyKey !== undefined ? { idempotencyKey: startInput.idempotencyKey } : {}),
+            };
+            const startPromise = appendEvent(runId, record, 'start', startPayload).then(() => undefined);
+            record.startPromise = startPromise;
+            try {
+                await startPromise;
+                record.startPromise = undefined;
+            }
+            catch (error) {
+                runs.delete(runId);
+                if (startInput.idempotencyKey !== undefined &&
+                    idempotencyIndex.get(startInput.idempotencyKey) === runId) {
+                    idempotencyIndex.delete(startInput.idempotencyKey);
+                }
+                throw error;
+            }
+            if (startInput.inactivityTimeoutMs !== undefined) {
+                record.watchdog = createInactivityWatchdog({
+                    timeoutMs: startInput.inactivityTimeoutMs,
+                    onTimeout: () => {
+                        void handleInactivityTimeout(runId);
+                    },
+                });
+            }
+            return { run: toPublicStatus(record), started: true };
+        },
+        async get(runId) {
+            const record = runs.get(runId);
+            return record ? toPublicStatus(record) : undefined;
+        },
+        async list(contextRef) {
+            const all = Array.from(runs.values());
+            const filtered = contextRef === undefined ? all : all.filter((record) => record.contextRef === contextRef);
+            return filtered.map(toPublicStatus);
+        },
+        async cancel(request) {
+            const record = requireRun(request.runId);
+            await record.startPromise;
+            if (record.finishPromise) {
+                return record.finishPromise;
+            }
+            if (isTerminalRunState(record.status.state)) {
+                return toPublicStatus(record);
+            }
+            record.cancelRequested = true;
+            record.lastCancelRequest = request;
+            record.status.updatedAt = Date.now();
+            for (const listener of record.cancelListeners) {
+                listener(request);
+            }
+            return toPublicStatus(record);
+        },
+        /**
+         * Registers a cancel-intent listener. If `cancel()` was already called
+         * for this run before this subscription, the listener fires immediately
+         * with the original request (mirrors `AbortSignal`'s `aborted`+`addEventListener`
+         * pairing) — otherwise a driver that attaches after the cancel already
+         * happened would silently never learn about it, since a plain
+         * subscribe-for-future-events registry has no memory of past firings.
+         */
+        onCancelRequested(runId, listener) {
+            const record = requireRun(runId);
+            if (record.cancelRequested && record.lastCancelRequest) {
+                listener(record.lastCancelRequest);
+            }
+            record.cancelListeners.add(listener);
+            return () => record.cancelListeners.delete(listener);
+        },
+        async emit(runId, driverInput) {
+            const record = requireRun(runId);
+            await record.startPromise;
+            if (record.finishPromise || isTerminalRunState(record.status.state)) {
+                throw new Error(`RunLifecycle: cannot emit "${driverInput.event}" on terminal run "${runId}" — drivers must stop emitting once finish() has been called`);
+            }
+            record.watchdog?.noteActivity();
+            return appendEvent(runId, record, driverInput.event, driverInput.data);
+        },
+        async finish(finishInput) {
+            const record = requireRun(finishInput.runId);
+            await record.startPromise;
+            if (record.finishPromise) {
+                return record.finishPromise;
+            }
+            if (isTerminalRunState(record.status.state)) {
+                return toPublicStatus(record);
+            }
+            const finishing = (async () => {
+                const endPayload = {
+                    code: finishInput.code,
+                    signal: finishInput.signal,
+                    status: TERMINAL_OUTCOME_TO_END_STATUS[finishInput.status],
+                    resumable: finishInput.resumable,
+                    ...(finishInput.sessionRef !== undefined ? { sessionRef: finishInput.sessionRef } : {}),
+                };
+                const endEntry = await eventLog.append({ runId: finishInput.runId, event: 'end', data: endPayload });
+                // Commit the in-memory terminal transition only after its durable end entry exists. Until
+                // then `finishPromise` reserves the transition and blocks emits/concurrent finishes.
+                record.watchdog?.cancel();
+                record.status.state = finishInput.status;
+                record.status.updatedAt = endEntry.recordedAt;
+                record.status.endedAt = endEntry.recordedAt;
+                record.resumable = finishInput.resumable;
+                record.terminalEndEntry = endEntry;
+                const endEvent = toRunEvent(finishInput.runId, endEntry);
+                notifySubscribers(record, endEvent);
+                resolveTerminalWaiters(record);
+                return toPublicStatus(record);
+            })();
+            record.finishPromise = finishing;
+            try {
+                return await finishing;
+            }
+            finally {
+                if (record.finishPromise === finishing) {
+                    record.finishPromise = undefined;
+                }
+            }
+        },
+        async resume(runId) {
+            const record = requireRun(runId);
+            const eligible = isTerminalRunState(record.status.state) && record.resumable;
+            if (!eligible) {
+                return { run: toPublicStatus(record), resumed: false };
+            }
+            const now = Date.now();
+            record.status.state = 'running';
+            record.status.updatedAt = now;
+            record.status.endedAt = undefined;
+            record.resumable = false;
+            record.cancelRequested = false;
+            record.lastCancelRequest = undefined;
+            record.terminalEndEntry = undefined;
+            // No protocol event is emitted here: none of RunProtocolEvent's six
+            // kinds represents "resumed" (extraction-plan scope decision — see
+            // source-map.md). The event log's cursor sequence continues
+            // unbroken; only RunStatus.state changes.
+            return { run: toPublicStatus(record), resumed: true };
+        },
+        async waitForTerminal(runId) {
+            const record = requireRun(runId);
+            if (isTerminalRunState(record.status.state)) {
+                return toPublicStatus(record);
+            }
+            return new Promise((resolve) => {
+                record.terminalWaiters.push(resolve);
+            });
+        },
+        async stream(runId, onEvent, options = {}) {
+            const record = runs.get(runId);
+            if (!record) {
+                return { kind: 'unknown-run' };
+            }
+            await record.startPromise;
+            // Subscribe before awaiting the durable replay. Any event appended while the replay query is
+            // in flight is buffered, then delivered after the replay entries, so a reconnect cannot lose
+            // the narrow replay→subscribe interval or observe the live event ahead of older history.
+            let replaying = true;
+            const bufferedLiveEvents = [];
+            const subscriber = (event) => {
+                if (replaying)
+                    bufferedLiveEvents.push(event);
+                else
+                    onEvent(event);
+            };
+            record.subscribers.add(subscriber);
+            try {
+                const replay = await eventLog.replay(runId, options.afterCursor ?? null);
+                if (replay.kind !== 'ok') {
+                    record.subscribers.delete(subscriber);
+                    return replay;
+                }
+                const deliveredEventIds = new Set();
+                for (const entry of replay.entries) {
+                    const event = toRunEvent(runId, entry);
+                    deliveredEventIds.add(event.eventId);
+                    onEvent(event);
+                }
+                for (const event of bufferedLiveEvents) {
+                    if (!deliveredEventIds.has(event.eventId)) {
+                        deliveredEventIds.add(event.eventId);
+                        onEvent(event);
+                    }
+                }
+                replaying = false;
+                const terminal = isTerminalRunState(record.status.state);
+                if (terminal && record.terminalEndEntry) {
+                    const terminalEvent = toRunEvent(runId, record.terminalEndEntry);
+                    if (!deliveredEventIds.has(terminalEvent.eventId)) {
+                        deliveredEventIds.add(terminalEvent.eventId);
+                        onEvent(terminalEvent);
+                    }
+                }
+                if (terminal) {
+                    record.subscribers.delete(subscriber);
+                    return { kind: 'ok', unsubscribe: () => { } };
+                }
+                return { kind: 'ok', unsubscribe: () => record.subscribers.delete(subscriber) };
+            }
+            catch (error) {
+                // Subscription is installed before durable replay to close the replay→live race. Any
+                // replay I/O or consumer callback failure must therefore remove it before propagating.
+                record.subscribers.delete(subscriber);
+                throw error;
+            }
+        },
+    };
+    return lifecycle;
+}
+//# sourceMappingURL=run-lifecycle.js.map

package/dist/run-lifecycle.js.map

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

package/dist/terminal-session.d.ts

@@ -0,0 +1,139 @@
+import type { Principal, ToolPolicy, ToolRegistration } from '@jini-ai/core';
+import { type PtySpawn, type TerminalService, type TerminalSseSink } from '@jini-ai/platform';
+export type { TerminalSseSink } from '@jini-ai/platform';
+/** The `ToolRegistry` id `terminal.create` executes through — see module doc §2. */
+export declare const TERMINAL_CREATE_TOOL_ID = "terminal.create";
+/**
+ * Deny-by-default `ToolPolicy` for `terminal.create`. Matching
+ * `db-ops.ts`'s `denyAllDaemonDbPolicy` / `@jini-ai/deploy`'s
+ * `denyAllDeployPublishPolicy` precedent: spawning an interactive shell is
+ * strictly more dangerous than any of those (it is not one bounded
+ * operation but an open-ended session), so a host must explicitly opt in
+ * with its own policy rather than getting a working shell spawner for free
+ * merely by registering the tool.
+ */
+export declare const denyAllTerminalCreatePolicy: ToolPolicy;
+/**
+ * The real, `node-pty`-backed {@link PtySpawn}. Dynamically imports
+ * `node-pty` (mirroring OD's origin `await import('node-pty')`, not a
+ * static top-level import) so a host process whose platform/environment
+ * lacks a usable `node-pty` addon can still boot — only an actual
+ * `terminal.create` call fails, cleanly, rather than crashing at
+ * module-eval time. Before the first spawn, repairs `node-pty`'s bundled
+ * `spawn-helper` binary's executable bit (pnpm unpacks it non-executable —
+ * see `@jini-ai/platform`'s `terminal.ts` module doc for the full story) via
+ * that package's own `spawnHelperCandidatePaths`/`ensureSpawnHelperExecutable`,
+ * but with the resolver anchored at **this** module
+ * (`createRequire(import.meta.url)` here, not `@jini-ai/platform`'s own
+ * default): `@jini-ai/platform` deliberately does not depend on `node-pty`, so
+ * its default `require.resolve('node-pty')` would not find the copy this
+ * package (`@jini-ai/daemon`) actually declares — this is exactly the
+ * resolver injection seam `spawnHelperCandidatePaths` was built for.
+ */
+export declare function loadRealSpawnPty(): Promise<PtySpawn>;
+/** The public, principal-neutral session snapshot this module exposes — deliberately its own shape rather than re-exporting `@jini-ai/platform`'s `TerminalSession` verbatim, since that type carries an OD-shaped per-session grouping key (see `@jini-ai/platform`'s `terminal.ts`) this module replaces entirely with the caller-supplied `resourceRef` (see {@link CreateTerminalSessionOptions}), tracked only in this module's own metadata and never forwarded to `@jini-ai/platform` at all — this package's own identifier-neutrality lint (`__tests__/identifier-lint.test.ts`) forbids that origin field's exact name from appearing anywhere in this package's source. */
+export interface TerminalSessionInfo {
+    readonly id: string;
+    readonly resourceRef: string | null;
+    readonly cwd: string;
+    readonly shell: string;
+    readonly cols: number;
+    readonly rows: number;
+    readonly status: 'running' | 'exited';
+    readonly createdAt: number;
+    readonly updatedAt: number;
+    readonly exitCode: number | null;
+    readonly signal: string | null;
+}
+export interface CreateTerminalSessionOptions {
+    /** Opaque grouping/scoping reference (e.g. what `@jini-ai/http`'s `workspace-root.ts` resolved `cwd` from) — tracked by this module only, never forwarded to `@jini-ai/platform`. */
+    readonly resourceRef?: string | null;
+    readonly cwd: string;
+    readonly cols?: number;
+    readonly rows?: number;
+    readonly shell?: string | null;
+}
+export interface TerminalSessionListFilter {
+    readonly resourceRef?: string;
+}
+export type TerminalSessionAccessResult = {
+    readonly status: 'not-found';
+} | {
+    readonly status: 'ok';
+    readonly session: TerminalSessionInfo;
+};
+/**
+ * Result of a `write`/`resize`/`kill` call. `'not-found'` covers both "no
+ * such session" and "this session belongs to a different principal" —
+ * identically, never distinguishably — see {@link checkOwnership}'s doc.
+ * `'ok'` with `ok: false` covers a session that exists and is owned by the
+ * caller but could not actually perform the action (already exited, killed
+ * by a racing call, or the underlying pty call itself failed) — mirroring
+ * `@jini-ai/platform`'s own `write`/`resize`/`kill` boolean-return contract.
+ */
+export type TerminalSessionActionResult = {
+    readonly status: 'not-found';
+} | {
+    readonly status: 'ok';
+    readonly ok: boolean;
+    readonly session: TerminalSessionInfo | null;
+};
+export type TerminalSessionAttachResult = 'attached' | 'ended' | 'not-found';
+export interface TerminalSessionManager {
+    /** The one call gated through `ToolExecutor` (see module doc §2) — this method is what `createTerminalToolRegistrations`'s handler calls, never invoked directly by a route. */
+    create(principal: Principal, options: CreateTerminalSessionOptions): Promise<TerminalSessionInfo>;
+    get(principal: Principal, id: string): TerminalSessionAccessResult;
+    /** Sessions the given principal owns, optionally narrowed by `resourceRef`. Never returns another principal's sessions. */
+    list(principal: Principal, filter?: TerminalSessionListFilter): readonly TerminalSessionInfo[];
+    write(principal: Principal, id: string, input: string): Promise<TerminalSessionActionResult>;
+    resize(principal: Principal, id: string, cols: number, rows: number): Promise<TerminalSessionActionResult>;
+    kill(principal: Principal, id: string, signal?: string): Promise<TerminalSessionActionResult>;
+    /** Replays scrollback after `lastEventId` and attaches `sink` for live output — ownership-checked the same as `write`/`resize`/`kill`, since reading a session's output is exactly as sensitive as writing to it. */
+    attach(principal: Principal, id: string, lastEventId: number, sink: TerminalSseSink): TerminalSessionAttachResult;
+    /** No ownership check: removing a sink that was never attached (e.g. a foreign/unknown id) is already a safe no-op at the `@jini-ai/platform` layer, and detach carries no capability of its own. */
+    detach(id: string, sink: TerminalSseSink): void;
+    shutdownActive(options?: {
+        graceMs?: number;
+    }): Promise<void>;
+}
+export interface CreateTerminalSessionManagerOptions {
+    /** Injected for tests (a fake session manager without a real pty) or an alternate host wiring. @default a fresh `@jini-ai/platform` `TerminalService` backed by {@link loadRealSpawnPty}. */
+    readonly terminalService?: TerminalService;
+    /** @default {@link loadRealSpawnPty} */
+    readonly loadSpawnPty?: () => Promise<PtySpawn>;
+    readonly maxEvents?: number;
+    readonly maxBufferBytes?: number;
+    readonly exitTailBytes?: number;
+    readonly flushIntervalMs?: number;
+    readonly flushThresholdBytes?: number;
+    readonly ttlMs?: number;
+    readonly shutdownGraceMs?: number;
+}
+/**
+ * Builds the reference `TerminalSessionManager`: an in-process wrapper
+ * around a `@jini-ai/platform` `TerminalService` adding session ownership,
+ * the kill/write/resize lock, and (via {@link createTerminalToolRegistrations})
+ * `ToolExecutor` gating for creation. See module doc for the full design.
+ */
+export declare function createTerminalSessionManager(options?: CreateTerminalSessionManagerOptions): TerminalSessionManager;
+export interface CreateTerminalToolRegistrationsOptions {
+    readonly manager: TerminalSessionManager;
+    /** @default {@link denyAllTerminalCreatePolicy} — see its doc for why a permissive default was rejected. */
+    readonly policy?: ToolPolicy;
+    readonly requiresConfirmation?: boolean;
+    readonly timeoutMs?: number;
+}
+export interface TerminalToolRegistrations {
+    readonly create: ToolRegistration;
+}
+/**
+ * Builds the `{descriptor, handler, policy}` triple a host registers
+ * against `@jini-ai/core`'s `ToolRegistry` so `terminal.create` becomes
+ * reachable only via `ToolExecutor.execute(principal, run,
+ * 'terminal.create', input)` — never by a route calling
+ * `manager.create()` directly, which would bypass authorization and the
+ * audit trail (matching `db-ops.ts`'s `createDaemonDbToolRegistrations`
+ * precedent).
+ */
+export declare function createTerminalToolRegistrations(options: CreateTerminalToolRegistrationsOptions): TerminalToolRegistrations;
+//# sourceMappingURL=terminal-session.d.ts.map

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

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