pi-kot 0.1.21 → 0.1.23

package/dist/server/orchestration/inbox.js

@@ -0,0 +1,186 @@
+/**
+ * Worker notification surface — the bridge between worker events and
+ * supervisor custom messages. The persisted inbox store remains as UI
+ * history/audit data.
+ *
+ * Delivery policy:
+ *   - If the supervisor is active, every worker update is delivered as
+ *     `steer` so it can enter the current run at the next model step.
+ *   - If the supervisor is idle, every update except delete/unregister
+ *     starts a new turn; delete/unregister only appends a visible card.
+ */
+import { sendCustomLifecycleMessage } from "../session-alerts.js";
+import { getSession } from "../session-store.js";
+import { enqueueInboxItem, getSupervisorIdForWorker, readPendingInbox } from "./store.js";
+const wakeCounters = new Map();
+function nextWakeCounter(supervisorId) {
+    const n = (wakeCounters.get(supervisorId) ?? 0) + 1;
+    wakeCounters.set(supervisorId, n);
+    return n;
+}
+function logInbox(level, payload) {
+    process.stderr.write(`${JSON.stringify({ level, time: new Date().toISOString(), ...payload })}\n`);
+}
+export const ORCHESTRATION_WAKE_PREFIX = "[orchestration]";
+export const ORCHESTRATION_NOTIFY_TYPE = "orchestration-notify";
+export function shouldTriggerWorkerTurn(type) {
+    return type !== "worker.deleted";
+}
+function workerStateForInboxType(type) {
+    if (type === "worker.ended")
+        return "ended";
+    if (type === "worker.execution_stopped_without_agent_end")
+        return "failed";
+    if (type === "worker.deleted")
+        return "deleted";
+    if (type === "worker.ask_user")
+        return "awaiting_question";
+    if (type === "worker.process_alert")
+        return "process_alert";
+    return type.replace(/^worker\./, "");
+}
+function buildNotificationText(type, workerId, data) {
+    const state = workerStateForInboxType(type);
+    const lines = [`Worker ${workerId} reported ${state}.`];
+    const detail = summarizeWorkerEventData(type, data);
+    if (detail !== "")
+        lines.push(detail);
+    return lines.join("\n\n");
+}
+function summarizeWorkerEventData(type, data) {
+    if (type === "worker.ended") {
+        const stop = typeof data.stopReason === "string" ? data.stopReason : "unknown";
+        const err = typeof data.errorMessage === "string" && data.errorMessage.length > 0
+            ? data.errorMessage
+            : "";
+        const text = typeof data.assistantText === "string" && data.assistantText.length > 0
+            ? data.assistantText
+            : "";
+        const parts = [`stopReason: ${stop}`];
+        if (err !== "")
+            parts.push(`errorMessage:\n${err}`);
+        if (text !== "")
+            parts.push(`finalMessage:\n${text}`);
+        return parts.join("\n\n");
+    }
+    if (type === "worker.ask_user") {
+        const count = typeof data.questionCount === "number" ? data.questionCount : 1;
+        const header = typeof data.firstQuestionHeader === "string" ? data.firstQuestionHeader : "";
+        const text = typeof data.firstQuestionText === "string" ? data.firstQuestionText : "";
+        return [
+            `questionCount: ${count}`,
+            header !== "" ? `firstQuestionHeader: ${header}` : "",
+            text !== "" ? `firstQuestionText:\n${text}` : "",
+        ]
+            .filter((part) => part !== "")
+            .join("\n\n");
+    }
+    if (type === "worker.execution_stopped_without_agent_end") {
+        const reason = typeof data.reason === "string" ? data.reason : "stopped";
+        const lastStart = typeof data.lastAgentStartAt === "string" ? data.lastAgentStartAt : "";
+        return `reason: ${reason}${lastStart !== "" ? `\nlastAgentStartAt: ${lastStart}` : ""}`;
+    }
+    if (type === "worker.deleted") {
+        return `wasLive: ${data.wasLive === true ? "true" : "false"}`;
+    }
+    try {
+        return JSON.stringify(data, null, 2);
+    }
+    catch {
+        return "";
+    }
+}
+async function tryWakeSupervisor(supervisorId, event) {
+    const live = getSession(supervisorId);
+    if (live === undefined)
+        return false;
+    const pendingItems = await readPendingInbox(supervisorId);
+    const pending = pendingItems.length;
+    const fallbackItem = pendingItems.find((it) => shouldTriggerWorkerTurn(it.type)) ?? pendingItems[0];
+    const effectiveEvent = event ??
+        (fallbackItem === undefined
+            ? undefined
+            : {
+                type: fallbackItem.type,
+                workerId: fallbackItem.workerId,
+                itemId: fallbackItem.id,
+                data: fallbackItem.data,
+            });
+    if (effectiveEvent === undefined)
+        return false;
+    const triggerTurn = shouldTriggerWorkerTurn(effectiveEvent.type);
+    const seq = nextWakeCounter(supervisorId);
+    const type = effectiveEvent.type;
+    const workerId = effectiveEvent.workerId;
+    const text = buildNotificationText(type, workerId, effectiveEvent.data);
+    sendCustomLifecycleMessage(live.session, {
+        customType: ORCHESTRATION_NOTIFY_TYPE,
+        content: text,
+        display: true,
+        details: {
+            source: "orchestration",
+            state: workerStateForInboxType(type),
+            eventType: type,
+            workerId,
+            inboxItemId: effectiveEvent.itemId,
+            pendingCount: pending,
+            data: effectiveEvent.data,
+        },
+    }, {
+        triggerTurn,
+        dedupe: { detailKey: "inboxItemId", detailValue: effectiveEvent.itemId },
+        onError: (err) => {
+            logInbox("warn", {
+                msg: "orchestration-wake-failed",
+                supervisorId,
+                workerId,
+                type,
+                pending,
+                seq,
+                triggerTurn,
+                err: err instanceof Error ? err.message : String(err),
+            });
+        },
+    });
+    logInbox("info", {
+        msg: "orchestration-wake-delivered",
+        supervisorId,
+        workerId,
+        type,
+        pending,
+        seq,
+        triggerTurn,
+    });
+    return true;
+}
+export async function bridgeWorkerEvent(workerId, type, data) {
+    const supervisorId = await getSupervisorIdForWorker(workerId);
+    if (supervisorId === undefined)
+        return undefined;
+    const item = await enqueueInboxItem(supervisorId, {
+        type,
+        workerId,
+        occurredAt: new Date().toISOString(),
+        data,
+        delivered: true,
+    });
+    logInbox("info", {
+        msg: "orchestration-inbox-enqueued",
+        supervisorId,
+        workerId,
+        type,
+        itemId: item.id,
+    });
+    void tryWakeSupervisor(supervisorId, { type, workerId, itemId: item.id, data });
+    return item;
+}
+export async function notifySupervisorIdle(supervisorId) {
+    void tryWakeSupervisor(supervisorId);
+}
+export function notifySupervisorDisposed(supervisorId) {
+    wakeCounters.delete(supervisorId);
+}
+export async function drainInbox(supervisorId) {
+    return readPendingInbox(supervisorId, { markDelivered: true });
+}
+//# sourceMappingURL=inbox.js.map

