catui-agent 1.0.0-beta.0

package/dist/core/model-registry.d.ts

@@ -0,0 +1,186 @@
+/**
+ * [WHO]: ModelRegistry class, model definitions, API key resolution
+ * [FROM]: Depends on ai, typebox, config modules
+ * [TO]: Consumed by index.ts, main.ts, catui-defaults.ts, core/runtime/sdk.ts, core/runtime/agent-session.ts, core/extensions-host/runner.ts, core/extensions-host/types.ts, cli/list-models.ts, modes/interactive/components/model-selector.ts, and test files
+ * [HERE]: core/model-registry.ts - model catalog and credential management
+ */
+import type { Api, Context, Model, SimpleStreamOptions } from "@catui/ai/types";
+import type { AssistantMessageEventStream } from "@catui/ai/events";
+import { type OAuthProviderInterface } from "@catui/ai/oauth";
+import type { AuthStorage } from "./platform/config/auth-storage.js";
+import { clearConfigValueCache } from "./platform/config/resolve-config-value.js";
+import { type DiscoveryResult } from "./model/discovery.js";
+type AgentLoopFramework = "standard" | "weak-model-compatible";
+type AgentLoopFrameworkInput = AgentLoopFramework | "high-intelligence" | "low-intelligence" | "structured-adaptive";
+/** Clear the config value command cache. Exported for testing. */
+export declare const clearApiKeyCache: typeof clearConfigValueCache;
+/**
+ * Model registry - loads and manages models, resolves API keys via AuthStorage.
+ */
+export interface ModelRegistryOptions {
+    /**
+     * When true, only load models from models.json (no full built-in catalog). Used by Catui.
+     * Exception: a small OpenRouter built-in set (`openrouter/auto`, `openrouter/free`) so `/login` and
+     * `/model` work without pasting ids; add any other OpenRouter model id in models.json.
+     */
+    useOnlyCustomModels?: boolean;
+    /** Provider id(s) for which apiKey is optional in models.json (key stored in auth.json later). Used by Catui. */
+    allowOptionalApiKeyForProvider?: string | string[];
+}
+export declare class ModelRegistry {
+    readonly authStorage: AuthStorage;
+    private modelsJsonPath;
+    private models;
+    private customProviderApiKeys;
+    private registeredProviders;
+    private loadError;
+    private useOnlyCustomModels;
+    private allowOptionalApiKeyForProvider;
+    private discoveryCache;
+    private discoveryProviders;
+    private discoveryRefreshing;
+    constructor(authStorage: AuthStorage, modelsJsonPath?: string | undefined, options?: ModelRegistryOptions);
+    /**
+     * Reload models from disk (built-in + custom from models.json).
+     */
+    refresh(): void;
+    /**
+     * Get any error from loading models.json (undefined if no error).
+     */
+    getError(): string | undefined;
+    private loadModels;
+    /** Load built-in models and apply provider/model overrides */
+    private loadBuiltInModels;
+    /** Merge custom models into built-in list by provider+id (custom wins on conflicts). */
+    private mergeCustomModels;
+    /**
+     * Merge discovered models into the existing model list.
+     * Hand-configured models (by provider+id) are NOT overwritten — they take priority.
+     * Discovered models use known-metadata defaults for fields the /models endpoint doesn't provide.
+     */
+    private mergeDiscoveredModels;
+    private loadCustomModels;
+    private validateConfig;
+    private parseModels;
+    /**
+     * Get all models (built-in + custom).
+     * If models.json had errors, returns only built-in models.
+     */
+    getAll(): Model<Api>[];
+    /**
+     * Get only models that have auth configured.
+     * This is a fast check that doesn't refresh OAuth tokens.
+     */
+    getAvailable(): Model<Api>[];
+    /**
+     * Get models with valid API keys (async, validates OAuth tokens).
+     * This checks and refreshes OAuth tokens, filtering out expired ones.
+     */
+    getAvailableAsync(): Promise<Model<Api>[]>;
+    /**
+     * Fetch models from remote /models endpoints for all discovery-enabled providers.
+     *
+     * This is an async, non-blocking operation:
+     * - Fetches all providers in parallel (Promise.allSettled)
+     * - Updates the discovery cache with fresh results
+     * - Re-runs loadModels() to merge fresh data
+     *
+     * Use this for:
+     * - Fire-and-forget on startup
+     * - Manual refresh from /model selector (Ctrl+R)
+     * - CLI --list-models --refresh
+     */
+    refreshWithDiscovery(): Promise<{
+        discovered: number;
+        errors: string[];
+    }>;
+    /**
+     * Discover models for a single provider.
+     * Fetches from remote, updates cache, returns result.
+     */
+    discoverProvider(providerName: string): Promise<DiscoveryResult>;
+    /**
+     * Get discovery status for a provider.
+     * Useful for debugging and UI indicators.
+     */
+    getDiscoveryStatus(providerName: string): {
+        enabled: boolean;
+        cached: boolean;
+        lastFetched?: number;
+        modelCount: number;
+    };
+    /**
+     * Check if a provider has discovery enabled.
+     */
+    isDiscoveryEnabled(providerName: string): boolean;
+    /**
+     * Clear all discovery cache data.
+     */
+    clearDiscoveryCache(): void;
+    /**
+     * Find a model by provider and ID.
+     */
+    find(provider: string, modelId: string): Model<Api> | undefined;
+    /**
+     * Get API key for a model.
+     */
+    getApiKey(model: Model<Api>): Promise<string | undefined>;
+    /**
+     * Get API key for a provider.
+     */
+    getApiKeyForProvider(provider: string): Promise<string | undefined>;
+    /**
+     * Check if a model is using OAuth credentials (subscription).
+     */
+    isUsingOAuth(model: Model<Api>): boolean;
+    /**
+     * Register a provider dynamically (from extensions).
+     *
+     * If provider has models: replaces all existing models for this provider.
+     * If provider has only baseUrl/headers: overrides existing models' URLs.
+     * If provider has oauth: registers OAuth provider for /login support.
+     */
+    registerProvider(providerName: string, config: ProviderConfigInput): void;
+    private applyProviderConfig;
+    private static readonly OPENROUTER_JSON_BASE;
+    private static readonly OPENROUTER_JSON_API;
+    /**
+     * Append an OpenRouter model to models.json by id (same string as on openrouter.ai, e.g. x-ai/grok-4.20).
+     * API key is not written; use /login openrouter or OPENROUTER_API_KEY.
+     */
+    appendOpenRouterModel(modelId: string, options?: {
+        name?: string;
+    }): void;
+}
+/**
+ * Input type for registerProvider API.
+ */
+export interface ProviderConfigInput {
+    baseUrl?: string;
+    apiKey?: string;
+    api?: Api;
+    streamSimple?: (model: Model<Api>, context: Context, options?: SimpleStreamOptions) => AssistantMessageEventStream;
+    headers?: Record<string, string>;
+    authHeader?: boolean;
+    /** OAuth provider for /login support */
+    oauth?: Omit<OAuthProviderInterface, "id">;
+    models?: Array<{
+        id: string;
+        name: string;
+        api?: Api;
+        reasoning: boolean;
+        input: ("text" | "image")[];
+        cost: {
+            input: number;
+            output: number;
+            cacheRead: number;
+            cacheWrite: number;
+        };
+        contextWindow: number;
+        maxTokens: number;
+        headers?: Record<string, string>;
+        agentLoopFramework?: AgentLoopFrameworkInput;
+        compat?: Model<Api>["compat"];
+    }>;
+}
+export {};

package/dist/core/model-registry.js

