@clinebot/core 0.0.35 → 0.0.37

package/dist/llms/cline-recommended-models.d.ts

@@ -0,0 +1,20 @@
+import { ProviderSettingsManager } from "../services/storage/provider-settings-manager";
+export interface ClineRecommendedModel {
+    id: string;
+    name: string;
+    description: string;
+    tags: string[];
+}
+export interface ClineRecommendedModelsData {
+    recommended: ClineRecommendedModel[];
+    free: ClineRecommendedModel[];
+}
+export interface FetchClineRecommendedModelsOptions {
+    baseUrl?: string;
+    fetchImpl?: typeof fetch;
+    providerSettingsManager?: Pick<ProviderSettingsManager, "getProviderSettings">;
+    timeoutMs?: number;
+}
+export declare const FALLBACK_CLINE_RECOMMENDED_MODELS: ClineRecommendedModelsData;
+export declare function fetchClineRecommendedModels(options?: FetchClineRecommendedModelsOptions): Promise<ClineRecommendedModelsData>;
+//# sourceMappingURL=cline-recommended-models.d.ts.map

package/dist/llms/cline-recommended-models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cline-recommended-models.d.ts","sourceRoot":"","sources":["../../src/llms/cline-recommended-models.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;AAExF,MAAM,WAAW,qBAAqB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;CACf;AAED,MAAM,WAAW,0BAA0B;IAC1C,WAAW,EAAE,qBAAqB,EAAE,CAAC;IACrC,IAAI,EAAE,qBAAqB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,kCAAkC;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,uBAAuB,CAAC,EAAE,IAAI,CAC7B,uBAAuB,EACvB,qBAAqB,CACrB,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAKD,eAAO,MAAM,iCAAiC,EAAE,0BAyC/C,CAAC;AA8EF,wBAAsB,2BAA2B,CAChD,OAAO,GAAE,kCAAuC,GAC9C,OAAO,CAAC,0BAA0B,CAAC,CAkBrC"}

package/dist/llms/configured-provider-registry.d.ts

@@ -0,0 +1,28 @@
+import type { ProviderConfig } from "./provider-settings";
+import type { BuiltInProviderSummary, CreateHandlerInput, ProviderConfigDefaults, ProviderSelectionConfig, RegisteredProviderSummary } from "./runtime-types";
+interface RegisterConfiguredProviderInput {
+    id: string;
+    models: readonly string[];
+    defaultModel?: string;
+    defaults?: ProviderConfigDefaults;
+}
+export declare function toBuiltInProviderSummary(input: {
+    collection: BuiltInProviderSummary["id"] extends string ? {
+        provider: Pick<import("@clinebot/llms").ProviderInfo, "id" | "name" | "description" | "protocol" | "baseUrl" | "capabilities" | "env" | "defaultModelId">;
+        models: Record<string, unknown>;
+    } : never;
+}): BuiltInProviderSummary;
+export declare class ConfiguredProviderRegistry {
+    private readonly providers;
+    register(input: RegisterConfiguredProviderInput): void;
+    registerSelectionConfig(provider: ProviderSelectionConfig): void;
+    registerModel(providerId: string, modelId: string): void;
+    createHandlerConfig(input: CreateHandlerInput): ProviderConfig;
+    list(): RegisteredProviderSummary[];
+    getModels(providerId: string): string[];
+    hasProvider(providerId: string): boolean;
+    hasModel(providerId: string, modelId: string): boolean;
+    private require;
+}
+export {};
+//# sourceMappingURL=configured-provider-registry.d.ts.map

package/dist/llms/configured-provider-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configured-provider-registry.d.ts","sourceRoot":"","sources":["../../src/llms/configured-provider-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EACX,sBAAsB,EACtB,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,yBAAyB,EACzB,MAAM,iBAAiB,CAAC;AASzB,UAAU,+BAA+B;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,sBAAsB,CAAC;CAClC;AAoCD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC/C,UAAU,EAAE,sBAAsB,CAAC,IAAI,CAAC,SAAS,MAAM,GACpD;QACA,QAAQ,EAAE,IAAI,CACb,OAAO,gBAAgB,EAAE,YAAY,EACnC,IAAI,GACJ,MAAM,GACN,aAAa,GACb,UAAU,GACV,SAAS,GACT,cAAc,GACd,KAAK,GACL,gBAAgB,CAClB,CAAC;QACF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAChC,GACA,KAAK,CAAC;CACT,GAAG,sBAAsB,CAczB;AAED,qBAAa,0BAA0B;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+C;IAEzE,QAAQ,CAAC,KAAK,EAAE,+BAA+B,GAAG,IAAI;IAuBtD,uBAAuB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,IAAI;IAiBhE,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAcxD,mBAAmB,CAAC,KAAK,EAAE,kBAAkB,GAAG,cAAc;IAgB9D,IAAI,IAAI,yBAAyB,EAAE;IAQnC,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;IAIvC,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIxC,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAItD,OAAO,CAAC,OAAO;CASf"}