package/dist/server/orchestration/inbox.js.map

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

package/dist/server/orchestration/init.d.ts

@@ -0,0 +1,2 @@
+export declare function initOrchestrationAskUserQuestionBridge(): () => void;
+//# sourceMappingURL=init.d.ts.map

package/dist/server/orchestration/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/orchestration/init.ts"],"names":[],"mappings":"AAeA,wBAAgB,sCAAsC,IAAI,MAAM,IAAI,CAKnE"}

package/dist/server/orchestration/init.js

@@ -0,0 +1,22 @@
+/**
+ * Boot-time wiring of the orchestration event bridge to the
+ * forge-native singleton event channels (ask-user-question).
+ *
+ * Per-AgentSession events (agent_start, agent_end) are dispatched
+ * from inside session-store — those need the LiveSession context
+ * at construction time. session-store also calls
+ * `notifySupervisorIdle` on supervisor agent_end.
+ *
+ * The DELETE-side `worker.deleted` event is fired from the sessions
+ * DELETE route.
+ */
+import { subscribe as subscribeAskQuestions } from "../ask-user-question/registry.js";
+import { bridgeWorkerAskUserQuestion } from "./event-bridge.js";
+export function initOrchestrationAskUserQuestionBridge() {
+    return subscribeAskQuestions((event) => {
+        if (event.type !== "ask_user_question")
+            return;
+        void bridgeWorkerAskUserQuestion(event.sessionId, event.questions, event.requestId);
+    });
+}
+//# sourceMappingURL=init.js.map

package/dist/server/orchestration/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/orchestration/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,SAAS,IAAI,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACtF,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAEhE,MAAM,UAAU,sCAAsC;IACpD,OAAO,qBAAqB,CAAC,CAAC,KAAK,EAAE,EAAE;QACrC,IAAI,KAAK,CAAC,IAAI,KAAK,mBAAmB;YAAE,OAAO;QAC/C,KAAK,2BAA2B,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/server/orchestration/store.d.ts

