@cuylabs/agent-core 0.6.0 → 0.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cuylabs/agent-core",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Embeddable AI agent infrastructure — execution, sessions, tools, skills, sub-agents, tracing",
   "type": "module",
   "main": "./dist/index.js",
@@ -21,6 +21,11 @@
       "import": "./dist/runtime/index.js",
       "default": "./dist/runtime/index.js"
     },
+    "./inference": {
+      "types": "./dist/inference/index.d.ts",
+      "import": "./dist/inference/index.js",
+      "default": "./dist/inference/index.js"
+    },
     "./tracking": {
       "types": "./dist/tracking/index.d.ts",
       "import": "./dist/tracking/index.js",
@@ -61,11 +66,6 @@
       "import": "./dist/reasoning/index.js",
       "default": "./dist/reasoning/index.js"
     },
-    "./capabilities": {
-      "types": "./dist/capabilities/index.d.ts",
-      "import": "./dist/capabilities/index.js",
-      "default": "./dist/capabilities/index.js"
-    },
     "./models": {
       "types": "./dist/models/index.d.ts",
       "import": "./dist/models/index.js",
@@ -75,6 +75,16 @@
       "types": "./dist/mcp/index.d.ts",
       "import": "./dist/mcp/index.js",
       "default": "./dist/mcp/index.js"
+    },
+    "./host": {
+      "types": "./dist/host/index.d.ts",
+      "import": "./dist/host/index.js",
+      "default": "./dist/host/index.js"
+    },
+    "./scope": {
+      "types": "./dist/scope/index.d.ts",
+      "import": "./dist/scope/index.js",
+      "default": "./dist/scope/index.js"
     }
   },
   "files": [
@@ -179,10 +189,11 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsup src/index.ts src/tool/index.ts src/runtime/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/capabilities/index.ts src/models/index.ts src/mcp/index.ts --format esm --dts --clean",
-    "dev": "tsup src/index.ts src/tool/index.ts src/runtime/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/capabilities/index.ts src/models/index.ts src/mcp/index.ts --format esm --dts --watch",
+    "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",
     "test": "vitest run",
     "test:watch": "vitest",
+    "lint": "eslint src/",
     "typecheck": "tsc --noEmit",
     "clean": "rm -rf dist"
   }

package/dist/capabilities/index.d.ts

@@ -1,97 +0,0 @@
-import { C as CapabilitySource, S as SourcePriority, b as SourceResult, P as ProviderCompatibility, R as ResolverOptions, M as ModelEntry, c as ModelCapabilities } from '../resolver-DOfZ-xuk.js';
-export { D as DEFAULT_RESOLVER_OPTIONS, I as InputModality, d as ModelCapabilityResolver, N as NetworkStatus, O as OutputModality, f as ResolutionResult, g as configureResolver, e as extractModelId, a as extractProvider, h as getDefaultResolver } from '../resolver-DOfZ-xuk.js';
-export { g as getModelId, a as getProviderId } from '../identifiers-BLUxFqV_.js';
-export { g as getNetworkStatus } from '../network-D76DS5ot.js';
-import 'ai';
-
-/**
- * Pattern-Based Capability Detection for @cuylabs/agent-core
- *
- * Static pattern matching for model capabilities when no external data is available.
- * This is the fallback layer - always works offline.
- */
-
-/**
- * Infer provider from model ID
- */
-declare function inferProvider(modelId: string): string | undefined;
-/**
- * Pattern-based capability source
- * Always available, uses heuristics to detect capabilities
- */
-declare class PatternCapabilitySource implements CapabilitySource {
-    readonly priority = SourcePriority.PatternMatch;
-    readonly name = "Pattern Matching";
-    lookup(modelId: string, providerHint?: string): Promise<SourceResult>;
-    isAvailable(): Promise<boolean>;
-}
-/**
- * Quick check if a model ID likely supports reasoning
- */
-declare function likelySupportsReasoning(modelId: string): boolean;
-/**
- * Get provider compatibility for a model
- */
-declare function getProviderCompatibility(modelId: string, provider?: string): ProviderCompatibility | undefined;
-
-type CapabilityOverrides = ResolverOptions["modelOverrides"];
-type OverrideLookup = {
-    override?: Partial<ModelCapabilities>;
-    matchedKey?: string;
-};
-declare function findCapabilityOverride(overrides: CapabilityOverrides, modelId: string, provider?: string): OverrideLookup;
-declare function applyCapabilityOverride(entry: ModelEntry, override?: Partial<ModelCapabilities>): ModelEntry;
-
-declare class CapabilityCache {
-    private adapter;
-    private memoryCache;
-    private ttlMs;
-    private loaded;
-    constructor(options?: Partial<ResolverOptions>);
-    private load;
-    get(modelId: string, provider?: string): Promise<ModelEntry | undefined>;
-    set(entry: ModelEntry): Promise<void>;
-    setMany(entries: ModelEntry[]): Promise<void>;
-    persist(): Promise<void>;
-    clear(): Promise<void>;
-    stats(): {
-        size: number;
-        loaded: boolean;
-    };
-    getAll(): Promise<ModelEntry[]>;
-    getAllByProvider(): Promise<Record<string, ModelEntry[]>>;
-}
-declare class CacheCapabilitySource implements CapabilitySource {
-    private cache;
-    readonly priority = SourcePriority.LocalCache;
-    readonly name = "Local Cache";
-    constructor(cache: CapabilityCache);
-    lookup(modelId: string, provider?: string): Promise<SourceResult>;
-    isAvailable(): Promise<boolean>;
-}
-
-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>;
-}
-
-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>;
-}
-
-export { CacheCapabilitySource, CapabilityCache, type CapabilityOverrides, CapabilitySource, ModelCapabilities, ModelEntry, PatternCapabilitySource, ProviderCompatibility, RemoteCapabilityFetcher, RemoteCapabilitySource, ResolverOptions, SourcePriority, SourceResult, applyCapabilityOverride, findCapabilityOverride, getProviderCompatibility, inferProvider, likelySupportsReasoning };

