@wastedcode/claudemux 0.2.0

package/dist/session/registry.d.ts

@@ -0,0 +1,31 @@
+import type { Backend } from "../backends/types.js";
+/**
+ * Bare `{ namespace, name }` operations for the public surface. Each
+ * accepts an optional `backend` override; when omitted, the process-wide
+ * default backend is used.
+ */
+/** Is the named session currently alive? */
+export declare function exists(o: {
+    name: string;
+    namespace?: string;
+    backend?: Backend;
+}): Promise<boolean>;
+/**
+ * Kill the named session. Idempotent — "kill of a missing session" is
+ * success, not an error.
+ */
+export declare function kill(o: {
+    name: string;
+    namespace?: string;
+    backend?: Backend;
+}): Promise<void>;
+/**
+ * List short session names owned by `namespace`. Result is sorted for
+ * stable test/UX behavior; the backend's order is not part of the
+ * contract.
+ */
+export declare function list(o?: {
+    namespace?: string;
+    backend?: Backend;
+}): Promise<string[]>;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/session/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAIpD;;;;GAIG;AAEH,4CAA4C;AAC5C,wBAAgB,MAAM,CAAC,CAAC,EAAE;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GAAG,OAAO,CAAC,OAAO,CAAC,CAGnB;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhB;AAED;;;;GAIG;AACH,wBAAsB,IAAI,CAAC,CAAC,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAK/F"}

package/dist/session/registry.js

@@ -0,0 +1,32 @@
+import { DEFAULT_NAMESPACE } from "./constants.js";
+import { sharedDefaultBackend } from "./default-backend.js";
+/**
+ * Bare `{ namespace, name }` operations for the public surface. Each
+ * accepts an optional `backend` override; when omitted, the process-wide
+ * default backend is used.
+ */
+/** Is the named session currently alive? */
+export function exists(o) {
+    const backend = o.backend ?? sharedDefaultBackend();
+    return backend.exists({ namespace: o.namespace ?? DEFAULT_NAMESPACE, name: o.name });
+}
+/**
+ * Kill the named session. Idempotent — "kill of a missing session" is
+ * success, not an error.
+ */
+export function kill(o) {
+    const backend = o.backend ?? sharedDefaultBackend();
+    return backend.kill({ namespace: o.namespace ?? DEFAULT_NAMESPACE, name: o.name });
+}
+/**
+ * List short session names owned by `namespace`. Result is sorted for
+ * stable test/UX behavior; the backend's order is not part of the
+ * contract.
+ */
+export async function list(o = {}) {
+    const backend = o.backend ?? sharedDefaultBackend();
+    const namespace = o.namespace ?? DEFAULT_NAMESPACE;
+    const shortNames = await backend.list(namespace);
+    return [...shortNames].sort();
+}
+//# sourceMappingURL=registry.js.map

package/dist/session/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/session/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;;;GAIG;AAEH,4CAA4C;AAC5C,MAAM,UAAU,MAAM,CAAC,CAItB;IACC,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,oBAAoB,EAAE,CAAC;IACpD,OAAO,OAAO,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AACvF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,IAAI,CAAC,CAIpB;IACC,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,oBAAoB,EAAE,CAAC;IACpD,OAAO,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AACrF,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAA+C,EAAE;IAC1E,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,oBAAoB,EAAE,CAAC;IACpD,MAAM,SAAS,GAAG,CAAC,CAAC,SAAS,IAAI,iBAAiB,CAAC;IACnD,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjD,OAAO,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC;AAChC,CAAC"}

package/dist/session/resolve.d.ts