@@ -0,0 +1,9 @@
+var k=Object.defineProperty;var h=(c,r)=>k(c,"name",{value:r,configurable:!0});import{getModels as E,getProviders as S}from"@catui/ai/models";import{registerOAuthProvider as L}from"@catui/ai/oauth";import{registerApiProvider as T}from"@catui/ai/registry";import{Type as e}from"@sinclair/typebox";import A from"ajv";import{existsSync as P,mkdirSync as F,readFileSync as R,writeFileSync as j}from"fs";import{dirname as M,join as U}from"path";import{getAgentDir as K}from"../config.js";import{clearConfigValueCache as $,resolveConfigValue as g,resolveHeaders as m}from"./platform/config/resolve-config-value.js";import{discoverModels as D,getDiscoveryProtocol as W}from"./model/discovery.js";import{DiscoveryCache as I}from"./model/discovery-cache.js";import{lookupKnownModel as B,UNKNOWN_MODEL_DEFAULTS as N}from"./model/known-models.js";const _=A.default||A,H=e.Object({only:e.Optional(e.Array(e.String())),order:e.Optional(e.Array(e.String()))}),q=e.Object({only:e.Optional(e.Array(e.String())),order:e.Optional(e.Array(e.String()))}),G=e.Object({supportsStore:e.Optional(e.Boolean()),supportsDeveloperRole:e.Optional(e.Boolean()),supportsReasoningEffort:e.Optional(e.Boolean()),supportsUsageInStreaming:e.Optional(e.Boolean()),maxTokensField:e.Optional(e.Union([e.Literal("max_completion_tokens"),e.Literal("max_tokens")])),requiresToolResultName:e.Optional(e.Boolean()),requiresAssistantAfterToolResult:e.Optional(e.Boolean()),requiresThinkingAsText:e.Optional(e.Boolean()),requiresMistralToolIds:e.Optional(e.Boolean()),thinkingFormat:e.Optional(e.Union([e.Literal("openai"),e.Literal("zai"),e.Literal("qwen")])),openRouterRouting:e.Optional(H),vercelGatewayRouting:e.Optional(q)}),J=e.Object({}),x=e.Union([G,J]),C=e.Union([e.Literal("standard"),e.Literal("weak-model-compatible"),e.Literal("high-intelligence"),e.Literal("low-intelligence"),e.Literal("structured-adaptive")]),z=e.Object({id:e.String({minLength:1}),name:e.Optional(e.String({minLength:1})),api:e.Optional(e.String({minLength:1})),reasoning:e.Optional(e.Boolean()),input:e.Optional(e.Array(e.Union([e.Literal("text"),e.Literal("image")]))),cost:e.Optional(e.Object({input:e.Number(),output:e.Number(),cacheRead:e.Number(),cacheWrite:e.Number()})),contextWindow:e.Optional(e.Number()),maxTokens:e.Optional(e.Number()),headers:e.Optional(e.Record(e.String(),e.String())),agentLoopFramework:e.Optional(C),compat:e.Optional(x)}),V=e.Object({name:e.Optional(e.String({minLength:1})),reasoning:e.Optional(e.Boolean()),input:e.Optional(e.Array(e.Union([e.Literal("text"),e.Literal("image")]))),cost:e.Optional(e.Object({input:e.Optional(e.Number()),output:e.Optional(e.Number()),cacheRead:e.Optional(e.Number()),cacheWrite:e.Optional(e.Number())})),contextWindow:e.Optional(e.Number()),maxTokens:e.Optional(e.Number()),headers:e.Optional(e.Record(e.String(),e.String())),agentLoopFramework:e.Optional(C),compat:e.Optional(x)});function y(c){return c==="high-intelligence"?"standard":c==="low-intelligence"||c==="structured-adaptive"?"weak-model-compatible":c}h(y,"normalizeAgentLoopFramework");const Q=e.Object({baseUrl:e.Optional(e.String({minLength:1})),apiKey:e.Optional(e.String({minLength:1})),api:e.Optional(e.String({minLength:1})),headers:e.Optional(e.Record(e.String(),e.String())),authHeader:e.Optional(e.Boolean()),models:e.Optional(e.Array(z)),modelOverrides:e.Optional(e.Record(e.String(),V)),discovery:e.Optional(e.Boolean()),discoveryCacheTtl:e.Optional(e.Number())}),X=e.Object({providers:e.Record(e.String(),Q)});function v(c){return{models:[],overrides:new Map,modelOverrides:new Map,error:c}}h(v,"emptyCustomModelsResult");function Y(c,r){if(!r)return c;const o=c,t=r,i={...o,...t},a=o,s=t,n=i;return(a?.openRouterRouting||s.openRouterRouting)&&(n.openRouterRouting={...a?.openRouterRouting,...s.openRouterRouting}),(a?.vercelGatewayRouting||s.vercelGatewayRouting)&&(n.vercelGatewayRouting={...a?.vercelGatewayRouting,...s.vercelGatewayRouting}),i}h(Y,"mergeCompat");function Z(c,r){const o={...c};if(r.name!==void 0&&(o.name=r.name),r.reasoning!==void 0&&(o.reasoning=r.reasoning),r.input!==void 0&&(o.input=r.input),r.contextWindow!==void 0&&(o.contextWindow=r.contextWindow),r.maxTokens!==void 0&&(o.maxTokens=r.maxTokens),r.agentLoopFramework!==void 0&&(o.agentLoopFramework=y(r.agentLoopFramework)),r.cost&&(o.cost={input:r.cost.input??c.cost.input,output:r.cost.output??c.cost.output,cacheRead:r.cost.cacheRead??c.cost.cacheRead,cacheWrite:r.cost.cacheWrite??c.cost.cacheWrite}),r.headers){const t=m(r.headers);o.headers=t?{...c.headers,...t}:c.headers}return o.compat=Y(c.compat,r.compat),o}h(Z,"applyModelOverride");const me=$,ee=["openrouter/auto","openrouter/free"];class O{static{h(this,"ModelRegistry")}authStorage;modelsJsonPath;models=[];customProviderApiKeys=new Map;registeredProviders=new Map;loadError=void 0;useOnlyCustomModels;allowOptionalApiKeyForProvider;discoveryCache;discoveryProviders=new Map;discoveryRefreshing=!1;constructor(r,o=U(K(),"models.json"),t={}){this.authStorage=r,this.modelsJsonPath=o,this.useOnlyCustomModels=t.useOnlyCustomModels??!1,this.allowOptionalApiKeyForProvider=t.allowOptionalApiKeyForProvider;const i=o?M(o):K();this.discoveryCache=new I(U(i,".cache","discovery")),this.authStorage.setFallbackResolver(a=>{const s=this.customProviderApiKeys.get(a);if(s)return g(s)}),this.loadModels()}refresh(){this.customProviderApiKeys.clear(),this.loadError=void 0,this.loadModels();for(const[r,o]of this.registeredProviders.entries())this.applyProviderConfig(r,o)}getError(){return this.loadError}loadModels(){const{models:r,overrides:o,modelOverrides:t,error:i}=this.modelsJsonPath?this.loadCustomModels(this.modelsJsonPath):v();i&&(this.loadError=i);const a=this.useOnlyCustomModels?this.loadBuiltInModels(o,t,new Set(["openrouter","zai"]),{openrouter:new Set(ee)}):this.loadBuiltInModels(o,t);let s=this.mergeCustomModels(a,r);for(const[n,l]of this.discoveryProviders){const d=this.discoveryCache.read(n,l.cacheTtl);d&&(s=this.mergeDiscoveredModels(s,d.models,n,l))}for(const n of this.authStorage.getOAuthProviders()){const l=this.authStorage.get(n.id);l?.type==="oauth"&&n.modifyModels&&(s=n.modifyModels(s,l))}this.models=s}loadBuiltInModels(r,o,t,i){return(t?S().filter(s=>t.has(s)):S()).flatMap(s=>{const n=i?.[s],l=E(s).filter(f=>!n||n.has(f.id)),d=r.get(s),p=o.get(s);return l.map(f=>{let u=f;if(d){const b=m(d.headers);u={...u,baseUrl:d.baseUrl??u.baseUrl,headers:b?{...u.headers,...b}:u.headers}}const w=p?.get(f.id);return w&&(u=Z(u,w)),u})})}mergeCustomModels(r,o){const t=[...r];for(const i of o){const a=t.findIndex(s=>s.provider===i.provider&&s.id===i.id);a>=0?t[a]=i:t.push(i)}return t}mergeDiscoveredModels(r,o,t,i){const a=[...r],s=new Set(r.filter(n=>n.provider===t).map(n=>n.id));for(const n of o){if(s.has(n.id))continue;const l=B(n.id),d=l??N;a.push({id:n.id,name:n.name??l?.name??n.id,api:i.api??l?.api??"openai-completions",provider:t,baseUrl:i.baseUrl,reasoning:d.reasoning,input:[...d.input],cost:{...d.cost},contextWindow:d.contextWindow,maxTokens:d.maxTokens,source:"discovery"})}return a}loadCustomModels(r){if(!P(r))return v();try{const o=R(r,"utf-8"),t=JSON.parse(o),a=new _().compile(X);if(!a(t)){const l=a.errors?.map(d=>`  - ${d.instancePath||"root"}: ${d.message}`).join(`
+`)||"Unknown schema error";return v(`Invalid models.json schema:
+${l}
+
+File: ${r}`)}this.validateConfig(t);const s=new Map,n=new Map;this.discoveryProviders.clear();for(const[l,d]of Object.entries(t.providers))(d.baseUrl||d.headers||d.apiKey)&&s.set(l,{baseUrl:d.baseUrl,headers:d.headers,apiKey:d.apiKey}),d.apiKey&&this.customProviderApiKeys.set(l,d.apiKey),d.modelOverrides&&n.set(l,new Map(Object.entries(d.modelOverrides))),d.discovery&&d.baseUrl&&d.api&&this.discoveryProviders.set(l,{provider:l,baseUrl:d.baseUrl,api:d.api,cacheTtl:d.discoveryCacheTtl??86400});return{models:this.parseModels(t),overrides:s,modelOverrides:n,error:void 0}}catch(o){return o instanceof SyntaxError?v(`Failed to parse models.json: ${o.message}
+
+File: ${r}`):v(`Failed to load models.json: ${o instanceof Error?o.message:o}
+
+File: ${r}`)}}validateConfig(r){for(const[o,t]of Object.entries(r.providers)){const i=!!t.api,a=t.models??[],s=t.modelOverrides&&Object.keys(t.modelOverrides).length>0;if(a.length===0){if(t.discovery&&t.baseUrl&&t.api)continue;if(!t.baseUrl&&!s)throw new Error(`Provider ${o}: must specify "baseUrl", "modelOverrides", or "models".`)}else{if(!t.baseUrl)throw new Error(`Provider ${o}: "baseUrl" is required when defining custom models.`);if(!!!(this.allowOptionalApiKeyForProvider!==void 0&&(Array.isArray(this.allowOptionalApiKeyForProvider)?this.allowOptionalApiKeyForProvider.includes(o):o===this.allowOptionalApiKeyForProvider))&&!t.apiKey)throw new Error(`Provider ${o}: "apiKey" is required when defining custom models.`)}for(const n of a){const l=!!n.api;if(!i&&!l)throw new Error(`Provider ${o}, model ${n.id}: no "api" specified. Set at provider or model level.`);if(!n.id)throw new Error(`Provider ${o}: model missing "id"`);if(n.contextWindow!==void 0&&n.contextWindow<=0)throw new Error(`Provider ${o}, model ${n.id}: invalid contextWindow`);if(n.maxTokens!==void 0&&n.maxTokens<=0)throw new Error(`Provider ${o}, model ${n.id}: invalid maxTokens`)}}}parseModels(r){const o=[];for(const[t,i]of Object.entries(r.providers)){const a=i.models??[];if(a.length!==0){i.apiKey&&this.customProviderApiKeys.set(t,i.apiKey);for(const s of a){const n=s.api||i.api;if(!n)continue;const l=m(i.headers),d=m(s.headers);let p=l||d?{...l,...d}:void 0;if(i.authHeader&&i.apiKey){const u=g(i.apiKey);u&&(p={...p,Authorization:`Bearer ${u}`})}const f={input:0,output:0,cacheRead:0,cacheWrite:0};o.push({id:s.id,name:s.name??s.id,api:n,provider:t,baseUrl:i.baseUrl,reasoning:s.reasoning??!1,input:s.input??["text"],cost:s.cost??f,contextWindow:s.contextWindow??128e3,maxTokens:s.maxTokens??16384,headers:p,agentLoopFramework:y(s.agentLoopFramework),compat:s.compat})}}}return o}getAll(){return this.models}getAvailable(){return this.models.filter(r=>this.authStorage.hasAuth(r.provider))}async getAvailableAsync(){const r=[];for(const o of this.models)await this.authStorage.getApiKey(o.provider)&&r.push(o);return r}async refreshWithDiscovery(){if(this.discoveryRefreshing)return{discovered:0,errors:[]};this.discoveryRefreshing=!0;try{const r=await Promise.allSettled(Array.from(this.discoveryProviders.keys()).map(i=>this.discoverProvider(i)));let o=0;const t=[];for(const i of r){if(i.status==="rejected"){t.push(i.reason?.message??"Unknown discovery error");continue}o+=i.value.models.length,i.value.error&&t.push(`${i.value.provider}: ${i.value.error}`)}this.loadModels();for(const[i,a]of this.registeredProviders.entries())this.applyProviderConfig(i,a);return{discovered:o,errors:t}}finally{this.discoveryRefreshing=!1}}async discoverProvider(r){const o=this.discoveryProviders.get(r);if(!o)return{provider:r,models:[],fetchedAt:Date.now(),ttl:0,error:`Provider "${r}" does not have discovery enabled`};if(W(o.api)==="unsupported")return{provider:r,models:[],fetchedAt:Date.now(),ttl:0,error:`Discovery not supported for API type "${o.api}"`};const i=await this.authStorage.getApiKey(r),a=await D(r,o.baseUrl,o.api,i);return(a.models.length>0||!a.error)&&this.discoveryCache.write(a),a}getDiscoveryStatus(r){const o=this.discoveryProviders.get(r);if(!o)return{enabled:!1,cached:!1,modelCount:0};const t=this.discoveryCache.read(r,o.cacheTtl);return{enabled:!0,cached:t!==void 0,lastFetched:t?.fetchedAt,modelCount:t?.models.length??0}}isDiscoveryEnabled(r){return this.discoveryProviders.has(r)}clearDiscoveryCache(){this.discoveryCache.clear()}find(r,o){return this.models.find(t=>t.provider===r&&t.id===o)}async getApiKey(r){return this.authStorage.getApiKey(r.provider)}async getApiKeyForProvider(r){return this.authStorage.getApiKey(r)}isUsingOAuth(r){return this.authStorage.get(r.provider)?.type==="oauth"}registerProvider(r,o){this.registeredProviders.set(r,o),this.applyProviderConfig(r,o)}applyProviderConfig(r,o){if(o.oauth){const t={...o.oauth,id:r};L(t)}if(o.streamSimple){if(!o.api)throw new Error(`Provider ${r}: "api" is required when registering streamSimple.`);const t=o.streamSimple;T({api:o.api,stream:h((i,a,s)=>t(i,a,s),"stream"),streamSimple:t})}if(o.apiKey&&this.customProviderApiKeys.set(r,o.apiKey),o.models&&o.models.length>0){if(this.models=this.models.filter(t=>t.provider!==r),!o.baseUrl)throw new Error(`Provider ${r}: "baseUrl" is required when defining models.`);if(!o.apiKey&&!o.oauth)throw new Error(`Provider ${r}: "apiKey" or "oauth" is required when defining models.`);for(const t of o.models){const i=t.api||o.api;if(!i)throw new Error(`Provider ${r}, model ${t.id}: no "api" specified.`);const a=m(o.headers),s=m(t.headers);let n=a||s?{...a,...s}:void 0;if(o.authHeader&&o.apiKey){const l=g(o.apiKey);l&&(n={...n,Authorization:`Bearer ${l}`})}this.models.push({id:t.id,name:t.name,api:i,provider:r,baseUrl:o.baseUrl,reasoning:t.reasoning,input:t.input,cost:t.cost,contextWindow:t.contextWindow,maxTokens:t.maxTokens,headers:n,agentLoopFramework:y(t.agentLoopFramework),compat:t.compat})}if(o.oauth?.modifyModels){const t=this.authStorage.get(r);t?.type==="oauth"&&(this.models=o.oauth.modifyModels(this.models,t))}}else if(o.baseUrl){const t=m(o.headers);this.models=this.models.map(i=>i.provider!==r?i:{...i,baseUrl:o.baseUrl??i.baseUrl,headers:t?{...i.headers,...t}:i.headers})}}static OPENROUTER_JSON_BASE="https://openrouter.ai/api/v1";static OPENROUTER_JSON_API="openai-completions";appendOpenRouterModel(r,o){const t="openrouter",i=r.trim();if(!i)throw new Error("OpenRouter model id cannot be empty");const a=this.modelsJsonPath;if(!a)throw new Error("models.json path is not configured");let s;if(P(a)){const p=R(a,"utf-8");s=JSON.parse(p)}else s={providers:{}};(!s.providers||typeof s.providers!="object")&&(s.providers={});const n=s.providers[t]??{},l=Array.isArray(n.models)?[...n.models]:[];if(l.some(p=>p&&typeof p=="object"&&p.id===i))throw new Error(`OpenRouter model "${i}" already exists in models.json`);const d=o?.name?.trim()||i;l.push({id:i,name:d,input:["text"],contextWindow:256e3,maxTokens:8192}),s.providers[t]={...n,baseUrl:n.baseUrl??O.OPENROUTER_JSON_BASE,api:n.api??O.OPENROUTER_JSON_API,models:l},F(M(a),{recursive:!0}),j(a,JSON.stringify(s,null,2),"utf-8"),this.refresh()}}export{O as ModelRegistry,me as clearApiKeyCache};

