daycare-cli 0.0.1

package/dist/engine/agents/ops/agentHistoryLoad.js

@@ -0,0 +1,144 @@
+import { createReadStream, promises as fs } from "node:fs";
+import path from "node:path";
+import { createInterface } from "node:readline";
+import { z } from "zod";
+import { agentPathBuild } from "./agentPathBuild.js";
+const fileReferenceSchema = z
+    .object({
+    id: z.string().min(1),
+    name: z.string().min(1),
+    mimeType: z.string().min(1),
+    size: z.number(),
+    path: z.string().min(1)
+})
+    .strict();
+const toolExecutionResultSchema = z
+    .object({
+    toolMessage: z.unknown(),
+    files: z.array(fileReferenceSchema)
+})
+    .strict();
+const tokenSizeSchema = z
+    .object({
+    input: z.number().int().nonnegative(),
+    output: z.number().int().nonnegative(),
+    cacheRead: z.number().int().nonnegative(),
+    cacheWrite: z.number().int().nonnegative(),
+    total: z.number().int().nonnegative()
+})
+    .strict();
+const tokenSnapshotSizeSchema = tokenSizeSchema;
+const tokenEntrySchema = z
+    .object({
+    provider: z.string().min(1),
+    model: z.string().min(1),
+    size: tokenSnapshotSizeSchema
+})
+    .strict()
+    .nullable();
+const historyRecordSchema = z.discriminatedUnion("type", [
+    z
+        .object({
+        type: z.literal("start"),
+        at: z.number().int()
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal("reset"),
+        at: z.number().int(),
+        message: z.string().optional()
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal("user_message"),
+        at: z.number().int(),
+        text: z.string(),
+        files: z.array(fileReferenceSchema)
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal("assistant_message"),
+        at: z.number().int(),
+        text: z.string(),
+        files: z.array(fileReferenceSchema),
+        toolCalls: z.array(z.unknown()),
+        tokens: tokenEntrySchema
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal("tool_result"),
+        at: z.number().int(),
+        toolCallId: z.string().min(1),
+        output: toolExecutionResultSchema
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal("note"),
+        at: z.number().int(),
+        text: z.string()
+    })
+        .strict()
+]);
+/**
+ * Loads history records after the most recent start/reset marker.
+ * Expects: history.jsonl is newline-delimited JSON.
+ */
+export async function agentHistoryLoad(config, agentId) {
+    const basePath = agentPathBuild(config, agentId);
+    const filePath = path.join(basePath, "history.jsonl");
+    try {
+        await fs.access(filePath);
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return [];
+        }
+        throw error;
+    }
+    const records = [];
+    const reader = createInterface({
+        input: createReadStream(filePath, { encoding: "utf8" }),
+        crlfDelay: Infinity
+    });
+    for await (const line of reader) {
+        const trimmed = line.trim();
+        if (!trimmed) {
+            continue;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(trimmed);
+        }
+        catch {
+            continue;
+        }
+        const result = historyRecordSchema.safeParse(parsed);
+        if (result.success) {
+            records.push(result.data);
+        }
+    }
+    if (records.length === 0) {
+        return [];
+    }
+    const lastMarkerIndex = records.reduce((acc, record, index) => {
+        if (record.type === "start" || record.type === "reset") {
+            return index;
+        }
+        return acc;
+    }, -1);
+    if (lastMarkerIndex < 0) {
+        return records;
+    }
+    const tail = records.slice(lastMarkerIndex + 1);
+    const marker = records[lastMarkerIndex];
+    if (marker?.type === "reset" && marker.message && marker.message.trim().length > 0) {
+        return [marker, ...tail];
+    }
+    return tail;
+}
+//# sourceMappingURL=agentHistoryLoad.js.map

package/dist/engine/agents/ops/agentHistoryLoad.js.map

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

package/dist/engine/agents/ops/agentHistoryLoad.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agentHistoryLoad.spec.d.ts.map

package/dist/engine/agents/ops/agentHistoryLoad.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentHistoryLoad.spec.d.ts","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentHistoryLoad.spec.ts"],"names":[],"mappings":""}

package/dist/engine/agents/ops/agentHistoryLoad.spec.js