@@ -0,0 +1,33 @@
+import { type InboxItem, type OrchestrationStore, type SupervisorRecord, type WorkerRecord } from "./types.js";
+export declare function readStore(): Promise<OrchestrationStore>;
+export declare class OrchestrationError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare function enableSupervisor(sessionId: string): Promise<SupervisorRecord>;
+export declare function disableSupervisor(sessionId: string): Promise<void>;
+export declare function registerWorker(opts: {
+    supervisorId: string;
+    workerId: string;
+    spawnedFrom?: {
+        sessionId: string;
+        mode: "fresh" | "summary";
+    };
+}): Promise<void>;
+export declare function unregisterWorker(workerId: string): Promise<void>;
+export declare function getSupervisorIdForWorker(workerId: string): Promise<string | undefined>;
+export declare function isSupervisor(sessionId: string): Promise<boolean>;
+export declare function isWorker(sessionId: string): Promise<boolean>;
+export declare function getWorkerIds(supervisorId: string): Promise<string[]>;
+export declare function getWorkerRecord(workerId: string): Promise<WorkerRecord | undefined>;
+export declare function updateWorkerLifecycle(workerId: string, patch: Partial<Pick<WorkerRecord, "state" | "turnOpen" | "lastStateAt" | "lastAgentStartAt" | "lastAgentEndAt" | "stopReason" | "errorMessage">>): Promise<WorkerRecord | undefined>;
+export declare function enqueueInboxItem(supervisorId: string, item: Omit<InboxItem, "id" | "delivered"> & {
+    delivered?: boolean;
+}): Promise<InboxItem>;
+export declare function readPendingInbox(supervisorId: string, opts?: {
+    markDelivered?: boolean;
+}): Promise<InboxItem[]>;
+export declare function readAllInbox(supervisorId: string): Promise<InboxItem[]>;
+export declare function pendingInboxCount(supervisorId: string): Promise<number>;
+export declare function clearInbox(supervisorId: string): Promise<void>;
+//# sourceMappingURL=store.d.ts.map

package/dist/server/orchestration/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/orchestration/store.ts"],"names":[],"mappings":"AAeA,OAAO,EAGL,KAAK,SAAS,EAKd,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EAErB,KAAK,YAAY,EAClB,MAAM,YAAY,CAAC;AAyGpB,wBAAsB,SAAS,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAE7D;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,YAAY,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAIxC;CACF;AAED,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAmBnF;AAED,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWxE;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,GAAG,SAAS,CAAA;KAAE,CAAC;CAChE,GAAG,OAAO,CAAC,IAAI,CAAC,CAmChB;AAED,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYtE;AAED,wBAAsB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAG5F;AAED,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGtE;AAED,wBAAsB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGlE;AAED,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAG1E;AAED,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAGzF;AAED,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,CACZ,IAAI,CACF,YAAY,EACV,OAAO,GACP,UAAU,GACV,aAAa,GACb,kBAAkB,GAClB,gBAAgB,GAChB,YAAY,GACZ,cAAc,CACjB,CACF,GACA,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CASnC;AAmDD,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAClE,OAAO,CAAC,SAAS,CAAC,CAepB;AAED,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,MAAM,EACpB,IAAI,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GACrC,OAAO,CAAC,SAAS,EAAE,CAAC,CAYtB;AAED,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAI7E;AAED,wBAAsB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI7E;AAED,wBAAsB,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOpE"}

package/dist/server/orchestration/store.js