package/dist/core/model-resolver.d.ts

@@ -0,0 +1,106 @@
+/**
+ * [WHO]: resolveCliModel(), resolveModelScope(), ScopedModel, defaultModelPerProvider
+ * [FROM]: Depends on agent-core, ai, chalk, minimatch, cli/args, defaults, model-registry
+ * [TO]: Consumed by main.ts, modes/interactive/interactive-mode.ts, core/runtime/sdk.ts
+ * [HERE]: core/model-resolver.ts - model resolution, scoping, and initial selection
+ */
+import type { ThinkingLevel } from "@catui/agent-core";
+import type { Api, KnownProvider, Model } from "@catui/ai/types";
+import type { ModelRegistry } from "./model-registry.js";
+/** Default model IDs for each known provider */
+export declare const defaultModelPerProvider: Record<KnownProvider, string>;
+export interface ScopedModel {
+    model: Model<Api>;
+    /** Thinking level if explicitly specified in pattern (e.g., "model:high"), undefined otherwise */
+    thinkingLevel?: ThinkingLevel;
+}
+export interface ParsedModelResult {
+    model: Model<Api> | undefined;
+    /** Thinking level if explicitly specified in pattern, undefined otherwise */
+    thinkingLevel?: ThinkingLevel;
+    warning: string | undefined;
+}
+/**
+ * Parse a pattern to extract model and thinking level.
+ * Handles models with colons in their IDs (e.g., OpenRouter's :exacto suffix).
+ *
+ * Algorithm:
+ * 1. Try to match full pattern as a model
+ * 2. If found, return it with "off" thinking level
+ * 3. If not found and has colons, split on last colon:
+ *    - If suffix is valid thinking level, use it and recurse on prefix
+ *    - If suffix is invalid, warn and recurse on prefix with "off"
+ *
+ * @internal Exported for testing
+ */
+export declare function parseModelPattern(pattern: string, availableModels: Model<Api>[], options?: {
+    allowInvalidThinkingLevelFallback?: boolean;
+}): ParsedModelResult;
+/**
+ * Resolve model patterns to actual Model objects with optional thinking levels
+ * Format: "pattern:level" where :level is optional
+ * For each pattern, finds all matching models and picks the best version:
+ * 1. Prefer alias (e.g., claude-sonnet-4-5) over dated versions (claude-sonnet-4-5-20250929)
+ * 2. If no alias, pick the latest dated version
+ *
+ * Supports models with colons in their IDs (e.g., OpenRouter's model:exacto).
+ * The algorithm tries to match the full pattern first, then progressively
+ * strips colon-suffixes to find a match.
+ */
+export declare function resolveModelScope(patterns: string[], modelRegistry: ModelRegistry): Promise<ScopedModel[]>;
+export interface ResolveCliModelResult {
+    model: Model<Api> | undefined;
+    thinkingLevel?: ThinkingLevel;
+    warning: string | undefined;
+    /**
+     * Error message suitable for CLI display.
+     * When set, model will be undefined.
+     */
+    error: string | undefined;
+}
+/**
+ * Resolve a single model from CLI flags.
+ *
+ * Supports:
+ * - --provider <provider> --model <pattern>
+ * - --model <provider>/<pattern>
+ * - Fuzzy matching (same rules as model scoping: exact id, then partial id/name)
+ *
+ * Note: This does not apply the thinking level by itself, but it may *parse* and
+ * return a thinking level from "<pattern>:<thinking>" so the caller can apply it.
+ */
+export declare function resolveCliModel(options: {
+    cliProvider?: string;
+    cliModel?: string;
+    modelRegistry: ModelRegistry;
+}): ResolveCliModelResult;
+export interface InitialModelResult {
+    model: Model<Api> | undefined;
+    thinkingLevel: ThinkingLevel;
+    fallbackMessage: string | undefined;
+}
+/**
+ * Find the initial model to use based on priority:
+ * 1. CLI args (provider + model)
+ * 2. First model from scoped models (if not continuing/resuming)
+ * 3. Restored from session (if continuing/resuming)
+ * 4. Saved default from settings
+ * 5. First available model with valid API key
+ */
+export declare function findInitialModel(options: {
+    cliProvider?: string;
+    cliModel?: string;
+    scopedModels: ScopedModel[];
+    isContinuing: boolean;
+    defaultProvider?: string;
+    defaultModelId?: string;
+    defaultThinkingLevel?: ThinkingLevel;
+    modelRegistry: ModelRegistry;
+}): Promise<InitialModelResult>;
+/**
+ * Restore model from session, with fallback to available models
+ */
+export declare function restoreModelFromSession(savedProvider: string, savedModelId: string, currentModel: Model<Api> | undefined, shouldPrintMessages: boolean, modelRegistry: ModelRegistry): Promise<{
+    model: Model<Api> | undefined;
+    fallbackMessage: string | undefined;
+}>;

package/dist/core/model-resolver.js

