fourmis-agents-sdk 0.2.6 → 0.3.0

package/dist/memory/index.js

@@ -0,0 +1,319 @@
+// @bun
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = import.meta.require;
+
+// src/memory/memory-handler.ts
+import { readdir, stat, readFile, writeFile, rm, rename, mkdir } from "fs/promises";
+import { join, resolve, relative } from "path";
+import { existsSync } from "fs";
+function createMemoryHandler(memoryDir) {
+  const absMemoryDir = resolve(memoryDir);
+  function resolvePath(logicalPath) {
+    let cleaned = logicalPath;
+    if (cleaned.startsWith("/memories")) {
+      cleaned = cleaned.slice("/memories".length);
+    }
+    if (cleaned.startsWith("/")) {
+      cleaned = cleaned.slice(1);
+    }
+    if (cleaned.includes("..") || cleaned.includes("%2e") || cleaned.includes("%2E")) {
+      throw new Error(`Path traversal detected: ${logicalPath}`);
+    }
+    const absPath = cleaned === "" ? absMemoryDir : resolve(absMemoryDir, cleaned);
+    const rel = relative(absMemoryDir, absPath);
+    if (rel.startsWith("..") || resolve(absPath) !== absPath && !absPath.startsWith(absMemoryDir)) {
+      throw new Error(`Path traversal detected: ${logicalPath}`);
+    }
+    return absPath;
+  }
+  function toLogicalPath(absPath) {
+    const rel = relative(absMemoryDir, absPath);
+    return rel === "" ? "/memories" : `/memories/${rel}`;
+  }
+  function formatSize(bytes) {
+    if (bytes < 1024)
+      return `${bytes}`;
+    if (bytes < 1024 * 1024)
+      return `${(bytes / 1024).toFixed(1)}K`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)}M`;
+  }
+  async function listDir(dirPath, depth = 0) {
+    const lines = [];
+    const dirStat = await stat(dirPath);
+    if (depth === 0) {
+      lines.push(`${formatSize(dirStat.size)}	${toLogicalPath(dirPath)}`);
+    }
+    if (depth >= 2)
+      return lines;
+    try {
+      const entries = await readdir(dirPath, { withFileTypes: true });
+      for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {
+        if (entry.name.startsWith(".") || entry.name === "node_modules")
+          continue;
+        const entryPath = join(dirPath, entry.name);
+        const entryStat = await stat(entryPath);
+        lines.push(`${formatSize(entryStat.size)}	${toLogicalPath(entryPath)}`);
+        if (entry.isDirectory()) {
+          const subLines = await listDir(entryPath, depth + 1);
+          lines.push(...subLines.slice(depth === 0 ? 0 : 0));
+        }
+      }
+    } catch {}
+    return lines;
+  }
+  function formatFileContent(content, viewRange) {
+    const lines = content.split(`
+`);
+    if (lines.length > 999999) {
+      throw new Error(`File exceeds maximum line limit of 999,999 lines.`);
+    }
+    let start = 0;
+    let end = lines.length;
+    if (viewRange && viewRange.length >= 2) {
+      start = Math.max(0, viewRange[0] - 1);
+      end = Math.min(lines.length, viewRange[1]);
+    }
+    const formatted = [];
+    for (let i = start;i < end; i++) {
+      const lineNum = String(i + 1).padStart(6, " ");
+      formatted.push(`${lineNum}	${lines[i]}`);
+    }
+    return formatted.join(`
+`);
+  }
+  async function handleView(cmd) {
+    const absPath = resolvePath(cmd.path);
+    if (!existsSync(absPath)) {
+      return `The path ${cmd.path} does not exist. Please provide a valid path.`;
+    }
+    const s = await stat(absPath);
+    if (s.isDirectory()) {
+      const lines = await listDir(absPath);
+      return `Here're the files and directories up to 2 levels deep in ${cmd.path}, excluding hidden items and node_modules:
+${lines.join(`
+`)}`;
+    }
+    const content = await readFile(absPath, "utf-8");
+    const formatted = formatFileContent(content, cmd.view_range);
+    return `Here's the content of ${cmd.path} with line numbers:
+${formatted}`;
+  }
+  async function handleCreate(cmd) {
+    const absPath = resolvePath(cmd.path);
+    if (existsSync(absPath)) {
+      return `Error: File ${cmd.path} already exists`;
+    }
+    const parentDir = resolve(absPath, "..");
+    await mkdir(parentDir, { recursive: true });
+    await writeFile(absPath, cmd.file_text, "utf-8");
+    return `File created successfully at: ${cmd.path}`;
+  }
+  async function handleStrReplace(cmd) {
+    const absPath = resolvePath(cmd.path);
+    if (!existsSync(absPath)) {
+      return `Error: The path ${cmd.path} does not exist. Please provide a valid path.`;
+    }
+    const s = await stat(absPath);
+    if (s.isDirectory()) {
+      return `Error: The path ${cmd.path} does not exist. Please provide a valid path.`;
+    }
+    const content = await readFile(absPath, "utf-8");
+    const lines = content.split(`
+`);
+    const matchingLines = [];
+    let searchPos = 0;
+    let occurrences = 0;
+    while (true) {
+      const idx = content.indexOf(cmd.old_str, searchPos);
+      if (idx === -1)
+        break;
+      occurrences++;
+      const lineNum = content.substring(0, idx).split(`
+`).length;
+      matchingLines.push(lineNum);
+      searchPos = idx + cmd.old_str.length;
+    }
+    if (occurrences === 0) {
+      return `No replacement was performed, old_str \`${cmd.old_str}\` did not appear verbatim in ${cmd.path}.`;
+    }
+    if (occurrences > 1) {
+      return `No replacement was performed. Multiple occurrences of old_str \`${cmd.old_str}\` in lines: ${matchingLines.join(", ")}. Please ensure it is unique`;
+    }
+    const newContent = content.replace(cmd.old_str, cmd.new_str);
+    await writeFile(absPath, newContent, "utf-8");
+    const newLines = newContent.split(`
+`);
+    const replaceLine = matchingLines[0];
+    const snippetStart = Math.max(0, replaceLine - 3);
+    const snippetEnd = Math.min(newLines.length, replaceLine + 3);
+    const snippet = newLines.slice(snippetStart, snippetEnd).map((line, i) => `${String(snippetStart + i + 1).padStart(6, " ")}	${line}`).join(`
+`);
+    return `The memory file has been edited.
+${snippet}`;
+  }
+  async function handleInsert(cmd) {
+    const absPath = resolvePath(cmd.path);
+    if (!existsSync(absPath)) {
+      return `Error: The path ${cmd.path} does not exist`;
+    }
+    const s = await stat(absPath);
+    if (s.isDirectory()) {
+      return `Error: The path ${cmd.path} does not exist`;
+    }
+    const content = await readFile(absPath, "utf-8");
+    const lines = content.split(`
+`);
+    if (cmd.insert_line < 0 || cmd.insert_line > lines.length) {
+      return `Error: Invalid \`insert_line\` parameter: ${cmd.insert_line}. It should be within the range of lines of the file: [0, ${lines.length}]`;
+    }
+    const insertLines = cmd.insert_text.split(`
+`);
+    lines.splice(cmd.insert_line, 0, ...insertLines);
+    await writeFile(absPath, lines.join(`
+`), "utf-8");
+    return `The file ${cmd.path} has been edited.`;
+  }
+  async function handleDelete(cmd) {
+    const absPath = resolvePath(cmd.path);
+    if (!existsSync(absPath)) {
+      return `Error: The path ${cmd.path} does not exist`;
+    }
+    await rm(absPath, { recursive: true, force: true });
+    return `Successfully deleted ${cmd.path}`;
+  }
+  async function handleRename(cmd) {
+    const oldAbs = resolvePath(cmd.old_path);
+    const newAbs = resolvePath(cmd.new_path);
+    if (!existsSync(oldAbs)) {
+      return `Error: The path ${cmd.old_path} does not exist`;
+    }
+    if (existsSync(newAbs)) {
+      return `Error: The destination ${cmd.new_path} already exists`;
+    }
+    const parentDir = resolve(newAbs, "..");
+    await mkdir(parentDir, { recursive: true });
+    await rename(oldAbs, newAbs);
+    return `Successfully renamed ${cmd.old_path} to ${cmd.new_path}`;
+  }
+  async function execute(cmd) {
+    if (!existsSync(absMemoryDir)) {
+      await mkdir(absMemoryDir, { recursive: true });
+    }
+    switch (cmd.command) {
+      case "view":
+        return handleView(cmd);
+      case "create":
+        return handleCreate(cmd);
+      case "str_replace":
+        return handleStrReplace(cmd);
+      case "insert":
+        return handleInsert(cmd);
+      case "delete":
+        return handleDelete(cmd);
+      case "rename":
+        return handleRename(cmd);
+      default:
+        return `Error: Unknown command: ${cmd.command}`;
+    }
+  }
+  return { execute, resolvePath, toLogicalPath };
+}
+// src/memory/index.ts
+function createNativeMemoryTool(config) {
+  const handler = createMemoryHandler(config.path);
+  return {
+    definition: { type: "memory_20250818", name: "memory" },
+    execute: (cmd) => handler.execute(cmd)
+  };
+}
+function createMemoryTool(config) {
+  const handler = createMemoryHandler(config.path);
+  return {
+    name: "memory",
+    description: `Manage persistent memory files. Supports 6 commands:
+` + `- view: Show directory listing or file contents (path, optional view_range)
+` + `- create: Create a new file (path, file_text)
+` + `- str_replace: Replace text in a file (path, old_str, new_str)
+` + `- insert: Insert text at a line number (path, insert_line, insert_text)
+` + `- delete: Delete a file or directory (path)
+` + `- rename: Rename/move a file or directory (old_path, new_path)
+
+` + `All paths should start with /memories/. Example: /memories/notes.txt
+
+` + "IMPORTANT: Always view your memory directory before starting any task.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        command: {
+          type: "string",
+          enum: ["view", "create", "str_replace", "insert", "delete", "rename"],
+          description: "The memory operation to perform"
+        },
+        path: {
+          type: "string",
+          description: "Path to the file or directory (starts with /memories/)"
+        },
+        file_text: {
+          type: "string",
+          description: "Content for the 'create' command"
+        },
+        old_str: {
+          type: "string",
+          description: "Text to find for 'str_replace' command"
+        },
+        new_str: {
+          type: "string",
+          description: "Replacement text for 'str_replace' command"
+        },
+        insert_line: {
+          type: "number",
+          description: "Line number for 'insert' command"
+        },
+        insert_text: {
+          type: "string",
+          description: "Text to insert for 'insert' command"
+        },
+        old_path: {
+          type: "string",
+          description: "Source path for 'rename' command"
+        },
+        new_path: {
+          type: "string",
+          description: "Destination path for 'rename' command"
+        },
+        view_range: {
+          type: "array",
+          items: { type: "number" },
+          description: "Optional [start, end] line range for 'view' command"
+        }
+      },
+      required: ["command"]
+    },
+    async execute(input) {
+      try {
+        const cmd = input;
+        const result = await handler.execute(cmd);
+        const isError = result.startsWith("Error:");
+        return { content: result, isError };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: `Error: ${message}`, isError: true };
+      }
+    }
+  };
+}
+export {
+  createNativeMemoryTool,
+  createMemoryTool,
+  createMemoryHandler
+};