@@ -0,0 +1,29 @@
+import { mkdtemp, rm } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { describe, expect, it } from "vitest";
+import { createId } from "@paralleldrive/cuid2";
+import { agentHistoryAppend } from "./agentHistoryAppend.js";
+import { agentHistoryLoad } from "./agentHistoryLoad.js";
+import { configResolve } from "../../../config/configResolve.js";
+const buildRecord = (record) => record;
+describe("agentHistoryLoad", () => {
+    it("returns records after the most recent start/reset marker", async () => {
+        const dir = await mkdtemp(path.join(os.tmpdir(), "daycare-agent-history-"));
+        const agentId = createId();
+        try {
+            const config = configResolve({ engine: { dataDir: dir }, assistant: { workspaceDir: dir } }, path.join(dir, "settings.json"));
+            await agentHistoryAppend(config, agentId, buildRecord({ type: "start", at: 1 }));
+            await agentHistoryAppend(config, agentId, buildRecord({ type: "user_message", at: 2, text: "hi", files: [] }));
+            await agentHistoryAppend(config, agentId, buildRecord({ type: "reset", at: 3 }));
+            await agentHistoryAppend(config, agentId, buildRecord({ type: "user_message", at: 4, text: "fresh", files: [] }));
+            const records = await agentHistoryLoad(config, agentId);
+            expect(records).toHaveLength(1);
+            expect(records[0]).toEqual({ type: "user_message", at: 4, text: "fresh", files: [] });
+        }
+        finally {
+            await rm(dir, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=agentHistoryLoad.spec.js.map

package/dist/engine/agents/ops/agentHistoryLoad.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentHistoryLoad.spec.js","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentHistoryLoad.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAGjE,MAAM,WAAW,GAAG,CAAC,MAA0B,EAAE,EAAE,CAAC,MAAM,CAAC;AAE3D,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,wBAAwB,CAAC,CAAC,CAAC;QAC5E,MAAM,OAAO,GAAG,QAAQ,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,aAAa,CAC1B,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,EAAE,EAC9D,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAChC,CAAC;YAEF,MAAM,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YACjF,MAAM,kBAAkB,CACtB,MAAM,EACN,OAAO,EACP,WAAW,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CACpE,CAAC;YACF,MAAM,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YACjF,MAAM,kBAAkB,CACtB,MAAM,EACN,OAAO,EACP,WAAW,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CACvE,CAAC;YAEF,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACxD,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAChC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QACxF,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/engine/agents/ops/agentHistorySummaryBuild.d.ts

@@ -0,0 +1,20 @@
+import type { AgentHistoryRecord } from "@/types";
+type AgentHistoryRecordType = AgentHistoryRecord["type"];
+type AgentHistorySummaryCounts = Record<AgentHistoryRecordType, number>;
+type AgentHistorySummary = {
+    recordCount: number;
+    firstAt: number | null;
+    lastAt: number | null;
+    counts: AgentHistorySummaryCounts;
+    lastUserMessage: string | null;
+    lastAssistantMessage: string | null;
+    lastNote: string | null;
+    lastToolName: string | null;
+};
+/**
+ * Builds compact summary metadata from agent history records.
+ * Expects: records are in chronological order from oldest to newest.
+ */
+export declare function agentHistorySummaryBuild(records: AgentHistoryRecord[]): AgentHistorySummary;
+export {};
+//# sourceMappingURL=agentHistorySummaryBuild.d.ts.map

package/dist/engine/agents/ops/agentHistorySummaryBuild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentHistorySummaryBuild.d.ts","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentHistorySummaryBuild.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,KAAK,sBAAsB,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;AACzD,KAAK,yBAAyB,GAAG,MAAM,CAAC,sBAAsB,EAAE,MAAM,CAAC,CAAC;AAExE,KAAK,mBAAmB,GAAG;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,yBAAyB,CAAC;IAClC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,mBAAmB,CA4C3F"}

package/dist/engine/agents/ops/agentHistorySummaryBuild.js

@@ -0,0 +1,57 @@
+/**
+ * Builds compact summary metadata from agent history records.
+ * Expects: records are in chronological order from oldest to newest.
+ */
+export function agentHistorySummaryBuild(records) {
+    const counts = buildEmptyCounts();
+    let firstAt = null;
+    let lastAt = null;
+    let lastUserMessage = null;
+    let lastAssistantMessage = null;
+    let lastNote = null;
+    let lastToolName = null;
+    for (const record of records) {
+        counts[record.type] += 1;
+        firstAt = firstAt === null ? record.at : Math.min(firstAt, record.at);
+        lastAt = lastAt === null ? record.at : Math.max(lastAt, record.at);
+        if (record.type === "user_message") {
+            lastUserMessage = record.text;
+            continue;
+        }
+        if (record.type === "assistant_message") {
+            lastAssistantMessage = record.text;
+            continue;
+        }
+        if (record.type === "note") {
+            lastNote = record.text;
+            continue;
+        }
+        if (record.type === "tool_result") {
+            const toolName = record.output.toolMessage.toolName;
+            if (typeof toolName === "string" && toolName.trim().length > 0) {
+                lastToolName = toolName;
+            }
+        }
+    }
+    return {
+        recordCount: records.length,
+        firstAt,
+        lastAt,
+        counts,
+        lastUserMessage,
+        lastAssistantMessage,
+        lastNote,
+        lastToolName
+    };
+}
+function buildEmptyCounts() {
+    return {
+        start: 0,
+        reset: 0,
+        user_message: 0,
+        assistant_message: 0,
+        tool_result: 0,
+        note: 0
+    };
+}
+//# sourceMappingURL=agentHistorySummaryBuild.js.map

package/dist/engine/agents/ops/agentHistorySummaryBuild.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentHistorySummaryBuild.js","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentHistorySummaryBuild.ts"],"names":[],"mappings":"AAgBA;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAA6B;IACpE,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAClC,IAAI,OAAO,GAAkB,IAAI,CAAC;IAClC,IAAI,MAAM,GAAkB,IAAI,CAAC;IACjC,IAAI,eAAe,GAAkB,IAAI,CAAC;IAC1C,IAAI,oBAAoB,GAAkB,IAAI,CAAC;IAC/C,IAAI,QAAQ,GAAkB,IAAI,CAAC;IACnC,IAAI,YAAY,GAAkB,IAAI,CAAC;IAEvC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzB,OAAO,GAAG,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QACtE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAEnE,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YACnC,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC;YAC9B,SAAS;QACX,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;YACxC,oBAAoB,GAAG,MAAM,CAAC,IAAI,CAAC;YACnC,SAAS;QACX,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC3B,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC;YACvB,SAAS;QACX,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YAClC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC;YACpD,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/D,YAAY,GAAG,QAAQ,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,WAAW,EAAE,OAAO,CAAC,MAAM;QAC3B,OAAO;QACP,MAAM;QACN,MAAM;QACN,eAAe;QACf,oBAAoB;QACpB,QAAQ;QACR,YAAY;KACb,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB;IACvB,OAAO;QACL,KAAK,EAAE,CAAC;QACR,KAAK,EAAE,CAAC;QACR,YAAY,EAAE,CAAC;QACf,iBAAiB,EAAE,CAAC;QACpB,WAAW,EAAE,CAAC;QACd,IAAI,EAAE,CAAC;KACR,CAAC;AACJ,CAAC"}

package/dist/engine/agents/ops/agentHistorySummaryBuild.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agentHistorySummaryBuild.spec.d.ts.map

package/dist/engine/agents/ops/agentHistorySummaryBuild.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentHistorySummaryBuild.spec.d.ts","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentHistorySummaryBuild.spec.ts"],"names":[],"mappings":""}

package/dist/engine/agents/ops/agentHistorySummaryBuild.spec.js

@@ -0,0 +1,69 @@
+import { describe, expect, it } from "vitest";
+import { agentHistorySummaryBuild } from "./agentHistorySummaryBuild.js";
+function buildRecord(record) {
+    return record;
+}
+describe("agentHistorySummaryBuild", () => {
+    it("returns zeroed summary for empty history", () => {
+        const summary = agentHistorySummaryBuild([]);
+        expect(summary.recordCount).toBe(0);
+        expect(summary.firstAt).toBeNull();
+        expect(summary.lastAt).toBeNull();
+        expect(summary.counts).toEqual({
+            start: 0,
+            reset: 0,
+            user_message: 0,
+            assistant_message: 0,
+            tool_result: 0,
+            note: 0
+        });
+    });
+    it("tracks counts, time range, and latest text snapshots", () => {
+        const records = [
+            buildRecord({ type: "start", at: 100 }),
+            buildRecord({ type: "user_message", at: 110, text: "hi", files: [] }),
+            buildRecord({
+                type: "assistant_message",
+                at: 120,
+                text: "hello",
+                files: [],
+                toolCalls: [],
+                tokens: null
+            }),
+            buildRecord({
+                type: "tool_result",
+                at: 130,
+                toolCallId: "tool-1",
+                output: {
+                    toolMessage: {
+                        role: "toolResult",
+                        toolCallId: "tool-1",
+                        toolName: "send_agent_message",
+                        content: [{ type: "text", text: "sent" }],
+                        isError: false,
+                        timestamp: 130
+                    },
+                    files: []
+                }
+            }),
+            buildRecord({ type: "note", at: 140, text: "done" })
+        ];
+        const summary = agentHistorySummaryBuild(records);
+        expect(summary.recordCount).toBe(5);
+        expect(summary.firstAt).toBe(100);
+        expect(summary.lastAt).toBe(140);
+        expect(summary.counts).toEqual({
+            start: 1,
+            reset: 0,
+            user_message: 1,
+            assistant_message: 1,
+            tool_result: 1,
+            note: 1
+        });
+        expect(summary.lastUserMessage).toBe("hi");
+        expect(summary.lastAssistantMessage).toBe("hello");
+        expect(summary.lastNote).toBe("done");
+        expect(summary.lastToolName).toBe("send_agent_message");
+    });
+});
+//# sourceMappingURL=agentHistorySummaryBuild.spec.js.map

package/dist/engine/agents/ops/agentHistorySummaryBuild.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentHistorySummaryBuild.spec.js","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentHistorySummaryBuild.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAGzE,SAAS,WAAW,CAAC,MAA0B;IAC7C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,OAAO,GAAG,wBAAwB,CAAC,EAAE,CAAC,CAAC;QAE7C,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;QACnC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;QAClC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YAC7B,KAAK,EAAE,CAAC;YACR,KAAK,EAAE,CAAC;YACR,YAAY,EAAE,CAAC;YACf,iBAAiB,EAAE,CAAC;YACpB,WAAW,EAAE,CAAC;YACd,IAAI,EAAE,CAAC;SACR,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,OAAO,GAAyB;YACpC,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC;YACvC,WAAW,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;YACrE,WAAW,CAAC;gBACV,IAAI,EAAE,mBAAmB;gBACzB,EAAE,EAAE,GAAG;gBACP,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE;gBACT,SAAS,EAAE,EAAE;gBACb,MAAM,EAAE,IAAI;aACb,CAAC;YACF,WAAW,CAAC;gBACV,IAAI,EAAE,aAAa;gBACnB,EAAE,EAAE,GAAG;gBACP,UAAU,EAAE,QAAQ;gBACpB,MAAM,EAAE;oBACN,WAAW,EAAE;wBACX,IAAI,EAAE,YAAY;wBAClB,UAAU,EAAE,QAAQ;wBACpB,QAAQ,EAAE,oBAAoB;wBAC9B,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;wBACzC,OAAO,EAAE,KAAK;wBACd,SAAS,EAAE,GAAG;qBACf;oBACD,KAAK,EAAE,EAAE;iBACV;aACF,CAAC;YACF,WAAW,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;SACrD,CAAC;QAEF,MAAM,OAAO,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;QAElD,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YAC7B,KAAK,EAAE,CAAC;YACR,KAAK,EAAE,CAAC;YACR,YAAY,EAAE,CAAC;YACf,iBAAiB,EAAE,CAAC;YACpB,WAAW,EAAE,CAAC;YACd,IAAI,EAAE,CAAC;SACR,CAAC,CAAC;QACH,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnD,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/engine/agents/ops/agentInbox.d.ts

@@ -0,0 +1,20 @@
+import type { AgentInboxCompletion, AgentInboxEntry, AgentInboxItem } from "./agentTypes.js";
+/**
+ * AgentInbox is a single-consumer queue for agent work items.
+ * Expects: only one agent attaches to an inbox at a time.
+ */
+export declare class AgentInbox {
+    readonly agentId: string;
+    private items;
+    private waiters;
+    private attached;
+    constructor(agentId: string);
+    attach(): void;
+    detach(): void;
+    post(item: AgentInboxItem, completion?: AgentInboxCompletion | null): AgentInboxEntry;
+    private mergePendingMessage;
+    next(): Promise<AgentInboxEntry>;
+    size(): number;
+    listPending(): AgentInboxEntry[];
+}
+//# sourceMappingURL=agentInbox.d.ts.map

package/dist/engine/agents/ops/agentInbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentInbox.d.ts","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentInbox.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,oBAAoB,EACpB,eAAe,EACf,cAAc,EAEf,MAAM,iBAAiB,CAAC;AAEzB;;;GAGG;AACH,qBAAa,UAAU;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,OAAO,CAA+C;IAC9D,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE,MAAM;IAI3B,MAAM,IAAI,IAAI;IAOd,MAAM,IAAI,IAAI;IAId,IAAI,CACF,IAAI,EAAE,cAAc,EACpB,UAAU,GAAE,oBAAoB,GAAG,IAAW,GAC7C,eAAe;IAsBlB,OAAO,CAAC,mBAAmB;IAarB,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC;IAUtC,IAAI,IAAI,MAAM;IAId,WAAW,IAAI,eAAe,EAAE;CAGjC"}

package/dist/engine/agents/ops/agentInbox.js

@@ -0,0 +1,128 @@
+import { createId } from "@paralleldrive/cuid2";
+/**
+ * AgentInbox is a single-consumer queue for agent work items.
+ * Expects: only one agent attaches to an inbox at a time.
+ */
+export class AgentInbox {
+    agentId;
+    items = [];
+    waiters = [];
+    attached = false;
+    constructor(agentId) {
+        this.agentId = agentId;
+    }
+    attach() {
+        if (this.attached) {
+            throw new Error(`AgentInbox already attached: ${this.agentId}`);
+        }
+        this.attached = true;
+    }
+    detach() {
+        this.attached = false;
+    }
+    post(item, completion = null) {
+        if (item.type === "message") {
+            const merged = this.mergePendingMessage(item, completion);
+            if (merged) {
+                return merged;
+            }
+        }
+        const entry = {
+            id: createId(),
+            postedAt: Date.now(),
+            item,
+            completion
+        };
+        const waiter = this.waiters.shift();
+        if (waiter) {
+            waiter(entry);
+            return entry;
+        }
+        this.items.push(entry);
+        return entry;
+    }
+    mergePendingMessage(item, completion) {
+        const lastEntry = this.items[this.items.length - 1];
+        if (!lastEntry || lastEntry.item.type !== "message") {
+            return null;
+        }
+        lastEntry.item = messageItemMerge(lastEntry.item, item);
+        lastEntry.completion = completionMerge(lastEntry.completion, completion);
+        return lastEntry;
+    }
+    async next() {
+        const next = this.items.shift();
+        if (next) {
+            return next;
+        }
+        return new Promise((resolve) => {
+            this.waiters.push(resolve);
+        });
+    }
+    size() {
+        return this.items.length;
+    }
+    listPending() {
+        return [...this.items];
+    }
+}
+function messageItemMerge(left, right) {
+    const files = [...(left.message.files ?? []), ...(right.message.files ?? [])];
+    const rawText = textMerge(left.message.rawText ?? left.message.text, right.message.rawText ?? right.message.text);
+    return {
+        type: "message",
+        message: {
+            text: textMerge(left.message.text, right.message.text),
+            ...(rawText !== null ? { rawText } : {}),
+            ...(files.length > 0 ? { files } : {}),
+            ...(right.message.replyToMessageId ?? left.message.replyToMessageId
+                ? { replyToMessageId: right.message.replyToMessageId ?? left.message.replyToMessageId }
+                : {})
+        },
+        context: messageContextMerge(left.context, right.context)
+    };
+}
+function messageContextMerge(left, right) {
+    const permissionTags = permissionTagsMerge(left.permissionTags, right.permissionTags);
+    const messageId = right.messageId ?? left.messageId;
+    return {
+        ...(messageId ? { messageId } : {}),
+        ...(permissionTags.length > 0 ? { permissionTags } : {})
+    };
+}
+function permissionTagsMerge(left, right) {
+    const deduped = new Set();
+    for (const tag of left ?? []) {
+        deduped.add(tag);
+    }
+    for (const tag of right ?? []) {
+        deduped.add(tag);
+    }
+    return Array.from(deduped);
+}
+function completionMerge(left, right) {
+    if (!left) {
+        return right;
+    }
+    if (!right) {
+        return left;
+    }
+    return {
+        resolve: (result) => {
+            left.resolve(result);
+            right.resolve(result);
+        },
+        reject: (error) => {
+            left.reject(error);
+            right.reject(error);
+        }
+    };
+}
+function textMerge(left, right) {
+    const parts = [left, right].filter((value) => value !== null && value !== undefined);
+    if (parts.length === 0) {
+        return null;
+    }
+    return parts.join("\n");
+}
+//# sourceMappingURL=agentInbox.js.map

package/dist/engine/agents/ops/agentInbox.js.map

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

package/dist/engine/agents/ops/agentInbox.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agentInbox.spec.d.ts.map

package/dist/engine/agents/ops/agentInbox.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentInbox.spec.d.ts","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentInbox.spec.ts"],"names":[],"mappings":""}

package/dist/engine/agents/ops/agentInbox.spec.js

@@ -0,0 +1,74 @@
+import { describe, expect, it, vi } from "vitest";
+import { AgentInbox } from "./agentInbox.js";
+const buildReset = () => ({ type: "reset" });
+const buildMessage = (text, messageId, tags = []) => ({
+    type: "message",
+    message: { text },
+    context: {
+        messageId,
+        ...(tags.length > 0 ? { permissionTags: tags } : {})
+    }
+});
+describe("AgentInbox", () => {
+    it("delivers queued entries in order", async () => {
+        const inbox = new AgentInbox("agent-1");
+        const first = inbox.post(buildReset());
+        const second = inbox.post(buildReset());
+        const entry1 = await inbox.next();
+        const entry2 = await inbox.next();
+        expect(entry1.id).toBe(first.id);
+        expect(entry2.id).toBe(second.id);
+    });
+    it("awaits until an entry is posted", async () => {
+        const inbox = new AgentInbox("agent-2");
+        const pending = inbox.next();
+        const posted = inbox.post(buildReset());
+        const entry = await pending;
+        expect(entry.id).toBe(posted.id);
+    });
+    it("allows reattach after detach", () => {
+        const inbox = new AgentInbox("agent-3");
+        inbox.attach();
+        inbox.detach();
+        expect(() => inbox.attach()).not.toThrow();
+    });
+    it("combines queued message items into one inbox entry", async () => {
+        const inbox = new AgentInbox("agent-4");
+        inbox.post(buildMessage("first", "1", ["@read:/tmp"]));
+        const second = inbox.post(buildMessage("second", "2", ["@write:/tmp", "@read:/tmp"]));
+        expect(inbox.size()).toBe(1);
+        const entry = await inbox.next();
+        expect(entry.id).toBe(second.id);
+        expect(entry.item.type).toBe("message");
+        if (entry.item.type !== "message") {
+            throw new Error("Expected merged message entry");
+        }
+        expect(entry.item.message.text).toBe("first\nsecond");
+        expect(entry.item.context).toEqual({
+            messageId: "2",
+            permissionTags: ["@read:/tmp", "@write:/tmp"]
+        });
+    });
+    it("resolves completion handlers for all merged messages", async () => {
+        const inbox = new AgentInbox("agent-5");
+        const resolveFirst = vi.fn();
+        const resolveSecond = vi.fn();
+        const rejectFirst = vi.fn();
+        const rejectSecond = vi.fn();
+        inbox.post(buildMessage("one", "1"), {
+            resolve: resolveFirst,
+            reject: rejectFirst
+        });
+        inbox.post(buildMessage("two", "2"), {
+            resolve: resolveSecond,
+            reject: rejectSecond
+        });
+        const entry = await inbox.next();
+        entry.completion?.resolve({ type: "message", responseText: "ok" });
+        expect(resolveFirst).toHaveBeenCalledWith({ type: "message", responseText: "ok" });
+        expect(resolveSecond).toHaveBeenCalledWith({ type: "message", responseText: "ok" });
+        expect(rejectFirst).not.toHaveBeenCalled();
+        expect(rejectSecond).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=agentInbox.spec.js.map

package/dist/engine/agents/ops/agentInbox.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentInbox.spec.js","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentInbox.spec.ts"],"names":[],"mappings":"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"}

package/dist/engine/agents/ops/agentList.d.ts

@@ -0,0 +1,14 @@
+import type { Config } from "@/types";
+import type { AgentDescriptor } from "./agentDescriptorTypes.js";
+import type { AgentLifecycleState } from "./agentTypes.js";
+/**
+ * Lists persisted agents with descriptors and last-updated timestamps.
+ * Expects: agentsDir may be missing when no agents have been created yet.
+ */
+export declare function agentList(config: Config): Promise<Array<{
+    agentId: string;
+    descriptor: AgentDescriptor;
+    lifecycle: AgentLifecycleState;
+    updatedAt: number;
+}>>;
+//# sourceMappingURL=agentList.d.ts.map

package/dist/engine/agents/ops/agentList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentList.d.ts","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/agentList.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAI3D;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,eAAe,CAAC;IAAC,SAAS,EAAE,mBAAmB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CA+BrH"}