daycare-cli 0.0.0-canary.08d0b9e

package/dist/engine/modules/tools/send-file.js.map

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

package/dist/engine/modules/tools/sendUserMessageTool.d.ts

@@ -0,0 +1,8 @@
+import type { ToolDefinition } from "@/types";
+/**
+ * Builds the send_user_message tool for background agents.
+ * Posts a <message_for_user> system message to the foreground agent,
+ * forcing it to present the content to the user.
+ */
+export declare function sendUserMessageToolBuild(): ToolDefinition;
+//# sourceMappingURL=sendUserMessageTool.d.ts.map

package/dist/engine/modules/tools/sendUserMessageTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendUserMessageTool.d.ts","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/sendUserMessageTool.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAsB,MAAM,SAAS,CAAC;AA4BlE;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,cAAc,CAuDzD"}

package/dist/engine/modules/tools/sendUserMessageTool.js

@@ -0,0 +1,67 @@
+import { Type } from "@sinclair/typebox";
+import { messageBuildUserFacing } from "../../messages/messageBuildUserFacing.js";
+const schema = Type.Object({
+    text: Type.String({ minLength: 1 })
+}, { additionalProperties: false });
+const sendUserMessageResultSchema = Type.Object({
+    summary: Type.String(),
+    targetAgentId: Type.String(),
+    originAgentId: Type.String()
+}, { additionalProperties: false });
+const sendUserMessageReturns = {
+    schema: sendUserMessageResultSchema,
+    toLLMText: (result) => result.summary
+};
+/**
+ * Builds the send_user_message tool for background agents.
+ * Posts a <message_for_user> system message to the foreground agent,
+ * forcing it to present the content to the user.
+ */
+export function sendUserMessageToolBuild() {
+    return {
+        tool: {
+            name: "send_user_message",
+            description: "Send a message that must be presented to the user. " +
+                "The foreground agent will rephrase and deliver it. " +
+                "Use for user-facing updates, results, or notifications.",
+            parameters: schema
+        },
+        returns: sendUserMessageReturns,
+        execute: async (args, toolContext, toolCall) => {
+            const payload = args;
+            const descriptor = toolContext.agent.descriptor;
+            const origin = toolContext.agent.id;
+            // Resolve target: parent agent for subagents/apps, most recent foreground otherwise
+            const targetAgentId = descriptor.type === "subagent" || descriptor.type === "app" ? descriptor.parentAgentId : undefined;
+            const resolvedTarget = targetAgentId ?? toolContext.agentSystem.agentFor("most-recent-foreground");
+            if (!resolvedTarget) {
+                throw new Error("No foreground agent found to deliver the message.");
+            }
+            const wrappedText = messageBuildUserFacing(payload.text, origin);
+            await toolContext.agentSystem.post({ agentId: resolvedTarget }, { type: "system_message", text: wrappedText, origin });
+            const summary = "Message queued for user delivery.";
+            const toolMessage = {
+                role: "toolResult",
+                toolCallId: toolCall.id,
+                toolName: toolCall.name,
+                content: [
+                    {
+                        type: "text",
+                        text: summary
+                    }
+                ],
+                isError: false,
+                timestamp: Date.now()
+            };
+            return {
+                toolMessage,
+                typedResult: {
+                    summary,
+                    targetAgentId: resolvedTarget,
+                    originAgentId: origin
+                }
+            };
+        }
+    };
+}
+//# sourceMappingURL=sendUserMessageTool.js.map