@@ -0,0 +1 @@
+var I=Object.defineProperty;var w=(o,t)=>I(o,"name",{value:t,configurable:!0});import{modelsAreEqual as x}from"@catui/ai/models";import k from"chalk";import{minimatch as C}from"minimatch";import{isValidThinkingLevel as M}from"../cli/args.js";import{DEFAULT_THINKING_LEVEL as v}from"./platform/config/defaults.js";const b={"amazon-bedrock":"us.anthropic.claude-opus-4-6-v1",anthropic:"claude-opus-4-6",openai:"gpt-5.1-codex","azure-openai-responses":"gpt-5.2","openai-codex":"gpt-5.3-codex",google:"gemini-2.5-pro","google-gemini-cli":"gemini-2.5-pro","google-antigravity":"gemini-3-pro-high","google-vertex":"gemini-3-pro-preview","github-copilot":"gpt-4o",openrouter:"openai/gpt-5.1-codex","vercel-ai-gateway":"anthropic/claude-opus-4-6",xai:"grok-4-fast-non-reasoning",groq:"openai/gpt-oss-120b",cerebras:"zai-glm-4.6",zai:"glm-4.6",mistral:"devstral-medium-latest",minimax:"MiniMax-M2.1","minimax-cn":"MiniMax-M2.1",huggingface:"moonshotai/Kimi-K2.5",opencode:"claude-opus-4-6","opencode-go":"claude-opus-4-6","kimi-coding":"kimi-k2-thinking","ali-token-plan-openai":"qwen3.6-plus","ali-token-plan-anthropic":"qwen3.6-plus"};function y(o){return o.endsWith("-latest")?!0:!/-\d{8}$/.test(o)}w(y,"isAlias");function A(o,t){const n=o.indexOf("/");if(n!==-1){const e=o.substring(0,n),r=o.substring(n+1),f=t.find(u=>u.provider.toLowerCase()===e.toLowerCase()&&u.id.toLowerCase()===r.toLowerCase());if(f)return f}const s=t.find(e=>e.id.toLowerCase()===o.toLowerCase());if(s)return s;const i=t.filter(e=>e.id.toLowerCase().includes(o.toLowerCase())||e.name?.toLowerCase().includes(o.toLowerCase()));if(i.length===0)return;const a=i.filter(e=>y(e.id)),l=i.filter(e=>!y(e.id));return a.length>0?(a.sort((e,r)=>r.id.localeCompare(e.id)),a[0]):(l.sort((e,r)=>r.id.localeCompare(e.id)),l[0])}w(A,"tryMatchModel");function L(o,t,n){const s=A(o,t);if(s)return{model:s,thinkingLevel:void 0,warning:void 0};const i=o.lastIndexOf(":");if(i===-1)return{model:void 0,thinkingLevel:void 0,warning:void 0};const a=o.substring(0,i),l=o.substring(i+1);if(M(l)){const e=L(a,t,n);return e.model?{model:e.model,thinkingLevel:e.warning?void 0:l,warning:e.warning}:e}else{if(!(n?.allowInvalidThinkingLevelFallback??!0))return{model:void 0,thinkingLevel:void 0,warning:void 0};const r=L(a,t,n);return r.model?{model:r.model,thinkingLevel:void 0,warning:`Invalid thinking level "${l}" in pattern "${o}". Using default instead.`}:r}}w(L,"parseModelPattern");async function N(o,t){const n=await t.getAvailable(),s=[];for(const i of o){if(i.includes("*")||i.includes("?")||i.includes("[")){const r=i.lastIndexOf(":");let f=i,u;if(r!==-1){const d=i.substring(r+1);M(d)&&(u=d,f=i.substring(0,r))}const p=n.filter(d=>{const m=`${d.provider}/${d.id}`;return C(m,f,{nocase:!0})||C(d.id,f,{nocase:!0})});if(p.length===0){console.warn(k.yellow(`Warning: No models match pattern "${i}"`));continue}for(const d of p)s.find(m=>x(m.model,d))||s.push({model:d,thinkingLevel:u});continue}const{model:a,thinkingLevel:l,warning:e}=L(i,n);if(e&&console.warn(k.yellow(`Warning: ${e}`)),!a){console.warn(k.yellow(`Warning: No models match pattern "${i}"`));continue}s.find(r=>x(r.model,a))||s.push({model:a,thinkingLevel:l})}return s}w(N,"resolveModelScope");function q(o){const{cliProvider:t,cliModel:n,modelRegistry:s}=o;if(!n)return{model:void 0,warning:void 0,error:void 0};const i=s.getAll();if(i.length===0)return{model:void 0,warning:void 0,error:"No models available. Check your installation or add models to models.json."};const a=new Map;for(const c of i)a.set(c.provider.toLowerCase(),c.provider);let l=t?a.get(t.toLowerCase()):void 0;if(t&&!l)return{model:void 0,warning:void 0,error:`Unknown provider "${t}". Use --list-models to see available providers/models.`};let e=n,r=!1;if(!l){const c=n.indexOf("/");if(c!==-1){const h=n.substring(0,c),g=a.get(h.toLowerCase());g&&(l=g,e=n.substring(c+1),r=!0)}}if(!l){const c=n.toLowerCase(),h=i.find(g=>g.id.toLowerCase()===c||`${g.provider}/${g.id}`.toLowerCase()===c);if(h)return{model:h,warning:void 0,thinkingLevel:void 0,error:void 0}}if(t&&l){const c=`${l}/`;n.toLowerCase().startsWith(c.toLowerCase())&&(e=n.substring(c.length))}const f=l?i.filter(c=>c.provider===l):i,{model:u,thinkingLevel:p,warning:d}=L(e,f,{allowInvalidThinkingLevelFallback:!1});if(u)return{model:u,thinkingLevel:p,warning:d,error:void 0};if(r){const c=n.toLowerCase(),h=i.find($=>$.id.toLowerCase()===c||`${$.provider}/${$.id}`.toLowerCase()===c);if(h)return{model:h,warning:void 0,thinkingLevel:void 0,error:void 0};const g=L(n,i,{allowInvalidThinkingLevelFallback:!1});if(g.model)return{model:g.model,thinkingLevel:g.thinkingLevel,warning:g.warning,error:void 0}}const m=l?`${l}/${e}`:n;return{model:void 0,thinkingLevel:void 0,warning:d,error:`Model "${m}" not found. Use --list-models to see available models.`}}w(q,"resolveCliModel");async function z(o){const{cliProvider:t,cliModel:n,scopedModels:s,isContinuing:i,defaultProvider:a,defaultModelId:l,defaultThinkingLevel:e,modelRegistry:r}=o;let f,u=v;if(t&&n){const d=r.find(t,n);return d||(console.error(k.red(`Model ${t}/${n} not found`)),process.exit(1)),{model:d,thinkingLevel:v,fallbackMessage:void 0}}if(s.length>0&&!i)return{model:s[0].model,thinkingLevel:s[0].thinkingLevel??e??v,fallbackMessage:void 0};if(a&&l){const d=r.find(a,l);if(d)return f=d,e&&(u=e),{model:f,thinkingLevel:u,fallbackMessage:void 0}}const p=await r.getAvailable();if(p.length>0){for(const d of Object.keys(b)){const m=b[d],c=p.find(h=>h.provider===d&&h.id===m);if(c)return{model:c,thinkingLevel:v,fallbackMessage:void 0}}return{model:p[0],thinkingLevel:v,fallbackMessage:void 0}}return{model:void 0,thinkingLevel:v,fallbackMessage:void 0}}w(z,"findInitialModel");async function E(o,t,n,s,i){const a=i.find(o,t),l=a?!!await i.getApiKey(a):!1;if(a&&l)return s&&console.log(k.dim(`Restored model: ${o}/${t}`)),{model:a,fallbackMessage:void 0};const e=a?"no API key available":"model no longer exists";if(s&&console.error(k.yellow(`Warning: Could not restore model ${o}/${t} (${e}).`)),n)return s&&console.log(k.dim(`Falling back to: ${n.provider}/${n.id}`)),{model:n,fallbackMessage:`Could not restore model ${o}/${t} (${e}). Using ${n.provider}/${n.id}.`};const r=await i.getAvailable();if(r.length>0){let f;for(const u of Object.keys(b)){const p=b[u],d=r.find(m=>m.provider===u&&m.id===p);if(d){f=d;break}}return f||(f=r[0]),s&&console.log(k.dim(`Falling back to: ${f.provider}/${f.id}`)),{model:f,fallbackMessage:`Could not restore model ${o}/${t} (${e}). Using ${f.provider}/${f.id}.`}}return{model:void 0,fallbackMessage:void 0}}w(E,"restoreModelFromSession");export{b as defaultModelPerProvider,z as findInitialModel,L as parseModelPattern,q as resolveCliModel,N as resolveModelScope,E as restoreModelFromSession};

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

