catui-agent 1.0.0-beta.0

package/dist/core/mcp/mcp-config.d.ts

@@ -0,0 +1,55 @@
+import type { MCPServerConfig } from "./mcp-types.js";
+export interface MCPConfig {
+    mcpServers: MCPServerConfig[];
+}
+/**
+ * Get the path to the MCP configuration file
+ * @param agentDir Optional agent directory. If omitted, uses getAgentDir().
+ */
+export declare function getMCPConfigPath(agentDir?: string, configPathOverride?: string): string;
+/**
+ * Load MCP configuration from file
+ * @param agentDir Optional agent directory. If omitted, uses getAgentDir().
+ */
+export declare function loadMCPConfig(agentDir?: string, configPathOverride?: string): MCPConfig;
+/**
+ * Save MCP configuration to file
+ * @param config MCP configuration to save
+ * @param agentDir Optional agent directory. If omitted, uses getAgentDir().
+ */
+export declare function saveMCPConfig(config: MCPConfig, agentDir?: string): void;
+/**
+ * Add an MCP server configuration
+ * @param agentDir Optional agent directory. If omitted, uses getAgentDir().
+ */
+export declare function addMCPServer(server: MCPServerConfig, agentDir?: string): void;
+/**
+ * Remove an MCP server configuration
+ * @param agentDir Optional agent directory. If omitted, uses getAgentDir().
+ */
+export declare function removeMCPServer(serverId: string, agentDir?: string): void;
+/**
+ * Update an MCP server configuration
+ * @param agentDir Optional agent directory. If omitted, uses getAgentDir().
+ */
+export declare function updateMCPServer(serverId: string, updates: Partial<MCPServerConfig>, agentDir?: string): void;
+/**
+ * Enable/disable an MCP server
+ * @param agentDir Optional agent directory. If omitted, uses getAgentDir().
+ */
+export declare function setMCPServerEnabled(serverId: string, enabled: boolean, agentDir?: string): void;
+/**
+ * Get an MCP server by ID
+ * @param agentDir Optional agent directory. If omitted, uses getAgentDir().
+ */
+export declare function getMCPServer(serverId: string, agentDir?: string): MCPServerConfig | undefined;
+/**
+ * List all MCP servers
+ * @param agentDir Optional agent directory. If omitted, uses getAgentDir().
+ */
+export declare function listMCPServers(agentDir?: string): MCPServerConfig[];
+/**
+ * List enabled MCP servers
+ * @param agentDir Optional agent directory. If omitted, uses getAgentDir().
+ */
+export declare function listEnabledMCPServers(agentDir?: string, configPathOverride?: string): MCPServerConfig[];

package/dist/core/mcp/mcp-config.js

@@ -0,0 +1 @@
+var P=Object.defineProperty;var i=(r,e)=>P(r,"name",{value:e,configurable:!0});import{existsSync as f,mkdirSync as h,readFileSync as T,writeFileSync as x}from"fs";import{join as a,resolve as b}from"path";import{homedir as s}from"os";import{getAgentDir as u}from"../../config.js";const l={mcpServers:[{id:"filesystem",name:"Filesystem",command:"npx",args:["-y","@modelcontextprotocol/server-filesystem","{cwd}"],enabled:!0,transport:"stdio",toolTimeout:3e4},{id:"fetch",name:"Fetch (Web Scraper)",command:"npx",args:["-y","@kazuph/mcp-fetch"],enabled:!1,transport:"stdio",toolTimeout:3e4},{id:"sequential-thinking",name:"Sequential Thinking",command:"npx",args:["-y","@modelcontextprotocol/server-sequential-thinking"],enabled:!0,transport:"stdio",toolTimeout:3e4},{id:"memory",name:"Memory (Knowledge Graph)",command:"npx",args:["-y","@modelcontextprotocol/server-memory"],enabled:!0,transport:"stdio",toolTimeout:3e4},{id:"figma-desktop",name:"Figma Desktop MCP",url:"http://127.0.0.1:3845/mcp",enabled:!1,transport:"http",toolTimeout:6e4,initTimeout:2e4},{id:"figma-remote",name:"Figma Remote MCP",url:"https://mcp.figma.com/mcp",authProvider:"figma",authHeaderName:"Authorization",authScheme:"bearer",enabled:!1,transport:"http",toolTimeout:6e4,initTimeout:2e4},{id:"sqlite",name:"SQLite (Database)",command:"npx",args:["-y","mcp-server-sqlite"],enabled:!1,transport:"stdio",toolTimeout:3e4},{id:"github",name:"GitHub",command:"npx",args:["-y","@modelcontextprotocol/server-github"],env:{GITHUB_TOKEN:""},enabled:!1,transport:"stdio",toolTimeout:3e4},{id:"brave-search",name:"Brave Search",command:"npx",args:["-y","@modelcontextprotocol/server-brave-search"],env:{BRAVE_API_KEY:""},enabled:!1,transport:"stdio",toolTimeout:6e4},{id:"git",name:"Git",command:"npx",args:["-y","@liangshanli/mcp-server-git"],enabled:!1,transport:"stdio",toolTimeout:3e4},{id:"postgres",name:"PostgreSQL",command:"npx",args:["-y","@modelcontextprotocol/server-postgres"],env:{POSTGRES_CONNECTION_STRING:""},enabled:!1,transport:"stdio",toolTimeout:3e4}]};function C(r,e){if(e&&e.trim()){const o=e.trim();return o==="~"?s():o.startsWith("~/")?a(s(),o.slice(2)):o.startsWith("~")?a(s(),o.slice(1)):b(o)}const t=process.env.MCP_CONFIG_PATH;if(t&&t.trim()){const o=t.trim();return o==="~"?s():o.startsWith("~/")?a(s(),o.slice(2)):o.startsWith("~")?a(s(),o.slice(1)):b(o)}const n=r??u();return a(n,"mcp.json")}i(C,"getMCPConfigPath");function c(r,e){const t=C(r,e),n=r??u();if(!f(t)){const o=n;return f(o)||h(o,{recursive:!0}),x(t,JSON.stringify(l,null,2),"utf-8"),l}try{const o=T(t,"utf-8"),m=JSON.parse(o),g=m.mcpServers??[],y=new Set(g.map(d=>d.id)),v=l.mcpServers.filter(d=>!y.has(d.id));if(v.length===0)return m;const S={mcpServers:[...g,...v]};return p(S,r),S}catch(o){return console.error(`Failed to load MCP config: ${o}`),l}}i(c,"loadMCPConfig");function p(r,e){const t=C(e),n=e??u();f(n)||h(n,{recursive:!0}),x(t,JSON.stringify(r,null,2),"utf-8")}i(p,"saveMCPConfig");function G(r,e){const t=c(e);t.mcpServers=t.mcpServers.filter(n=>n.id!==r.id),t.mcpServers.push(r),p(t,e)}i(G,"addMCPServer");function O(r,e){const t=c(e);t.mcpServers=t.mcpServers.filter(n=>n.id!==r),p(t,e)}i(O,"removeMCPServer");function M(r,e,t){const n=c(t),o=n.mcpServers.find(m=>m.id===r);o&&(Object.assign(o,e),p(n,t))}i(M,"updateMCPServer");function k(r,e,t){M(r,{enabled:e},t)}i(k,"setMCPServerEnabled");function I(r,e){return c(e).mcpServers.find(n=>n.id===r)}i(I,"getMCPServer");function q(r){return c(r).mcpServers}i(q,"listMCPServers");function W(r,e){return c(r,e).mcpServers.filter(n=>n.enabled!==!1)}i(W,"listEnabledMCPServers");export{G as addMCPServer,C as getMCPConfigPath,I as getMCPServer,W as listEnabledMCPServers,q as listMCPServers,c as loadMCPConfig,O as removeMCPServer,p as saveMCPConfig,k as setMCPServerEnabled,M as updateMCPServer};