package/dist/engine/modules/tools/sendUserMessageTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendUserMessageTool.js","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/sendUserMessageTool.ts"],"names":[],"mappings":"AACA,OAAO,EAAe,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAGtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAElF,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CACtB;IACI,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;CACtC,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAClC,CAAC;AAIF,MAAM,2BAA2B,GAAG,IAAI,CAAC,MAAM,CAC3C;IACI,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE;IACtB,aAAa,EAAE,IAAI,CAAC,MAAM,EAAE;IAC5B,aAAa,EAAE,IAAI,CAAC,MAAM,EAAE;CAC/B,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAClC,CAAC;AAIF,MAAM,sBAAsB,GAA8C;IACtE,MAAM,EAAE,2BAA2B;IACnC,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO;CACxC,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,wBAAwB;IACpC,OAAO;QACH,IAAI,EAAE;YACF,IAAI,EAAE,mBAAmB;YACzB,WAAW,EACP,qDAAqD;gBACrD,qDAAqD;gBACrD,yDAAyD;YAC7D,UAAU,EAAE,MAAM;SACrB;QACD,OAAO,EAAE,sBAAsB;QAC/B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE;YAC3C,MAAM,OAAO,GAAG,IAA2B,CAAC;YAC5C,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC;YAChD,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;YAEpC,oFAAoF;YACpF,MAAM,aAAa,GACf,UAAU,CAAC,IAAI,KAAK,UAAU,IAAI,UAAU,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;YACvG,MAAM,cAAc,GAAG,aAAa,IAAI,WAAW,CAAC,WAAW,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAAC;YACnG,IAAI,CAAC,cAAc,EAAE,CAAC;gBAClB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;YACzE,CAAC;YAED,MAAM,WAAW,GAAG,sBAAsB,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACjE,MAAM,WAAW,CAAC,WAAW,CAAC,IAAI,CAC9B,EAAE,OAAO,EAAE,cAAc,EAAE,EAC3B,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CACxD,CAAC;YAEF,MAAM,OAAO,GAAG,mCAAmC,CAAC;YACpD,MAAM,WAAW,GAAsB;gBACnC,IAAI,EAAE,YAAY;gBAClB,UAAU,EAAE,QAAQ,CAAC,EAAE;gBACvB,QAAQ,EAAE,QAAQ,CAAC,IAAI;gBACvB,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,OAAO;qBAChB;iBACJ;gBACD,OAAO,EAAE,KAAK;gBACd,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACxB,CAAC;YAEF,OAAO;gBACH,WAAW;gBACX,WAAW,EAAE;oBACT,OAAO;oBACP,aAAa,EAAE,cAAc;oBAC7B,aAAa,EAAE,MAAM;iBACxB;aACJ,CAAC;QACN,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/engine/modules/tools/sendUserMessageTool.spec.d.ts

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

package/dist/engine/modules/tools/sendUserMessageTool.spec.d.ts.map

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

package/dist/engine/modules/tools/sendUserMessageTool.spec.js

@@ -0,0 +1,72 @@
+import { describe, expect, it, vi } from "vitest";
+import { sendUserMessageToolBuild } from "./sendUserMessageTool.js";
+const toolCall = { id: "tool-1", name: "send_user_message" };
+describe("sendUserMessageToolBuild", () => {
+    it("posts message_for_user to parent agent for subagents", async () => {
+        const post = vi.fn();
+        const tool = sendUserMessageToolBuild();
+        const ctx = contextBuild({
+            agentId: "bg-1",
+            descriptor: { type: "subagent", id: "bg-1", parentAgentId: "fg-1", name: "worker" },
+            post
+        });
+        const result = await tool.execute({ text: "task done" }, ctx, toolCall);
+        expect(post).toHaveBeenCalledWith({ agentId: "fg-1" }, {
+            type: "system_message",
+            text: '<message_for_user origin="bg-1">task done</message_for_user>',
+            origin: "bg-1"
+        });
+        expect(result.toolMessage.isError).toBe(false);
+    });
+    it("falls back to most-recent-foreground when no parent", async () => {
+        const post = vi.fn();
+        const tool = sendUserMessageToolBuild();
+        const ctx = contextBuild({
+            agentId: "bg-2",
+            descriptor: { type: "permanent", id: "bg-2", name: "bot" },
+            post,
+            foregroundAgentId: "fg-main"
+        });
+        await tool.execute({ text: "hello user" }, ctx, toolCall);
+        expect(post).toHaveBeenCalledWith({ agentId: "fg-main" }, expect.objectContaining({ type: "system_message" }));
+    });
+    it("throws when no foreground agent is found", async () => {
+        const tool = sendUserMessageToolBuild();
+        const ctx = contextBuild({
+            agentId: "bg-3",
+            descriptor: { type: "permanent", id: "bg-3", name: "bot" },
+            post: vi.fn(),
+            foregroundAgentId: null
+        });
+        await expect(tool.execute({ text: "hi" }, ctx, toolCall)).rejects.toThrow("No foreground agent found");
+    });
+});
+function contextBuild(opts) {
+    return {
+        connectorRegistry: null,
+        fileStore: null,
+        auth: null,
+        logger: console,
+        assistant: null,
+        permissions: {
+            workingDir: "/tmp",
+            writeDirs: ["/tmp"],
+            readDirs: ["/tmp"],
+            network: false,
+            events: false
+        },
+        agent: {
+            id: opts.agentId,
+            descriptor: opts.descriptor
+        },
+        ctx: null,
+        source: "test",
+        messageContext: {},
+        agentSystem: {
+            post: opts.post,
+            agentFor: () => opts.foregroundAgentId ?? undefined
+        },
+        heartbeats: null
+    };
+}
+//# sourceMappingURL=sendUserMessageTool.spec.js.map

