@cuylabs/agent-core 0.7.0 → 0.9.0

package/dist/chunk-ZPMACVZK.js

@@ -1,305 +0,0 @@
-import {
-  extractModelId,
-  extractProvider,
-  getDefaultResolver,
-  likelySupportsReasoning
-} from "./chunk-QGOGIP7T.js";
-
-// src/reasoning/types.ts
-var STANDARD_LEVELS = ["off", "low", "medium", "high"];
-var EXTENDED_LEVELS = ["off", "minimal", "low", "medium", "high", "xhigh"];
-var FIXED_LEVELS = ["medium"];
-function shouldIncludeReasoningSummary() {
-  if (typeof process !== "undefined" && process.env) {
-    return process.env.CODE_AGENT_DISABLE_REASONING_SUMMARY !== "true";
-  }
-  return true;
-}
-
-// src/reasoning/providers.ts
-function buildOpenAIOptions(level, compat) {
-  if (level === "off") return void 0;
-  const options = {};
-  if (compat?.supportsReasoningEffort !== false) {
-    options.reasoningEffort = level;
-  }
-  if (shouldIncludeReasoningSummary()) {
-    options.reasoningSummary = "auto";
-  }
-  return options;
-}
-var ANTHROPIC_BUDGETS = {
-  off: 0,
-  minimal: 2e3,
-  low: 4e3,
-  medium: 8e3,
-  high: 16e3,
-  xhigh: 31999
-};
-function buildAnthropicOptions(level) {
-  if (level === "off") return void 0;
-  return {
-    thinking: {
-      type: "enabled",
-      budgetTokens: ANTHROPIC_BUDGETS[level]
-    }
-  };
-}
-var GOOGLE_BUDGETS = {
-  off: 0,
-  minimal: 2e3,
-  low: 4e3,
-  medium: 8e3,
-  high: 16e3,
-  xhigh: 24576
-};
-function buildGoogleOptions(level, modelId) {
-  if (level === "off") return void 0;
-  if (modelId?.includes("gemini-3") || modelId?.includes("gemini-4")) {
-    return {
-      thinkingConfig: {
-        includeThoughts: true,
-        thinkingLevel: level === "high" || level === "xhigh" ? "high" : "low"
-      }
-    };
-  }
-  return {
-    thinkingConfig: {
-      includeThoughts: true,
-      thinkingBudget: GOOGLE_BUDGETS[level]
-    }
-  };
-}
-function buildXAIOptions(level) {
-  if (level === "off") return void 0;
-  return { reasoningEffort: level };
-}
-function buildGroqOptions(level) {
-  if (level === "off") return void 0;
-  return {
-    includeThoughts: true,
-    thinkingLevel: level === "high" || level === "xhigh" ? "high" : "low"
-  };
-}
-var BEDROCK_ANTHROPIC_BUDGETS = {
-  off: 0,
-  minimal: 2e3,
-  low: 4e3,
-  medium: 8e3,
-  high: 16e3,
-  xhigh: 31999
-};
-function buildBedrockOptions(level, modelId) {
-  if (level === "off") return void 0;
-  if (modelId?.includes("anthropic") || modelId?.includes("claude")) {
-    return {
-      reasoningConfig: {
-        type: "enabled",
-        budgetTokens: BEDROCK_ANTHROPIC_BUDGETS[level]
-      }
-    };
-  }
-  return {
-    reasoningConfig: {
-      type: "enabled",
-      maxReasoningEffort: level
-    }
-  };
-}
-function buildOpenRouterOptions(level) {
-  if (level === "off") return void 0;
-  return {
-    reasoning: { effort: level }
-  };
-}
-var PROVIDER_KEY_MAP = {
-  "openai.chat": "openai",
-  "openai.responses": "openai",
-  "anthropic.messages": "anthropic",
-  "google.generative-ai": "google",
-  "bedrock": "bedrock",
-  "azure": "azure",
-  "xai": "xai",
-  "deepinfra": "deepinfra",
-  "togetherai": "togetherai",
-  "groq": "groq",
-  "mistral": "mistral"
-};
-function getProviderOptionsKey(provider) {
-  return PROVIDER_KEY_MAP[provider] || provider.split(".")[0] || "unknown";
-}
-
-// src/reasoning/config.ts
-async function getReasoningConfig(model) {
-  const resolver = getDefaultResolver();
-  const result = await resolver.resolve(model);
-  const { capabilities, compatibility } = result.entry;
-  const provider = extractProvider(model);
-  const modelId = extractModelId(model).toLowerCase();
-  if (!capabilities.reasoning) {
-    return {
-      supportsReasoning: false,
-      availableLevels: ["off"],
-      getProviderOptions: () => void 0
-    };
-  }
-  if (provider?.includes("openai") || modelId.includes("gpt") || modelId.match(/^o[134]/)) {
-    if (modelId === "o1-mini") {
-      return {
-        supportsReasoning: true,
-        availableLevels: FIXED_LEVELS,
-        getProviderOptions: () => void 0
-      };
-    }
-    const isAdvanced = modelId.includes("gpt-5") || modelId.includes("o3") || modelId.includes("o4");
-    return {
-      supportsReasoning: true,
-      availableLevels: isAdvanced ? EXTENDED_LEVELS : STANDARD_LEVELS,
-      getProviderOptions: (level) => buildOpenAIOptions(level, compatibility)
-    };
-  }
-  if (provider?.includes("anthropic") || modelId.includes("claude")) {
-    return {
-      supportsReasoning: true,
-      availableLevels: ["off", "low", "medium", "high"],
-      getProviderOptions: buildAnthropicOptions
-    };
-  }
-  if (provider?.includes("google") || modelId.includes("gemini")) {
-    return {
-      supportsReasoning: true,
-      availableLevels: STANDARD_LEVELS,
-      getProviderOptions: (level) => buildGoogleOptions(level, modelId)
-    };
-  }
-  if (provider?.includes("xai") || modelId.includes("grok")) {
-    return {
-      supportsReasoning: true,
-      availableLevels: STANDARD_LEVELS,
-      getProviderOptions: buildXAIOptions
-    };
-  }
-  if (provider?.includes("bedrock")) {
-    return {
-      supportsReasoning: true,
-      availableLevels: STANDARD_LEVELS,
-      getProviderOptions: (level) => buildBedrockOptions(level, modelId)
-    };
-  }
-  if (provider?.includes("groq")) {
-    return {
-      supportsReasoning: true,
-      availableLevels: ["off", "low", "high"],
-      getProviderOptions: buildGroqOptions
-    };
-  }
-  if (provider?.includes("openrouter")) {
-    return {
-      supportsReasoning: true,
-      availableLevels: STANDARD_LEVELS,
-      getProviderOptions: buildOpenRouterOptions
-    };
-  }
-  if (modelId.includes("r1") || modelId.includes("deepseek")) {
-    return {
-      supportsReasoning: true,
-      availableLevels: FIXED_LEVELS,
-      getProviderOptions: () => void 0
-    };
-  }
-  return {
-    supportsReasoning: true,
-    availableLevels: STANDARD_LEVELS,
-    getProviderOptions: (level) => buildOpenAIOptions(level, compatibility)
-  };
-}
-function getReasoningConfigSync(model) {
-  const modelId = extractModelId(model).toLowerCase();
-  const provider = extractProvider(model) || "";
-  const supportsReasoning2 = modelId.match(/^o[134]/) !== null || modelId.includes("gpt-5") || modelId.includes("r1") || modelId.includes("thinking") || modelId.includes("reasoning") || modelId.includes("grok") && modelId.includes("mini");
-  if (!supportsReasoning2) {
-    return {
-      supportsReasoning: false,
-      availableLevels: ["off"],
-      getProviderOptions: () => void 0
-    };
-  }
-  const isOpenAI = provider.includes("openai") || !!modelId.match(/^o[134]/) || modelId.includes("gpt");
-  const isAnthropic = provider.includes("anthropic") || modelId.includes("claude");
-  const isGoogle = provider.includes("google") || modelId.includes("gemini");
-  const isXAI = provider.includes("xai") || modelId.includes("grok");
-  const isBedrock = provider.includes("bedrock");
-  const isGroq = provider.includes("groq");
-  const isOpenRouter = provider.includes("openrouter");
-  return {
-    supportsReasoning: true,
-    availableLevels: STANDARD_LEVELS,
-    getProviderOptions: (level) => {
-      if (level === "off") return void 0;
-      if (isOpenAI) {
-        const opts = { reasoningEffort: level };
-        if (shouldIncludeReasoningSummary()) opts.reasoningSummary = "auto";
-        return opts;
-      }
-      if (isAnthropic) return buildAnthropicOptions(level);
-      if (isGoogle) return buildGoogleOptions(level, modelId);
-      if (isXAI) return buildXAIOptions(level);
-      if (isBedrock) return buildBedrockOptions(level, modelId);
-      if (isGroq) return buildGroqOptions(level);
-      if (isOpenRouter) return buildOpenRouterOptions(level);
-      const defaultOpts = { reasoningEffort: level };
-      if (shouldIncludeReasoningSummary()) defaultOpts.reasoningSummary = "auto";
-      return defaultOpts;
-    }
-  };
-}
-async function buildReasoningOptions(model, level) {
-  if (level === "off") return void 0;
-  const config = await getReasoningConfig(model);
-  if (!config.supportsReasoning) return void 0;
-  const effectiveLevel = config.availableLevels.includes(level) ? level : config.availableLevels[config.availableLevels.length - 1];
-  const options = config.getProviderOptions(effectiveLevel);
-  if (!options) return void 0;
-  const provider = extractProvider(model) || "";
-  const providerKey = getProviderOptionsKey(provider);
-  return { [providerKey]: options };
-}
-function buildReasoningOptionsSync(model, level) {
-  if (level === "off") return void 0;
-  const config = getReasoningConfigSync(model);
-  if (!config.supportsReasoning) return void 0;
-  const effectiveLevel = config.availableLevels.includes(level) ? level : config.availableLevels[config.availableLevels.length - 1];
-  const options = config.getProviderOptions(effectiveLevel);
-  if (!options) return void 0;
-  const provider = extractProvider(model) || "";
-  const providerKey = getProviderOptionsKey(provider);
-  return { [providerKey]: options };
-}
-async function supportsReasoning(model) {
-  const resolver = getDefaultResolver();
-  return resolver.supportsReasoning(model);
-}
-function supportsReasoningSync(model) {
-  return likelySupportsReasoning(extractModelId(model));
-}
-
-export {
-  STANDARD_LEVELS,
-  EXTENDED_LEVELS,
-  FIXED_LEVELS,
-  shouldIncludeReasoningSummary,
-  buildOpenAIOptions,
-  buildAnthropicOptions,
-  buildGoogleOptions,
-  buildXAIOptions,
-  buildGroqOptions,
-  buildBedrockOptions,
-  buildOpenRouterOptions,
-  getProviderOptionsKey,
-  getReasoningConfig,
-  getReasoningConfigSync,
-  buildReasoningOptions,
-  buildReasoningOptionsSync,
-  supportsReasoning,
-  supportsReasoningSync
-};

