@cuylabs/agent-core 0.8.0 → 0.10.0

package/dist/logger/index.d.ts

@@ -0,0 +1,50 @@
+import { C as ConsoleLoggerOptions, L as Logger, F as FileLoggerOptions } from '../types-RSCv7nQ4.js';
+export { a as LogLevel, b as LogMeta } from '../types-RSCv7nQ4.js';
+
+/**
+ * Built-in logger implementations.
+ *
+ * - `silentLogger`         — no-op (default for agents)
+ * - `createConsoleLogger`  — pretty console output with level gating
+ * - `createFileLogger`     — append-only file output for debugging
+ */
+
+/**
+ * A logger that discards every message.
+ *
+ * This is the default used when no logger is supplied to `createAgent()`.
+ */
+declare const silentLogger: Logger;
+/**
+ * Create a console-backed logger with configurable minimum level.
+ *
+ * ```ts
+ * import { createConsoleLogger } from "@cuylabs/agent-core";
+ *
+ * const agent = createAgent({
+ *   model,
+ *   logger: createConsoleLogger({ level: "debug" }),
+ * });
+ * ```
+ *
+ * Respects the `AGENT_LOG_LEVEL` environment variable when no explicit
+ * level is supplied, falling back to `"warn"`.
+ */
+declare function createConsoleLogger(options?: ConsoleLoggerOptions): Logger;
+/**
+ * Create a file-backed logger that appends timestamped entries.
+ *
+ * ```ts
+ * import { createFileLogger } from "@cuylabs/agent-core";
+ *
+ * const logger = createFileLogger({ filePath: "/tmp/team.log", level: "debug" });
+ * ```
+ *
+ * The log file is created (with parent directories) if it doesn't exist.
+ * All writes are non-blocking; write errors are silently swallowed.
+ */
+declare function createFileLogger(options: FileLoggerOptions): Logger & {
+    close(): void;
+};
+
+export { ConsoleLoggerOptions, FileLoggerOptions, Logger, createConsoleLogger, createFileLogger, silentLogger };

package/dist/logger/index.js

@@ -0,0 +1,11 @@
+import "../chunk-SPBFQXOT.js";
+import {
+  createConsoleLogger,
+  createFileLogger,
+  silentLogger
+} from "../chunk-T4UIX5D7.js";
+export {
+  createConsoleLogger,
+  createFileLogger,
+  silentLogger
+};

package/dist/mcp/index.d.ts

@@ -1,15 +1,11 @@
-import { M as MCPConfig, a as MCPManager, d as MCPServerConfig, H as HttpTransportConfig, S as SseTransportConfig, f as StdioTransportConfig } from '../types-VQgymC1N.js';
-export { b as MCPPrompt, c as MCPResource, e as MCPServerStatus } from '../types-VQgymC1N.js';
+import { M as MCPConfig, a as MCPManager, R as RemoteTransportConfig, d as StdioTransportConfig } from '../types-Bj_J8u_W.js';
+export { H as HttpTransportConfig, b as MCPServerConfig, c as MCPServerStatus, S as SseTransportConfig } from '../types-Bj_J8u_W.js';
 import 'ai';
 
 /**
  * Create an MCP manager for connecting to multiple MCP servers.
  */
 declare function createMCPManager(config: MCPConfig): MCPManager;
-/**
- * Helper to define a single MCP server config.
- */
-declare function defineServer(config: MCPServerConfig): MCPServerConfig;
 /**
  * Helper to create a stdio server config.
  */