package/dist/core/mcp/mcp-guidance.d.ts

@@ -0,0 +1,52 @@
+/**
+ * [WHO]: APIKeyGuidance, getAPIKeyGuidance(), formatGuidanceMessage()
+ * [FROM]: No external dependencies
+ * [TO]: Consumed by core/mcp/index.ts, core/mcp/mcp-adapter.ts
+ * [HERE]: core/mcp/mcp-guidance.ts - API key guidance for MCP servers
+ */
+export interface APIKeyGuidance {
+    /** Server ID */
+    serverId: string;
+    /** Server name */
+    serverName: string;
+    /** Whether key is required */
+    required: boolean;
+    /** API key environment variable name */
+    envVar: string;
+    /** User-friendly instructions */
+    instructions: string;
+    /** URL to get the key */
+    getKeyUrl?: string;
+    /** Free tier information */
+    freeTier?: string;
+    /** Alternative (skip key) */
+    alternative?: string;
+}
+/**
+ * Guidance for MCP servers that require API keys
+ */
+export declare const API_KEY_GUIDANCE: Record<string, APIKeyGuidance>;
+/**
+ * Get guidance for a specific server
+ */
+export declare function getAPIKeyGuidance(serverId: string): APIKeyGuidance | undefined;
+/**
+ * Check if a server requires an API key
+ */
+export declare function requiresAPIKey(serverId: string): boolean;
+/**
+ * Get list of servers that require API keys
+ */
+export declare function getRequiringAPIKeyServers(): string[];
+/**
+ * Get list of servers with optional API keys
+ */
+export declare function getOptionalAPIKeyServers(): string[];
+/**
+ * Format guidance as a user-friendly message
+ */
+export declare function formatGuidanceMessage(guidance: APIKeyGuidance, missingKey?: boolean): string;
+/**
+ * Get all servers that are configured but missing keys
+ */
+export declare function getMissingKeyServers(configuredServers: string[]): string[];

package/dist/core/mcp/mcp-guidance.js

@@ -0,0 +1,54 @@
+var c=Object.defineProperty;var s=(e,r)=>c(e,"name",{value:r,configurable:!0});const o={github:{serverId:"github",serverName:"GitHub",required:!1,envVar:"GITHUB_TOKEN",instructions:`GitHub Token is used to access GitHub repositories, issues, and PRs.
+
+**Steps to obtain:**
+1. Visit https://github.com/settings/tokens
+2. Click "Generate new token" (classic)
+3. Select permissions:
+   - repo (Full control of private repositories)
+   - public_repo (Access public repositories)
+4. Click "Generate token"
+5. Copy the token (format: ghp_xxxxxxxxxxxxxxxxxxxx)
+6. Configure in mcp.json:
+   {
+     "id": "github",
+     "enabled": true,
+     "env": {
+       "GITHUB_TOKEN": "your_token"
+     }
+   }`,getKeyUrl:"https://github.com/settings/tokens",freeTier:"Free",alternative:"Public repositories can still be accessed without a token"},"brave-search":{serverId:"brave-search",serverName:"Brave Search",required:!1,envVar:"BRAVE_API_KEY",instructions:`Brave Search API Key is used for web search functionality.
+
+**Steps to obtain:**
+1. Visit https://api.search.brave.com/app/keys
+2. Sign up (or log in)
+3. Click "Create API Key"
+4. Copy the API Key (format: BSxxxxx)
+5. Configure in mcp.json:
+   {
+     "id": "brave-search",
+     "enabled": true,
+     "env": {
+       "BRAVE_API_KEY": "your_api_key"
+     }
+   }`,getKeyUrl:"https://api.search.brave.com/app/keys",freeTier:"Free tier: 2000 queries per month",alternative:"Without search, other tools remain available"},postgres:{serverId:"postgres",serverName:"PostgreSQL",required:!1,envVar:"POSTGRES_CONNECTION_STRING",instructions:`PostgreSQL connection string is used to connect to a local database.
+
+**Configuration steps:**
+1. Ensure PostgreSQL is installed
+2. Prepare the connection string in format:
+   postgresql://user:password@localhost:5432/dbname
+3. Configure in mcp.json:
+   {
+     "id": "postgres",
+     "enabled": true,
+     "env": {
+       "POSTGRES_CONNECTION_STRING": "your_connection_string"
+     }
+   }`,freeTier:"Free (local database)",alternative:"Use SQLite (enabled by default)"}};function u(e){return o[e]}s(u,"getAPIKeyGuidance");function f(e){const r=o[e];return r?r.required:!1}s(f,"requiresAPIKey");function v(){return Object.values(o).filter(e=>e.required).map(e=>e.serverId)}s(v,"getRequiringAPIKeyServers");function l(){return Object.values(o).filter(e=>!e.required).map(e=>e.serverId)}s(l,"getOptionalAPIKeyServers");function g(e,r=!0){const i=r?"\u26A0\uFE0F  ":"\u2139\uFE0F  ",n=r?"API Key not configured":"API Key configured";let t=`${i}${e.serverName} - ${n}
+
+`;return t+=`${e.instructions}
+`,e.getKeyUrl&&(t+=`
+\u{1F517} Get API Key: ${e.getKeyUrl}
+`),e.freeTier&&(t+=`
+\u{1F4B0} ${e.freeTier}
+`),e.alternative&&(t+=`
+\u{1F4A1} ${e.alternative}
+`),t}s(g,"formatGuidanceMessage");function x(e){const r=l(),i=[];for(const n of e)if(r.includes(n)){const t=u(n);if(t&&t.envVar){const a=process.env[t.envVar];(!a||a.trim()===""||a==="YOUR_TOKEN")&&i.push(n)}}return i}s(x,"getMissingKeyServers");export{o as API_KEY_GUIDANCE,g as formatGuidanceMessage,u as getAPIKeyGuidance,x as getMissingKeyServers,l as getOptionalAPIKeyServers,v as getRequiringAPIKeyServers,f as requiresAPIKey};