package/dist/capabilities/index.js

@@ -1,46 +0,0 @@
-import {
-  CacheCapabilitySource,
-  CapabilityCache,
-  DEFAULT_RESOLVER_OPTIONS,
-  ModelCapabilityResolver,
-  PatternCapabilitySource,
-  RemoteCapabilityFetcher,
-  RemoteCapabilitySource,
-  SourcePriority,
-  applyCapabilityOverride,
-  configureResolver,
-  extractModelId,
-  extractProvider,
-  findCapabilityOverride,
-  getDefaultResolver,
-  getNetworkStatus,
-  getProviderCompatibility,
-  inferProvider,
-  likelySupportsReasoning
-} from "../chunk-QWFMX226.js";
-import {
-  getModelId,
-  getProviderId
-} from "../chunk-DWYX7ASF.js";
-export {
-  CacheCapabilitySource,
-  CapabilityCache,
-  DEFAULT_RESOLVER_OPTIONS,
-  ModelCapabilityResolver,
-  PatternCapabilitySource,
-  RemoteCapabilityFetcher,
-  RemoteCapabilitySource,
-  SourcePriority,
-  applyCapabilityOverride,
-  configureResolver,
-  extractModelId,
-  extractProvider,
-  findCapabilityOverride,
-  getDefaultResolver,
-  getModelId,
-  getNetworkStatus,
-  getProviderCompatibility,
-  getProviderId,
-  inferProvider,
-  likelySupportsReasoning
-};

package/dist/chunk-6TDTQJ4P.js

