@easynet/agent-tool-hub 1.0.7 → 1.0.9

package/dist/ToolRegistry-wObXj92k.d.cts

@@ -0,0 +1,196 @@
+/**
+ * Budget constraints for a tool invocation.
+ */
+interface BudgetConfig {
+    timeoutMs?: number;
+    maxRetries?: number;
+    maxToolCalls?: number;
+}
+/**
+ * Execution context passed from agent-orchestra.
+ * Contains permissions, budget, and observability context.
+ */
+interface ExecContext {
+    requestId: string;
+    taskId: string;
+    /** Allowed capabilities for this invocation */
+    permissions: Capability[];
+    budget?: BudgetConfig;
+    /** OpenTelemetry-compatible trace ID */
+    traceId?: string;
+    userId?: string;
+    /** Optional: enable dry-run mode for two-phase commit */
+    dryRun?: boolean;
+}
+/**
+ * Tool invocation intent from agent-orchestra.
+ * Represents what the agent wants to do (untrusted input).
+ */
+interface ToolIntent {
+    /** ToolSpec.name reference */
+    tool: string;
+    /** Untrusted input arguments */
+    args: unknown;
+    /** Human-readable purpose for audit trail */
+    purpose: string;
+    /** Idempotency key: recommended format requestId:taskId:tool */
+    idempotencyKey?: string;
+}
+
+/**
+ * Unified tool kinds supported by the tools package.
+ */
+type ToolKind = "mcp" | "langchain" | "n8n" | "comfyui" | "skill" | "core";
+/**
+ * Capability declarations for tools.
+ * Used by PolicyEngine for permission gating.
+ */
+type Capability = "read:web" | "read:fs" | "write:fs" | "read:db" | "write:db" | "network" | "gpu" | "workflow" | "danger:destructive";
+/**
+ * Cost hints for tools, used by Budget and routing.
+ */
+interface CostHints {
+    latencyMsP50?: number;
+    latencyMsP95?: number;
+    isAsync?: boolean;
+}
+/**
+ * Unified tool specification.
+ * All tool types (MCP, LangChain, n8n, ComfyUI, SKILL) are described by this interface.
+ */
+interface ToolSpec {
+    /** Globally unique name, recommended format: namespace/name */
+    name: string;
+    /** Semver version */
+    version: string;
+    /** Tool kind determines which adapter handles execution */
+    kind: ToolKind;
+    description?: string;
+    tags?: string[];
+    /** JSON Schema for input validation */
+    inputSchema: object;
+    /** JSON Schema for output validation */
+    outputSchema: object;
+    /** Required capabilities for this tool */
+    capabilities: Capability[];
+    costHints?: CostHints;
+    /** Adapter-specific: endpoint URL (MCP/n8n/ComfyUI) */
+    endpoint?: string;
+    /** Adapter-specific: resource identifier (workflowId, promptId, etc.) */
+    resourceId?: string;
+    /** Adapter-specific: implementation reference (LangChain Tool instance, skill handler) */
+    impl?: unknown;
+}
+/**
+ * Unified adapter interface.
+ * Each protocol adapter (MCP, LangChain, n8n, ComfyUI, SKILL) implements this.
+ */
+interface ToolAdapter {
+    kind: ToolKind;
+    /** Optional: supports dynamic tool discovery */
+    listTools?(): Promise<ToolSpec[]>;
+    /** Execute the tool with validated args */
+    invoke(spec: ToolSpec, args: unknown, ctx: ExecContext): Promise<{
+        result: unknown;
+        raw?: unknown;
+    }>;
+}
+
+/**
+ * Evidence attached to a tool result for audit trail.
+ */
+interface Evidence {
+    type: "tool" | "file" | "url" | "text" | "metric";
+    ref: string;
+    summary: string;
+    createdAt: string;
+}
+/**
+ * Error information in a tool result.
+ */
+interface ToolError {
+    kind?: "TOOL_NOT_FOUND" | "INPUT_SCHEMA_INVALID" | "POLICY_DENIED" | "BUDGET_EXCEEDED" | "TIMEOUT" | "UPSTREAM_ERROR" | "OUTPUT_SCHEMA_INVALID" | "PATH_OUTSIDE_SANDBOX" | "FILE_TOO_LARGE" | "HTTP_DISALLOWED_HOST" | "HTTP_TIMEOUT" | "HTTP_TOO_LARGE";
+    message: string;
+    details?: unknown;
+}
+/**
+ * Unified tool result returned to agent-orchestra.
+ * Always structured, never throws raw exceptions.
+ */
+interface ToolResult {
+    ok: boolean;
+    result?: unknown;
+    evidence: Evidence[];
+    error?: ToolError;
+    /** Raw response for debugging (can be disabled in production) */
+    raw?: unknown;
+}
+
+/**
+ * Search query for tools.
+ */
+interface ToolSearchQuery {
+    /** Text search in name/description/tags */
+    text?: string;
+    /** Filter by tool kind */
+    kind?: ToolKind;
+    /** Filter by required capabilities */
+    capabilities?: Capability[];
+    /** Filter by tags */
+    tags?: string[];
+}
+/**
+ * Tool Registry: manages tool registration, lookup, and search.
+ * Supports both static registration and dynamic discovery via adapters.
+ */
+declare class ToolRegistry {
+    private readonly tools;
+    private readonly tagIndex;
+    private readonly kindIndex;
+    /**
+     * Register a single tool spec.
+     * Overwrites if same name already exists.
+     */
+    register(spec: ToolSpec): void;
+    /**
+     * Register multiple tool specs at once.
+     */
+    bulkRegister(specs: ToolSpec[]): void;
+    /**
+     * Unregister a tool by name.
+     */
+    unregister(name: string): boolean;
+    /**
+     * Get a tool spec by name.
+     */
+    get(name: string): ToolSpec | undefined;
+    /**
+     * Check if a tool exists.
+     */
+    has(name: string): boolean;
+    /**
+     * Search tools by query.
+     */
+    search(query: ToolSearchQuery): ToolSpec[];
+    /**
+     * List all registered tool names.
+     */
+    list(): string[];
+    /**
+     * Get count of registered tools.
+     */
+    get size(): number;
+    /**
+     * Export a snapshot of all registered tools (for debugging/routing).
+     */
+    snapshot(): ToolSpec[];
+    /**
+     * Clear all registered tools.
+     */
+    clear(): void;
+    private validateSpec;
+    private indexTool;
+    private deindexTool;
+}
+
+export { type BudgetConfig as B, type Capability as C, type Evidence as E, type ToolError as T, type ToolSpec as a, type ExecContext as b, ToolRegistry as c, type ToolAdapter as d, type ToolIntent as e, type ToolResult as f, type ToolKind as g, type CostHints as h, type ToolSearchQuery as i };