package/dist/core/mcp/mcp-manager.d.ts

@@ -0,0 +1,51 @@
+/**
+ * [WHO]: MCPManager class
+ * [FROM]: Depends on mcp/mcp-client, mcp/mcp-adapter, mcp/mcp-config, extensions
+ * [TO]: Consumed by core/index.ts, core/runtime/sdk.ts
+ * [HERE]: core/mcp/mcp-manager.ts - MCP client lifecycle and tool integration
+ */
+import { MCPClient } from "./mcp-client.js";
+import type { ToolDefinition } from "../extensions-host/index.js";
+export interface MCPManagerOptions {
+    mcpConfigPath?: string;
+}
+export declare class MCPManager {
+    private client;
+    private tools;
+    private enabledServerIds;
+    private startedServerIds;
+    private failedServerIds;
+    private workingDir;
+    private mcpConfigPath?;
+    constructor(options?: MCPManagerOptions);
+    /**
+     * Set the working directory for MCP servers (e.g., user's project dir)
+     */
+    setWorkingDir(dir: string): void;
+    /**
+     * Initialize MCP manager and load tools
+     */
+    initialize(): Promise<void>;
+    /**
+     * Resolve dynamic placeholders in server configuration
+     */
+    private resolveServerConfig;
+    /**
+     * Get all MCP tools as Catui ToolDefinitions
+     */
+    getTools(): ToolDefinition[];
+    /**
+     * Get the MCP client instance
+     */
+    getClient(): MCPClient;
+    getStatus(): {
+        enabledServers: string[];
+        startedServers: string[];
+        failedServers: string[];
+        toolCount: number;
+    };
+    /**
+     * Cleanup: stop all servers
+     */
+    dispose(): void;
+}

package/dist/core/mcp/mcp-manager.js

@@ -0,0 +1 @@
+var o=Object.defineProperty;var i=(t,r)=>o(t,"name",{value:r,configurable:!0});import{MCPClient as n}from"./mcp-client.js";import{loadMCPTools as d}from"./mcp-adapter.js";import{listEnabledMCPServers as a}from"./mcp-config.js";class f{static{i(this,"MCPManager")}client;tools=[];enabledServerIds=[];startedServerIds=[];failedServerIds=[];workingDir;mcpConfigPath;constructor(r){this.mcpConfigPath=r?.mcpConfigPath,this.client=new n(void 0,void 0,this.mcpConfigPath),this.workingDir=process.cwd()}setWorkingDir(r){this.workingDir=r}async initialize(){let r=a(void 0,this.mcpConfigPath);this.enabledServerIds=r.map(e=>e.id),this.startedServerIds=[],this.failedServerIds=[],r=r.map(e=>this.resolveServerConfig(e));for(const e of r)this.client.addServer(e),e.transport!=="sse"?await this.client.startServer(e.id)?this.startedServerIds.push(e.id):this.failedServerIds.push(e.id):this.startedServerIds.push(e.id);this.tools=await d(this.client)}resolveServerConfig(r){const e={...r};return e.args&&(e.args=e.args.map(s=>s.replace(/\{cwd\}/g,this.workingDir))),e.cwd||(e.cwd=this.workingDir),e}getTools(){return this.tools}getClient(){return this.client}getStatus(){return{enabledServers:[...this.enabledServerIds],startedServers:[...this.startedServerIds],failedServers:[...this.failedServerIds],toolCount:this.tools.length}}dispose(){this.client.stopAllServers()}}export{f as MCPManager};

package/dist/core/mcp/mcp-types.d.ts

@@ -0,0 +1,62 @@
+/**
+ * [WHO]: Provides MCPServerConfig, MCPTool, MCPToolResult shared MCP contracts
+ * [FROM]: No runtime dependencies; pure type surface for MCP client/config/adapter
+ * [TO]: Consumed by core/mcp/mcp-client.ts, mcp-config.ts, mcp-manager.ts, mcp-adapter.ts, index.ts
+ * [HERE]: core/mcp/mcp-types.ts - shared contracts that keep MCP client/config acyclic
+ */
+export interface MCPServerConfig {
+    /** Unique identifier for this server */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Command to start the server (e.g., "npx", "uvx") */
+    command?: string;
+    /** Arguments to pass to the command */
+    args?: string[];
+    /** Streamable HTTP endpoint for remote/local HTTP MCP servers */
+    url?: string;
+    /** Additional headers for HTTP MCP servers */
+    headers?: Record<string, string>;
+    /** Credential provider id stored in auth.json for HTTP MCP servers */
+    authProvider?: string;
+    /** Header name to use when authProvider resolves a token */
+    authHeaderName?: string;
+    /** Header auth scheme. "bearer" prefixes the token, "raw" passes it as-is */
+    authScheme?: "bearer" | "raw";
+    /** Environment variables to pass */
+    env?: Record<string, string>;
+    /** Transport type: "stdio", "sse", or "http" */
+    transport?: "stdio" | "sse" | "http";
+    /** Whether this server is enabled */
+    enabled?: boolean;
+    /** Tool call timeout in milliseconds (default: 20000) */
+    toolTimeout?: number;
+    /** Initialize request timeout in milliseconds (default: 20000) */
+    initTimeout?: number;
+    /** Working directory for the server process */
+    cwd?: string;
+}
+export interface MCPTool {
+    /** Tool name (server_id/tool_name format) */
+    name: string;
+    /** Display name */
+    displayName?: string;
+    /** Tool description */
+    description: string;
+    /** JSON Schema for input */
+    inputSchema: Record<string, unknown>;
+    /** Server ID */
+    serverId: string;
+}
+export interface MCPToolResult {
+    /** Tool result content */
+    content: Array<{
+        type: "text" | "image" | "resource";
+        text?: string;
+        data?: any;
+    }>;
+    /** Error message if call failed */
+    error?: string;
+    /** Whether result is partial (hasMore=true) */
+    isPartial?: boolean;
+}

package/dist/core/messages.d.ts