package/dist/llms/handler-factory.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Build a concrete `LlmsProviders.ApiHandler` from an `AgentConfig`.
+ *
+ * @see PLAN.md §3.1 — moved from `packages/agents/src/utils/config-helpers.ts` lines 15–55.
+ * @see PLAN.md §3.2.1 — `AgentConfig → AgentRuntimeConfig` mapping for
+ *                      the `model` field.
+ *
+ * Pure port. Core calls this once per session (and again on
+ * `updateConnection`) to produce the `AgentModel` adapter handed to
+ * `new AgentRuntime({ model, ... })`.
+ */
+import * as LlmsProviders from "@clinebot/llms";
+import type { AgentConfig, BasicLogger } from "@clinebot/shared";
+export declare function resolveKnownModelsFromConfig(config: AgentConfig): Record<string, LlmsProviders.ModelInfo> | undefined;
+export declare function createHandlerFromConfig(config: AgentConfig, logger: BasicLogger | undefined): LlmsProviders.ApiHandler;
+//# sourceMappingURL=handler-factory.d.ts.map

package/dist/llms/handler-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-factory.d.ts","sourceRoot":"","sources":["../../src/llms/handler-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,aAAa,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEjE,wBAAgB,4BAA4B,CAC3C,MAAM,EAAE,WAAW,GACjB,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC,GAAG,SAAS,CAYrD;AAED,wBAAgB,uBAAuB,CACtC,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,WAAW,GAAG,SAAS,GAC7B,aAAa,CAAC,UAAU,CAqB1B"}

package/dist/llms/provider-defaults.d.ts

@@ -0,0 +1,27 @@
+/** biome-ignore-all lint/style/noNonNullAssertion: static */
+import * as Llms from "@clinebot/llms";
+import type { ModelCatalogConfig, ModelInfo, ProviderCapability, ProviderConfig } from "./provider-settings";
+export interface BuiltInProviderManifest {
+    id: string;
+    baseUrl: string;
+    modelId: string;
+    knownModels?: Record<string, ModelInfo>;
+    capabilities?: Llms.CatalogProviderCapability[];
+    env?: readonly string[];
+    client: Llms.ProviderClient;
+    protocol?: Llms.ProviderProtocol;
+}
+export interface ProviderDefaults {
+    baseUrl: string;
+    modelId: string;
+    knownModels?: Record<string, ModelInfo>;
+    capabilities?: ProviderCapability[];
+}
+export declare const DEFAULT_MODELS_CATALOG_URL = "https://models.dev/api.json";
+export declare function getLiveModelsCatalog(options?: Pick<ModelCatalogConfig, "url" | "cacheTtlMs">): Promise<Record<string, Record<string, ModelInfo>>>;
+export declare function clearLiveModelsCatalogCache(url?: string): void;
+export declare function clearPrivateModelsCatalogCache(): void;
+export declare const OPENAI_COMPATIBLE_PROVIDERS: Record<string, ProviderDefaults>;
+export declare function getProviderConfig(providerId: string): ProviderDefaults | undefined;
+export declare function resolveProviderConfig(providerId: string, modelCatalog?: ModelCatalogConfig, config?: ProviderConfig): Promise<ProviderDefaults | undefined>;
+//# sourceMappingURL=provider-defaults.d.ts.map

package/dist/llms/provider-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-defaults.d.ts","sourceRoot":"","sources":["../../src/llms/provider-defaults.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,EACX,kBAAkB,EAClB,SAAS,EACT,kBAAkB,EAClB,cAAc,EACd,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,uBAAuB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACxC,YAAY,CAAC,EAAE,IAAI,CAAC,yBAAyB,EAAE,CAAC;IAChD,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC;IAC5B,QAAQ,CAAC,EAAE,IAAI,CAAC,gBAAgB,CAAC;CACjC;AAkED,MAAM,WAAW,gBAAgB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACxC,YAAY,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACpC;AAmBD,eAAO,MAAM,0BAA0B,gCAAgC,CAAC;AAwaxE,wBAAsB,oBAAoB,CACzC,OAAO,GAAE,IAAI,CAAC,kBAAkB,EAAE,KAAK,GAAG,YAAY,CAAM,GAC1D,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CA0BpD;AAED,wBAAgB,2BAA2B,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAS9D;AAED,wBAAgB,8BAA8B,IAAI,IAAI,CAGrD;AAiBD,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CACP,CAAC;AAEnE,wBAAgB,iBAAiB,CAChC,UAAU,EAAE,MAAM,GAChB,gBAAgB,GAAG,SAAS,CAY9B;AAED,wBAAsB,qBAAqB,CAC1C,UAAU,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,kBAAkB,EACjC,MAAM,CAAC,EAAE,cAAc,GACrB,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAmCvC"}