@@ -0,0 +1,156 @@
+import type { SettingsManager } from "./platform/config/settings-manager.js";
+export interface PathMetadata {
+    source: string;
+    scope: SourceScope;
+    origin: "package" | "top-level";
+    baseDir?: string;
+}
+export interface ResolvedResource {
+    path: string;
+    enabled: boolean;
+    metadata: PathMetadata;
+}
+export interface ResolvedPaths {
+    extensions: ResolvedResource[];
+    skills: ResolvedResource[];
+    prompts: ResolvedResource[];
+    themes: ResolvedResource[];
+}
+export type MissingSourceAction = "install" | "skip" | "error";
+export interface ProgressEvent {
+    type: "start" | "progress" | "complete" | "error";
+    action: "install" | "remove" | "update" | "clone" | "pull";
+    source: string;
+    message?: string;
+}
+export type ProgressCallback = (event: ProgressEvent) => void;
+export interface PackageManager {
+    resolve(onMissing?: (source: string) => Promise<MissingSourceAction>): Promise<ResolvedPaths>;
+    install(source: string, options?: {
+        local?: boolean;
+    }): Promise<void>;
+    remove(source: string, options?: {
+        local?: boolean;
+    }): Promise<void>;
+    update(source?: string): Promise<void>;
+    resolveExtensionSources(sources: string[], options?: {
+        local?: boolean;
+        temporary?: boolean;
+    }): Promise<ResolvedPaths>;
+    addSourceToSettings(source: string, options?: {
+        local?: boolean;
+    }): boolean;
+    removeSourceFromSettings(source: string, options?: {
+        local?: boolean;
+    }): boolean;
+    setProgressCallback(callback: ProgressCallback | undefined): void;
+    getInstalledPath(source: string, scope: "user" | "project"): string | undefined;
+}
+interface PackageManagerOptions {
+    cwd: string;
+    agentDir: string;
+    settingsManager: SettingsManager;
+}
+type SourceScope = "user" | "project" | "temporary";
+export declare class DefaultPackageManager implements PackageManager {
+    private cwd;
+    private agentDir;
+    private settingsManager;
+    private globalNpmRoot;
+    private progressCallback;
+    constructor(options: PackageManagerOptions);
+    setProgressCallback(callback: ProgressCallback | undefined): void;
+    addSourceToSettings(source: string, options?: {
+        local?: boolean;
+    }): boolean;
+    removeSourceFromSettings(source: string, options?: {
+        local?: boolean;
+    }): boolean;
+    getInstalledPath(source: string, scope: "user" | "project"): string | undefined;
+    private emitProgress;
+    private withProgress;
+    resolve(onMissing?: (source: string) => Promise<MissingSourceAction>): Promise<ResolvedPaths>;
+    resolveExtensionSources(sources: string[], options?: {
+        local?: boolean;
+        temporary?: boolean;
+    }): Promise<ResolvedPaths>;
+    install(source: string, options?: {
+        local?: boolean;
+    }): Promise<void>;
+    remove(source: string, options?: {
+        local?: boolean;
+    }): Promise<void>;
+    update(source?: string): Promise<void>;
+    private updateSourceForScope;
+    private resolvePackageSources;
+    private resolveLocalExtensionSource;
+    private installParsedSource;
+    private getPackageSourceString;
+    private getSourceMatchKeyForInput;
+    private getSourceMatchKeyForSettings;
+    private packageSourcesMatch;
+    private normalizePackageSourceForSettings;
+    private parseSource;
+    /**
+     * Check if an npm package needs to be updated.
+     * - For pinned packages: check if installed version matches the pinned version
+     * - For unpinned packages: skip registry check at startup (returns false); registry
+     *   check is deferred to explicit /update or auto-update runs to avoid startup latency
+     */
+    private npmNeedsUpdate;
+    private getInstalledNpmVersion;
+    private getLatestNpmVersion;
+    /**
+     * Get a unique identity for a package, ignoring version/ref.
+     * Used to detect when the same package is in both global and project settings.
+     * For git packages, uses normalized host/path to ensure SSH and HTTPS URLs
+     * for the same repository are treated as identical.
+     */
+    private getPackageIdentity;
+    /**
+     * Dedupe packages: if same package identity appears in both global and project,
+     * keep only the project one (project wins).
+     */
+    private dedupePackages;
+    private parseNpmSpec;
+    private installNpm;
+    private uninstallNpm;
+    private installGit;
+    private updateGit;
+    private refreshTemporaryGitSource;
+    private removeGit;
+    private pruneEmptyGitParents;
+    private ensureNpmProject;
+    private ensureGitIgnore;
+    private getNpmInstallRoot;
+    private getGlobalNpmRoot;
+    private getNpmInstallPath;
+    private getGitInstallPath;
+    private getGitInstallRoot;
+    private getTemporaryDir;
+    private getBaseDirForScope;
+    private resolvePath;
+    private resolvePathFromBase;
+    private collectPackageResources;
+    private collectDefaultResources;
+    private applyPackageFilter;
+    /**
+     * Collect all files from a package for a resource type, applying manifest patterns.
+     * Returns { allFiles, enabledByManifest } where enabledByManifest is the set of files
+     * that pass the manifest's own patterns.
+     */
+    private collectManifestFiles;
+    private readPiManifest;
+    private addManifestEntries;
+    private collectFilesFromManifestEntries;
+    private resolveLocalEntries;
+    private addAutoDiscoveredResources;
+    private collectFilesFromPaths;
+    private getTargetMap;
+    private addResource;
+    private createAccumulator;
+    private toResolvedPaths;
+    private runCommand;
+    private runCommandSync;
+}
+export {};

package/dist/core/package-manager.js

