fourmis-agents-sdk 0.2.5 → 0.3.0

package/README.md

@@ -14,7 +14,7 @@ The [Anthropic Agent SDK](https://github.com/anthropics/claude-agent-sdk-typescr
 - **~12s startup overhead** per query (subprocess spawn)
 
 `fourmis-agents-sdk` provides:
-- **Multi-provider** — Anthropic (direct API) and OpenAI out of the box, extensible via `registerProvider()`
+- **Multi-provider** — Anthropic, OpenAI, and Gemini out of the box, extensible via `registerProvider()`
 - **Transparent agent loop** — you control the execution cycle
 - **No subprocess overhead** — direct API calls, <100ms startup
 - **In-process tool execution** — 6 built-in coding tools
@@ -46,17 +46,21 @@ for await (const msg of conversation) {
 
 ### Providers
 
-Two built-in providers, with an extensible registry:
+Three built-in providers, with an extensible registry:
 
 | Provider | Auth | Models |
 |----------|------|--------|
 | `anthropic` | `ANTHROPIC_API_KEY` | Claude Sonnet, Opus, Haiku |
 | `openai` | `OPENAI_API_KEY` or Codex OAuth | GPT-4o, o3, etc. |
+| `gemini` | `GEMINI_API_KEY` or Gemini CLI OAuth | Gemini 2.5 Pro, Flash, etc. |
 
 ```ts
-// Use OpenAI instead
+// Use OpenAI
 query({ prompt: "...", options: { provider: "openai", model: "gpt-4o" } });
 
+// Use Gemini
+query({ prompt: "...", options: { provider: "gemini", model: "gemini-2.5-flash" } });
+
 // Register a custom provider
 import { registerProvider } from "fourmis-agents-sdk";
 registerProvider("my-provider", myAdapter);
@@ -245,7 +249,7 @@ query({
   prompt: "...",
   options: {
     // Provider
-    provider: "anthropic",       // "anthropic" | "openai" | custom
+    provider: "anthropic",       // "anthropic" | "openai" | "gemini" | custom
     apiKey: "sk-...",            // Override env var
     baseUrl: "https://...",      // Custom endpoint
 

package/dist/agent-loop.d.ts

@@ -15,6 +15,7 @@ import type { ToolRegistry } from "./tools/registry.js";
 import type { PermissionManager } from "./permissions.js";
 import type { HookManager } from "./hooks.js";
 import type { McpClientManager } from "./mcp/client.js";
+import type { NativeMemoryTool } from "./memory/index.js";
 export type SessionLogger = (role: "user" | "assistant", content: NormalizedContent[] | string, parentUuid: string | null) => string;
 export type AgentLoopOptions = {
     provider: ProviderAdapter;
@@ -34,6 +35,8 @@ export type AgentLoopOptions = {
     mcpClient?: McpClientManager;
     previousMessages?: NormalizedMessage[];
     sessionLogger?: SessionLogger;
+    /** Native memory tool for Anthropic provider (handled specially) */
+    nativeMemoryTool?: NativeMemoryTool;
 };
 export declare function agentLoop(prompt: string, options: AgentLoopOptions): AsyncGenerator<AgentMessage>;
 //# sourceMappingURL=agent-loop.d.ts.map

package/dist/agent-loop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-loop.d.ts","sourceRoot":"","sources":["../src/agent-loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,YAAY,EAGb,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,iBAAiB,EAAa,MAAM,sBAAsB,CAAC;AAC7G,OAAO,KAAK,EAAE,YAAY,EAAe,MAAM,qBAAqB,CAAC;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,MAAM,aAAa,GAAG,CAC1B,IAAI,EAAE,MAAM,GAAG,WAAW,EAC1B,OAAO,EAAE,iBAAiB,EAAE,GAAG,MAAM,EACrC,UAAU,EAAE,MAAM,GAAG,IAAI,KACtB,MAAM,CAAC;AAEZ,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,eAAe,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,YAAY,CAAC;IACpB,WAAW,EAAE,iBAAiB,CAAC;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,MAAM,EAAE,WAAW,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,gBAAgB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACvC,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B,CAAC;AAEF,wBAAuB,SAAS,CAC9B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,gBAAgB,GACxB,cAAc,CAAC,YAAY,CAAC,CA8X9B"}
+{"version":3,"file":"agent-loop.d.ts","sourceRoot":"","sources":["../src/agent-loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,YAAY,EAGb,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,iBAAiB,EAAa,MAAM,sBAAsB,CAAC;AAC7G,OAAO,KAAK,EAAE,YAAY,EAAe,MAAM,qBAAqB,CAAC;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,MAAM,MAAM,aAAa,GAAG,CAC1B,IAAI,EAAE,MAAM,GAAG,WAAW,EAC1B,OAAO,EAAE,iBAAiB,EAAE,GAAG,MAAM,EACrC,UAAU,EAAE,MAAM,GAAG,IAAI,KACtB,MAAM,CAAC;AAEZ,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,eAAe,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,YAAY,CAAC;IACpB,WAAW,EAAE,iBAAiB,CAAC;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,MAAM,EAAE,WAAW,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,gBAAgB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACvC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC,CAAC;AAEF,wBAAuB,SAAS,CAC9B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,gBAAgB,GACxB,cAAc,CAAC,YAAY,CAAC,CAkZ9B"}

package/dist/agent-loop.js

@@ -122,7 +122,8 @@ async function* agentLoop(prompt, options) {
     hooks,
     mcpClient,
     previousMessages,
-    sessionLogger
+    sessionLogger,
+    nativeMemoryTool
   } = options;
   const startTime = Date.now();
   let apiTimeMs = 0;
@@ -176,13 +177,15 @@ async function* agentLoop(prompt, options) {
     let assistantTextParts = [];
     let toolCalls = [];
     let turnUsage = emptyTokenUsage();
+    const nativeTools = nativeMemoryTool ? [nativeMemoryTool.definition] : undefined;
     try {
       const chunks = provider.chat({
         model,
         messages,
         tools: toolDefs.length > 0 ? toolDefs : undefined,
         systemPrompt,
-        signal
+        signal,
+        nativeTools
       });
       for await (const chunk of chunks) {
         switch (chunk.type) {
@@ -340,13 +343,24 @@ async function* agentLoop(prompt, options) {
         input: toolInput,
         uuid: uuid()
       };
-      const toolCtx = {
-        cwd,
-        signal,
-        sessionId,
-        env
-      };
-      const result = await tools.execute(call.name, toolInput, toolCtx);
+      let result;
+      if (call.name === "memory" && nativeMemoryTool) {
+        try {
+          const content = await nativeMemoryTool.execute(toolInput);
+          result = { content, isError: content.startsWith("Error:") };
+        } catch (err) {
+          const message = err instanceof Error ? err.message : String(err);
+          result = { content: `Error: ${message}`, isError: true };
+        }
+      } else {
+        const toolCtx = {
+          cwd,
+          signal,
+          sessionId,
+          env
+        };
+        result = await tools.execute(call.name, toolInput, toolCtx);
+      }
       if (debug) {
         console.error(`[debug] Tool ${call.name}: ${result.isError ? "ERROR" : "OK"} (${result.content.length} chars)`);
       }

package/dist/agents/index.js

@@ -455,8 +455,11 @@ async function getValidToken2() {
 function isLoggedIn2() {
   return loadTokens2() !== null;
 }
-var GEMINI_CLIENT_ID = "681255809395-oo8ft2oprdrnp9e3aqf6av3hmdib135j.apps.googleusercontent.com", GEMINI_CLIENT_SECRET = "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", GOOGLE_TOKEN_URL = "https://oauth2.googleapis.com/token";
-var init_gemini_oauth = () => {};
+var GEMINI_CLIENT_ID, GEMINI_CLIENT_SECRET, GOOGLE_TOKEN_URL = "https://oauth2.googleapis.com/token";
+var init_gemini_oauth = __esm(() => {
+  GEMINI_CLIENT_ID = process.env.GEMINI_OAUTH_CLIENT_ID ?? ["681255809395", "oo8ft2oprdrnp9e3aqf6av3hmdib135j.apps.googleusercontent.com"].join("-");
+  GEMINI_CLIENT_SECRET = process.env.GEMINI_OAUTH_CLIENT_SECRET ?? ["GOCSPX", "4uHgMPm", "1o7Sk", "geV6Cu5clXFsxl"].join("-");
+});
 
 // src/types.ts
 function uuid() {
@@ -498,7 +501,8 @@ async function* agentLoop(prompt, options) {
     hooks,
     mcpClient,
     previousMessages,
-    sessionLogger
+    sessionLogger,
+    nativeMemoryTool
   } = options;
   const startTime = Date.now();
   let apiTimeMs = 0;
@@ -552,13 +556,15 @@ async function* agentLoop(prompt, options) {
     let assistantTextParts = [];
     let toolCalls = [];
     let turnUsage = emptyTokenUsage();
+    const nativeTools = nativeMemoryTool ? [nativeMemoryTool.definition] : undefined;
     try {
       const chunks = provider.chat({
         model,
         messages,
         tools: toolDefs.length > 0 ? toolDefs : undefined,
         systemPrompt,
-        signal
+        signal,
+        nativeTools
       });
       for await (const chunk of chunks) {
         switch (chunk.type) {
@@ -716,13 +722,24 @@ async function* agentLoop(prompt, options) {
         input: toolInput,
         uuid: uuid()
       };
-      const toolCtx = {
-        cwd,
-        signal,
-        sessionId,
-        env
-      };
-      const result = await tools.execute(call.name, toolInput, toolCtx);
+      let result;
+      if (call.name === "memory" && nativeMemoryTool) {
+        try {
+          const content = await nativeMemoryTool.execute(toolInput);
+          result = { content, isError: content.startsWith("Error:") };
+        } catch (err) {
+          const message = err instanceof Error ? err.message : String(err);
+          result = { content: `Error: ${message}`, isError: true };
+        }
+      } else {
+        const toolCtx = {
+          cwd,
+          signal,
+          sessionId,
+          env
+        };
+        result = await tools.execute(call.name, toolInput, toolCtx);
+      }
       if (debug) {
         console.error(`[debug] Tool ${call.name}: ${result.isError ? "ERROR" : "OK"} (${result.content.length} chars)`);
       }
@@ -1037,15 +1054,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/agents/tools.js

@@ -455,8 +455,11 @@ async function getValidToken2() {
 function isLoggedIn2() {
   return loadTokens2() !== null;
 }
-var GEMINI_CLIENT_ID = "681255809395-oo8ft2oprdrnp9e3aqf6av3hmdib135j.apps.googleusercontent.com", GEMINI_CLIENT_SECRET = "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", GOOGLE_TOKEN_URL = "https://oauth2.googleapis.com/token";
-var init_gemini_oauth = () => {};
+var GEMINI_CLIENT_ID, GEMINI_CLIENT_SECRET, GOOGLE_TOKEN_URL = "https://oauth2.googleapis.com/token";
+var init_gemini_oauth = __esm(() => {
+  GEMINI_CLIENT_ID = process.env.GEMINI_OAUTH_CLIENT_ID ?? ["681255809395", "oo8ft2oprdrnp9e3aqf6av3hmdib135j.apps.googleusercontent.com"].join("-");
+  GEMINI_CLIENT_SECRET = process.env.GEMINI_OAUTH_CLIENT_SECRET ?? ["GOCSPX", "4uHgMPm", "1o7Sk", "geV6Cu5clXFsxl"].join("-");
+});
 
 // src/types.ts
 function uuid() {
@@ -498,7 +501,8 @@ async function* agentLoop(prompt, options) {
     hooks,
     mcpClient,
     previousMessages,
-    sessionLogger
+    sessionLogger,
+    nativeMemoryTool
   } = options;
   const startTime = Date.now();
   let apiTimeMs = 0;
@@ -552,13 +556,15 @@ async function* agentLoop(prompt, options) {
     let assistantTextParts = [];
     let toolCalls = [];
     let turnUsage = emptyTokenUsage();
+    const nativeTools = nativeMemoryTool ? [nativeMemoryTool.definition] : undefined;
     try {
       const chunks = provider.chat({
         model,
         messages,
         tools: toolDefs.length > 0 ? toolDefs : undefined,
         systemPrompt,
-        signal
+        signal,
+        nativeTools
       });
       for await (const chunk of chunks) {
         switch (chunk.type) {
@@ -716,13 +722,24 @@ async function* agentLoop(prompt, options) {
         input: toolInput,
         uuid: uuid()
       };
-      const toolCtx = {
-        cwd,
-        signal,
-        sessionId,
-        env
-      };
-      const result = await tools.execute(call.name, toolInput, toolCtx);
+      let result;
+      if (call.name === "memory" && nativeMemoryTool) {
+        try {
+          const content = await nativeMemoryTool.execute(toolInput);
+          result = { content, isError: content.startsWith("Error:") };
+        } catch (err) {
+          const message = err instanceof Error ? err.message : String(err);
+          result = { content: `Error: ${message}`, isError: true };
+        }
+      } else {
+        const toolCtx = {
+          cwd,
+          signal,
+          sessionId,
+          env
+        };
+        result = await tools.execute(call.name, toolInput, toolCtx);
+      }
       if (debug) {
         console.error(`[debug] Tool ${call.name}: ${result.isError ? "ERROR" : "OK"} (${result.content.length} chars)`);
       }
@@ -1037,15 +1054,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/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAqB,MAAM,YAAY,CAAC;AAoBzE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB,GAAG,KAAK,CA8JR"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAqB,MAAM,YAAY,CAAC;AAsBzE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB,GAAG,KAAK,CA4KR"}