package/dist/memory/memory-handler.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Memory handler — file-based memory storage with path traversal protection.
+ *
+ * Implements all 6 memory tool operations:
+ *   - view: Show directory contents or file contents
+ *   - create: Create a new file
+ *   - str_replace: Replace text in a file
+ *   - insert: Insert text at a specific line
+ *   - delete: Delete a file or directory
+ *   - rename: Rename/move a file or directory
+ *
+ * All paths are sandboxed within the configured memory directory.
+ */
+export type MemoryCommand = {
+    command: "view";
+    path: string;
+    view_range?: number[];
+} | {
+    command: "create";
+    path: string;
+    file_text: string;
+} | {
+    command: "str_replace";
+    path: string;
+    old_str: string;
+    new_str: string;
+} | {
+    command: "insert";
+    path: string;
+    insert_line: number;
+    insert_text: string;
+} | {
+    command: "delete";
+    path: string;
+} | {
+    command: "rename";
+    old_path: string;
+    new_path: string;
+};
+/**
+ * Create a memory handler bound to a specific directory.
+ * All operations are sandboxed within this directory.
+ */
+export declare function createMemoryHandler(memoryDir: string): {
+    execute: (cmd: MemoryCommand) => Promise<string>;
+    resolvePath: (logicalPath: string) => string;
+    toLogicalPath: (absPath: string) => string;
+};
+//# sourceMappingURL=memory-handler.d.ts.map

