daycare-cli 0.0.1

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

@@ -0,0 +1,187 @@
+import { Type } from "@sinclair/typebox";
+import { createId } from "@paralleldrive/cuid2";
+import path from "node:path";
+import { agentDescriptorTargetResolve } from "../../agents/ops/agentDescriptorTargetResolve.js";
+import { agentDescriptorLabel } from "../../agents/ops/agentDescriptorLabel.js";
+import { permissionAccessParse } from "../../permissions/permissionAccessParse.js";
+import { permissionAccessAllows } from "../../permissions/permissionAccessAllows.js";
+const schema = Type.Object({
+    permission: Type.String({ minLength: 1 }),
+    reason: Type.String({ minLength: 1 }),
+    agentId: Type.Optional(Type.String({ minLength: 1 }))
+}, { additionalProperties: false });
+const grantSchema = Type.Object({
+    agentId: Type.String({ minLength: 1 }),
+    permission: Type.String({ minLength: 1 }),
+    reason: Type.String({ minLength: 1 })
+}, { additionalProperties: false });
+export function buildPermissionRequestTool() {
+    return {
+        tool: {
+            name: "request_permission",
+            description: "Request additional permissions from the user. Emits a connector-specific approval prompt.",
+            parameters: schema
+        },
+        execute: async (args, toolContext, toolCall) => {
+            const payload = args;
+            const descriptor = toolContext.agent.descriptor;
+            const isForeground = descriptor.type === "user";
+            const permission = payload.permission.trim();
+            const reason = payload.reason.trim();
+            if (!reason) {
+                throw new Error("Permission reason is required.");
+            }
+            if (!permission) {
+                throw new Error("Permission string is required.");
+            }
+            if (!isForeground && payload.agentId) {
+                throw new Error("Background agents cannot override agentId.");
+            }
+            const requestedAgentId = payload.agentId?.trim() ?? toolContext.agent.id;
+            const requestedDescriptor = requestedAgentId === toolContext.agent.id
+                ? descriptor
+                : toolContext.agentSystem.getAgentDescriptor(requestedAgentId);
+            if (!requestedDescriptor) {
+                throw new Error("Requested agent not found.");
+            }
+            const connectorRegistry = toolContext.connectorRegistry;
+            if (!connectorRegistry) {
+                throw new Error("Connector registry unavailable.");
+            }
+            const foregroundAgentId = isForeground
+                ? toolContext.agent.id
+                : toolContext.agentSystem.agentFor("most-recent-foreground");
+            if (!foregroundAgentId) {
+                throw new Error("No foreground agent available for permission requests.");
+            }
+            const foregroundDescriptor = isForeground
+                ? descriptor
+                : toolContext.agentSystem.getAgentDescriptor(foregroundAgentId);
+            if (!foregroundDescriptor) {
+                throw new Error("Foreground agent descriptor not found.");
+            }
+            const target = agentDescriptorTargetResolve(foregroundDescriptor);
+            if (!target) {
+                throw new Error("Foreground agent has no user target for permission requests.");
+            }
+            const connector = connectorRegistry.get(target.connector);
+            if (!connector) {
+                throw new Error("Connector not available for permission requests.");
+            }
+            const access = permissionAccessParse(permission);
+            if (access.kind !== "network" && !path.isAbsolute(access.path)) {
+                throw new Error("Path must be absolute.");
+            }
+            const friendly = describePermission(access);
+            const requesterLabel = agentDescriptorLabel(requestedDescriptor);
+            const requesterKind = requestedDescriptor.type === "user" ? "foreground" : "background";
+            const heading = requestedDescriptor.type === "user"
+                ? "Permission request:"
+                : `Permission request from background agent "${requesterLabel}":`;
+            const text = `${heading}\n${friendly}\nReason: ${reason}`;
+            const request = {
+                token: createId(),
+                agentId: requestedAgentId,
+                reason,
+                message: text,
+                permission,
+                access,
+                requester: {
+                    id: requestedAgentId,
+                    type: requestedDescriptor.type,
+                    label: requesterLabel,
+                    kind: requesterKind
+                }
+            };
+            if (connector.requestPermission) {
+                await connector.requestPermission(target.targetId, request, toolContext.messageContext, foregroundDescriptor);
+            }
+            else {
+                await connector.sendMessage(target.targetId, {
+                    text,
+                    replyToMessageId: toolContext.messageContext.messageId
+                });
+            }
+            if (!isForeground && requestedDescriptor.type !== "user") {
+                const agentName = agentDescriptorLabel(requestedDescriptor);
+                const notice = [
+                    `Permission request from background agent "${agentName}" was presented to the user.`,
+                    `permission: ${permission}`,
+                    `reason: ${reason}`
+                ].join("\n");
+                await toolContext.agentSystem.post({ agentId: foregroundAgentId }, {
+                    type: "system_message",
+                    text: notice,
+                    origin: requestedAgentId,
+                    silent: true
+                });
+            }
+            const toolMessage = {
+                role: "toolResult",
+                toolCallId: toolCall.id,
+                toolName: toolCall.name,
+                content: [{ type: "text", text: "Permission request sent." }],
+                details: {
+                    permission,
+                    token: request.token,
+                    agentId: requestedAgentId
+                },
+                isError: false,
+                timestamp: Date.now()
+            };
+            return { toolMessage, files: [] };
+        }
+    };
+}
+export function buildPermissionGrantTool() {
+    return {
+        tool: {
+            name: "grant_permission",
+            description: "Grant a permission you already have to another agent (requires a justification).",
+            parameters: grantSchema
+        },
+        execute: async (args, toolContext, toolCall) => {
+            const payload = args;
+            const permission = payload.permission.trim();
+            const reason = payload.reason.trim();
+            if (!reason) {
+                throw new Error("Reason is required.");
+            }
+            const access = permissionAccessParse(permission);
+            const allowed = await permissionAccessAllows(toolContext.permissions, access);
+            if (!allowed) {
+                throw new Error("You can only grant permissions you already have.");
+            }
+            await toolContext.agentSystem.grantPermission({ agentId: payload.agentId }, access);
+            const toolMessage = {
+                role: "toolResult",
+                toolCallId: toolCall.id,
+                toolName: toolCall.name,
+                content: [
+                    {
+                        type: "text",
+                        text: `Permission granted to agent ${payload.agentId}.`
+                    }
+                ],
+                details: {
+                    agentId: payload.agentId,
+                    permission,
+                    reason
+                },
+                isError: false,
+                timestamp: Date.now()
+            };
+            return { toolMessage, files: [] };
+        }
+    };
+}
+function describePermission(access) {
+    if (access.kind === "network") {
+        return "Network access";
+    }
+    if (access.kind === "read") {
+        return `Read access to ${access.path}`;
+    }
+    return `Write access to ${access.path}`;
+}
+//# sourceMappingURL=permissions.js.map

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

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

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

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from "@/types";
+export declare function buildReactionTool(): ToolDefinition;
+//# sourceMappingURL=reaction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reaction.d.ts","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/reaction.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAc9C,wBAAgB,iBAAiB,IAAI,cAAc,CA0ClD"}

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

