@librechat/agents 3.4.6 → 3.5.0

package/src/scripts/local_engine_compile.ts

@@ -1,263 +0,0 @@
-/**
- * src/scripts/local_engine_compile.ts
- *
- * Live demonstration of the cheap typecheck integration shipped as
- * an alternative to full LSP:
- *
- *   1. Post-edit syntax check (`local.postEditSyntaxCheck: 'auto'`)
- *      runs `node --check` after every edit_file / write_file on
- *      `.js`/`.mjs` files — the model sees the parse error in the
- *      tool result and self-corrects on the next turn.
- *
- *   2. `compile_check` tool runs the project's standard typecheck
- *      command (auto-detected from project markers, or supplied via
- *      the `command` arg) and surfaces the result.
- *
- * The script seeds a tiny package.json + tsconfig + index.ts in a
- * temp dir, then asks the model to:
- *   (a) `write_file` an intentionally broken `index.js`,
- *   (b) call `compile_check` to see the error,
- *   (c) fix the file via `edit_file`,
- *   (d) call `compile_check` again to confirm green.
- *
- * Run with: `npm run local:compile`
- */
-import { config } from 'dotenv';
-config();
-import { tmpdir } from 'os';
-import { join } from 'path';
-import { mkdtemp, rm, symlink, writeFile } from 'fs/promises';
-import { resolve } from 'path';
-import { HumanMessage, ToolMessage } from '@langchain/core/messages';
-import type { BaseMessage } from '@langchain/core/messages';
-import type * as t from '@/types';
-import { ChatModelStreamHandler, createContentAggregator } from '@/stream';
-import { ToolEndHandler, ModelEndHandler } from '@/events';
-import { getLLMConfig } from '@/utils/llmConfig';
-import { getArgs } from '@/scripts/args';
-import { GraphEvents } from '@/common';
-import { Run } from '@/run';
-
-const conversationHistory: BaseMessage[] = [];
-
-async function main(): Promise<void> {
-  const { userName, provider } = await getArgs();
-  const cwd = await mkdtemp(join(tmpdir(), 'lc-local-compile-'));
-  console.log(`[local_engine_compile] workspace: ${cwd}`);
-
-  // Seed a tiny TypeScript project so `compile_check` can actually
-  // resolve a real toolchain (tsc). We include a healthy index.ts
-  // baseline; the LLM will be asked to add a broken file alongside.
-  await writeFile(
-    join(cwd, 'tsconfig.json'),
-    JSON.stringify(
-      {
-        compilerOptions: {
-          target: 'ES2020',
-          module: 'commonjs',
-          strict: true,
-          noEmit: true,
-          skipLibCheck: true,
-        },
-        include: ['*.ts'],
-      },
-      null,
-      2
-    ),
-    'utf8'
-  );
-  await writeFile(
-    join(cwd, 'index.ts'),
-    'export function add(a: number, b: number): number {\n  return a + b;\n}\n',
-    'utf8'
-  );
-
-  // Make tsc available in the temp workspace by symlinking the
-  // surrounding repo's node_modules. This avoids a slow first-run
-  // npm install while the model waits, and lets `npx --no-install
-  // tsc` resolve typescript instantly. `process.cwd()` is the
-  // package root when running via `npm run`. We fall back
-  // gracefully on platforms where the symlink isn't possible.
-  const repoNodeModules = resolve(process.cwd(), 'node_modules');
-  try {
-    await symlink(repoNodeModules, join(cwd, 'node_modules'), 'dir');
-  } catch (err) {
-    console.warn(
-      '[local_engine_compile] could not symlink node_modules:',
-      (err as Error).message
-    );
-  }
-  await writeFile(
-    join(cwd, 'package.json'),
-    JSON.stringify({ name: 'lc-local-compile-demo', private: true }, null, 2),
-    'utf8'
-  );
-
-  const { aggregateContent } = createContentAggregator();
-  const customHandlers = {
-    [GraphEvents.TOOL_END]: new ToolEndHandler(),
-    [GraphEvents.CHAT_MODEL_END]: new ModelEndHandler(),
-    [GraphEvents.CHAT_MODEL_STREAM]: new ChatModelStreamHandler(),
-    // Forward ON_RUN_STEP so the aggregator's stepMap is seeded
-    // before ON_RUN_STEP_COMPLETED arrives — without this the
-    // aggregator logs "No run step or runId found for completed step
-    // event" once per tool call (issue #142).
-    [GraphEvents.ON_RUN_STEP]: {
-      handle: (event: GraphEvents.ON_RUN_STEP, data: t.StreamEventData): void => {
-        aggregateContent({ event, data: data as t.RunStep });
-      },
-    },
-    [GraphEvents.ON_RUN_STEP_COMPLETED]: {
-      handle: (
-        event: GraphEvents.ON_RUN_STEP_COMPLETED,
-        data: t.StreamEventData
-      ): void => {
-        aggregateContent({
-          event,
-          data: data as unknown as { result: t.ToolEndEvent },
-        });
-      },
-    },
-    [GraphEvents.TOOL_START]: {
-      handle: (_event: string, data: t.StreamEventData): void => {
-        const obj = data as unknown as { name?: string; input?: unknown };
-        const inputStr = JSON.stringify(obj.input);
-        console.log(
-          `====== TOOL_START tool=${obj.name ?? '?'} input=${
-            inputStr.length > 200 ? inputStr.slice(0, 200) + '…' : inputStr
-          } ======`
-        );
-      },
-    },
-  };
-
-  const llmConfig = getLLMConfig(provider);
-
-  const runConfig: t.RunConfig = {
-    runId: 'local-engine-compile-1',
-    graphConfig: {
-      type: 'standard',
-      llmConfig,
-      instructions:
-        `You are ${userName}'s coding assistant. The host has wired a ` +
-        'post-edit syntax check (you will see `[syntax-check warning ...]` blocks ' +
-        'in tool results) and the `compile_check` tool. Use them to verify your ' +
-        'edits. When a syntax check warns you of an error, FIX IT before doing ' +
-        'anything else. Keep responses tight.',
-    },
-    toolExecution: {
-      engine: 'local',
-      local: {
-        cwd,
-        postEditSyntaxCheck: 'auto',
-        timeoutMs: 30_000,
-      },
-    },
-    returnContent: true,
-    skipCleanup: true,
-    customHandlers,
-  };
-  const run = await Run.create<t.IState>(runConfig);
-
-  const streamConfig = {
-    configurable: { provider, thread_id: 'local-engine-compile-thread-1' },
-    streamMode: 'values',
-    version: 'v2' as const,
-  };
-
-  const userMessage = new HumanMessage(
-    `Hi ${userName}. Here's the workflow. The workspace is a tiny TypeScript project (tsconfig.json + index.ts).\n\n` +
-      '1. First, exercise the post-edit syntax check. Use `write_file` to create `broken.js` with EXACTLY this content (it is intentionally broken):\n' +
-      '```\n' +
-      'function broken(a,) {\n' +
-      '  return a +;\n' +
-      '}\n' +
-      '```\n' +
-      '2. After the write, the post-edit syntax check should warn you with `[syntax-check warning ...]`. Read the warning carefully and fix the file via `edit_file` or `write_file`. The smallest valid fix is fine.\n\n' +
-      '3. Now exercise `compile_check`. Use `write_file` to create `broken.ts` with EXACTLY this content (it has a TYPE error, not a syntax error — `tsc` will catch it):\n' +
-      '```\n' +
-      'export const x: number = "not a number";\n' +
-      '```\n' +
-      '4. Call `compile_check` (no args). Anthropic\'s tsc should fail with a type error.\n' +
-      '5. Fix the type error in `broken.ts` (e.g. change the literal to a number) via `edit_file`.\n' +
-      '6. Call `compile_check` again to confirm green.\n\n' +
-      'Tell me what each `compile_check` call reported. Be concise.'
-  );
-  conversationHistory.push(userMessage);
-  console.log('====== USER ======\n' + userMessage.content + '\n');
-
-  await run.processStream({ messages: conversationHistory }, streamConfig);
-  const finalMessages = run.getRunMessages();
-  if (finalMessages) {
-    conversationHistory.push(...finalMessages);
-  }
-
-  let sawSyntaxWarning = false;
-  let compileCheckCalls = 0;
-  let compileCheckFailedAtLeastOnce = false;
-  let compileCheckPassedAtLeastOnce = false;
-  console.log('\n====== TOOL MESSAGES IN HISTORY ======');
-  for (const msg of conversationHistory) {
-    if (msg instanceof ToolMessage) {
-      const content =
-        typeof msg.content === 'string'
-          ? msg.content
-          : JSON.stringify(msg.content);
-      const head = content.slice(0, 240);
-      console.log(`- ${msg.name}: ${head.replace(/\n/g, ' ⏎ ')}`);
-      if (content.includes('[syntax-check')) sawSyntaxWarning = true;
-      if (msg.name === 'compile_check') {
-        compileCheckCalls += 1;
-        if (content.includes('PASSED')) compileCheckPassedAtLeastOnce = true;
-        if (content.includes('FAILED')) compileCheckFailedAtLeastOnce = true;
-      }
-    }
-  }
-
-  console.log('\n====== ASSISTANT FINAL TEXT ======');
-  const lastAssistant = [...conversationHistory]
-    .reverse()
-    .find((m) => m._getType() === 'ai');
-  if (lastAssistant) {
-    const c = lastAssistant.content;
-    console.log(
-      typeof c === 'string'
-        ? c
-        : Array.isArray(c)
-          ? c
-            .map((b) => ('text' in b ? b.text : `<${b.type}>`))
-            .join(' ')
-          : JSON.stringify(c)
-    );
-  }
-
-  console.log('\n====== ASSERTIONS ======');
-  console.log(
-    `post-edit syntax-check warning observed: ${sawSyntaxWarning} ${
-      sawSyntaxWarning ? '✔' : '✖'
-    }`
-  );
-  console.log(
-    `compile_check called ${compileCheckCalls} time(s); FAILED-then-PASSED cycle observed: ${
-      compileCheckFailedAtLeastOnce && compileCheckPassedAtLeastOnce
-    } ${compileCheckFailedAtLeastOnce && compileCheckPassedAtLeastOnce ? '✔' : '✖'}`
-  );
-
-  if (
-    !sawSyntaxWarning ||
-    !(compileCheckFailedAtLeastOnce && compileCheckPassedAtLeastOnce)
-  ) {
-    process.exitCode = 1;
-  }
-  await rm(cwd, { recursive: true, force: true });
-}
-
-process.on('unhandledRejection', (reason) => {
-  console.error('Unhandled Rejection:', reason);
-  process.exit(1);
-});
-
-main().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});