package/dist/ToolRegistry-wObXj92k.d.ts

@@ -0,0 +1,196 @@
+/**
+ * Budget constraints for a tool invocation.
+ */
+interface BudgetConfig {
+    timeoutMs?: number;
+    maxRetries?: number;
+    maxToolCalls?: number;
+}
+/**
+ * Execution context passed from agent-orchestra.
+ * Contains permissions, budget, and observability context.
+ */
+interface ExecContext {
+    requestId: string;
+    taskId: string;
+    /** Allowed capabilities for this invocation */
+    permissions: Capability[];
+    budget?: BudgetConfig;
+    /** OpenTelemetry-compatible trace ID */
+    traceId?: string;
+    userId?: string;
+    /** Optional: enable dry-run mode for two-phase commit */
+    dryRun?: boolean;
+}
+/**
+ * Tool invocation intent from agent-orchestra.
+ * Represents what the agent wants to do (untrusted input).
+ */
+interface ToolIntent {
+    /** ToolSpec.name reference */
+    tool: string;
+    /** Untrusted input arguments */
+    args: unknown;
+    /** Human-readable purpose for audit trail */
+    purpose: string;
+    /** Idempotency key: recommended format requestId:taskId:tool */
+    idempotencyKey?: string;
+}
+
+/**
+ * Unified tool kinds supported by the tools package.
+ */
+type ToolKind = "mcp" | "langchain" | "n8n" | "comfyui" | "skill" | "core";
+/**
+ * Capability declarations for tools.
+ * Used by PolicyEngine for permission gating.
+ */
+type Capability = "read:web" | "read:fs" | "write:fs" | "read:db" | "write:db" | "network" | "gpu" | "workflow" | "danger:destructive";
+/**
+ * Cost hints for tools, used by Budget and routing.
+ */
+interface CostHints {
+    latencyMsP50?: number;
+    latencyMsP95?: number;
+    isAsync?: boolean;
+}
+/**
+ * Unified tool specification.
+ * All tool types (MCP, LangChain, n8n, ComfyUI, SKILL) are described by this interface.
+ */
+interface ToolSpec {
+    /** Globally unique name, recommended format: namespace/name */
+    name: string;
+    /** Semver version */
+    version: string;
+    /** Tool kind determines which adapter handles execution */
+    kind: ToolKind;
+    description?: string;
+    tags?: string[];
+    /** JSON Schema for input validation */
+    inputSchema: object;
+    /** JSON Schema for output validation */
+    outputSchema: object;
+    /** Required capabilities for this tool */
+    capabilities: Capability[];
+    costHints?: CostHints;
+    /** Adapter-specific: endpoint URL (MCP/n8n/ComfyUI) */
+    endpoint?: string;
+    /** Adapter-specific: resource identifier (workflowId, promptId, etc.) */
+    resourceId?: string;
+    /** Adapter-specific: implementation reference (LangChain Tool instance, skill handler) */
+    impl?: unknown;
+}
+/**
+ * Unified adapter interface.
+ * Each protocol adapter (MCP, LangChain, n8n, ComfyUI, SKILL) implements this.
+ */
+interface ToolAdapter {
+    kind: ToolKind;
+    /** Optional: supports dynamic tool discovery */
+    listTools?(): Promise<ToolSpec[]>;
+    /** Execute the tool with validated args */
+    invoke(spec: ToolSpec, args: unknown, ctx: ExecContext): Promise<{
+        result: unknown;
+        raw?: unknown;
+    }>;
+}
+
+/**
+ * Evidence attached to a tool result for audit trail.
+ */
+interface Evidence {
+    type: "tool" | "file" | "url" | "text" | "metric";
+    ref: string;
+    summary: string;
+    createdAt: string;
+}
+/**
+ * Error information in a tool result.
+ */
+interface ToolError {
+    kind?: "TOOL_NOT_FOUND" | "INPUT_SCHEMA_INVALID" | "POLICY_DENIED" | "BUDGET_EXCEEDED" | "TIMEOUT" | "UPSTREAM_ERROR" | "OUTPUT_SCHEMA_INVALID" | "PATH_OUTSIDE_SANDBOX" | "FILE_TOO_LARGE" | "HTTP_DISALLOWED_HOST" | "HTTP_TIMEOUT" | "HTTP_TOO_LARGE";
+    message: string;
+    details?: unknown;
+}
+/**
+ * Unified tool result returned to agent-orchestra.
+ * Always structured, never throws raw exceptions.
+ */
+interface ToolResult {
+    ok: boolean;
+    result?: unknown;
+    evidence: Evidence[];
+    error?: ToolError;
+    /** Raw response for debugging (can be disabled in production) */
+    raw?: unknown;
+}
+
+/**
+ * Search query for tools.
+ */
+interface ToolSearchQuery {
+    /** Text search in name/description/tags */
+    text?: string;
+    /** Filter by tool kind */
+    kind?: ToolKind;
+    /** Filter by required capabilities */
+    capabilities?: Capability[];
+    /** Filter by tags */
+    tags?: string[];
+}
+/**
+ * Tool Registry: manages tool registration, lookup, and search.
+ * Supports both static registration and dynamic discovery via adapters.
+ */
+declare class ToolRegistry {
+    private readonly tools;
+    private readonly tagIndex;
+    private readonly kindIndex;
+    /**
+     * Register a single tool spec.
+     * Overwrites if same name already exists.
+     */
+    register(spec: ToolSpec): void;
+    /**
+     * Register multiple tool specs at once.
+     */
+    bulkRegister(specs: ToolSpec[]): void;
+    /**
+     * Unregister a tool by name.
+     */
+    unregister(name: string): boolean;
+    /**
+     * Get a tool spec by name.
+     */
+    get(name: string): ToolSpec | undefined;
+    /**
+     * Check if a tool exists.
+     */
+    has(name: string): boolean;
+    /**
+     * Search tools by query.
+     */
+    search(query: ToolSearchQuery): ToolSpec[];
+    /**
+     * List all registered tool names.
+     */
+    list(): string[];
+    /**
+     * Get count of registered tools.
+     */
+    get size(): number;
+    /**
+     * Export a snapshot of all registered tools (for debugging/routing).
+     */
+    snapshot(): ToolSpec[];
+    /**
+     * Clear all registered tools.
+     */
+    clear(): void;
+    private validateSpec;
+    private indexTool;
+    private deindexTool;
+}
+
+export { type BudgetConfig as B, type Capability as C, type Evidence as E, type ToolError as T, type ToolSpec as a, type ExecContext as b, ToolRegistry as c, type ToolAdapter as d, type ToolIntent as e, type ToolResult as f, type ToolKind as g, type CostHints as h, type ToolSearchQuery as i };

