@cuylabs/agent-core 0.7.0 → 0.9.0

package/dist/types-YuWV4ag7.d.ts

@@ -0,0 +1,72 @@
+import { A as AgentEvent } from './events-CE72w8W4.js';
+
+/**
+ * Agent Signal — typed event dispatch interface.
+ *
+ * Defines how consumers subscribe to {@link AgentEvent}s without being
+ * part of the middleware stack.  Each Agent owns a signal; events are
+ * scoped to that agent instance.
+ *
+ * The default implementation (`LocalSignal`) dispatches in-process via
+ * plain function calls.  A distributed runtime can supply its own
+ * implementation that bridges to external infrastructure.
+ */
+
+/**
+ * Extract a single variant from the AgentEvent union by its `type` tag.
+ */
+type EventOf<T extends AgentEvent["type"]> = Extract<AgentEvent, {
+    type: T;
+}>;
+/** Handler for a specific event type. */
+type TypedHandler<T extends AgentEvent["type"]> = (event: EventOf<T>) => void;
+/** Handler that receives every event regardless of type. */
+type WildcardHandler = (event: AgentEvent) => void;
+/** Call to remove a previously registered handler. */
+type Unsubscribe = () => void;
+/**
+ * Typed, multi-consumer event dispatch.
+ *
+ * Subscribe to agent events from anywhere — SSE routes, TUI renderers,
+ * plugins, tests.  The interface is deliberately minimal so that backend
+ * implementations (in-process, Dapr, Redis, …) have a small contract to
+ * fulfil.
+ *
+ * @example
+ * ```ts
+ * // Subscribe to a specific event
+ * const off = agent.signal.on("text-delta", (e) => process.stdout.write(e.text));
+ *
+ * // Subscribe to everything
+ * const off2 = agent.signal.onAny((e) => logger.info(e.type));
+ *
+ * // Clean up
+ * off();
+ * off2();
+ * ```
+ */
+interface AgentSignal {
+    /**
+     * Subscribe to a specific event type.
+     *
+     * @returns An unsubscribe function.
+     */
+    on<T extends AgentEvent["type"]>(type: T, handler: TypedHandler<T>): Unsubscribe;
+    /**
+     * Subscribe to all events.
+     *
+     * @returns An unsubscribe function.
+     */
+    onAny(handler: WildcardHandler): Unsubscribe;
+    /**
+     * Dispatch an event to every matching handler.
+     *
+     * Called internally by the Agent — but nothing prevents external code
+     * from injecting a synthetic event (useful for testing or bridging).
+     */
+    emit(event: AgentEvent): void;
+    /** Remove all handlers.  Called during agent disposal. */
+    clear(): void;
+}
+
+export type { AgentSignal as A, EventOf as E, TypedHandler as T, Unsubscribe as U, WildcardHandler as W };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cuylabs/agent-core",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Embeddable AI agent infrastructure — execution, sessions, tools, skills, sub-agents, tracing",
   "type": "module",
   "main": "./dist/index.js",