package/src/scripts/local_engine_hooks.ts

@@ -1,226 +0,0 @@
-/**
- * src/scripts/local_engine_hooks.ts
- *
- * Live demonstration that PreToolUse / PostToolUse hooks now fire on
- * the direct-path tools the local engine registers. Wires up:
- *
- *   - a `createToolPolicyHook` that DENIES `write_file` and `edit_file`
- *     while allowing reads, `bash`, and the search tools, and
- *   - an explicit `PostToolUse` hook that prefixes every successful
- *     tool result with a "[reviewed]" tag so you can confirm it ran
- *     against the in-process tools.
- *
- * The script asks the model to (a) write a file, (b) read it back. Step
- * (a) should be blocked with a `Blocked: ...` ToolMessage and a
- * `PermissionDenied` hook fire; step (b) should succeed with the
- * "[reviewed]" prefix injected by `PostToolUse`.
- *
- * Run with: `npm run local:hooks`
- */
-import { config } from 'dotenv';
-config();
-import { tmpdir } from 'os';
-import { join } from 'path';
-import { mkdtemp, rm, writeFile } from 'fs/promises';
-import { HumanMessage } from '@langchain/core/messages';
-import type { BaseMessage } from '@langchain/core/messages';
-import type * as t from '@/types';
-import { ChatModelStreamHandler, createContentAggregator } from '@/stream';
-import { ToolEndHandler, ModelEndHandler } from '@/events';
-import { HookRegistry, createToolPolicyHook } from '@/hooks';
-import type {
-  PostToolUseHookOutput,
-  PermissionDeniedHookOutput,
-} from '@/hooks';
-import { getLLMConfig } from '@/utils/llmConfig';
-import { getArgs } from '@/scripts/args';
-import { GraphEvents } from '@/common';
-import { Run } from '@/run';
-
-const conversationHistory: BaseMessage[] = [];
-
-async function main(): Promise<void> {
-  const { userName, provider } = await getArgs();
-  const cwd = await mkdtemp(join(tmpdir(), 'lc-local-hooks-'));
-  console.log(`[local_engine_hooks] workspace: ${cwd}`);
-
-  // Seed a file so read_file has something interesting to return.
-  await writeFile(
-    join(cwd, 'allowed.txt'),
-    'this is a pre-existing file the agent is allowed to read\n',
-    'utf8'
-  );
-
-  // --- HOOK SETUP ---
-  const denyEvents: { tool: string; reason?: string }[] = [];
-  const reviewedTools = new Set<string>();
-
-  const hookRegistry = new HookRegistry();
-
-  // PreToolUse policy: deny mutations, allow everything else.
-  hookRegistry.register('PreToolUse', {
-    hooks: [
-      createToolPolicyHook({
-        mode: 'bypass',
-        deny: ['write_file', 'edit_file'],
-        reason: 'this script blocks {tool} to demonstrate direct-path hooks',
-      }),
-    ],
-  });
-
-  // PostToolUse: tag successful results so we can see the hook running.
-  hookRegistry.register('PostToolUse', {
-    hooks: [
-      async ({
-        toolName,
-        toolOutput,
-      }): Promise<PostToolUseHookOutput> => {
-        reviewedTools.add(toolName);
-        const text =
-          typeof toolOutput === 'string'
-            ? toolOutput
-            : JSON.stringify(toolOutput);
-        return { updatedOutput: `[reviewed] ${text}` };
-      },
-    ],
-  });
-
-  // PermissionDenied: observational sink so we can prove the hook fired.
-  hookRegistry.register('PermissionDenied', {
-    hooks: [
-      async ({
-        toolName,
-        reason,
-      }): Promise<PermissionDeniedHookOutput> => {
-        denyEvents.push({ tool: toolName, reason });
-        return {};
-      },
-    ],
-  });
-
-  // --- STREAM HANDLERS ---
-  const { contentParts, aggregateContent } = createContentAggregator();
-  const customHandlers = {
-    [GraphEvents.TOOL_END]: new ToolEndHandler(),
-    [GraphEvents.CHAT_MODEL_END]: new ModelEndHandler(),
-    [GraphEvents.CHAT_MODEL_STREAM]: new ChatModelStreamHandler(),
-    // Forward ON_RUN_STEP so the aggregator's stepMap is seeded
-    // before ON_RUN_STEP_COMPLETED arrives (issue #142).
-    [GraphEvents.ON_RUN_STEP]: {
-      handle: (event: GraphEvents.ON_RUN_STEP, data: t.StreamEventData): void => {
-        aggregateContent({ event, data: data as t.RunStep });
-      },
-    },
-    [GraphEvents.ON_RUN_STEP_COMPLETED]: {
-      handle: (
-        event: GraphEvents.ON_RUN_STEP_COMPLETED,
-        data: t.StreamEventData
-      ): void => {
-        const cast = data as unknown as { result: t.ToolEndEvent };
-        const tc = (cast.result as { tool_call?: { name?: string } } | undefined)
-          ?.tool_call;
-        console.log(`====== ON_RUN_STEP_COMPLETED tool=${tc?.name ?? '?'} ======`);
-        aggregateContent({ event, data: cast });
-      },
-    },
-    [GraphEvents.ON_MESSAGE_DELTA]: {
-      handle: (
-        event: GraphEvents.ON_MESSAGE_DELTA,
-        data: t.StreamEventData
-      ): void => {
-        aggregateContent({ event, data: data as t.MessageDeltaEvent });
-      },
-    },
-    [GraphEvents.TOOL_START]: {
-      handle: (_event: string, data: t.StreamEventData): void => {
-        const obj = data as unknown as { name?: string; input?: unknown };
-        console.log(
-          `====== TOOL_START tool=${obj.name ?? '?'} input=${JSON.stringify(
-            obj.input
-          )} ======`
-        );
-      },
-    },
-  };
-
-  const llmConfig = getLLMConfig(provider);
-
-  const runConfig: t.RunConfig = {
-    runId: 'local-engine-hooks-1',
-    graphConfig: {
-      type: 'standard',
-      llmConfig,
-      instructions:
-        'You are a coding assistant. The host has loaded a permissions policy. ' +
-        'When a tool call is denied you will see a ToolMessage starting with ' +
-        '`Blocked:` — DO NOT retry the same denied tool. If a write is denied, ' +
-        'just acknowledge the denial and continue with operations that are allowed.',
-    },
-    toolExecution: {
-      engine: 'local',
-      local: { cwd, timeoutMs: 30_000 },
-    },
-    hooks: hookRegistry,
-    returnContent: true,
-    skipCleanup: true,
-    customHandlers,
-  };
-  const run = await Run.create<t.IState>(runConfig);
-
-  const streamConfig = {
-    configurable: { provider, thread_id: 'local-engine-hooks-thread-1' },
-    streamMode: 'values',
-    version: 'v2' as const,
-  };
-
-  const userMessage = new HumanMessage(
-    `Hi ${userName}. Please do these two things in order:\n\n` +
-      '1. Use `write_file` to create `blocked.txt` with the content "should never land".\n' +
-      '2. Use `read_file` on `allowed.txt` and tell me what is inside.\n\n' +
-      'Then report whether each step succeeded.'
-  );
-  conversationHistory.push(userMessage);
-  console.log('====== USER ======\n' + userMessage.content + '\n');
-
-  await run.processStream({ messages: conversationHistory }, streamConfig);
-  const finalMessages = run.getRunMessages();
-  if (finalMessages) {
-    conversationHistory.push(...finalMessages);
-  }
-
-  console.log('\n====== FINAL CONTENT PARTS ======');
-  console.dir(contentParts, { depth: null });
-
-  console.log('\n====== HOOK OBSERVATIONS ======');
-  console.log(
-    `PermissionDenied fired ${denyEvents.length} time(s):`,
-    denyEvents
-  );
-  console.log(
-    `PostToolUse saw tools: ${[...reviewedTools].join(', ') || '<none>'}`
-  );
-
-  // The deny-target file must NOT exist.
-  const fs = await import('fs/promises');
-  const exists = await fs
-    .stat(join(cwd, 'blocked.txt'))
-    .then(() => true)
-    .catch(() => false);
-  console.log(
-    `blocked.txt landed on disk? ${exists} ${
-      exists ? '(BUG)' : '(expected: false)'
-    }`
-  );
-
-  await rm(cwd, { recursive: true, force: true });
-}
-
-process.on('unhandledRejection', (reason) => {
-  console.error('Unhandled Rejection:', reason);
-  process.exit(1);
-});
-
-main().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});