@@ -0,0 +1,331 @@
+/**
+ * Disk-backed persistence for orchestration metadata.
+ *
+ * Two files in `${config.forgeDataDir}/`:
+ *   - `session-orchestration.json` — supervisor opt-in + supervisor↔worker links
+ *   - `orchestrator-inbox.json`    — per-supervisor pending event queue
+ *
+ * Separate files so the chatty inbox writes don't fight the rare
+ * topology mutations. Same atomic-write + in-process lock pattern as
+ * Single-tenant / single-process assumption.
+ */
+import { randomUUID } from "node:crypto";
+import { chmod, mkdir, readFile, rename, unlink, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { config } from "../config.js";
+import { emptyInboxStore, emptyStore, isInboxEventType, MAX_INBOX_ITEMS, ORCHESTRATION_VERSION, } from "./types.js";
+const STORE_FILE = () => join(config.forgeDataDir, "session-orchestration.json");
+const INBOX_FILE = () => join(config.forgeDataDir, "orchestrator-inbox.json");
+async function ensureDir() {
+    await mkdir(config.forgeDataDir, { recursive: true });
+}
+async function atomicWriteJson(target, data, mode) {
+    await ensureDir();
+    const tmp = `${target}.${randomUUID()}.tmp`;
+    await writeFile(tmp, JSON.stringify(data, null, 2), "utf8");
+    try {
+        await chmod(tmp, mode);
+        await rename(tmp, target);
+    }
+    catch (err) {
+        await unlink(tmp).catch(() => undefined);
+        throw err;
+    }
+}
+// ---- session-orchestration.json (topology) ----
+let storeLock = Promise.resolve();
+function withStoreLock(fn) {
+    const next = storeLock.then(fn, fn);
+    storeLock = next.catch(() => undefined);
+    return next;
+}
+function isSupervisorRecord(v) {
+    if (typeof v !== "object" || v === null)
+        return false;
+    const r = v;
+    return (typeof r.enabledAt === "string" &&
+        Array.isArray(r.workerIds) &&
+        r.workerIds.every((id) => typeof id === "string"));
+}
+const WORKER_LIFECYCLE_STATES = new Set([
+    "idle",
+    "running",
+    "ended",
+    "errored",
+    "stopped",
+    "deleted",
+    "awaiting_question",
+]);
+function isWorkerLifecycleState(v) {
+    return typeof v === "string" && WORKER_LIFECYCLE_STATES.has(v);
+}
+function isWorkerRecord(v) {
+    if (typeof v !== "object" || v === null)
+        return false;
+    const r = v;
+    if (typeof r.supervisorId !== "string" || typeof r.spawnedAt !== "string")
+        return false;
+    if (r.spawnedFrom !== undefined) {
+        const sf = r.spawnedFrom;
+        if (typeof sf.sessionId !== "string")
+            return false;
+        if (sf.mode !== "fresh" && sf.mode !== "summary")
+            return false;
+    }
+    if (r.state !== undefined && !isWorkerLifecycleState(r.state))
+        return false;
+    if (r.turnOpen !== undefined && typeof r.turnOpen !== "boolean")
+        return false;
+    for (const key of ["lastStateAt", "lastAgentStartAt", "lastAgentEndAt"]) {
+        if (r[key] !== undefined && typeof r[key] !== "string")
+            return false;
+    }
+    for (const key of ["stopReason", "errorMessage"]) {
+        if (r[key] !== undefined && r[key] !== null && typeof r[key] !== "string")
+            return false;
+    }
+    return true;
+}
+async function readStoreFile() {
+    await ensureDir();
+    try {
+        const raw = await readFile(STORE_FILE(), "utf8");
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== "object" || parsed === null)
+            return emptyStore();
+        const r = parsed;
+        const supervisors = {};
+        const workers = {};
+        if (typeof r.supervisors === "object" && r.supervisors !== null) {
+            for (const [id, rec] of Object.entries(r.supervisors)) {
+                if (isSupervisorRecord(rec))
+                    supervisors[id] = rec;
+            }
+        }
+        if (typeof r.workers === "object" && r.workers !== null) {
+            for (const [id, rec] of Object.entries(r.workers)) {
+                if (isWorkerRecord(rec))
+                    workers[id] = rec;
+            }
+        }
+        return { version: ORCHESTRATION_VERSION, supervisors, workers };
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return emptyStore();
+        throw err;
+    }
+}
+async function writeStoreFile(s) {
+    await atomicWriteJson(STORE_FILE(), s, 0o600);
+}
+export async function readStore() {
+    return readStoreFile();
+}
+export class OrchestrationError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "OrchestrationError";
+    }
+}
+export async function enableSupervisor(sessionId) {
+    return withStoreLock(async () => {
+        const s = await readStoreFile();
+        if (s.workers[sessionId] !== undefined) {
+            throw new OrchestrationError("depth_limit_exceeded", `Session ${sessionId} is a worker and cannot become a supervisor (depth=1).`);
+        }
+        const existing = s.supervisors[sessionId];
+        if (existing !== undefined)
+            return existing;
+        const rec = {
+            enabledAt: new Date().toISOString(),
+            workerIds: [],
+        };
+        s.supervisors[sessionId] = rec;
+        await writeStoreFile(s);
+        return rec;
+    });
+}
+export async function disableSupervisor(sessionId) {
+    await withStoreLock(async () => {
+        const s = await readStoreFile();
+        const rec = s.supervisors[sessionId];
+        if (rec === undefined)
+            return;
+        for (const workerId of rec.workerIds) {
+            delete s.workers[workerId];
+        }
+        delete s.supervisors[sessionId];
+        await writeStoreFile(s);
+    });
+}
+export async function registerWorker(opts) {
+    await withStoreLock(async () => {
+        const s = await readStoreFile();
+        const sup = s.supervisors[opts.supervisorId];
+        if (sup === undefined) {
+            throw new OrchestrationError("supervisor_not_found", `No supervisor record for ${opts.supervisorId}.`);
+        }
+        if (s.workers[opts.workerId] !== undefined) {
+            throw new OrchestrationError("worker_already_linked", `Worker ${opts.workerId} is already linked to a supervisor.`);
+        }
+        if (s.supervisors[opts.workerId] !== undefined) {
+            throw new OrchestrationError("depth_limit_exceeded", `Session ${opts.workerId} is already a supervisor; cannot also be a worker.`);
+        }
+        sup.workerIds.push(opts.workerId);
+        const now = new Date().toISOString();
+        const wrec = {
+            supervisorId: opts.supervisorId,
+            spawnedAt: now,
+            state: "idle",
+            turnOpen: false,
+            lastStateAt: now,
+        };
+        if (opts.spawnedFrom !== undefined)
+            wrec.spawnedFrom = opts.spawnedFrom;
+        s.workers[opts.workerId] = wrec;
+        await writeStoreFile(s);
+    });
+}
+export async function unregisterWorker(workerId) {
+    await withStoreLock(async () => {
+        const s = await readStoreFile();
+        const wrec = s.workers[workerId];
+        if (wrec === undefined)
+            return;
+        const sup = s.supervisors[wrec.supervisorId];
+        if (sup !== undefined) {
+            sup.workerIds = sup.workerIds.filter((id) => id !== workerId);
+        }
+        delete s.workers[workerId];
+        await writeStoreFile(s);
+    });
+}
+export async function getSupervisorIdForWorker(workerId) {
+    const s = await readStoreFile();
+    return s.workers[workerId]?.supervisorId;
+}
+export async function isSupervisor(sessionId) {
+    const s = await readStoreFile();
+    return s.supervisors[sessionId] !== undefined;
+}
+export async function isWorker(sessionId) {
+    const s = await readStoreFile();
+    return s.workers[sessionId] !== undefined;
+}
+export async function getWorkerIds(supervisorId) {
+    const s = await readStoreFile();
+    return [...(s.supervisors[supervisorId]?.workerIds ?? [])];
+}
+export async function getWorkerRecord(workerId) {
+    const s = await readStoreFile();
+    return s.workers[workerId];
+}
+export async function updateWorkerLifecycle(workerId, patch) {
+    return withStoreLock(async () => {
+        const s = await readStoreFile();
+        const rec = s.workers[workerId];
+        if (rec === undefined)
+            return undefined;
+        Object.assign(rec, patch);
+        await writeStoreFile(s);
+        return { ...rec };
+    });
+}
+// ---- orchestrator-inbox.json (queue) ----
+let inboxLock = Promise.resolve();
+function withInboxLock(fn) {
+    const next = inboxLock.then(fn, fn);
+    inboxLock = next.catch(() => undefined);
+    return next;
+}
+function isInboxItem(v) {
+    if (typeof v !== "object" || v === null)
+        return false;
+    const r = v;
+    return (typeof r.id === "string" &&
+        isInboxEventType(r.type) &&
+        typeof r.workerId === "string" &&
+        typeof r.occurredAt === "string" &&
+        typeof r.data === "object" &&
+        r.data !== null &&
+        typeof r.delivered === "boolean");
+}
+async function readInboxFile() {
+    await ensureDir();
+    try {
+        const raw = await readFile(INBOX_FILE(), "utf8");
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== "object" || parsed === null)
+            return emptyInboxStore();
+        const r = parsed;
+        const inboxes = {};
+        if (typeof r.inboxes === "object" && r.inboxes !== null) {
+            for (const [supId, items] of Object.entries(r.inboxes)) {
+                if (Array.isArray(items)) {
+                    inboxes[supId] = items.filter(isInboxItem);
+                }
+            }
+        }
+        return { version: ORCHESTRATION_VERSION, inboxes };
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return emptyInboxStore();
+        throw err;
+    }
+}
+async function writeInboxFile(s) {
+    await atomicWriteJson(INBOX_FILE(), s, 0o600);
+}
+export async function enqueueInboxItem(supervisorId, item) {
+    return withInboxLock(async () => {
+        const s = await readInboxFile();
+        const existing = s.inboxes[supervisorId] ?? [];
+        const { delivered = false, ...rest } = item;
+        const full = { id: randomUUID(), delivered, ...rest };
+        existing.push(full);
+        const trimmed = existing.length > MAX_INBOX_ITEMS
+            ? existing.slice(existing.length - MAX_INBOX_ITEMS)
+            : existing;
+        s.inboxes[supervisorId] = trimmed;
+        await writeInboxFile(s);
+        return full;
+    });
+}
+export async function readPendingInbox(supervisorId, opts = {}) {
+    return withInboxLock(async () => {
+        const s = await readInboxFile();
+        const items = s.inboxes[supervisorId] ?? [];
+        const pending = items.filter((it) => !it.delivered);
+        if (opts.markDelivered === true && pending.length > 0) {
+            for (const it of pending)
+                it.delivered = true;
+            s.inboxes[supervisorId] = items;
+            await writeInboxFile(s);
+        }
+        return pending.map((it) => ({ ...it }));
+    });
+}
+export async function readAllInbox(supervisorId) {
+    const s = await readInboxFile();
+    const items = s.inboxes[supervisorId] ?? [];
+    return items.slice().reverse();
+}
+export async function pendingInboxCount(supervisorId) {
+    const s = await readInboxFile();
+    const items = s.inboxes[supervisorId] ?? [];
+    return items.filter((it) => !it.delivered).length;
+}
+export async function clearInbox(supervisorId) {
+    await withInboxLock(async () => {
+        const s = await readInboxFile();
+        if (s.inboxes[supervisorId] === undefined)
+            return;
+        delete s.inboxes[supervisorId];
+        await writeInboxFile(s);
+    });
+}
+//# sourceMappingURL=store.js.map