@@ -0,0 +1,49 @@
+import { Type } from "@sinclair/typebox";
+import { agentDescriptorTargetResolve } from "../../agents/ops/agentDescriptorTargetResolve.js";
+const schema = Type.Object({
+    reaction: Type.String({ minLength: 1 }),
+    messageId: Type.Optional(Type.String({ minLength: 1 })),
+    source: Type.Optional(Type.String({ minLength: 1 }))
+}, { additionalProperties: false });
+export function buildReactionTool() {
+    return {
+        tool: {
+            name: "set_reaction",
+            description: "Set a reaction emoji on a message in the active connector.",
+            parameters: schema
+        },
+        execute: async (args, toolContext, toolCall) => {
+            const payload = args;
+            if (!toolContext.connectorRegistry) {
+                throw new Error("Connector registry unavailable");
+            }
+            const target = agentDescriptorTargetResolve(toolContext.agent.descriptor);
+            if (!target) {
+                throw new Error("Reactions require a user agent.");
+            }
+            const source = payload.source ?? target.connector;
+            if (source !== target.connector) {
+                throw new Error("Reaction source must match the agent connector.");
+            }
+            const connector = toolContext.connectorRegistry.get(source);
+            if (!connector || !connector.capabilities.reactions || !connector.setReaction) {
+                throw new Error(`Connector does not support reactions: ${source}`);
+            }
+            const messageId = payload.messageId ?? toolContext.messageContext.messageId;
+            if (!messageId) {
+                throw new Error("Missing message id for reaction");
+            }
+            await connector.setReaction(target.targetId, String(messageId), payload.reaction);
+            const toolMessage = {
+                role: "toolResult",
+                toolCallId: toolCall.id,
+                toolName: toolCall.name,
+                content: [{ type: "text", text: `Reaction set: ${payload.reaction}` }],
+                isError: false,
+                timestamp: Date.now()
+            };
+            return { toolMessage, files: [] };
+        }
+    };
+}
+//# sourceMappingURL=reaction.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reaction.js","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/reaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAe,MAAM,mBAAmB,CAAC;AAItD,OAAO,EAAE,4BAA4B,EAAE,MAAM,kDAAkD,CAAC;AAEhG,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CACxB;IACE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACvC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;IACvD,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;CACrD,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAIF,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,IAAI,EAAE;YACJ,IAAI,EAAE,cAAc;YACpB,WAAW,EAAE,4DAA4D;YACzE,UAAU,EAAE,MAAM;SACnB;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE;YAC7C,MAAM,OAAO,GAAG,IAAoB,CAAC;YACrC,IAAI,CAAC,WAAW,CAAC,iBAAiB,EAAE,CAAC;gBACnC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;YACpD,CAAC;YACD,MAAM,MAAM,GAAG,4BAA4B,CAAC,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAC1E,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;YACrD,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,SAAS,CAAC;YAClD,IAAI,MAAM,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC;gBAChC,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;YACrE,CAAC;YACD,MAAM,SAAS,GAAG,WAAW,CAAC,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC5D,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;gBAC9E,MAAM,IAAI,KAAK,CAAC,yCAAyC,MAAM,EAAE,CAAC,CAAC;YACrE,CAAC;YACD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,WAAW,CAAC,cAAc,CAAC,SAAS,CAAC;YAC5E,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;YACrD,CAAC;YACD,MAAM,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;YAElF,MAAM,WAAW,GAAsB;gBACrC,IAAI,EAAE,YAAY;gBAClB,UAAU,EAAE,QAAQ,CAAC,EAAE;gBACvB,QAAQ,EAAE,QAAQ,CAAC,IAAI;gBACvB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;gBACtE,OAAO,EAAE,KAAK;gBACd,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC;YAEF,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QACpC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/engine/modules/tools/send-file.d.ts