@@ -17,10 +13,10 @@ declare function stdioServer(command: string, args?: string[], options?: Omit<St
 /**
  * Helper to create an HTTP server config.
  */
-declare function httpServer(url: string, options?: Omit<HttpTransportConfig, "transport" | "url">): HttpTransportConfig;
+declare function httpServer(url: string, options?: Omit<RemoteTransportConfig, "transport" | "url">): RemoteTransportConfig;
 /**
  * Helper to create an SSE server config.
  */
-declare function sseServer(url: string, options?: Omit<SseTransportConfig, "transport" | "url">): SseTransportConfig;
+declare function sseServer(url: string, options?: Omit<RemoteTransportConfig, "transport" | "url">): RemoteTransportConfig;
 
-export { HttpTransportConfig, MCPConfig, MCPManager, MCPServerConfig, SseTransportConfig, StdioTransportConfig, createMCPManager, defineServer, httpServer, sseServer, stdioServer };
+export { MCPConfig, MCPManager, RemoteTransportConfig, StdioTransportConfig, createMCPManager, httpServer, sseServer, stdioServer };

package/dist/mcp/index.js

@@ -1,13 +1,12 @@
 import {
   createMCPManager,
-  defineServer,
   httpServer,
   sseServer,
   stdioServer
-} from "../chunk-ZXAKHMWH.js";
+} from "../chunk-ROTGCYDW.js";
+import "../chunk-T4UIX5D7.js";
 export {
   createMCPManager,
-  defineServer,
   httpServer,
   sseServer,
   stdioServer

package/dist/middleware/index.d.ts

@@ -1,153 +1,14 @@
-import { A as AgentMiddleware } from '../runner-e2YRcUoX.js';
-export { f as AgentModelHooks, B as BlockedModelCall, M as MiddlewareRunner, h as ModelCallContext, e as ModelCallInput, i as ModelCallOutput, j as PluginCommand, k as PluginContext, l as PluginInit, T as ToolCallDecision } from '../runner-e2YRcUoX.js';
-import { a as ApprovalConfig, R as RiskLevel } from '../types-CWm-7rvB.js';
-import { TelemetrySettings } from 'ai';
-import '@ai-sdk/provider-utils';
-import '../events-CE72w8W4.js';
-import '../messages-BYWGn8TY.js';
-import '../types-BfNpU8NS.js';
-import '../types-CQL-SvTn.js';
-import '../tool-DLXAR9Ce.js';
-import '../types-CHiPh8U2.js';
-import '../tool-BHbyUAy3.js';
+import { bR as OtelMiddlewareConfig, L as AgentMiddleware, de as TelemetryConfig, df as TelemetryConfigResult } from '../instance-BqV2D5pc.js';
+export { N as AgentModelHooks, ac as ApprovalAgentMiddleware, al as ApprovalMiddlewareConfig, as as BlockedModelCall, au as ChatLifecycleContext, b as MiddlewareRunner, d as ModelCallContext, bK as ModelCallInput, bL as ModelCallOutput, dh as ToolCallDecision, di as ToolCallOutput, dz as approvalMiddleware, dM as isApprovalMiddleware, dN as isBlockedModelCall } from '../instance-BqV2D5pc.js';
+import '../types-C_LCeYNg.js';
+import 'ai';
+import '../types-RSCv7nQ4.js';
 import 'zod';
 import '../types-CQaXbRsS.js';
-
-/**
- * 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>;
-}
+import '../types-Bj_J8u_W.js';
+import '@ai-sdk/provider-utils';
+import '../sandbox/index.js';
+import '../llm-error-D93FNNLY.js';
 
 declare function otelMiddleware(config?: OtelMiddlewareConfig): AgentMiddleware;
 
@@ -246,4 +107,4 @@ interface PromptCacheConfig {
  */
 declare function promptCacheMiddleware(config?: PromptCacheConfig): AgentMiddleware;
 
-export { AgentMiddleware, type ApprovalMiddlewareConfig, type CacheTTL, type OtelMiddlewareConfig, type PromptCacheConfig, type TelemetryConfig, type TelemetryConfigResult, approvalMiddleware, createTelemetryConfig, otelMiddleware, promptCacheMiddleware };
+export { AgentMiddleware, type CacheTTL, OtelMiddlewareConfig, type PromptCacheConfig, TelemetryConfig, TelemetryConfigResult, createTelemetryConfig, otelMiddleware, promptCacheMiddleware };

package/dist/middleware/index.js

@@ -2,15 +2,23 @@ import {
   MiddlewareRunner,
   approvalMiddleware,
   createTelemetryConfig,
+  isApprovalMiddleware,
   otelMiddleware,
   promptCacheMiddleware
-} from "../chunk-YSLSEQ6B.js";
-import "../chunk-BFM2YHNM.js";
-import "../chunk-DWYX7ASF.js";
+} from "../chunk-NDZWXCBZ.js";
+import {
+  isBlockedModelCall
+} from "../chunk-CJI7PVS2.js";
+import "../chunk-I6PKJ7XQ.js";
+import "../chunk-V4RFNEET.js";
+import "../chunk-FII65CN7.js";
+import "../chunk-T4UIX5D7.js";
 export {
   MiddlewareRunner,
   approvalMiddleware,
   createTelemetryConfig,
+  isApprovalMiddleware,
+  isBlockedModelCall,
   otelMiddleware,
   promptCacheMiddleware
 };