@@ -0,0 +1,77 @@
+/**
+ * [WHO]: AgentMessage extensions, convertToLlm(), message transformers
+ * [FROM]: Depends on agent-core, ai
+ * [TO]: Consumed by index.ts, core/runtime/sdk.ts, core/session/session-manager.ts, modes/interactive/interactive-mode.ts, modes/interactive/components/branch-summary-message.ts, modes/interactive/components/compaction-summary-message.ts, modes/interactive/components/custom-message.ts
+ * [HERE]: core/messages.ts - custom message types and LLM transformers
+ */
+import type { AgentMessage } from "@catui/agent-core";
+import type { ImageContent, Message, TextContent } from "@catui/ai/types";
+export declare const COMPACTION_SUMMARY_PREFIX = "The conversation history before this point was compacted into the following summary:\n\n<summary>\n";
+export declare const COMPACTION_SUMMARY_SUFFIX = "\n</summary>";
+export declare const BRANCH_SUMMARY_PREFIX = "The following is a summary of a branch that this conversation came back from:\n\n<summary>\n";
+export declare const BRANCH_SUMMARY_SUFFIX = "</summary>";
+export declare const CUSTOM_MESSAGE_TYPES_EXCLUDED_FROM_CONTEXT: Set<string>;
+/**
+ * Message type for bash executions via the ! command.
+ */
+export interface BashExecutionMessage {
+    role: "bashExecution";
+    command: string;
+    output: string;
+    exitCode: number | undefined;
+    cancelled: boolean;
+    truncated: boolean;
+    fullOutputPath?: string;
+    timestamp: number;
+    /** If true, this message is excluded from LLM context (!! prefix) */
+    excludeFromContext?: boolean;
+}
+/**
+ * Message type for extension-injected messages via sendMessage().
+ * These are custom messages that extensions can inject into the conversation.
+ */
+export interface CustomMessage<T = unknown> {
+    role: "custom";
+    customType: string;
+    content: string | (TextContent | ImageContent)[];
+    display: boolean;
+    details?: T;
+    timestamp: number;
+}
+export interface BranchSummaryMessage {
+    role: "branchSummary";
+    summary: string;
+    fromId: string;
+    timestamp: number;
+}
+export interface CompactionSummaryMessage {
+    role: "compactionSummary";
+    summary: string;
+    tokensBefore: number;
+    timestamp: number;
+}
+declare module "@catui/agent-core" {
+    interface CustomAgentMessages {
+        bashExecution: BashExecutionMessage;
+        custom: CustomMessage;
+        branchSummary: BranchSummaryMessage;
+        compactionSummary: CompactionSummaryMessage;
+    }
+}
+/**
+ * Convert a BashExecutionMessage to user message text for LLM context.
+ */
+export declare function bashExecutionToText(msg: BashExecutionMessage): string;
+export declare function createBranchSummaryMessage(summary: string, fromId: string, timestamp: string): BranchSummaryMessage;
+export declare function createCompactionSummaryMessage(summary: string, tokensBefore: number, timestamp: string): CompactionSummaryMessage;
+/** Convert CustomMessageEntry to AgentMessage format */
+export declare function createCustomMessage(customType: string, content: string | (TextContent | ImageContent)[], display: boolean, details: unknown | undefined, timestamp: string): CustomMessage;
+/**
+ * Transform AgentMessages (including custom types) to LLM-compatible Messages.
+ *
+ * This is used by:
+ * - Agent's transormToLlm option (for prompt calls and queued messages)
+ * - Compaction's generateSummary (for summarization)
+ * - Custom extensions and tools
+ */
+export declare function convertToLlm(messages: AgentMessage[]): Message[];

package/dist/core/messages.js

@@ -0,0 +1,17 @@
+var u=Object.defineProperty;var o=(e,t)=>u(e,"name",{value:t,configurable:!0});const c=`The conversation history before this point was compacted into the following summary:
+
+<summary>
+`,s=`
+</summary>`,i=`The following is a summary of a branch that this conversation came back from:
+
+<summary>
+`,m="</summary>",p=new Set(["presence","btw","recap"]);function l(e){let t=`Ran \`${e.command}\`
+`;return e.output?t+=`\`\`\`
+${e.output}
+\`\`\``:t+="(no output)",e.cancelled?t+=`
+
+(command cancelled)`:e.exitCode!==null&&e.exitCode!==void 0&&e.exitCode!==0&&(t+=`
+
+Command exited with code ${e.exitCode}`),e.truncated&&e.fullOutputPath&&(t+=`
+
+[Output truncated. Full output: ${e.fullOutputPath}]`),t}o(l,"bashExecutionToText");function d(e,t,n){return{role:"branchSummary",summary:e,fromId:t,timestamp:new Date(n).getTime()}}o(d,"createBranchSummaryMessage");function f(e,t,n){return{role:"compactionSummary",summary:e,tokensBefore:t,timestamp:new Date(n).getTime()}}o(f,"createCompactionSummaryMessage");function y(e,t,n,r,a){return{role:"custom",customType:e,content:t,display:n,details:r,timestamp:new Date(a).getTime()}}o(y,"createCustomMessage");function h(e){return e.map(t=>{switch(t.role){case"bashExecution":return t.excludeFromContext?void 0:{role:"user",content:[{type:"text",text:l(t)}],timestamp:t.timestamp};case"custom":return p.has(t.customType)?void 0:{role:"user",content:typeof t.content=="string"?[{type:"text",text:t.content}]:t.content,timestamp:t.timestamp};case"branchSummary":return{role:"user",content:[{type:"text",text:i+t.summary+m}],timestamp:t.timestamp};case"compactionSummary":return{role:"user",content:[{type:"text",text:c+t.summary+s}],timestamp:t.timestamp};case"user":case"assistant":case"toolResult":return t;default:const n=t;return}}).filter(t=>t!==void 0)}o(h,"convertToLlm");export{i as BRANCH_SUMMARY_PREFIX,m as BRANCH_SUMMARY_SUFFIX,c as COMPACTION_SUMMARY_PREFIX,s as COMPACTION_SUMMARY_SUFFIX,p as CUSTOM_MESSAGE_TYPES_EXCLUDED_FROM_CONTEXT,l as bashExecutionToText,h as convertToLlm,d as createBranchSummaryMessage,f as createCompactionSummaryMessage,y as createCustomMessage};

package/dist/core/model/custom-providers.d.ts

@@ -0,0 +1,34 @@
+/**
+ * [WHO]: CUSTOM_ANTHROPIC_PROVIDER, CUSTOM_OPENAI_PROVIDER, registerCustomProvider()
+ * [FROM]: Depends on config/auth-storage, node:fs
+ * [TO]: Consumed by core/model-registry.ts
+ * [HERE]: core/model/custom-providers.ts - custom provider registration
+ */
+import type { AuthStorage } from "../platform/config/auth-storage.js";
+export declare const CUSTOM_ANTHROPIC_PROVIDER = "custom-anthropic";
+export declare const CUSTOM_OPENAI_PROVIDER = "custom-openai";
+export type CustomProtocolProviderId = typeof CUSTOM_ANTHROPIC_PROVIDER | typeof CUSTOM_OPENAI_PROVIDER;
+type CustomProtocolProviderDefinition = {
+    id: CustomProtocolProviderId;
+    label: string;
+    description: string;
+    defaultBaseUrl: string;
+    api: "anthropic-messages" | "openai-completions";
+    defaultInput: ("text" | "image")[];
+};
+export declare function isCustomProtocolProvider(provider: string): provider is CustomProtocolProviderId;
+export declare function listCustomProtocolProviders(): CustomProtocolProviderId[];
+export declare function getCustomProtocolProviderDefinition(provider: CustomProtocolProviderId): CustomProtocolProviderDefinition;
+export declare function getCustomProtocolProviderBaseUrl(modelsPath: string, provider: CustomProtocolProviderId): string | undefined;
+export declare function getCustomProtocolProviderModelName(modelsPath: string, provider: CustomProtocolProviderId): string | undefined;
+export declare function ensureCustomProtocolProvidersInModels(modelsPath: string): void;
+export declare function saveCustomProtocolProviderConfig(modelsPath: string, provider: CustomProtocolProviderId, configUpdate: {
+    baseUrl: string;
+    modelName: string;
+    apiKey?: string;
+}): Promise<{
+    contextWindow?: number;
+    maxTokens?: number;
+} | null>;
+export declare function saveCustomProtocolProviderApiKey(authStorage: AuthStorage, provider: CustomProtocolProviderId, apiKey: string): void;
+export {};