package/dist/server/orchestration/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/orchestration/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACrF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EACL,eAAe,EACf,UAAU,EAGV,gBAAgB,EAChB,eAAe,EACf,qBAAqB,GAKtB,MAAM,YAAY,CAAC;AAEpB,MAAM,UAAU,GAAG,GAAW,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,4BAA4B,CAAC,CAAC;AACzF,MAAM,UAAU,GAAG,GAAW,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,yBAAyB,CAAC,CAAC;AAEtF,KAAK,UAAU,SAAS;IACtB,MAAM,KAAK,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,MAAc,EAAE,IAAa,EAAE,IAAY;IACxE,MAAM,SAAS,EAAE,CAAC;IAClB,MAAM,GAAG,GAAG,GAAG,MAAM,IAAI,UAAU,EAAE,MAAM,CAAC;IAC5C,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC5D,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACvB,MAAM,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,kDAAkD;AAElD,IAAI,SAAS,GAAqB,OAAO,CAAC,OAAO,EAAE,CAAC;AACpD,SAAS,aAAa,CAAI,EAAoB;IAC5C,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACpC,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACxC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,kBAAkB,CAAC,CAAU;IACpC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,CAAC,GAAG,CAA4B,CAAC;IACvC,OAAO,CACL,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ;QAC/B,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1B,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,KAAK,QAAQ,CAAC,CAClD,CAAC;AACJ,CAAC;AAED,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAuB;IAC5D,MAAM;IACN,SAAS;IACT,OAAO;IACP,SAAS;IACT,SAAS;IACT,SAAS;IACT,mBAAmB;CACpB,CAAC,CAAC;AAEH,SAAS,sBAAsB,CAAC,CAAU;IACxC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,uBAAuB,CAAC,GAAG,CAAC,CAAyB,CAAC,CAAC;AACzF,CAAC;AAED,SAAS,cAAc,CAAC,CAAU;IAChC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,CAAC,GAAG,CAA4B,CAAC;IACvC,IAAI,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACxF,IAAI,CAAC,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,EAAE,GAAG,CAAC,CAAC,WAAsC,CAAC;QACpD,IAAI,OAAO,EAAE,CAAC,SAAS,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACnD,IAAI,EAAE,CAAC,IAAI,KAAK,OAAO,IAAI,EAAE,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;IACjE,CAAC;IACD,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,sBAAsB,CAAC,CAAC,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5E,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC9E,KAAK,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,kBAAkB,EAAE,gBAAgB,CAAU,EAAE,CAAC;QACjF,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;IACvE,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,CAAC,YAAY,EAAE,cAAc,CAAU,EAAE,CAAC;QAC1D,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;IAC1F,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,KAAK,UAAU,aAAa;IAC1B,MAAM,SAAS,EAAE,CAAC;IAClB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,EAAE,MAAM,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;QAC1C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,UAAU,EAAE,CAAC;QACvE,MAAM,CAAC,GAAG,MAAiC,CAAC;QAC5C,MAAM,WAAW,GAAqC,EAAE,CAAC;QACzD,MAAM,OAAO,GAAiC,EAAE,CAAC;QACjD,IAAI,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;YAChE,KAAK,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,WAAsC,CAAC,EAAE,CAAC;gBACjF,IAAI,kBAAkB,CAAC,GAAG,CAAC;oBAAE,WAAW,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;YACrD,CAAC;QACH,CAAC;QACD,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YACxD,KAAK,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAkC,CAAC,EAAE,CAAC;gBAC7E,IAAI,cAAc,CAAC,GAAG,CAAC;oBAAE,OAAO,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;YAC7C,CAAC;QACH,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;IAClE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,UAAU,EAAE,CAAC;QAC1E,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,CAAqB;IACjD,MAAM,eAAe,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,OAAO,aAAa,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,IAAI,CAAS;IACtB,YAAY,IAAY,EAAE,OAAe;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,SAAiB;IACtD,OAAO,aAAa,CAAC,KAAK,IAAI,EAAE;QAC9B,MAAM,CAAC,GAAG,MAAM,aAAa,EAAE,CAAC;QAChC,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,SAAS,EAAE,CAAC;YACvC,MAAM,IAAI,kBAAkB,CAC1B,sBAAsB,EACtB,WAAW,SAAS,wDAAwD,CAC7E,CAAC;QACJ,CAAC;QACD,MAAM,QAAQ,GAAG,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,QAAQ,CAAC;QAC5C,MAAM,GAAG,GAAqB;YAC5B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,SAAS,EAAE,EAAE;SACd,CAAC;QACF,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC;QAC/B,MAAM,cAAc,CAAC,CAAC,CAAC,CAAC;QACxB,OAAO,GAAG,CAAC;IACb,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,SAAiB;IACvD,MAAM,aAAa,CAAC,KAAK,IAAI,EAAE;QAC7B,MAAM,CAAC,GAAG,MAAM,aAAa,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO;QAC9B,KAAK,MAAM,QAAQ,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;YACrC,OAAO,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAChC,MAAM,cAAc,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAIpC;IACC,MAAM,aAAa,CAAC,KAAK,IAAI,EAAE;QAC7B,MAAM,CAAC,GAAG,MAAM,aAAa,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC7C,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,MAAM,IAAI,kBAAkB,CAC1B,sBAAsB,EACtB,4BAA4B,IAAI,CAAC,YAAY,GAAG,CACjD,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,SAAS,EAAE,CAAC;YAC3C,MAAM,IAAI,kBAAkB,CAC1B,uBAAuB,EACvB,UAAU,IAAI,CAAC,QAAQ,qCAAqC,CAC7D,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,SAAS,EAAE,CAAC;YAC/C,MAAM,IAAI,kBAAkB,CAC1B,sBAAsB,EACtB,WAAW,IAAI,CAAC,QAAQ,oDAAoD,CAC7E,CAAC;QACJ,CAAC;QACD,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,IAAI,GAAiB;YACzB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,SAAS,EAAE,GAAG;YACd,KAAK,EAAE,MAAM;YACb,QAAQ,EAAE,KAAK;YACf,WAAW,EAAE,GAAG;SACjB,CAAC;QACF,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;YAAE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACxE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;QAChC,MAAM,cAAc,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,QAAgB;IACrD,MAAM,aAAa,CAAC,KAAK,IAAI,EAAE;QAC7B,MAAM,CAAC,GAAG,MAAM,aAAa,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACjC,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO;QAC/B,MAAM,GAAG,GAAG,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC7C,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,GAAG,CAAC,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC3B,MAAM,cAAc,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,QAAgB;IAC7D,MAAM,CAAC,GAAG,MAAM,aAAa,EAAE,CAAC;IAChC,OAAO,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,SAAiB;IAClD,MAAM,CAAC,GAAG,MAAM,aAAa,EAAE,CAAC;IAChC,OAAO,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,KAAK,SAAS,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,SAAiB;IAC9C,MAAM,CAAC,GAAG,MAAM,aAAa,EAAE,CAAC;IAChC,OAAO,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,SAAS,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,YAAoB;IACrD,MAAM,CAAC,GAAG,MAAM,aAAa,EAAE,CAAC;IAChC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,YAAY,CAAC,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB;IACpD,MAAM,CAAC,GAAG,MAAM,aAAa,EAAE,CAAC;IAChC,OAAO,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,QAAgB,EAChB,KAWC;IAED,OAAO,aAAa,CAAC,KAAK,IAAI,EAAE;QAC9B,MAAM,CAAC,GAAG,MAAM,aAAa,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAChC,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC1B,MAAM,cAAc,CAAC,CAAC,CAAC,CAAC;QACxB,OAAO,EAAE,GAAG,GAAG,EAAE,CAAC;IACpB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,4CAA4C;AAE5C,IAAI,SAAS,GAAqB,OAAO,CAAC,OAAO,EAAE,CAAC;AACpD,SAAS,aAAa,CAAI,EAAoB;IAC5C,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACpC,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACxC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,WAAW,CAAC,CAAU;IAC7B,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,CAAC,GAAG,CAA4B,CAAC;IACvC,OAAO,CACL,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ;QACxB,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC;QACxB,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ;QAC9B,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ;QAChC,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;QAC1B,CAAC,CAAC,IAAI,KAAK,IAAI;QACf,OAAO,CAAC,CAAC,SAAS,KAAK,SAAS,CACjC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,aAAa;IAC1B,MAAM,SAAS,EAAE,CAAC;IAClB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,EAAE,MAAM,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;QAC1C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,eAAe,EAAE,CAAC;QAC5E,MAAM,CAAC,GAAG,MAAiC,CAAC;QAC5C,MAAM,OAAO,GAAgC,EAAE,CAAC;QAChD,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YACxD,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAkC,CAAC,EAAE,CAAC;gBAClF,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;oBACzB,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;gBAC7C,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,CAAC;IACrD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,eAAe,EAAE,CAAC;QAC/E,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,CAAa;IACzC,MAAM,eAAe,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,YAAoB,EACpB,IAAmE;IAEnE,OAAO,aAAa,CAAC,KAAK,IAAI,EAAE;QAC9B,MAAM,CAAC,GAAG,MAAM,aAAa,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QAC/C,MAAM,EAAE,SAAS,GAAG,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;QAC5C,MAAM,IAAI,GAAc,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,CAAC;QACjE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,MAAM,OAAO,GACX,QAAQ,CAAC,MAAM,GAAG,eAAe;YAC/B,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,eAAe,CAAC;YACnD,CAAC,CAAC,QAAQ,CAAC;QACf,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC;QAClC,MAAM,cAAc,CAAC,CAAC,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,YAAoB,EACpB,IAAI,GAAgC,EAAE;IAEtC,OAAO,aAAa,CAAC,KAAK,IAAI,EAAE;QAC9B,MAAM,CAAC,GAAG,MAAM,aAAa,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QAC5C,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;QACpD,IAAI,IAAI,CAAC,aAAa,KAAK,IAAI,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtD,KAAK,MAAM,EAAE,IAAI,OAAO;gBAAE,EAAE,CAAC,SAAS,GAAG,IAAI,CAAC;YAC9C,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC;YAChC,MAAM,cAAc,CAAC,CAAC,CAAC,CAAC;QAC1B,CAAC;QACD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,YAAoB;IACrD,MAAM,CAAC,GAAG,MAAM,aAAa,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;IAC5C,OAAO,KAAK,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,YAAoB;IAC1D,MAAM,CAAC,GAAG,MAAM,aAAa,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;IAC5C,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,YAAoB;IACnD,MAAM,aAAa,CAAC,KAAK,IAAI,EAAE;QAC7B,MAAM,CAAC,GAAG,MAAM,aAAa,EAAE,CAAC;QAChC,IAAI,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,SAAS;YAAE,OAAO;QAClD,OAAO,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAC/B,MAAM,cAAc,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/server/orchestration/tools.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Agent-facing tool surface for supervisor sessions.
+ *
+ * Seven `orchestrate_*` tools, registered onto a session ONLY when
+ * that session has supervisor mode enabled. Wired through
+ * `createAgentSession({ customTools })` in session-store.
+ *
+ * Topology is hub-and-spoke by tool surface: workers don't get
+ * these tools. Same-project enforcement: spawn_worker creates in
+ * the supervisor's project.
+ */
+import type { ToolDefinition } from "@earendil-works/pi-coding-agent";
+export declare function createOrchestrationTools(supervisorId: string): ToolDefinition[];
+export declare const ORCHESTRATION_TOOL_NAMES: readonly ["orchestrate_spawn_worker", "orchestrate_list_workers", "orchestrate_read_worker", "orchestrate_send_to_worker", "orchestrate_interrupt_worker", "orchestrate_kill_worker", "orchestrate_detach_worker", "orchestrate_read_inbox"];
+//# sourceMappingURL=tools.d.ts.map

package/dist/server/orchestration/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/orchestration/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AA4tBtE,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,EAAE,CAW/E;AAED,eAAO,MAAM,wBAAwB,YACnC,0BAA0B,EAC1B,0BAA0B,EAC1B,yBAAyB,EACzB,4BAA4B,EAC5B,8BAA8B,EAC9B,yBAAyB,EACzB,2BAA2B,EAC3B,wBAAwB,CAChB,CAAC"}