@push.rocks/smartagent 1.7.0 → 3.0.0

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@push.rocks/smartagent',
-    version: '1.7.0',
-    description: 'an agentic framework built on top of @push.rocks/smartai'
+    version: '3.0.0',
+    description: 'Agentic loop for ai-sdk (Vercel AI SDK). Wraps streamText with stopWhen for parallel multi-step tool execution. Built on @push.rocks/smartai.'
 };
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSx3QkFBd0I7SUFDOUIsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLDBEQUEwRDtDQUN4RSxDQUFBIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSx3QkFBd0I7SUFDOUIsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLCtJQUErSTtDQUM3SixDQUFBIn0=

package/dist_ts/index.d.ts

@@ -1,12 +1,9 @@
-export { DualAgentOrchestrator } from './smartagent.classes.dualagent.js';
-export { DriverAgent } from './smartagent.classes.driveragent.js';
-export { GuardianAgent } from './smartagent.classes.guardianagent.js';
-export { BaseToolWrapper } from './smartagent.tools.base.js';
-export { FilesystemTool, type IFilesystemToolOptions } from './smartagent.tools.filesystem.js';
-export { HttpTool } from './smartagent.tools.http.js';
-export { ShellTool } from './smartagent.tools.shell.js';
-export { BrowserTool } from './smartagent.tools.browser.js';
-export { DenoTool, type TDenoPermission } from './smartagent.tools.deno.js';
-export { JsonValidatorTool } from './smartagent.tools.json.js';
-export * from './smartagent.interfaces.js';
-export { type ISmartAiOptions, type TProvider, type ChatMessage, type ChatOptions, type ChatResponse, } from '@push.rocks/smartai';
+export { runAgent } from './smartagent.classes.agent.js';
+export { ToolRegistry } from './smartagent.classes.toolregistry.js';
+export { truncateOutput } from './smartagent.utils.truncation.js';
+export type { ITruncateResult } from './smartagent.utils.truncation.js';
+export { ContextOverflowError } from './smartagent.interfaces.js';
+export type { IAgentRunOptions, IAgentRunResult } from './smartagent.interfaces.js';
+export { tool, jsonSchema } from '@push.rocks/smartai';
+export { z } from 'zod';
+export { stepCountIs } from 'ai';

package/dist_ts/index.js