@@ -0,0 +1,14 @@
+import type { ToolDefinition } from "@/types";
+declare const schema: import("@sinclair/typebox").TObject<{
+    fileId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    path: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    name: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    mimeType: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    sendAs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"auto">, import("@sinclair/typebox").TLiteral<"document">, import("@sinclair/typebox").TLiteral<"photo">, import("@sinclair/typebox").TLiteral<"video">]>>;
+    text: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    source: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    channelId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export declare function buildSendFileTool(): ToolDefinition<typeof schema>;
+export {};
+//# sourceMappingURL=send-file.d.ts.map

package/dist/engine/modules/tools/send-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-file.d.ts","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/send-file.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAGV,cAAc,EAEf,MAAM,SAAS,CAAC;AAIjB,QAAA,MAAM,MAAM;;;;;;;;;EAmBX,CAAC;AAaF,wBAAgB,iBAAiB,IAAI,cAAc,CAAC,OAAO,MAAM,CAAC,CA2EjE"}

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

@@ -0,0 +1,147 @@
+import { Type } from "@sinclair/typebox";
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { pathResolveSecure, openSecure } from "../../permissions/pathResolveSecure.js";
+import { agentDescriptorTargetResolve } from "../../agents/ops/agentDescriptorTargetResolve.js";
+const schema = Type.Object({
+    fileId: Type.Optional(Type.String({ minLength: 1 })),
+    path: Type.Optional(Type.String({ minLength: 1 })),
+    name: Type.Optional(Type.String({ minLength: 1 })),
+    mimeType: Type.Optional(Type.String({ minLength: 1 })),
+    sendAs: Type.Optional(Type.Union([
+        Type.Literal("auto"),
+        Type.Literal("document"),
+        Type.Literal("photo"),
+        Type.Literal("video")
+    ])),
+    text: Type.Optional(Type.String()),
+    source: Type.Optional(Type.String({ minLength: 1 })),
+    channelId: Type.Optional(Type.String({ minLength: 1 }))
+}, { additionalProperties: false });
+export function buildSendFileTool() {
+    return {
+        tool: {
+            name: "send_file",
+            description: "Send a file to the current channel via the active connector. Supports photo/video/document modes when available.",
+            parameters: schema
+        },
+        execute: async (args, context, toolCall) => {
+            const payload = args;
+            if (!context.connectorRegistry) {
+                throw new Error("Connector registry unavailable");
+            }
+            const target = agentDescriptorTargetResolve(context.agent.descriptor);
+            if (payload.source && target && payload.source !== target.connector && !payload.channelId) {
+                throw new Error("Override source requires an explicit channelId.");
+            }
+            const source = payload.source ?? target?.connector ?? context.source;
+            const connector = context.connectorRegistry.get(source);
+            if (!connector) {
+                throw new Error(`Connector not loaded: ${source}`);
+            }
+            const modes = connector.capabilities.sendFiles?.modes ?? [];
+            if (modes.length === 0) {
+                throw new Error(`Connector does not support file sending: ${source}`);
+            }
+            const sendAs = payload.sendAs ?? "auto";
+            if (sendAs !== "auto" && !modes.includes(sendAs)) {
+                throw new Error(`Connector does not support ${sendAs} mode: ${source}`);
+            }
+            const file = await resolveFile(payload, context);
+            const messageText = typeof payload.text === "string" && payload.text.length > 0
+                ? payload.text
+                : null;
+            const targetId = payload.channelId ?? target?.targetId;
+            if (!targetId) {
+                throw new Error("Send file requires a user agent or explicit channelId.");
+            }
+            await connector.sendMessage(targetId, {
+                text: messageText,
+                files: [{ ...file, sendAs }]
+            });
+            const toolMessage = {
+                role: "toolResult",
+                toolCallId: toolCall.id,
+                toolName: toolCall.name,
+                content: [
+                    {
+                        type: "text",
+                        text: `Sent file ${file.name}.`
+                    }
+                ],
+                details: {
+                    fileId: file.id,
+                    name: file.name,
+                    mimeType: file.mimeType,
+                    sendAs
+                },
+                isError: false,
+                timestamp: Date.now()
+            };
+            return {
+                toolMessage,
+                files: []
+            };
+        }
+    };
+}
+async function resolveFile(payload, context) {
+    const hasFileId = typeof payload.fileId === "string" && payload.fileId.length > 0;
+    const hasPath = typeof payload.path === "string" && payload.path.length > 0;
+    if (!hasFileId && !hasPath) {
+        throw new Error("fileId or path is required");
+    }
+    if (hasFileId && hasPath) {
+        throw new Error("Provide only one of fileId or path");
+    }
+    if (hasFileId) {
+        const stored = await context.fileStore.get(payload.fileId);
+        if (!stored) {
+            throw new Error(`Unknown file id: ${payload.fileId}`);
+        }
+        return {
+            id: stored.id,
+            name: stored.name,
+            mimeType: stored.mimeType,
+            size: stored.size,
+            path: stored.path
+        };
+    }
+    // Securely resolve path, following symlinks and verifying containment
+    const allowedDirs = [context.permissions.workingDir, ...context.permissions.readDirs];
+    const { realPath: resolved } = await pathResolveSecure(allowedDirs, payload.path);
+    // Use lstat to check for symlinks, then open securely to prevent TOCTOU
+    const stats = await fs.lstat(resolved);
+    if (stats.isSymbolicLink()) {
+        throw new Error("Cannot send symbolic link");
+    }
+    if (!stats.isFile()) {
+        throw new Error("Path is not a file");
+    }
+    // Verify file is still accessible via secure open
+    const handle = await openSecure(resolved, "r");
+    const handleStats = await handle.stat();
+    await handle.close();
+    if (!handleStats.isFile()) {
+        throw new Error("Path is not a file");
+    }
+    const mimeType = payload.mimeType;
+    if (!mimeType) {
+        throw new Error("mimeType is required when sending a path");
+    }
+    const name = payload.name ?? path.basename(resolved);
+    const stored = await context.fileStore.saveFromPath({
+        name,
+        mimeType,
+        source: "send_file",
+        path: resolved
+    });
+    return {
+        id: stored.id,
+        name: stored.name,
+        mimeType: stored.mimeType,
+        size: stored.size,
+        path: stored.path
+    };
+}
+//# sourceMappingURL=send-file.js.map

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/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":"AAKA,OAAO,KAAK,EAEV,cAAc,EAEf,MAAM,SAAS,CAAC;AA8BjB;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,cAAc,CAqDxD"}

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