package/dist/model-messages-B4nK9D1-.d.ts

@@ -0,0 +1,13 @@
+import { ModelMessage } from 'ai';
+import { M as Message } from './instance-BqV2D5pc.js';
+
+/**
+ * Convert framework messages into Vercel AI SDK model messages.
+ *
+ * This keeps the message translation logic reusable for workflow activities
+ * and other runtime integrations without forcing those integrations to reach
+ * into `Agent` internals.
+ */
+declare function convertAgentMessagesToModelMessages(messages: Message[]): ModelMessage[];
+
+export { convertAgentMessagesToModelMessages as c };

package/dist/models/index.d.ts

@@ -1,6 +1,9 @@
 import { LanguageModel } from 'ai';
-import { C as CapabilitySource, S as SourcePriority, b as SourceResult, P as ProviderCompatibility, R as ResolverOptions, a as ModelEntry, M as ModelCapabilities } from '../types-QA4WhEfz.js';
-export { D as DEFAULT_RESOLVER_OPTIONS, I as InputModality, O as OutputModality } from '../types-QA4WhEfz.js';
+import { C as CapabilitySource, S as SourcePriority, b as SourceResult, P as ProviderCompatibility, R as ResolverOptions, a as ModelEntry, M as ModelCapabilities } from '../index-BCqEGzBj.js';
+export { D as DEFAULT_RESOLVER_OPTIONS, I as InputModality, O as OutputModality, c as buildAnthropicOptions, d as buildBedrockOptions, e as buildGoogleOptions, f as buildGroqOptions, g as buildOpenAIOptions, h as buildOpenRouterOptions, i as buildReasoningOptions, j as buildReasoningOptionsSync, k as buildXAIOptions, l as getProviderOptionsKey, m as getReasoningConfig, n as getReasoningConfigSync, s as supportsReasoning, o as supportsReasoningSync } from '../index-BCqEGzBj.js';
+import { L as Logger } from '../types-RSCv7nQ4.js';
+export { E as EXTENDED_LEVELS, F as FIXED_LEVELS, a as ReasoningConfig, R as ReasoningLevel, S as STANDARD_LEVELS, s as shouldIncludeReasoningSummary } from '../types-CQaXbRsS.js';
+import '@ai-sdk/provider-utils';
 
 /**
  * Extract a model ID string from a LanguageModel instance.
@@ -10,6 +13,19 @@ declare function getModelId(model: LanguageModel): string;
  * Extract a provider identifier from a LanguageModel instance.
  */
 declare function getProviderId(model: LanguageModel): string | undefined;