@@ -0,0 +1,30 @@
+import type { AgentDef } from "../agents/types.js";
+import type { Backend, SessionRef } from "../backends/types.js";
+/** The options every lifecycle entry (`create`/`resume`/`adopt`) shares. */
+export interface SessionContextOptions {
+    /** Session name within the namespace. */
+    name: string;
+    /** Namespace prefix (default: `"claudemux"`). */
+    namespace?: string;
+    /** Agent definition (default: claude). */
+    agent?: AgentDef;
+    /** Backend instance (default: the process-wide shared default). */
+    backend?: Backend;
+}
+/** The resolved front-matter every lifecycle entry derives before its own work. */
+export interface SessionContext {
+    readonly ref: SessionRef;
+    readonly agent: AgentDef;
+    readonly backend: Backend;
+}
+/**
+ * Resolve the shared front-matter of every lifecycle entry point: default the
+ * namespace, validate name + namespace, default the agent and backend, and build
+ * the validated {@link SessionRef}. `create`/`resume`/`adopt` each open with THIS,
+ * then own their one distinct next step — the exists-check polarity (present is a
+ * collision for create/resume, absence for adopt) and spawn-vs-attach. Extracted
+ * because the four-line preamble was byte-identical across all three and drifted
+ * as a class (one place to fix a default or a validation rule, not three).
+ */
+export declare function resolveSessionContext(opts: SessionContextOptions): SessionContext;
+//# sourceMappingURL=resolve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/session/resolve.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAKhE,4EAA4E;AAC5E,MAAM,WAAW,qBAAqB;IACpC,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,mFAAmF;AACnF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,qBAAqB,GAAG,cAAc,CASjF"}

package/dist/session/resolve.js

@@ -0,0 +1,24 @@
+import { claude as defaultAgent } from "../agents/claude.js";
+import { DEFAULT_NAMESPACE } from "./constants.js";
+import { sharedDefaultBackend } from "./default-backend.js";
+import { validateNamePart } from "./validate.js";
+/**
+ * Resolve the shared front-matter of every lifecycle entry point: default the
+ * namespace, validate name + namespace, default the agent and backend, and build
+ * the validated {@link SessionRef}. `create`/`resume`/`adopt` each open with THIS,
+ * then own their one distinct next step — the exists-check polarity (present is a
+ * collision for create/resume, absence for adopt) and spawn-vs-attach. Extracted
+ * because the four-line preamble was byte-identical across all three and drifted
+ * as a class (one place to fix a default or a validation rule, not three).
+ */
+export function resolveSessionContext(opts) {
+    const namespace = opts.namespace ?? DEFAULT_NAMESPACE;
+    validateNamePart("namespace", namespace);
+    validateNamePart("name", opts.name);
+    return {
+        ref: { namespace, name: opts.name },
+        agent: opts.agent ?? defaultAgent,
+        backend: opts.backend ?? sharedDefaultBackend(),
+    };
+}
+//# sourceMappingURL=resolve.js.map

package/dist/session/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/session/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAG7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAqBjD;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAA2B;IAC/D,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,iBAAiB,CAAC;IACtD,gBAAgB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IACzC,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,OAAO;QACL,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;QACnC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,YAAY;QACjC,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,oBAAoB,EAAE;KAChD,CAAC;AACJ,CAAC"}

package/dist/session/resume.d.ts

