@agent-native/core 0.5.0-dev.b51eaae → 0.6.1

package/dist/action.js

@@ -1,35 +1,232 @@
-/**
- * Define an agent action. Place in `actions/` directory -- auto-discovered by the framework.
- *
- * ```ts
- * // actions/list-events.ts
- * import { defineAction } from "@agent-native/core";
- *
- * export default defineAction({
- *   description: "List calendar events",
- *   parameters: {
- *     from: { type: "string", description: "Start date" },
- *     to: { type: "string", description: "End date" },
- *   },
- *   run: async (args) => {
- *     const events = await fetchEvents(args.from, args.to);
- *     return JSON.stringify(events, null, 2);
- *   },
- * });
- * ```
- */
 export function defineAction(options) {
+    const hasSchema = options.schema && "~standard" in options.schema;
+    // Build tool definition for the Claude API
+    let toolParameters;
+    if (hasSchema) {
+        // Convert Standard Schema to JSON Schema for Claude
+        toolParameters = schemaToJsonSchema(options.schema, options.description);
+    }
+    else if (options.parameters) {
+        toolParameters = {
+            type: "object",
+            properties: options.parameters,
+        };
+    }
+    // Wrap run() with validation when schema is provided.
+    // Pass toolParameters so the validation error can echo the expected signature
+    // (required vs optional fields) and help the caller self-correct.
+    const run = hasSchema
+        ? wrapWithValidation(options.schema, options.run, toolParameters)
+        : options.run;
     return {
         tool: {
             description: options.description,
-            parameters: options.parameters
-                ? {
-                    type: "object",
-                    properties: options.parameters,
-                }
-                : undefined,
+            parameters: toolParameters,
         },
-        run: options.run,
+        run,
+        ...(hasSchema ? { schema: options.schema } : {}),
+        ...(options.http !== undefined ? { http: options.http } : {}),
+    };
+}
+// ---------------------------------------------------------------------------
+// Schema → JSON Schema conversion
+// ---------------------------------------------------------------------------
+/**
+ * Convert a Standard Schema to JSON Schema for the Claude API.
+ * Tries vendor-specific toJSONSchema first (Zod v4), then falls back
+ * to a basic introspection of the schema shape.
+ */
+function schemaToJsonSchema(schema, _description) {
+    // Try Zod v4's toJSONSchema if available
+    const s = schema;
+    if (s._zod?.def) {
+        return zodDefToJsonSchema(s._zod.def);
+    }
+    // Try StandardJSONSchemaV1 interface (future-proof)
+    if (s["~standard"]?.jsonSchema?.input) {
+        try {
+            return s["~standard"].jsonSchema.input({
+                target: "draft-07",
+            });
+        }
+        catch {
+            // Fall through
+        }
+    }
+    // Fallback: empty object schema
+    return { type: "object", properties: {} };
+}
+/**
+ * Convert a Zod v4 internal def to JSON Schema.
+ * Handles the common types used in action parameters.
+ */
+function zodDefToJsonSchema(def) {
+    const type = def.type;
+    if (type === "object") {
+        const properties = {};
+        const required = [];
+        const shape = def.shape;
+        if (shape) {
+            for (const [key, fieldSchema] of Object.entries(shape)) {
+                const fieldDef = fieldSchema?._zod?.def;
+                if (fieldDef) {
+                    properties[key] = zodDefToJsonSchema(fieldDef);
+                    // Check if field is required (not optional, not default)
+                    if (fieldDef.type !== "optional" && fieldDef.type !== "default") {
+                        required.push(key);
+                    }
+                }
+            }
+        }
+        const result = { type: "object", properties };
+        if (required.length > 0)
+            result.required = required;
+        return result;
+    }
+    if (type === "string") {
+        const result = { type: "string" };
+        if (def.description)
+            result.description = def.description;
+        return result;
+    }
+    if (type === "number" || type === "float" || type === "int") {
+        const result = { type: type === "int" ? "integer" : "number" };
+        if (def.description)
+            result.description = def.description;
+        return result;
+    }
+    if (type === "boolean") {
+        const result = { type: "boolean" };
+        if (def.description)
+            result.description = def.description;
+        return result;
+    }
+    if (type === "enum") {
+        const result = { type: "string", enum: def.entries };
+        if (def.description)
+            result.description = def.description;
+        return result;
+    }
+    if (type === "literal") {
+        return { type: typeof def.value, enum: [def.value] };
+    }
+    if (type === "array") {
+        const result = { type: "array" };
+        if (def.element?._zod?.def) {
+            result.items = zodDefToJsonSchema(def.element._zod.def);
+        }
+        if (def.description)
+            result.description = def.description;
+        return result;
+    }
+    if (type === "optional") {
+        if (def.innerType?._zod?.def) {
+            return zodDefToJsonSchema(def.innerType._zod.def);
+        }
+    }
+    if (type === "default") {
+        if (def.innerType?._zod?.def) {
+            const inner = zodDefToJsonSchema(def.innerType._zod.def);
+            inner.default =
+                typeof def.defaultValue === "function"
+                    ? def.defaultValue()
+                    : def.defaultValue;
+            return inner;
+        }
+    }
+    if (type === "nullable") {
+        if (def.innerType?._zod?.def) {
+            return zodDefToJsonSchema(def.innerType._zod.def);
+        }
+    }
+    if (type === "union") {
+        if (def.options?.length) {
+            // Check if it's a simple enum-like union of literals
+            const allLiterals = def.options.every((o) => o?._zod?.def?.type === "literal");
+            if (allLiterals) {
+                return {
+                    type: "string",
+                    enum: def.options.map((o) => o._zod.def.value),
+                };
+            }
+            return {
+                anyOf: def.options.map((o) => zodDefToJsonSchema(o._zod?.def ?? {})),
+            };
+        }
+    }
+    // Fallback
+    return { type: "string" };
+}
+// ---------------------------------------------------------------------------
+// Runtime validation wrapper
+// ---------------------------------------------------------------------------
+/**
+ * Wrap an action's run function with schema validation.
+ * Invalid inputs get a clear error message (including what was actually passed)
+ * so the agent can see its own mistake and correct it on the next turn.
+ */
+function wrapWithValidation(schema, run, toolParameters) {
+    return async (args) => {
+        const result = await schema["~standard"].validate(args);
+        if (result.issues) {
+            // Split issues into "missing required field" vs other validation errors
+            // so the error message reads naturally rather than as "fieldName: Required".
+            const missing = [];
+            const other = [];
+            for (const issue of result.issues) {
+                const pathStr = issue.path
+                    ? issue.path.map((p) => (typeof p === "object" ? p.key : p)).join(".")
+                    : "";
+                const msg = String(issue.message ?? "");
+                // Zod emits "Required" for missing fields; other libraries may use
+                // similar wording. Treat any variant as "missing".
+                if (pathStr &&
+                    (msg === "Required" ||
+                        /invalid.*undefined/i.test(msg) ||
+                        /expected.*received undefined/i.test(msg))) {
+                    missing.push(pathStr);
+                }
+                else {
+                    other.push(pathStr ? `${pathStr}: ${msg}` : msg);
+                }
+            }
+            const parts = [];
+            if (missing.length > 0) {
+                parts.push(`Missing required parameter${missing.length === 1 ? "" : "s"}: ${missing.join(", ")}`);
+            }
+            if (other.length > 0) {
+                parts.push(other.join("; "));
+            }
+            // Echo the args that were actually passed so the caller (usually an
+            // agent) can see exactly what it sent and fix its next call.
+            let received;
+            try {
+                received = JSON.stringify(args);
+                if (received.length > 500)
+                    received = received.slice(0, 500) + "…";
+            }
+            catch {
+                received = String(args);
+            }
+            // Also show the EXPECTED signature so the agent doesn't have to guess.
+            // Format: `{ deckId*: string, content*: string, slideId?: string, ... }`
+            // where `*` = required, `?` = optional.
+            let expected = "";
+            if (toolParameters?.properties) {
+                const required = new Set(toolParameters.required ?? []);
+                const sig = Object.entries(toolParameters.properties)
+                    .map(([k, v]) => {
+                    const mark = required.has(k) ? "*" : "?";
+                    const type = v.type ?? "any";
+                    return `${k}${mark}: ${type}`;
+                })
+                    .join(", ");
+                if (sig)
+                    expected = ` Expected: { ${sig} } (where * = required, ? = optional).`;
+            }
+            throw new Error(`Invalid action parameters — ${parts.join(". ")}. Received: ${received}.${expected}`);
+        }
+        return run(result.value);
     };
 }
 //# sourceMappingURL=action.js.map