package/dist/llms/provider-settings.d.ts

@@ -0,0 +1,245 @@
+import * as Llms from "@clinebot/llms";
+import { z } from "zod";
+import { type ProviderDefaults } from "./provider-defaults";
+export type ModelInfo = Llms.ModelInfo;
+export type ProviderClient = Llms.ProviderClient;
+export type ProviderProtocol = Llms.ProviderProtocol;
+export type ProviderId = Llms.ProviderId;
+export type ProviderCapability = Llms.ProviderCapability;
+export type ProviderConfig = Llms.ProviderConfig;
+export type BuiltInProviderId = Llms.BuiltInProviderId;
+export declare const BUILT_IN_PROVIDER: typeof Llms.BUILT_IN_PROVIDER;
+export declare const BUILT_IN_PROVIDER_IDS: [Llms.BUILT_IN_PROVIDER, ...Llms.BUILT_IN_PROVIDER[]];
+export declare const isBuiltInProviderId: typeof Llms.isBuiltInProviderId;
+export declare const normalizeProviderId: typeof Llms.normalizeProviderId;
+export type ProviderDefaultsConfig = ProviderDefaults;
+export declare const ProviderIdSchema: z.ZodString;
+export declare const ProviderProtocolSchema: z.ZodEnum<{
+    "openai-responses": "openai-responses";
+    anthropic: "anthropic";
+    gemini: "gemini";
+    "openai-chat": "openai-chat";
+    "openai-r1": "openai-r1";
+    "ai-sdk": "ai-sdk";
+}>;
+export declare const ProviderClientSchema: z.ZodEnum<{
+    custom: "custom";
+    anthropic: "anthropic";
+    gemini: "gemini";
+    "openai-r1": "openai-r1";
+    "ai-sdk": "ai-sdk";
+    "ai-sdk-community": "ai-sdk-community";
+    openai: "openai";
+    "openai-compatible": "openai-compatible";
+    bedrock: "bedrock";
+    fetch: "fetch";
+    vertex: "vertex";
+}>;
+export declare const AuthSettingsSchema: z.ZodObject<{
+    apiKey: z.ZodOptional<z.ZodString>;
+    accessToken: z.ZodOptional<z.ZodString>;
+    refreshToken: z.ZodOptional<z.ZodString>;
+    expiresAt: z.ZodOptional<z.ZodNumber>;
+    accountId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type AuthSettings = z.infer<typeof AuthSettingsSchema>;
+export declare const ReasoningSettingsSchema: z.ZodObject<{
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    effort: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        high: "high";
+        medium: "medium";
+        xhigh: "xhigh";
+        none: "none";
+    }>>;
+    budgetTokens: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type ReasoningSettings = z.infer<typeof ReasoningSettingsSchema>;
+export declare const AwsSettingsSchema: z.ZodObject<{
+    accessKey: z.ZodOptional<z.ZodString>;
+    secretKey: z.ZodOptional<z.ZodString>;
+    sessionToken: z.ZodOptional<z.ZodString>;
+    region: z.ZodOptional<z.ZodString>;
+    profile: z.ZodOptional<z.ZodString>;
+    authentication: z.ZodOptional<z.ZodEnum<{
+        iam: "iam";
+        "api-key": "api-key";
+        profile: "profile";
+    }>>;
+    usePromptCache: z.ZodOptional<z.ZodBoolean>;
+    useCrossRegionInference: z.ZodOptional<z.ZodBoolean>;
+    useGlobalInference: z.ZodOptional<z.ZodBoolean>;
+    endpoint: z.ZodOptional<z.ZodString>;
+    customModelBaseId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type AwsSettings = z.infer<typeof AwsSettingsSchema>;
+export declare const GcpSettingsSchema: z.ZodObject<{
+    projectId: z.ZodOptional<z.ZodString>;
+    region: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type GcpSettings = z.infer<typeof GcpSettingsSchema>;
+export declare const AzureSettingsSchema: z.ZodObject<{
+    apiVersion: z.ZodOptional<z.ZodString>;
+    useIdentity: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type AzureSettings = z.infer<typeof AzureSettingsSchema>;
+export declare const SapSettingsSchema: z.ZodObject<{
+    clientId: z.ZodOptional<z.ZodString>;
+    clientSecret: z.ZodOptional<z.ZodString>;
+    tokenUrl: z.ZodOptional<z.ZodString>;
+    resourceGroup: z.ZodOptional<z.ZodString>;
+    deploymentId: z.ZodOptional<z.ZodString>;
+    useOrchestrationMode: z.ZodOptional<z.ZodBoolean>;
+    api: z.ZodOptional<z.ZodEnum<{
+        orchestration: "orchestration";
+        "foundation-models": "foundation-models";
+    }>>;
+    defaultSettings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type SapSettings = z.infer<typeof SapSettingsSchema>;
+export declare const OcaSettingsSchema: z.ZodObject<{
+    mode: z.ZodOptional<z.ZodEnum<{
+        external: "external";
+        internal: "internal";
+    }>>;
+    usePromptCache: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type OcaSettings = z.infer<typeof OcaSettingsSchema>;
+export declare const ModelCatalogSettingsSchema: z.ZodObject<{
+    loadLatestOnInit: z.ZodOptional<z.ZodBoolean>;
+    loadPrivateOnAuth: z.ZodOptional<z.ZodBoolean>;
+    url: z.ZodOptional<z.ZodString>;
+    cacheTtlMs: z.ZodOptional<z.ZodNumber>;
+    failOnError: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type ModelCatalogSettings = z.infer<typeof ModelCatalogSettingsSchema>;
+export type ModelCatalogConfig = ModelCatalogSettings;
+export declare const ProviderSettingsSchema: z.ZodObject<{
+    provider: z.ZodString;
+    apiKey: z.ZodOptional<z.ZodString>;
+    auth: z.ZodOptional<z.ZodObject<{
+        apiKey: z.ZodOptional<z.ZodString>;
+        accessToken: z.ZodOptional<z.ZodString>;
+        refreshToken: z.ZodOptional<z.ZodString>;
+        expiresAt: z.ZodOptional<z.ZodNumber>;
+        accountId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    model: z.ZodOptional<z.ZodString>;
+    protocol: z.ZodOptional<z.ZodEnum<{
+        "openai-responses": "openai-responses";
+        anthropic: "anthropic";
+        gemini: "gemini";
+        "openai-chat": "openai-chat";
+        "openai-r1": "openai-r1";
+        "ai-sdk": "ai-sdk";
+    }>>;
+    client: z.ZodOptional<z.ZodEnum<{
+        custom: "custom";
+        anthropic: "anthropic";
+        gemini: "gemini";
+        "openai-r1": "openai-r1";
+        "ai-sdk": "ai-sdk";
+        "ai-sdk-community": "ai-sdk-community";
+        openai: "openai";
+        "openai-compatible": "openai-compatible";
+        bedrock: "bedrock";
+        fetch: "fetch";
+        vertex: "vertex";
+    }>>;
+    routingProviderId: z.ZodOptional<z.ZodString>;
+    maxTokens: z.ZodOptional<z.ZodNumber>;
+    contextWindow: z.ZodOptional<z.ZodNumber>;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    reasoning: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        effort: z.ZodOptional<z.ZodEnum<{
+            low: "low";
+            high: "high";
+            medium: "medium";
+            xhigh: "xhigh";
+            none: "none";
+        }>>;
+        budgetTokens: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    aws: z.ZodOptional<z.ZodObject<{
+        accessKey: z.ZodOptional<z.ZodString>;
+        secretKey: z.ZodOptional<z.ZodString>;
+        sessionToken: z.ZodOptional<z.ZodString>;
+        region: z.ZodOptional<z.ZodString>;
+        profile: z.ZodOptional<z.ZodString>;
+        authentication: z.ZodOptional<z.ZodEnum<{
+            iam: "iam";
+            "api-key": "api-key";
+            profile: "profile";
+        }>>;
+        usePromptCache: z.ZodOptional<z.ZodBoolean>;
+        useCrossRegionInference: z.ZodOptional<z.ZodBoolean>;
+        useGlobalInference: z.ZodOptional<z.ZodBoolean>;
+        endpoint: z.ZodOptional<z.ZodString>;
+        customModelBaseId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    gcp: z.ZodOptional<z.ZodObject<{
+        projectId: z.ZodOptional<z.ZodString>;
+        region: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    azure: z.ZodOptional<z.ZodObject<{
+        apiVersion: z.ZodOptional<z.ZodString>;
+        useIdentity: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    sap: z.ZodOptional<z.ZodObject<{
+        clientId: z.ZodOptional<z.ZodString>;
+        clientSecret: z.ZodOptional<z.ZodString>;
+        tokenUrl: z.ZodOptional<z.ZodString>;
+        resourceGroup: z.ZodOptional<z.ZodString>;
+        deploymentId: z.ZodOptional<z.ZodString>;
+        useOrchestrationMode: z.ZodOptional<z.ZodBoolean>;
+        api: z.ZodOptional<z.ZodEnum<{
+            orchestration: "orchestration";
+            "foundation-models": "foundation-models";
+        }>>;
+        defaultSettings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    oca: z.ZodOptional<z.ZodObject<{
+        mode: z.ZodOptional<z.ZodEnum<{
+            external: "external";
+            internal: "internal";
+        }>>;
+        usePromptCache: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    region: z.ZodOptional<z.ZodString>;
+    apiLine: z.ZodOptional<z.ZodEnum<{
+        china: "china";
+        international: "international";
+    }>>;
+    capabilities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        reasoning: "reasoning";
+        tools: "tools";
+        streaming: "streaming";
+        "prompt-cache": "prompt-cache";
+        "computer-use": "computer-use";
+        oauth: "oauth";
+        vision: "vision";
+    }>>>;
+    modelCatalog: z.ZodOptional<z.ZodObject<{
+        loadLatestOnInit: z.ZodOptional<z.ZodBoolean>;
+        loadPrivateOnAuth: z.ZodOptional<z.ZodBoolean>;
+        url: z.ZodOptional<z.ZodString>;
+        cacheTtlMs: z.ZodOptional<z.ZodNumber>;
+        failOnError: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ProviderSettings = z.infer<typeof ProviderSettingsSchema>;
+export declare function parseSettings(input: unknown): ProviderSettings;
+export declare function safeParseSettings(input: unknown): ReturnType<typeof ProviderSettingsSchema.safeParse>;
+export declare function toProviderConfig(settings: ProviderSettings): ProviderConfig;
+export declare function createProviderConfig(input: unknown): ProviderConfig;
+export declare function safeCreateProviderConfig(input: unknown): {
+    success: true;
+    config: ProviderConfig;
+} | {
+    success: false;
+    error: z.ZodError;
+};
+//# sourceMappingURL=provider-settings.d.ts.map

package/dist/llms/provider-settings.d.ts.map

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

package/dist/llms/runtime-config.d.ts

@@ -0,0 +1,4 @@
+import type { LlmsConfig } from "./runtime-types";
+export declare function defineLlmsConfig(config: LlmsConfig): LlmsConfig;
+export declare function loadLlmsConfigFromFile(configPath: string): Promise<LlmsConfig>;
+//# sourceMappingURL=runtime-config.d.ts.map

package/dist/llms/runtime-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-config.d.ts","sourceRoot":"","sources":["../../src/llms/runtime-config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAE/D;AAED,wBAAsB,sBAAsB,CAC3C,UAAU,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,CAAC,CAarB"}

package/dist/llms/runtime-registry.d.ts

@@ -0,0 +1,20 @@
+import type { ApiHandler } from "@clinebot/llms";
+import type { BuiltInProviderSummary, CreateHandlerInput, LlmsConfig, LlmsSdk, RegisterBuiltinProviderInput, RegisteredProviderSummary, RegisterModelInput, RegisterProviderInput } from "./runtime-types";
+export declare class DefaultLlmsSdk implements LlmsSdk {
+    private readonly configuredProviders;
+    constructor(config: LlmsConfig);
+    createHandler(input: CreateHandlerInput): ApiHandler;
+    createHandlerAsync(input: CreateHandlerInput): Promise<ApiHandler>;
+    registerProvider(input: RegisterProviderInput): void;
+    registerBuiltinProvider(input: RegisterBuiltinProviderInput): void;
+    registerModel(input: RegisterModelInput): void;
+    getProviders(): RegisteredProviderSummary[];
+    getBuiltInProviderIds(): import("@clinebot/llms").BUILT_IN_PROVIDER[];
+    getBuiltInProviders(): Promise<BuiltInProviderSummary[]>;
+    getModels(providerId: string): string[];
+    isProviderConfigured(providerId: string): boolean;
+    isModelConfigured(providerId: string, modelId: string): boolean;
+    private applyConfig;
+}
+export declare function createLlmsSdk(config: LlmsConfig): LlmsSdk;
+//# sourceMappingURL=runtime-registry.d.ts.map

package/dist/llms/runtime-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-registry.d.ts","sourceRoot":"","sources":["../../src/llms/runtime-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAgBjD,OAAO,KAAK,EACX,sBAAsB,EACtB,kBAAkB,EAClB,UAAU,EACV,OAAO,EACP,4BAA4B,EAC5B,yBAAyB,EACzB,kBAAkB,EAClB,qBAAqB,EACrB,MAAM,iBAAiB,CAAC;AAEzB,qBAAa,cAAe,YAAW,OAAO;IAC7C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAoC;gBAE5D,MAAM,EAAE,UAAU;IAI9B,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,UAAU;IAM9C,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;IAMxE,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,IAAI;IAyBpD,uBAAuB,CAAC,KAAK,EAAE,4BAA4B,GAAG,IAAI;IAgClE,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAK9C,YAAY,IAAI,yBAAyB,EAAE;IAI3C,qBAAqB;IAIf,mBAAmB,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAc9D,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;IAIvC,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIjD,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAI/D,OAAO,CAAC,WAAW;CAyBnB;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAEzD"}

package/dist/llms/runtime-types.d.ts

@@ -0,0 +1,85 @@
+import type { ApiHandler, BuiltInProviderId, HandlerFactory, LazyHandlerFactory, ModelCollection, ModelInfo, CatalogProviderCapability as ModelProviderCapability, ProviderClient, ProviderConfig, ProviderInfo, ProviderProtocol } from "@clinebot/llms";
+import type { ProviderCapability } from "./provider-settings";
+export type ProviderConfigDefaults = Omit<ProviderConfig, "providerId" | "modelId">;
+export interface ProviderSelectionConfig {
+    id: string;
+    models: string[];
+    defaultModel?: string;
+    builtinProviderId?: BuiltInProviderId;
+    apiKey?: string;
+    apiKeyEnv?: string;
+    baseUrl?: string;
+    headers?: Record<string, string>;
+    timeoutMs?: number;
+    capabilities?: ProviderCapability[];
+    settings?: ProviderConfigDefaults;
+}
+export interface AdditionalModelConfig {
+    providerId: string;
+    modelId: string;
+    info: ModelInfo;
+}
+export interface CustomProviderConfig {
+    collection: ModelCollection;
+    defaults?: ProviderConfigDefaults;
+    handlerFactory?: HandlerFactory;
+    asyncHandlerFactory?: LazyHandlerFactory;
+}
+export interface LlmsConfig {
+    providers: ProviderSelectionConfig[];
+    models?: AdditionalModelConfig[];
+    customProviders?: CustomProviderConfig[];
+}
+export interface CreateHandlerInput {
+    providerId: string;
+    modelId?: string;
+    overrides?: ProviderConfigDefaults;
+}
+export interface RegisteredProviderSummary {
+    id: string;
+    models: string[];
+    defaultModel: string;
+}
+export interface BuiltInProviderSummary extends Pick<ProviderInfo, "id" | "name" | "description" | "protocol" | "baseUrl" | "capabilities" | "env"> {
+    models: string[];
+    defaultModel: string;
+    modelCount: number;
+}
+export interface RegisterBuiltinProviderInput {
+    id: string;
+    builtinProviderId: BuiltInProviderId;
+    models: Record<string, ModelInfo>;
+    name?: string;
+    description?: string;
+    protocol?: ProviderProtocol;
+    baseUrl?: string;
+    client?: ProviderClient;
+    capabilities?: ModelProviderCapability[];
+    env?: string[];
+    defaultModel?: string;
+    defaults?: ProviderConfigDefaults;
+    exposeModels?: string[];
+}
+export interface RegisterProviderInput extends CustomProviderConfig {
+    exposeModels?: string[];
+    defaultModel?: string;
+}
+export interface RegisterModelInput {
+    providerId: string;
+    modelId: string;
+    info: ModelInfo;
+}
+export interface LlmsSdk {
+    createHandler(input: CreateHandlerInput): ApiHandler;
+    createHandlerAsync(input: CreateHandlerInput): Promise<ApiHandler>;
+    registerProvider(input: RegisterProviderInput): void;
+    registerBuiltinProvider(input: RegisterBuiltinProviderInput): void;
+    registerModel(input: RegisterModelInput): void;
+    getProviders(): RegisteredProviderSummary[];
+    getBuiltInProviderIds(): BuiltInProviderId[];
+    getBuiltInProviders(): Promise<BuiltInProviderSummary[]>;
+    getModels(providerId: string): string[];
+    isProviderConfigured(providerId: string): boolean;
+    isModelConfigured(providerId: string, modelId: string): boolean;
+}
+//# sourceMappingURL=runtime-types.d.ts.map

package/dist/llms/runtime-types.d.ts.map

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

package/dist/runtime/agent-config-adapter.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Cross-shape adapters between the **legacy host API** types
+ * (`ApiHandler`, `Tool`, `MessageWithMetadata`) and the **new
+ * runtime contract** types (`AgentModel`, `AgentTool`,
+ * `AgentMessage`) consumed by `AgentRuntime`.
+ *
+ * @see PLAN.md §3.1   — pure adapters; introduced alongside the core
+ *                       runtime port.
+ * @see PLAN.md §3.2.1 — consumed by `createAgentRuntimeConfig` to
+ *                       populate the `model`, `tools`, and
+ *                       `initialMessages` fields.
+ *
+ * These functions are intentionally **pure** (stateless adapters —
+ * they allocate fresh closures / arrays on every call and hold no
+ * internal state). Any state a consumer needs (e.g. an `AbortSignal`
+ * or a conversation id for `ToolContext.conversationId`) is injected
+ * per-call via the second-arg options object.
+ */
+import type { ApiHandler, ApiStreamChunk, ToolDefinition } from "@clinebot/llms";
+import type { AgentMessage, AgentModel, AgentModelEvent, AgentModelRequest, AgentTool, Message, MessageWithMetadata, Tool } from "@clinebot/shared";
+/**
+ * Context describing the model the `ApiHandler` talks to. This is
+ * used to populate `AgentMessage.modelInfo` on assistant messages
+ * emitted by the runtime. Matches PLAN.md §3.2.1 —
+ * `messageModelInfo = { id: modelId, provider: providerId, family:
+ * providerConfig?.family }`.
+ */
+export interface ApiHandlerAgentModelOptions {
+    /** Optional provider-family hint (e.g. `"claude-3.5"`). Attached as metadata. */
+    readonly family?: string;
+    /**
+     * Optional abort-signal factory. When provided, the returned
+     * `AgentModel.stream()` installs the signal on the handler via
+     * `handler.setAbortSignal()` before each call, and threads
+     * `request.signal` through for per-turn abort semantics.
+     */
+    readonly getAbortSignal?: () => AbortSignal | undefined;
+    /**
+     * Last-mile message preparation before the legacy handler builds a provider
+     * request. SessionRuntime uses this to apply API-safe normalization,
+     * tool-result truncation, and stale read-result rewriting with its
+     * session-owned MessageBuilder.
+     */
+    readonly prepareMessages?: (messages: Message[]) => Message[] | Promise<Message[]>;
+}
+/**
+ * Build an `AgentModel` adapter around an existing `ApiHandler`.
+ *
+ * The returned adapter:
+ *
+ *  1. Converts `AgentModelRequest.messages` (`AgentMessage[]`) back
+ *     into `LlmsProviders.Message[]` via
+ *     {@link agentMessagesToMessages}.
+ *  2. Converts `AgentModelRequest.tools`
+ *     (`AgentToolDefinition[]`) to `LlmsProviders.ToolDefinition[]`.
+ *  3. Invokes `handler.createMessage(systemPrompt, messages, tools)`.
+ *  4. Iterates the returned `ApiStream` and yields
+ *     `AgentModelEvent`s produced by {@link apiStreamChunkToAgentModelEvent}.
+ */
+export declare function apiHandlerToAgentModel(handler: ApiHandler, options?: ApiHandlerAgentModelOptions): AgentModel;
+/**
+ * Translate an `ApiStream` (async generator of `ApiStreamChunk`)
+ * into an async iterable of `AgentModelEvent`. Exposed for tests;
+ * production callers go through {@link apiHandlerToAgentModel}.
+ */
+export declare function translateApiStream(stream: AsyncIterable<ApiStreamChunk>): AsyncIterable<AgentModelEvent>;
+/**
+ * Map a single `ApiStreamChunk` to the corresponding
+ * `AgentModelEvent`. Returns `undefined` for chunks that carry no
+ * runtime-observable payload (currently none — but the hook exists
+ * so we can silently drop future additions without type breakage).
+ */
+export declare function apiStreamChunkToAgentModelEvent(chunk: ApiStreamChunk): AgentModelEvent | undefined;
+/**
+ * Options threaded into every adapted tool's `ToolContext`.
+ */
+export interface ToolAdapterOptions {
+    /**
+     * Conversation id bound to every `ToolContext.conversationId`
+     * the tool's `execute()` receives. The new runtime scopes tools
+     * by `AgentToolContext.agentId`/`.runId`; the legacy `ToolContext`
+     * requires `conversationId` separately, so the caller
+     * (`SessionRuntime`) supplies it once at adapter-construction
+     * time.
+     */
+    readonly conversationId: string;
+    /**
+     * Optional metadata merged into every tool execution
+     * (`AgentConfig.toolContextMetadata` equivalent).
+     */
+    readonly metadata?: Record<string, unknown>;
+}
+/**
+ * Adapt a legacy `Tool<TInput, TOutput>` to the new
+ * `AgentTool<TInput, TOutput>`.
+ *
+ *  - name/description/inputSchema flow through verbatim;
+ *  - `execute(input, AgentToolContext)` is wrapped so the legacy
+ *    signature `execute(input, ToolContext, onChange)` receives the
+ *    correct fields and the return value is boxed into an
+ *    `AgentToolResult`.
+ */
+export declare function toolToAgentTool<TInput, TOutput>(tool: Tool<TInput, TOutput>, options: ToolAdapterOptions): AgentTool<TInput, TOutput>;
+/**
+ * Convenience bulk-adapter for `AgentConfig.tools`.
+ */
+export declare function toolsToAgentTools(tools: readonly Tool[], options: ToolAdapterOptions): AgentTool[];
+/**
+ * Normalize a single `MessageWithMetadata` into an `AgentMessage`.
+ *
+ * Role mapping: the legacy `MessageRole` is `"user" | "assistant"`.
+ * `tool_result` content blocks on user messages are hoisted into a
+ * dedicated `AgentMessage` with role `"tool"` — matching how the new
+ * runtime's tool executor emits tool messages
+ * (`packages/agents/src/agent-runtime.ts` tool-finished path).
+ */
+export declare function messageToAgentMessages(message: MessageWithMetadata): AgentMessage[];
+/**
+ * Bulk-adapter: `MessageWithMetadata[]` → `AgentMessage[]`. A single
+ * legacy message with both text and tool-result blocks may expand
+ * into multiple agent messages (see {@link messageToAgentMessages}).
+ */
+export declare function messagesToAgentMessages(messages: readonly MessageWithMetadata[]): AgentMessage[];
+/**
+ * Reverse adapter: `AgentMessage` → `MessageWithMetadata`. Best-effort
+ * preservation of id/metadata/modelInfo/metrics; tool-message
+ * tool-result parts are rendered as `tool_result` content blocks on
+ * a user message (matching legacy storage conventions).
+ */
+export declare function agentMessageToMessageWithMetadata(message: AgentMessage): MessageWithMetadata;
+/**
+ * Bulk-adapter for the reverse direction.
+ */
+export declare function agentMessagesToMessagesWithMetadata(messages: readonly AgentMessage[]): MessageWithMetadata[];
+/**
+ * Lossy but adequate: `AgentMessage[]` → `LlmsProviders.Message[]`.
+ * Used to feed the legacy `ApiHandler.createMessage()` in
+ * {@link apiHandlerToAgentModel}. Drops fields that the handler
+ * does not consume (id, ts, metrics, modelInfo).
+ */
+export declare function agentMessagesToMessages(messages: readonly AgentMessage[]): Message[];
+/**
+ * Map runtime `AgentToolDefinition[]` to legacy
+ * `LlmsProviders.ToolDefinition[]`. Structurally identical today —
+ * but typing them separately keeps the adapter explicit.
+ */
+export declare function agentToolDefinitionsToToolDefinitions(tools: AgentModelRequest["tools"]): ToolDefinition[];
+//# sourceMappingURL=agent-config-adapter.d.ts.map

package/dist/runtime/agent-config-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-config-adapter.d.ts","sourceRoot":"","sources":["../../src/runtime/agent-config-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EACX,UAAU,EACV,cAAc,EACd,cAAc,EACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EACX,YAAY,EAEZ,UAAU,EACV,eAAe,EACf,iBAAiB,EAEjB,SAAS,EAMT,OAAO,EACP,mBAAmB,EAInB,IAAI,EAIJ,MAAM,kBAAkB,CAAC;AAM1B;;;;;;GAMG;AACH,MAAM,WAAW,2BAA2B;IAC3C,iFAAiF;IACjF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,WAAW,GAAG,SAAS,CAAC;IACxD;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,CAC1B,QAAQ,EAAE,OAAO,EAAE,KACf,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;CACpC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACrC,OAAO,EAAE,UAAU,EACnB,OAAO,GAAE,2BAAgC,GACvC,UAAU,CAkBZ;AAED;;;;GAIG;AACH,wBAAuB,kBAAkB,CACxC,MAAM,EAAE,aAAa,CAAC,cAAc,CAAC,GACnC,aAAa,CAAC,eAAe,CAAC,CAuBhC;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC9C,KAAK,EAAE,cAAc,GACnB,eAAe,GAAG,SAAS,CA8D7B;AAMD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC;;;;;;;OAOG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,EAC9C,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3B,OAAO,EAAE,kBAAkB,GACzB,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAgC5B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,OAAO,EAAE,kBAAkB,GACzB,SAAS,EAAE,CAEb;AAMD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACrC,OAAO,EAAE,mBAAmB,GAC1B,YAAY,EAAE,CAgChB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACtC,QAAQ,EAAE,SAAS,mBAAmB,EAAE,GACtC,YAAY,EAAE,CAMhB;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAChD,OAAO,EAAE,YAAY,GACnB,mBAAmB,CAarB;AAED;;GAEG;AACH,wBAAgB,mCAAmC,CAClD,QAAQ,EAAE,SAAS,YAAY,EAAE,GAC/B,mBAAmB,EAAE,CAEvB;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACtC,QAAQ,EAAE,SAAS,YAAY,EAAE,GAC/B,OAAO,EAAE,CA6BX;AAED;;;;GAIG;AACH,wBAAgB,qCAAqC,CACpD,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAC/B,cAAc,EAAE,CAMlB"}