pi-kot 0.1.21 → 0.1.22

package/server/orchestration/types.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Session orchestration — types + constants.
+ *
+ * A "supervisor" session has the `orchestrate_*` tool group enabled
+ * and can spawn / observe / message / interrupt / kill / detach a set
+ * of "worker" sessions. Workers are real first-class sessions (same
+ * .jsonl on disk, same browser visibility) — the link is purely
+ * forge-side metadata in `${FORGE_DATA_DIR}/session-orchestration.json`.
+ *
+ * Topology is strict hub-and-spoke: workers don't get the orchestrate
+ * tools and have no way to enumerate or message other workers.
+ * Enforcement is by tool-surface (the tools simply aren't there),
+ * not by permission check at the registry layer.
+ *
+ * Depth is limited to 1: a worker cannot become a supervisor. Keeps
+ * the worst case bounded against fork-bomb runaway prompts.
+ */
+export declare const ORCHESTRATION_VERSION: 1;
+/**
+ * Worker event types stored in orchestration history and pushed to
+ * supervisors as `orchestration-notify` custom messages.
+ */
+export declare const INBOX_EVENT_TYPES: readonly ["worker.ended", "worker.ask_user", "worker.execution_stopped_without_agent_end", "worker.auto_retry_failed", "worker.process_alert", "worker.deleted"];
+export type InboxEventType = (typeof INBOX_EVENT_TYPES)[number];
+export declare function isInboxEventType(v: unknown): v is InboxEventType;
+export interface InboxItem {
+    id: string;
+    type: InboxEventType;
+    workerId: string;
+    occurredAt: string;
+    data: Record<string, unknown>;
+    delivered: boolean;
+}
+export interface SupervisorRecord {
+    enabledAt: string;
+    workerIds: string[];
+}
+export type WorkerLifecycleState = "idle" | "running" | "ended" | "errored" | "stopped" | "deleted" | "awaiting_question";
+export interface WorkerRecord {
+    supervisorId: string;
+    spawnedAt: string;
+    spawnedFrom?: {
+        sessionId: string;
+        mode: "fresh" | "summary";
+    };
+    state?: WorkerLifecycleState;
+    turnOpen?: boolean;
+    lastStateAt?: string;
+    lastAgentStartAt?: string;
+    lastAgentEndAt?: string;
+    stopReason?: string | null;
+    errorMessage?: string | null;
+}
+export interface OrchestrationStore {
+    version: typeof ORCHESTRATION_VERSION;
+    supervisors: Record<string, SupervisorRecord>;
+    workers: Record<string, WorkerRecord>;
+}
+export declare function emptyStore(): OrchestrationStore;
+export interface InboxStore {
+    version: typeof ORCHESTRATION_VERSION;
+    inboxes: Record<string, InboxItem[]>;
+}
+export declare function emptyInboxStore(): InboxStore;
+export declare const MAX_INBOX_ITEMS = 200;
+export declare const DEFAULT_MAX_WORKERS_PER_SUPERVISOR = 8;
+export declare const MAX_DEPTH = 1;
+//# sourceMappingURL=types.d.ts.map

package/server/orchestration/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/orchestration/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,eAAO,MAAM,qBAAqB,EAAG,CAAU,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,YAC5B,cAAc,EACd,iBAAiB,EACjB,4CAA4C,EAC5C,0BAA0B,EAC1B,sBAAsB,EACtB,gBAAgB,CACR,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,cAAc,CAEhE;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,MAAM,oBAAoB,GAC5B,MAAM,GACN,SAAS,GACT,OAAO,GACP,SAAS,GACT,SAAS,GACT,SAAS,GACT,mBAAmB,CAAC;AAExB,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;KAC3B,CAAC;IACF,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,qBAAqB,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC9C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACvC;AAED,wBAAgB,UAAU,IAAI,kBAAkB,CAE/C;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,qBAAqB,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;CACtC;AAED,wBAAgB,eAAe,IAAI,UAAU,CAE5C;AAED,eAAO,MAAM,eAAe,MAAM,CAAC;AACnC,eAAO,MAAM,kCAAkC,IAAI,CAAC;AACpD,eAAO,MAAM,SAAS,IAAI,CAAC"}

package/server/orchestration/types.js

@@ -0,0 +1,43 @@
+/**
+ * Session orchestration — types + constants.
+ *
+ * A "supervisor" session has the `orchestrate_*` tool group enabled
+ * and can spawn / observe / message / interrupt / kill / detach a set
+ * of "worker" sessions. Workers are real first-class sessions (same
+ * .jsonl on disk, same browser visibility) — the link is purely
+ * forge-side metadata in `${FORGE_DATA_DIR}/session-orchestration.json`.
+ *
+ * Topology is strict hub-and-spoke: workers don't get the orchestrate
+ * tools and have no way to enumerate or message other workers.
+ * Enforcement is by tool-surface (the tools simply aren't there),
+ * not by permission check at the registry layer.
+ *
+ * Depth is limited to 1: a worker cannot become a supervisor. Keeps
+ * the worst case bounded against fork-bomb runaway prompts.
+ */
+export const ORCHESTRATION_VERSION = 1;
+/**
+ * Worker event types stored in orchestration history and pushed to
+ * supervisors as `orchestration-notify` custom messages.
+ */
+export const INBOX_EVENT_TYPES = [
+    "worker.ended",
+    "worker.ask_user",
+    "worker.execution_stopped_without_agent_end",
+    "worker.auto_retry_failed",
+    "worker.process_alert",
+    "worker.deleted",
+];
+export function isInboxEventType(v) {
+    return typeof v === "string" && INBOX_EVENT_TYPES.includes(v);
+}
+export function emptyStore() {
+    return { version: ORCHESTRATION_VERSION, supervisors: {}, workers: {} };
+}
+export function emptyInboxStore() {
+    return { version: ORCHESTRATION_VERSION, inboxes: {} };
+}
+export const MAX_INBOX_ITEMS = 200;
+export const DEFAULT_MAX_WORKERS_PER_SUPERVISOR = 8;
+export const MAX_DEPTH = 1;
+//# sourceMappingURL=types.js.map

package/server/orchestration/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/orchestration/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAU,CAAC;AAEhD;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,cAAc;IACd,iBAAiB;IACjB,4CAA4C;IAC5C,0BAA0B;IAC1B,sBAAsB;IACtB,gBAAgB;CACR,CAAC;AAIX,MAAM,UAAU,gBAAgB,CAAC,CAAU;IACzC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAK,iBAAuC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AACvF,CAAC;AA+CD,MAAM,UAAU,UAAU;IACxB,OAAO,EAAE,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;AAC1E,CAAC;AAOD,MAAM,UAAU,eAAe;IAC7B,OAAO,EAAE,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;AACzD,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAC;AACnC,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC;AACpD,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC"}

package/server/orchestration/worker-lifecycle.d.ts

@@ -0,0 +1,15 @@
+export type WorkerArchiveStatus = "archived" | "not_found";
+export interface KillWorkerResult {
+    wasLive: boolean;
+    archiveStatus: WorkerArchiveStatus;
+}
+export interface CleanupSupervisorWorkersResult {
+    workerIds: string[];
+    results: Record<string, KillWorkerResult>;
+}
+export declare function killWorkerAndArchive(args: {
+    supervisorId: string;
+    workerId: string;
+}): Promise<KillWorkerResult>;
+export declare function cleanupWorkersForDeletedSupervisor(supervisorId: string): Promise<CleanupSupervisorWorkersResult>;
+//# sourceMappingURL=worker-lifecycle.d.ts.map

package/server/orchestration/worker-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-lifecycle.d.ts","sourceRoot":"","sources":["../../src/orchestration/worker-lifecycle.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,WAAW,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,mBAAmB,CAAC;CACpC;AAED,MAAM,WAAW,8BAA8B;IAC7C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC3C;AAuBD,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAe5B;AAED,wBAAsB,kCAAkC,CACtD,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,8BAA8B,CAAC,CAQzC"}

package/server/orchestration/worker-lifecycle.js

@@ -0,0 +1,45 @@
+import { disposeSession, getSession } from "../session-store.js";
+import { bridgeWorkerDeleted } from "./event-bridge.js";
+import { disableSupervisor, getWorkerIds, unregisterWorker } from "./store.js";
+function notifySupervisorSessionListChanged(args) {
+    const supervisor = getSession(args.supervisorId);
+    if (supervisor === undefined)
+        return;
+    for (const client of supervisor.clients) {
+        try {
+            client.send({
+                type: "session_list_changed",
+                reason: args.reason,
+                projectId: supervisor.projectId,
+                sessionId: args.workerId,
+            });
+        }
+        catch {
+            // SSE client already dropped
+        }
+    }
+}
+export async function killWorkerAndArchive(args) {
+    const wasLive = await disposeSession(args.workerId);
+    await bridgeWorkerDeleted(args.workerId, { wasLive, reason: "killed" }).catch(() => undefined);
+    await unregisterWorker(args.workerId);
+    notifySupervisorSessionListChanged({
+        supervisorId: args.supervisorId,
+        workerId: args.workerId,
+        reason: "kill_worker",
+    });
+    return {
+        wasLive,
+        archiveStatus: "archived",
+    };
+}
+export async function cleanupWorkersForDeletedSupervisor(supervisorId) {
+    const workerIds = await getWorkerIds(supervisorId);
+    const results = {};
+    for (const workerId of workerIds) {
+        results[workerId] = await killWorkerAndArchive({ supervisorId, workerId });
+    }
+    await disableSupervisor(supervisorId);
+    return { workerIds, results };
+}
+//# sourceMappingURL=worker-lifecycle.js.map

package/server/orchestration/worker-lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-lifecycle.js","sourceRoot":"","sources":["../../src/orchestration/worker-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,cAAc,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAc/E,SAAS,kCAAkC,CAAC,IAI3C;IACC,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACjD,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO;IACrC,KAAK,MAAM,MAAM,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;QACxC,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,sBAAsB;gBAC5B,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,SAAS,EAAE,UAAU,CAAC,SAAS;gBAC/B,SAAS,EAAE,IAAI,CAAC,QAAQ;aACzB,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,6BAA6B;QAC/B,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAG1C;IACC,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpD,MAAM,mBAAmB,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAC3E,GAAG,EAAE,CAAC,SAAS,CAChB,CAAC;IACF,MAAM,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtC,kCAAkC,CAAC;QACjC,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM,EAAE,aAAa;KACtB,CAAC,CAAC;IACH,OAAO;QACL,OAAO;QACP,aAAa,EAAE,UAAU;KAC1B,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kCAAkC,CACtD,YAAoB;IAEpB,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC,CAAC;IACnD,MAAM,OAAO,GAAqC,EAAE,CAAC;IACrD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,OAAO,CAAC,QAAQ,CAAC,GAAG,MAAM,oBAAoB,CAAC,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,iBAAiB,CAAC,YAAY,CAAC,CAAC;IACtC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;AAChC,CAAC"}

package/server/path-refs.d.ts

@@ -0,0 +1,5 @@
+/** Parse `@<path>` references out of a text without touching it. */
+export declare function parseFileReferences(text: string): string[];
+export declare function expandFileReferences(text: string, workspacePath: string): Promise<string>;
+export declare function languageHintForPath(path: string): string;
+//# sourceMappingURL=path-refs.d.ts.map

package/server/path-refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-refs.d.ts","sourceRoot":"","sources":["../src/path-refs.ts"],"names":[],"mappings":"AAgFA,oEAAoE;AACpE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAE1D;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgH/F;AAkED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGxD"}

package/server/path-refs.js

@@ -0,0 +1,249 @@
+import { extname, join } from "node:path";
+import { readFile } from "./file-manager.js";
+import { stat, open as fsOpen } from "node:fs/promises";
+/**
+ * Process `@<path>` references in user input. The chat input's
+ * `@`-autocomplete inserts these markers; this helper transforms them
+ * server-side before the prompt reaches pi's `session.prompt()`.
+ *
+ * Threshold-based design: small files get inlined as fenced code blocks
+ * (the model has the content immediately, no tool round-trip); large
+ * files stay as the literal `@<path>` reference (the model loads what
+ * it needs via its read/grep/find tools, no context-burn on a 50 MB
+ * log we'd otherwise inhale wholesale).
+ *
+ * The chat UI renders BOTH forms as collapsed file badges in the user
+ * message bubble, so visually the user sees a chip either way; the
+ * difference is purely whether the LLM has the content in-prompt or
+ * has to fetch it.
+ *
+ * Behaviour:
+ * - Markers must be at start-of-string OR preceded by whitespace
+ *   (avoid expanding `email@example.com`).
+ * - Two path forms accepted:
+ *     `@<path>`               — greedy non-whitespace; common case.
+ *     `@"<path with spaces>"` — anything that isn't a `"` or newline.
+ * - Resolved against the project's workspace root via file-manager's
+ *   path-traversal-safe `checkFileReference`. Four outcomes:
+ *     inline    → file ≤ INLINE_THRESHOLD; replace marker with a
+ *                  fenced code block. Language hint derived from
+ *                  extension.
+ *     defer     → file > INLINE_THRESHOLD; leave the literal `@<path>`
+ *                  reference for the model to load on demand.
+ *     directory → path is a directory; preserve the marker normalized
+ *                  with a trailing `/` (e.g. `@src/components/`) so
+ *                  the model can ls/find/grep it via its tools.
+ *     error     → missing / outside root / binary. Replace marker
+ *                  with `[@<path> not included: <reason>]`.
+ *
+ * Multiple markers in one prompt are classified independently, then
+ * inline candidates compete for a shared aggregate budget. See
+ * `AGGREGATE_INLINE_BUDGET_BYTES` for the cap and the smallest-first
+ * walk that keeps the degradation graceful.
+ */
+/** Per-file inlining cutoff. 128 KB ≈ 32K tokens. */
+const INLINE_THRESHOLD_BYTES = 128 * 1024;
+/** Aggregate cap on TOTAL bytes inlined across every `@<path>` in one prompt. 512 KB ≈ 128K tokens. */
+const AGGREGATE_INLINE_BUDGET_BYTES = 512 * 1024;
+/**
+ * Regex shared by `findRefs` and `parseFileReferences`. Match `@` at
+ * start-or-after-whitespace then either a `"path with spaces"` quoted
+ * form or a bare non-whitespace token.
+ */
+const REF_RE = /(^|\s)@(?:"([^"\n]+)"|([^\s]+?))(?=[?,;:!)\]]?(?:\s|$))/g;
+function findRefs(text) {
+    const matches = [];
+    REF_RE.lastIndex = 0;
+    let m;
+    while ((m = REF_RE.exec(text)) !== null) {
+        matches.push({
+            start: m.index,
+            end: m.index + m[0].length,
+            lead: m[1] ?? "",
+            path: m[2] ?? m[3] ?? "",
+        });
+    }
+    return matches;
+}
+/** Parse `@<path>` references out of a text without touching it. */
+export function parseFileReferences(text) {
+    return findRefs(text).map((m) => m.path);
+}
+export async function expandFileReferences(text, workspacePath) {
+    const matches = findRefs(text);
+    if (matches.length === 0)
+        return text;
+    // Phase 1: classify every marker in parallel
+    const classifications = await Promise.all(matches.map(async (mm) => {
+        try {
+            const abs = join(workspacePath, mm.path);
+            const st = await stat(abs).catch(() => undefined);
+            if (st === undefined)
+                return { kind: "error", reason: "file not found" };
+            if (st.isDirectory())
+                return { kind: "directory" };
+            // Binary sniff — read first 8 KB
+            const fh = await fsOpen(abs, "r");
+            try {
+                const buf = Buffer.alloc(8000);
+                const { bytesRead } = await fh.read(buf, 0, 8000, 0);
+                const binary = looksBinary(buf.subarray(0, bytesRead));
+                if (binary)
+                    return { kind: "error", reason: "binary file" };
+            }
+            finally {
+                await fh.close();
+            }
+            if (st.size > INLINE_THRESHOLD_BYTES)
+                return { kind: "deferLarge" };
+            return { kind: "inlineCandidate", size: st.size, abs };
+        }
+        catch (err) {
+            const e = err;
+            if (e.name === "NotFoundError" || e.code === "ENOENT") {
+                return { kind: "error", reason: "file not found" };
+            }
+            if (e.name === "PathOutsideRootError") {
+                return { kind: "error", reason: "path is outside allowed roots" };
+            }
+            return { kind: "error", reason: "unreadable" };
+        }
+    }));
+    // Phase 2: aggregate-budget walk, smallest-first
+    const inlineSet = new Set();
+    const candidateIndices = [];
+    for (let i = 0; i < classifications.length; i += 1) {
+        const c = classifications[i];
+        if (c?.kind === "inlineCandidate")
+            candidateIndices.push({ i, size: c.size });
+    }
+    candidateIndices.sort((a, b) => a.size - b.size);
+    let remaining = AGGREGATE_INLINE_BUDGET_BYTES;
+    for (const { i, size } of candidateIndices) {
+        if (size <= remaining) {
+            inlineSet.add(i);
+            remaining -= size;
+        }
+    }
+    // Phase 3: read content for budget survivors
+    const outcomes = await Promise.all(classifications.map(async (c, i) => {
+        if (c.kind === "directory")
+            return { kind: "directory" };
+        if (c.kind === "error")
+            return { kind: "error", reason: c.reason };
+        if (c.kind === "deferLarge")
+            return { kind: "defer" };
+        if (!inlineSet.has(i))
+            return { kind: "defer" };
+        try {
+            const result = await readFile(c.abs, workspacePath);
+            if (result.binary)
+                return { kind: "error", reason: "binary file" };
+            const mm = matches[i];
+            if (mm === undefined)
+                return { kind: "defer" };
+            return { kind: "inline", text: formatExpansion(mm.path, result.content) };
+        }
+        catch (err) {
+            const e = err;
+            if (e.name === "FileTooLargeError" || e.name === "NotFoundError" || e.code === "ENOENT") {
+                return { kind: "defer" };
+            }
+            return { kind: "error", reason: "unreadable" };
+        }
+    }));
+    // Walk in reverse so earlier indices stay valid
+    let out = text;
+    for (let i = matches.length - 1; i >= 0; i--) {
+        const outcome = outcomes[i];
+        const mm = matches[i];
+        if (outcome === undefined || mm === undefined)
+            continue;
+        const before = out.slice(0, mm.start) + mm.lead;
+        const after = out.slice(mm.end);
+        const marker = /\s/.test(mm.path) ? `@"${mm.path}"` : `@${mm.path}`;
+        if (outcome.kind === "inline") {
+            out = `${before}${marker}\n${outcome.text}\n${after}`;
+        }
+        else if (outcome.kind === "defer") {
+            out = `${before}${marker}${after}`;
+        }
+        else if (outcome.kind === "directory") {
+            const dirPath = mm.path.endsWith("/") ? mm.path : `${mm.path}/`;
+            const dirMarker = /\s/.test(dirPath) ? `@"${dirPath}"` : `@${dirPath}`;
+            out = `${before}${dirMarker}${after}`;
+        }
+        else {
+            out = `${before}[${marker} not included: ${outcome.reason}]${after}`;
+        }
+    }
+    return out;
+}
+function formatExpansion(path, content) {
+    const lang = languageHintForPath(path);
+    const fence = pickFence(content);
+    return `${fence}${lang} file: ${path}\n${content}\n${fence}`;
+}
+function pickFence(content) {
+    let max = 0;
+    let run = 0;
+    for (const ch of content) {
+        if (ch === "`") {
+            run += 1;
+            if (run > max)
+                max = run;
+        }
+        else {
+            run = 0;
+        }
+    }
+    return "`".repeat(Math.max(3, max + 1));
+}
+function looksBinary(buf) {
+    const limit = Math.min(buf.length, 8000);
+    for (let i = 0; i < limit; i++) {
+        if (buf[i] === 0)
+            return true;
+    }
+    return false;
+}
+const LANG_BY_EXT = {
+    ".ts": "ts",
+    ".tsx": "tsx",
+    ".js": "js",
+    ".jsx": "jsx",
+    ".mjs": "js",
+    ".cjs": "js",
+    ".json": "json",
+    ".py": "python",
+    ".rb": "ruby",
+    ".go": "go",
+    ".rs": "rust",
+    ".java": "java",
+    ".kt": "kotlin",
+    ".swift": "swift",
+    ".c": "c",
+    ".h": "c",
+    ".cpp": "cpp",
+    ".cc": "cpp",
+    ".hpp": "cpp",
+    ".cs": "csharp",
+    ".php": "php",
+    ".sh": "bash",
+    ".bash": "bash",
+    ".zsh": "bash",
+    ".yml": "yaml",
+    ".yaml": "yaml",
+    ".toml": "toml",
+    ".md": "markdown",
+    ".html": "html",
+    ".css": "css",
+    ".scss": "scss",
+    ".sql": "sql",
+    ".xml": "xml",
+};
+export function languageHintForPath(path) {
+    const ext = extname(path).toLowerCase();
+    return LANG_BY_EXT[ext] ?? "";
+}
+//# sourceMappingURL=path-refs.js.map