package/dist/chunk-GBNFC46A.js

@@ -0,0 +1,147 @@
+// src/llm/OpenAICompatibleClient.ts
+var DEFAULT_TIMEOUT_MS = 6e4;
+function createOpenAICompatibleClient(baseUrl, model, apiKey) {
+  return new OpenAICompatibleClient({ baseUrl, model, apiKey });
+}
+var OpenAICompatibleClient = class {
+  baseUrl;
+  model;
+  apiKey;
+  constructor(config) {
+    this.baseUrl = config.baseUrl.replace(/\/$/, "");
+    this.model = config.model;
+    this.apiKey = config.apiKey;
+  }
+  async chat(messages, options) {
+    const timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const raw = await this.request(
+      {
+        model: this.model,
+        messages: messages.map((m) => ({ role: m.role, content: m.content }))
+      },
+      timeoutMs
+    );
+    const choices = raw.choices;
+    const content = Array.isArray(choices) && choices[0]?.message?.content != null ? String(choices[0].message.content) : "";
+    return { content, raw };
+  }
+  async chatWithTools(messages, tools, options) {
+    const timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const raw = await this.request(
+      {
+        model: this.model,
+        messages: messages.map((m) => this.serializeMessage(m)),
+        tools
+      },
+      timeoutMs
+    );
+    const choices = raw.choices;
+    const msg = Array.isArray(choices) ? choices[0]?.message : void 0;
+    return {
+      message: {
+        role: "assistant",
+        content: msg?.content ?? null,
+        tool_calls: msg?.tool_calls
+      },
+      raw
+    };
+  }
+  buildHeaders() {
+    const headers = {
+      "Content-Type": "application/json"
+    };
+    if (this.apiKey) headers["Authorization"] = `Bearer ${this.apiKey}`;
+    return headers;
+  }
+  serializeMessage(m) {
+    if (m.role === "tool")
+      return { role: "tool", content: m.content, tool_call_id: m.tool_call_id };
+    if (m.role === "assistant" && "tool_calls" in m && m.tool_calls?.length)
+      return { role: "assistant", content: m.content ?? null, tool_calls: m.tool_calls };
+    return { role: m.role, content: m.content };
+  }
+  async request(body, timeoutMs) {
+    const url = `${this.baseUrl}/chat/completions`;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    let response;
+    try {
+      response = await fetch(url, {
+        method: "POST",
+        headers: this.buildHeaders(),
+        body: JSON.stringify(body),
+        signal: controller.signal
+      });
+    } catch (err) {
+      clearTimeout(timer);
+      if (err instanceof Error && err.name === "AbortError")
+        throw new Error(`LLM request timed out after ${timeoutMs}ms`);
+      throw err;
+    }
+    clearTimeout(timer);
+    const raw = await response.json();
+    if (!response.ok) {
+      const errBody = typeof raw === "object" && raw !== null && "error" in raw ? raw.error : raw;
+      throw new Error(
+        `LLM API error ${response.status}: ${JSON.stringify(errBody)}`
+      );
+    }
+    return raw;
+  }
+};
+
+// src/llm/ReActAgent.ts
+var DEFAULT_PROMPT = "ReAct: Thought (reason) \u2192 Action (use tool or answer) \u2192 Observation (tool result). Repeat until you give the final answer. Same language as user.";
+var ReActAgent = class {
+  constructor(llm, toolHub) {
+    this.llm = llm;
+    this.toolHub = toolHub;
+  }
+  async run(instruction, options = {}) {
+    const maxSteps = options.maxSteps ?? 10;
+    const tools = this.getTools();
+    const messages = [
+      { role: "system", content: options.systemPrompt ?? DEFAULT_PROMPT },
+      { role: "user", content: instruction }
+    ];
+    let steps = 0;
+    let lastContent = "";
+    while (steps < maxSteps) {
+      const { message } = await this.llm.chatWithTools(
+        messages,
+        tools,
+        options.timeoutMs ? { timeoutMs: options.timeoutMs } : void 0
+      );
+      steps++;
+      messages.push({ ...message, role: "assistant" });
+      if (message.content) lastContent = message.content;
+      if (!message.tool_calls?.length)
+        return { content: lastContent, steps };
+      for (const tc of message.tool_calls) {
+        const args = this.parseArgs(tc.function.arguments);
+        const result = await this.toolHub.invokeTool(tc.function.name, args);
+        const content = result.ok ? JSON.stringify(result.result) : JSON.stringify({ ok: false, error: result.error?.message ?? "Tool failed" });
+        messages.push({ role: "tool", content: `Observation: ${content}`, tool_call_id: tc.id });
+      }
+    }
+    return { content: lastContent || "Reached max steps.", steps };
+  }
+  getTools() {
+    return this.toolHub.getRegistry().snapshot().map((s) => ({
+      type: "function",
+      function: { name: s.name, description: s.description ?? "", parameters: s.inputSchema }
+    }));
+  }
+  parseArgs(json) {
+    if (!json) return {};
+    try {
+      return JSON.parse(json);
+    } catch {
+      return {};
+    }
+  }
+};
+
+export { OpenAICompatibleClient, ReActAgent, createOpenAICompatibleClient };
+//# sourceMappingURL=chunk-GBNFC46A.js.map
+//# sourceMappingURL=chunk-GBNFC46A.js.map