package/dist/core/model/custom-providers.js

@@ -0,0 +1 @@
+var b=Object.defineProperty;var r=(e,t)=>b(e,"name",{value:t,configurable:!0});import{existsSync as M,mkdirSync as O,readFileSync as I,writeFileSync as A}from"fs";import{dirname as S}from"node:path";const d="custom-anthropic",m="custom-openai",p="custom-model",f=2,w={[d]:{id:d,label:"Anthropic-compatible",description:"Configure or edit an endpoint that speaks the Anthropic Messages API.",defaultBaseUrl:"https://api.anthropic.com/v1",api:"anthropic-messages",defaultInput:["text","image"]},[m]:{id:m,label:"OpenAI-compatible",description:"Configure or edit an endpoint that speaks an OpenAI-compatible API.",defaultBaseUrl:"https://api.openai.com/v1",api:"openai-completions",defaultInput:["text","image"]}};function g(e){if(!M(e))return{providers:{}};const t=I(e,"utf-8");return{providers:JSON.parse(t).providers??{}}}r(g,"readModelsConfig");function h(e,t){O(S(e),{recursive:!0}),A(e,JSON.stringify(t,null,2),"utf-8")}r(h,"writeModelsConfig");function y(e,t,o){const n=C(e),s=t.trim()||p;return{id:s,name:s,api:n.api,input:n.defaultInput,contextWindow:o?.contextWindow??256e3,maxTokens:o?.maxTokens??32768}}r(y,"createCustomModelDefinition");async function _(e,t,o,n){try{if(e===d)return null;if(t.includes("localhost:11434")||t.includes("127.0.0.1:11434")){const s=await N(n);if(s)return s}return o?await U(t,o,n):null}catch{return null}}r(_,"probeModelContextWindow");async function N(e){try{const o=await fetch("http://localhost:11434/api/show",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({name:e}),signal:AbortSignal.timeout(5e3)});if(!o.ok)return null;const s=(await o.json()).model_info;if(!s)return null;const i=s["general.context_length"];return typeof i=="number"&&i>0?{contextWindow:i}:null}catch{return null}}r(N,"probeOllamaModelInfo");async function U(e,t,o){try{const n=E(e),s=await fetch(n,{headers:{Authorization:`Bearer ${t}`},signal:AbortSignal.timeout(5e3)});if(!s.ok)return null;const c=(await s.json()).data;if(!Array.isArray(c))return null;const l=c.find(u=>u.id===o);if(!l)return null;const a=l.context_length??l.max_context_length??l.top_provider?.context_length;return typeof a=="number"&&a>0?{contextWindow:a}:null}catch{return null}}r(U,"probeOpenAICompatibleModels");function E(e){const t=e.replace(/\/+$/,"");return t.endsWith("/chat/completions")?t.slice(0,-17)+"/models":(t.endsWith("/v1"),t+"/models")}r(E,"buildModelsEndpoint");function v(e,t){try{return g(e).providers?.[t]}catch{return}}r(v,"getStoredProviderConfig");function x(e){const t=e?.models;if(!Array.isArray(t)||t.length===0)return;const o=t[0];if(typeof o=="object"&&o!==null&&"id"in o&&typeof o.id=="string"&&o.id.trim())return o.id.trim()}r(x,"getStoredModelId");function R(e){const t=e?.models;return Array.isArray(t)?t.length:0}r(R,"getStoredModelCount");function T(e){const t=e?.customProviderVersion;return typeof t=="number"?t:void 0}r(T,"getStoredConfigVersion");function W(e){return e===d||e===m}r(W,"isCustomProtocolProvider");function V(){return[d,m]}r(V,"listCustomProtocolProviders");function C(e){return w[e]}r(C,"getCustomProtocolProviderDefinition");function F(e,t){const n=v(e,t)?.baseUrl;return typeof n=="string"&&n.trim()?n.trim():void 0}r(F,"getCustomProtocolProviderBaseUrl");function J(e,t){return x(v(e,t))}r(J,"getCustomProtocolProviderModelName");function L(e){let t;try{t=g(e)}catch{return}t.providers??={};let o=!1;for(const n of V()){const s=C(n),i=t.providers[n],a=T(i)!==f||R(i)!==1?p:x(i)??p,u=[y(n,a)];if(!i){t.providers[n]={baseUrl:s.defaultBaseUrl,customProviderVersion:f,models:u},o=!0;continue}(typeof i.baseUrl!="string"||!i.baseUrl.trim())&&(i.baseUrl=s.defaultBaseUrl,o=!0),i.customProviderVersion!==f&&(i.customProviderVersion=f,o=!0);const P=i.models;JSON.stringify(P)!==JSON.stringify(u)&&(i.models=u,o=!0)}o&&h(e,t)}r(L,"ensureCustomProtocolProvidersInModels");async function j(e,t,o){const n=o.baseUrl.trim(),s=o.modelName.trim();if(!n)throw new Error("Base URL cannot be empty.");if(!s)throw new Error("Model name cannot be empty.");const i=await _(t,n,o.apiKey,s),c=g(e);return c.providers??={},c.providers[t]={...c.providers[t]??{},baseUrl:n,customProviderVersion:f,models:[y(t,s,i??void 0)]},h(e,c),i}r(j,"saveCustomProtocolProviderConfig");function $(e,t,o){const n=o.trim();if(!n)throw new Error("API key cannot be empty.");e.set(t,{type:"api_key",key:n})}r($,"saveCustomProtocolProviderApiKey");export{d as CUSTOM_ANTHROPIC_PROVIDER,m as CUSTOM_OPENAI_PROVIDER,L as ensureCustomProtocolProvidersInModels,F as getCustomProtocolProviderBaseUrl,C as getCustomProtocolProviderDefinition,J as getCustomProtocolProviderModelName,W as isCustomProtocolProvider,V as listCustomProtocolProviders,$ as saveCustomProtocolProviderApiKey,j as saveCustomProtocolProviderConfig};

package/dist/core/model/discovery-cache.d.ts