@@ -0,0 +1,3 @@
+var st=Object.defineProperty;var p=(a,t)=>st(a,"name",{value:t,configurable:!0});import{spawn as nt,spawnSync as rt}from"node:child_process";import{createHash as it}from"node:crypto";import{existsSync as f,mkdirSync as C,readdirSync as E,readFileSync as j,rmSync as K,statSync as S,writeFileSync as z}from"node:fs";import{homedir as F,tmpdir as ot}from"node:os";import{basename as T,dirname as P,join as u,relative as y,resolve as v,sep as at}from"node:path";import $ from"ignore";import{minimatch as M}from"minimatch";import{CONFIG_DIR_NAME as x}from"../config.js";import{parseGitUrl as ct}from"../utils/git.js";const lt=1e4;function N(){const a=process.env.CATUI_OFFLINE??process.env.NANOPENCIL_OFFLINE;return a?a==="1"||a.toLowerCase()==="true"||a.toLowerCase()==="yes":!1}p(N,"isOfflineModeEnabled");const W=["extensions","skills","prompts","themes"],ut={extensions:/\.(ts|js)$/,skills:/\.md$/,prompts:/\.md$/,themes:/\.json$/},ht=[".gitignore",".ignore",".fdignore"];function I(a){return a.split(at).join("/")}p(I,"toPosixPath");function ft(a,t){const e=a.trim();if(!e||e.startsWith("#")&&!e.startsWith("\\#"))return null;let s=a,n=!1;s.startsWith("!")?(n=!0,s=s.slice(1)):s.startsWith("\\!")&&(s=s.slice(1)),s.startsWith("/")&&(s=s.slice(1));const r=t?`${t}${s}`:s;return n?`!${r}`:r}p(ft,"prefixIgnorePattern");function R(a,t,e){const s=y(e,t),n=s?`${I(s)}/`:"";for(const r of ht){const i=u(t,r);if(f(i))try{const o=j(i,"utf-8").split(/\r?\n/).map(l=>ft(l,n)).filter(l=>!!l);o.length>0&&a.add(o)}catch(c){console.warn("Warning: Failed to read ignore file:",c instanceof Error?c.message:c)}}}p(R,"addIgnoreRules");function D(a){return a.startsWith("!")||a.startsWith("+")||a.startsWith("-")||a.includes("*")||a.includes("?")}p(D,"isPattern");function pt(a){const t=[],e=[];for(const s of a)D(s)?e.push(s):t.push(s);return{plain:t,patterns:e}}p(pt,"splitPatterns");function B(a,t,e=!0,s,n){const r=[];if(!f(a))return r;const i=n??a,c=s??$();R(c,a,i);try{const o=E(a,{withFileTypes:!0});for(const l of o){if(l.name.startsWith(".")||e&&l.name==="node_modules")continue;const g=u(a,l.name);let h=l.isDirectory(),d=l.isFile();if(l.isSymbolicLink())try{const k=S(g);h=k.isDirectory(),d=k.isFile()}catch{continue}const w=I(y(i,g)),m=h?`${w}/`:w;c.ignores(m)||(h?r.push(...B(g,t,e,c,i)):d&&t.test(l.name)&&r.push(g))}}catch(o){console.error("[package-manager] collectFiles failed:",o)}return r}p(B,"collectFiles");function O(a,t=!0,e,s){const n=[];if(!f(a))return n;const r=s??a,i=e??$();R(i,a,r);try{const c=E(a,{withFileTypes:!0});for(const o of c){if(o.name.startsWith(".")||o.name==="node_modules")continue;const l=u(a,o.name);let g=o.isDirectory(),h=o.isFile();if(o.isSymbolicLink())try{const m=S(l);g=m.isDirectory(),h=m.isFile()}catch{continue}const d=I(y(r,l)),w=g?`${d}/`:d;if(!i.ignores(w)){if(g)n.push(...O(l,!1,i,r));else if(h){const m=t&&o.name.endsWith(".md"),k=!t&&o.name==="SKILL.md";(m||k)&&n.push(l)}}}}catch(c){console.error("[package-manager] collectSkillEntries failed:",c)}return n}p(O,"collectSkillEntries");function b(a,t=!0){return O(a,t)}p(b,"collectAutoSkillEntries");function gt(a){let t=v(a);for(;;){if(f(u(t,".git")))return t;const e=P(t);if(e===t)return null;t=e}}p(gt,"findGitRepoRoot");function mt(a){const t=[],e=v(a),s=gt(e);let n=e;for(;t.push(u(n,".agents","skills")),!(s&&n===s);){const r=P(n);if(r===n)break;n=r}return t}p(mt,"collectAncestorAgentsSkillDirs");function V(a){const t=[];if(!f(a))return t;const e=$();R(e,a,a);try{const s=E(a,{withFileTypes:!0});for(const n of s){if(n.name.startsWith(".")||n.name==="node_modules")continue;const r=u(a,n.name);let i=n.isFile();if(n.isSymbolicLink())try{i=S(r).isFile()}catch{continue}const c=I(y(a,r));e.ignores(c)||i&&n.name.endsWith(".md")&&t.push(r)}}catch(s){console.error("[package-manager] collectAutoPromptEntries failed:",s)}return t}p(V,"collectAutoPromptEntries");function H(a){const t=[];if(!f(a))return t;const e=$();R(e,a,a);try{const s=E(a,{withFileTypes:!0});for(const n of s){if(n.name.startsWith(".")||n.name==="node_modules")continue;const r=u(a,n.name);let i=n.isFile();if(n.isSymbolicLink())try{i=S(r).isFile()}catch{continue}const c=I(y(a,r));e.ignores(c)||i&&n.name.endsWith(".json")&&t.push(r)}}catch(s){console.error("[package-manager] collectAutoThemeEntries failed:",s)}return t}p(H,"collectAutoThemeEntries");function dt(a){try{const t=j(a,"utf-8");return JSON.parse(t).catui??null}catch{return null}}p(dt,"readPiManifestFile");function Y(a){const t=u(a,"package.json");if(f(t)){const n=dt(t);if(n?.extensions?.length){const r=[];for(const i of n.extensions){const c=v(a,i);f(c)&&r.push(c)}if(r.length>0)return r}}const e=u(a,"index.ts"),s=u(a,"index.js");return f(e)?[e]:f(s)?[s]:null}p(Y,"resolveExtensionEntries");function _(a){const t=[];if(!f(a))return t;const e=Y(a);if(e)return e;const s=$();R(s,a,a);try{const n=E(a,{withFileTypes:!0});for(const r of n){if(r.name.startsWith(".")||r.name==="node_modules")continue;const i=u(a,r.name);let c=r.isDirectory(),o=r.isFile();if(r.isSymbolicLink())try{const h=S(i);c=h.isDirectory(),o=h.isFile()}catch{continue}const l=I(y(a,i)),g=c?`${l}/`:l;if(!s.ignores(g)){if(o&&(r.name.endsWith(".ts")||r.name.endsWith(".js")))t.push(i);else if(c){const h=Y(i);h&&t.push(...h)}}}}catch(n){console.error("[package-manager] collectAutoExtensionEntries failed:",n)}return t}p(_,"collectAutoExtensionEntries");function G(a,t){return t==="skills"?O(a):t==="extensions"?_(a):B(a,ut[t])}p(G,"collectResourceFiles");function J(a,t,e){const s=y(e,a),n=T(a),r=n==="SKILL.md",i=r?P(a):void 0,c=r?y(e,i):void 0,o=r?T(i):void 0;return t.some(l=>M(s,l)||M(n,l)||M(a,l)?!0:r?M(c,l)||M(o,l)||M(i,l):!1)}p(J,"matchesAnyPattern");function yt(a){return a.startsWith("./")||a.startsWith(".\\")?a.slice(2):a}p(yt,"normalizeExactPattern");function A(a,t,e){if(t.length===0)return!1;const s=y(e,a),r=T(a)==="SKILL.md",i=r?P(a):void 0,c=r?y(e,i):void 0;return t.some(o=>{const l=yt(o);return l===s||l===a?!0:r?l===c||l===i:!1})}p(A,"matchesAnyExactPattern");function Pt(a){return a.filter(t=>t.startsWith("!")||t.startsWith("+")||t.startsWith("-"))}p(Pt,"getOverridePatterns");function kt(a,t,e){const s=Pt(t),n=s.filter(o=>o.startsWith("!")).map(o=>o.slice(1)),r=s.filter(o=>o.startsWith("+")).map(o=>o.slice(1)),i=s.filter(o=>o.startsWith("-")).map(o=>o.slice(1));let c=!0;return n.length>0&&J(a,n,e)&&(c=!1),r.length>0&&A(a,r,e)&&(c=!0),i.length>0&&A(a,i,e)&&(c=!1),c}p(kt,"isEnabledByOverrides");function L(a,t,e){const s=[],n=[],r=[],i=[];for(const o of t)o.startsWith("+")?r.push(o.slice(1)):o.startsWith("-")?i.push(o.slice(1)):o.startsWith("!")?n.push(o.slice(1)):s.push(o);let c;if(s.length===0?c=[...a]:c=a.filter(o=>J(o,s,e)),n.length>0&&(c=c.filter(o=>!J(o,n,e))),r.length>0)for(const o of a)!c.includes(o)&&A(o,r,e)&&c.push(o);return i.length>0&&(c=c.filter(o=>!A(o,i,e))),new Set(c)}p(L,"applyPatterns");class Rt{static{p(this,"DefaultPackageManager")}cwd;agentDir;settingsManager;globalNpmRoot;progressCallback;constructor(t){this.cwd=t.cwd,this.agentDir=t.agentDir,this.settingsManager=t.settingsManager}setProgressCallback(t){this.progressCallback=t}addSourceToSettings(t,e){const s=e?.local?"project":"user",r=(s==="project"?this.settingsManager.getProjectSettings():this.settingsManager.getGlobalSettings()).packages??[],i=this.normalizePackageSourceForSettings(t,s);if(r.some(l=>this.packageSourcesMatch(l,t,s)))return!1;const o=[...r,i];return s==="project"?this.settingsManager.setProjectPackages(o):this.settingsManager.setPackages(o),!0}removeSourceFromSettings(t,e){const s=e?.local?"project":"user",r=(s==="project"?this.settingsManager.getProjectSettings():this.settingsManager.getGlobalSettings()).packages??[],i=r.filter(o=>!this.packageSourcesMatch(o,t,s));return i.length!==r.length?(s==="project"?this.settingsManager.setProjectPackages(i):this.settingsManager.setPackages(i),!0):!1}getInstalledPath(t,e){const s=this.parseSource(t);if(s.type==="npm"){const n=this.getNpmInstallPath(s,e);return f(n)?n:void 0}if(s.type==="git"){const n=this.getGitInstallPath(s,e);return f(n)?n:void 0}if(s.type==="local"){const n=this.getBaseDirForScope(e),r=this.resolvePathFromBase(s.path,n);return f(r)?r:void 0}}emitProgress(t){this.progressCallback?.(t)}async withProgress(t,e,s,n){this.emitProgress({type:"start",action:t,source:e,message:s});try{await n(),this.emitProgress({type:"complete",action:t,source:e})}catch(r){const i=r instanceof Error?r.message:String(r);throw this.emitProgress({type:"error",action:t,source:e,message:i}),r}}async resolve(t){const e=this.createAccumulator(),s=this.settingsManager.getGlobalSettings(),n=this.settingsManager.getProjectSettings(),r=[];for(const l of n.packages??[])r.push({pkg:l,scope:"project"});for(const l of s.packages??[])r.push({pkg:l,scope:"user"});const i=this.dedupePackages(r);await this.resolvePackageSources(i,e,t);const c=this.agentDir,o=u(this.cwd,x);for(const l of W){const g=this.getTargetMap(e,l),h=s[l]??[],d=n[l]??[];this.resolveLocalEntries(d,l,g,{source:"local",scope:"project",origin:"top-level"},o),this.resolveLocalEntries(h,l,g,{source:"local",scope:"user",origin:"top-level"},c)}return this.addAutoDiscoveredResources(e,s,n,c,o),this.toResolvedPaths(e)}async resolveExtensionSources(t,e){const s=this.createAccumulator(),n=e?.temporary?"temporary":e?.local?"project":"user",r=t.map(i=>({pkg:i,scope:n}));return await this.resolvePackageSources(r,s),this.toResolvedPaths(s)}async install(t,e){const s=this.parseSource(t),n=e?.local?"project":"user";await this.withProgress("install",t,`Installing ${t}...`,async()=>{if(s.type==="npm"){await this.installNpm(s,n,!1);return}if(s.type==="git"){await this.installGit(s,n);return}if(s.type==="local"){const r=this.resolvePath(s.path);if(!f(r))throw new Error(`Path does not exist: ${r}`);return}throw new Error(`Unsupported install source: ${t}`)})}async remove(t,e){const s=this.parseSource(t),n=e?.local?"project":"user";await this.withProgress("remove",t,`Removing ${t}...`,async()=>{if(s.type==="npm"){await this.uninstallNpm(s,n);return}if(s.type==="git"){await this.removeGit(s,n);return}if(s.type!=="local")throw new Error(`Unsupported remove source: ${t}`)})}async update(t){const e=this.settingsManager.getGlobalSettings(),s=this.settingsManager.getProjectSettings(),n=t?this.getPackageIdentity(t):void 0;for(const r of e.packages??[]){const i=typeof r=="string"?r:r.source;n&&this.getPackageIdentity(i,"user")!==n||await this.updateSourceForScope(i,"user")}for(const r of s.packages??[]){const i=typeof r=="string"?r:r.source;n&&this.getPackageIdentity(i,"project")!==n||await this.updateSourceForScope(i,"project")}}async updateSourceForScope(t,e){if(N())return;const s=this.parseSource(t);if(s.type==="npm"){if(s.pinned)return;await this.withProgress("update",t,`Updating ${t}...`,async()=>{await this.installNpm(s,e,!1)});return}if(s.type==="git"){if(s.pinned)return;await this.withProgress("update",t,`Updating ${t}...`,async()=>{await this.updateGit(s,e)});return}}async resolvePackageSources(t,e,s){for(const{pkg:n,scope:r}of t){const i=typeof n=="string"?n:n.source,c=typeof n=="object"?n:void 0,o=this.parseSource(i),l={source:i,scope:r,origin:"package"};if(o.type==="local"){const h=this.getBaseDirForScope(r);this.resolveLocalExtensionSource(o,e,c,l,h);continue}const g=p(async()=>{if(N())return!1;if(!s)return await this.installParsedSource(o,r),!0;const h=await s(i);if(h==="skip")return!1;if(h==="error")throw new Error(`Missing source: ${i}`);return await this.installParsedSource(o,r),!0},"installMissing");if(o.type==="npm"){const h=this.getNpmInstallPath(o,r);if((!f(h)||await this.npmNeedsUpdate(o,h))&&!await g())continue;l.baseDir=h,this.collectPackageResources(h,e,c,l);continue}if(o.type==="git"){const h=this.getGitInstallPath(o,r);if(f(h))r==="temporary"&&!o.pinned&&!N()&&await this.refreshTemporaryGitSource(o,i);else if(!await g())continue;l.baseDir=h,this.collectPackageResources(h,e,c,l)}}}resolveLocalExtensionSource(t,e,s,n,r){const i=this.resolvePathFromBase(t.path,r);if(f(i))try{const c=S(i);if(c.isFile()){n.baseDir=P(i),this.addResource(e.extensions,i,n,!0);return}c.isDirectory()&&(n.baseDir=i,this.collectPackageResources(i,e,s,n)||this.addResource(e.extensions,i,n,!0))}catch{return}}async installParsedSource(t,e){if(t.type==="npm"){await this.installNpm(t,e,e==="temporary");return}if(t.type==="git"){await this.installGit(t,e);return}}getPackageSourceString(t){return typeof t=="string"?t:t.source}getSourceMatchKeyForInput(t){const e=this.parseSource(t);return e.type==="npm"?`npm:${e.name}`:e.type==="git"?`git:${e.host}/${e.path}`:`local:${this.resolvePath(e.path)}`}getSourceMatchKeyForSettings(t,e){const s=this.parseSource(t);if(s.type==="npm")return`npm:${s.name}`;if(s.type==="git")return`git:${s.host}/${s.path}`;const n=this.getBaseDirForScope(e);return`local:${this.resolvePathFromBase(s.path,n)}`}packageSourcesMatch(t,e,s){const n=this.getSourceMatchKeyForSettings(this.getPackageSourceString(t),s),r=this.getSourceMatchKeyForInput(e);return n===r}normalizePackageSourceForSettings(t,e){const s=this.parseSource(t);if(s.type!=="local")return t;const n=this.getBaseDirForScope(e),r=this.resolvePath(s.path);return y(n,r)||"."}parseSource(t){if(t.startsWith("npm:")){const i=t.slice(4).trim(),{name:c,version:o}=this.parseNpmSpec(i);return{type:"npm",spec:i,name:c,pinned:!!o}}const e=t.trim(),s=/^[A-Za-z]:[\\/]|^\\\\/.test(e);if(e.startsWith(".")||e.startsWith("/")||e==="~"||e.startsWith("~/")||s)return{type:"local",path:t};const r=ct(t);return r||{type:"local",path:t}}async npmNeedsUpdate(t,e){if(N())return!1;const s=this.getInstalledNpmVersion(e);if(!s)return!0;const{version:n}=this.parseNpmSpec(t.spec);return n?s!==n:!1}getInstalledNpmVersion(t){const e=u(t,"package.json");if(f(e))try{const s=j(e,"utf-8");return JSON.parse(s).version}catch{return}}async getLatestNpmVersion(t){const e=await fetch(`https://registry.npmjs.org/${t}/latest`,{signal:AbortSignal.timeout(lt)});if(!e.ok)throw new Error(`Failed to fetch npm registry: ${e.status}`);return(await e.json()).version}getPackageIdentity(t,e){const s=this.parseSource(t);if(s.type==="npm")return`npm:${s.name}`;if(s.type==="git")return`git:${s.host}/${s.path}`;if(e){const n=this.getBaseDirForScope(e);return`local:${this.resolvePathFromBase(s.path,n)}`}return`local:${this.resolvePath(s.path)}`}dedupePackages(t){const e=new Map;for(const s of t){const n=typeof s.pkg=="string"?s.pkg:s.pkg.source,r=this.getPackageIdentity(n,s.scope),i=e.get(r);i?s.scope==="project"&&i.scope==="user"&&e.set(r,s):e.set(r,s)}return Array.from(e.values())}parseNpmSpec(t){const e=t.match(/^(@?[^@]+(?:\/[^@]+)?)(?:@(.+))?$/);if(!e)return{name:t};const s=e[1]??t,n=e[2];return{name:s,version:n}}async installNpm(t,e,s){if(e==="user"&&!s){await this.runCommand("npm",["install","-g",t.spec]);return}const n=this.getNpmInstallRoot(e,s);this.ensureNpmProject(n),await this.runCommand("npm",["install",t.spec,"--prefix",n])}async uninstallNpm(t,e){if(e==="user"){await this.runCommand("npm",["uninstall","-g",t.name]);return}const s=this.getNpmInstallRoot(e,!1);f(s)&&await this.runCommand("npm",["uninstall",t.name,"--prefix",s])}async installGit(t,e){const s=this.getGitInstallPath(t,e);if(f(s))return;const n=this.getGitInstallRoot(e);n&&this.ensureGitIgnore(n),C(P(s),{recursive:!0}),await this.runCommand("git",["clone",t.repo,s]),t.ref&&await this.runCommand("git",["checkout",t.ref],{cwd:s});const r=u(s,"package.json");f(r)&&await this.runCommand("npm",["install"],{cwd:s})}async updateGit(t,e){const s=this.getGitInstallPath(t,e);if(!f(s)){await this.installGit(t,e);return}await this.runCommand("git",["fetch","--prune","origin"],{cwd:s});try{await this.runCommand("git",["reset","--hard","@{upstream}"],{cwd:s})}catch{await this.runCommand("git",["remote","set-head","origin","-a"],{cwd:s}).catch(()=>{}),await this.runCommand("git",["reset","--hard","origin/HEAD"],{cwd:s})}await this.runCommand("git",["clean","-fdx"],{cwd:s});const n=u(s,"package.json");f(n)&&await this.runCommand("npm",["install"],{cwd:s})}async refreshTemporaryGitSource(t,e){if(!N())try{await this.withProgress("pull",e,`Refreshing ${e}...`,async()=>{await this.updateGit(t,"temporary")})}catch{}}async removeGit(t,e){const s=this.getGitInstallPath(t,e);f(s)&&(K(s,{recursive:!0,force:!0}),this.pruneEmptyGitParents(s,this.getGitInstallRoot(e)))}pruneEmptyGitParents(t,e){if(!e)return;const s=v(e);let n=P(t);for(;n.startsWith(s)&&n!==s;){if(!f(n)){n=P(n);continue}if(E(n).length>0)break;try{K(n,{recursive:!0,force:!0})}catch{break}n=P(n)}}ensureNpmProject(t){f(t)||C(t,{recursive:!0}),this.ensureGitIgnore(t);const e=u(t,"package.json");f(e)||z(e,JSON.stringify({name:"catui-extensions",private:!0},null,2),"utf-8")}ensureGitIgnore(t){f(t)||C(t,{recursive:!0});const e=u(t,".gitignore");f(e)||z(e,`*
+!.gitignore
+`,"utf-8")}getNpmInstallRoot(t,e){return e?this.getTemporaryDir("npm"):t==="project"?u(this.cwd,x,"npm"):u(this.getGlobalNpmRoot(),"..")}getGlobalNpmRoot(){if(this.globalNpmRoot)return this.globalNpmRoot;const t=this.runCommandSync("npm",["root","-g"]);return this.globalNpmRoot=t.trim(),this.globalNpmRoot}getNpmInstallPath(t,e){return e==="temporary"?u(this.getTemporaryDir("npm"),"node_modules",t.name):e==="project"?u(this.cwd,x,"npm","node_modules",t.name):u(this.getGlobalNpmRoot(),t.name)}getGitInstallPath(t,e){return e==="temporary"?this.getTemporaryDir(`git-${t.host}`,t.path):e==="project"?u(this.cwd,x,"git",t.host,t.path):u(this.agentDir,"git",t.host,t.path)}getGitInstallRoot(t){if(t!=="temporary")return t==="project"?u(this.cwd,x,"git"):u(this.agentDir,"git")}getTemporaryDir(t,e){const s=it("sha256").update(`${t}-${e??""}`).digest("hex").slice(0,8);return u(ot(),"catui-extensions",t,s,e??"")}getBaseDirForScope(t){return t==="project"?u(this.cwd,x):t==="user"?this.agentDir:this.cwd}resolvePath(t){const e=t.trim();return e==="~"?F():e.startsWith("~/")?u(F(),e.slice(2)):e.startsWith("~")?u(F(),e.slice(1)):v(this.cwd,e)}resolvePathFromBase(t,e){const s=t.trim();return s==="~"?F():s.startsWith("~/")?u(F(),s.slice(2)):s.startsWith("~")?u(F(),s.slice(1)):v(e,s)}collectPackageResources(t,e,s,n){if(s){for(const c of W){const o=s[c],l=this.getTargetMap(e,c);o!==void 0?this.applyPackageFilter(t,o,c,l,n):this.collectDefaultResources(t,c,l,n)}return!0}const r=this.readPiManifest(t);if(r){for(const c of W){const o=r[c];this.addManifestEntries(o,t,c,this.getTargetMap(e,c),n)}return!0}let i=!1;for(const c of W){const o=u(t,c);if(f(o)){const l=G(o,c);for(const g of l)this.addResource(this.getTargetMap(e,c),g,n,!0);i=!0}}return i}collectDefaultResources(t,e,s,n){const i=this.readPiManifest(t)?.[e];if(i){this.addManifestEntries(i,t,e,s,n);return}const c=u(t,e);if(f(c)){const o=G(c,e);for(const l of o)this.addResource(s,l,n,!0)}}applyPackageFilter(t,e,s,n,r){const{allFiles:i}=this.collectManifestFiles(t,s);if(e.length===0){for(const o of i)this.addResource(n,o,r,!1);return}const c=L(i,e,t);for(const o of i){const l=c.has(o);this.addResource(n,o,r,l)}}collectManifestFiles(t,e){const n=this.readPiManifest(t)?.[e];if(n&&n.length>0){const c=this.collectFilesFromManifestEntries(n,t,e),o=n.filter(D),l=o.length>0?L(c,o,t):new Set(c);return{allFiles:Array.from(l),enabledByManifest:l}}const r=u(t,e);if(!f(r))return{allFiles:[],enabledByManifest:new Set};const i=G(r,e);return{allFiles:i,enabledByManifest:new Set(i)}}readPiManifest(t){const e=u(t,"package.json");if(!f(e))return null;try{const s=j(e,"utf-8");return JSON.parse(s).catui??null}catch{return null}}addManifestEntries(t,e,s,n,r){if(!t)return;const i=this.collectFilesFromManifestEntries(t,e,s),c=t.filter(D),o=L(i,c,e);for(const l of i)o.has(l)&&this.addResource(n,l,r,!0)}collectFilesFromManifestEntries(t,e,s){const r=t.filter(i=>!D(i)).map(i=>v(e,i));return this.collectFilesFromPaths(r,s)}resolveLocalEntries(t,e,s,n,r){if(t.length===0)return;const{plain:i,patterns:c}=pt(t),o=i.map(h=>this.resolvePathFromBase(h,r)),l=this.collectFilesFromPaths(o,e),g=L(l,c,r);for(const h of l)this.addResource(s,h,n,g.has(h))}addAutoDiscoveredResources(t,e,s,n,r){const i={source:"auto",scope:"user",origin:"top-level",baseDir:n},c={source:"auto",scope:"project",origin:"top-level",baseDir:r},o={extensions:e.extensions??[],skills:e.skills??[],prompts:e.prompts??[],themes:e.themes??[]},l={extensions:s.extensions??[],skills:s.skills??[],prompts:s.prompts??[],themes:s.themes??[]},g={extensions:u(n,"extensions"),skills:u(n,"skills"),prompts:u(n,"prompts"),themes:u(n,"themes")},h={extensions:u(r,"extensions"),skills:u(r,"skills"),prompts:u(r,"prompts"),themes:u(r,"themes")},d=u(F(),".agents","skills"),w=mt(this.cwd),m=p((k,Z,q,Q,X)=>{const tt=this.getTargetMap(t,k);for(const U of Z){const et=kt(U,Q,X);this.addResource(tt,U,q,et)}},"addResources");m("extensions",_(h.extensions),c,l.extensions,r),m("skills",[...b(h.skills),...w.flatMap(k=>b(k))],c,l.skills,r),m("prompts",V(h.prompts),c,l.prompts,r),m("themes",H(h.themes),c,l.themes,r),m("extensions",_(g.extensions),i,o.extensions,n),m("skills",[...b(g.skills),...b(d)],i,o.skills,n),m("prompts",V(g.prompts),i,o.prompts,n),m("themes",H(g.themes),i,o.themes,n)}collectFilesFromPaths(t,e){const s=[];for(const n of t)if(f(n))try{const r=S(n);r.isFile()?s.push(n):r.isDirectory()&&s.push(...G(n,e))}catch(r){console.error("[package-manager] collectFilesFromPaths failed:",r)}return s}getTargetMap(t,e){switch(e){case"extensions":return t.extensions;case"skills":return t.skills;case"prompts":return t.prompts;case"themes":return t.themes;default:throw new Error(`Unknown resource type: ${e}`)}}addResource(t,e,s,n){e&&(t.has(e)||t.set(e,{metadata:s,enabled:n}))}createAccumulator(){return{extensions:new Map,skills:new Map,prompts:new Map,themes:new Map}}toResolvedPaths(t){const e=p(s=>Array.from(s.entries()).map(([n,{metadata:r,enabled:i}])=>({path:n,enabled:i,metadata:r})),"toResolved");return{extensions:e(t.extensions),skills:e(t.skills),prompts:e(t.prompts),themes:e(t.themes)}}runCommand(t,e,s){return new Promise((n,r)=>{const i=nt(t,e,{cwd:s?.cwd,stdio:"inherit",shell:process.platform==="win32"});i.on("error",r),i.on("exit",c=>{c===0?n():r(new Error(`${t} ${e.join(" ")} failed with code ${c}`))})})}runCommandSync(t,e){const s=rt(t,e,{stdio:["ignore","pipe","pipe"],encoding:"utf-8",shell:process.platform==="win32"});if(s.status!==0)throw new Error(`Failed to run ${t} ${e.join(" ")}: ${s.stderr||s.stdout}`);return(s.stdout||s.stderr||"").trim()}}export{Rt as DefaultPackageManager};

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