@@ -0,0 +1,68 @@
+import type { AgentDef } from "../agents/types.js";
+import type { Backend } from "../backends/types.js";
+import type { SessionHandle } from "../types.js";
+/**
+ * Options for {@link resume}. The peer of {@link CreateOptions} — same lifecycle
+ * shape, except the conversation id is **given** (the one to continue), not
+ * minted.
+ */
+export interface ResumeOptions {
+    /** Session name within the namespace (a fresh pane is spawned under it). */
+    name: string;
+    /** Working directory the agent runs in. */
+    cwd: string;
+    /**
+     * The conversation to continue — an `agentSessionId` previously surfaced by
+     * {@link create}/{@link adopt}. Validated as a v4 UUID before spawn. The agent
+     * maps it to its own resume mechanism (claude: `--resume <id>`); the vendor
+     * flag never appears in consumer code.
+     */
+    agentSessionId: string;
+    /** Namespace prefix (default: `"claudemux"`). */
+    namespace?: string;
+    /** Agent definition (default: claude). */
+    agent?: AgentDef;
+    /** Backend instance (default: tmux on a fresh shared socket per process). */
+    backend?: Backend;
+    /** Extra args passed to the agent's argv. */
+    extraArgs?: string[];
+    /** Override env passed to the agent process. */
+    env?: Record<string, string>;
+    /** Boot timeout in ms (default 60_000). */
+    bootTimeoutMs?: number;
+    /** Opt in to auto-dismissing the workspace-trust dialog (default false). */
+    trustWorkspace?: boolean;
+    /** Inject the agent's observe hooks at spawn (default true). */
+    hooks?: boolean;
+}
+/**
+ * Resume an existing conversation in a **fresh pane** — the lifecycle peer of
+ * {@link create} (start fresh) and {@link adopt} (re-attach to a *running*
+ * pane). Use it after a crash, or to fork the conversation onto a new session:
+ * pass the `agentSessionId` you persisted from a prior {@link create}/
+ * {@link adopt}; the agent replays its history and you get a live handle.
+ *
+ * Composes the same spawn→boot→handle core as `create`; only identity differs
+ * (an existing id → the agent's resume flag, vs a fresh mint → `--session-id`).
+ *
+ * @throws `InvalidAgentSessionId` if `agentSessionId` is not a v4 UUID
+ *   (before spawn).
+ * @throws `SessionExists` if a session with `{ namespace, name }` already exists
+ *   — resume spawns a NEW pane and never silently adopts; pick an unused name,
+ *   or {@link adopt} the running one.
+ * @throws the same boot failures as {@link create}
+ *   (`LoginRequired`/`WorkspaceUntrusted`/`DialogStuck`/`AgentExitedDuringBoot`/
+ *   `ReplTimeout`). An `AgentExitedDuringBoot` here most often means the id is
+ *   already live in another pane (claude refuses to resume an in-use id).
+ *
+ * @example
+ * ```ts
+ * import { create, resume } from "claudemux";
+ * const s = await create({ name: "job", cwd });
+ * const id = s.agentSessionId!;          // persist this
+ * // …process restarts / crashes…
+ * const r = await resume({ name: "job-2", cwd, agentSessionId: id });
+ * ```
+ */
+export declare function resume(opts: ResumeOptions): Promise<SessionHandle>;
+//# sourceMappingURL=resume.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resume.d.ts","sourceRoot":"","sources":["../../src/session/resume.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMjD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;OAKG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4EAA4E;IAC5E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gEAAgE;IAChE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAoBxE"}

package/dist/session/resume.js