@@ -1,20 +1,9 @@
-import * as plugins from './plugins.js';
-// Export the dual-agent orchestrator (main entry point)
-export { DualAgentOrchestrator } from './smartagent.classes.dualagent.js';
-// Export individual agents
-export { DriverAgent } from './smartagent.classes.driveragent.js';
-export { GuardianAgent } from './smartagent.classes.guardianagent.js';
-// Export base tool class for custom tool creation
-export { BaseToolWrapper } from './smartagent.tools.base.js';
-// Export standard tools
-export { FilesystemTool } from './smartagent.tools.filesystem.js';
-export { HttpTool } from './smartagent.tools.http.js';
-export { ShellTool } from './smartagent.tools.shell.js';
-export { BrowserTool } from './smartagent.tools.browser.js';
-export { DenoTool } from './smartagent.tools.deno.js';
-export { JsonValidatorTool } from './smartagent.tools.json.js';
-// Export all interfaces
-export * from './smartagent.interfaces.js';
-// Re-export useful types from smartai
-export {} from '@push.rocks/smartai';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGNBQWMsQ0FBQztBQUV4Qyx3REFBd0Q7QUFDeEQsT0FBTyxFQUFFLHFCQUFxQixFQUFFLE1BQU0sbUNBQW1DLENBQUM7QUFFMUUsMkJBQTJCO0FBQzNCLE9BQU8sRUFBRSxXQUFXLEVBQUUsTUFBTSxxQ0FBcUMsQ0FBQztBQUNsRSxPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0sdUNBQXVDLENBQUM7QUFFdEUsa0RBQWtEO0FBQ2xELE9BQU8sRUFBRSxlQUFlLEVBQUUsTUFBTSw0QkFBNEIsQ0FBQztBQUU3RCx3QkFBd0I7QUFDeEIsT0FBTyxFQUFFLGNBQWMsRUFBK0IsTUFBTSxrQ0FBa0MsQ0FBQztBQUMvRixPQUFPLEVBQUUsUUFBUSxFQUFFLE1BQU0sNEJBQTRCLENBQUM7QUFDdEQsT0FBTyxFQUFFLFNBQVMsRUFBRSxNQUFNLDZCQUE2QixDQUFDO0FBQ3hELE9BQU8sRUFBRSxXQUFXLEVBQUUsTUFBTSwrQkFBK0IsQ0FBQztBQUM1RCxPQUFPLEVBQUUsUUFBUSxFQUF3QixNQUFNLDRCQUE0QixDQUFDO0FBQzVFLE9BQU8sRUFBRSxpQkFBaUIsRUFBRSxNQUFNLDRCQUE0QixDQUFDO0FBRS9ELHdCQUF3QjtBQUN4QixjQUFjLDRCQUE0QixDQUFDO0FBRTNDLHNDQUFzQztBQUN0QyxPQUFPLEVBTU4sTUFBTSxxQkFBcUIsQ0FBQyJ9
+export { runAgent } from './smartagent.classes.agent.js';
+export { ToolRegistry } from './smartagent.classes.toolregistry.js';
+export { truncateOutput } from './smartagent.utils.truncation.js';
+export { ContextOverflowError } from './smartagent.interfaces.js';
+// Re-export tool() and z so consumers can define tools without extra imports
+export { tool, jsonSchema } from '@push.rocks/smartai';
+export { z } from 'zod';
+export { stepCountIs } from 'ai';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsUUFBUSxFQUFFLE1BQU0sK0JBQStCLENBQUM7QUFDekQsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLHNDQUFzQyxDQUFDO0FBQ3BFLE9BQU8sRUFBRSxjQUFjLEVBQUUsTUFBTSxrQ0FBa0MsQ0FBQztBQUVsRSxPQUFPLEVBQUUsb0JBQW9CLEVBQUUsTUFBTSw0QkFBNEIsQ0FBQztBQUdsRSw2RUFBNkU7QUFDN0UsT0FBTyxFQUFFLElBQUksRUFBRSxVQUFVLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUN2RCxPQUFPLEVBQUUsQ0FBQyxFQUFFLE1BQU0sS0FBSyxDQUFDO0FBQ3hCLE9BQU8sRUFBRSxXQUFXLEVBQUUsTUFBTSxJQUFJLENBQUMifQ==

package/dist_ts/plugins.d.ts

@@ -1,11 +1,10 @@
 import * as path from 'path';
 export { path };
-import { minimatch } from 'minimatch';
-export { minimatch };
-import * as smartai from '@push.rocks/smartai';
-import * as smartdeno from '@push.rocks/smartdeno';
-import * as smartfs from '@push.rocks/smartfs';
-import * as smartrequest from '@push.rocks/smartrequest';
-import * as smartbrowser from '@push.rocks/smartbrowser';
-import * as smartshell from '@push.rocks/smartshell';
-export { smartai, smartdeno, smartfs, smartrequest, smartbrowser, smartshell, };
+import { streamText, generateText, stepCountIs } from 'ai';
+export { streamText, generateText, stepCountIs };
+export type { ModelMessage, ToolSet, StreamTextResult, } from 'ai';
+import { tool, jsonSchema } from '@push.rocks/smartai';
+export { tool, jsonSchema };
+export type { LanguageModelV3 } from '@push.rocks/smartai';
+import { z } from 'zod';
+export { z };

package/dist_ts/plugins.js

@@ -1,15 +1,13 @@
 // node native
 import * as path from 'path';
 export { path };