package/dist/engine/modules/tools/sendUserMessageTool.spec.js.map

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

package/dist/engine/modules/tools/sessionHistoryToolBuild.d.ts

@@ -0,0 +1,7 @@
+import type { ToolDefinition } from "@/types";
+/**
+ * Builds the read_session_history tool for cross-session visibility.
+ * Expects: agentId references another persisted agent/session id.
+ */
+export declare function sessionHistoryToolBuild(): ToolDefinition;
+//# sourceMappingURL=sessionHistoryToolBuild.d.ts.map

package/dist/engine/modules/tools/sessionHistoryToolBuild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionHistoryToolBuild.d.ts","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/sessionHistoryToolBuild.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAsB,cAAc,EAA4C,MAAM,SAAS,CAAC;AA+C5G;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,cAAc,CA4DxD"}

package/dist/engine/modules/tools/sessionHistoryToolBuild.js

@@ -0,0 +1,213 @@
+import { createId } from "@paralleldrive/cuid2";
+import { Type } from "@sinclair/typebox";
+import { getProviderDefinition, listActiveInferenceProviders } from "../../../providers/catalog.js";
+import { providerModelSelectBySize } from "../../../providers/providerModelSelectBySize.js";
+import { stringTruncate } from "../../../utils/stringTruncate.js";
+import { agentDescriptorRead } from "../../agents/ops/agentDescriptorRead.js";
+import { agentHistoryLoad } from "../../agents/ops/agentHistoryLoad.js";
+import { agentHistorySummary } from "../../agents/ops/agentHistorySummary.js";
+import { agentPromptBundledRead } from "../../agents/ops/agentPromptBundledRead.js";
+import { messageExtractText } from "../../messages/messageExtractText.js";
+import { toolResultFormatVerbose } from "./toolResultFormatVerbose.js";
+const schema = Type.Object({
+    agentId: Type.String({ minLength: 1 }),
+    summarized: Type.Optional(Type.Boolean()),
+    fromAt: Type.Optional(Type.Integer({ minimum: 0 })),
+    toAt: Type.Optional(Type.Integer({ minimum: 0 }))
+}, { additionalProperties: false });
+const MAX_SUMMARY_RECORDS = 400;
+const MAX_SUMMARY_INPUT_CHARS = 120_000;
+const sessionHistoryResultSchema = Type.Object({
+    summary: Type.String(),
+    agentId: Type.String(),
+    summarized: Type.Boolean(),
+    recordCount: Type.Number()
+}, { additionalProperties: false });
+const sessionHistoryReturns = {
+    schema: sessionHistoryResultSchema,
+    toLLMText: (result) => result.summary
+};
+/**
+ * Builds the read_session_history tool for cross-session visibility.
+ * Expects: agentId references another persisted agent/session id.
+ */
+export function sessionHistoryToolBuild() {
+    return {
+        tool: {
+            name: "read_session_history",
+            description: "Read another session's history by agentId. Returns a summary by default (summarized=true). Optional fromAt/toAt filters by record timestamp (unix ms).",
+            parameters: schema
+        },
+        returns: sessionHistoryReturns,
+        execute: async (args, toolContext, toolCall) => {
+            const payload = args;
+            const agentId = payload.agentId.trim();
+            if (!agentId) {
+                throw new Error("agentId is required.");
+            }
+            if (agentId === toolContext.agent.id) {
+                throw new Error("agentId must refer to another session.");
+            }
+            const storage = toolContext.agentSystem.storage;
+            const descriptor = await agentDescriptorRead(storage, agentId);
+            if (!descriptor) {
+                throw new Error(`Agent session not found: ${agentId}`);
+            }
+            const timeRange = sessionHistoryTimeRangeNormalize(payload.fromAt, payload.toAt);
+            const records = agentHistoryFilterByTime(await agentHistoryLoad(storage, agentId), timeRange);
+            const summarized = payload.summarized ?? true;
+            const text = summarized
+                ? await summaryTextGenerate(agentId, records, toolContext)
+                : rawHistoryTextBuild(agentId, records);
+            const summary = text;
+            const toolMessage = {
+                role: "toolResult",
+                toolCallId: toolCall.id,
+                toolName: toolCall.name,
+                content: [{ type: "text", text: summary }],
+                details: {
+                    agentId,
+                    summarized,
+                    recordCount: records.length,
+                    fromAt: timeRange.fromAt,
+                    toAt: timeRange.toAt
+                },
+                isError: false,
+                timestamp: Date.now()
+            };
+            return {
+                toolMessage,
+                typedResult: {
+                    summary,
+                    agentId,
+                    summarized,
+                    recordCount: records.length
+                }
+            };
+        }
+    };
+}
+async function summaryTextGenerate(agentId, records, toolContext) {
+    if (records.length === 0) {
+        return `No history records found for agent ${agentId}.`;
+    }
+    const providers = listActiveInferenceProviders(toolContext.agentSystem.config.current.settings);
+    if (providers.length === 0) {
+        throw new Error("No inference provider available.");
+    }
+    const providersOverride = providers.map((provider) => {
+        const definition = getProviderDefinition(provider.id);
+        const normalModel = providerModelSelectBySize(definition?.models ?? [], "normal");
+        return normalModel ? { ...provider, model: normalModel } : { ...provider };
+    });
+    const summaryPrompt = (await agentPromptBundledRead("COMPACTION.md")).trim();
+    const summaryContext = {
+        systemPrompt: summaryPrompt,
+        messages: [
+            {
+                role: "user",
+                content: summaryInputBuild(agentId, records),
+                timestamp: Date.now()
+            }
+        ]
+    };
+    const response = await toolContext.agentSystem.inferenceRouter.complete(summaryContext, `session-history-summary:${createId()}`, { providersOverride });
+    const summaryText = messageExtractText(response.message)?.trim();
+    if (!summaryText) {
+        throw new Error("Summarization model returned empty output.");
+    }
+    return [`Agent ${agentId} session summary:`, summaryText].join("\n");
+}
+function rawHistoryTextBuild(agentId, records) {
+    if (records.length === 0) {
+        return `No history records found for agent ${agentId}.`;
+    }
+    return [
+        `Agent ${agentId} full session history (${records.length} records):`,
+        JSON.stringify(records, null, 2)
+    ].join("\n");
+}
+function summaryInputBuild(agentId, records) {
+    const summary = agentHistorySummary(records);
+    const tail = records.slice(-MAX_SUMMARY_RECORDS);
+    const omittedCount = records.length - tail.length;
+    const lines = [
+        `Summarize this agent session history: ${agentId}`,
+        `record_count: ${summary.recordCount}`,
+        `range: ${formatTimestamp(summary.firstAt)} -> ${formatTimestamp(summary.lastAt)}`,
+        [
+            `types: user=${summary.counts.user_message}`,
+            `assistant=${summary.counts.assistant_message}`,
+            `assistant_rewrite=${summary.counts.assistant_rewrite}`,
+            `tool_result=${summary.counts.tool_result}`,
+            `note=${summary.counts.note}`
+        ].join(" "),
+        omittedCount > 0
+            ? `Only last ${tail.length} records are included below (${omittedCount} earlier records omitted).`
+            : "All records are included below.",
+        "History:"
+    ];
+    for (const record of tail) {
+        lines.push(recordSummaryLineBuild(record));
+    }
+    return stringTruncate(lines.join("\n"), MAX_SUMMARY_INPUT_CHARS);
+}
+function sessionHistoryTimeRangeNormalize(fromAt, toAt) {
+    const normalized = {
+        fromAt: fromAt ?? null,
+        toAt: toAt ?? null
+    };
+    if (normalized.fromAt !== null && normalized.toAt !== null && normalized.fromAt > normalized.toAt) {
+        throw new Error("fromAt must be less than or equal to toAt.");
+    }
+    return normalized;
+}
+function agentHistoryFilterByTime(records, timeRange) {
+    return records.filter((record) => {
+        if (timeRange.fromAt !== null && record.at < timeRange.fromAt) {
+            return false;
+        }
+        if (timeRange.toAt !== null && record.at > timeRange.toAt) {
+            return false;
+        }
+        return true;
+    });
+}
+function recordSummaryLineBuild(record) {
+    const prefix = `[${formatTimestamp(record.at)}]`;
+    if (record.type === "user_message") {
+        return `${prefix} user_message text="${singleLine(stringTruncate(record.text, 700))}"`;
+    }
+    if (record.type === "assistant_message") {
+        return `${prefix} assistant_message text="${singleLine(stringTruncate(record.text, 700))}"`;
+    }
+    if (record.type === "assistant_rewrite") {
+        return `${prefix} assistant_rewrite assistantAt=${record.assistantAt} reason=${record.reason} text="${singleLine(stringTruncate(record.text, 700))}"`;
+    }
+    if (record.type === "note") {
+        return `${prefix} note text="${singleLine(stringTruncate(record.text, 400))}"`;
+    }
+    if (record.type === "rlm_start") {
+        return `${prefix} rlm_start toolCallId=${record.toolCallId} code="${singleLine(stringTruncate(record.code, 400))}"`;
+    }
+    if (record.type === "rlm_tool_call") {
+        return `${prefix} rlm_tool_call toolCallId=${record.toolCallId} toolName=${record.toolName}`;
+    }
+    if (record.type === "rlm_tool_result") {
+        return `${prefix} rlm_tool_result toolCallId=${record.toolCallId} toolName=${record.toolName} isError=${record.toolIsError}`;
+    }
+    if (record.type === "rlm_complete") {
+        return `${prefix} rlm_complete toolCallId=${record.toolCallId} isError=${record.isError} toolCalls=${record.toolCallCount}`;
+    }
+    return `${prefix} tool_result toolCallId=${record.toolCallId} ${singleLine(toolResultFormatVerbose(record.output))}`;
+}
+function singleLine(value) {
+    return value.replace(/\s+/g, " ").trim();
+}
+function formatTimestamp(at) {
+    if (at === null) {
+        return "unknown";
+    }
+    return new Date(at).toISOString();
+}
+//# sourceMappingURL=sessionHistoryToolBuild.js.map