package/dist/memory/memory-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-handler.d.ts","sourceRoot":"","sources":["../../src/memory/memory-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,MAAM,MAAM,aAAa,GACrB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GACxD;IAAE,OAAO,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,OAAO,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC1E;IAAE,OAAO,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC7E;IAAE,OAAO,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,OAAO,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM;mBA0QvB,aAAa,KAAG,OAAO,CAAC,MAAM,CAAC;+BAlQzB,MAAM,KAAG,MAAM;6BA6BjB,MAAM,KAAG,MAAM;EA8PhD"}

package/dist/memory/memory-handler.js

@@ -0,0 +1,233 @@
+// @bun
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = import.meta.require;
+
+// src/memory/memory-handler.ts
+import { readdir, stat, readFile, writeFile, rm, rename, mkdir } from "fs/promises";
+import { join, resolve, relative } from "path";
+import { existsSync } from "fs";
+function createMemoryHandler(memoryDir) {
+  const absMemoryDir = resolve(memoryDir);
+  function resolvePath(logicalPath) {
+    let cleaned = logicalPath;
+    if (cleaned.startsWith("/memories")) {
+      cleaned = cleaned.slice("/memories".length);
+    }
+    if (cleaned.startsWith("/")) {
+      cleaned = cleaned.slice(1);
+    }
+    if (cleaned.includes("..") || cleaned.includes("%2e") || cleaned.includes("%2E")) {
+      throw new Error(`Path traversal detected: ${logicalPath}`);
+    }
+    const absPath = cleaned === "" ? absMemoryDir : resolve(absMemoryDir, cleaned);
+    const rel = relative(absMemoryDir, absPath);
+    if (rel.startsWith("..") || resolve(absPath) !== absPath && !absPath.startsWith(absMemoryDir)) {
+      throw new Error(`Path traversal detected: ${logicalPath}`);
+    }
+    return absPath;
+  }
+  function toLogicalPath(absPath) {
+    const rel = relative(absMemoryDir, absPath);
+    return rel === "" ? "/memories" : `/memories/${rel}`;
+  }
+  function formatSize(bytes) {
+    if (bytes < 1024)
+      return `${bytes}`;
+    if (bytes < 1024 * 1024)
+      return `${(bytes / 1024).toFixed(1)}K`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)}M`;
+  }
+  async function listDir(dirPath, depth = 0) {
+    const lines = [];
+    const dirStat = await stat(dirPath);
+    if (depth === 0) {
+      lines.push(`${formatSize(dirStat.size)}	${toLogicalPath(dirPath)}`);
+    }
+    if (depth >= 2)
+      return lines;
+    try {
+      const entries = await readdir(dirPath, { withFileTypes: true });
+      for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {
+        if (entry.name.startsWith(".") || entry.name === "node_modules")
+          continue;
+        const entryPath = join(dirPath, entry.name);
+        const entryStat = await stat(entryPath);
+        lines.push(`${formatSize(entryStat.size)}	${toLogicalPath(entryPath)}`);
+        if (entry.isDirectory()) {
+          const subLines = await listDir(entryPath, depth + 1);
+          lines.push(...subLines.slice(depth === 0 ? 0 : 0));
+        }
+      }
+    } catch {}
+    return lines;
+  }
+  function formatFileContent(content, viewRange) {
+    const lines = content.split(`
+`);
+    if (lines.length > 999999) {
+      throw new Error(`File exceeds maximum line limit of 999,999 lines.`);
+    }
+    let start = 0;
+    let end = lines.length;
+    if (viewRange && viewRange.length >= 2) {
+      start = Math.max(0, viewRange[0] - 1);
+      end = Math.min(lines.length, viewRange[1]);
+    }
+    const formatted = [];
+    for (let i = start;i < end; i++) {
+      const lineNum = String(i + 1).padStart(6, " ");
+      formatted.push(`${lineNum}	${lines[i]}`);
+    }
+    return formatted.join(`
+`);
+  }
+  async function handleView(cmd) {
+    const absPath = resolvePath(cmd.path);
+    if (!existsSync(absPath)) {
+      return `The path ${cmd.path} does not exist. Please provide a valid path.`;
+    }
+    const s = await stat(absPath);
+    if (s.isDirectory()) {
+      const lines = await listDir(absPath);
+      return `Here're the files and directories up to 2 levels deep in ${cmd.path}, excluding hidden items and node_modules:
+${lines.join(`
+`)}`;
+    }
+    const content = await readFile(absPath, "utf-8");
+    const formatted = formatFileContent(content, cmd.view_range);
+    return `Here's the content of ${cmd.path} with line numbers:
+${formatted}`;
+  }
+  async function handleCreate(cmd) {
+    const absPath = resolvePath(cmd.path);
+    if (existsSync(absPath)) {
+      return `Error: File ${cmd.path} already exists`;
+    }
+    const parentDir = resolve(absPath, "..");
+    await mkdir(parentDir, { recursive: true });
+    await writeFile(absPath, cmd.file_text, "utf-8");
+    return `File created successfully at: ${cmd.path}`;
+  }
+  async function handleStrReplace(cmd) {
+    const absPath = resolvePath(cmd.path);
+    if (!existsSync(absPath)) {
+      return `Error: The path ${cmd.path} does not exist. Please provide a valid path.`;
+    }
+    const s = await stat(absPath);
+    if (s.isDirectory()) {
+      return `Error: The path ${cmd.path} does not exist. Please provide a valid path.`;
+    }
+    const content = await readFile(absPath, "utf-8");
+    const lines = content.split(`
+`);
+    const matchingLines = [];
+    let searchPos = 0;
+    let occurrences = 0;
+    while (true) {
+      const idx = content.indexOf(cmd.old_str, searchPos);
+      if (idx === -1)
+        break;
+      occurrences++;
+      const lineNum = content.substring(0, idx).split(`
+`).length;
+      matchingLines.push(lineNum);
+      searchPos = idx + cmd.old_str.length;
+    }
+    if (occurrences === 0) {
+      return `No replacement was performed, old_str \`${cmd.old_str}\` did not appear verbatim in ${cmd.path}.`;
+    }
+    if (occurrences > 1) {
+      return `No replacement was performed. Multiple occurrences of old_str \`${cmd.old_str}\` in lines: ${matchingLines.join(", ")}. Please ensure it is unique`;
+    }
+    const newContent = content.replace(cmd.old_str, cmd.new_str);
+    await writeFile(absPath, newContent, "utf-8");
+    const newLines = newContent.split(`
+`);
+    const replaceLine = matchingLines[0];
+    const snippetStart = Math.max(0, replaceLine - 3);
+    const snippetEnd = Math.min(newLines.length, replaceLine + 3);
+    const snippet = newLines.slice(snippetStart, snippetEnd).map((line, i) => `${String(snippetStart + i + 1).padStart(6, " ")}	${line}`).join(`
+`);
+    return `The memory file has been edited.
+${snippet}`;
+  }
+  async function handleInsert(cmd) {
+    const absPath = resolvePath(cmd.path);
+    if (!existsSync(absPath)) {
+      return `Error: The path ${cmd.path} does not exist`;
+    }
+    const s = await stat(absPath);
+    if (s.isDirectory()) {
+      return `Error: The path ${cmd.path} does not exist`;
+    }
+    const content = await readFile(absPath, "utf-8");
+    const lines = content.split(`
+`);
+    if (cmd.insert_line < 0 || cmd.insert_line > lines.length) {
+      return `Error: Invalid \`insert_line\` parameter: ${cmd.insert_line}. It should be within the range of lines of the file: [0, ${lines.length}]`;
+    }
+    const insertLines = cmd.insert_text.split(`
+`);
+    lines.splice(cmd.insert_line, 0, ...insertLines);
+    await writeFile(absPath, lines.join(`
+`), "utf-8");
+    return `The file ${cmd.path} has been edited.`;
+  }
+  async function handleDelete(cmd) {
+    const absPath = resolvePath(cmd.path);
+    if (!existsSync(absPath)) {
+      return `Error: The path ${cmd.path} does not exist`;
+    }
+    await rm(absPath, { recursive: true, force: true });
+    return `Successfully deleted ${cmd.path}`;
+  }
+  async function handleRename(cmd) {
+    const oldAbs = resolvePath(cmd.old_path);
+    const newAbs = resolvePath(cmd.new_path);
+    if (!existsSync(oldAbs)) {
+      return `Error: The path ${cmd.old_path} does not exist`;
+    }
+    if (existsSync(newAbs)) {
+      return `Error: The destination ${cmd.new_path} already exists`;
+    }
+    const parentDir = resolve(newAbs, "..");
+    await mkdir(parentDir, { recursive: true });
+    await rename(oldAbs, newAbs);
+    return `Successfully renamed ${cmd.old_path} to ${cmd.new_path}`;
+  }
+  async function execute(cmd) {
+    if (!existsSync(absMemoryDir)) {
+      await mkdir(absMemoryDir, { recursive: true });
+    }
+    switch (cmd.command) {
+      case "view":
+        return handleView(cmd);
+      case "create":
+        return handleCreate(cmd);
+      case "str_replace":
+        return handleStrReplace(cmd);
+      case "insert":
+        return handleInsert(cmd);
+      case "delete":
+        return handleDelete(cmd);
+      case "rename":
+        return handleRename(cmd);
+      default:
+        return `Error: Unknown command: ${cmd.command}`;
+    }
+  }
+  return { execute, resolvePath, toLogicalPath };
+}
+export {
+  createMemoryHandler
+};

