@arki-moe/agent-ts 4.0.0 → 5.0.0

package/README.md

@@ -13,6 +13,7 @@ const getTimeTool: Tool = {
   name: "get_time",
   description: "Get the current time in ISO format",
   parameters: { type: "object", properties: {} },
+  data: { category: "time" },
   execute: (_args, _agent) => new Date().toISOString(),
 };
 
@@ -54,7 +55,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, options?)` - Execute tool chain automatically, returns all new `Message[]`
+- `agent.run(message)` - Execute tool chain automatically, returns all new `Message[]`
 
 ### Config
 
@@ -68,10 +69,12 @@ When `apiKey` is not provided in config, adapters read from the corresponding en
 | `onToolCall` | `(message, args, agent) => boolean \| void \| Promise<boolean \| void>` | Called before each tool execution; return `false` to skip tool execution and `onToolResult` |
 | `onToolResult` | `(message, agent) => void \| Promise<void>` | Called after each tool execution (`message.role === Role.ToolResult`) |
 
-`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.
+`agent.run` always appends new messages to `agent.context`. 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.
 
+`tool.data` is a local JSON metadata bag for your own use and is not sent to adapters.
+
 ## Scripts
 
 | Command | Description |

package/dist/index.d.ts

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

package/dist/index.js

@@ -28,8 +28,7 @@ class Agent {
     registerTool(tool) {
         this.tools.push(tool);
     }
-    async run(message, options = {}) {
-        const once = options.once ?? false;
+    async run(message) {
         const all = [];
         const sessionContext = [...this.context];
         const persistToContext = (msgs) => {
@@ -40,8 +39,7 @@ class Agent {
         };
         const userMessage = { role: types_1.Role.User, content: message };
         pushToSession([userMessage]);
-        if (!once)
-            persistToContext([userMessage]);
+        persistToContext([userMessage]);
         const runAdapter = async () => {
             const msgs = await this.adapter(this.config, sessionContext, this.tools);
             pushToSession(msgs);

package/dist/types.d.ts

@@ -29,12 +29,13 @@ export type Context = Message[];
 export interface AgentLike {
     context: Context;
     registerTool: (tool: Tool) => void;
-    run: (message: string, options?: RunOptions) => Promise<Message[]>;
+    run: (message: string) => Promise<Message[]>;
 }
 export type Tool = {
     name: string;
     description: string;
     parameters: unknown;
+    data?: Record<string, unknown>;
     execute: (args: unknown, agent: AgentLike) => Promise<unknown> | unknown;
 };
 export type AgentConfig = {
@@ -48,7 +49,4 @@ export type AgentConfig = {
     }>, agent: AgentLike) => 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": "4.0.0",
+  "version": "5.0.0",
   "description": "Minimal Agent library, zero dependencies",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",