@@ -0,0 +1,65 @@
+/**
+ * [WHO]: DiscoveryCache - read/write/clear cached discovery results
+ * [FROM]: Depends on node:fs, discovery types (DiscoveryResult)
+ * [TO]: Consumed by core/model-registry.ts for persistence of discovery data
+ * [HERE]: core/model/discovery-cache.ts - filesystem cache for remote model discovery
+ *
+ * Caches DiscoveryResult objects as JSON files in {agentDir}/.cache/discovery/.
+ * Each provider gets its own file: {provider}.json
+ * Supports TTL-based expiration (default 24h).
+ */
+import type { DiscoveryResult } from "./discovery.js";
+/**
+ * Filesystem-backed cache for discovery results.
+ *
+ * Directory structure:
+ * ```
+ * {cacheDir}/
+ * ├── dashscope-coding.json
+ * ├── ollama.json
+ * └── ali-token-plan-openai.json
+ * ```
+ *
+ * Each file contains a serialized DiscoveryResult with TTL metadata.
+ */
+export declare class DiscoveryCache {
+    private cacheDir;
+    constructor(cacheDir: string);
+    /**
+     * Get the filesystem path for a provider's cache file.
+     * Sanitizes provider name to avoid path traversal.
+     */
+    private providerCachePath;
+    /**
+     * Read a cached discovery result.
+     * Returns undefined if:
+     * - The file doesn't exist
+     * - The file is corrupted (JSON parse error)
+     * - The result has expired (age > TTL)
+     *
+     * @param provider    Provider name
+     * @param ttlSeconds  Time-to-live in seconds (default: 24h)
+     */
+    read(provider: string, ttlSeconds?: number): DiscoveryResult | undefined;
+    /**
+     * Write a discovery result to the cache.
+     * Creates the cache directory if it doesn't exist.
+     */
+    write(result: DiscoveryResult): void;
+    /**
+     * Check if a cache entry exists and is fresh (without reading full content).
+     */
+    isFresh(provider: string, ttlSeconds?: number): boolean;
+    /**
+     * Remove a single provider's cache file.
+     */
+    remove(provider: string): void;
+    /**
+     * Clear all cached discovery data by removing the cache directory.
+     */
+    clear(): void;
+    /**
+     * List all provider names that have cached data (fresh or stale).
+     */
+    listProviders(): string[];
+}

package/dist/core/model/discovery-cache.js

@@ -0,0 +1 @@
+var d=Object.defineProperty;var s=(n,r)=>d(n,"name",{value:r,configurable:!0});import{existsSync as c,mkdirSync as u,readFileSync as f,readdirSync as p,renameSync as y,rmSync as a,writeFileSync as m}from"node:fs";import{join as D}from"node:path";import{DEFAULT_DISCOVERY_TTL_SECONDS as h}from"./discovery.js";class A{static{s(this,"DiscoveryCache")}cacheDir;constructor(r){this.cacheDir=r}providerCachePath(r){const e=r.replace(/[^a-zA-Z0-9_.-]/g,"_");return D(this.cacheDir,`${e}.json`)}read(r,e=h){const t=this.providerCachePath(r);if(c(t))try{const o=f(t,"utf-8"),i=JSON.parse(o);return!i||typeof i!="object"||!Array.isArray(i.models)||Date.now()-i.fetchedAt>e*1e3?void 0:i}catch{return}}write(r){try{c(this.cacheDir)||u(this.cacheDir,{recursive:!0});const e=this.providerCachePath(r.provider),t=e+".tmp";m(t,JSON.stringify(r,null,2),"utf-8"),y(t,e)}catch{}}isFresh(r,e=h){return this.read(r,e)!==void 0}remove(r){const e=this.providerCachePath(r);try{c(e)&&a(e)}catch{}}clear(){try{c(this.cacheDir)&&a(this.cacheDir,{recursive:!0,force:!0})}catch{}}listProviders(){if(!c(this.cacheDir))return[];try{return p(this.cacheDir).filter(e=>e.endsWith(".json")).map(e=>e.replace(/\.json$/,""))}catch{return[]}}}export{A as DiscoveryCache};

package/dist/core/model/discovery-cache.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * [WHO]: Tests for DiscoveryCache read/write/clear
+ * [FROM]: Depends on ./discovery-cache.js
+ * [TO]: None (test file)
+ * [HERE]: core/model/discovery-cache.test.ts — filesystem cache tests
+ */
+export {};

package/dist/core/model/discovery-cache.test.js

@@ -0,0 +1 @@
+var f=Object.defineProperty;var l=(i,e)=>f(i,"name",{value:e,configurable:!0});import r from"node:assert";import{describe as c,it as t,beforeEach as p,afterEach as v}from"node:test";import{existsSync as d,mkdirSync as u,rmSync as m,writeFileSync as h}from"node:fs";import{join as a}from"node:path";import{tmpdir as w}from"node:os";import{DiscoveryCache as y}from"./discovery-cache.js";function o(i={}){return{provider:"test-provider",models:[{id:"model-a",name:"Model A"}],fetchedAt:Date.now(),ttl:86400,...i}}l(o,"makeResult"),c("DiscoveryCache",()=>{let i,e;p(()=>{i=a(w(),`discovery-cache-test-${Date.now()}-${Math.random().toString(36).slice(2)}`),e=new y(i)}),v(()=>{try{d(i)&&m(i,{recursive:!0,force:!0})}catch{}}),c("write and read",()=>{t("writes and reads back a discovery result",()=>{const s=o();e.write(s);const n=e.read("test-provider");r.ok(n),r.strictEqual(n.provider,"test-provider"),r.strictEqual(n.models.length,1),r.strictEqual(n.models[0].id,"model-a")}),t("creates cache directory if it doesn't exist",()=>{r.strictEqual(d(i),!1),e.write(o()),r.strictEqual(d(i),!0)}),t("returns undefined for non-existent provider",()=>{r.strictEqual(e.read("nonexistent"),void 0)})}),c("TTL expiration",()=>{t("returns cached result when fresh (within TTL)",()=>{const s=o({fetchedAt:Date.now()-1e3});e.write(s);const n=e.read("test-provider",86400);r.ok(n)}),t("returns undefined when expired (beyond TTL)",()=>{const s=o({fetchedAt:Date.now()-2e5});e.write(s);const n=e.read("test-provider",100);r.strictEqual(n,void 0)}),t("uses default TTL of 24h when not specified",()=>{const s=o({fetchedAt:Date.now()-36e5});e.write(s);const n=e.read("test-provider");r.ok(n)})}),c("error handling",()=>{t("returns undefined for corrupted JSON file",()=>{u(i,{recursive:!0}),h(a(i,"test-provider.json"),"not json{{{","utf-8"),r.strictEqual(e.read("test-provider"),void 0)}),t("returns undefined for file with invalid structure",()=>{u(i,{recursive:!0}),h(a(i,"test-provider.json"),JSON.stringify({foo:"bar"}),"utf-8"),r.strictEqual(e.read("test-provider"),void 0)}),t("sanitizes provider names with special characters",()=>{const s=o({provider:"test/../provider"});e.write(s);const n=e.read("test/../provider");r.ok(n)})}),c("isFresh",()=>{t("returns true for fresh cache entry",()=>{e.write(o()),r.strictEqual(e.isFresh("test-provider"),!0)}),t("returns false for expired cache entry",()=>{const s=o({fetchedAt:Date.now()-2e5});e.write(s),r.strictEqual(e.isFresh("test-provider",100),!1)}),t("returns false for non-existent entry",()=>{r.strictEqual(e.isFresh("nonexistent"),!1)})}),c("remove",()=>{t("removes a specific provider's cache file",()=>{e.write(o()),r.strictEqual(e.isFresh("test-provider"),!0),e.remove("test-provider"),r.strictEqual(e.isFresh("test-provider"),!1)}),t("does nothing for non-existent provider",()=>{e.remove("nonexistent")})}),c("clear",()=>{t("removes entire cache directory",()=>{e.write(o({provider:"a"})),e.write(o({provider:"b"})),r.strictEqual(d(i),!0),e.clear(),r.strictEqual(d(i),!1)}),t("does nothing when cache directory doesn't exist",()=>{e.clear()})}),c("listProviders",()=>{t("lists all cached provider names",()=>{e.write(o({provider:"alpha"})),e.write(o({provider:"beta"}));const s=e.listProviders();r.ok(s.includes("alpha")),r.ok(s.includes("beta")),r.strictEqual(s.length,2)}),t("returns empty array when cache directory doesn't exist",()=>{r.deepStrictEqual(e.listProviders(),[])})})});