-// third party
-import { minimatch } from 'minimatch';
-export { minimatch };
-// @push.rocks scope
-import * as smartai from '@push.rocks/smartai';
-import * as smartdeno from '@push.rocks/smartdeno';
-import * as smartfs from '@push.rocks/smartfs';
-import * as smartrequest from '@push.rocks/smartrequest';
-import * as smartbrowser from '@push.rocks/smartbrowser';
-import * as smartshell from '@push.rocks/smartshell';
-export { smartai, smartdeno, smartfs, smartrequest, smartbrowser, smartshell, };
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGx1Z2lucy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL3BsdWdpbnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsY0FBYztBQUNkLE9BQU8sS0FBSyxJQUFJLE1BQU0sTUFBTSxDQUFDO0FBRTdCLE9BQU8sRUFBRSxJQUFJLEVBQUUsQ0FBQztBQUVoQixjQUFjO0FBQ2QsT0FBTyxFQUFFLFNBQVMsRUFBRSxNQUFNLFdBQVcsQ0FBQztBQUV0QyxPQUFPLEVBQUUsU0FBUyxFQUFFLENBQUM7QUFFckIsb0JBQW9CO0FBQ3BCLE9BQU8sS0FBSyxPQUFPLE1BQU0scUJBQXFCLENBQUM7QUFDL0MsT0FBTyxLQUFLLFNBQVMsTUFBTSx1QkFBdUIsQ0FBQztBQUNuRCxPQUFPLEtBQUssT0FBTyxNQUFNLHFCQUFxQixDQUFDO0FBQy9DLE9BQU8sS0FBSyxZQUFZLE1BQU0sMEJBQTBCLENBQUM7QUFDekQsT0FBTyxLQUFLLFlBQVksTUFBTSwwQkFBMEIsQ0FBQztBQUN6RCxPQUFPLEtBQUssVUFBVSxNQUFNLHdCQUF3QixDQUFDO0FBRXJELE9BQU8sRUFDTCxPQUFPLEVBQ1AsU0FBUyxFQUNULE9BQU8sRUFDUCxZQUFZLEVBQ1osWUFBWSxFQUNaLFVBQVUsR0FDWCxDQUFDIn0=
+// ai-sdk core
+import { streamText, generateText, stepCountIs } from 'ai';
+export { streamText, generateText, stepCountIs };
+// @push.rocks/smartai
+import { tool, jsonSchema } from '@push.rocks/smartai';
+export { tool, jsonSchema };
+// zod
+import { z } from 'zod';
+export { z };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGx1Z2lucy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL3BsdWdpbnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsY0FBYztBQUNkLE9BQU8sS0FBSyxJQUFJLE1BQU0sTUFBTSxDQUFDO0FBRTdCLE9BQU8sRUFBRSxJQUFJLEVBQUUsQ0FBQztBQUVoQixjQUFjO0FBQ2QsT0FBTyxFQUFFLFVBQVUsRUFBRSxZQUFZLEVBQUUsV0FBVyxFQUFFLE1BQU0sSUFBSSxDQUFDO0FBRTNELE9BQU8sRUFBRSxVQUFVLEVBQUUsWUFBWSxFQUFFLFdBQVcsRUFBRSxDQUFDO0FBUWpELHNCQUFzQjtBQUN0QixPQUFPLEVBQUUsSUFBSSxFQUFFLFVBQVUsRUFBRSxNQUFNLHFCQUFxQixDQUFDO0FBRXZELE9BQU8sRUFBRSxJQUFJLEVBQUUsVUFBVSxFQUFFLENBQUM7QUFJNUIsTUFBTTtBQUNOLE9BQU8sRUFBRSxDQUFDLEVBQUUsTUFBTSxLQUFLLENBQUM7QUFFeEIsT0FBTyxFQUFFLENBQUMsRUFBRSxDQUFDIn0=

package/dist_ts/smartagent.classes.agent.d.ts

@@ -0,0 +1,2 @@
+import type { IAgentRunOptions, IAgentRunResult } from './smartagent.interfaces.js';
+export declare function runAgent(options: IAgentRunOptions): Promise<IAgentRunResult>;

package/dist_ts/smartagent.classes.agent.js

