orbitx 0.3.0 → 0.3.2

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

@@ -0,0 +1,28 @@
+import type { AgentProvidersInput } from "./agent-providers.js";
+import type { MessageUsage } from "./ai-provider.js";
+export interface AIAskOutputField {
+    name: string;
+    type: "number" | "string" | "boolean" | "object" | "array";
+    description: string;
+    required?: boolean;
+}
+export type AIAskOutputStructure = AIAskOutputField[];
+export interface AIAskProps {
+    instruction: string;
+    aiModel: AgentProvidersInput;
+    outputStructure: AIAskOutputStructure;
+}
+export interface AIAskResult {
+    output: Record<string, any>;
+    valid: boolean;
+    errors?: string[];
+    attempts: number;
+    usage: MessageUsage[];
+}
+export declare class AIASK {
+    #private;
+    constructor({ instruction, aiModel, outputStructure }: AIAskProps);
+    run(input: string): Promise<AIAskResult>;
+}
+export default AIASK;
+//# sourceMappingURL=ai-ask.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai-ask.d.ts","sourceRoot":"","sources":["../../src/core/ai-ask.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAOrD,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,EAAE,CAAC;AAEtD,MAAM,WAAW,UAAU;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,eAAe,EAAE,oBAAoB,CAAC;CACzC;AAED,MAAM,WAAW,WAAW;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,YAAY,EAAE,CAAC;CACzB;AAuBD,qBAAa,KAAK;;gBAKF,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,EAAE,EAAE,UAAU;IAM3D,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAsDjD;AAED,eAAe,KAAK,CAAC"}

package/dist/core/ai-ask.js

