@cuylabs/agent-core 4.9.0 → 4.10.0

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

@@ -1,4 +1,12 @@
-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';
+/**
+ * Reasoning — Barrel Export
+ *
+ * Re-exports all reasoning subsystem modules:
+ * - **types**     — ReasoningLevel, ReasoningConfig, level constants
+ * - **providers** — Provider-specific option builders
+ * - **config**    — Orchestration (getReasoningConfig, buildReasoningOptions, etc.)
+ */
+export { type ReasoningLevel, type ReasoningConfig, STANDARD_LEVELS, EXTENDED_LEVELS, FIXED_LEVELS, shouldIncludeReasoningSummary, } from "./types.js";
+export { buildOpenAIOptions, buildAnthropicOptions, buildGoogleOptions, buildXAIOptions, buildGroqOptions, buildBedrockOptions, buildOpenRouterOptions, getProviderOptionsKey, } from "./providers.js";
+export { getReasoningConfig, getReasoningConfigSync, buildReasoningOptions, buildReasoningOptionsSync, supportsReasoning, supportsReasoningSync, } from "./config.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/models/reasoning/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,6BAA6B,GAC9B,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,EACzB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,aAAa,CAAC"}

package/dist/models/reasoning/index.js

@@ -17,7 +17,7 @@ import {
   shouldIncludeReasoningSummary,
   supportsReasoning,
   supportsReasoningSync
-} from "../../chunk-GJFP5L2V.js";
+} from "../../chunk-CNM6OROH.js";
 import "../../chunk-I6PKJ7XQ.js";
 import "../../chunk-S6AKEPAX.js";
 export {

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

@@ -0,0 +1,63 @@
+/**
+ * Provider-Specific Reasoning Option Builders
+ *
+ * Each function takes a {@link ReasoningLevel} and returns the
+ * provider-options object expected by the Vercel AI SDK's
+ * `providerOptions` parameter.
+ *
+ * Provider key mapping (`getProviderOptionsKey`) is also defined
+ * here so that callers can wrap the raw options correctly.
+ */
+import type { ReasoningLevel } from "./types.js";
+import type { ProviderCompatibility } from "../index.js";
+/**
+ * Build OpenAI reasoning options.
+ *
+ * OpenAI reasoning models use:
+ * - `reasoningEffort` — controls depth
+ * - `reasoningSummary` — controls whether reasoning is streamed
+ *   (`"auto"` = condensed summary, `"detailed"` = full)
+ *
+ * `reasoningSummary` requires a verified OpenAI organisation.
+ * Set `CODE_AGENT_DISABLE_REASONING_SUMMARY=true` to skip it.
+ */
+export declare function buildOpenAIOptions(level: ReasoningLevel, compat?: ProviderCompatibility): Record<string, unknown> | undefined;
+/**
+ * Build Anthropic thinking options.
+ *
+ * Uses `thinking.type: "enabled"` with `budgetTokens`.
+ */
+export declare function buildAnthropicOptions(level: ReasoningLevel): Record<string, unknown> | undefined;
+/**
+ * Build Google / Gemini reasoning options.
+ *
+ * - **Gemini 3+** uses `thinkingLevel` (`"low"` / `"high"`)
+ * - **Gemini 2.5 and earlier** uses `thinkingBudget` (token count)
+ */
+export declare function buildGoogleOptions(level: ReasoningLevel, modelId?: string): Record<string, unknown> | undefined;
+/**
+ * Build xAI / Grok reasoning options.
+ */
+export declare function buildXAIOptions(level: ReasoningLevel): Record<string, unknown> | undefined;
+/**
+ * Build Groq reasoning options.
+ */
+export declare function buildGroqOptions(level: ReasoningLevel): Record<string, unknown> | undefined;
+/**
+ * Build Amazon Bedrock reasoning options.
+ *
+ * - Anthropic / Claude models use `budgetTokens`
+ * - Amazon Nova models use `maxReasoningEffort`
+ */
+export declare function buildBedrockOptions(level: ReasoningLevel, modelId?: string): Record<string, unknown> | undefined;
+/**
+ * Build OpenRouter reasoning options.
+ */
+export declare function buildOpenRouterOptions(level: ReasoningLevel): Record<string, unknown> | undefined;
+/**
+ * Resolve the `providerOptions` key for a given SDK provider string.
+ *
+ * Falls back to the first dot-segment (e.g. `"foo.bar"` → `"foo"`).
+ */
+export declare function getProviderOptionsKey(provider: string): string;
+//# sourceMappingURL=providers.d.ts.map

package/dist/models/reasoning/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../../src/models/reasoning/providers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAOzD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,cAAc,EACrB,MAAM,CAAC,EAAE,qBAAqB,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAoBrC;AAgBD;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,cAAc,GACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CASrC;AAgBD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,cAAc,EACrB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAoBrC;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,cAAc,GACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAGrC;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,cAAc,GACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAOrC;AAgBD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,cAAc,EACrB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAoBrC;AAMD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,cAAc,GACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAMrC;AAqBD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE9D"}

package/dist/{types-CQaXbRsS.d.ts → models/reasoning/types.d.ts}

@@ -16,12 +16,12 @@
  * | `"high"`   | Deep reasoning                     |
  * | `"xhigh"`  | Maximum reasoning (where supported)|
  */
-type ReasoningLevel = "off" | "minimal" | "low" | "medium" | "high" | "xhigh";
+export type ReasoningLevel = "off" | "minimal" | "low" | "medium" | "high" | "xhigh";
 /**
  * Provider-specific reasoning configuration returned by
  * {@link getReasoningConfig} / {@link getReasoningConfigSync}.
  */
-interface ReasoningConfig {
+export interface ReasoningConfig {
     /** Whether the model supports reasoning at all */
     supportsReasoning: boolean;
     /** Reasoning levels available for this model */
@@ -30,11 +30,11 @@ interface ReasoningConfig {
     getProviderOptions: (level: ReasoningLevel) => Record<string, unknown> | undefined;
 }
 /** Standard four-level set used by most providers. */
-declare const STANDARD_LEVELS: ReasoningLevel[];
+export declare const STANDARD_LEVELS: ReasoningLevel[];
 /** Extended set for advanced models (e.g. o3, o4, GPT-5). */
-declare const EXTENDED_LEVELS: ReasoningLevel[];
+export declare const EXTENDED_LEVELS: ReasoningLevel[];
 /** Fixed set for models whose reasoning level is not adjustable. */
-declare const FIXED_LEVELS: ReasoningLevel[];
+export declare const FIXED_LEVELS: ReasoningLevel[];
 /**
  * Check whether reasoning summaries should be included in responses.
  *
@@ -42,6 +42,5 @@ declare const FIXED_LEVELS: ReasoningLevel[];
  * variable. Summaries require a verified OpenAI organisation — set the
  * env var to `"true"` to disable them.
  */
-declare function shouldIncludeReasoningSummary(): boolean;
-
-export { EXTENDED_LEVELS as E, FIXED_LEVELS as F, type ReasoningLevel as R, STANDARD_LEVELS as S, type ReasoningConfig as a, shouldIncludeReasoningSummary as s };
+export declare function shouldIncludeReasoningSummary(): boolean;
+//# sourceMappingURL=types.d.ts.map

package/dist/models/reasoning/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/models/reasoning/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,cAAc,GACtB,KAAK,GACL,SAAS,GACT,KAAK,GACL,QAAQ,GACR,MAAM,GACN,OAAO,CAAC;AAEZ;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gDAAgD;IAChD,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,+CAA+C;IAC/C,kBAAkB,EAAE,CAClB,KAAK,EAAE,cAAc,KAClB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAC1C;AAMD,sDAAsD;AACtD,eAAO,MAAM,eAAe,EAAE,cAAc,EAK3C,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,eAAe,EAAE,cAAc,EAO3C,CAAC;AAEF,oEAAoE;AACpE,eAAO,MAAM,YAAY,EAAE,cAAc,EAAe,CAAC;AAMzD;;;;;;GAMG;AACH,wBAAgB,6BAA6B,IAAI,OAAO,CAKvD"}

package/dist/models/remote/fetcher.d.ts

@@ -0,0 +1,13 @@
+import type { ModelEntry, ResolverOptions } from "../types.js";
+import { CapabilityCache } from "../cache/index.js";
+export declare class RemoteCapabilityFetcher {
+    private apiUrl;
+    private timeoutMs;
+    private cache;
+    private lastFetchTime;
+    private minFetchInterval;
+    constructor(cache: CapabilityCache, options?: Partial<ResolverOptions>);
+    fetchAll(): Promise<ModelEntry[]>;
+    ping(): Promise<boolean>;
+}
+//# sourceMappingURL=fetcher.d.ts.map

package/dist/models/remote/fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetcher.d.ts","sourceRoot":"","sources":["../../../src/models/remote/fetcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE/D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAUpD,qBAAa,uBAAuB;IAClC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,gBAAgB,CAAa;gBAEzB,KAAK,EAAE,eAAe,EAAE,OAAO,GAAE,OAAO,CAAC,eAAe,CAAM;IAOpE,QAAQ,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAkDjC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;CAS/B"}

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

@@ -0,0 +1,8 @@
+/**
+ * Remote capability fetching, network state, and source integration.
+ */
+export type { NetworkStatus } from "./types.js";
+export { getNetworkStatus } from "./network.js";
+export { RemoteCapabilityFetcher } from "./fetcher.js";
+export { RemoteCapabilitySource } from "./source.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/models/remote/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/models/remote/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC"}

package/dist/models/remote/network.d.ts

@@ -0,0 +1,6 @@
+import type { NetworkStatus } from "./types.js";
+export declare function getNetworkStatus(): NetworkStatus;
+export declare function recordNetworkSuccess(): void;
+export declare function recordNetworkFailure(error: string): void;
+export declare function fetchWithTimeout(url: string, timeoutMs: number): Promise<Response>;
+//# sourceMappingURL=network.d.ts.map

package/dist/models/remote/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../../src/models/remote/network.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA2DhD,wBAAgB,gBAAgB,IAAI,aAAa,CAEhD;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAExD;AAED,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,QAAQ,CAAC,CAqBnB"}

package/dist/models/remote/source.d.ts

@@ -0,0 +1,16 @@
+import type { CapabilitySource, ResolverOptions, SourceResult } from "../types.js";
+import { SourcePriority } from "../types.js";
+import { CapabilityCache } from "../cache/index.js";
+export declare class RemoteCapabilitySource implements CapabilitySource {
+    readonly priority = SourcePriority.RemoteAPI;
+    readonly name = "Remote API (models.dev)";
+    private fetcher;
+    private cache;
+    private fetchPromise;
+    private enabled;
+    constructor(cache: CapabilityCache, options?: Partial<ResolverOptions>);
+    lookup(modelId: string, provider?: string): Promise<SourceResult>;
+    isAvailable(): Promise<boolean>;
+    refresh(): Promise<void>;
+}
+//# sourceMappingURL=source.d.ts.map

package/dist/models/remote/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../src/models/remote/source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAEhB,eAAe,EACf,YAAY,EACb,MAAM,aAAa,CAAC;AACrB,OAAO,EAA4B,cAAc,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIpD,qBAAa,sBAAuB,YAAW,gBAAgB;IAC7D,QAAQ,CAAC,QAAQ,4BAA4B;IAC7C,QAAQ,CAAC,IAAI,6BAA6B;IAE1C,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,YAAY,CAAoC;IACxD,OAAO,CAAC,OAAO,CAAU;gBAEb,KAAK,EAAE,eAAe,EAAE,OAAO,GAAE,OAAO,CAAC,eAAe,CAAM;IAOpE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAiDjE,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAI/B"}

package/dist/models/remote/transform.d.ts

@@ -0,0 +1,4 @@
+import type { ModelEntry } from "../types.js";
+import type { ModelsDevModel } from "./types.js";
+export declare function transformModelsDevEntry(raw: ModelsDevModel): ModelEntry;
+//# sourceMappingURL=transform.d.ts.map

package/dist/models/remote/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../src/models/remote/transform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,UAAU,EAEX,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,cAAc,GAAG,UAAU,CAsBvE"}

package/dist/models/remote/types.d.ts

@@ -0,0 +1,28 @@
+export interface NetworkStatus {
+    online: boolean;
+    lastSuccess?: number;
+    lastError?: string;
+    failureCount: number;
+}
+export interface ModelsDevModel {
+    id: string;
+    name: string;
+    provider?: string;
+    reasoning?: boolean;
+    tool_call?: boolean;
+    temperature?: boolean;
+    attachment?: boolean;
+    modalities?: {
+        input?: string[];
+        output?: string[];
+    };
+    limit?: {
+        context?: number;
+        output?: number;
+    };
+    cost?: {
+        input?: number;
+        output?: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/models/remote/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/models/remote/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE;QACX,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,KAAK,CAAC,EAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH"}

package/dist/models/resolver.d.ts

@@ -0,0 +1,26 @@
+import type { LanguageModel } from "ai";
+type AdapterKind = "openai" | "anthropic" | "google" | "openai-compatible" | "openrouter" | "azure" | "bedrock" | "vertex" | "xai" | "mistral" | "groq";
+export type AdapterSettings = {
+    apiKey?: string;
+    baseUrl?: string;
+    headers?: Record<string, string>;
+    extra?: Record<string, unknown>;
+};
+export type EngineSpec = {
+    adapter: AdapterKind | string;
+    settings?: AdapterSettings;
+    build?: (modelId: string, settings: AdapterSettings) => LanguageModel;
+};
+export type ModelSpec = {
+    engine: string;
+    id: string;
+    settings?: AdapterSettings;
+};
+export type Directory = {
+    engines: Record<string, EngineSpec>;
+    entries?: Record<string, ModelSpec>;
+};
+export type Resolver = (key: string) => Promise<LanguageModel>;
+export declare function createResolver(directory: Directory): Resolver;
+export {};
+//# sourceMappingURL=resolver.d.ts.map

package/dist/models/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/models/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAExC,KAAK,WAAW,GACZ,QAAQ,GACR,WAAW,GACX,QAAQ,GACR,mBAAmB,GACnB,YAAY,GACZ,OAAO,GACP,SAAS,GACT,QAAQ,GACR,KAAK,GACL,SAAS,GACT,MAAM,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,WAAW,GAAG,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,KAAK,aAAa,CAAC;CACvE,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;AAgM/D,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,QAAQ,CAiC7D"}

package/dist/models/types.d.ts

@@ -0,0 +1,137 @@
+/**
+ * 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
+ */
+export type InputModality = "text" | "image" | "audio" | "video" | "pdf";
+/**
+ * Output modalities a model can produce
+ */
+export type OutputModality = "text" | "image" | "audio" | "video";
+/**
+ * Comprehensive model capabilities
+ */
+export 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
+ */
+export 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
+ */
+export 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
+ */
+export 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
+ */
+export 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
+ */
+export 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
+ */
+export 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
+ */
+export declare const DEFAULT_RESOLVER_OPTIONS: Required<ResolverOptions>;
+//# sourceMappingURL=types.d.ts.map

package/dist/models/types.d.ts.map

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

package/dist/plugin/compatibility.d.ts

@@ -0,0 +1,11 @@
+import type { PluginCompatibility } from "./types.js";
+export interface PluginCompatibilityContext {
+    apiVersion?: string;
+    nodeVersion?: string;
+}
+export declare function matchesVersionRequirement(version: string, requirement: string): boolean;
+export declare function validatePluginCompatibility(options: {
+    compatibility?: PluginCompatibility;
+    context: PluginCompatibilityContext;
+}): string | undefined;
+//# sourceMappingURL=compatibility.d.ts.map

package/dist/plugin/compatibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility.d.ts","sourceRoot":"","sources":["../../src/plugin/compatibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,WAAW,0BAA0B;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAiCD,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAqCT;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE;IACnD,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,OAAO,EAAE,0BAA0B,CAAC;CACrC,GAAG,MAAM,GAAG,SAAS,CAuBrB"}

package/dist/plugin/define.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Declarative plugin authoring — `definePlugin()`.
+ *
+ * Converts a static plugin definition into a `PluginInit` function.
+ * The registry and imperative layer stay unchanged; this is sugar
+ * that makes plugins inspectable, type-safe, and easier to author.
+ */
+import type { AgentMiddleware } from "../middleware/types.js";
+import type { PromptSection } from "../prompt/types.js";
+import type { Tool } from "../tool/tool.js";
+import type { PluginCapabilityTag, PluginCompatibility, PluginCommand, PluginContext, PluginInit, PluginSurfaceContract, PluginSettingsDefinition, PluginSessionContext } from "./types.js";
+/** Declarative plugin definition passed to `definePlugin()`. */
+export interface PluginDefinition {
+    /** Unique plugin identifier. */
+    id: string;
+    /** Human-readable display name. */
+    name?: string;
+    /** Short description. */
+    description?: string;
+    /** SemVer string. */
+    version?: string;
+    /** Host/runtime compatibility validated before the plugin is committed. */
+    compatibility?: PluginCompatibility;
+    /** Host-readable business capability tags for catalogs and inventories. */
+    capabilities?: PluginCapabilityTag[];
+    /** Explicit contract for the host-owned surfaces this plugin contributes to. */
+    surfaces?: PluginSurfaceContract;
+    /** Optional settings schema to validate before the plugin is committed. */
+    settings?: PluginSettingsDefinition;
+    /** Tools the LLM can call. Statically declared — inspectable without execution. */
+    tools?: Tool.AnyInfo[];
+    /** Middleware hooks (model I/O, tool guards, prompt sections). */
+    middleware?: AgentMiddleware[];
+    /** User-facing commands. */
+    commands?: PluginCommand[];
+    /** Dynamic prompt sections injected at system-prompt build time. */
+    promptSections?: PromptSection[];
+    /**
+     * Imperative activation hook — runs when the agent session starts.
+     * Use for dynamic setup that can't be expressed declaratively
+     * (starting servers, loading config, managing state).
+     */
+    activate?: (ctx: PluginActivateContext) => Promise<void> | void;
+    /**
+     * Imperative deactivation hook — runs when the agent session ends.
+     */
+    deactivate?: () => Promise<void> | void;
+    /**
+     * Full imperative escape hatch — runs during plugin loading.
+     * Receives the raw PluginContext for anything the declarative
+     * fields can't express. Runs after all declarative contributions
+     * have been registered.
+     */
+    setup?: (ctx: PluginContext) => void | Promise<void>;
+}
+/** Context passed to the declarative `activate` hook. */
+export interface PluginActivateContext extends PluginSessionContext {
+    /** The plugin's own event bus. */
+    events: PluginContext["events"];
+    /** The plugin's settings provider. */
+    settings: PluginContext["settings"];
+}
+/**
+ * Create a plugin from a declarative definition.
+ *
+ * Returns a `PluginInit` function that the registry executes normally.
+ * The definition object is attached as `init.__definition` so the
+ * registry can inspect it without running the plugin.
+ */
+export declare function definePlugin(def: PluginDefinition): PluginInit;
+/** A PluginInit created by `definePlugin()` — carries the static definition. */
+export interface DefinePluginInit extends PluginInit {
+    __definition: PluginDefinition;
+}
+/** Type guard: check if a PluginInit was created by `definePlugin()`. */
+export declare function isDefinedPlugin(init: PluginInit): init is DefinePluginInit;
+//# sourceMappingURL=define.d.ts.map

package/dist/plugin/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../src/plugin/define.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,UAAU,EACV,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAMpB,gEAAgE;AAChE,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,mBAAmB,CAAC;IAEpC,2EAA2E;IAC3E,YAAY,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAErC,gFAAgF;IAChF,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IAEjC,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,wBAAwB,CAAC;IAEpC,mFAAmF;IACnF,KAAK,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;IAEvB,kEAAkE;IAClE,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;IAE/B,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAE3B,oEAAoE;IACpE,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;IAEjC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAEhE;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAExC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD;AAED,yDAAyD;AACzD,MAAM,WAAW,qBAAsB,SAAQ,oBAAoB;IACjE,kCAAkC;IAClC,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,sCAAsC;IACtC,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;CACrC;AAMD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,gBAAgB,GAAG,UAAU,CAyC9D;AAED,gFAAgF;AAChF,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,YAAY,EAAE,gBAAgB,CAAC;CAChC;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,IAAI,gBAAgB,CAE1E"}

package/dist/plugin/event-bus.d.ts

@@ -0,0 +1,31 @@
+/**
+ * PluginEventBus — string-keyed pub/sub for inter-plugin communication.
+ *
+ * Channel names are namespaced by convention:
+ * "finance:transaction-created", "crm:contact-updated".
+ */
+/** Remove a previously registered listener. */
+export type PluginUnsubscribe = () => void;
+/** Listener function for a specific channel. */
+export type PluginEventHandler = (data: unknown) => void;
+/**
+ * Minimal event bus interface. Plugins depend only on this.
+ */
+export interface PluginEventBusAPI {
+    emit(channel: string, data: unknown): void;
+    on(channel: string, handler: PluginEventHandler): PluginUnsubscribe;
+}
+/**
+ * In-process event bus. Dispatches synchronously.
+ * Listener errors are caught silently.
+ */
+export declare class PluginEventBus implements PluginEventBusAPI {
+    private readonly channels;
+    emit(channel: string, data: unknown): void;
+    on(channel: string, handler: PluginEventHandler): PluginUnsubscribe;
+    /** Number of active channels. */
+    get size(): number;
+    /** Remove all listeners. */
+    clear(): void;
+}
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/plugin/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/plugin/event-bus.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+CAA+C;AAC/C,MAAM,MAAM,iBAAiB,GAAG,MAAM,IAAI,CAAC;AAE3C,gDAAgD;AAChD,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3C,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,CAAC;CACrE;AAED;;;GAGG;AACH,qBAAa,cAAe,YAAW,iBAAiB;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8C;IAEvE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAY1C,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,iBAAiB;IAcnE,iCAAiC;IACjC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,4BAA4B;IAC5B,KAAK,IAAI,IAAI;CAGd"}