package/dist/engine/modules/tools/sessionHistoryToolBuild.js.map

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

package/dist/engine/modules/tools/sessionHistoryToolBuild.spec.d.ts

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

package/dist/engine/modules/tools/sessionHistoryToolBuild.spec.d.ts.map

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

package/dist/engine/modules/tools/sessionHistoryToolBuild.spec.js

@@ -0,0 +1,197 @@
+import { mkdtemp, rm } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { createId } from "@paralleldrive/cuid2";
+import { describe, expect, it, vi } from "vitest";
+import { configResolve } from "../../../config/configResolve.js";
+import { storageResolve } from "../../../storage/storageResolve.js";
+import { agentDescriptorWrite } from "../../agents/ops/agentDescriptorWrite.js";
+import { agentHistoryAppend } from "../../agents/ops/agentHistoryAppend.js";
+import { sessionHistoryToolBuild } from "./sessionHistoryToolBuild.js";
+const toolCall = { id: "tool-1", name: "read_session_history" };
+describe("sessionHistoryToolBuild", () => {
+    it("returns summary output by default", async () => {
+        const dir = await mkdtemp(path.join(os.tmpdir(), "daycare-session-history-tool-"));
+        try {
+            const config = configResolve({
+                engine: { dataDir: dir },
+                assistant: { workspaceDir: dir },
+                providers: [{ id: "openai", model: "gpt-4o-mini", enabled: true }]
+            }, path.join(dir, "settings.json"));
+            const currentAgentId = createId();
+            const targetAgentId = createId();
+            await agentDescriptorWrite(config, targetAgentId, {
+                type: "subagent",
+                id: targetAgentId,
+                parentAgentId: currentAgentId,
+                name: "worker"
+            });
+            await agentHistoryAppend(config, targetAgentId, { type: "note", at: 10, text: "start" });
+            await agentHistoryAppend(config, targetAgentId, {
+                type: "user_message",
+                at: 20,
+                text: "check logs",
+                files: []
+            });
+            const tool = sessionHistoryToolBuild();
+            const completeMock = vi.fn(async (..._args) => ({
+                message: summaryAssistantMessageBuild("Summary:\n- reviewed history"),
+                providerId: "openai",
+                modelId: "gpt-test"
+            }));
+            const context = buildContext(currentAgentId, config, completeMock);
+            const result = await tool.execute({ agentId: targetAgentId }, context, toolCall);
+            const text = contentText(result.toolMessage.content);
+            expect(result.toolMessage.isError).toBe(false);
+            expect(text).toContain("Agent");
+            expect(text).toContain("Summary:");
+            expect(text).toContain("reviewed history");
+            expect(completeMock).toHaveBeenCalledTimes(1);
+            const summaryContext = completeMock.mock.calls[0]?.[0];
+            expect(summaryContext).toBeDefined();
+            expect(summaryContext?.messages).toHaveLength(1);
+            const details = result.toolMessage.details;
+            expect(details.fromAt).toBe(null);
+            expect(details.toAt).toBe(null);
+        }
+        finally {
+            await rm(dir, { recursive: true, force: true });
+        }
+    });
+    it("returns raw history when summarized is false", async () => {
+        const dir = await mkdtemp(path.join(os.tmpdir(), "daycare-session-history-tool-"));
+        try {
+            const config = configResolve({
+                engine: { dataDir: dir },
+                assistant: { workspaceDir: dir },
+                providers: [{ id: "openai", model: "gpt-4o-mini", enabled: true }]
+            }, path.join(dir, "settings.json"));
+            const currentAgentId = createId();
+            const targetAgentId = createId();
+            await agentDescriptorWrite(config, targetAgentId, {
+                type: "subagent",
+                id: targetAgentId,
+                parentAgentId: currentAgentId,
+                name: "worker"
+            });
+            await agentHistoryAppend(config, targetAgentId, { type: "note", at: 10, text: "start" });
+            await agentHistoryAppend(config, targetAgentId, {
+                type: "note",
+                at: 30,
+                text: "done"
+            });
+            await agentHistoryAppend(config, targetAgentId, {
+                type: "note",
+                at: 50,
+                text: "late"
+            });
+            const tool = sessionHistoryToolBuild();
+            const completeMock = vi.fn(async (..._args) => ({
+                message: summaryAssistantMessageBuild("unused"),
+                providerId: "openai",
+                modelId: "gpt-test"
+            }));
+            const context = buildContext(currentAgentId, config, completeMock);
+            const result = await tool.execute({ agentId: targetAgentId, summarized: false, fromAt: 20, toAt: 40 }, context, toolCall);
+            const text = contentText(result.toolMessage.content);
+            expect(result.toolMessage.isError).toBe(false);
+            expect(text).toContain("full session history");
+            expect(text).toContain('"type": "note"');
+            expect(text).toContain('"at": 30');
+            expect(text).not.toContain('"at": 10');
+            expect(text).not.toContain('"at": 50');
+            expect(completeMock).not.toHaveBeenCalled();
+            const details = result.toolMessage.details;
+            expect(details.recordCount).toBe(1);
+            expect(details.fromAt).toBe(20);
+            expect(details.toAt).toBe(40);
+        }
+        finally {
+            await rm(dir, { recursive: true, force: true });
+        }
+    });
+    it("rejects invalid time range", async () => {
+        const dir = await mkdtemp(path.join(os.tmpdir(), "daycare-session-history-tool-"));
+        try {
+            const config = configResolve({
+                engine: { dataDir: dir },
+                assistant: { workspaceDir: dir },
+                providers: [{ id: "openai", model: "gpt-4o-mini", enabled: true }]
+            }, path.join(dir, "settings.json"));
+            const currentAgentId = createId();
+            const targetAgentId = createId();
+            await agentDescriptorWrite(config, targetAgentId, {
+                type: "subagent",
+                id: targetAgentId,
+                parentAgentId: currentAgentId,
+                name: "worker"
+            });
+            await agentHistoryAppend(config, targetAgentId, { type: "note", at: 10, text: "start" });
+            const tool = sessionHistoryToolBuild();
+            const completeMock = vi.fn(async (..._args) => ({
+                message: summaryAssistantMessageBuild("unused"),
+                providerId: "openai",
+                modelId: "gpt-test"
+            }));
+            const context = buildContext(currentAgentId, config, completeMock);
+            await expect(tool.execute({ agentId: targetAgentId, summarized: false, fromAt: 41, toAt: 40 }, context, toolCall)).rejects.toThrow("fromAt must be less than or equal to toAt.");
+            expect(completeMock).not.toHaveBeenCalled();
+        }
+        finally {
+            await rm(dir, { recursive: true, force: true });
+        }
+    });
+});
+function buildContext(agentId, config, completeMock) {
+    const storage = storageResolve(config);
+    return {
+        connectorRegistry: null,
+        fileStore: null,
+        auth: null,
+        logger: console,
+        assistant: null,
+        permissions: config.defaultPermissions,
+        agent: { id: agentId },
+        ctx: null,
+        source: "test",
+        messageContext: {},
+        agentSystem: {
+            config: { current: config },
+            storage,
+            inferenceRouter: {
+                complete: completeMock
+            }
+        },
+        heartbeats: null
+    };
+}
+function contentText(content) {
+    if (!Array.isArray(content)) {
+        return "";
+    }
+    return content
+        .filter((item) => {
+        if (typeof item !== "object" || item === null) {
+            return false;
+        }
+        return item.type === "text";
+    })
+        .map((item) => item.text)
+        .filter((value) => typeof value === "string")
+        .join("\n");
+}
+function summaryAssistantMessageBuild(text) {
+    return {
+        role: "assistant",
+        content: [{ type: "text", text }],
+        stopReason: "complete",
+        usage: {
+            input: 0,
+            output: 0,
+            cacheRead: 0,
+            cacheWrite: 0,
+            total: 0
+        }
+    };
+}
+//# sourceMappingURL=sessionHistoryToolBuild.spec.js.map