@@ -0,0 +1,80 @@
+import MCPTool from "./mcp.js";
+import MCPClient from "./mcp-client.js";
+import MCPConnection from "./mcp-connection.js";
+import MCPServer from "./mcp-server.js";
+import { StatelessAgent } from "./stateless-agent.js";
+const OUTPUT_TOOL_NAME = "submit_answer";
+const MAX_ATTEMPTS = 3;
+function validate(output, structure) {
+    const errors = [];
+    for (const field of structure) {
+        const value = output[field.name];
+        if (value === undefined) {
+            if (field.required !== false)
+                errors.push(`missing required field "${field.name}"`);
+            continue;
+        }
+        const matches = field.type === "array" ? Array.isArray(value)
+            : field.type === "object" ? (typeof value === "object" && value !== null && !Array.isArray(value))
+                : typeof value === field.type;
+        if (!matches) {
+            errors.push(`field "${field.name}" should be ${field.type}, got ${Array.isArray(value) ? "array" : typeof value}`);
+        }
+    }
+    return errors;
+}
+export class AIASK {
+    #instruction;
+    #aiModel;
+    #outputStructure;
+    constructor({ instruction, aiModel, outputStructure }) {
+        this.#instruction = instruction;
+        this.#aiModel = aiModel;
+        this.#outputStructure = outputStructure;
+    }
+    async run(input) {
+        let captured;
+        const submitTool = new MCPTool({
+            name: OUTPUT_TOOL_NAME,
+            description: "Submit your final answer in the exact structure requested. Call this exactly once you have the answer — do not reply in plain text.",
+            inputs: this.#outputStructure.map(f => ({ name: f.name, type: f.type, description: f.description, required: f.required })),
+            execute: async (_envID, inputs) => {
+                captured = inputs;
+                return inputs;
+            },
+        });
+        const conn = new MCPConnection();
+        const mcpServer = new MCPServer(conn);
+        mcpServer.registerTool(submitTool);
+        const mcpClient = new MCPClient("AI_ASK", conn);
+        const agent = new StatelessAgent({
+            instruction: this.#instruction,
+            aiProvider: this.#aiModel,
+            mcpClient,
+            allowedTools: [submitTool],
+        });
+        const usage = [];
+        let errors = [];
+        let lastOutput = {};
+        for (let attempt = 1; attempt <= MAX_ATTEMPTS; attempt++) {
+            captured = undefined;
+            const prompt = errors.length === 0
+                ? input
+                : `${input}\n\nYour previous "${OUTPUT_TOOL_NAME}" call was rejected:\n${errors.map(e => `- ${e}`).join("\n")}\n\nCall "${OUTPUT_TOOL_NAME}" again with a corrected answer.`;
+            const result = await agent.run(prompt);
+            usage.push(...result.usage);
+            if (captured === undefined) {
+                errors = [`"${OUTPUT_TOOL_NAME}" was not called — replied with plain text instead: ${JSON.stringify(result.content)}`];
+                continue;
+            }
+            lastOutput = captured;
+            errors = validate(captured, this.#outputStructure);
+            if (errors.length === 0) {
+                return { output: lastOutput, valid: true, attempts: attempt, usage };
+            }
+        }
+        return { output: lastOutput, valid: false, errors, attempts: MAX_ATTEMPTS, usage };
+    }
+}
+export default AIASK;
+//# sourceMappingURL=ai-ask.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai-ask.js","sourceRoot":"","sources":["../../src/core/ai-ask.ts"],"names":[],"mappings":"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"}

package/dist/core/mcp-auto-execution-policy.d.ts

@@ -0,0 +1,22 @@
+import type { AgentProvidersInput } from "./agent-providers.js";
+import { MCPExecutionPolicy, type MCPToolCallRequest } from "./mcp-execution-policy.js";
+export interface MCPAutoExecutionPolicyVerdict {
+    harmful: boolean;
+    reason: string;
+}
+export interface MCPAutoExecutionPolicyProps {
+    aiModel: AgentProvidersInput;
+    instruction?: string;
+    onVerdict?: (request: MCPToolCallRequest, verdict: MCPAutoExecutionPolicyVerdict) => void;
+    watchedTools?: string[];
+    scopeDir?: string;
+}
+export declare class MCPAutoExecutionPolicy extends MCPExecutionPolicy {
+    #private;
+    constructor({ aiModel, instruction, onVerdict, watchedTools, scopeDir }: MCPAutoExecutionPolicyProps);
+    authorize(request: MCPToolCallRequest): Promise<boolean>;
+    getVerdict(toolCallId: string): MCPAutoExecutionPolicyVerdict | undefined;
+    getLastVerdict(): MCPAutoExecutionPolicyVerdict | undefined;
+}
+export default MCPAutoExecutionPolicy;
+//# sourceMappingURL=mcp-auto-execution-policy.d.ts.map

package/dist/core/mcp-auto-execution-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-auto-execution-policy.d.ts","sourceRoot":"","sources":["../../src/core/mcp-auto-execution-policy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,OAAO,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAExF,MAAM,WAAW,6BAA6B;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,2BAA2B;IACxC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,6BAA6B,KAAK,IAAI,CAAC;IAC1F,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AA6BD,qBAAa,sBAAuB,SAAQ,kBAAkB;;gBAQ9C,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,YAAoC,EAAE,QAAQ,EAAE,EAAE,2BAA2B;IAgCtH,SAAS,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAoB9D,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,6BAA6B,GAAG,SAAS;IAIzE,cAAc,IAAI,6BAA6B,GAAG,SAAS;CAG9D;AAED,eAAe,sBAAsB,CAAC"}

package/dist/core/mcp-auto-execution-policy.js

@@ -0,0 +1,85 @@
+import { resolve, relative, isAbsolute } from "path";
+import { AIASK } from "./ai-ask.js";
+import { MCPExecutionPolicy } from "./mcp-execution-policy.js";
+const DEFAULT_WATCHED_TOOLS = ["bash-run", "fs-write-file", "fs-edit-file", "fs-delete", "fs-move"];
+const FS_PATH_FIELDS = {
+    "fs-write-file": ["path"],
+    "fs-edit-file": ["path"],
+    "fs-delete": ["path"],
+    "fs-move": ["from", "to"],
+};
+const DEFAULT_INSTRUCTION = "You are a safety supervisor reviewing a single tool call an AI agent is about to make, before it's allowed to run. Determine whether executing it, as-is, would cause harm — destructive or irreversible action, data loss, security compromise, exfiltrating secrets — or otherwise clearly goes against reasonable user intent. Judge only this one call: assume ordinary, legitimate agent use unless the tool name or its inputs are themselves clearly dangerous. Note: file content is intentionally omitted from write/edit calls to keep this check cheap — judge those by path and surrounding inputs alone.";
+function isWithinScope(scopeDir, rawPath) {
+    const target = resolve(process.cwd(), rawPath);
+    const rel = relative(scopeDir, target);
+    return rel === "" || (!rel.startsWith("..") && !isAbsolute(rel));
+}
+function redactContent(inputs) {
+    const redacted = {};
+    for (const [key, value] of Object.entries(inputs)) {
+        redacted[key] = key === "content" && typeof value === "string"
+            ? `<omitted, ${Buffer.byteLength(value, "utf-8")} bytes>`
+            : value;
+    }
+    return redacted;
+}
+export class MCPAutoExecutionPolicy extends MCPExecutionPolicy {
+    #ask;
+    #onVerdict;
+    #watchedTools;
+    #scopeDir;
+    #verdicts = new Map();
+    #lastVerdict;
+    constructor({ aiModel, instruction, onVerdict, watchedTools = DEFAULT_WATCHED_TOOLS, scopeDir }) {
+        super();
+        this.#ask = new AIASK({
+            aiModel,
+            instruction: instruction ? `${DEFAULT_INSTRUCTION}\n\n${instruction}` : DEFAULT_INSTRUCTION,
+            outputStructure: [
+                { name: "harmful", type: "boolean", description: "true if executing this tool call would cause harm or clearly goes against reasonable user intent" },
+                { name: "reason", type: "string", description: "brief justification for the verdict" },
+            ],
+        });
+        this.#onVerdict = onVerdict;
+        this.#watchedTools = new Set(watchedTools);
+        this.#scopeDir = resolve(process.cwd(), scopeDir ?? ".");
+    }
+    #record(request, verdict) {
+        this.#lastVerdict = verdict;
+        if (request.toolCallId)
+            this.#verdicts.set(request.toolCallId, verdict);
+        this.#onVerdict?.(request, verdict);
+    }
+    async #askModel(request) {
+        const result = await this.#ask.run(`tool: ${request.toolName}\ninputs: ${JSON.stringify(redactContent(request.inputs))}`);
+        const verdict = result.valid
+            ? { harmful: !!result.output.harmful, reason: String(result.output.reason ?? "") }
+            : { harmful: true, reason: `safety check failed to produce a valid verdict after retries: ${result.errors?.join("; ") ?? "unknown error"}` };
+        this.#record(request, verdict);
+        return !verdict.harmful;
+    }
+    async authorize(request) {
+        if (!this.#watchedTools.has(request.toolName)) {
+            return true;
+        }
+        const pathFields = FS_PATH_FIELDS[request.toolName];
+        if (pathFields) {
+            const paths = pathFields
+                .map(field => request.inputs[field])
+                .filter((v) => typeof v === "string" && v.length > 0);
+            if (paths.length === pathFields.length && paths.every(p => isWithinScope(this.#scopeDir, p))) {
+                this.#record(request, { harmful: false, reason: `path(s) resolve inside ${this.#scopeDir}, skipped model review` });
+                return true;
+            }
+        }
+        return this.#askModel(request);
+    }
+    getVerdict(toolCallId) {
+        return this.#verdicts.get(toolCallId);
+    }
+    getLastVerdict() {
+        return this.#lastVerdict;
+    }
+}
+export default MCPAutoExecutionPolicy;
+//# sourceMappingURL=mcp-auto-execution-policy.js.map

package/dist/core/mcp-auto-execution-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-auto-execution-policy.js","sourceRoot":"","sources":["../../src/core/mcp-auto-execution-policy.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,30 @@
+import type { Message, StreamCallback, MessageUsage } from "./ai-provider.js";
+import type MCPClient from "./mcp-client.js";
+import type MCPTool from "./mcp.js";
+import { type AgentProvidersInput } from "./agent-providers.js";
+export interface StatelessAgentProps {
+    instruction: string;
+    safetyPolicies?: string;
+    aiProvider: AgentProvidersInput;
+    mcpClient?: MCPClient;
+    allowedTools?: MCPTool[];
+}
+export interface DispatchedToolCall {
+    id: string;
+    name: string;
+    inputs: Record<string, any>;
+    resultText: string;
+}
+export interface StatelessAgentResult {
+    content: string;
+    toolCalls: DispatchedToolCall[];
+    usage: MessageUsage[];
+    messages: Message[];
+}
+export declare class StatelessAgent {
+    #private;
+    constructor({ instruction, safetyPolicies, aiProvider, mcpClient, allowedTools }: StatelessAgentProps);
+    run(input: string, streamCallback?: StreamCallback, previousMessages?: Message[]): Promise<StatelessAgentResult>;
+}
+export default StatelessAgent;
+//# sourceMappingURL=stateless-agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stateless-agent.d.ts","sourceRoot":"","sources":["../../src/core/stateless-agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,OAAO,EAAE,cAAc,EAA6C,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrI,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,OAAO,MAAM,UAAU,CAAC;AACpC,OAAO,EAAyB,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEvF,MAAM,WAAW,mBAAmB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,mBAAmB,CAAC;IAChC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACvB;AAED,qBAAa,cAAc;;gBAOX,EAAE,WAAW,EAAE,cAAmB,EAAE,UAAU,EAAE,SAAS,EAAE,YAAiB,EAAE,EAAE,mBAAmB;IA0CzG,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,cAAc,EAAE,gBAAgB,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAoCzH;AAED,eAAe,cAAc,CAAC"}

package/dist/core/stateless-agent.js

@@ -0,0 +1,79 @@
+import { resolveAgentProviders } from "./agent-providers.js";
+export class StatelessAgent {
+    #instruction;
+    #safetyPolicies;
+    #provider;
+    #mcpClient;
+    #allowedTools;
+    constructor({ instruction, safetyPolicies = "", aiProvider, mcpClient, allowedTools = [] }) {
+        if (allowedTools.length > 0 && !mcpClient) {
+            throw new Error("StatelessAgent: mcpClient is required when allowedTools is non-empty.");
+        }
+        this.#instruction = instruction;
+        this.#safetyPolicies = safetyPolicies;
+        this.#provider = resolveAgentProviders(aiProvider).getMain();
+        this.#mcpClient = mcpClient;
+        this.#allowedTools = allowedTools;
+    }
+    async #getToolSchemas() {
+        if (this.#allowedTools.length === 0 || !this.#mcpClient)
+            return [];
+        const allowedNames = new Set(this.#allowedTools.map(t => t.getOptions().name));
+        const tools = await this.#mcpClient.getTools();
+        return tools.filter(t => allowedNames.has(t.name));
+    }
+    async #dispatchTool(call) {
+        if (!this.#allowedTools.map(t => t.getOptions().name).includes(call.name)) {
+            return { ...call, resultText: `Error: tool "${call.name}" not found or not allowed.` };
+        }
+        try {
+            const output = await this.#mcpClient.callTool(call.name, call.inputs, call.id);
+            return { ...call, resultText: JSON.stringify(output.output) };
+        }
+        catch (err) {
+            return { ...call, resultText: `Error: ${err?.message ?? String(err)}` };
+        }
+    }
+    #usageEntry(chat) {
+        return {
+            type: "main",
+            model: this.#provider.getModel(),
+            unit: "tokens",
+            inputMissTokens: chat.inputMissTokens ?? 0,
+            inputCacheTokens: chat.inputCacheTokens ?? 0,
+            outputTokens: chat.outputTokens ?? 0,
+        };
+    }
+    async run(input, streamCallback, previousMessages) {
+        const tools = await this.#getToolSchemas();
+        const toolsArg = tools.length ? tools : undefined;
+        const messages = previousMessages
+            ? [...previousMessages, { role: "user", content: input }]
+            : [
+                { role: "system", content: this.#safetyPolicies },
+                { role: "system", content: this.#instruction },
+                { role: "user", content: input },
+            ];
+        const chat = await this.#provider.chat(messages, streamCallback, toolsArg);
+        const usage = [this.#usageEntry(chat)];
+        const requestedCalls = chat.toolCalls ?? [];
+        messages.push({
+            role: "assistant",
+            content: chat.content,
+            ...(requestedCalls.length ? { toolCalls: requestedCalls } : {}),
+        });
+        if (requestedCalls.length === 0) {
+            return { content: chat.content, toolCalls: [], usage, messages };
+        }
+        const dispatched = [];
+        for (const call of requestedCalls) {
+            dispatched.push(await this.#dispatchTool(call));
+        }
+        for (const result of dispatched) {
+            messages.push({ role: "tool", content: result.resultText, toolCallId: result.id, toolName: result.name });
+        }
+        return { content: chat.content, toolCalls: dispatched, usage, messages };
+    }
+}
+export default StatelessAgent;
+//# sourceMappingURL=stateless-agent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stateless-agent.js","sourceRoot":"","sources":["../../src/core/stateless-agent.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -4,6 +4,10 @@ export { resolveThinkEffortLevel, clampThinkEffort } from "./core/think-effort.j
 export type { ThinkEffortLevel } from "./core/think-effort.js";
 export { BaseAgent } from "./core/base-agent.js";
 export type { ExtractedSegment, ParsedToolCall } from "./core/base-agent.js";
+export { StatelessAgent } from "./core/stateless-agent.js";
+export type { StatelessAgentProps, StatelessAgentResult, DispatchedToolCall } from "./core/stateless-agent.js";
+export { AIASK } from "./core/ai-ask.js";
+export type { AIAskProps, AIAskResult, AIAskOutputField, AIAskOutputStructure } from "./core/ai-ask.js";
 export { DeepSeekProvider } from "./core/deepseek-provider.js";
 export { OpenAIProvider } from "./core/openai-provider.js";
 export { AnthropicProvider } from "./core/anthropic-provider.js";
@@ -26,6 +30,8 @@ export { MCPFSStorage } from "./core/mcp-fs-storage.js";
 export { MCPOutputFilter, MCPFilter } from "./core/mcp-filter.js";
 export { MCPExecutionPolicy, MCPBypassExecutionPolicy } from "./core/mcp-execution-policy.js";
 export type { MCPToolCallRequest } from "./core/mcp-execution-policy.js";
+export { MCPAutoExecutionPolicy } from "./core/mcp-auto-execution-policy.js";
+export type { MCPAutoExecutionPolicyProps, MCPAutoExecutionPolicyVerdict } from "./core/mcp-auto-execution-policy.js";
 export { SimpleAgent } from "./templates/simple.js";
 export { SwarmBase } from "./core/swarm-base.js";
 export type { SwarmBaseProps, SwarmRunOptions, SwarmState, SwarmAgentState, SwarmStreamChunk, SwarmStreamCallback, SwarmAgentFailure } from "./core/swarm-base.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,6 +1,8 @@
 export { AIProvider } from "./core/ai-provider.js";
 export { resolveThinkEffortLevel, clampThinkEffort } from "./core/think-effort.js";
 export { BaseAgent } from "./core/base-agent.js";
+export { StatelessAgent } from "./core/stateless-agent.js";
+export { AIASK } from "./core/ai-ask.js";
 export { DeepSeekProvider } from "./core/deepseek-provider.js";
 export { OpenAIProvider } from "./core/openai-provider.js";
 export { AnthropicProvider } from "./core/anthropic-provider.js";
@@ -20,6 +22,7 @@ export { MCPStorage } from "./core/mcp-storage.js";
 export { MCPFSStorage } from "./core/mcp-fs-storage.js";
 export { MCPOutputFilter, MCPFilter } from "./core/mcp-filter.js";
 export { MCPExecutionPolicy, MCPBypassExecutionPolicy } from "./core/mcp-execution-policy.js";
+export { MCPAutoExecutionPolicy } from "./core/mcp-auto-execution-policy.js";
 export { SimpleAgent } from "./templates/simple.js";
 export { SwarmBase } from "./core/swarm-base.js";
 export { AgentDefinition, applyTextOverride, selectTools } from "./core/agent-definition.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAEnF,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAE5E,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAGpF,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAE9F,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAI7E,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGjD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAG7F,OAAO,EACH,aAAa,EACb,cAAc,EACd,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,GACrB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACH,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,SAAS,EACT,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,cAAc,GACjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEjG,OAAO,EACH,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,SAAS,GACZ,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACH,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,YAAY,GACf,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACH,cAAc,EACd,eAAe,EACf,cAAc,EACd,aAAa,EACb,eAAe,EACf,YAAY,EACZ,UAAU,EACV,UAAU,EACV,OAAO,GACV,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACH,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,SAAS,GACZ,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACH,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,GACnB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACH,kBAAkB,EAClB,mBAAmB,GACtB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/tests/core/ai-ask.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ai-ask.test.d.ts.map

package/dist/tests/core/ai-ask.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-ask.test.d.ts","sourceRoot":"","sources":["../../../src/tests/core/ai-ask.test.ts"],"names":[],"mappings":""}

package/dist/tests/core/ai-ask.test.js

@@ -0,0 +1,101 @@
+import { test, describe } from "node:test";
+import assert from "node:assert/strict";
+import { AIASK } from "../../index.js";
+import { ScriptedProvider } from "./scripted-provider.js";
+describe("core/ai-ask", () => {
+    test("run(): a valid first attempt returns immediately with valid:true, attempts:1", async () => {
+        const provider = new ScriptedProvider("p", () => ({
+            toolCalls: [{ name: "submit_answer", inputs: { valid: true, score: 7 } }],
+        }));
+        const ask = new AIASK({
+            instruction: "classify the input",
+            aiModel: provider,
+            outputStructure: [
+                { name: "valid", type: "boolean", description: "whether it's valid" },
+                { name: "score", type: "number", description: "confidence 0-10" },
+            ],
+        });
+        const result = await ask.run("check this");
+        assert.deepStrictEqual(result.output, { valid: true, score: 7 });
+        assert.strictEqual(result.valid, true);
+        assert.strictEqual(result.attempts, 1);
+        assert.strictEqual(result.errors, undefined);
+    });
+    test("run(): a missing required field triggers a retry, and a corrected 2nd attempt succeeds", async () => {
+        const provider = new ScriptedProvider("p", [
+            () => ({ toolCalls: [{ name: "submit_answer", inputs: { valid: true } }] }), // 1st attempt, missing "score"
+            () => ({ toolCalls: [{ name: "submit_answer", inputs: { valid: true, score: 9 } }] }), // 2nd attempt, corrected
+        ]);
+        const ask = new AIASK({
+            instruction: "classify the input",
+            aiModel: provider,
+            outputStructure: [
+                { name: "valid", type: "boolean", description: "whether it's valid" },
+                { name: "score", type: "number", description: "confidence 0-10" },
+            ],
+        });
+        const result = await ask.run("check this");
+        assert.deepStrictEqual(result.output, { valid: true, score: 9 });
+        assert.strictEqual(result.valid, true);
+        assert.strictEqual(result.attempts, 2);
+    });
+    test("run(): a wrong-typed field is rejected as invalid", async () => {
+        const provider = new ScriptedProvider("p", () => ({
+            toolCalls: [{ name: "submit_answer", inputs: { valid: "yes" } }], // should be boolean
+        }));
+        const ask = new AIASK({
+            instruction: "x",
+            aiModel: provider,
+            outputStructure: [{ name: "valid", type: "boolean", description: "d" }],
+        });
+        const result = await ask.run("go");
+        assert.strictEqual(result.valid, false);
+        assert.strictEqual(result.attempts, 3);
+        assert.match(result.errors[0], /should be boolean/);
+    });
+    test("run(): plain text instead of calling the tool counts as a failed attempt and retries", async () => {
+        const provider = new ScriptedProvider("p", [
+            () => ({ content: "I think it's valid" }), // no tool call at all
+            () => ({ toolCalls: [{ name: "submit_answer", inputs: { valid: true } }] }),
+        ]);
+        const ask = new AIASK({
+            instruction: "x",
+            aiModel: provider,
+            outputStructure: [{ name: "valid", type: "boolean", description: "d" }],
+        });
+        const result = await ask.run("go");
+        assert.strictEqual(result.valid, true);
+        assert.strictEqual(result.attempts, 2);
+    });
+    test("run(): gives up after 3 attempts, returning the last best-effort output with valid:false", async () => {
+        const provider = new ScriptedProvider("p", () => ({ content: "nope, just text" }));
+        const ask = new AIASK({
+            instruction: "x",
+            aiModel: provider,
+            outputStructure: [{ name: "valid", type: "boolean", description: "d" }],
+        });
+        const result = await ask.run("go");
+        assert.strictEqual(result.valid, false);
+        assert.strictEqual(result.attempts, 3);
+        assert.deepStrictEqual(result.output, {});
+        assert.strictEqual(result.errors.length, 1);
+        assert.strictEqual(provider.getCallCount(), 3, "one chat() call per attempt, no automatic follow-up");
+    });
+    test("run(): an optional field (required: false) may be omitted without failing validation", async () => {
+        const provider = new ScriptedProvider("p", () => ({
+            toolCalls: [{ name: "submit_answer", inputs: { valid: true } }],
+        }));
+        const ask = new AIASK({
+            instruction: "x",
+            aiModel: provider,
+            outputStructure: [
+                { name: "valid", type: "boolean", description: "d" },
+                { name: "note", type: "string", description: "d", required: false },
+            ],
+        });
+        const result = await ask.run("go");
+        assert.strictEqual(result.valid, true);
+        assert.strictEqual(result.attempts, 1);
+    });
+});
+//# sourceMappingURL=ai-ask.test.js.map

package/dist/tests/core/ai-ask.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-ask.test.js","sourceRoot":"","sources":["../../../src/tests/core/ai-ask.test.ts"],"names":[],"mappings":"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"}

package/dist/tests/core/mcp-auto-execution-policy.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mcp-auto-execution-policy.test.d.ts.map

package/dist/tests/core/mcp-auto-execution-policy.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-auto-execution-policy.test.d.ts","sourceRoot":"","sources":["../../../src/tests/core/mcp-auto-execution-policy.test.ts"],"names":[],"mappings":""}