@@ -0,0 +1,35 @@
+import { type AgentDirContext } from "../agent-dir/agent-dir-context.js";
+export declare class PersonaManager {
+    private readonly ctx;
+    constructor(ctx?: AgentDirContext);
+    private get personasDir();
+    private get activePersonaStatePath();
+    private ensurePersonasDir;
+    getPersonasDir(): string;
+    getActivePersonaId(): string | undefined;
+    setActivePersonaId(personaId: string | undefined): void;
+    listPersonas(): string[];
+    getPersonaDir(personaId: string): string;
+    getPersonaCatuiPath(personaId: string): string;
+    getPersonaSkillsDir(personaId: string): string;
+    getPersonaSoulDir(personaId: string): string;
+    getPersonaMemoryDir(personaId: string): string;
+    getPersonaMcpConfigPath(personaId: string): string;
+    getPersonaDescription(personaId: string): string;
+}
+/** Get path to personas directory (default agent context). */
+export declare function getPersonasDir(): string;
+export declare function getActivePersonaId(): string | undefined;
+export declare function setActivePersonaId(personaId: string | undefined): void;
+export declare function listPersonas(): string[];
+export declare function getPersonaDir(personaId: string): string;
+export declare function getPersonaCatuiPath(personaId: string): string;
+export declare function getPersonaSkillsDir(personaId: string): string;
+export declare function getPersonaSoulDir(personaId: string): string;
+export declare function getPersonaMemoryDir(personaId: string): string;
+export declare function getPersonaMcpConfigPath(personaId: string): string;
+export declare function getPersonaDescription(personaId: string): string;
+/**
+ * For later environment variable override: resolve path to absolute to avoid relative path issues during reload.
+ */
+export declare function toAbsolutePath(p: string): string;

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