package/dist/core/model/discovery.d.ts

@@ -0,0 +1,79 @@
+/**
+ * [WHO]: discoverModels(), discoverOpenAIModels(), getDiscoveryProtocol(), DiscoveredModel, DiscoveryResult
+ * [FROM]: Depends on @catui/ai/types for Api type
+ * [TO]: Consumed by core/model-registry.ts, core/model/discovery-cache.ts
+ * [HERE]: core/model/discovery.ts - remote model discovery engine
+ *
+ * Fetches model lists from provider /models endpoints (OpenAI-compatible protocol).
+ * All failures are graceful — returns empty results instead of throwing.
+ */
+/**
+ * A model discovered from a remote /models endpoint.
+ */
+export interface DiscoveredModel {
+    /** Model identifier (same format as used in API requests). */
+    id: string;
+    /** Human-readable display name, if provided by the endpoint. */
+    name?: string;
+    /** Organization or entity that owns the model. */
+    ownedBy?: string;
+}
+/**
+ * Result of a discovery operation for a single provider.
+ */
+export interface DiscoveryResult {
+    /** Provider name this result belongs to. */
+    provider: string;
+    /** Discovered models (may be empty on failure or unsupported protocol). */
+    models: DiscoveredModel[];
+    /** Epoch milliseconds when this result was fetched. */
+    fetchedAt: number;
+    /** Cache time-to-live in seconds. */
+    ttl: number;
+    /** Non-fatal error message (e.g., "unsupported protocol" or network error details). */
+    error?: string;
+}
+/**
+ * Discovery protocol supported by a provider's API type.
+ * - "openai-models": GET {baseUrl}/models (OpenAI-compatible standard)
+ * - "unsupported": API type does not expose a model listing endpoint
+ */
+export type DiscoveryProtocol = "openai-models" | "unsupported";
+/** Default cache TTL: 24 hours. */
+export declare const DEFAULT_DISCOVERY_TTL_SECONDS = 86400;
+/** Default fetch timeout: 5 seconds. */
+export declare const DEFAULT_DISCOVERY_TIMEOUT_MS = 5000;
+/**
+ * Determine which discovery protocol a provider supports based on its API type.
+ *
+ * OpenAI-compatible APIs (completions, responses) implement the standard
+ * `GET /v1/models` endpoint. Anthropic Messages API does not expose one.
+ */
+export declare function getDiscoveryProtocol(api: string): DiscoveryProtocol;
+/**
+ * Fetch model list from an OpenAI-compatible /models endpoint.
+ *
+ * Expects response format: `{ data: [{ id: string, name?: string, owned_by?: string }, ...] }`
+ *
+ * Returns empty array on any failure:
+ * - Network errors / timeouts
+ * - Non-200 HTTP responses (401, 403, 500, etc.)
+ * - Malformed response bodies
+ *
+ * @param baseUrl  Provider base URL (trailing slashes are stripped)
+ * @param apiKey   Optional API key for Authorization header
+ * @param options  Optional timeout and abort signal
+ */
+export declare function discoverOpenAIModels(baseUrl: string, apiKey: string | undefined, options?: {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}): Promise<DiscoveredModel[]>;
+/**
+ * Top-level discover function: routes to the correct protocol handler.
+ *
+ * Returns a DiscoveryResult with metadata (timestamps, TTL, error info).
+ * Never throws — all errors are captured in the result.
+ */
+export declare function discoverModels(providerName: string, baseUrl: string, api: string, apiKey: string | undefined, options?: {
+    timeoutMs?: number;
+}): Promise<DiscoveryResult>;

package/dist/core/model/discovery.js

@@ -0,0 +1 @@
+var f=Object.defineProperty;var c=(e,o)=>f(e,"name",{value:o,configurable:!0});const D=86400,S=5e3;function E(e){switch(e){case"openai-completions":case"openai-responses":case"openai-codex-responses":case"azure-openai-responses":return"openai-models";default:return"unsupported"}}c(E,"getDiscoveryProtocol");async function A(e,o,t){const a=t?.timeoutMs??5e3,d=`${e.replace(/\/+$/,"")}/models`,i={};o&&(i.Authorization=`Bearer ${o}`);const n=new AbortController,s=setTimeout(()=>n.abort(),a),p=t?.signal?T(t.signal,n.signal):n.signal;try{const l=await fetch(d,{headers:i,signal:p});if(!l.ok)return[];const u=await l.json();return(Array.isArray(u?.data)?u.data:[]).filter(r=>r!=null&&typeof r=="object"&&typeof r.id=="string").map(r=>({id:r.id,name:typeof r.name=="string"?r.name:void 0,ownedBy:typeof r.owned_by=="string"?r.owned_by:void 0}))}catch{return[]}finally{clearTimeout(s)}}c(A,"discoverOpenAIModels");async function b(e,o,t,a,d){const i=E(t),n=Date.now();if(i==="unsupported")return{provider:e,models:[],fetchedAt:n,ttl:0,error:`Discovery not supported for API type "${t}"`};try{const s=await A(o,a,d);return{provider:e,models:s,fetchedAt:n,ttl:86400}}catch(s){return{provider:e,models:[],fetchedAt:n,ttl:86400,error:s instanceof Error?s.message:String(s)}}}c(b,"discoverModels");function T(e,o){const t=new AbortController,a=c(()=>t.abort(),"onAbort");return e.aborted||o.aborted?(t.abort(),t.signal):(e.addEventListener("abort",a,{once:!0}),o.addEventListener("abort",a,{once:!0}),t.signal)}c(T,"combineAbortSignals");export{S as DEFAULT_DISCOVERY_TIMEOUT_MS,D as DEFAULT_DISCOVERY_TTL_SECONDS,b as discoverModels,A as discoverOpenAIModels,E as getDiscoveryProtocol};