package/server/path-refs.js.map

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

package/server/routes/_schemas.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Shared response schemas used across multiple route files.
+ */
+export declare const errorSchema: {
+    readonly type: "object";
+    readonly required: readonly ["error"];
+    readonly properties: {
+        readonly error: {
+            readonly type: "string";
+        };
+        readonly message: {
+            readonly type: "string";
+        };
+    };
+};
+//# sourceMappingURL=_schemas.d.ts.map

package/server/routes/_schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_schemas.d.ts","sourceRoot":"","sources":["../../src/routes/_schemas.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,WAAW;aACtB,IAAI,EAAE,QAAQ;aACd,QAAQ,YAAG,OAAO;aAClB,UAAU;iBACR,KAAK;qBAAI,IAAI,EAAE,QAAQ;;iBACvB,OAAO;qBAAI,IAAI,EAAE,QAAQ;;;CAEnB,CAAC"}

package/server/routes/_schemas.js

@@ -0,0 +1,12 @@
+/**
+ * Shared response schemas used across multiple route files.
+ */
+export const errorSchema = {
+    type: "object",
+    required: ["error"],
+    properties: {
+        error: { type: "string" },
+        message: { type: "string" },
+    },
+};
+//# sourceMappingURL=_schemas.js.map

package/server/routes/_schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_schemas.js","sourceRoot":"","sources":["../../src/routes/_schemas.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,CAAC,OAAO,CAAC;IACnB,UAAU,EAAE;QACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC5B;CACO,CAAC"}

