@arki-moe/agent-ts 2.2.2 → 3.0.0

package/README.md

@@ -53,8 +53,7 @@ When `apiKey` is not provided in config, adapters read from the corresponding en
 - `Agent(adapterName, config)` - Create Agent
 - `agent.context` - Public property, complete conversation history
 - `agent.registerTool(tool)` - Register tool
-- `agent.run(message)` - Execute tool chain automatically, returns all new `Message[]`
-- `agent.fork()` - Create a new agent with a copied context
+- `agent.run(message, options?)` - Execute tool chain automatically, returns all new `Message[]`
 
 ### Config
 
@@ -68,25 +67,10 @@ When `apiKey` is not provided in config, adapters read from the corresponding en
 | `onToolCall` | `(message, args) => boolean \| void \| Promise<boolean \| void>` | Called before each tool execution; return `false` to skip tool execution and `onToolResult` |
 | `onToolResult` | `(message) => void \| Promise<void>` | Called after each tool execution (`message.role === Role.ToolResult`) |
 
-`agent.run` always appends new messages to `agent.context`. Multiple tool calls in a single model response are executed in parallel.
+`agent.run` always appends new messages to `agent.context`. Set `options.once = true` to avoid persisting the user message (useful for one-shot hints). Multiple tool calls in a single model response are executed in parallel.
 
 `onToolCall` receives parsed JSON args and can mutate them before execution. Returning `false` skips the tool call and does not emit a `ToolResult` message.
 
-`agent.fork()` shallow-copies the context array, but message objects are shared. This means:
-- Shallow copy: `forked.context !== agent.context`, so pushing new messages does not affect the other agent.
-- Shared messages: modifying a message object in one context will be visible in the other.
-
-Example:
-
-```ts
-const forked = agent.fork();
-forked.context.push({ role: Role.User, content: "hi" });
-// agent.context length is unchanged
-
-forked.context[0].content = "changed";
-// agent.context[0].content is also "changed" because messages are shared
-```
-
 ## Scripts
 
 | Command | Description |

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import type { AgentConfig, Context, Message, Tool } from "./types";
+import type { AgentConfig, Context, Message, RunOptions, Tool } from "./types";
 export { openaiAdapter } from "./adapter/openai";
 export { openrouterAdapter } from "./adapter/openrouter";
-export type { Adapter, AgentConfig, Context, Message, Tool } from "./types";
+export type { Adapter, AgentConfig, Context, Message, RunOptions, Tool } from "./types";
 export { Role } from "./types";
 export declare class Agent {
     context: Context;
@@ -14,6 +14,5 @@ export declare class Agent {
     private onToolResult?;
     constructor(adapterName: string, config: AgentConfig);
     registerTool(tool: Tool): void;
-    run(message: string): Promise<Message[]>;
-    fork(): Agent;
+    run(message: string, options?: RunOptions): Promise<Message[]>;
 }

package/dist/index.js

@@ -28,15 +28,31 @@ class Agent {
     registerTool(tool) {
         this.tools.push(tool);
     }
-    async run(message) {
-        this.context.push({ role: types_1.Role.User, content: message });
+    async run(message, options = {}) {
+        const once = options.once ?? false;
         const all = [];
-        let msgs = await this.adapter(this.config, this.context, this.tools);
-        this.context.push(...msgs);
-        all.push(...msgs);
+        const sessionContext = [...this.context];
+        const persistToContext = (msgs) => {
+            this.context.push(...msgs);
+        };
+        const pushToSession = (msgs) => {
+            sessionContext.push(...msgs);
+        };
+        const userMessage = { role: types_1.Role.User, content: message };
+        pushToSession([userMessage]);
+        if (!once)
+            persistToContext([userMessage]);
+        const runAdapter = async () => {
+            const msgs = await this.adapter(this.config, sessionContext, this.tools);
+            pushToSession(msgs);
+            persistToContext(msgs);
+            all.push(...msgs);
+            return msgs;
+        };
+        let msgs = await runAdapter();
         for (;;) {
             const last = msgs[msgs.length - 1];
-            if (this.endCondition(this.context, last))
+            if (this.endCondition(sessionContext, last))
                 return all;
             const toolCalls = msgs.filter((m) => m.role === types_1.Role.ToolCall);
             if (toolCalls.length === 0)
@@ -81,19 +97,11 @@ class Agent {
                 return result;
             }));
             const filteredResults = results.filter((result) => result !== null);
-            this.context.push(...filteredResults);
+            pushToSession(filteredResults);
+            persistToContext(filteredResults);
             all.push(...filteredResults);
-            msgs = await this.adapter(this.config, this.context, this.tools);
-            this.context.push(...msgs);
-            all.push(...msgs);
+            msgs = await runAdapter();
         }
     }
-    fork() {
-        const agent = new Agent(this.adapterName, this.config);
-        agent.adapter = this.adapter;
-        agent.tools = [...this.tools];
-        agent.context = [...this.context];
-        return agent;
-    }
 }
 exports.Agent = Agent;

package/dist/types.d.ts

@@ -43,4 +43,7 @@ export type AgentConfig = {
     }>) => void | Promise<void>;
     [key: string]: unknown;
 };
+export type RunOptions = {
+    once?: boolean;
+};
 export type Adapter = (config: Record<string, unknown>, context: Message[], tools: Tool[]) => Promise<Message[]>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arki-moe/agent-ts",
-  "version": "2.2.2",
+  "version": "3.0.0",
   "description": "Minimal Agent library, zero dependencies",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",