clementine-agent 1.18.168 → 1.18.169

package/dist/agent/run-agent.d.ts

@@ -111,7 +111,7 @@ export interface RunAgentOptions {
      *  team-task) keep the prompt small. When unset, falls back to
      *  profile.systemPromptBody (legacy single-source behavior). */
     systemPromptAppend?: string;
-    /** Per-run override for the tool-output-guard config (1.18.168).
+    /** Per-run override for the tool-output-guard config (1.18.169).
      *  Defaults come from src/config.ts TOOL_OUTPUT_GUARD (env +
      *  clementine.json). Pass null to disable the guard for this run
      *  (rarely needed — almost always a sign that perTool overrides

package/dist/agent/run-agent.js

@@ -279,7 +279,7 @@ export async function runAgent(prompt, opts) {
         }
     }
     // PRD §6 / 1.18.85: stable run id created before sdkOptions so the
-    // tool-output guard (1.18.168) can namespace its on-disk archive by
+    // tool-output guard (1.18.169) can namespace its on-disk archive by
     // runId. EventLog writers below also reference this id.
     const runId = randomUUID();
     const eventLog = new EventLog();
@@ -294,7 +294,7 @@ export async function runAgent(prompt, opts) {
         }
         catch { /* never block */ }
     };
-    // ── Tool-output guard hooks (1.18.168) ─────────────────────────────
+    // ── Tool-output guard hooks (1.18.169) ─────────────────────────────
     // Bounds the per-tool-call output that reaches the model so SDK
     // auto-compaction never thrashes on a runaway MCP result. The hook
     // ALSO mirrors compression events into the run's EventLog so the Run
@@ -380,7 +380,7 @@ export async function runAgent(prompt, opts) {
         ...(opts.additionalDirectories && opts.additionalDirectories.length > 0
             ? { additionalDirectories: opts.additionalDirectories }
             : {}),
-        // 1.18.168 — install the tool-output guard hooks. SDK types accept
+        // 1.18.169 — install the tool-output guard hooks. SDK types accept
         // `hooks` keyed by HookEvent; the empty object is a no-op when the
         // guard is disabled.
         ...(Object.keys(guard.hooks).length > 0 ? { hooks: guard.hooks } : {}),
@@ -443,7 +443,7 @@ export async function runAgent(prompt, opts) {
             }
             if (message.type === 'assistant') {
                 const am = message;
-                // 1.18.168 — capture this turn's usage so the tool-output guard can
+                // 1.18.169 — capture this turn's usage so the tool-output guard can
                 // adaptively tighten its cap as cumulative context climbs. We sum
                 // input + cache_read + cache_creation because all three count
                 // against the model's window for the NEXT turn. Output_tokens isn't
@@ -631,7 +631,7 @@ export async function runAgent(prompt, opts) {
         totalCostUsd: Number(totalCostUsd.toFixed(4)),
         durationMs: Date.now() - startedAt,
         finalTextChars: finalText.length,
-        // 1.18.168 — tool-output guard summary, surfaced for observability.
+        // 1.18.169 — tool-output guard summary, surfaced for observability.
         // Non-zero `compressed` means the guard kept the SDK from thrashing.
         guard: guard.stats.inspected > 0 ? {
             inspected: guard.stats.inspected,

package/dist/agent/tool-output-guard.d.ts

@@ -141,6 +141,8 @@ export interface GuardHookOptions {
      *  guard calls this once per tool result to adapt the cap. When
      *  absent, ratio is assumed 0 (full soft cap is always used). */
     usageRatio?: () => number;
+    /** Optional archive root override for tests. Defaults to Clementine home. */
+    archiveBaseDir?: string;
 }
 export interface GuardHookHandles {
     /** Hook map suitable for SDK `query({ options: { hooks } })`. */

package/dist/agent/tool-output-guard.js

@@ -184,9 +184,9 @@ function formatBytes(n) {
 /** Persist the full payload so the agent can `Read` it later if needed.
  *  Returns the absolute path, or null on any failure (archive is opt-in
  *  convenience — never blocks compression). */
-function archivePayload(runId, toolUseId, toolName, payload) {
+function archivePayload(baseDir, runId, toolUseId, toolName, payload) {
     try {
-        const dir = join(BASE_DIR, 'tool-archive', runId);
+        const dir = join(baseDir, 'tool-archive', runId);
         mkdirSync(dir, { recursive: true });
         const safeName = toolName.replace(/[^a-zA-Z0-9_-]+/g, '_').slice(0, 80);
         const file = join(dir, `${safeName}__${toolUseId}.json`);
@@ -304,7 +304,7 @@ export function buildGuardHooks(opts) {
         // a real file. We don't fail compression if archive fails — the
         // payload just becomes irretrievable; the model still gets a
         // truncation marker and can re-call the tool.
-        const archivePath = archivePayload(opts.runId, toolUseId, toolName, rawOutput);
+        const archivePath = archivePayload(opts.archiveBaseDir ?? BASE_DIR, opts.runId, toolUseId, toolName, rawOutput);
         const outcome = compressToolOutput(toolName, rawOutput, {
             toolName,
             toolUseId,

package/dist/config/clementine-json.js

@@ -68,7 +68,7 @@ export const clementineJsonSchema = z.object({
         chat: z.number().nonnegative().optional(),
     }).optional(),
     /**
-     * Tool-output context-protection caps (1.18.168).
+     * Tool-output context-protection caps (1.18.169).
      *
      * Every SDK `tool_result` larger than the limit gets compressed in a
      * PostToolUse hook before the model sees it. The full result is archived

package/dist/config.js

@@ -428,7 +428,7 @@ export const TASK_BUDGET_TOKENS = {
     // Interactive chat: off by default — let the user and maxTurns drive it.
     chat: optionalTokenEnv('TASK_BUDGET_CHAT', undefined),
 };
-// ── Tool-output context guard (1.18.168) ─────────────────────────────
+// ── Tool-output context guard (1.18.169) ─────────────────────────────
 // Caps the per-tool-call size that reaches the model's context window.
 // Implements Anthropic's recommended PostToolUse hook pattern to prevent
 // runaway MCP-tool outputs (Outlook inbox dumps, iMessage history,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clementine-agent",
-  "version": "1.18.168",
+  "version": "1.18.169",
   "description": "Clementine — Personal AI Assistant (TypeScript)",
   "type": "module",
   "main": "dist/index.js",