package/src/scripts/local_engine_image.ts

@@ -1,201 +0,0 @@
-/**
- * src/scripts/local_engine_image.ts
- *
- * Live demo of the local read_file tool returning an image as an
- * inline `MessageContentComplex[]` attachment when
- * `local.attachReadAttachments: 'images-only'` is set. We seed a tiny
- * red square PNG into the workspace, ask the agent to read it, and
- * verify the model receives the image bytes (not just a refusal stub).
- *
- * Best run with a vision-capable provider, e.g.:
- *   npm run local:image -- --provider anthropic
- */
-import { config } from 'dotenv';
-config();
-import { tmpdir } from 'os';
-import { join } from 'path';
-import { copyFile, mkdtemp, rm, writeFile } from 'fs/promises';
-import { HumanMessage, ToolMessage } from '@langchain/core/messages';
-import type { BaseMessage } from '@langchain/core/messages';
-import type * as t from '@/types';
-import { ChatModelStreamHandler, createContentAggregator } from '@/stream';
-import { ToolEndHandler, ModelEndHandler } from '@/events';
-import { getLLMConfig } from '@/utils/llmConfig';
-import { getArgs } from '@/scripts/args';
-import { GraphEvents } from '@/common';
-import { Run } from '@/run';
-
-const conversationHistory: BaseMessage[] = [];
-
-// Canonical 1x1 transparent PNG fallback if the system PNG isn't readable.
-const TINY_PNG_HEX =
-  '89504e470d0a1a0a0000000d49484452000000010000000108060000001f15' +
-  'c4890000000a49444154789c63000100000005000165be7e6e0000000049' +
-  '454e44ae426082';
-
-const SAMPLE_PNG_PATHS = [
-  '/System/Library/CoreServices/Certificate Assistant.app/Contents/Resources/droppedImage.png',
-  '/System/Library/CoreServices/Certificate Assistant.app/Contents/Resources/shapeimage_1.png',
-  '/System/Library/CoreServices/BluetoothUIServer.app/Contents/Resources/handoff.png',
-];
-
-async function main(): Promise<void> {
-  const { userName, provider } = await getArgs();
-  const cwd = await mkdtemp(join(tmpdir(), 'lc-local-image-'));
-  console.log(`[local_engine_image] workspace: ${cwd}`);
-
-  const pngPath = join(cwd, 'sample.png');
-  let copied = false;
-  for (const sample of SAMPLE_PNG_PATHS) {
-    try {
-      await copyFile(sample, pngPath);
-      copied = true;
-      break;
-    } catch {
-      // try next
-    }
-  }
-  if (!copied) {
-    await writeFile(pngPath, Buffer.from(TINY_PNG_HEX, 'hex'));
-  }
-  console.log(`[local_engine_image] wrote ${pngPath} (real-png=${copied})`);
-
-  const { aggregateContent } = createContentAggregator();
-  const customHandlers = {
-    [GraphEvents.TOOL_END]: new ToolEndHandler(),
-    [GraphEvents.CHAT_MODEL_END]: new ModelEndHandler(),
-    [GraphEvents.CHAT_MODEL_STREAM]: new ChatModelStreamHandler(),
-    // Forward ON_RUN_STEP so the aggregator's stepMap is seeded
-    // before ON_RUN_STEP_COMPLETED arrives (issue #142).
-    [GraphEvents.ON_RUN_STEP]: {
-      handle: (event: GraphEvents.ON_RUN_STEP, data: t.StreamEventData): void => {
-        aggregateContent({ event, data: data as t.RunStep });
-      },
-    },
-    [GraphEvents.ON_RUN_STEP_COMPLETED]: {
-      handle: (
-        event: GraphEvents.ON_RUN_STEP_COMPLETED,
-        data: t.StreamEventData
-      ): void => {
-        aggregateContent({
-          event,
-          data: data as unknown as { result: t.ToolEndEvent },
-        });
-      },
-    },
-    [GraphEvents.TOOL_START]: {
-      handle: (_event: string, data: t.StreamEventData): void => {
-        const obj = data as unknown as { name?: string; input?: unknown };
-        console.log(
-          `====== TOOL_START tool=${obj.name ?? '?'} input=${JSON.stringify(
-            obj.input
-          )} ======`
-        );
-      },
-    },
-  };
-
-  const llmConfig = getLLMConfig(provider);
-
-  const runConfig: t.RunConfig = {
-    runId: 'local-engine-image-1',
-    graphConfig: {
-      type: 'standard',
-      llmConfig,
-      instructions:
-        `You are ${userName}'s assistant. When asked to inspect a file, ` +
-        'use `read_file`. The host has enabled inline image attachments, so ' +
-        'reading an image will deliver the actual image bytes to your vision ' +
-        'context. Describe the image you see.',
-    },
-    toolExecution: {
-      engine: 'local',
-      local: {
-        cwd,
-        attachReadAttachments: 'images-only',
-        timeoutMs: 30_000,
-      },
-    },
-    returnContent: true,
-    skipCleanup: true,
-    customHandlers,
-  };
-  const run = await Run.create<t.IState>(runConfig);
-
-  const streamConfig = {
-    configurable: { provider, thread_id: 'local-engine-image-thread-1' },
-    streamMode: 'values',
-    version: 'v2' as const,
-  };
-
-  const userMessage = new HumanMessage(
-    'Please call `read_file` on `sample.png` (in the working directory) and ' +
-      'then briefly describe what the image shows.'
-  );
-  conversationHistory.push(userMessage);
-  console.log('====== USER ======\n' + userMessage.content + '\n');
-
-  await run.processStream({ messages: conversationHistory }, streamConfig);
-  const finalMessages = run.getRunMessages();
-  if (finalMessages) {
-    conversationHistory.push(...finalMessages);
-  }
-
-  console.log('\n====== TOOL MESSAGES IN HISTORY ======');
-  let imageBlockSeen = false;
-  for (const msg of conversationHistory) {
-    if (msg instanceof ToolMessage) {
-      const isArray = Array.isArray(msg.content);
-      const blocks = isArray
-        ? (msg.content as Array<{ type?: string; image_url?: { url?: string } }>)
-        : [];
-      const types = blocks.map((b) => b.type ?? '?').join(',');
-      const url = blocks.find((b) => b.type === 'image_url')?.image_url?.url;
-      console.log(
-        `- ToolMessage(name=${msg.name}, content=${
-          isArray ? `[${types}]` : typeof msg.content
-        }${url ? ` url=${url.slice(0, 40)}…` : ''})`
-      );
-      if (isArray && blocks.some((b) => b.type === 'image_url')) {
-        imageBlockSeen = true;
-      }
-    }
-  }
-  console.log(
-    `\nImage attachment landed in tool result: ${imageBlockSeen} ${
-      imageBlockSeen ? '✔' : '✖'
-    }`
-  );
-
-  console.log('\n====== ASSISTANT FINAL TEXT ======');
-  const lastAssistant = [...conversationHistory]
-    .reverse()
-    .find((m) => m._getType() === 'ai');
-  if (lastAssistant) {
-    const c = lastAssistant.content;
-    console.log(
-      typeof c === 'string'
-        ? c
-        : Array.isArray(c)
-          ? c
-            .map((b) => ('text' in b ? b.text : `<${b.type}>`))
-            .join(' ')
-          : JSON.stringify(c)
-    );
-  }
-
-  if (!imageBlockSeen) {
-    process.exitCode = 1;
-  }
-  await rm(cwd, { recursive: true, force: true });
-}
-
-process.on('unhandledRejection', (reason) => {
-  console.error('Unhandled Rejection:', reason);
-  process.exit(1);
-});
-
-main().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});