@@ -1,116 +0,0 @@
-// src/models/resolver.ts
-function parseKey(input) {
-  const [engineId, ...rest] = input.split("/");
-  if (!engineId || rest.length === 0) return null;
-  return { engineId, modelId: rest.join("/") };
-}
-function mergeSettings(base, override) {
-  return {
-    apiKey: override?.apiKey ?? base?.apiKey,
-    baseUrl: override?.baseUrl ?? base?.baseUrl,
-    headers: {
-      ...base?.headers ?? {},
-      ...override?.headers ?? {}
-    },
-    extra: {
-      ...base?.extra ?? {},
-      ...override?.extra ?? {}
-    }
-  };
-}
-function settingsKey(settings, adapter, engineId) {
-  return JSON.stringify({
-    engineId,
-    adapter,
-    apiKey: settings.apiKey ?? "",
-    baseUrl: settings.baseUrl ?? "",
-    headers: settings.headers ?? {},
-    extra: settings.extra ?? {}
-  });
-}
-function buildOptions(settings) {
-  const opts = { ...settings.extra ?? {} };
-  if (settings.apiKey) opts.apiKey = settings.apiKey;
-  if (settings.baseUrl) opts.baseURL = settings.baseUrl;
-  if (settings.headers && Object.keys(settings.headers).length > 0) opts.headers = settings.headers;
-  return opts;
-}
-async function createFactory(adapter, settings) {
-  const asModel = (m) => m;
-  const opts = buildOptions(settings);
-  switch (adapter) {
-    case "openai": {
-      const { createOpenAI } = await import("@ai-sdk/openai").catch(() => {
-        throw new Error(
-          `Provider "@ai-sdk/openai" is required for the "openai" adapter. Install it with: pnpm add @ai-sdk/openai`
-        );
-      });
-      const provider = createOpenAI(opts);
-      return (modelId) => provider.languageModel(modelId);
-    }
-    case "anthropic": {
-      const { createAnthropic } = await import("@ai-sdk/anthropic").catch(() => {
-        throw new Error(
-          `Provider "@ai-sdk/anthropic" is required for the "anthropic" adapter. Install it with: pnpm add @ai-sdk/anthropic`
-        );
-      });
-      const provider = createAnthropic(opts);
-      return (modelId) => provider.languageModel(modelId);
-    }
-    case "google": {
-      const { createGoogleGenerativeAI } = await import("@ai-sdk/google").catch(() => {
-        throw new Error(
-          `Provider "@ai-sdk/google" is required for the "google" adapter. Install it with: pnpm add @ai-sdk/google`
-        );
-      });
-      const provider = createGoogleGenerativeAI(opts);
-      return (modelId) => asModel(provider.languageModel(modelId));
-    }
-    case "openai-compatible": {
-      const { createOpenAICompatible } = await import("@ai-sdk/openai-compatible").catch(() => {
-        throw new Error(
-          `Provider "@ai-sdk/openai-compatible" is required for the "openai-compatible" adapter. Install it with: pnpm add @ai-sdk/openai-compatible`
-        );
-      });
-      const provider = createOpenAICompatible({
-        name: opts.name ?? "custom",
-        baseURL: opts.baseURL ?? "",
-        ...opts.apiKey ? { apiKey: opts.apiKey } : {},
-        ...opts.headers ? { headers: opts.headers } : {}
-      });
-      return (modelId) => provider.languageModel(modelId);
-    }
-    default:
-      throw new Error(`No factory registered for adapter: ${adapter}`);
-  }
-}
-function createResolver(directory) {
-  const factoryCache = /* @__PURE__ */ new Map();
-  return async (key) => {
-    const parsed = parseKey(key);
-    const entry = parsed ? void 0 : directory.entries?.[key];
-    const engineId = parsed?.engineId ?? entry?.engine;
-    const modelId = parsed?.modelId ?? entry?.id;
-    if (!engineId || !modelId) {
-      throw new Error(`Unknown model reference: ${key}`);
-    }
-    const engine = directory.engines[engineId];
-    if (!engine) {
-      throw new Error(`Unknown engine: ${engineId}`);
-    }
-    const settings = mergeSettings(engine.settings, entry?.settings);
-    if (engine.build) {
-      return engine.build(modelId, settings);
-    }
-    const cacheKey = settingsKey(settings, engine.adapter, engineId);
-    const cached = factoryCache.get(cacheKey);
-    if (cached) return cached(modelId);
-    const factory = await createFactory(engine.adapter, settings);
-    factoryCache.set(cacheKey, factory);
-    return factory(modelId);
-  };
-}
-
-export {
-  createResolver
-};

package/dist/chunk-DWYX7ASF.js

@@ -1,26 +0,0 @@
-// src/models/identifiers.ts
-function getModelId(model) {
-  if (typeof model === "string") return model;
-  if (typeof model === "object" && model !== null && "modelId" in model) {
-    return String(model.modelId);
-  }
-  return String(model);
-}
-function getProviderId(model) {
-  if (typeof model === "string") {
-    if (model.includes("/")) {
-      return model.split("/")[0];
-    }
-    return void 0;
-  }
-  if (typeof model === "object" && model !== null && "provider" in model) {
-    const provider = String(model.provider);
-    return provider.split(".")[0];
-  }
-  return void 0;
-}
-
-export {
-  getModelId,
-  getProviderId
-};

package/dist/chunk-FG4MD5MU.js