package/server/routes/ask-user-question.d.ts

@@ -0,0 +1,3 @@
+import type { FastifyPluginAsync } from "fastify";
+export declare const askUserQuestionRoutes: FastifyPluginAsync;
+//# sourceMappingURL=ask-user-question.d.ts.map

package/server/routes/ask-user-question.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user-question.d.ts","sourceRoot":"","sources":["../../src/routes/ask-user-question.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAsClD,eAAO,MAAM,qBAAqB,EAAE,kBAsFnC,CAAC"}

package/server/routes/ask-user-question.js

@@ -0,0 +1,105 @@
+import { getSession } from "../session-store.js";
+import { answerPending, getPendingForSession } from "../ask-user-question/registry.js";
+import { buildResult } from "../ask-user-question/envelope.js";
+const answerBodySchema = {
+    type: "object",
+    required: ["requestId"],
+    additionalProperties: false,
+    properties: {
+        requestId: { type: "string", minLength: 1 },
+        cancelled: { type: "boolean" },
+        answers: {
+            type: "array",
+            items: {
+                type: "object",
+                required: ["questionIndex", "question", "kind"],
+                properties: {
+                    questionIndex: { type: "integer", minimum: 0 },
+                    question: { type: "string" },
+                    kind: { type: "string", enum: ["option", "custom", "chat", "multi"] },
+                    answer: { type: ["string", "null"] },
+                    selected: { type: "array", items: { type: "string" } },
+                    notes: { type: "string" },
+                    preview: { type: "string" },
+                },
+            },
+        },
+    },
+};
+export const askUserQuestionRoutes = async (fastify) => {
+    fastify.get("/sessions/:id/ask-user-question/pending", {
+        schema: {
+            params: {
+                type: "object",
+                required: ["id"],
+                properties: { id: { type: "string" } },
+            },
+            response: {
+                200: {
+                    type: "object",
+                    required: ["pending"],
+                    properties: {
+                        pending: {
+                            type: "array",
+                            items: {
+                                type: "object",
+                                required: ["requestId", "questions"],
+                                properties: {
+                                    requestId: { type: "string" },
+                                    questions: { type: "array" },
+                                },
+                            },
+                        },
+                    },
+                },
+                404: {
+                    type: "object",
+                    properties: { error: { type: "string" } },
+                },
+            },
+        },
+    }, async (req, reply) => {
+        const live = getSession(req.params.id);
+        if (live === undefined) {
+            return reply.code(404).send({ error: "session_not_found" });
+        }
+        const pending = getPendingForSession(req.params.id).map((p) => ({
+            requestId: p.requestId,
+            questions: p.questions,
+        }));
+        return { pending };
+    });
+    fastify.post("/sessions/:id/ask-user-question/answer", {
+        schema: {
+            params: {
+                type: "object",
+                required: ["id"],
+                properties: { id: { type: "string" } },
+            },
+            body: answerBodySchema,
+            response: {
+                204: { type: "null" },
+                404: {
+                    type: "object",
+                    properties: { error: { type: "string" } },
+                },
+            },
+        },
+    }, async (req, reply) => {
+        const live = getSession(req.params.id);
+        if (live === undefined) {
+            return reply.code(404).send({ error: "session_not_found" });
+        }
+        const cancelled = req.body.cancelled === true;
+        const answers = Array.isArray(req.body.answers) ? req.body.answers : [];
+        const pending = getPendingForSession(req.params.id).find((p) => p.requestId === req.body.requestId);
+        const questionCount = pending?.questions.length ?? answers.length;
+        const envelope = buildResult(answers, { cancelled, questionCount });
+        const ok = answerPending(req.body.requestId, req.params.id, envelope);
+        if (!ok) {
+            return reply.code(404).send({ error: "request_not_found" });
+        }
+        return reply.code(204).send();
+    });
+};
+//# sourceMappingURL=ask-user-question.js.map

package/server/routes/ask-user-question.js.map

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

package/server/routes/auth.d.ts

@@ -0,0 +1,8 @@
+import type { FastifyPluginAsync } from "fastify";
+export declare function verifyHmac(token: string): string | undefined;
+export declare function extractBearer(header: string | undefined): string | undefined;
+export declare function authEnabled(): boolean;
+export declare const versionRoutes: FastifyPluginAsync;
+export declare const healthRoutes: FastifyPluginAsync;
+export declare const authRoutes: FastifyPluginAsync;
+//# sourceMappingURL=auth.d.ts.map

package/server/routes/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/routes/auth.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAmBlD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAgB5D;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAI5E;AAED,wBAAgB,WAAW,IAAI,OAAO,CAErC;AA8CD,eAAO,MAAM,aAAa,EAAE,kBA8E3B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,kBA2B1B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,kBAgExB,CAAC"}