@@ -0,0 +1,5 @@
+var p=Object.defineProperty;var n=(r,t)=>p(r,"name",{value:t,configurable:!0});import{existsSync as a,readdirSync as D,readFileSync as h,mkdirSync as g,statSync as m,writeFileSync as f}from"node:fs";import{join as o,resolve as d}from"node:path";import{defaultAgentDirContext as v}from"../agent-dir/agent-dir-context.js";const l={default:"catui"};function u(r){const t=r.trim();return t?t.replace(/[^a-zA-Z0-9_-]/g,"_"):"general"}n(u,"normalizePersonaId");class x{static{n(this,"PersonaManager")}ctx;constructor(t=v()){this.ctx=t}get personasDir(){return o(this.ctx.path,"personas")}get activePersonaStatePath(){return o(this.ctx.path,"persona.json")}ensurePersonasDir(){a(this.personasDir)||g(this.personasDir,{recursive:!0});const t=o(this.personasDir,"vex");if(!a(t)){g(t,{recursive:!0});const e=o(t,"CATUI.md");a(e)||f(e,`# vex
+
+Default persona for Catui.
+`,"utf-8")}}getPersonasDir(){return this.personasDir}getActivePersonaId(){try{if(!a(this.activePersonaStatePath))return"vex";const t=h(this.activePersonaStatePath,"utf-8"),e=JSON.parse(t);if(!e?.activePersonaId)return"vex";let i=u(String(e.activePersonaId));return l[i]&&(i=l[i],this.setActivePersonaId(i)),i}catch{return"vex"}}setActivePersonaId(t){if(this.ensurePersonasDir(),!t){try{f(this.activePersonaStatePath,JSON.stringify({},null,2),"utf-8")}catch{}return}const e=u(t),i=this.getPersonaDir(e);a(i)||g(i,{recursive:!0});const P={activePersonaId:e};f(this.activePersonaStatePath,JSON.stringify(P,null,2),"utf-8")}listPersonas(){try{return this.ensurePersonasDir(),D(this.personasDir).map(t=>u(t)).filter(t=>{const e=this.getPersonaDir(t);try{return m(e).isDirectory()}catch{return!1}}).sort((t,e)=>t.localeCompare(e))}catch{return[]}}getPersonaDir(t){const e=u(t);return o(this.personasDir,e)}getPersonaCatuiPath(t){return o(this.getPersonaDir(t),"CATUI.md")}getPersonaSkillsDir(t){return o(this.getPersonaDir(t),"skills")}getPersonaSoulDir(t){return o(this.getPersonaDir(t),"soul")}getPersonaMemoryDir(t){return o(this.getPersonaDir(t),"memory")}getPersonaMcpConfigPath(t){return o(this.getPersonaDir(t),"mcp.json")}getPersonaDescription(t){try{const e=this.getPersonaCatuiPath(t);if(!a(e))return"";const i=h(e,"utf-8");for(const P of i.split(`
+`)){const c=P.trim();if(!(!c||c.startsWith("#")))return c.length>60?c.slice(0,57)+"...":c}return""}catch{return""}}}const s=new x;function I(){return s.getPersonasDir()}n(I,"getPersonasDir");function M(){return s.getActivePersonaId()}n(M,"getActivePersonaId");function k(r){s.setActivePersonaId(r)}n(k,"setActivePersonaId");function N(){return s.listPersonas()}n(N,"listPersonas");function w(r){return s.getPersonaDir(r)}n(w,"getPersonaDir");function z(r){return s.getPersonaCatuiPath(r)}n(z,"getPersonaCatuiPath");function O(r){return s.getPersonaSkillsDir(r)}n(O,"getPersonaSkillsDir");function j(r){return s.getPersonaSoulDir(r)}n(j,"getPersonaSoulDir");function E(r){return s.getPersonaMemoryDir(r)}n(E,"getPersonaMemoryDir");function J(r){return s.getPersonaMcpConfigPath(r)}n(J,"getPersonaMcpConfigPath");function _(r){return s.getPersonaDescription(r)}n(_,"getPersonaDescription");function F(r){const t=r.trim();return t&&d(t)}n(F,"toAbsolutePath");export{x as PersonaManager,M as getActivePersonaId,z as getPersonaCatuiPath,_ as getPersonaDescription,w as getPersonaDir,J as getPersonaMcpConfigPath,E as getPersonaMemoryDir,O as getPersonaSkillsDir,j as getPersonaSoulDir,I as getPersonasDir,N as listPersonas,k as setActivePersonaId,F as toAbsolutePath};

package/dist/core/platform/abort-slot.d.ts

@@ -0,0 +1,26 @@
+/**
+ * [WHO]: Provides AbortSlot — a single-occupancy holder for an in-flight operation's AbortController
+ * [FROM]: No dependencies — wraps the Web AbortController primitive
+ * [TO]: Consumed by core/runtime/agent-session.ts (compaction / auto-compaction / branch summary);
+ *       reusable by any module that runs one cancellable operation at a time
+ * [HERE]: core/platform/abort-slot.ts - generic cancellation primitive (no business knowledge)
+ *
+ * Replaces the repeated `private _xAbortController: AbortController | undefined` + begin/abort/
+ * clear pattern. Holds at most one controller: begin() starts a fresh operation and returns its
+ * signal; abort() cancels the active one; clear() releases the slot (call in finally).
+ */
+export declare class AbortSlot {
+    private _controller;
+    /** Start a new operation, replacing any prior controller, and return its signal. */
+    begin(): AbortSignal;
+    /** Whether an operation is currently active. */
+    get active(): boolean;
+    /** Whether the active operation has been aborted (false when no active operation). */
+    get aborted(): boolean;
+    /** The active operation's signal, if any. */
+    get signal(): AbortSignal | undefined;
+    /** Abort the active operation (no-op if none). */
+    abort(): void;
+    /** Release the slot — call in a finally after the operation settles. */
+    clear(): void;
+}

package/dist/core/platform/abort-slot.js

@@ -0,0 +1 @@
+var l=Object.defineProperty;var t=(r,e)=>l(r,"name",{value:e,configurable:!0});class n{static{t(this,"AbortSlot")}_controller=void 0;begin(){return this._controller=new AbortController,this._controller.signal}get active(){return this._controller!==void 0}get aborted(){return this._controller?.signal.aborted??!1}get signal(){return this._controller?.signal}abort(){this._controller?.abort()}clear(){this._controller=void 0}}export{n as AbortSlot};