package/dist/index-CfBGYrpd.d.ts

@@ -1,317 +0,0 @@
-import { h as AgentMiddleware } from './runner-DSKaEz3z.js';
-import { TelemetrySettings } from 'ai';
-
-/**
- * Risk level for operations.
- */
-type RiskLevel = "safe" | "moderate" | "dangerous";
-/**
- * User response to an approval request.
- */
-type ApprovalAction = "allow" | "deny" | "remember";
-/**
- * Approval request sent to the UI/handler.
- */
-interface ApprovalRequest {
-    /** Unique request ID */
-    id: string;
-    /** Session ID */
-    sessionId: string;
-    /** Tool name */
-    tool: string;
-    /** Tool arguments */
-    args: unknown;
-    /** Human-readable description */
-    description: string;
-    /** Risk level */
-    risk: RiskLevel;
-    /** Patterns that would be remembered if "remember" is chosen */
-    patterns: string[];
-    /** Timestamp */
-    timestamp: number;
-}
-/**
- * Rule for auto-approving/denying operations.
- */
-interface ApprovalRule {
-    /** Pattern to match (glob-style) */
-    pattern: string;
-    /** Tool to match (`*` for all) */
-    tool: string;
-    /** Action to take */
-    action: "allow" | "deny";
-}
-/**
- * Configuration for the approval handler.
- */
-interface ApprovalConfig {
-    /** Default action when no rule matches (default: "ask") */
-    defaultAction?: "allow" | "deny" | "ask";
-    /** Pre-configured rules */
-    rules?: ApprovalRule[];
-    /** Handler for approval requests */
-    onRequest?: (request: ApprovalRequest) => Promise<ApprovalAction>;
-    /** Timeout for approval requests in ms (default: 5 minutes) */
-    timeout?: number;
-}
-
-/**
- * Approval Middleware
- *
- * Wraps the existing approval system as an AgentMiddleware.
- * This is how approval finally gets wired into the tool execution
- * pipeline — no more dead code.
- *
- * @example
- * ```typescript
- * import { createAgent, approvalMiddleware } from "@cuylabs/agent-core";
- *
- * const agent = createAgent({
- *   model: anthropic("claude-sonnet-4-20250514"),
- *   tools: [read, write, bash],
- *   middleware: [
- *     approvalMiddleware({
- *       rules: [
- *         { pattern: "src/*", tool: "read_file", action: "allow" },
- *       ],
- *       onRequest: async (req) => {
- *         // Prompt user in your UI
- *         return await askUser(req);
- *       },
- *     }),
- *   ],
- * });
- * ```
- */
-
-/**
- * Configuration for the approval middleware.
- *
- * Extends the existing ApprovalConfig with middleware-specific options.
- */
-interface ApprovalMiddlewareConfig extends ApprovalConfig {
-    /**
-     * Custom risk classification for tools.
-     *
-     * Overrides the built-in risk map. Tools not listed here
-     * fall back to the default classification.
-     *
-     * @example
-     * ```typescript
-     * customRisks: {
-     *   "my_deploy_tool": "dangerous",
-     *   "my_lint_tool": "safe",
-     * }
-     * ```
-     */
-    customRisks?: Record<string, RiskLevel>;
-}
-/**
- * Create an approval middleware from an ApprovalConfig.
- *
- * This bridges the existing `createApprovalHandler` into the middleware
- * system. The `beforeToolCall` hook checks rules, classifies risk,
- * and calls the approval handler when needed.
- *
- * @param config - Approval configuration (rules, handler, timeout, etc.)
- * @returns An AgentMiddleware that gates tool execution
- */
-declare function approvalMiddleware(config?: ApprovalMiddlewareConfig): AgentMiddleware;
-
-/**
- * Configuration for the OpenTelemetry middleware.
- */
-interface OtelMiddlewareConfig {
-    /**
-     * Whether to record tool call arguments as span attributes.
-     * Defaults to `true`.
-     */
-    recordInputs?: boolean;
-    /**
-     * Whether to record tool results as span attributes.
-     * Defaults to `true`.
-     */
-    recordOutputs?: boolean;
-    /**
-     * Agent name — used in the root span name and attributes.
-     * Falls back to `"agent"`.
-     */
-    agentName?: string;
-    /** Agent description — recorded as `gen_ai.agent.description`. */
-    agentDescription?: string;
-    /**
-     * Whether to emit `execute_tool` spans for tool calls.
-     * Defaults to `true`.
-     */
-    emitToolSpans?: boolean;
-    /**
-     * TTL in milliseconds for orphaned spans.
-     * Defaults to 5 minutes.
-     */
-    spanTimeoutMs?: number;
-}
-/**
- * Configuration for `createTelemetryConfig()`.
- */
-interface TelemetryConfig {
-    /** Agent name — used in span names and `gen_ai.agent.name`. */
-    agentName: string;
-    /** Agent description — recorded as `gen_ai.agent.description`. */
-    agentDescription?: string;
-    /** Record tool arguments and LLM prompts in spans. Defaults to `true`. */
-    recordInputs?: boolean;
-    /** Record tool results and LLM responses in spans. Defaults to `true`. */
-    recordOutputs?: boolean;
-    /** Emit `execute_tool` spans from our middleware. Defaults to `true`. */
-    emitToolSpans?: boolean;
-    /** TTL in ms for orphaned spans. Defaults to 5 minutes. */
-    spanTimeoutMs?: number;
-    /**
-     * An OTel `SpanProcessor` to auto-create and register a `NodeTracerProvider`.
-     */
-    spanProcessor?: unknown;
-    /**
-     * OTel service name for the `NodeTracerProvider` resource.
-     * Defaults to `agentName`.
-     */
-    serviceName?: string;
-}
-/**
- * Result of `createTelemetryConfig()`.
- */
-interface TelemetryConfigResult {
-    /** Agent-core middleware. */
-    middleware: AgentMiddleware;
-    /** AI SDK telemetry settings. */
-    telemetry: TelemetrySettings;
-    /**
-     * Flush and shut down the auto-created tracer provider.
-     * No-op when no provider was auto-created.
-     */
-    shutdown: () => Promise<void>;
-}
-
-declare function otelMiddleware(config?: OtelMiddlewareConfig): AgentMiddleware;
-
-declare function createTelemetryConfig(config: TelemetryConfig): TelemetryConfigResult;
-
-/**
- * Prompt Cache Middleware — Type definitions.
- *
- * Defines the configuration for provider-specific prompt caching.
- * Currently supports Anthropic's `cache_control` with ephemeral breakpoints.
- */
-/**
- * Supported cache TTL values for Anthropic prompt caching.
- *
- * - `"5m"` — 5-minute cache (default, ~90% input cost reduction)
- * - `"1h"` — 1-hour cache (higher write cost, but longer retention)
- */
-type CacheTTL = "5m" | "1h";
-/**
- * Configuration for the prompt cache middleware.
- *
- * @example
- * ```typescript
- * // Default — auto-detect Anthropic, 5-minute TTL
- * promptCacheMiddleware()
- *
- * // Custom TTL
- * promptCacheMiddleware({ ttl: "1h" })
- *
- * // Custom breakpoint strategy
- * promptCacheMiddleware({
- *   messageBreakpoints: 2,   // cache system + 2 message boundaries
- * })
- * ```
- */
-interface PromptCacheConfig {
-    /**
-     * Cache TTL. Defaults to `"5m"` (Anthropic's default).
-     *
-     * - `"5m"` — 5 minutes. 1.25× write, 0.1× read.
-     * - `"1h"` — 1 hour. Higher write cost, longer retention.
-     */
-    ttl?: CacheTTL;
-    /**
-     * Number of cache breakpoints to place on conversation messages.
-     *
-     * Anthropic allows up to 4 breakpoints total. The system prompt always
-     * gets one. This controls how many additional breakpoints are placed
-     * on conversation messages (counting from the end of stable content).
-     *
-     * Defaults to `1` (system + 1 message boundary = 2 breakpoints).
-     *
-     * Set to `0` to only cache the system prompt.
-     */
-    messageBreakpoints?: number;
-}
-
-/**
- * Prompt Cache Middleware — Anthropic prompt caching via `model.input`.
- *
- * Reduces input token costs by marking stable content (system prompt,
- * older conversation messages) with Anthropic `cache_control` breakpoints.
- *
- * How it works:
- *
- * 1. The middleware runs before each `streamText()` call via `model.input`
- * 2. It detects if the model is Anthropic (via provider string or model ID)
- * 3. For Anthropic models, it sets `cache_control: { type: "ephemeral" }`
- *    on the system prompt and on stable conversation messages
- * 4. The AI SDK's Anthropic provider translates these into API-level
- *    `cache_control` fields that Anthropic uses for prefix caching
- *
- * Cost impact:
- * - First call per cache region: 1.25× write cost (25% premium)
- * - Subsequent calls hitting cache: 0.1× read cost (90% savings)
- * - Cache TTL: 5 minutes (default) or 1 hour
- * - Net savings on multi-turn conversations: ~75%
- *
- * Anthropic limits: max 4 cache breakpoints per request.
- * This middleware uses 1 for system + up to `messageBreakpoints` for messages.
- *
- * @example
- * ```typescript
- * import { promptCacheMiddleware } from "@cuylabs/agent-core/middleware";
- *
- * const agent = createAgent({
- *   model: anthropic("claude-sonnet-4-20250514"),
- *   middleware: [promptCacheMiddleware()],
- * });
- * ```
- */
-
-/**
- * Create a prompt cache middleware for Anthropic models.
- *
- * Automatically detects Anthropic models and adds `cache_control`
- * breakpoints to the system prompt and stable conversation messages.
- * Non-Anthropic models are passed through unchanged.
- *
- * @param config - Optional configuration (TTL, breakpoint count)
- * @returns An `AgentMiddleware` that enables Anthropic prompt caching
- *
- * @example
- * ```typescript
- * import { anthropic } from "@ai-sdk/anthropic";
- * import { createAgent } from "@cuylabs/agent-core";
- * import { promptCacheMiddleware } from "@cuylabs/agent-core/middleware";
- *
- * const agent = createAgent({
- *   model: anthropic("claude-sonnet-4-20250514"),
- *   middleware: [promptCacheMiddleware()],
- * });
- *
- * // With custom config
- * const agent2 = createAgent({
- *   model: anthropic("claude-sonnet-4-20250514"),
- *   middleware: [
- *     promptCacheMiddleware({ ttl: "1h", messageBreakpoints: 2 }),
- *   ],
- * });
- * ```
- */
-declare function promptCacheMiddleware(config?: PromptCacheConfig): AgentMiddleware;
-
-export { type ApprovalConfig as A, type CacheTTL as C, type OtelMiddlewareConfig as O, type PromptCacheConfig as P, type RiskLevel as R, type TelemetryConfig as T, type ApprovalRule as a, type ApprovalAction as b, type ApprovalMiddlewareConfig as c, type ApprovalRequest as d, type TelemetryConfigResult as e, approvalMiddleware as f, createTelemetryConfig as g, otelMiddleware as o, promptCacheMiddleware as p };