@@ -62,9 +62,9 @@
       "default": "./dist/context/index.js"
     },
     "./reasoning": {
-      "types": "./dist/reasoning/index.d.ts",
-      "import": "./dist/reasoning/index.js",
-      "default": "./dist/reasoning/index.js"
+      "types": "./dist/models/reasoning/index.d.ts",
+      "import": "./dist/models/reasoning/index.js",
+      "default": "./dist/models/reasoning/index.js"
     },
     "./models": {
       "types": "./dist/models/index.d.ts",
@@ -85,6 +85,31 @@
       "types": "./dist/scope/index.d.ts",
       "import": "./dist/scope/index.js",
       "default": "./dist/scope/index.js"
+    },
+    "./signal": {
+      "types": "./dist/signal/index.d.ts",
+      "import": "./dist/signal/index.js",
+      "default": "./dist/signal/index.js"
+    },
+    "./errors": {
+      "types": "./dist/inference/errors/index.d.ts",
+      "import": "./dist/inference/errors/index.js",
+      "default": "./dist/inference/errors/index.js"
+    },
+    "./presets": {
+      "types": "./dist/presets/index.d.ts",
+      "import": "./dist/presets/index.js",
+      "default": "./dist/presets/index.js"
+    },
+    "./safety": {
+      "types": "./dist/safety/index.d.ts",
+      "import": "./dist/safety/index.js",
+      "default": "./dist/safety/index.js"
+    },
+    "./plugin": {
+      "types": "./dist/plugin/index.d.ts",
+      "import": "./dist/plugin/index.js",
+      "default": "./dist/plugin/index.js"
     }
   },
   "files": [
@@ -94,15 +119,23 @@
   "dependencies": {
     "@ai-sdk/provider": "^3.0.7",
     "ai": "^6.0.67",
+    "jiti": "^2.6.1",
     "zod": "^3.25.76 || ^4.1.8"
   },
   "peerDependencies": {
+    "@ai-sdk/amazon-bedrock": "^4.0.0",
     "@ai-sdk/anthropic": "^3.0.0",
+    "@ai-sdk/azure": "^3.0.0",
     "@ai-sdk/google": "^3.0.0",
+    "@ai-sdk/google-vertex": "^4.0.0",
+    "@ai-sdk/groq": "^3.0.0",
     "@ai-sdk/mcp": "^1.0.0",
+    "@ai-sdk/mistral": "^3.0.0",
     "@ai-sdk/openai": "^3.0.0",
     "@ai-sdk/openai-compatible": "^2.0.0",
+    "@ai-sdk/xai": "^3.0.0",
     "@modelcontextprotocol/sdk": "^1.0.0",
+    "@openrouter/ai-sdk-provider": "^1.0.0",
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/resources": "^2.0.0",
     "@opentelemetry/sdk-trace-node": "^2.0.0",
@@ -110,9 +143,15 @@
     "dockerode": "^4.0.9"
   },
   "peerDependenciesMeta": {
+    "@ai-sdk/amazon-bedrock": {
+      "optional": true
+    },
     "@ai-sdk/anthropic": {
       "optional": true
     },
+    "@ai-sdk/azure": {
+      "optional": true
+    },
     "@ai-sdk/openai": {
       "optional": true
     },
@@ -122,12 +161,27 @@
     "@ai-sdk/google": {
       "optional": true
     },
+    "@ai-sdk/google-vertex": {
+      "optional": true
+    },
+    "@ai-sdk/groq": {
+      "optional": true
+    },
     "@ai-sdk/mcp": {
       "optional": true
     },
+    "@ai-sdk/mistral": {
+      "optional": true
+    },
+    "@ai-sdk/xai": {
+      "optional": true
+    },
     "@modelcontextprotocol/sdk": {
       "optional": true
     },
+    "@openrouter/ai-sdk-provider": {
+      "optional": true
+    },
     "dockerode": {
       "optional": true
     },
@@ -145,14 +199,21 @@
     }
   },
   "devDependencies": {
+    "@ai-sdk/amazon-bedrock": "^4.0.77",
     "@ai-sdk/anthropic": "^3.0.35",
+    "@ai-sdk/azure": "^3.0.42",
     "@ai-sdk/google": "^3.0.30",
+    "@ai-sdk/google-vertex": "^4.0.80",
+    "@ai-sdk/groq": "^3.0.29",
     "@ai-sdk/mcp": "^1.0.19",
+    "@ai-sdk/mistral": "^3.0.24",
     "@ai-sdk/openai": "^3.0.25",
     "@ai-sdk/openai-compatible": "^2.0.30",
     "@ai-sdk/provider-utils": "^4.0.15",
+    "@ai-sdk/xai": "^3.0.67",
     "@arizeai/openinference-vercel": "^2.7.1",
     "@modelcontextprotocol/sdk": "^1.26.0",
+    "@openrouter/ai-sdk-provider": "^1.0.0",
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/exporter-trace-otlp-grpc": "^0.213.0",
     "@opentelemetry/exporter-trace-otlp-http": "^0.213.0",
@@ -189,8 +250,8 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsup src/index.ts src/tool/index.ts src/runtime/index.ts src/inference/index.ts src/tracking/index.ts src/middleware/index.ts src/prompt/index.ts src/skill/index.ts src/sub-agent/index.ts src/storage/index.ts src/context/index.ts src/reasoning/index.ts src/models/index.ts src/mcp/index.ts src/host/index.ts src/scope/index.ts --format esm --dts --clean",
-    "dev": "tsup src/index.ts src/tool/index.ts src/runtime/index.ts src/inference/index.ts src/tracking/index.ts src/middleware/index.ts src/prompt/index.ts src/skill/index.ts src/sub-agent/index.ts src/storage/index.ts src/context/index.ts src/reasoning/index.ts src/models/index.ts src/mcp/index.ts src/host/index.ts src/scope/index.ts --format esm --dts --watch",
+    "build": "tsup src/index.ts src/tool/index.ts src/runtime/index.ts src/inference/index.ts src/inference/errors/index.ts src/tracking/index.ts src/middleware/index.ts src/prompt/index.ts src/skill/index.ts src/sub-agent/index.ts src/storage/index.ts src/context/index.ts src/models/index.ts src/models/reasoning/index.ts src/mcp/index.ts src/host/index.ts src/scope/index.ts src/signal/index.ts src/presets/index.ts src/safety/index.ts src/plugin/index.ts --format esm --dts --clean",
+    "dev": "tsup src/index.ts src/tool/index.ts src/runtime/index.ts src/inference/index.ts src/inference/errors/index.ts src/tracking/index.ts src/middleware/index.ts src/prompt/index.ts src/skill/index.ts src/sub-agent/index.ts src/storage/index.ts src/context/index.ts src/models/index.ts src/models/reasoning/index.ts src/mcp/index.ts src/host/index.ts src/scope/index.ts src/signal/index.ts src/presets/index.ts src/safety/index.ts src/plugin/index.ts --format esm --dts --watch",
     "test": "vitest run",
     "test:watch": "vitest",
     "lint": "eslint src/",

package/dist/capability-resolver-CgRGsWVX.d.ts

@@ -1,254 +0,0 @@
-import { LanguageModel } from 'ai';
-
-/**
- * Model Capability Types for @cuylabs/agent-core
- *
- * Defines the structure for model capabilities that can be sourced from
- * static patterns, local cache, or remote APIs.
- */
-/**
- * Input modalities a model can accept
- */
-type InputModality = "text" | "image" | "audio" | "video" | "pdf";
-/**
- * Output modalities a model can produce
- */
-type OutputModality = "text" | "image" | "audio" | "video";
-/**
- * Comprehensive model capabilities
- */
-interface ModelCapabilities {
-    /** Model supports extended reasoning/thinking */
-    reasoning: boolean;
-    /** Model supports function/tool calling */
-    toolCalling: boolean;
-    /** Model supports temperature adjustment */
-    temperature: boolean;
-    /** Model supports file attachments */
-    attachments: boolean;
-    /** Model supports streaming responses */
-    streaming: boolean;
-    /** Supported input modalities */
-    inputModalities: InputModality[];
-    /** Supported output modalities */
-    outputModalities: OutputModality[];
-    /** Maximum context window in tokens */
-    contextWindow?: number;
-    /** Maximum output tokens */
-    maxOutput?: number;
-}
-/**
- * Provider-specific compatibility flags
- * These handle quirks in different provider implementations
- */
-interface ProviderCompatibility {
-    /** Supports OpenAI-style reasoning_effort parameter */
-    supportsReasoningEffort?: boolean;
-    /** Supports developer/system role distinction */
-    supportsDeveloperRole?: boolean;
-    /** Field name for max tokens (varies by provider) */
-    maxTokensField?: "max_tokens" | "max_completion_tokens";
-    /** Requires thinking as text tags vs structured */
-    requiresThinkingTags?: boolean;
-    /** Provider-specific thinking format */
-    thinkingFormat?: "openai" | "anthropic" | "google" | "zai";
-}
-/**
- * Complete model entry with metadata
- */
-interface ModelEntry {
-    /** Model identifier (e.g., "gpt-4o", "claude-sonnet-4") */
-    id: string;
-    /** Human-readable model name */
-    name: string;
-    /** Provider identifier (e.g., "openai", "anthropic") */
-    provider: string;
-    /** Model capabilities */
-    capabilities: ModelCapabilities;
-    /** Provider-specific compatibility settings */
-    compatibility?: ProviderCompatibility;
-    /** Cost per million tokens (input) */
-    costInput?: number;
-    /** Cost per million tokens (output) */
-    costOutput?: number;
-    /** When this entry was last updated */
-    updatedAt?: string;
-}
-/**
- * Priority levels for capability sources
- */
-declare enum SourcePriority {
-    /** User configuration overrides everything */
-    UserConfig = 0,
-    /** Local cache from previous fetch */
-    LocalCache = 1,
-    /** Bundled static data (build-time) */
-    BundledData = 2,
-    /** Pattern-based inference (fallback) */
-    PatternMatch = 3,
-    /** Remote API (if network available) */
-    RemoteAPI = 4
-}
-/**
- * Result from a capability source lookup
- */
-interface SourceResult {
-    /** The model entry if found */
-    entry?: ModelEntry;
-    /** Which source provided this result */
-    source: SourcePriority;
-    /** Whether this is a confident match */
-    confident: boolean;
-    /** Error message if lookup failed */
-    error?: string;
-}
-/**
- * Capability source interface
- */
-interface CapabilitySource {
-    /** Source priority (lower = higher priority) */
-    priority: SourcePriority;
-    /** Human-readable source name */
-    name: string;
-    /** Look up capabilities for a model */
-    lookup(modelId: string, provider?: string): Promise<SourceResult>;
-    /** Check if this source is available */
-    isAvailable(): Promise<boolean>;
-}
-/**
- * Options for the capability resolver
- */
-interface ResolverOptions {
-    /** Enable remote API fetching (default: false) */
-    enableRemoteFetch?: boolean;
-    /** Remote API URL (default: https://models.dev) */
-    remoteApiUrl?: string;
-    /** Cache directory path */
-    cachePath?: string;
-    /** Cache TTL in milliseconds (default: 1 hour) */
-    cacheTtlMs?: number;
-    /** Network timeout in milliseconds (default: 10 seconds) */
-    networkTimeoutMs?: number;
-    /** Custom user overrides for specific models */
-    modelOverrides?: Record<string, Partial<ModelCapabilities>>;
-}
-/**
- * Default resolver options
- */
-declare const DEFAULT_RESOLVER_OPTIONS: Required<ResolverOptions>;
-
-interface NetworkStatus {
-    online: boolean;
-    lastSuccess?: number;
-    lastError?: string;
-    failureCount: number;
-}
-
-/**
- * Model Capability Resolver for @cuylabs/agent-core
- *
- * Main orchestrator that combines multiple capability sources:
- * 1. User overrides (highest priority)
- * 2. Local cache (fast, persisted)
- * 3. Pattern matching (always available)
- * 4. Remote API (optional, network-dependent)
- *
- * 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
- */
-interface ResolutionResult {
-    /** The resolved model entry */
-    entry: ModelEntry;
-    /** Which source provided the primary result */
-    source: SourcePriority;
-    /** Whether this is a confident match */
-    confident: boolean;
-    /** Resolution timing in ms */
-    resolveTimeMs: number;
-}
-/**
- * Model Capability Resolver
- *
- * Provides a unified API for querying model capabilities with
- * automatic fallback through multiple sources.
- */
-declare class ModelCapabilityResolver {
-    private options;
-    private cache;
-    private sources;
-    private initialized;
-    private initPromise;
-    constructor(options?: Partial<ResolverOptions>);
-    /**
-     * Initialize the resolver (load cache, optionally fetch remote)
-     */
-    initialize(): Promise<void>;
-    /**
-     * Resolve capabilities for a model
-     */
-    resolve(model: LanguageModel): Promise<ResolutionResult>;
-    /**
-     * Quick check if a model supports reasoning
-     * Uses cache/patterns only for speed
-     */
-    supportsReasoning(model: LanguageModel): Promise<boolean>;
-    /**
-     * Get capabilities for a model
-     */
-    getCapabilities(model: LanguageModel): Promise<ModelCapabilities>;
-    /**
-     * Get provider compatibility settings
-     */
-    getCompatibility(model: LanguageModel): Promise<ProviderCompatibility | undefined>;
-    /**
-     * Force refresh from remote API
-     */
-    refreshRemote(): Promise<void>;
-    /**
-     * Get current network status
-     */
-    getNetworkStatus(): NetworkStatus;
-    /**
-     * Get resolver statistics
-     */
-    getStats(): {
-        cacheSize: number;
-        cacheLoaded: boolean;
-        remoteFetchEnabled: boolean;
-        networkOnline: boolean;
-    };
-    /**
-     * Clear all cached data
-     */
-    clearCache(): Promise<void>;
-    /**
-     * List all available models
-     * Fetches from remote if cache is empty and remote is enabled
-     */
-    listModels(): Promise<ModelEntry[]>;
-    /**
-     * List all available models grouped by provider
-     */
-    listModelsByProvider(): Promise<Record<string, ModelEntry[]>>;
-}
-/**
- * Get the default resolver instance
- */
-declare function getDefaultResolver(): ModelCapabilityResolver;
-/**
- * Configure the default resolver with custom options
- */
-declare function configureResolver(options: Partial<ResolverOptions>): void;
-
-export { type CapabilitySource as C, DEFAULT_RESOLVER_OPTIONS as D, type InputModality as I, type ModelCapabilities as M, type NetworkStatus as N, type OutputModality as O, type ProviderCompatibility as P, type ResolutionResult as R, SourcePriority as S, ModelCapabilityResolver as a, type ModelEntry as b, type ResolverOptions as c, type SourceResult as d, configureResolver as e, extractModelId as f, extractProvider as g, getDefaultResolver as h };