package/dist/providers/anthropic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/providers/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,SAAS,EACT,eAAe,EAIhB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAiB9C,qBAAa,gBAAiB,YAAW,eAAe;IACtD,IAAI,SAAe;IACnB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,SAAS,CAAU;gBAEf,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAwBpD,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,CAAC,SAAS,CAAC;IA+H5D,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM;IAIvD,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIvC,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO;IAgBlD,OAAO,CAAC,eAAe;IAiCvB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,aAAa;CActB"}
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/providers/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,SAAS,EACT,eAAe,EAIhB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAiB9C,qBAAa,gBAAiB,YAAW,eAAe;IACtD,IAAI,SAAe;IACnB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,SAAS,CAAU;gBAEf,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAwBpD,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,CAAC,SAAS,CAAC;IAmJ5D,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM;IAIvD,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIvC,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO;IAgBlD,OAAO,CAAC,eAAe;IAiCvB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,aAAa;CActB"}

package/dist/providers/anthropic.js

@@ -278,15 +278,29 @@ class AnthropicAdapter {
     } else if (request.systemPrompt) {
       params.system = request.systemPrompt;
     }
+    const allTools = [];
     if (tools && tools.length > 0) {
-      params.tools = tools;
+      allTools.push(...tools);
+    }
+    if (request.nativeTools && request.nativeTools.length > 0) {
+      allTools.push(...request.nativeTools);
+    }
+    if (allTools.length > 0) {
+      params.tools = allTools;
     }
     if (request.temperature !== undefined) {
       params.temperature = request.temperature;
     }