@@ -0,0 +1,187 @@
+import { createId } from "@paralleldrive/cuid2";
+import { Type } from "@sinclair/typebox";
+import { listActiveInferenceProviders, getProviderDefinition } 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 { agentHistorySummaryBuild } from "../../agents/ops/agentHistorySummaryBuild.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;
+/**
+ * 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
+        },
+        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 config = toolContext.agentSystem.config.current;
+            const descriptor = await agentDescriptorRead(config, agentId);
+            if (!descriptor) {
+                throw new Error(`Agent session not found: ${agentId}`);
+            }
+            const timeRange = sessionHistoryTimeRangeNormalize(payload.fromAt, payload.toAt);
+            const records = agentHistoryFilterByTime(await agentHistoryLoad(config, agentId), timeRange);
+            const summarized = payload.summarized ?? true;
+            const text = summarized
+                ? await summaryTextGenerate(agentId, records, toolContext)
+                : rawHistoryTextBuild(agentId, records);
+            const toolMessage = {
+                role: "toolResult",
+                toolCallId: toolCall.id,
+                toolName: toolCall.name,
+                content: [{ type: "text", text }],
+                details: {
+                    agentId,
+                    summarized,
+                    recordCount: records.length,
+                    fromAt: timeRange.fromAt,
+                    toAt: timeRange.toAt
+                },
+                isError: false,
+                timestamp: Date.now()
+            };
+            return { toolMessage, files: [] };
+        }
+    };
+}
+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 = agentHistorySummaryBuild(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: start=${summary.counts.start}`,
+            `reset=${summary.counts.reset}`,
+            `user=${summary.counts.user_message}`,
+            `assistant=${summary.counts.assistant_message}`,
+            `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 === "start") {
+        return `${prefix} start`;
+    }
+    if (record.type === "reset") {
+        return `${prefix} reset ${record.message ? `message="${singleLine(record.message)}"` : ""}`.trim();
+    }
+    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 === "note") {
+        return `${prefix} note text="${singleLine(stringTruncate(record.text, 400))}"`;
+    }
+    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