@@ -0,0 +1,54 @@
+import { SessionExists } from "../errors.js";
+import { formatSessionLabel } from "./ref.js";
+import { resolveSessionContext } from "./resolve.js";
+import { spawnBootHandle } from "./spawn-boot.js";
+import { validateAgentSessionId } from "./validate.js";
+/**
+ * Resume an existing conversation in a **fresh pane** — the lifecycle peer of
+ * {@link create} (start fresh) and {@link adopt} (re-attach to a *running*
+ * pane). Use it after a crash, or to fork the conversation onto a new session:
+ * pass the `agentSessionId` you persisted from a prior {@link create}/
+ * {@link adopt}; the agent replays its history and you get a live handle.
+ *
+ * Composes the same spawn→boot→handle core as `create`; only identity differs
+ * (an existing id → the agent's resume flag, vs a fresh mint → `--session-id`).
+ *
+ * @throws `InvalidAgentSessionId` if `agentSessionId` is not a v4 UUID
+ *   (before spawn).
+ * @throws `SessionExists` if a session with `{ namespace, name }` already exists
+ *   — resume spawns a NEW pane and never silently adopts; pick an unused name,
+ *   or {@link adopt} the running one.
+ * @throws the same boot failures as {@link create}
+ *   (`LoginRequired`/`WorkspaceUntrusted`/`DialogStuck`/`AgentExitedDuringBoot`/
+ *   `ReplTimeout`). An `AgentExitedDuringBoot` here most often means the id is
+ *   already live in another pane (claude refuses to resume an in-use id).
+ *
+ * @example
+ * ```ts
+ * import { create, resume } from "claudemux";
+ * const s = await create({ name: "job", cwd });
+ * const id = s.agentSessionId!;          // persist this
+ * // …process restarts / crashes…
+ * const r = await resume({ name: "job-2", cwd, agentSessionId: id });
+ * ```
+ */
+export async function resume(opts) {
+    validateAgentSessionId(opts.agentSessionId);
+    const { ref, agent, backend } = resolveSessionContext(opts);
+    if (await backend.exists(ref)) {
+        throw new SessionExists(formatSessionLabel(ref));
+    }
+    return spawnBootHandle({
+        agent,
+        backend,
+        ref,
+        cwd: opts.cwd,
+        identity: { mode: "resume", agentSessionId: opts.agentSessionId },
+        hooks: opts.hooks !== false,
+        ...(opts.extraArgs === undefined ? {} : { extraArgs: opts.extraArgs }),
+        ...(opts.env === undefined ? {} : { env: opts.env }),
+        ...(opts.bootTimeoutMs === undefined ? {} : { bootTimeoutMs: opts.bootTimeoutMs }),
+        ...(opts.trustWorkspace === undefined ? {} : { trustWorkspace: opts.trustWorkspace }),
+    });
+}
+//# sourceMappingURL=resume.js.map

package/dist/session/resume.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.js","sourceRoot":"","sources":["../../src/session/resume.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAqCvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAmB;IAC9C,sBAAsB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC5C,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAE5D,IAAI,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,aAAa,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,OAAO,eAAe,CAAC;QACrB,KAAK;QACL,OAAO;QACP,GAAG;QACH,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE;QACjE,KAAK,EAAE,IAAI,CAAC,KAAK,KAAK,KAAK;QAC3B,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;QACtE,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC;QACpD,GAAG,CAAC,IAAI,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC;QAClF,GAAG,CAAC,IAAI,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC;KACtF,CAAC,CAAC;AACL,CAAC"}

package/dist/session/spawn-boot.d.ts

@@ -0,0 +1,44 @@
+import type { AgentDef } from "../agents/types.js";
+import type { Backend, SessionRef } from "../backends/types.js";
+import type { SessionHandle } from "../types.js";
+/**
+ * How the conversation id is decided for a spawn — the ONLY thing that differs
+ * between the lifecycle peers:
+ *   - `fresh` (`create`): a minted or caller-chosen `sessionId` → `--session-id`.
+ *   - `resume`: an existing `agentSessionId` → the agent's resume flag.
+ */
+type SpawnIdentity = {
+    readonly mode: "fresh";
+    readonly sessionId: string;
+    readonly explicit: boolean;
+} | {
+    readonly mode: "resume";
+    readonly agentSessionId: string;
+};
+/** The shared spawn→boot→handle input. `identity` carries the fresh/resume split. */
+export interface SpawnBootInput {
+    agent: AgentDef;
+    backend: Backend;
+    ref: SessionRef;
+    cwd: string;
+    identity: SpawnIdentity;
+    /** Inject the agent's observe hooks at spawn. */
+    hooks: boolean;
+    extraArgs?: string[];
+    env?: Record<string, string>;
+    bootTimeoutMs?: number;
+    trustWorkspace?: boolean;
+}
+/**
+ * The shared lifecycle core for `create` (fresh) and `resume`: inject hooks,
+ * build the argv (mapping the {@link SpawnIdentity}), spawn the pane, boot it,
+ * cache the recoverable id, and return the handle. Both lifecycle faces compose
+ * this ONE owner so the spawn/boot/handle decision lives in a single place;
+ * they differ only in how identity is resolved before calling in.
+ *
+ * @throws the boot failures documented on {@link bootSession}; on any boot
+ *   failure the just-spawned pane is killed (best-effort) before rethrowing.
+ */
+export declare function spawnBootHandle(o: SpawnBootInput): Promise<SessionHandle>;
+export {};
+//# sourceMappingURL=spawn-boot.d.ts.map

