daycare-cli 0.0.0-canary.f57680e

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

@@ -0,0 +1,138 @@
+import { mkdtemp, readFile, readdir, rm } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { describe, expect, it, vi } from "vitest";
+import { contextCompact } from "./contextCompact.js";
+const providers = [{ id: "openai" }];
+function buildAssistantMessage(text) {
+    return {
+        role: "assistant",
+        content: [{ type: "text", text }],
+        api: "openai-responses",
+        provider: "openai",
+        model: "gpt-4.1",
+        usage: {
+            input: 1,
+            output: 1,
+            cacheRead: 0,
+            cacheWrite: 0,
+            totalTokens: 2,
+            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 }
+        },
+        stopReason: "stop",
+        timestamp: Date.now()
+    };
+}
+function buildContext() {
+    return {
+        messages: [{ role: "user", content: "hello", timestamp: Date.now() }]
+    };
+}
+describe("contextCompact", () => {
+    it("returns one compacted summary message", async () => {
+        const complete = vi.fn(async () => ({
+            message: buildAssistantMessage("Summary"),
+            providerId: "openai",
+            modelId: "gpt-4.1"
+        }));
+        const inferenceRouter = { complete };
+        const compacted = await contextCompact({
+            context: buildContext(),
+            inferenceRouter,
+            providers
+        });
+        const messages = compacted.messages ?? [];
+        expect(messages).toHaveLength(1);
+        expect(messages[0]?.role).toBe("assistant");
+        expect(messages[0]?.content).toEqual([{ type: "text", text: "Summary" }]);
+    });
+    it("adds an explicit compaction instruction as the final user message", async () => {
+        let receivedContext;
+        const complete = vi.fn(async (context) => {
+            receivedContext = context;
+            return {
+                message: buildAssistantMessage("Summary"),
+                providerId: "openai",
+                modelId: "gpt-4.1"
+            };
+        });
+        const inferenceRouter = { complete };
+        await contextCompact({
+            context: buildContext(),
+            inferenceRouter,
+            providers
+        });
+        const lastMessage = receivedContext?.messages.at(-1);
+        expect(lastMessage?.role).toBe("user");
+        expect(lastMessage?.content).toBe("Summarize the conversation above into a compact context checkpoint. " +
+            "Follow the system prompt format exactly. " +
+            "Do not continue the conversation.");
+    });
+    it("returns an empty compacted context when summary text is empty", async () => {
+        const complete = vi.fn(async () => ({
+            message: buildAssistantMessage("  "),
+            providerId: "openai",
+            modelId: "gpt-4.1"
+        }));
+        const inferenceRouter = { complete };
+        const compacted = await contextCompact({
+            context: buildContext(),
+            inferenceRouter,
+            providers
+        });
+        expect(compacted.messages).toEqual([]);
+    });
+    it("forwards abort signal to inference router", async () => {
+        let receivedSignal;
+        const complete = vi.fn(async (_context, _sessionId, options) => {
+            receivedSignal = options?.signal;
+            return {
+                message: buildAssistantMessage("Summary"),
+                providerId: "openai",
+                modelId: "gpt-4.1"
+            };
+        });
+        const inferenceRouter = { complete };
+        const controller = new AbortController();
+        await contextCompact({
+            context: buildContext(),
+            inferenceRouter,
+            providers,
+            signal: controller.signal
+        });
+        expect(complete).toHaveBeenCalledTimes(1);
+        expect(receivedSignal).toBe(controller.signal);
+    });
+    it("writes per-agent compaction markdown logs", async () => {
+        const dir = await mkdtemp(path.join(os.tmpdir(), "daycare-context-compact-"));
+        try {
+            const complete = vi.fn(async () => ({
+                message: buildAssistantMessage("Summary for logging"),
+                providerId: "openai",
+                modelId: "gpt-4.1"
+            }));
+            const inferenceRouter = { complete };
+            await contextCompact({
+                context: buildContext(),
+                inferenceRouter,
+                providers,
+                compactionLog: {
+                    agentsDir: dir,
+                    agentId: "agent-1"
+                }
+            });
+            const agentDir = path.join(dir, "agent-1");
+            const entries = await readdir(agentDir);
+            const logName = entries.find((entry) => entry.startsWith("compaction_") && entry.endsWith(".md"));
+            expect(logName).toBeTruthy();
+            const raw = await readFile(path.join(agentDir, logName ?? ""), "utf8");
+            expect(raw).toContain("### Request Context");
+            expect(raw).toContain("### Inference Response");
+            expect(raw).toContain("Summary for logging");
+        }
+        finally {
+            await rm(dir, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=contextCompact.spec.js.map

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

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

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

@@ -0,0 +1,20 @@
+import type { AgentHistoryRecord } from "./agentTypes.js";
+import { type ContextEstimateTokensExtras } from "./contextEstimateTokensWithExtras.js";
+export type ContextCompactionStatus = {
+    estimatedTokens: number;
+    extraTokens: number;
+    emergencyLimit: number;
+    warningLimit: number;
+    criticalLimit: number;
+    utilization: number;
+    severity: "ok" | "warning" | "critical";
+};
+export type ContextCompactionStatusOptions = {
+    extras?: ContextEstimateTokensExtras;
+};
+/**
+ * Evaluates compaction pressure against the emergency context limit.
+ * Expects: emergencyLimit is a positive integer.
+ */
+export declare function contextCompactionStatus(history: AgentHistoryRecord[], emergencyLimit: number, options?: ContextCompactionStatusOptions): ContextCompactionStatus;
+//# sourceMappingURL=contextCompactionStatus.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contextCompactionStatus.d.ts","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/contextCompactionStatus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,sCAAsC,CAAC;AAK9C,MAAM,MAAM,uBAAuB,GAAG;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,IAAI,GAAG,SAAS,GAAG,UAAU,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,MAAM,CAAC,EAAE,2BAA2B,CAAC;CACtC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,kBAAkB,EAAE,EAC7B,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE,8BAAmC,GAC3C,uBAAuB,CAuBzB"}

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

@@ -0,0 +1,31 @@
+import { contextEstimateTokens } from "./contextEstimateTokens.js";
+import { contextEstimateTokensWithExtras } from "./contextEstimateTokensWithExtras.js";
+const WARNING_RATIO = 0.75;
+const CRITICAL_RATIO = 0.9;
+/**
+ * Evaluates compaction pressure against the emergency context limit.
+ * Expects: emergencyLimit is a positive integer.
+ */
+export function contextCompactionStatus(history, emergencyLimit, options = {}) {
+    const baseTokens = contextEstimateTokens(history);
+    const estimatedTokens = contextEstimateTokensWithExtras(history, options.extras);
+    const extraTokens = Math.max(0, estimatedTokens - baseTokens);
+    const warningLimit = Math.max(1, Math.floor(emergencyLimit * WARNING_RATIO));
+    const criticalLimit = Math.max(warningLimit + 1, Math.floor(emergencyLimit * CRITICAL_RATIO));
+    const utilization = emergencyLimit > 0 ? Math.min(1, estimatedTokens / emergencyLimit) : 0;
+    const severity = estimatedTokens >= criticalLimit
+        ? "critical"
+        : estimatedTokens >= warningLimit
+            ? "warning"
+            : "ok";
+    return {
+        estimatedTokens,
+        extraTokens,
+        emergencyLimit,
+        warningLimit,
+        criticalLimit,
+        utilization,
+        severity
+    };
+}
+//# sourceMappingURL=contextCompactionStatus.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contextCompactionStatus.js","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/contextCompactionStatus.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EACL,+BAA+B,EAEhC,MAAM,sCAAsC,CAAC;AAE9C,MAAM,aAAa,GAAG,IAAI,CAAC;AAC3B,MAAM,cAAc,GAAG,GAAG,CAAC;AAgB3B;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAA6B,EAC7B,cAAsB,EACtB,UAA0C,EAAE;IAE5C,MAAM,UAAU,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAClD,MAAM,eAAe,GAAG,+BAA+B,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACjF,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,eAAe,GAAG,UAAU,CAAC,CAAC;IAC9D,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,aAAa,CAAC,CAAC,CAAC;IAC7E,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,cAAc,CAAC,CAAC,CAAC;IAC9F,MAAM,WAAW,GAAG,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,eAAe,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3F,MAAM,QAAQ,GACZ,eAAe,IAAI,aAAa;QAC9B,CAAC,CAAC,UAAU;QACZ,CAAC,CAAC,eAAe,IAAI,YAAY;YAC/B,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,IAAI,CAAC;IAEb,OAAO;QACL,eAAe;QACf,WAAW;QACX,cAAc;QACd,YAAY;QACZ,aAAa;QACb,WAAW;QACX,QAAQ;KACT,CAAC;AACJ,CAAC"}

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

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

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

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

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

@@ -0,0 +1,37 @@
+import { describe, it, expect } from "vitest";
+import { contextCompactionStatus } from "./contextCompactionStatus.js";
+function buildHistory(textLength) {
+    return [
+        {
+            type: "user_message",
+            at: 1,
+            text: "x".repeat(textLength),
+            files: []
+        }
+    ];
+}
+describe("contextCompactionStatus", () => {
+    it("returns ok when under warning threshold", () => {
+        const history = buildHistory(200); // 50 tokens
+        const status = contextCompactionStatus(history, 100);
+        expect(status.estimatedTokens).toBe(50);
+        expect(status.severity).toBe("ok");
+    });
+    it("returns warning and critical at thresholds", () => {
+        const warningHistory = buildHistory(300); // 75 tokens
+        const warningStatus = contextCompactionStatus(warningHistory, 100);
+        expect(warningStatus.severity).toBe("warning");
+        const criticalHistory = buildHistory(360); // 90 tokens
+        const criticalStatus = contextCompactionStatus(criticalHistory, 100);
+        expect(criticalStatus.severity).toBe("critical");
+    });
+    it("includes heuristic extras in the estimate", () => {
+        const history = buildHistory(0);
+        const status = contextCompactionStatus(history, 100, {
+            extras: { systemPrompt: "x".repeat(48) }
+        });
+        expect(status.estimatedTokens).toBe(12);
+        expect(status.extraTokens).toBe(12);
+    });
+});
+//# sourceMappingURL=contextCompactionStatus.spec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contextCompactionStatus.spec.js","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/contextCompactionStatus.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAGvE,SAAS,YAAY,CAAC,UAAkB;IACtC,OAAO;QACL;YACE,IAAI,EAAE,cAAc;YACpB,EAAE,EAAE,CAAC;YACL,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC;YAC5B,KAAK,EAAE,EAAE;SACV;KACF,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY;QAC/C,MAAM,MAAM,GAAG,uBAAuB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,cAAc,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY;QACtD,MAAM,aAAa,GAAG,uBAAuB,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;QACnE,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAE/C,MAAM,eAAe,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY;QACvD,MAAM,cAAc,GAAG,uBAAuB,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;QACrE,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,MAAM,GAAG,uBAAuB,CAAC,OAAO,EAAE,GAAG,EAAE;YACnD,MAAM,EAAE,EAAE,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE;SACzC,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { AgentHistoryRecord } from "@/types";
+/**
+ * Estimates token usage from history records using a symbols/4 heuristic.
+ * Expects: records are ordered and contain valid user/assistant/tool entries.
+ */
+export declare function contextEstimateTokens(records: AgentHistoryRecord[]): number;
+//# sourceMappingURL=contextEstimateTokens.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contextEstimateTokens.d.ts","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/contextEstimateTokens.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAiB,MAAM,SAAS,CAAC;AAMjE;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAM3E"}

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

@@ -0,0 +1,114 @@
+const SYMBOLS_PER_TOKEN = 4;
+const IMAGE_SYMBOLS_ESTIMATE = 512;
+const IMAGE_DATA_PLACEHOLDER = "<image>";
+/**
+ * Estimates token usage from history records using a symbols/4 heuristic.
+ * Expects: records are ordered and contain valid user/assistant/tool entries.
+ */
+export function contextEstimateTokens(records) {
+    const symbols = records.reduce((total, record) => total + estimateRecordSymbols(record), 0);
+    if (symbols <= 0) {
+        return 0;
+    }
+    return Math.ceil(symbols / SYMBOLS_PER_TOKEN);
+}
+function estimateRecordSymbols(record) {
+    if (record.type === "user_message") {
+        return record.text.length + estimateFileSymbols(record.files);
+    }
+    if (record.type === "assistant_message") {
+        return (record.text.length +
+            estimateFileSymbols(record.files) +
+            estimateToolCallsSymbols(record.toolCalls));
+    }
+    if (record.type === "tool_result") {
+        return estimateToolMessageSymbols(record.output.toolMessage);
+    }
+    return 0;
+}
+function estimateToolCallsSymbols(toolCalls) {
+    return toolCalls.reduce((total, toolCall) => total + safeStringLength(toolCall), 0);
+}
+function estimateToolMessageSymbols(message) {
+    return estimateToolMessageContentSymbols(message.content);
+}
+function estimateToolMessageContentSymbols(content) {
+    if (typeof content === "string") {
+        return content.length;
+    }
+    if (Array.isArray(content)) {
+        return content.reduce((total, item) => total + estimateContentItemSymbols(item), 0);
+    }
+    return safeStringLength(content);
+}
+function estimateContentItemSymbols(item) {
+    if (item && typeof item === "object") {
+        if (isImageLike(item)) {
+            return IMAGE_SYMBOLS_ESTIMATE;
+        }
+        const maybeText = item;
+        if (maybeText.type === "text" && typeof maybeText.text === "string") {
+            return maybeText.text.length;
+        }
+    }
+    return safeStringLength(item);
+}
+function estimateFileSymbols(files) {
+    return files.reduce((total, file) => total + estimateFileSymbol(file), 0);
+}
+function estimateFileSymbol(file) {
+    if (file.mimeType.startsWith("image/")) {
+        return IMAGE_SYMBOLS_ESTIMATE;
+    }
+    return 0;
+}
+function safeStringLength(value) {
+    if (typeof value === "string") {
+        return value.length;
+    }
+    try {
+        const encoded = JSON.stringify(sanitizeImageData(value, 0, new WeakSet()));
+        return encoded ? encoded.length : 0;
+    }
+    catch {
+        return 0;
+    }
+}
+function sanitizeImageData(value, depth, seen) {
+    if (!value || typeof value !== "object") {
+        return value;
+    }
+    if (seen.has(value)) {
+        return null;
+    }
+    if (depth > 6) {
+        return null;
+    }
+    seen.add(value);
+    if (Array.isArray(value)) {
+        return value.map((entry) => sanitizeImageData(entry, depth + 1, seen));
+    }
+    if (isImageLike(value)) {
+        const image = value;
+        return { ...image, data: IMAGE_DATA_PLACEHOLDER };
+    }
+    const record = value;
+    const sanitized = {};
+    for (const [key, entry] of Object.entries(record)) {
+        sanitized[key] = sanitizeImageData(entry, depth + 1, seen);
+    }
+    return sanitized;
+}
+function isImageLike(value) {
+    if (!value || typeof value !== "object") {
+        return false;
+    }
+    const record = value;
+    if (record.type === "image" && typeof record.data === "string") {
+        return true;
+    }
+    return (typeof record.mimeType === "string" &&
+        record.mimeType.startsWith("image/") &&
+        typeof record.data === "string");
+}
+//# sourceMappingURL=contextEstimateTokens.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,88 @@
+import { describe, expect, it } from "vitest";
+import { contextEstimateTokens } from "./contextEstimateTokens.js";
+describe("contextEstimateTokens", () => {
+    it("estimates tokens from user, assistant, and tool records", () => {
+        const userText = "abcd";
+        const assistantText = "hello!";
+        const toolCall = {
+            type: "toolCall",
+            id: "tool-1",
+            name: "exec",
+            arguments: { cmd: "ls" }
+        };
+        const toolOutputText = "tool-output";
+        const toolResult = {
+            toolMessage: {
+                role: "toolResult",
+                toolCallId: "tool-1",
+                toolName: "exec",
+                content: [{ type: "text", text: toolOutputText }],
+                isError: false,
+                timestamp: Date.now()
+            },
+            typedResult: { text: toolOutputText }
+        };
+        const history = [
+            { type: "user_message", at: 1, text: userText, files: [] },
+            {
+                type: "assistant_message",
+                at: 2,
+                text: assistantText,
+                files: [],
+                toolCalls: [toolCall],
+                tokens: {
+                    provider: "test",
+                    model: "test-model",
+                    size: {
+                        input: 1,
+                        output: 1,
+                        cacheRead: 0,
+                        cacheWrite: 0,
+                        total: 2
+                    }
+                }
+            },
+            { type: "tool_result", at: 3, toolCallId: "tool-1", output: toolResult }
+        ];
+        const symbols = userText.length +
+            assistantText.length +
+            JSON.stringify(toolCall).length +
+            toolOutputText.length;
+        const expected = Math.ceil(symbols / 4);
+        expect(contextEstimateTokens(history)).toBe(expected);
+    });
+    it("does not scale image estimates with inline data size", () => {
+        const smallImage = "x".repeat(8);
+        const largeImage = "x".repeat(8000);
+        const smallResult = {
+            toolMessage: {
+                role: "toolResult",
+                toolCallId: "tool-1",
+                toolName: "image_generation",
+                content: [{ type: "image", data: smallImage, mimeType: "image/png" }],
+                isError: false,
+                timestamp: Date.now()
+            },
+            typedResult: { text: "" }
+        };
+        const largeResult = {
+            toolMessage: {
+                role: "toolResult",
+                toolCallId: "tool-1",
+                toolName: "image_generation",
+                content: [{ type: "image", data: largeImage, mimeType: "image/png" }],
+                isError: false,
+                timestamp: Date.now()
+            },
+            typedResult: { text: "" }
+        };
+        const smallHistory = [
+            { type: "tool_result", at: 1, toolCallId: "tool-1", output: smallResult }
+        ];
+        const largeHistory = [
+            { type: "tool_result", at: 1, toolCallId: "tool-1", output: largeResult }
+        ];
+        expect(contextEstimateTokens(largeHistory)).toBe(contextEstimateTokens(smallHistory));
+    });
+});
+//# sourceMappingURL=contextEstimateTokens.spec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contextEstimateTokens.spec.js","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/contextEstimateTokens.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAI9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,QAAQ,GAAG,MAAM,CAAC;QACxB,MAAM,aAAa,GAAG,QAAQ,CAAC;QAC/B,MAAM,QAAQ,GAAa;YACzB,IAAI,EAAE,UAAU;YAChB,EAAE,EAAE,QAAQ;YACZ,IAAI,EAAE,MAAM;YACZ,SAAS,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE;SACzB,CAAC;QACF,MAAM,cAAc,GAAG,aAAa,CAAC;QACrC,MAAM,UAAU,GAAwB;YACtC,WAAW,EAAE;gBACX,IAAI,EAAE,YAAY;gBAClB,UAAU,EAAE,QAAQ;gBACpB,QAAQ,EAAE,MAAM;gBAChB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;gBACjD,OAAO,EAAE,KAAK;gBACd,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB;YACD,WAAW,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE;SACtC,CAAC;QAEF,MAAM,OAAO,GAAyB;YACpC,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE;YAC1D;gBACE,IAAI,EAAE,mBAAmB;gBACzB,EAAE,EAAE,CAAC;gBACL,IAAI,EAAE,aAAa;gBACnB,KAAK,EAAE,EAAE;gBACT,SAAS,EAAE,CAAC,QAAQ,CAAC;gBACrB,MAAM,EAAE;oBACN,QAAQ,EAAE,MAAM;oBAChB,KAAK,EAAE,YAAY;oBACnB,IAAI,EAAE;wBACJ,KAAK,EAAE,CAAC;wBACR,MAAM,EAAE,CAAC;wBACT,SAAS,EAAE,CAAC;wBACZ,UAAU,EAAE,CAAC;wBACb,KAAK,EAAE,CAAC;qBACT;iBACF;aACF;YACD,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE;SACzE,CAAC;QAEF,MAAM,OAAO,GACX,QAAQ,CAAC,MAAM;YACf,aAAa,CAAC,MAAM;YACpB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,MAAM;YAC/B,cAAc,CAAC,MAAM,CAAC;QACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;QAExC,MAAM,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,WAAW,GAAwB;YACvC,WAAW,EAAE;gBACX,IAAI,EAAE,YAAY;gBAClB,UAAU,EAAE,QAAQ;gBACpB,QAAQ,EAAE,kBAAkB;gBAC5B,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;gBACrE,OAAO,EAAE,KAAK;gBACd,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB;YACD,WAAW,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;SAC1B,CAAC;QACF,MAAM,WAAW,GAAwB;YACvC,WAAW,EAAE;gBACX,IAAI,EAAE,YAAY;gBAClB,UAAU,EAAE,QAAQ;gBACpB,QAAQ,EAAE,kBAAkB;gBAC5B,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;gBACrE,OAAO,EAAE,KAAK;gBACd,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB;YACD,WAAW,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;SAC1B,CAAC;QACF,MAAM,YAAY,GAAyB;YACzC,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE;SAC1E,CAAC;QACF,MAAM,YAAY,GAAyB;YACzC,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE;SAC1E,CAAC;QAEF,MAAM,CAAC,qBAAqB,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,YAAY,CAAC,CAAC,CAAC;IACxF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,15 @@
+import type { Tool } from "@mariozechner/pi-ai";
+import type { AgentHistoryRecord } from "@/types";
+export type ContextEstimateTokensExtras = {
+    systemPrompt?: string;
+    tools?: Tool[];
+    extraText?: string[];
+    extraValues?: unknown[];
+    extraTokens?: number;
+};
+/**
+ * Estimates total tokens using history records plus heuristic extras.
+ * Expects: history records are ordered; extras include raw strings or values.
+ */
+export declare function contextEstimateTokensWithExtras(history: AgentHistoryRecord[], extras?: ContextEstimateTokensExtras): number;
+//# sourceMappingURL=contextEstimateTokensWithExtras.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contextEstimateTokensWithExtras.d.ts","sourceRoot":"","sources":["../../../../sources/engine/agents/ops/contextEstimateTokensWithExtras.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAOlD,MAAM,MAAM,2BAA2B,GAAG;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,kBAAkB,EAAE,EAC7B,MAAM,GAAE,2BAAgC,GACvC,MAAM,CAKR"}

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

@@ -0,0 +1,95 @@
+import { contextEstimateTokens } from "./contextEstimateTokens.js";
+const SYMBOLS_PER_TOKEN = 4;
+const IMAGE_DATA_PLACEHOLDER = "<image>";
+/**
+ * Estimates total tokens using history records plus heuristic extras.
+ * Expects: history records are ordered; extras include raw strings or values.
+ */
+export function contextEstimateTokensWithExtras(history, extras = {}) {
+    const baseTokens = contextEstimateTokens(history);
+    const extraTokens = normalizeExtraTokens(extras.extraTokens);
+    const extraSymbols = estimateExtrasSymbols(extras);
+    return baseTokens + extraTokens + symbolsToTokens(extraSymbols);
+}
+function estimateExtrasSymbols(extras) {
+    let symbols = 0;
+    if (extras.systemPrompt) {
+        symbols += extras.systemPrompt.length;
+    }
+    if (extras.tools && extras.tools.length > 0) {
+        symbols += safeStringLength(extras.tools);
+    }
+    if (extras.extraText) {
+        for (const text of extras.extraText) {
+            symbols += text.length;
+        }
+    }
+    if (extras.extraValues) {
+        for (const value of extras.extraValues) {
+            symbols += safeStringLength(value);
+        }
+    }
+    return symbols;
+}
+function normalizeExtraTokens(value) {
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+        return 0;
+    }
+    return Math.max(0, Math.floor(value));
+}
+function symbolsToTokens(symbols) {
+    if (symbols <= 0) {
+        return 0;
+    }
+    return Math.ceil(symbols / SYMBOLS_PER_TOKEN);
+}
+function safeStringLength(value) {
+    if (typeof value === "string") {
+        return value.length;
+    }
+    try {
+        const encoded = JSON.stringify(sanitizeImageData(value, 0, new WeakSet()));
+        return encoded ? encoded.length : 0;
+    }
+    catch {
+        return 0;
+    }
+}
+function sanitizeImageData(value, depth, seen) {
+    if (!value || typeof value !== "object") {
+        return value;
+    }
+    if (seen.has(value)) {
+        return null;
+    }
+    if (depth > 6) {
+        return null;
+    }
+    seen.add(value);
+    if (Array.isArray(value)) {
+        return value.map((entry) => sanitizeImageData(entry, depth + 1, seen));
+    }
+    if (isImageLike(value)) {
+        const image = value;
+        return { ...image, data: IMAGE_DATA_PLACEHOLDER };
+    }
+    const record = value;
+    const sanitized = {};
+    for (const [key, entry] of Object.entries(record)) {
+        sanitized[key] = sanitizeImageData(entry, depth + 1, seen);
+    }
+    return sanitized;
+}
+function isImageLike(value) {
+    if (!value || typeof value !== "object") {
+        return false;
+    }
+    const record = value;
+    if (record.type === "image" && typeof record.data === "string") {
+        return true;
+    }
+    return (typeof record.mimeType === "string" &&
+        record.mimeType.startsWith("image/") &&
+        typeof record.data === "string");
+}
+//# sourceMappingURL=contextEstimateTokensWithExtras.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,14 @@
+import { describe, expect, it } from "vitest";
+import { contextEstimateTokensWithExtras } from "./contextEstimateTokensWithExtras.js";
+describe("contextEstimateTokensWithExtras", () => {
+    it("adds heuristic extras to history estimates", () => {
+        const history = [
+            { type: "user_message", at: 1, text: "abcd", files: [] }
+        ];
+        const estimated = contextEstimateTokensWithExtras(history, {
+            systemPrompt: "abcd"
+        });
+        expect(estimated).toBe(2);
+    });
+});
+//# sourceMappingURL=contextEstimateTokensWithExtras.spec.js.map