package/dist/chunk-GBNFC46A.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/llm/OpenAICompatibleClient.ts","../src/llm/ReActAgent.ts"],"names":[],"mappings":"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","file":"chunk-GBNFC46A.js","sourcesContent":["/**\n * Minimal client for OpenAI-compatible chat completions API.\n * Use createOpenAICompatibleClient(baseUrl, model, apiKey?) and then .chat(messages) or .chatWithTools(messages, tools).\n */\n\nexport interface ChatMessage {\n  role: \"system\" | \"user\" | \"assistant\";\n  content: string;\n}\n\nexport interface ChatOptions {\n  /** Request timeout in milliseconds. Default 60000. */\n  timeoutMs?: number;\n}\n\nexport interface ChatResult {\n  content: string;\n  raw: unknown;\n}\n\nexport interface OpenAIToolDefinition {\n  type: \"function\";\n  function: {\n    name: string;\n    description?: string;\n    parameters?: object;\n  };\n}\n\nexport interface AssistantMessageWithToolCalls {\n  role: \"assistant\";\n  content?: string | null;\n  tool_calls?: Array<{\n    id: string;\n    type: \"function\";\n    function: { name: string; arguments: string };\n  }>;\n}\n\nexport interface ChatWithToolsResult {\n  message: AssistantMessageWithToolCalls;\n  raw: unknown;\n}\n\nexport interface OpenAICompatibleClientConfig {\n  baseUrl: string;\n  model: string;\n  apiKey?: string;\n}\n\nconst DEFAULT_TIMEOUT_MS = 60_000;\n\nexport function createOpenAICompatibleClient(\n  baseUrl: string,\n  model: string,\n  apiKey?: string\n): OpenAICompatibleClient {\n  return new OpenAICompatibleClient({ baseUrl, model, apiKey });\n}\n\nexport class OpenAICompatibleClient {\n  private readonly baseUrl: string;\n  private readonly model: string;\n  private readonly apiKey?: string;\n\n  constructor(config: OpenAICompatibleClientConfig) {\n    this.baseUrl = config.baseUrl.replace(/\\/$/, \"\");\n    this.model = config.model;\n    this.apiKey = config.apiKey;\n  }\n\n  async chat(\n    messages: ChatMessage[],\n    options?: ChatOptions\n  ): Promise<ChatResult> {\n    const timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n    const raw = await this.request(\n      {\n        model: this.model,\n        messages: messages.map((m) => ({ role: m.role, content: m.content })),\n      },\n      timeoutMs\n    );\n    const choices = (raw as { choices?: Array<{ message?: { content?: string } }> }).choices;\n    const content =\n      Array.isArray(choices) && choices[0]?.message?.content != null\n        ? String(choices[0].message.content)\n        : \"\";\n    return { content, raw };\n  }\n\n  async chatWithTools(\n    messages: Array<\n      | ChatMessage\n      | { role: \"tool\"; content: string; tool_call_id: string }\n      | (Omit<AssistantMessageWithToolCalls, \"role\"> & { role: \"assistant\" })\n    >,\n    tools: OpenAIToolDefinition[],\n    options?: ChatOptions\n  ): Promise<ChatWithToolsResult> {\n    const timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n    const raw = await this.request(\n      {\n        model: this.model,\n        messages: messages.map((m) => this.serializeMessage(m)),\n        tools,\n      },\n      timeoutMs\n    );\n    const choices = (raw as {\n      choices?: Array<{\n        message?: {\n          content?: string | null;\n          tool_calls?: AssistantMessageWithToolCalls[\"tool_calls\"];\n        };\n      }>;\n    }).choices;\n    const msg = Array.isArray(choices) ? choices[0]?.message : undefined;\n    return {\n      message: {\n        role: \"assistant\",\n        content: msg?.content ?? null,\n        tool_calls: msg?.tool_calls,\n      },\n      raw,\n    };\n  }\n\n  private buildHeaders(): Record<string, string> {\n    const headers: Record<string, string> = {\n      \"Content-Type\": \"application/json\",\n    };\n    if (this.apiKey) headers[\"Authorization\"] = `Bearer ${this.apiKey}`;\n    return headers;\n  }\n\n  private serializeMessage(\n    m:\n      | ChatMessage\n      | { role: \"tool\"; content: string; tool_call_id: string }\n      | (AssistantMessageWithToolCalls & { role: \"assistant\" })\n  ): object {\n    if (m.role === \"tool\")\n      return { role: \"tool\", content: m.content, tool_call_id: m.tool_call_id };\n    if (m.role === \"assistant\" && \"tool_calls\" in m && m.tool_calls?.length)\n      return { role: \"assistant\", content: m.content ?? null, tool_calls: m.tool_calls };\n    return { role: m.role, content: (m as ChatMessage).content };\n  }\n\n  private async request(body: object, timeoutMs: number): Promise<unknown> {\n    const url = `${this.baseUrl}/chat/completions`;\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), timeoutMs);\n    let response: Response;\n    try {\n      response = await fetch(url, {\n        method: \"POST\",\n        headers: this.buildHeaders(),\n        body: JSON.stringify(body),\n        signal: controller.signal,\n      });\n    } catch (err) {\n      clearTimeout(timer);\n      if (err instanceof Error && err.name === \"AbortError\")\n        throw new Error(`LLM request timed out after ${timeoutMs}ms`);\n      throw err;\n    }\n    clearTimeout(timer);\n    const raw = (await response.json()) as unknown;\n    if (!response.ok) {\n      const errBody =\n        typeof raw === \"object\" && raw !== null && \"error\" in (raw as object)\n          ? (raw as { error: unknown }).error\n          : raw;\n      throw new Error(\n        `LLM API error ${response.status}: ${JSON.stringify(errBody)}`\n      );\n    }\n    return raw;\n  }\n}\n","/**\n * ReAct agent: LLM + tool hub, Thought–Action–Observation loop.\n * Use: new ReActAgent(llm, toolHub).run(instruction).\n */\n\nimport type { ToolRegistry } from \"../registry/ToolRegistry.js\";\nimport type { ToolSpec } from \"../types/ToolSpec.js\";\nimport type { ToolResult } from \"../types/ToolResult.js\";\nimport type {\n  OpenAICompatibleClient,\n  OpenAIToolDefinition,\n  AssistantMessageWithToolCalls,\n  ChatMessage,\n} from \"./OpenAICompatibleClient.js\";\n\nexport interface ReActAgentToolHub {\n  getRegistry(): ToolRegistry;\n  invokeTool(toolName: string, args: unknown): Promise<ToolResult>;\n}\n\nexport interface ReActAgentRunOptions {\n  systemPrompt?: string;\n  maxSteps?: number;\n  timeoutMs?: number;\n}\n\nexport interface ReActAgentRunResult {\n  content: string;\n  steps: number;\n}\n\ntype AgentMessage =\n  | ChatMessage\n  | { role: \"tool\"; content: string; tool_call_id: string }\n  | (AssistantMessageWithToolCalls & { role: \"assistant\" });\n\nconst DEFAULT_PROMPT =\n  \"ReAct: Thought (reason) → Action (use tool or answer) → Observation (tool result). Repeat until you give the final answer. Same language as user.\";\n\nexport class ReActAgent {\n  constructor(\n    private readonly llm: OpenAICompatibleClient,\n    private readonly toolHub: ReActAgentToolHub\n  ) {}\n\n  async run(\n    instruction: string,\n    options: ReActAgentRunOptions = {}\n  ): Promise<ReActAgentRunResult> {\n    const maxSteps = options.maxSteps ?? 10;\n    const tools = this.getTools();\n    const messages: AgentMessage[] = [\n      { role: \"system\", content: options.systemPrompt ?? DEFAULT_PROMPT },\n      { role: \"user\", content: instruction },\n    ];\n    let steps = 0;\n    let lastContent = \"\";\n\n    while (steps < maxSteps) {\n      const { message } = await this.llm.chatWithTools(\n        messages,\n        tools,\n        options.timeoutMs ? { timeoutMs: options.timeoutMs } : undefined\n      );\n      steps++;\n      messages.push({ ...message, role: \"assistant\" });\n      if (message.content) lastContent = message.content;\n      if (!message.tool_calls?.length)\n        return { content: lastContent, steps };\n\n      for (const tc of message.tool_calls) {\n        const args = this.parseArgs(tc.function.arguments);\n        const result = await this.toolHub.invokeTool(tc.function.name, args);\n        const content = result.ok\n          ? JSON.stringify(result.result)\n          : JSON.stringify({ ok: false, error: result.error?.message ?? \"Tool failed\" });\n        messages.push({ role: \"tool\", content: `Observation: ${content}`, tool_call_id: tc.id });\n      }\n    }\n    return { content: lastContent || \"Reached max steps.\", steps };\n  }\n\n  private getTools(): OpenAIToolDefinition[] {\n    return this.toolHub.getRegistry().snapshot().map((s: ToolSpec) => ({\n      type: \"function\" as const,\n      function: { name: s.name, description: s.description ?? \"\", parameters: s.inputSchema },\n    }));\n  }\n\n  private parseArgs(json: string | undefined): unknown {\n    if (!json) return {};\n    try {\n      return JSON.parse(json);\n    } catch {\n      return {};\n    }\n  }\n}\n"]}