-    const stream = this.client.messages.stream(params, {
+    const hasMemoryTool = request.nativeTools?.some((t) => t.type === "memory_20250818");
+    const requestOptions = {
       signal: request.signal
-    });
+    };
+    if (hasMemoryTool) {
+      requestOptions.headers = {
+        "anthropic-beta": "context-management-2025-06-27"
+      };
+    }
+    const stream = this.client.messages.stream(params, requestOptions);
     const toolInputBuffers = new Map;
     for await (const event of stream) {
       switch (event.type) {

package/dist/providers/registry.js

@@ -657,15 +657,29 @@ class AnthropicAdapter {
     } else if (request.systemPrompt) {
       params.system = request.systemPrompt;
     }
+    const allTools = [];
     if (tools && tools.length > 0) {
-      params.tools = tools;
+      allTools.push(...tools);
+    }
+    if (request.nativeTools && request.nativeTools.length > 0) {
+      allTools.push(...request.nativeTools);
+    }
+    if (allTools.length > 0) {
+      params.tools = allTools;
     }
     if (request.temperature !== undefined) {
       params.temperature = request.temperature;
     }
-    const stream = this.client.messages.stream(params, {
+    const hasMemoryTool = request.nativeTools?.some((t) => t.type === "memory_20250818");
+    const requestOptions = {
       signal: request.signal
-    });
+    };
+    if (hasMemoryTool) {
+      requestOptions.headers = {
+        "anthropic-beta": "context-management-2025-06-27"
+      };
+    }
+    const stream = this.client.messages.stream(params, requestOptions);
     const toolInputBuffers = new Map;
     for await (const event of stream) {
       switch (event.type) {

package/dist/providers/types.d.ts

@@ -39,6 +39,12 @@ export type ChatRequest = {
     temperature?: number;
     thinkingBudget?: number;
     signal?: AbortSignal;
+    /**
+     * Provider-specific native tools (e.g. Anthropic's memory_20250818).
+     * These bypass the normal tool definition format and are passed directly
+     * to the provider's API alongside converted regular tools.
+     */
+    nativeTools?: unknown[];
 };
 export type StopReason = "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
 export type ChatChunk = {