package/dist/session/spawn-boot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-boot.d.ts","sourceRoot":"","sources":["../../src/session/spawn-boot.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAOjD;;;;;GAKG;AACH,KAAK,aAAa,GACd;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GAClF;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjE,qFAAqF;AACrF,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,UAAU,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,aAAa,CAAC;IACxB,iDAAiD;IACjD,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CAAC,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAwE/E"}

package/dist/session/spawn-boot.js

@@ -0,0 +1,87 @@
+import { mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { bootSession } from "./boot.js";
+import { AGENT_SESSION_ID_META_KEY } from "./constants.js";
+import { makeHandle } from "./handle.js";
+import { buildHookInjection } from "./hooks.js";
+import { formatSessionLabel } from "./ref.js";
+/**
+ * The shared lifecycle core for `create` (fresh) and `resume`: inject hooks,
+ * build the argv (mapping the {@link SpawnIdentity}), spawn the pane, boot it,
+ * cache the recoverable id, and return the handle. Both lifecycle faces compose
+ * this ONE owner so the spawn/boot/handle decision lives in a single place;
+ * they differ only in how identity is resolved before calling in.
+ *
+ * @throws the boot failures documented on {@link bootSession}; on any boot
+ *   failure the just-spawned pane is killed (best-effort) before rethrowing.
+ */
+export async function spawnBootHandle(o) {
+    // The id the hook rendezvous is keyed on (the conversation we'll run under).
+    const idForHooks = o.identity.mode === "fresh" ? o.identity.sessionId : o.identity.agentSessionId;
+    const injection = buildHookInjection({
+        agent: o.agent,
+        sessionId: idForHooks,
+        enabled: o.hooks,
+        userExtraArgs: o.extraArgs ?? [],
+    });
+    if (injection.rendezvousPath !== undefined) {
+        mkdirSync(dirname(injection.rendezvousPath), { recursive: true });
+    }
+    const extraArgs = [...injection.args, ...(o.extraArgs ?? [])];
+    const argvBuild = o.agent.buildArgv({
+        cwd: o.cwd,
+        sessionName: formatSessionLabel(o.ref),
+        ...(o.identity.mode === "fresh"
+            ? { sessionId: o.identity.sessionId, sessionIdExplicit: o.identity.explicit }
+            : { resumeFrom: o.identity.agentSessionId }),
+        ...(extraArgs.length > 0 ? { extraArgs } : {}),
+    });
+    const agentSessionId = argvBuild.agentSessionId;
+    const mergedEnv = { ...(argvBuild.env ?? {}), ...(o.env ?? {}) };
+    await o.backend.spawn({
+        namespace: o.ref.namespace,
+        name: o.ref.name,
+        cwd: o.cwd,
+        env: mergedEnv,
+        cmd: argvBuild.cmd,
+        argv: argvBuild.argv,
+    });
+    // The caller-known id to attribute a boot-death to: the resume id, or an
+    // explicitly-chosen fresh id (a minted v4 never collides, so omit it then).
+    const knownId = o.identity.mode === "resume"
+        ? o.identity.agentSessionId
+        : o.identity.explicit
+            ? o.identity.sessionId
+            : undefined;
+    try {
+        await bootSession(o.backend, o.agent, o.ref, {
+            cwd: o.cwd,
+            ...(knownId === undefined ? {} : { agentSessionId: knownId }),
+            ...(o.bootTimeoutMs === undefined ? {} : { timeoutMs: o.bootTimeoutMs }),
+            ...(o.trustWorkspace === undefined ? {} : { trustWorkspace: o.trustWorkspace }),
+            ...(injection.rendezvousPath === undefined
+                ? {}
+                : { rendezvousPath: injection.rendezvousPath }),
+        });
+    }
+    catch (err) {
+        await o.backend.kill(o.ref).catch(() => undefined);
+        throw err;
+    }
+    // Best-effort: cache the id so adopt() can recover it after the process dies.
+    // Never load-bearing (the id is already on the handle); a failure is ignored.
+    if (agentSessionId !== undefined) {
+        await o.backend
+            .setSessionMeta(o.ref, AGENT_SESSION_ID_META_KEY, agentSessionId)
+            .catch(() => undefined);
+    }
+    return makeHandle({
+        backend: o.backend,
+        agent: o.agent,
+        namespace: o.ref.namespace,
+        name: o.ref.name,
+        ...(agentSessionId === undefined ? {} : { agentSessionId }),
+        ...(injection.rendezvousPath === undefined ? {} : { rendezvousPath: injection.rendezvousPath }),
+    });
+}
+//# sourceMappingURL=spawn-boot.js.map

package/dist/session/spawn-boot.js.map

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

package/dist/session/validate.d.ts

@@ -0,0 +1,10 @@
+/** Validate a `name` or `namespace` field. Throws {@link InvalidSessionName}. */
+export declare function validateNamePart(field: "name" | "namespace", value: string): void;
+/**
+ * Validate a caller-supplied `agentSessionId`. Throws
+ * {@link InvalidAgentSessionId} if it is not a well-formed v4 UUID. This is a
+ * security boundary (the id reaches the agent argv and the backend's command
+ * grammar), not merely correctness — see the error's TSDoc.
+ */
+export declare function validateAgentSessionId(value: string): void;
+//# sourceMappingURL=validate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/session/validate.ts"],"names":[],"mappings":"AA6BA,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAyBjF;AAWD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAI1D"}

package/dist/session/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/session/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEzE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;AAE9E,8DAA8D;AAC9D,iGAAiG;AACjG,MAAM,YAAY,GAAG,OAAO,CAAC;AAE7B,iFAAiF;AACjF,MAAM,UAAU,gBAAgB,CAAC,KAA2B,EAAE,KAAa;IACzE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,mBAAmB,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,yDAAyD;QACzD,MAAM,IAAI,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,yBAAyB,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,kBAAkB,CAC1B,KAAK,EACL,KAAK,EACL,6EAA6E,CAC9E,CAAC;IACJ,CAAC;IACD,KAAK,MAAM,EAAE,IAAI,cAAc,EAAE,CAAC;QAChC,IAAI,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACnF,MAAM,IAAI,kBAAkB,CAC1B,KAAK,EACL,KAAK,EACL,oBAAoB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,gDAAgD,CAC1F,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,OAAO,GAAG,wEAAwE,CAAC;AAEzF;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,qBAAqB,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;AACH,CAAC"}

package/dist/state/classifier.d.ts

@@ -0,0 +1,29 @@
+import type { State } from "../types.js";
+import type { ClassifierRules } from "./types.js";
+/**
+ * Map pane text → {@link State} via the agent's rules.
+ *
+ * **The dispatch order is load-bearing** and enforced by the function's
+ * structure, not by reviewer vigilance:
+ *
+ *   `dialog → permission-prompt → working → idle → unknown`
+ *
+ * Dialog is checked before everything else so a boot dialog with a stray
+ * idle-shaped substring cannot mis-classify as idle. Permission-prompt is
+ * checked before working/idle so a permission shape mid-stream cannot
+ * mis-classify as working. `unknown` is the contractual "no predicate
+ * fired" return — consumers must not treat it as idle.
+ *
+ * @param text - The pane text to classify. Callers must pre-slice to the
+ *   bottom-N lines (the "scrollback trap" — see
+ *   `engineer/wiki/tmux-capture-pane-the-bottom-n-trap`).
+ * @param rules - The agent's predicate set.
+ *
+ * @example
+ * ```ts
+ * import { classify } from "./classifier.js";
+ * const state = classify(bottomLines, claude.rules);
+ * ```
+ */
+export declare function classify(text: string, rules: ClassifierRules): State;
+//# sourceMappingURL=classifier.d.ts.map

package/dist/state/classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifier.d.ts","sourceRoot":"","sources":["../../src/state/classifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,KAAK,CAMpE"}

package/dist/state/classifier.js

@@ -0,0 +1,37 @@
+/**
+ * Map pane text → {@link State} via the agent's rules.
+ *
+ * **The dispatch order is load-bearing** and enforced by the function's
+ * structure, not by reviewer vigilance:
+ *
+ *   `dialog → permission-prompt → working → idle → unknown`
+ *
+ * Dialog is checked before everything else so a boot dialog with a stray
+ * idle-shaped substring cannot mis-classify as idle. Permission-prompt is
+ * checked before working/idle so a permission shape mid-stream cannot
+ * mis-classify as working. `unknown` is the contractual "no predicate
+ * fired" return — consumers must not treat it as idle.
+ *
+ * @param text - The pane text to classify. Callers must pre-slice to the
+ *   bottom-N lines (the "scrollback trap" — see
+ *   `engineer/wiki/tmux-capture-pane-the-bottom-n-trap`).
+ * @param rules - The agent's predicate set.
+ *
+ * @example
+ * ```ts
+ * import { classify } from "./classifier.js";
+ * const state = classify(bottomLines, claude.rules);
+ * ```
+ */
+export function classify(text, rules) {
+    if (rules.dialog(text))
+        return "dialog";
+    if (rules.permissionPrompt(text))
+        return "permission-prompt";
+    if (rules.working(text))
+        return "working";
+    if (rules.idle(text))
+        return "idle";
+    return "unknown";
+}
+//# sourceMappingURL=classifier.js.map

package/dist/state/classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifier.js","sourceRoot":"","sources":["../../src/state/classifier.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,KAAsB;IAC3D,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC;IACxC,IAAI,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC;QAAE,OAAO,mBAAmB,CAAC;IAC7D,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC;IACpC,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/state/types.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Predicates the classifier dispatches over. Each agent (`src/agents/*.ts`)
+ * supplies its own rules; the classifier itself is agent-agnostic.
+ */
+export interface ClassifierRules {
+    /** True when the pane is showing a boot/system dialog. */
+    dialog(text: string): boolean;
+    /** True when the pane is showing a permission prompt awaiting user input. */
+    permissionPrompt(text: string): boolean;
+    /** True when the agent is actively producing output (spinner, streaming). */
+    working(text: string): boolean;
+    /** True when the REPL is idle and ready for input. */
+    idle(text: string): boolean;
+    /**
+     * True when the pane shows a turn that was **interrupted** (ESC) rather than
+     * completed — a state only the pane sees (interrupt fires no `stop` hook).
+     * Optional: agents that can't distinguish it simply omit it. The Observer
+     * maps it to a `TurnOutcome` of `aborted`.
+     */
+    interrupted?(text: string): boolean;
+    /**
+     * True when the pane shows that input sent mid-turn was **queued** (the agent
+     * was busy, so it accepted the message to run after the current turn) rather
+     * than started immediately. Like {@link interrupted}, this is an orthogonal
+     * pane fact, NOT a dispatched {@link import('../types.js').State} (the agent is
+     * still `working`); it is read separately — by the send path, to tell a queued
+     * delivery ("accepted, will run") apart from a lost one ("re-send"). Optional:
+     * agents with no queue affordance omit it.
+     */
+    queued?(text: string): boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/state/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/state/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,6EAA6E;IAC7E,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACxC,6EAA6E;IAC7E,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B,sDAAsD;IACtD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B;;;;;OAKG;IACH,WAAW,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACpC;;;;;;;;OAQG;IACH,MAAM,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAChC"}

package/dist/state/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/state/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/state/types.ts"],"names":[],"mappings":""}