package/dist/core/model/discovery.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * [WHO]: Tests for discoverModels(), discoverOpenAIModels(), getDiscoveryProtocol()
+ * [FROM]: Depends on ./discovery.js
+ * [TO]: None (test file)
+ * [HERE]: core/model/discovery.test.ts — remote model discovery engine tests
+ */
+export {};

package/dist/core/model/discovery.test.js

@@ -0,0 +1 @@
+var h=Object.defineProperty;var i=(o,t)=>h(o,"name",{value:t,configurable:!0});import e from"node:assert";import{describe as p,it as s,mock as a}from"node:test";import{getDiscoveryProtocol as n,discoverOpenAIModels as l,discoverModels as d}from"./discovery.js";p("getDiscoveryProtocol",()=>{s("returns 'openai-models' for openai-completions",()=>{e.strictEqual(n("openai-completions"),"openai-models")}),s("returns 'openai-models' for openai-responses",()=>{e.strictEqual(n("openai-responses"),"openai-models")}),s("returns 'openai-models' for openai-codex-responses",()=>{e.strictEqual(n("openai-codex-responses"),"openai-models")}),s("returns 'openai-models' for azure-openai-responses",()=>{e.strictEqual(n("azure-openai-responses"),"openai-models")}),s("returns 'unsupported' for anthropic-messages",()=>{e.strictEqual(n("anthropic-messages"),"unsupported")}),s("returns 'unsupported' for google-generative-ai",()=>{e.strictEqual(n("google-generative-ai"),"unsupported")}),s("returns 'unsupported' for bedrock-converse-stream",()=>{e.strictEqual(n("bedrock-converse-stream"),"unsupported")}),s("returns 'unsupported' for unknown API types",()=>{e.strictEqual(n("custom-api"),"unsupported")})}),p("discoverOpenAIModels",()=>{s("parses standard OpenAI /models response",async()=>{const o={data:[{id:"gpt-4o",name:"GPT-4o",owned_by:"openai"},{id:"gpt-4o-mini",name:"GPT-4o Mini",owned_by:"openai"}]},t=globalThis.fetch;globalThis.fetch=a.fn(async()=>({ok:!0,json:i(async()=>o,"json")}));try{const r=await l("https://api.openai.com/v1","test-key");e.strictEqual(r.length,2),e.strictEqual(r[0].id,"gpt-4o"),e.strictEqual(r[0].name,"GPT-4o"),e.strictEqual(r[0].ownedBy,"openai"),e.strictEqual(r[1].id,"gpt-4o-mini")}finally{globalThis.fetch=t}}),s("includes Authorization header when apiKey is provided",async()=>{const o=globalThis.fetch;let t={};globalThis.fetch=a.fn(async(r,c)=>(t=c.headers,{ok:!0,json:i(async()=>({data:[]}),"json")}));try{await l("https://api.example.com/v1","sk-test-123"),e.strictEqual(t.Authorization,"Bearer sk-test-123")}finally{globalThis.fetch=o}}),s("omits Authorization header when apiKey is undefined",async()=>{const o=globalThis.fetch;let t={};globalThis.fetch=a.fn(async(r,c)=>(t=c.headers,{ok:!0,json:i(async()=>({data:[]}),"json")}));try{await l("http://localhost:11434/v1",void 0),e.strictEqual(t.Authorization,void 0)}finally{globalThis.fetch=o}}),s("strips trailing slashes from baseUrl",async()=>{const o=globalThis.fetch;let t="";globalThis.fetch=a.fn(async r=>(t=r,{ok:!0,json:i(async()=>({data:[]}),"json")}));try{await l("https://api.example.com/v1///",void 0),e.strictEqual(t,"https://api.example.com/v1/models")}finally{globalThis.fetch=o}}),s("returns empty array on non-200 response",async()=>{const o=globalThis.fetch;globalThis.fetch=a.fn(async()=>({ok:!1,status:401,json:i(async()=>({error:"Unauthorized"}),"json")}));try{const t=await l("https://api.example.com/v1","bad-key");e.deepStrictEqual(t,[])}finally{globalThis.fetch=o}}),s("returns empty array on malformed JSON",async()=>{const o=globalThis.fetch;globalThis.fetch=a.fn(async()=>({ok:!0,json:i(async()=>({unexpected:"format"}),"json")}));try{const t=await l("https://api.example.com/v1",void 0);e.deepStrictEqual(t,[])}finally{globalThis.fetch=o}}),s("filters out entries without string id",async()=>{const o=globalThis.fetch;globalThis.fetch=a.fn(async()=>({ok:!0,json:i(async()=>({data:[{id:"valid-model"},{id:123},{name:"no-id"},null,{id:"another-valid"}]}),"json")}));try{const t=await l("https://api.example.com/v1",void 0);e.strictEqual(t.length,2),e.strictEqual(t[0].id,"valid-model"),e.strictEqual(t[1].id,"another-valid")}finally{globalThis.fetch=o}}),s("returns empty array on network error",async()=>{const o=globalThis.fetch;globalThis.fetch=a.fn(async()=>{throw new Error("ECONNREFUSED")});try{const t=await l("http://localhost:11434/v1",void 0);e.deepStrictEqual(t,[])}finally{globalThis.fetch=o}})}),p("discoverModels",()=>{s("returns DiscoveryResult with models for openai-completions",async()=>{const o=globalThis.fetch;globalThis.fetch=a.fn(async()=>({ok:!0,json:i(async()=>({data:[{id:"model-a"},{id:"model-b"}]}),"json")}));try{const t=await d("test-provider","https://api.example.com/v1","openai-completions","key");e.strictEqual(t.provider,"test-provider"),e.strictEqual(t.models.length,2),e.strictEqual(t.ttl,86400),e.ok(t.fetchedAt>0),e.strictEqual(t.error,void 0)}finally{globalThis.fetch=o}}),s("returns error for unsupported protocol",async()=>{const o=await d("anthropic","https://api.anthropic.com/v1","anthropic-messages","key");e.strictEqual(o.provider,"anthropic"),e.deepStrictEqual(o.models,[]),e.ok(o.error?.includes("not supported")),e.strictEqual(o.ttl,0)}),s("returns empty models on fetch error (graceful degradation)",async()=>{const o=globalThis.fetch;globalThis.fetch=a.fn(async()=>{throw new Error("timeout")});try{const t=await d("test","https://api.example.com/v1","openai-completions","key");e.deepStrictEqual(t.models,[]),e.strictEqual(t.error,void 0),e.strictEqual(t.provider,"test")}finally{globalThis.fetch=o}})});