orbitx 0.0.8 → 0.1.0

package/Readme.md

@@ -6,12 +6,9 @@
 npm install orbitx
 ```
 
+## Quick Start
 
-## Quick Start (Templates)
-
-### Simple Agent
-
-The `SimpleAgent` is the fastest way to get an agent running with tools and a chosen AI provider.
+The fastest way to get an agent running is `SimpleAgent` — give it a provider, an instruction, and a list of tools/skills.
 
 ```ts
 import { OllamaProvider, SimpleAgent, GetCurrentTimeTool } from "orbitx";
@@ -21,7 +18,7 @@ const ollamaProvider = new OllamaProvider("gemma3:latest");
 const agent = new SimpleAgent({
   aiProvider: ollamaProvider,
   instruction: "You are a helpful assistant.",
-  tools: [GetCurrentTimeTool],
+  tools: [GetCurrentTimeTool()],
 });
 
 let oldRole: "assistant" | "tool" | undefined;
@@ -32,6 +29,14 @@ agent.run("what is current time?", (chunk) => {
     oldRole = chunk.role;
   }
   process.stdout.write(chunk.content);
+
+  if (chunk.done && chunk.role === "assistant" && chunk.toolCalls?.length) {
+    console.log(chunk.toolCalls);
+  }
+  if (chunk.role === "tool") {
+    console.log({ toolCallId: chunk.toolCallId, toolName: chunk.toolName });
+  }
+
   if (chunk.done) {
     process.stdout.write("\n\n");
     oldRole = undefined;
@@ -39,32 +44,31 @@ agent.run("what is current time?", (chunk) => {
 });
 ```
 
-### Researcher Agent
+All tools and skills passed in are baked into the system prompt once, up front — there's no separate routing/selection step deciding what the model can see turn to turn.
 
-The `ResearcherAgent` is optimized for open-ended research and synthesis tasks.
+### Recovering an agent's state
 
-```ts
-import { OllamaProvider, ResearcherAgent } from "orbitx";
+`getCurrentAgentStates()` returns a plain JSON-serializable snapshot (messages, memory, token counters). Save it wherever you like, and pass it back in as `initData` to resume the exact same agent later — a process restart, a saved session, etc.
 
-const ollamaProvider = new OllamaProvider("gemma3:latest");
-
-const agent = new ResearcherAgent({ aiProvider: ollamaProvider });
+```ts
+import { writeFileSync, existsSync, readFileSync } from "fs";
 
-let oldRole: "assistant" | "tool" | undefined;
+const initData = existsSync("./state.json")
+  ? JSON.parse(readFileSync("./state.json", "utf-8"))
+  : undefined;
 
-agent.run("How artificial intelligence is changing the job market", (chunk) => {
-  if (oldRole !== chunk.role) {
-    process.stdout.write(`\n${chunk.role}: `);
-    oldRole = chunk.role;
-  }
-  process.stdout.write(chunk.content);
-  if (chunk.done) {
-    process.stdout.write("\n\n");
-    oldRole = undefined;
-  }
+const agent = new SimpleAgent({
+  aiProvider: ollamaProvider,
+  instruction: "You are a helpful assistant.",
+  tools: [GetCurrentTimeTool()],
+  ...(initData ? { initData } : {}),
 });
+
+// after any run() call:
+writeFileSync("./state.json", JSON.stringify(agent.getCurrentAgentStates()));
 ```
 
+Old messages are never rewritten once written — the agent only ever appends. When the conversation grows past its memory limit, OrbitX keeps the full history intact on disk (`messagesFull`) and instead resets the model's working context window from a running summary of what it already did, so it can keep going indefinitely without losing the ability to act on what happened earlier.
 
 ## Providers
 
@@ -86,54 +90,121 @@ import { DeepSeekProvider } from "orbitx";
 const deepseekProvider = new DeepSeekProvider("api-key", "deepseek-v4-flash");
 ```
 
-### Creating a Custom Tool
-
-Define your own tools with `MCPTool` to extend an agent's capabilities and integrate with your own ecosystem. also currently we have `ReadFileTool`, `WriteFileTool`, `GetCurrentTimeTool`, `FetchTool`, `WebSearchTool`, `ReadWebPageTool`
-
-⚠️ EXTREMELY IMPORTANT WARNING ABOUT `WriteFileTool` ⚠️
+### Two providers: main + image
 
-🔴 CRITICAL: USE `WriteFileTool` WITH EXTREME CAUTION – THIS TOOL CAN PERMANENTLY OVERWRITE, DELETE, OR CORRUPT EXISTING FILES ON YOUR SYSTEM WITHOUT UNDO CAPABILITY.
+An agent uses exactly two provider roles — `main` (drives the agent loop itself) and `image` (describes image tool output, e.g. screenshots, so the main conversation doesn't have to carry raw image bytes). Pass a single provider to use it for both roles, or an array to split them:
 
 ```ts
-import { MCPTool } from "orbitx";
+import { BaseAgent, DeepSeekProvider, OllamaProvider } from "orbitx";
 
-export const SumTool = new MCPTool({
-  name: "math-sum",
-  description: "get two numbers and sum them",
-  inputs: [
-    {
-      name: "first",
-      type: "number",
-      description: "first number",
-      required: true,
-    },
-    {
-      name: "second",
-      type: "number",
-      description: "second number",
-      required: true,
-    },
+const agent = new BaseAgent({
+  aiProvider: [
+    { type: "main", aiProvider: new DeepSeekProvider("api-key", "deepseek-v4-flash") },
+    { type: "image", aiProvider: new OllamaProvider("llava:latest") },
   ],
-  execute: async (_: string, inputs: Record<string, any>): Promise<any> => {
-    const { first, second } = inputs;
-
-    if (!first || typeof first !== "number") {
-      throw new Error("first must be a number");
-    }
-
-    if (!second || typeof second !== "number") {
-      throw new Error("second must be a number");
-    }
-
-    return {
-      output: first + second,
-    };
-  },
+  instruction: "You are a helpful assistant.",
+  mcpClient,
+  allowedTools: [/* ... */],
 });
 ```
 
-
-### Building from the Base Agent
+## Available Tools
+
+Tools are grouped by domain. Import each group's array (e.g. `FsTools()`) to get every tool in that group at once, or import individual tools by name.
+
+### Filesystem (`FsTools`)
+
+| Tool | Purpose |
+|---|---|
+| `FsReadFileTool` | Read a text file, paging through large files by line. |
+| `FsWriteFileTool` | Write/overwrite a file's full content (creates parent dirs as needed). ⚠️ No undo. |
+| `FsEditFileTool` | Replace a specific line range in an existing file without rewriting the whole thing. |
+| `FsListDirTool` | List a directory's entries, paged by index for large directories. |
+| `FsCreateDirTool` | Create a directory, including missing parents. |
+| `FsDeleteTool` | Permanently delete a file or directory (recursive optional). ⚠️ No undo. |
+| `FsMoveTool` | Move or rename a file or directory. |
+| `FsStatTool` | Check whether a path exists and get its metadata (type, size, modified time). |
+
+### Bash / processes (`BashTools`)
+
+| Tool | Purpose |
+|---|---|
+| `BashRunTool` | Launch a shell command as a background process; returns immediately if it's still running after `waitMs` (e.g. a dev server). |
+| `BashWaitTool` | Wait again on a previously started process and get its latest status/output. |
+| `BashLogsTool` | Read a process's combined stdout/stderr, paged by line. |
+| `BashListTool` | List every process launched so far with its status. |
+| `BashWriteInputTool` | Send text to a running process's stdin (answer an interactive prompt like `(y/n)`). |
+| `BashTerminateTool` | Terminate a running process. |
+
+### Browser (`BrowserTools`)
+
+Drives a real headless browser session.
+
+| Tool | Purpose |
+|---|---|
+| `BrowserCreateSessionTool` | Open a new headless browser session at a URL, returns its `sessionId`. |
+| `BrowserRemoveSessionTool` | Close and remove a browser session. |
+| `BrowserGetSessionsTool` | List all currently open session ids. |
+| `BrowserNavigateTool` | Navigate an existing session to a new URL. |
+| `BrowserReadTool` | Read the page as a text outline (headings, tables, links, forms), assigning ref ids to clickable/fillable elements. |
+| `BrowserClickTool` | Click a `[CLICKABLE]` element by ref id. |
+| `BrowserFillTool` | Type into a `[FILLABLE]` element by ref id; can submit via Enter if the field's form has no visible submit button. |
+| `BrowserSubmitFormTool` | Submit a `[FORM]` ref directly — for forms with no visible submit button. |
+| `BrowserScrollInfoTool` | Get total scrollable length and current scroll position. |
+| `BrowserScrollTool` | Scroll to a given vertical pixel position. |
+| `BrowserConsoleTool` | Read captured browser console log messages. |
+| `BrowserNetworkTool` | Read captured network request/response activity. |
+| `BrowserNetworkStatusTool` | Check whether the page currently has in-flight network activity (use before assuming a "no response yet" state means something broke). |
+| `BrowserInjectTool` | Evaluate arbitrary JS in the page and return the result. |
+| `BrowserScreenshotTool` | Capture a screenshot; can be described by the `image` provider instead of passed raw to the main model. |
+
+### Todo lists (`TodoTools`)
+
+| Tool | Purpose |
+|---|---|
+| `TodoCreateListTool` | Create a new todo list, returns its `todoListId`. |
+| `TodoRemoveListTool` | Remove one or more todo lists (and their tasks). |
+| `TodoGetListsTool` | Get all existing todo list ids. |
+| `TodoGetListTool` | Get all tasks belonging to a list. |
+| `TodoCreateTaskTool` | Create one or more tasks inside a list. |
+| `TodoRemoveTaskTool` | Remove one or more tasks by id. |
+| `TodoCheckTaskTool` | Set the checked/unchecked state of one or more tasks. |
+
+### Present / deliverables (`PresentTools`)
+
+| Tool | Purpose |
+|---|---|
+| `PresentAddTool` | Present a file to the user by copying it into the present folder (zip folders first — this only accepts single files). |
+| `PresentClearTool` | Clear out every file currently presented. |
+| `PresentGetListTool` | Get the list of files currently presented. |
+
+### Utility (`UtilTools`)
+
+| Tool | Purpose |
+|---|---|
+| `GetCurrentTimeTool` | Get the current date/time (ISO string, unix timestamp, timezone). |
+| `DelayTool` | Wait a given number of milliseconds (max 60000ms) before continuing. |
+
+## Available Skills
+
+A `Skill` bundles instructions with the tools that go with them. Passing a skill into an agent adds its tools automatically and folds its instructions into the system prompt.
+
+| Skill | Purpose |
+|---|---|
+| `PlannerSkill` | Stands up a persistent, checkable todo list for any large/multi-step/vague job so progress survives long conversations and context resets. |
+| `BigTaskSkill` | Keeps the agent from stopping short on large or ambitious jobs — no declaring victory on a partial slice, no handing a big job back half-finished. |
+| `LongTaskEfficiencySkill` | Keeps a long job efficient — batching, avoiding redundant reads, checkpointing, not gold-plating — without giving up on getting through the full scope. |
+| `NodeBackendSkill` | Building, running, and debugging Node.js backends: APIs, servers, CLIs, workers, schedulers, DB access layers — new or existing. |
+| `ReactFrontendSkill` | Building, running, and debugging modern React (`.tsx`/`.jsx`) projects, typically Vite-scaffolded — new or existing. |
+| `UiUxDesignSkill` | Visual and interaction design quality for any user-facing UI — layout, hierarchy, feedback states, accessibility, responsiveness. |
+| `BackendSecuritySkill` | Hardening server-side code that touches auth, sessions, tokens, uploads, DB queries, payments, or any trust boundary. |
+| `CodeVerificationSkill` | Running the right type checker/build/lint/test suite before handing code back, and telling real bugs apart from sandbox artifacts. |
+| `WebEndToEndTestSkill` | Testing a live web app like a real user would (fill, click, navigate) and verifying via the rendered page, console, and network — not by reading source and assuming. |
+| `ResearchSkill` | Answering questions that need real, current information from the live web — opens pages, cross-checks multiple sources, never trusts one page. |
+| `ShoppingSkill` | Purchase-decision help — real current listings, prices, links, and review sentiment instead of recommending from memory. |
+| `PresentSkill` | Deciding how to hand back a job's output as files (individually or zipped) and cleaning build artifacts out first. |
+
+## Building from the Base Agent
 
 For full control over the MCP server, connection, and client, compose an agent from the base primitives:
 
@@ -152,7 +223,7 @@ const ollamaProvider = new OllamaProvider("gemma3:latest");
 const connection = new MCPConnection();
 
 const mcpServer = new MCPServer(connection);
-mcpServer.registerTool(GetCurrentTimeTool);
+mcpServer.registerTool(GetCurrentTimeTool());
 
 const mcpClient = new MCPClient("DEFAULT_ENV", connection);
 
@@ -160,7 +231,7 @@ const agent = new BaseAgent({
   aiProvider: ollamaProvider,
   instruction: "",
   mcpClient,
-  allowedTools: [GetCurrentTimeTool],
+  allowedTools: [GetCurrentTimeTool()],
 });
 
 let oldRole: "assistant" | "tool" | undefined;
@@ -190,4 +261,93 @@ const path =
   os.platform() === "win32" ? `\\\\.\\pipe\\mcp_test` : `/tmp/mcp_test.sock`;
 
 const ipcConnection = new MCPIPCConnection(path);
-```
+```
+
+## Creating a Custom Tool
+
+Define your own tools with `MCPTool` to extend an agent's capabilities and integrate with your own ecosystem.
+
+⚠️ EXTREMELY IMPORTANT WARNING ABOUT `FsWriteFileTool` / `FsDeleteTool` ⚠️
+
+🔴 CRITICAL: USE FILE-WRITING/DELETING TOOLS WITH EXTREME CAUTION – THEY CAN PERMANENTLY OVERWRITE, DELETE, OR CORRUPT EXISTING FILES ON YOUR SYSTEM WITHOUT UNDO CAPABILITY.
+
+```ts
+import { MCPTool } from "orbitx";
+
+export const SumTool = () => new MCPTool({
+  name: "math-sum",
+  description: "get two numbers and sum them",
+  inputs: [
+    {
+      name: "first",
+      type: "number",
+      description: "first number",
+      required: true,
+    },
+    {
+      name: "second",
+      type: "number",
+      description: "second number",
+      required: true,
+    },
+  ],
+  execute: async (_envID: string, inputs: Record<string, any>) => {
+    const { first, second } = inputs;
+
+    if (typeof first !== "number") {
+      throw new Error("first must be a number");
+    }
+    if (typeof second !== "number") {
+      throw new Error("second must be a number");
+    }
+
+    return { output: first + second };
+  },
+});
+```
+
+Use it like any built-in tool:
+
+```ts
+const agent = new SimpleAgent({
+  aiProvider: ollamaProvider,
+  instruction: "You are a helpful assistant.",
+  tools: [SumTool()],
+});
+```
+
+## Creating a Custom Skill
+
+A `Skill` bundles instructions with the tools it needs, so an agent that includes it automatically gets both.
+
+```ts
+import { Skill, FsReadFileTool, FsWriteFileTool } from "orbitx";
+import { SumTool } from "./sum-tool.js";
+
+export const MathHelperSkill = () => new Skill({
+  name: "math-helper",
+  description:
+    "Use this skill whenever the user asks for arithmetic that should be computed exactly " +
+    "rather than estimated from the model's own reasoning — sums, running totals, or " +
+    "anything written to a file afterward.",
+  instructions: `
+- Always use the math-sum tool for addition instead of computing it yourself.
+- If asked to save a result, write it to disk with fs-write-file and confirm the path back to the user.
+  `,
+  tools: [
+    SumTool(),
+    FsReadFileTool(),
+    FsWriteFileTool(),
+  ],
+});
+```
+
+```ts
+const agent = new SimpleAgent({
+  aiProvider: ollamaProvider,
+  instruction: "You are a helpful assistant.",
+  skills: [MathHelperSkill()],
+});
+```
+
+

package/dist/core/agent-providers.d.ts

@@ -0,0 +1,16 @@
+import type { AIProvider } from "./ai-provider.js";
+export type AgentProviderRole = "main" | "image";
+export interface AgentProviderEntry {
+    aiProvider: AIProvider;
+    type: AgentProviderRole;
+}
+export type AgentProvidersInput = AIProvider | AgentProviderEntry[];
+export interface ResolvedAgentProviders {
+    main: AIProvider;
+    /** Present only if a provider was assigned the "image" role, or (single-provider case) the one provider supports images. */
+    image?: AIProvider;
+}
+/** Only two provider roles exist: "main" (the agent loop itself) and "image" (describing/handling image tool output). There is no separate "utils" provider — all skills and tools are always included in the system prompt from the start, so there's nothing left for a utils pass to decide. */
+export declare function resolveAgentProviders(input: AgentProvidersInput): ResolvedAgentProviders;
+export default resolveAgentProviders;
+//# sourceMappingURL=agent-providers.d.ts.map

package/dist/core/agent-providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-providers.d.ts","sourceRoot":"","sources":["../../src/core/agent-providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IAC/B,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,EAAE,iBAAiB,CAAC;CAC3B;AAED,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,kBAAkB,EAAE,CAAC;AAEpE,MAAM,WAAW,sBAAsB;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB,4HAA4H;IAC5H,KAAK,CAAC,EAAE,UAAU,CAAC;CACtB;AAED,mSAAmS;AACnS,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,mBAAmB,GAAG,sBAAsB,CAoBxF;AAED,eAAe,qBAAqB,CAAC"}

package/dist/core/agent-providers.js

@@ -0,0 +1,21 @@
+/** Only two provider roles exist: "main" (the agent loop itself) and "image" (describing/handling image tool output). There is no separate "utils" provider — all skills and tools are always included in the system prompt from the start, so there's nothing left for a utils pass to decide. */
+export function resolveAgentProviders(input) {
+    if (!Array.isArray(input)) {
+        const caps = input.getCapabilities();
+        return {
+            main: input,
+            image: caps.supportsImages ? input : undefined,
+        };
+    }
+    const mainEntry = input.find(e => e.type === "main");
+    if (!mainEntry) {
+        throw new Error("resolveAgentProviders: a provider with type \"main\" is required when passing an array of providers.");
+    }
+    const imageEntry = input.find(e => e.type === "image");
+    return {
+        main: mainEntry.aiProvider,
+        image: imageEntry?.aiProvider,
+    };
+}
+export default resolveAgentProviders;
+//# sourceMappingURL=agent-providers.js.map

package/dist/core/agent-providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-providers.js","sourceRoot":"","sources":["../../src/core/agent-providers.ts"],"names":[],"mappings":"AAiBA,mSAAmS;AACnS,MAAM,UAAU,qBAAqB,CAAC,KAA0B;IAC5D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,eAAe,EAAE,CAAC;QACrC,OAAO;YACH,IAAI,EAAE,KAAK;YACX,KAAK,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;SACjD,CAAC;IACN,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IACrD,IAAI,CAAC,SAAS,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,sGAAsG,CAAC,CAAC;IAC5H,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;IAEvD,OAAO;QACH,IAAI,EAAE,SAAS,CAAC,UAAU;QAC1B,KAAK,EAAE,UAAU,EAAE,UAAU;KAChC,CAAC;AACN,CAAC;AAED,eAAe,qBAAqB,CAAC"}

package/dist/core/ai-provider.d.ts

@@ -1,19 +1,87 @@
+/**
+ * Standard, provider-agnostic tool schema. Every AIProvider is responsible
+ * for translating this into whatever shape its own API expects (OpenAI-style
+ * `tools: [{type:"function", function:{...}}]`, Ollama's function-calling
+ * format, etc.) — the rest of the codebase (BaseAgent, MCPClient) never needs
+ * to know about a specific provider's wire format.
+ */
+export interface ToolSchema {
+    name: string;
+    description: string;
+    inputs: {
+        name: string;
+        type: "number" | "string" | "boolean" | "object" | "array";
+        description: string;
+        required?: boolean;
+        default?: any;
+    }[];
+}
+/** A tool call the model asked to make, normalized across providers. */
+export interface ToolCallRequest {
+    id: string;
+    name: string;
+    inputs: Record<string, any>;
+}
+/** A single piece of message content: plain text, or an image for multimodal providers. */
+export type MessageContentPart = {
+    type: "text";
+    text: string;
+} | {
+    type: "image";
+    image: string;
+    mimeType?: string;
+};
 export interface Message {
     role: "user" | "system" | "assistant" | "tool";
     content?: string;
+    /** Optional richer content (e.g. images) for providers that support multimodal input. If present, takes precedence over `content` for those providers; providers without image support should fall back to `content`/a text-only projection. */
+    parts?: MessageContentPart[];
+    /** Present on assistant messages that requested native tool calls. */
+    toolCalls?: ToolCallRequest[];
+    /** Present on tool-role messages responding to a native tool call. */
+    toolCallId?: string;
+    /** Present on tool-role messages responding to a native tool call — the tool name being answered. */
+    toolName?: string;
 }
 export interface ChatResponse {
     content: string;
     inputTokens: number;
     outputTokens: number;
+    /** Native tool calls requested by the model, when the provider supports native tool-calling and tools were supplied. */
+    toolCalls?: ToolCallRequest[];
 }
 export type StreamCallback = (chunk: {
     role: "assistant" | "tool";
     content: string;
     done: boolean;
+    /** Present on the final ("done") assistant chunk when the model requested native tool calls this turn. */
+    toolCalls?: ToolCallRequest[];
+    /** Present on "tool"-role chunks — the id of the native tool call this result answers. */
+    toolCallId?: string;
+    /** Present on "tool"-role chunks — the name of the tool that was called. */
+    toolName?: string;
 }) => void;
+/**
+ * Static capability + limits description for a provider/model pair. This
+ * lets callers (BaseAgent in particular) make decisions — like whether to
+ * rely on native tool-calling vs. the legacy JSON-in-text convention, or
+ * where to trigger a memory-compaction pass — based on what the provider
+ * actually supports, instead of a single hardcoded constant.
+ */
+export interface ProviderCapabilities {
+    /** Whether this provider/model can receive a `tools` schema and return native tool_calls. When false, BaseAgent falls back to legacy JSON-in-text tool calls carried over `system`-role messages. */
+    supportsTools: boolean;
+    /** Whether this provider/model accepts image content in messages. */
+    supportsImages: boolean;
+    /** The model's total context window, in tokens. Used to derive a safe default for when to trigger a memory-compaction event, without needing a hardcoded per-agent constant. */
+    contextWindow: number;
+    /** Fraction of the context window (0-1) that's safe to fill before compacting; leaves headroom for the system prompt, tool schema, and the model's own output. Defaults applied by callers if not specified. */
+    safeUsageRatio?: number;
+}
 export declare abstract class AIProvider {
-    abstract chat(messages: Message[], streamCallback?: StreamCallback): Promise<ChatResponse>;
+    abstract chat(messages: Message[], streamCallback?: StreamCallback, tools?: ToolSchema[]): Promise<ChatResponse>;
+    /** Describe what this provider/model can do — used by BaseAgent to pick the native-tools vs. legacy-JSON path and to size the memory-compaction threshold. */
+    abstract getCapabilities(): ProviderCapabilities;
 }
 export default AIProvider;
 //# sourceMappingURL=ai-provider.d.ts.map

package/dist/core/ai-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-provider.d.ts","sourceRoot":"","sources":["../../src/core/ai-provider.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACpB,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE;IACjC,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;CACjB,KAAK,IAAI,CAAC;AAEX,8BAAsB,UAAU;IAC5B,QAAQ,CAAC,IAAI,CACT,QAAQ,EAAE,OAAO,EAAE,EACnB,cAAc,CAAC,EAAE,cAAc,GAChC,OAAO,CAAC,YAAY,CAAC;CAC3B;AAED,eAAe,UAAU,CAAC"}
+{"version":3,"file":"ai-provider.d.ts","sourceRoot":"","sources":["../../src/core/ai-provider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;QAC3D,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,OAAO,CAAC,EAAE,GAAG,CAAC;KACjB,EAAE,CAAC;CACP;AAED,wEAAwE;AACxE,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAED,2FAA2F;AAC3F,MAAM,MAAM,kBAAkB,GACxB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAwC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjG,MAAM,WAAW,OAAO;IACpB,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gPAAgP;IAChP,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC7B,sEAAsE;IACtE,SAAS,CAAC,EAAE,eAAe,EAAE,CAAC;IAC9B,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qGAAqG;IACrG,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,wHAAwH;IACxH,SAAS,CAAC,EAAE,eAAe,EAAE,CAAC;CACjC;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE;IACjC,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,0GAA0G;IAC1G,SAAS,CAAC,EAAE,eAAe,EAAE,CAAC;IAC9B,0FAA0F;IAC1F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,KAAK,IAAI,CAAC;AAEX;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACjC,qMAAqM;IACrM,aAAa,EAAE,OAAO,CAAC;IACvB,qEAAqE;IACrE,cAAc,EAAE,OAAO,CAAC;IACxB,gLAAgL;IAChL,aAAa,EAAE,MAAM,CAAC;IACtB,gNAAgN;IAChN,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,8BAAsB,UAAU;IAC5B,QAAQ,CAAC,IAAI,CACT,QAAQ,EAAE,OAAO,EAAE,EACnB,cAAc,CAAC,EAAE,cAAc,EAC/B,KAAK,CAAC,EAAE,UAAU,EAAE,GACrB,OAAO,CAAC,YAAY,CAAC;IAExB,8JAA8J;IAC9J,QAAQ,CAAC,eAAe,IAAI,oBAAoB;CACnD;AAED,eAAe,UAAU,CAAC"}

package/dist/core/ai-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai-provider.js","sourceRoot":"","sources":["../../src/core/ai-provider.ts"],"names":[],"mappings":"AAiBA,MAAM,OAAgB,UAAU;CAK/B;AAED,eAAe,UAAU,CAAC"}
+{"version":3,"file":"ai-provider.js","sourceRoot":"","sources":["../../src/core/ai-provider.ts"],"names":[],"mappings":"AAkFA,MAAM,OAAgB,UAAU;CAS/B;AAED,eAAe,UAAU,CAAC"}

package/dist/core/base-agent.d.ts

@@ -1,7 +1,8 @@
-import type { AIProvider, Message, StreamCallback } from "./ai-provider.js";
+import type { Message, StreamCallback } from "./ai-provider.js";
 import type MCPClient from "./mcp-client.js";
 import type MCPTool from "./mcp.js";
 import type Skill from "./skill.js";
+import { type AgentProvidersInput } from "./agent-providers.js";
 export interface ParsedToolCall {
     id: string;
     tool: string;
@@ -16,12 +17,13 @@ export type ExtractedSegment = {
 };
 export declare class BaseAgent {
     #private;
-    constructor({ instruction, allowedTools, aiProvider, mcpClient, initData, skills, maxMemorizeToken }: {
+    constructor({ instruction, allowedTools, aiProvider, mcpClient, initData, skills, maxMemorizeToken, }: {
         instruction: string;
-        allowedTools: MCPTool[];
-        aiProvider: AIProvider;
+        allowedTools: MCPTool<any>[];
+        aiProvider: AgentProvidersInput;
         mcpClient: MCPClient;
         skills?: Skill[];
+        /** If omitted, derived from the main provider's reported context window (via getCapabilities()) instead of a hardcoded constant, so the memory-compaction trigger point scales with whatever model is actually in use. */
         maxMemorizeToken?: number;
         initData?: {
             memory: string;
@@ -35,7 +37,9 @@ export declare class BaseAgent {
             currentOutputTokens: number;
         };
     });
+    stop(): Promise<void>;
     run(prompt: string, streamCallback?: StreamCallback): Promise<void>;
+    /** Full recoverable snapshot of agent state — pass this back in as `initData` on a fresh BaseAgent instance (e.g. after a process restart) to resume exactly where this one left off. Persist the return value to disk (or wherever) whenever you want a recovery point. */
     getCurrentAgentStates(): {
         memory: string;
         messagesFull: Message[];

package/dist/core/base-agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-agent.d.ts","sourceRoot":"","sources":["../../src/core/base-agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,OAAO,MAAM,UAAU,CAAC;AACpC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AAEpC,MAAM,WAAW,cAAc;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAED,MAAM,MAAM,gBAAgB,GACtB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAAE,CAAC;AAEhD,qBAAa,SAAS;;gBAwBN,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,QAU/D,EAAE,MAAW,EAAE,gBAAwB,EAAE,EAAE;QACxC,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,OAAO,EAAE,CAAC;QACxB,UAAU,EAAE,UAAU,CAAC;QACvB,SAAS,EAAE,SAAS,CAAC;QACrB,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;QACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,EAAE;YACP,MAAM,EAAE,MAAM,CAAC;YACf,YAAY,EAAE,OAAO,EAAE,CAAC;YACxB,mBAAmB,EAAE,MAAM,CAAC;YAC5B,kBAAkB,EAAE,MAAM,CAAC;YAC3B,gBAAgB,EAAE,MAAM,CAAC;YACzB,eAAe,EAAE,OAAO,EAAE,CAAC;YAC3B,sBAAsB,EAAE,MAAM,CAAC;YAC/B,qBAAqB,EAAE,MAAM,CAAC;YAC9B,mBAAmB,EAAE,MAAM,CAAC;SAC/B,CAAA;KACJ;IAoJK,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA8DzE,qBAAqB;;;;;;;;;;;IAarB,cAAc;;;;;;IASd,qBAAqB;;;;;;IASrB,kBAAkB;;;;;;CAQrB;AAED,eAAe,SAAS,CAAC"}
+{"version":3,"file":"base-agent.d.ts","sourceRoot":"","sources":["../../src/core/base-agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,OAAO,EAAE,cAAc,EAA+B,MAAM,kBAAkB,CAAC;AACzG,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,OAAO,MAAM,UAAU,CAAC;AACpC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AAGpC,OAAO,EAAyB,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEvF,MAAM,WAAW,cAAc;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAED,MAAM,MAAM,gBAAgB,GACtB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAAE,CAAC;AAWhD,qBAAa,SAAS;;gBAkCN,EACR,WAAW,EACX,YAAY,EACZ,UAAU,EACV,SAAS,EACT,QAUC,EACD,MAAW,EACX,gBAAgB,GACnB,EAAE;QACC,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,UAAU,EAAE,mBAAmB,CAAC;QAChC,SAAS,EAAE,SAAS,CAAC;QACrB,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;QACjB,0NAA0N;QAC1N,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,EAAE;YACP,MAAM,EAAE,MAAM,CAAC;YACf,YAAY,EAAE,OAAO,EAAE,CAAC;YACxB,mBAAmB,EAAE,MAAM,CAAC;YAC5B,kBAAkB,EAAE,MAAM,CAAC;YAC3B,gBAAgB,EAAE,MAAM,CAAC;YACzB,eAAe,EAAE,OAAO,EAAE,CAAC;YAC3B,sBAAsB,EAAE,MAAM,CAAC;YAC/B,qBAAqB,EAAE,MAAM,CAAC;YAC9B,mBAAmB,EAAE,MAAM,CAAC;SAC/B,CAAA;KACJ;IA6LK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBrB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA+IzE,4QAA4Q;IAC5Q,qBAAqB;;;;;;;;;;;IAarB,cAAc;;;;;;IASd,qBAAqB;;;;;;IASrB,kBAAkB;;;;;;CAQrB;AAED,eAAe,SAAS,CAAC"}