package/dist/action.js.map

@@ -1 +1 @@
-{"version":3,"file":"action.js","sourceRoot":"","sources":["../src/action.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,YAAY,CAAC,OAA4B;IACvD,OAAO;QACL,IAAI,EAAE;YACJ,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC5B,CAAC,CAAC;oBACE,IAAI,EAAE,QAAiB;oBACvB,UAAU,EAAE,OAAO,CAAC,UAAU;iBAC/B;gBACH,CAAC,CAAC,SAAS;SACd;QACD,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"action.js","sourceRoot":"","sources":["../src/action.ts"],"names":[],"mappings":"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"}

package/dist/agent/engine/ai-sdk-engine.d.ts

@@ -0,0 +1,24 @@
+/**
+ * AISDKEngine — wraps the Vercel AI SDK (ai package) for multi-provider support.
+ *
+ * Supports Anthropic, OpenAI, Google Gemini, Groq, and any provider with an
+ * @ai-sdk/* package. Provider is selected via the `provider` config option.
+ *
+ * When provider is "anthropic", Anthropic-native features (thinking, cacheControl)
+ * are forwarded through the AI SDK's providerOptions mechanism — no fidelity loss
+ * compared to the native AnthropicEngine.
+ *
+ * The ai package is an OPTIONAL peer dependency. This engine uses dynamic import()
+ * so the core package remains installable without the AI SDK.
+ */
+import type { AgentEngine, EngineCapabilities } from "./types.js";
+export type AISDKProvider = "anthropic" | "openai" | "google" | "groq" | "mistral" | "cohere" | "ollama";
+declare const PROVIDER_CAPABILITIES: Record<AISDKProvider, EngineCapabilities>;
+declare const PROVIDER_DEFAULT_MODELS: Record<AISDKProvider, string>;
+declare const PROVIDER_SUPPORTED_MODELS: Record<AISDKProvider, readonly string[]>;
+declare const PROVIDER_ENV_VARS: Record<AISDKProvider, string[]>;
+declare const PROVIDER_PACKAGES: Record<AISDKProvider, string>;
+export declare const AISDK_ASSISTANT_CONTENT_KEY: unique symbol;
+export declare function createAISDKEngine(provider: AISDKProvider, config?: Record<string, unknown>): AgentEngine;
+export { PROVIDER_CAPABILITIES, PROVIDER_DEFAULT_MODELS, PROVIDER_SUPPORTED_MODELS, PROVIDER_ENV_VARS, PROVIDER_PACKAGES, };
+//# sourceMappingURL=ai-sdk-engine.d.ts.map

package/dist/agent/engine/ai-sdk-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-sdk-engine.d.ts","sourceRoot":"","sources":["../../../src/agent/engine/ai-sdk-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EAGnB,MAAM,YAAY,CAAC;AAYpB,MAAM,MAAM,aAAa,GACrB,WAAW,GACX,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,SAAS,GACT,QAAQ,GACR,QAAQ,CAAC;AAEb,QAAA,MAAM,qBAAqB,EAAE,MAAM,CAAC,aAAa,EAAE,kBAAkB,CAkDpE,CAAC;AAEF,QAAA,MAAM,uBAAuB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAQ1D,CAAC;AAEF,QAAA,MAAM,yBAAyB,EAAE,MAAM,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAmCvE,CAAC;AAEF,QAAA,MAAM,iBAAiB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,CAQtD,CAAC;AAEF,QAAA,MAAM,iBAAiB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAQpD,CAAC;AAsKF,eAAO,MAAM,2BAA2B,eAAkC,CAAC;AAM3E,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,aAAa,EACvB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,WAAW,CAEb;AAsBD,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,yBAAyB,EACzB,iBAAiB,EACjB,iBAAiB,GAClB,CAAC"}

package/dist/agent/engine/ai-sdk-engine.js

@@ -0,0 +1,302 @@
+/**
+ * AISDKEngine — wraps the Vercel AI SDK (ai package) for multi-provider support.
+ *
+ * Supports Anthropic, OpenAI, Google Gemini, Groq, and any provider with an
+ * @ai-sdk/* package. Provider is selected via the `provider` config option.
+ *
+ * When provider is "anthropic", Anthropic-native features (thinking, cacheControl)
+ * are forwarded through the AI SDK's providerOptions mechanism — no fidelity loss
+ * compared to the native AnthropicEngine.
+ *
+ * The ai package is an OPTIONAL peer dependency. This engine uses dynamic import()
+ * so the core package remains installable without the AI SDK.
+ */
+import { engineToolsToAISDK, engineMessagesToAISDK, aiSdkPartToEngineEvents, aiSdkStepToAssistantContent, } from "./translate-ai-sdk.js";
+const PROVIDER_CAPABILITIES = {
+    anthropic: {
+        thinking: true,
+        promptCaching: true,
+        vision: true,
+        computerUse: false, // not exposed through AI SDK yet
+        parallelToolCalls: true,
+    },
+    openai: {
+        thinking: false,
+        promptCaching: false,
+        vision: true,
+        computerUse: false,
+        parallelToolCalls: true,
+    },
+    google: {
+        thinking: true,
+        promptCaching: false,
+        vision: true,
+        computerUse: false,
+        parallelToolCalls: true,
+    },
+    groq: {
+        thinking: false,
+        promptCaching: false,
+        vision: false,
+        computerUse: false,
+        parallelToolCalls: true,
+    },
+    mistral: {
+        thinking: false,
+        promptCaching: false,
+        vision: false,
+        computerUse: false,
+        parallelToolCalls: true,
+    },
+    cohere: {
+        thinking: false,
+        promptCaching: false,
+        vision: false,
+        computerUse: false,
+        parallelToolCalls: true,
+    },
+    ollama: {
+        thinking: false,
+        promptCaching: false,
+        vision: false,
+        computerUse: false,
+        parallelToolCalls: false,
+    },
+};
+const PROVIDER_DEFAULT_MODELS = {
+    anthropic: "claude-sonnet-4-6",
+    openai: "gpt-4o",
+    google: "gemini-2.0-flash",
+    groq: "llama-3.3-70b-versatile",
+    mistral: "mistral-large-latest",
+    cohere: "command-r-plus",
+    ollama: "llama3.1",
+};
+const PROVIDER_SUPPORTED_MODELS = {
+    anthropic: [
+        "claude-opus-4-6",
+        "claude-sonnet-4-6",
+        "claude-haiku-4-5-20251001",
+        "claude-opus-4-5",
+        "claude-sonnet-4-5",
+    ],
+    openai: [
+        "gpt-4o",
+        "gpt-4o-mini",
+        "gpt-4-turbo",
+        "o1",
+        "o1-mini",
+        "o3",
+        "o3-mini",
+    ],
+    google: [
+        "gemini-2.0-flash",
+        "gemini-2.0-pro",
+        "gemini-1.5-pro",
+        "gemini-1.5-flash",
+    ],
+    groq: [
+        "llama-3.3-70b-versatile",
+        "llama-3.1-70b-versatile",
+        "mixtral-8x7b-32768",
+    ],
+    mistral: [
+        "mistral-large-latest",
+        "mistral-medium-latest",
+        "mistral-small-latest",
+    ],
+    cohere: ["command-r-plus", "command-r"],
+    ollama: ["llama3.1", "llama3.2", "mistral", "codestral"],
+};
+const PROVIDER_ENV_VARS = {
+    anthropic: ["ANTHROPIC_API_KEY"],
+    openai: ["OPENAI_API_KEY"],
+    google: ["GOOGLE_GENERATIVE_AI_API_KEY"],
+    groq: ["GROQ_API_KEY"],
+    mistral: ["MISTRAL_API_KEY"],
+    cohere: ["COHERE_API_KEY"],
+    ollama: [], // runs locally
+};
+const PROVIDER_PACKAGES = {
+    anthropic: "@ai-sdk/anthropic",
+    openai: "@ai-sdk/openai",
+    google: "@ai-sdk/google",
+    groq: "@ai-sdk/groq",
+    mistral: "@ai-sdk/mistral",
+    cohere: "@ai-sdk/cohere",
+    ollama: "ollama-ai-provider",
+};
+// ---------------------------------------------------------------------------
+// AISDKEngine implementation
+// ---------------------------------------------------------------------------
+class AISDKEngine {
+    name;
+    label;
+    defaultModel;
+    supportedModels;
+    capabilities;
+    provider;
+    apiKey;
+    baseUrl;
+    constructor(provider, config) {
+        this.provider = provider;
+        this.name = `ai-sdk:${provider}`;
+        this.label = `${capitalize(provider)} (AI SDK)`;
+        this.defaultModel =
+            config.model ?? PROVIDER_DEFAULT_MODELS[provider];
+        this.supportedModels = PROVIDER_SUPPORTED_MODELS[provider];
+        this.capabilities = PROVIDER_CAPABILITIES[provider];
+        this.apiKey =
+            config.apiKey ?? getProviderApiKey(provider);
+        this.baseUrl = config.baseUrl;
+    }
+    async *stream(opts) {
+        let aiModule;
+        try {
+            aiModule = await import("ai");
+        }
+        catch {
+            yield {
+                type: "stop",
+                reason: "error",
+                error: `The "ai" package is not installed. Run: pnpm add ai ${PROVIDER_PACKAGES[this.provider]}`,
+            };
+            return;
+        }
+        const { streamText, jsonSchema } = aiModule;
+        let providerModel;
+        try {
+            providerModel = await this.createProviderModel(opts.model);
+        }
+        catch (err) {
+            yield {
+                type: "stop",
+                reason: "error",
+                error: err?.message ?? String(err),
+            };
+            return;
+        }
+        const aiSdkTools = opts.tools.length > 0
+            ? engineToolsToAISDK(opts.tools, jsonSchema)
+            : undefined;
+        const messages = engineMessagesToAISDK(opts.messages);
+        // Build providerOptions for Anthropic-native features when using Anthropic provider
+        const providerOpts = {};
+        if (this.provider === "anthropic" && opts.providerOptions?.anthropic) {
+            const anthropicOpts = opts.providerOptions.anthropic;
+            if (anthropicOpts.thinking) {
+                providerOpts.anthropic = {
+                    ...(providerOpts.anthropic ?? {}),
+                    thinking: {
+                        type: "enabled",
+                        budgetTokens: anthropicOpts.thinking.budgetTokens,
+                    },
+                };
+            }
+            if (anthropicOpts.cacheControl) {
+                // AI SDK v5 supports cache_control via system message providerOptions
+                providerOpts.anthropic = {
+                    ...(providerOpts.anthropic ?? {}),
+                    cacheControl: anthropicOpts.cacheControl,
+                };
+            }
+        }
+        try {
+            const result = streamText({
+                model: providerModel,
+                system: opts.systemPrompt,
+                messages,
+                tools: aiSdkTools,
+                maxTokens: opts.maxTokens ?? 16384,
+                ...(opts.temperature !== undefined
+                    ? { temperature: opts.temperature }
+                    : {}),
+                abortSignal: opts.abortSignal,
+                // One step only — runAgentLoop drives the loop
+                maxSteps: 1,
+                // Collect tool calls but don't auto-execute them
+                experimental_toolCallStreaming: false,
+                ...(Object.keys(providerOpts).length > 0
+                    ? { providerOptions: providerOpts }
+                    : {}),
+            });
+            let hasEmittedStop = false;
+            let assistantContent = [];
+            for await (const part of result.fullStream) {
+                const events = aiSdkPartToEngineEvents(part);
+                for (const event of events) {
+                    yield event;
+                    if (event.type === "stop")
+                        hasEmittedStop = true;
+                }
+                // Capture step finish for assistant content reconstruction
+                if (part.type === "step-finish") {
+                    assistantContent = aiSdkStepToAssistantContent(part);
+                    opts[AISDK_ASSISTANT_CONTENT_KEY] = assistantContent;
+                }
+            }
+            if (!hasEmittedStop) {
+                yield { type: "stop", reason: "end_turn" };
+            }
+        }
+        catch (err) {
+            yield {
+                type: "stop",
+                reason: "error",
+                error: err?.message ?? String(err),
+            };
+            throw err;
+        }
+    }
+    async createProviderModel(model) {
+        const pkg = PROVIDER_PACKAGES[this.provider];
+        let providerModule;
+        try {
+            providerModule = await import(/* @vite-ignore */ pkg);
+        }
+        catch {
+            throw new Error(`Provider package "${pkg}" is not installed. Run: pnpm add ai ${pkg}`);
+        }
+        const createFnName = `create${capitalize(this.provider)}`;
+        const createFn = providerModule[createFnName] ?? providerModule.default;
+        if (typeof createFn !== "function") {
+            throw new Error(`Could not find provider factory in "${pkg}"`);
+        }
+        const config = {};
+        if (this.apiKey)
+            config.apiKey = this.apiKey;
+        if (this.baseUrl)
+            config.baseURL = this.baseUrl;
+        const provider = createFn(config);
+        return provider(model);
+    }
+}
+// ---------------------------------------------------------------------------
+// Symbol for assistant content pass-through
+// ---------------------------------------------------------------------------
+export const AISDK_ASSISTANT_CONTENT_KEY = Symbol("aiSdkAssistantContent");
+// ---------------------------------------------------------------------------
+// Factory functions
+// ---------------------------------------------------------------------------
+export function createAISDKEngine(provider, config = {}) {
+    return new AISDKEngine(provider, config);
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+function getProviderApiKey(provider) {
+    const envVars = PROVIDER_ENV_VARS[provider];
+    for (const v of envVars) {
+        if (process.env[v])
+            return process.env[v];
+    }
+    return undefined;
+}
+// ---------------------------------------------------------------------------
+// Exports for registry registration
+// ---------------------------------------------------------------------------
+export { PROVIDER_CAPABILITIES, PROVIDER_DEFAULT_MODELS, PROVIDER_SUPPORTED_MODELS, PROVIDER_ENV_VARS, PROVIDER_PACKAGES, };
+//# sourceMappingURL=ai-sdk-engine.js.map

package/dist/agent/engine/ai-sdk-engine.js.map

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

package/dist/agent/engine/anthropic-engine.d.ts

@@ -0,0 +1,24 @@
+/**
+ * AnthropicEngine — wraps @anthropic-ai/sdk for use as an AgentEngine.
+ *
+ * This is the default, best-in-class engine. It supports all Anthropic-native
+ * features: extended thinking, prompt caching, vision, computer use, and
+ * parallel tool calls.
+ *
+ * All providerOptions.anthropic fields are forwarded directly to the SDK.
+ */
+import type { AgentEngine, EngineCapabilities } from "./types.js";
+export declare const ANTHROPIC_CAPABILITIES: EngineCapabilities;
+export declare const ANTHROPIC_SUPPORTED_MODELS: readonly ["claude-opus-4-6", "claude-sonnet-4-6", "claude-haiku-4-5-20251001", "claude-opus-4-5", "claude-sonnet-4-5", "claude-haiku-4-5"];
+export declare const ANTHROPIC_DEFAULT_MODEL = "claude-sonnet-4-6";
+/**
+ * Symbol used by AnthropicEngine to return the final assistant content blocks
+ * back to runAgentLoop without changing the EngineEvent stream shape.
+ */
+export declare const ASSISTANT_CONTENT_KEY: unique symbol;
+/**
+ * Create an AnthropicEngine instance.
+ * Falls back to ANTHROPIC_API_KEY env var if no key is provided.
+ */
+export declare function createAnthropicEngine(config?: Record<string, unknown>): AgentEngine;
+//# sourceMappingURL=anthropic-engine.d.ts.map

package/dist/agent/engine/anthropic-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-engine.d.ts","sourceRoot":"","sources":["../../../src/agent/engine/anthropic-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EAInB,MAAM,YAAY,CAAC;AAQpB,eAAO,MAAM,sBAAsB,EAAE,kBAMpC,CAAC;AAEF,eAAO,MAAM,0BAA0B,4IAO7B,CAAC;AAEX,eAAO,MAAM,uBAAuB,sBAAsB,CAAC;AAiI3D;;;GAGG;AACH,eAAO,MAAM,qBAAqB,eAA6B,CAAC;AAEhE;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,WAAW,CAuBb"}