@@ -1,54 +0,0 @@
-import {
-  extractFilePathsFromArgs,
-  shouldCaptureBaseline
-} from "./chunk-VEKUXUVF.js";
-
-// src/tool/executor.ts
-async function executeAgentToolCall(options) {
-  const initialized = await options.tool.init({ cwd: options.cwd });
-  const ctx = {
-    cwd: options.cwd,
-    abort: options.abort,
-    sessionID: options.sessionID,
-    messageID: options.messageID,
-    agent: options.agent ?? "default",
-    ...options.host ? { host: options.host } : {},
-    ...options.turnTracker ? { turnTracker: options.turnTracker } : {}
-  };
-  if (options.middleware?.hasMiddleware) {
-    const decision = await options.middleware.runBeforeToolCall(
-      options.toolName,
-      options.params,
-      ctx
-    );
-    if (decision.action === "deny") {
-      return {
-        output: decision.reason ?? `Tool call denied: ${options.toolName}`
-      };
-    }
-  }
-  if (options.turnTracker && initialized.fileOps && shouldCaptureBaseline(initialized.fileOps)) {
-    const paths = extractFilePathsFromArgs(
-      options.params,
-      initialized.fileOps
-    );
-    for (const path of paths) {
-      await options.turnTracker.beforeWrite(path);
-    }
-  }
-  const result = await initialized.execute(options.params, ctx);
-  if (options.middleware?.hasMiddleware) {
-    const transformed = await options.middleware.runAfterToolCall(
-      options.toolName,
-      options.params,
-      result,
-      ctx
-    );
-    return { output: transformed.output };
-  }
-  return { output: result.output };
-}
-
-export {
-  executeAgentToolCall
-};

package/dist/config-D2xeGEHK.d.ts

@@ -1,52 +0,0 @@
-import { LanguageModel } from 'ai';
-import { ProviderOptions } from '@ai-sdk/provider-utils';
-import { R as ReasoningLevel, a as ReasoningConfig } from './types-CQaXbRsS.js';
-
-/**
- * Reasoning Configuration & Option Builders
- *
- * Orchestrates capability detection and provider-specific option
- * building to produce ready-to-use `providerOptions` for the
- * Vercel AI SDK.
- *
- * Two flavours of every function are provided:
- * - **Async** (`getReasoningConfig`, `buildReasoningOptions`) —
- *   uses the full capability resolver (network + cache).
- * - **Sync** (`getReasoningConfigSync`, `buildReasoningOptionsSync`) —
- *   uses fast pattern-matching only (no network).
- */
-
-/**
- * Get the reasoning configuration for a model.
- *
- * Uses the full capability resolver (including network lookups)
- * for the most accurate result.
- */
-declare function getReasoningConfig(model: LanguageModel): Promise<ReasoningConfig>;
-/**
- * Synchronous reasoning config using pattern-matching only.
- *
- * Faster but less accurate than {@link getReasoningConfig}.
- * Good for hot paths where async is impractical.
- */
-declare function getReasoningConfigSync(model: LanguageModel): ReasoningConfig;
-/**
- * Build `providerOptions` for a reasoning level (async).
- *
- * Returns `undefined` when reasoning is off or unsupported.
- */
-declare function buildReasoningOptions(model: LanguageModel, level: ReasoningLevel): Promise<ProviderOptions | undefined>;
-/**
- * Build `providerOptions` for a reasoning level (sync / pattern-only).
- */
-declare function buildReasoningOptionsSync(model: LanguageModel, level: ReasoningLevel): ProviderOptions | undefined;
-/**
- * Check whether a model supports reasoning (async, full resolver).
- */
-declare function supportsReasoning(model: LanguageModel): Promise<boolean>;
-/**
- * Synchronous check using pattern-matching only.
- */
-declare function supportsReasoningSync(model: LanguageModel): boolean;
-
-export { buildReasoningOptionsSync as a, buildReasoningOptions as b, getReasoningConfigSync as c, supportsReasoningSync as d, getReasoningConfig as g, supportsReasoning as s };

package/dist/identifiers-BLUxFqV_.d.ts

@@ -1,12 +0,0 @@
-import { LanguageModel } from 'ai';
-
-/**
- * Extract a model ID string from a LanguageModel instance.
- */
-declare function getModelId(model: LanguageModel): string;
-/**
- * Extract a provider identifier from a LanguageModel instance.
- */
-declare function getProviderId(model: LanguageModel): string | undefined;
-
-export { getProviderId as a, getModelId as g };

package/dist/network-D76DS5ot.d.ts

@@ -1,5 +0,0 @@
-import { N as NetworkStatus } from './resolver-DOfZ-xuk.js';
-
-declare function getNetworkStatus(): NetworkStatus;
-
-export { getNetworkStatus as g };