+/**
+ * Extract model ID from a LanguageModel.
+ *
+ * Canonical helper — use this instead of `getModelId` in consumer code.
+ */
+declare const extractModelId: (model: LanguageModel) => string;
+/**
+ * Extract provider from a LanguageModel.
+ *
+ * Tries the model's `.provider` property first, then falls back
+ * to pattern-matching the model ID via `inferProvider`.
+ */
+declare function extractProvider(model: LanguageModel): string | undefined;
 
 type AdapterKind = "openai" | "anthropic" | "google" | "openai-compatible" | "openrouter" | "azure" | "bedrock" | "vertex" | "xai" | "mistral" | "groq";
 type AdapterSettings = {
@@ -33,11 +49,6 @@ type Directory = {
     entries?: Record<string, ModelSpec>;
 };
 type Resolver = (key: string) => Promise<LanguageModel>;
-/**
- * @deprecated Use `Resolver` (async) instead. Kept for backwards compatibility
- * with custom `build` functions that return synchronously.
- */
-type SyncResolver = (key: string) => LanguageModel;
 declare function createResolver(directory: Directory): Resolver;
 
 /**
@@ -90,7 +101,8 @@ declare class CapabilityCache {
     private memoryCache;
     private ttlMs;
     private loaded;
-    constructor(options?: Partial<ResolverOptions>);
+    private readonly log;
+    constructor(options?: Partial<ResolverOptions>, logger?: Logger);
     private load;
     get(modelId: string, provider?: string): Promise<ModelEntry | undefined>;
     set(entry: ModelEntry): Promise<void>;
@@ -158,14 +170,6 @@ declare class RemoteCapabilitySource implements CapabilitySource {
  * Designed for the Vercel AI SDK v6 ecosystem.
  */
 
-/**
- * Extract model ID from LanguageModel
- */
-declare function extractModelId(model: LanguageModel): string;
-/**
- * Extract provider from LanguageModel
- */
-declare function extractProvider(model: LanguageModel): string | undefined;
 /**
  * Resolution result with source information
  */
@@ -191,7 +195,8 @@ declare class ModelCapabilityResolver {
     private sources;
     private initialized;
     private initPromise;
-    constructor(options?: Partial<ResolverOptions>);
+    private readonly log;
+    constructor(options?: Partial<ResolverOptions>, logger?: Logger);
     /**
      * Initialize the resolver (load cache, optionally fetch remote)
      */
@@ -253,4 +258,4 @@ declare function getDefaultResolver(): ModelCapabilityResolver;
  */
 declare function configureResolver(options: Partial<ResolverOptions>): void;
 
-export { type AdapterSettings, CacheCapabilitySource, CapabilityCache, type CapabilityOverrides, CapabilitySource, type Directory, type EngineSpec, ModelCapabilities, ModelCapabilityResolver, ModelEntry, type ModelSpec, type NetworkStatus, PatternCapabilitySource, ProviderCompatibility, RemoteCapabilityFetcher, RemoteCapabilitySource, type ResolutionResult, type Resolver, ResolverOptions, SourcePriority, SourceResult, type SyncResolver, applyCapabilityOverride, configureResolver, createResolver, extractModelId, extractProvider, findCapabilityOverride, getDefaultResolver, getModelId, getNetworkStatus, getProviderCompatibility, getProviderId, inferContextWindow, inferProvider, likelySupportsReasoning };
+export { type AdapterSettings, CacheCapabilitySource, CapabilityCache, type CapabilityOverrides, CapabilitySource, type Directory, type EngineSpec, ModelCapabilities, ModelCapabilityResolver, ModelEntry, type ModelSpec, type NetworkStatus, PatternCapabilitySource, ProviderCompatibility, RemoteCapabilityFetcher, RemoteCapabilitySource, type ResolutionResult, type Resolver, ResolverOptions, SourcePriority, SourceResult, applyCapabilityOverride, configureResolver, createResolver, extractModelId, extractProvider, findCapabilityOverride, getDefaultResolver, getModelId, getNetworkStatus, getProviderCompatibility, getProviderId, inferContextWindow, inferProvider, likelySupportsReasoning };

package/dist/models/index.js

@@ -1,39 +1,70 @@
 import {
   CacheCapabilitySource,
   CapabilityCache,
-  DEFAULT_RESOLVER_OPTIONS,
+  EXTENDED_LEVELS,
+  FIXED_LEVELS,
   ModelCapabilityResolver,
-  PatternCapabilitySource,
   RemoteCapabilityFetcher,
   RemoteCapabilitySource,
-  SourcePriority,
+  STANDARD_LEVELS,
   applyCapabilityOverride,
+  buildAnthropicOptions,
+  buildBedrockOptions,
+  buildGoogleOptions,
+  buildGroqOptions,
+  buildOpenAIOptions,
+  buildOpenRouterOptions,
+  buildReasoningOptions,
+  buildReasoningOptionsSync,
+  buildXAIOptions,
   configureResolver,
   createResolver,
-  extractModelId,
-  extractProvider,
   findCapabilityOverride,
   getDefaultResolver,
   getNetworkStatus,
+  getProviderOptionsKey,
+  getReasoningConfig,
+  getReasoningConfigSync,
+  shouldIncludeReasoningSummary,
+  supportsReasoning,
+  supportsReasoningSync
+} from "../chunk-RN6WZEUF.js";
+import {
+  DEFAULT_RESOLVER_OPTIONS,
+  PatternCapabilitySource,
+  SourcePriority,
+  extractModelId,
+  extractProvider,
+  getModelId,
   getProviderCompatibility,
+  getProviderId,
   inferContextWindow,
   inferProvider,
   likelySupportsReasoning
-} from "../chunk-RFEKJKTO.js";
-import {
-  getModelId,
-  getProviderId
-} from "../chunk-DWYX7ASF.js";
+} from "../chunk-I6PKJ7XQ.js";
+import "../chunk-T4UIX5D7.js";
 export {
   CacheCapabilitySource,
   CapabilityCache,
   DEFAULT_RESOLVER_OPTIONS,
+  EXTENDED_LEVELS,
+  FIXED_LEVELS,
   ModelCapabilityResolver,
   PatternCapabilitySource,
   RemoteCapabilityFetcher,
   RemoteCapabilitySource,
+  STANDARD_LEVELS,
   SourcePriority,
   applyCapabilityOverride,
+  buildAnthropicOptions,
+  buildBedrockOptions,
+  buildGoogleOptions,
+  buildGroqOptions,
+  buildOpenAIOptions,
+  buildOpenRouterOptions,
+  buildReasoningOptions,
+  buildReasoningOptionsSync,
+  buildXAIOptions,
   configureResolver,
   createResolver,
   extractModelId,
@@ -44,7 +75,13 @@ export {
   getNetworkStatus,
   getProviderCompatibility,
   getProviderId,
+  getProviderOptionsKey,
+  getReasoningConfig,
+  getReasoningConfigSync,
   inferContextWindow,
   inferProvider,
-  likelySupportsReasoning
+  likelySupportsReasoning,
+  shouldIncludeReasoningSummary,
+  supportsReasoning,
+  supportsReasoningSync
 };

package/dist/models/reasoning/index.d.ts

@@ -0,0 +1,4 @@
+export { E as EXTENDED_LEVELS, F as FIXED_LEVELS, a as ReasoningConfig, R as ReasoningLevel, S as STANDARD_LEVELS, s as shouldIncludeReasoningSummary } from '../../types-CQaXbRsS.js';
+export { c as buildAnthropicOptions, d as buildBedrockOptions, e as buildGoogleOptions, f as buildGroqOptions, g as buildOpenAIOptions, h as buildOpenRouterOptions, i as buildReasoningOptions, j as buildReasoningOptionsSync, k as buildXAIOptions, l as getProviderOptionsKey, m as getReasoningConfig, n as getReasoningConfigSync, s as supportsReasoning, o as supportsReasoningSync } from '../../index-BCqEGzBj.js';
+import 'ai';
+import '@ai-sdk/provider-utils';

package/dist/{reasoning → models/reasoning}/index.js

@@ -17,9 +17,9 @@ import {
   shouldIncludeReasoningSummary,
   supportsReasoning,
   supportsReasoningSync
-} from "../chunk-SQU2AJHO.js";
-import "../chunk-RFEKJKTO.js";
-import "../chunk-DWYX7ASF.js";
+} from "../../chunk-RN6WZEUF.js";
+import "../../chunk-I6PKJ7XQ.js";
+import "../../chunk-T4UIX5D7.js";
 export {
   EXTENDED_LEVELS,
   FIXED_LEVELS,