@@ -0,0 +1,173 @@
+// Retry backoff and context overflow logic derived from opencode (MIT) — https://github.com/sst/opencode
+import * as plugins from './plugins.js';
+import { ContextOverflowError } from './smartagent.interfaces.js';
+// Retry constants
+const RETRY_INITIAL_DELAY = 2000;
+const RETRY_BACKOFF_FACTOR = 2;
+const RETRY_MAX_DELAY = 30_000;
+const MAX_RETRY_ATTEMPTS = 8;
+function retryDelay(attempt, headers) {
+    if (headers) {
+        const ms = headers['retry-after-ms'];
+        if (ms) {
+            const n = parseFloat(ms);
+            if (!isNaN(n))
+                return n;
+        }
+        const after = headers['retry-after'];
+        if (after) {
+            const secs = parseFloat(after);
+            if (!isNaN(secs))
+                return Math.ceil(secs * 1000);
+            const date = Date.parse(after) - Date.now();
+            if (!isNaN(date) && date > 0)
+                return Math.ceil(date);
+        }
+    }
+    return Math.min(RETRY_INITIAL_DELAY * Math.pow(RETRY_BACKOFF_FACTOR, attempt - 1), RETRY_MAX_DELAY);
+}
+async function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(new DOMException('Aborted', 'AbortError'));
+            return;
+        }
+        const t = setTimeout(resolve, ms);
+        signal?.addEventListener('abort', () => {
+            clearTimeout(t);
+            reject(new DOMException('Aborted', 'AbortError'));
+        }, { once: true });
+    });
+}
+function isRetryableError(err) {
+    const status = err?.status ?? err?.statusCode;
+    if (status === 429 || status === 529 || status === 503)
+        return true;
+    if (err instanceof Error) {
+        const msg = err.message.toLowerCase();
+        if (msg.includes('rate limit') || msg.includes('overloaded') || msg.includes('too many requests')) {
+            return true;
+        }
+    }
+    return false;
+}
+function isContextOverflow(err) {
+    if (err instanceof Error) {
+        const msg = err.message.toLowerCase();
+        return (msg.includes('context_length_exceeded') ||
+            msg.includes('context window') ||
+            msg.includes('maximum context length') ||
+            msg.includes('too many tokens') ||
+            msg.includes('input is too long') ||
+            err?.name === 'AI_ContextWindowExceededError');
+    }
+    return false;
+}
+export async function runAgent(options) {
+    let stepCount = 0;
+    let attempt = 0;
+    let totalInput = 0;
+    let totalOutput = 0;
+    const tools = options.tools ?? {};
+    // Add a no-op sink for repaired-but-unrecognised tool calls
+    const allTools = {
+        ...tools,
+        invalid: plugins.tool({
+            description: 'Sink for unrecognised tool calls — returns an error message to the model',
+            inputSchema: plugins.z.object({
+                tool: plugins.z.string(),
+                error: plugins.z.string(),
+            }),
+            execute: async ({ tool, error }) => `Unknown tool "${tool}": ${error}`,
+        }),
+    };
+    // Build messages — streamText requires either prompt OR messages, not both
+    let messages = options.messages
+        ? [...options.messages, { role: 'user', content: options.prompt }]
+        : [{ role: 'user', content: options.prompt }];
+    while (true) {
+        try {
+            const result = plugins.streamText({
+                model: options.model,
+                system: options.system,
+                messages,
+                tools: allTools,
+                stopWhen: plugins.stepCountIs(options.maxSteps ?? 20),
+                maxRetries: 0, // handled manually below
+                abortSignal: options.abort,
+                experimental_repairToolCall: async ({ toolCall, tools: availableTools, error }) => {
+                    const lower = toolCall.toolName.toLowerCase();
+                    if (lower !== toolCall.toolName && availableTools[lower]) {
+                        return { ...toolCall, toolName: lower };
+                    }
+                    return {
+                        ...toolCall,
+                        toolName: 'invalid',
+                        args: JSON.stringify({
+                            tool: toolCall.toolName,
+                            error: String(error),
+                        }),
+                    };
+                },
+                onChunk: ({ chunk }) => {
+                    if (chunk.type === 'text-delta' && options.onToken) {
+                        options.onToken(chunk.textDelta ?? chunk.text ?? '');
+                    }
+                },
+                experimental_onToolCallStart: options.onToolCall
+                    ? ({ toolCall }) => {
+                        options.onToolCall(toolCall.toolName, toolCall.input ?? toolCall.args);
+                    }
+                    : undefined,
+                experimental_onToolCallFinish: options.onToolResult
+                    ? ({ toolCall }) => {
+                        options.onToolResult(toolCall.toolName, toolCall.result);
+                    }
+                    : undefined,
+                onStepFinish: ({ usage }) => {
+                    stepCount++;
+                    totalInput += usage?.inputTokens ?? 0;
+                    totalOutput += usage?.outputTokens ?? 0;
+                },
+            });
+            // Consume the stream and collect results
+            const text = await result.text;
+            const finishReason = await result.finishReason;
+            const responseData = await result.response;
+            attempt = 0; // reset on success
+            return {
+                text,
+                messages: responseData.messages,
+                steps: stepCount,
+                finishReason,
+                usage: {
+                    inputTokens: totalInput,
+                    outputTokens: totalOutput,
+                    totalTokens: totalInput + totalOutput,
+                },
+            };
+        }
+        catch (err) {
+            // Abort — don't retry
+            if (err instanceof DOMException && err.name === 'AbortError')
+                throw err;
+            // Rate limit / overload — retry with backoff
+            if (isRetryableError(err) && attempt < MAX_RETRY_ATTEMPTS) {
+                attempt++;
+                const headers = err?.responseHeaders ?? err?.headers;
+                const delay = retryDelay(attempt, headers);
+                await sleep(delay, options.abort);
+                continue;
+            }
+            // Context overflow — compact and retry if handler provided
+            if (isContextOverflow(err)) {
+                if (!options.onContextOverflow)
+                    throw new ContextOverflowError();
+                messages = await options.onContextOverflow(messages);
+                continue;
+            }
+            throw err;
+        }
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic21hcnRhZ2VudC5jbGFzc2VzLmFnZW50LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvc21hcnRhZ2VudC5jbGFzc2VzLmFnZW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLHlHQUF5RztBQUV6RyxPQUFPLEtBQUssT0FBTyxNQUFNLGNBQWMsQ0FBQztBQUV4QyxPQUFPLEVBQUUsb0JBQW9CLEVBQUUsTUFBTSw0QkFBNEIsQ0FBQztBQUVsRSxrQkFBa0I7QUFDbEIsTUFBTSxtQkFBbUIsR0FBRyxJQUFJLENBQUM7QUFDakMsTUFBTSxvQkFBb0IsR0FBRyxDQUFDLENBQUM7QUFDL0IsTUFBTSxlQUFlLEdBQUcsTUFBTSxDQUFDO0FBQy9CLE1BQU0sa0JBQWtCLEdBQUcsQ0FBQyxDQUFDO0FBRTdCLFNBQVMsVUFBVSxDQUFDLE9BQWUsRUFBRSxPQUFnQztJQUNuRSxJQUFJLE9BQU8sRUFBRSxDQUFDO1FBQ1osTUFBTSxFQUFFLEdBQUcsT0FBTyxDQUFDLGdCQUFnQixDQUFDLENBQUM7UUFDckMsSUFBSSxFQUFFLEVBQUUsQ0FBQztZQUNQLE1BQU0sQ0FBQyxHQUFHLFVBQVUsQ0FBQyxFQUFFLENBQUMsQ0FBQztZQUN6QixJQUFJLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQztnQkFBRSxPQUFPLENBQUMsQ0FBQztRQUMxQixDQUFDO1FBQ0QsTUFBTSxLQUFLLEdBQUcsT0FBTyxDQUFDLGFBQWEsQ0FBQyxDQUFDO1FBQ3JDLElBQUksS0FBSyxFQUFFLENBQUM7WUFDVixNQUFNLElBQUksR0FBRyxVQUFVLENBQUMsS0FBSyxDQUFDLENBQUM7WUFDL0IsSUFBSSxDQUFDLEtBQUssQ0FBQyxJQUFJLENBQUM7Z0JBQUUsT0FBTyxJQUFJLENBQUMsSUFBSSxDQUFDLElBQUksR0FBRyxJQUFJLENBQUMsQ0FBQztZQUNoRCxNQUFNLElBQUksR0FBRyxJQUFJLENBQUMsS0FBSyxDQUFDLEtBQUssQ0FBQyxHQUFHLElBQUksQ0FBQyxHQUFH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

package/dist_ts/smartagent.classes.toolregistry.d.ts

@@ -0,0 +1,12 @@
+import type { ToolSet } from './plugins.js';
+export declare class ToolRegistry {
+    private tools;
+    /**
+     * Register a tool.
+     * @param name  Tool name (must be unique, snake_case recommended)
+     * @param def   Tool definition created with ai-sdk's tool() helper
+     */
+    register(name: string, def: ToolSet[string]): this;
+    /** Get the full ToolSet for passing to runAgent */
+    getTools(): ToolSet;
+}

package/dist_ts/smartagent.classes.toolregistry.js

@@ -0,0 +1,17 @@
+export class ToolRegistry {
+    tools = {};
+    /**
+     * Register a tool.
+     * @param name  Tool name (must be unique, snake_case recommended)
+     * @param def   Tool definition created with ai-sdk's tool() helper
+     */
+    register(name, def) {
+        this.tools[name] = def;
+        return this;
+    }
+    /** Get the full ToolSet for passing to runAgent */
+    getTools() {
+        return { ...this.tools };
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic21hcnRhZ2VudC5jbGFzc2VzLnRvb2xyZWdpc3RyeS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL3NtYXJ0YWdlbnQuY2xhc3Nlcy50b29scmVnaXN0cnkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsTUFBTSxPQUFPLFlBQVk7SUFDZixLQUFLLEdBQVksRUFBRSxDQUFDO0lBRTVCOzs7O09BSUc7SUFDSSxRQUFRLENBQUMsSUFBWSxFQUFFLEdBQW9CO1FBQ2hELElBQUksQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLEdBQUcsR0FBRyxDQUFDO1FBQ3ZCLE9BQU8sSUFBSSxDQUFDO0lBQ2QsQ0FBQztJQUVELG1EQUFtRDtJQUM1QyxRQUFRO1FBQ2IsT0FBTyxFQUFFLEdBQUcsSUFBSSxDQUFDLEtBQUssRUFBRSxDQUFDO0lBQzNCLENBQUM7Q0FDRiJ9

package/dist_ts/smartagent.interfaces.d.ts

@@ -1,236 +1,52 @@
-import * as plugins from './plugins.js';
-/**
- * Options for running a task with the DualAgentOrchestrator
- */
-export interface ITaskRunOptions {
-    /** Base64-encoded images to include with the task (for vision-capable models) */
-    images?: string[];
-}
-/**
- * Configuration options for the DualAgentOrchestrator
- */
-export interface IDualAgentOptions extends plugins.smartai.ISmartAiOptions {
-    /** Existing SmartAi instance to reuse (avoids creating duplicate providers) */
-    smartAiInstance?: plugins.smartai.SmartAi;
-    /** Name of the agent system */
-    name?: string;
-    /** Default AI provider for both Driver and Guardian */
-    defaultProvider?: plugins.smartai.TProvider;
-    /** Optional separate provider for Guardian (for cost optimization) */
-    guardianProvider?: plugins.smartai.TProvider;
-    /** System message for the Driver agent */
-    driverSystemMessage?: string;
-    /** Policy prompt for the Guardian agent - REQUIRED */
-    guardianPolicyPrompt: string;
-    /** Maximum iterations for task completion (default: 20) */
-    maxIterations?: number;
-    /** Maximum consecutive rejections before aborting (default: 3) */
-    maxConsecutiveRejections?: number;
-    /** Enable verbose logging */
-    verbose?: boolean;
-    /** Maximum characters for tool result output before truncation (default: 15000). Set to 0 to disable. */
-    maxResultChars?: number;
-    /** Maximum history messages to pass to API (default: 20). Set to 0 for unlimited. */
-    maxHistoryMessages?: number;
-    /** Optional callback for live progress updates during execution */
-    onProgress?: (event: IProgressEvent) => void;
-    /** Prefix for log messages (e.g., "[README]", "[Commit]"). Default: empty */
-    logPrefix?: string;
-    /** Callback fired for each token during LLM generation (streaming mode) */
-    onToken?: (token: string, source: 'driver' | 'guardian') => void;
+import type { ToolSet, ModelMessage, LanguageModelV3 } from './plugins.js';
+export interface IAgentRunOptions {
+    /** The LanguageModelV3 to use — from smartai.getModel() */
+    model: LanguageModelV3;
+    /** Initial user message or task description */
+    prompt: string;
+    /** System prompt override */
+    system?: string;
+    /** Tools available to the agent */
+    tools?: ToolSet;
     /**
-     * Enable native tool calling mode (default: false)
-     * When enabled, uses Ollama's native tool calling API instead of XML parsing
-     * This is more efficient for models that support it (e.g., GPT-OSS with Harmony format)
+     * Maximum number of LLM↔tool round trips.
+     * Each step may execute multiple tools in parallel.
+     * Default: 20
      */
-    useNativeToolCalling?: boolean;
-}
-/**
- * Represents a message in the agent's conversation history
- */
-export interface IAgentMessage {
-    role: 'system' | 'user' | 'assistant' | 'tool' | 'guardian';
-    content: string;
-    toolName?: string;
-    toolResult?: unknown;
-    toolCall?: IToolCallProposal;
-    guardianDecision?: IGuardianDecision;
-    timestamp?: Date;
-}
-/**
- * Represents an action that a tool can perform
- */
-export interface IToolAction {
-    /** Action name (e.g., 'read', 'write', 'delete') */
-    name: string;
-    /** Description of what this action does */
-    description: string;
-    /** JSON schema for action parameters */
-    parameters: Record<string, unknown>;
-}
-/**
- * Native tool call from provider (matches Ollama's tool calling format)
- * Format: function name is "toolName_actionName" (e.g., "json_validate")
- */
-export interface INativeToolCall {
-    function: {
-        name: string;
-        arguments: Record<string, unknown>;
-        index?: number;
+    maxSteps?: number;
+    /** Prior conversation messages to include */
+    messages?: ModelMessage[];
+    /** Called for each streamed text delta */
+    onToken?: (delta: string) => void;
+    /** Called when a tool call starts */
+    onToolCall?: (toolName: string, input: unknown) => void;
+    /** Called when a tool call completes */
+    onToolResult?: (toolName: string, result: unknown) => void;
+    /**
+     * Called when total token usage approaches the model's context limit.
+     * Receives the full message history and must return a compacted replacement.
+     * If not provided, runAgent throws a ContextOverflowError instead.
+     */
+    onContextOverflow?: (messages: ModelMessage[]) => Promise<ModelMessage[]>;
+    /** AbortSignal to cancel the run mid-flight */
+    abort?: AbortSignal;
+}
+export interface IAgentRunResult {
+    /** Final text output from the model */
+    text: string;
+    /** All messages in the completed conversation */
+    messages: ModelMessage[];
+    /** Total steps taken */
+    steps: number;
+    /** Finish reason from the final step */
+    finishReason: string;
+    /** Accumulated token usage across all steps */
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens: number;
     };
 }
-/**
- * Proposed tool call from the Driver
- */
-export interface IToolCallProposal {
-    /** Unique ID for this proposal */
-    proposalId: string;
-    /** Name of the tool */
-    toolName: string;
-    /** Specific action to perform */
-    action: string;
-    /** Parameters for the action */
-    params: Record<string, unknown>;
-    /** Driver's reasoning for this call */
-    reasoning?: string;
-}
-/**
- * Result of tool execution
- */
-export interface IToolExecutionResult {
-    success: boolean;
-    result?: unknown;
-    error?: string;
-    /** Optional human-readable summary for history (if provided, used instead of full result) */
-    summary?: string;
-}
-/**
- * Base interface for wrapped tools
- */
-export interface IAgentToolWrapper {
-    /** Tool name */
-    name: string;
-    /** Tool description */
-    description: string;
-    /** Available actions */
-    actions: IToolAction[];
-    /** Initialize the tool */
-    initialize(): Promise<void>;
-    /** Cleanup resources */
-    cleanup(): Promise<void>;
-    /** Execute an action */
-    execute(action: string, params: Record<string, unknown>): Promise<IToolExecutionResult>;
-    /** Get a summary for Guardian review */
-    getCallSummary(action: string, params: Record<string, unknown>): string;
-}
-/**
- * Request for Guardian evaluation
- */
-export interface IGuardianEvaluationRequest {
-    /** The proposed tool call */
-    proposal: IToolCallProposal;
-    /** Current task context */
-    taskContext: string;
-    /** Recent conversation history (last N messages) */
-    recentHistory: IAgentMessage[];
-    /** Summary of what the tool call will do */
-    callSummary: string;
-}
-/**
- * Guardian's decision
- */
-export interface IGuardianDecision {
-    /** Approve or reject */
-    decision: 'approve' | 'reject';
-    /** Explanation of the decision */
-    reason: string;
-    /** Specific concerns if rejected */
-    concerns?: string[];
-    /** Suggestions for the Driver if rejected */
-    suggestions?: string;
-    /** Confidence level (0-1) */
-    confidence?: number;
-}
-/**
- * Log entry for tool executions
- */
-export interface IToolExecutionLog {
-    timestamp: Date;
-    toolName: string;
-    action: string;
-    params: Record<string, unknown>;
-    guardianDecision: 'approved' | 'rejected';
-    guardianReason: string;
-    executionResult?: unknown;
-    executionError?: string;
-}
-/**
- * Status of a dual-agent run
- */
-export type TDualAgentRunStatus = 'completed' | 'in_progress' | 'max_iterations_reached' | 'max_rejections_reached' | 'clarification_needed' | 'error';
-/**
- * Result of a dual-agent run
- */
-export interface IDualAgentRunResult {
-    /** Whether the task was successful */
-    success: boolean;
-    /** Whether the task is completed */
-    completed: boolean;
-    /** Final result or response */
-    result: string;
-    /** Total iterations taken */
-    iterations: number;
-    /** Full conversation history */
-    history: IAgentMessage[];
-    /** Current status */
-    status: TDualAgentRunStatus;
-    /** Number of tool calls made */
-    toolCallCount?: number;
-    /** Number of Guardian rejections */
-    rejectionCount?: number;
-    /** Tool execution log */
-    toolLog?: IToolExecutionLog[];
-    /** Error message if status is 'error' */
-    error?: string;
-}
-/**
- * Progress event types for live feedback during agent execution
- */
-export type TProgressEventType = 'task_started' | 'iteration_started' | 'tool_proposed' | 'guardian_evaluating' | 'tool_approved' | 'tool_rejected' | 'tool_executing' | 'tool_completed' | 'task_completed' | 'clarification_needed' | 'max_iterations' | 'max_rejections';
-/**
- * Log level for progress events
- */
-export type TLogLevel = 'info' | 'warn' | 'error' | 'success';
-/**
- * Progress event for live feedback during agent execution
- */
-export interface IProgressEvent {
-    /** Type of progress event */
-    type: TProgressEventType;
-    /** Current iteration number */
-    iteration?: number;
-    /** Maximum iterations configured */
-    maxIterations?: number;
-    /** Name of the tool being used */
-    toolName?: string;
-    /** Action being performed */
-    action?: string;
-    /** Reason for rejection or other explanation */
-    reason?: string;
-    /** Human-readable message about the event */
-    message?: string;
-    /** Timestamp of the event */
-    timestamp: Date;
-    /** Log level for this event (info, warn, error, success) */
-    logLevel: TLogLevel;
-    /** Pre-formatted log message ready for output */
-    logMessage: string;
+export declare class ContextOverflowError extends Error {
+    constructor(message?: string);
 }
-/**
- * Available tool names
- */
-export type TToolName = 'filesystem' | 'http' | 'browser' | 'shell';
-/**
- * Generate a unique proposal ID
- */
-export declare function generateProposalId(): string;

package/dist_ts/smartagent.interfaces.js

@@ -1,8 +1,7 @@
-import * as plugins from './plugins.js';
-/**
- * Generate a unique proposal ID
- */
-export function generateProposalId() {
-    return `proposal_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
+export class ContextOverflowError extends Error {
+    constructor(message = 'Agent context limit reached and no onContextOverflow handler provided') {
+        super(message);
+        this.name = 'ContextOverflowError';
+    }
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic21hcnRhZ2VudC5pbnRlcmZhY2VzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvc21hcnRhZ2VudC5pbnRlcmZhY2VzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sY0FBYyxDQUFDO0FBNFN4Qzs7R0FFRztBQUNILE1BQU0sVUFBVSxrQkFBa0I7SUFDaEMsT0FBTyxZQUFZLElBQUksQ0FBQyxHQUFHLEVBQUUsSUFBSSxJQUFJLENBQUMsTUFBTSxFQUFFLENBQUMsUUFBUSxDQUFDLEVBQUUsQ0FBQyxDQUFDLFNBQVMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLEVBQUUsQ0FBQztBQUNoRixDQUFDIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic21hcnRhZ2VudC5pbnRlcmZhY2VzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvc21hcnRhZ2VudC5pbnRlcmZhY2VzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQWdEQSxNQUFNLE9BQU8sb0JBQXFCLFNBQVEsS0FBSztJQUM3QyxZQUFZLE9BQU8sR0FBRyx1RUFBdUU7UUFDM0YsS0FBSyxDQUFDLE9BQU8sQ0FBQyxDQUFDO1FBQ2YsSUFBSSxDQUFDLElBQUksR0FBRyxzQkFBc0IsQ0FBQztJQUNyQyxDQUFDO0NBQ0YifQ==