@openadapter/koda 1.0.0-beta.3

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

@@ -0,0 +1,149 @@
+/**
+ * Model registry - manages built-in and custom models, provides API key resolution.
+ */
+import { type Api, type AssistantMessageEventStream, type Context, type Model, type OAuthProviderInterface, type SimpleStreamOptions } from "@openadapter/koda-ai";
+import type { AuthStatus, AuthStorage } from "./auth-storage.ts";
+import { clearConfigValueCache } from "./resolve-config-value.ts";
+export type ResolvedRequestAuth = {
+    ok: true;
+    apiKey?: string;
+    headers?: Record<string, string>;
+} | {
+    ok: false;
+    error: string;
+};
+/** 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 declare class ModelRegistry {
+    private models;
+    private providerRequestConfigs;
+    private modelRequestHeaders;
+    private registeredProviders;
+    private loadError;
+    readonly authStorage: AuthStorage;
+    private modelsJsonPath;
+    private constructor();
+    static create(authStorage: AuthStorage, modelsJsonPath?: string): ModelRegistry;
+    static inMemory(authStorage: AuthStorage): ModelRegistry;
+    /**
+     * 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;
+    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>[];
+    /**
+     * Find a model by provider and ID.
+     */
+    find(provider: string, modelId: string): Model<Api> | undefined;
+    /**
+     * Get API key for a model.
+     */
+    hasConfiguredAuth(model: Model<Api>): boolean;
+    private getModelRequestKey;
+    private storeProviderRequestConfig;
+    private storeModelHeaders;
+    /**
+     * Get API key and request headers for a model.
+     */
+    getApiKeyAndHeaders(model: Model<Api>): Promise<ResolvedRequestAuth>;
+    /**
+     * Return auth status for a provider, including request auth configured in models.json.
+     * This intentionally does not execute command-backed config values.
+     */
+    getProviderAuthStatus(provider: string): AuthStatus;
+    /**
+     * Get display name for a provider.
+     */
+    getProviderDisplayName(provider: string): string;
+    /**
+     * 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;
+    /**
+     * Unregister a previously registered provider.
+     *
+     * Removes the provider from the registry and reloads models from disk so that
+     * built-in models overridden by this provider are restored to their original state.
+     * Also resets dynamic OAuth and API stream registrations before reapplying
+     * remaining dynamic providers.
+     * Has no effect if the provider was never registered.
+     */
+    unregisterProvider(providerName: string): void;
+    /**
+     * Upsert a provider config into registeredProviders.
+     * If the provider is already registered, defined values in the incoming config
+     * override existing ones; undefined values are preserved from the stored config.
+     * If the provider is not registered, the incoming config is stored as-is.
+     */
+    private upsertRegisteredProvider;
+    private validateProviderConfig;
+    private applyProviderConfig;
+}
+/**
+ * Input type for registerProvider API.
+ */
+export interface ProviderConfigInput {
+    name?: string;
+    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;
+        baseUrl?: string;
+        reasoning: boolean;
+        thinkingLevelMap?: Model<Api>["thinkingLevelMap"];
+        input: ("text" | "image")[];
+        cost: {
+            input: number;
+            output: number;
+            cacheRead: number;
+            cacheWrite: number;
+        };
+        contextWindow: number;
+        maxTokens: number;
+        headers?: Record<string, string>;
+        compat?: Model<Api>["compat"];
+    }>;
+}

package/dist/core/model-registry.js

@@ -0,0 +1,9 @@
+var x=Object.defineProperty;var c=(d,t)=>x(d,"name",{value:t,configurable:!0});import{getModels as S,getProviders as g,registerApiProvider as $,resetApiProviders as q}from"@openadapter/koda-ai";import{registerOAuthProvider as j,resetOAuthProviders as K}from"@openadapter/koda-ai/oauth";import{existsSync as B,readFileSync as T}from"fs";import{join as E}from"path";import{Type as e}from"typebox";import{Compile as I}from"typebox/compile";import{getAgentDir as H}from"../config.js";import{warnDeprecation as _}from"../utils/deprecation.js";import{stripJsonComments as V}from"../utils/json.js";import{normalizePath as W}from"../utils/paths.js";import{BUILT_IN_PROVIDER_DISPLAY_NAMES as N}from"./provider-display-names.js";import{clearConfigValueCache as D,getConfigValueEnvVarNames as F,isCommandConfigValue as G,isConfigValueConfigured as w,isLegacyEnvVarNameConfigValue as z,resolveConfigValueOrThrow as J,resolveConfigValueUncached as Y,resolveHeadersOrThrow as C}from"./resolve-config-value.js";const P=e.Object({p50:e.Optional(e.Number()),p75:e.Optional(e.Number()),p90:e.Optional(e.Number()),p99:e.Optional(e.Number())}),Q=e.Object({allow_fallbacks:e.Optional(e.Boolean()),require_parameters:e.Optional(e.Boolean()),data_collection:e.Optional(e.Union([e.Literal("deny"),e.Literal("allow")])),zdr:e.Optional(e.Boolean()),enforce_distillable_text:e.Optional(e.Boolean()),order:e.Optional(e.Array(e.String())),only:e.Optional(e.Array(e.String())),ignore:e.Optional(e.Array(e.String())),quantizations:e.Optional(e.Array(e.String())),sort:e.Optional(e.Union([e.String(),e.Object({by:e.Optional(e.String()),partition:e.Optional(e.Union([e.String(),e.Null()]))})])),max_price:e.Optional(e.Object({prompt:e.Optional(e.Union([e.Number(),e.String()])),completion:e.Optional(e.Union([e.Number(),e.String()])),image:e.Optional(e.Union([e.Number(),e.String()])),audio:e.Optional(e.Union([e.Number(),e.String()])),request:e.Optional(e.Union([e.Number(),e.String()]))})),preferred_min_throughput:e.Optional(e.Union([e.Number(),P])),preferred_max_latency:e.Optional(e.Union([e.Number(),P]))}),X=e.Object({only:e.Optional(e.Array(e.String())),order:e.Optional(e.Array(e.String()))}),h=e.Union([e.String(),e.Null()]),R=e.Object({off:e.Optional(h),minimal:e.Optional(h),low:e.Optional(h),medium:e.Optional(h),high:e.Optional(h),xhigh:e.Optional(h)}),Z=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()),requiresReasoningContentOnAssistantMessages:e.Optional(e.Boolean()),thinkingFormat:e.Optional(e.Union([e.Literal("openai"),e.Literal("openrouter"),e.Literal("together"),e.Literal("deepseek"),e.Literal("zai"),e.Literal("qwen"),e.Literal("qwen-chat-template")])),cacheControlFormat:e.Optional(e.Literal("anthropic")),openRouterRouting:e.Optional(Q),vercelGatewayRouting:e.Optional(X),supportsStrictMode:e.Optional(e.Boolean()),supportsLongCacheRetention:e.Optional(e.Boolean())}),ee=e.Object({sendSessionIdHeader:e.Optional(e.Boolean()),supportsLongCacheRetention:e.Optional(e.Boolean())}),te=e.Object({supportsEagerToolInputStreaming:e.Optional(e.Boolean()),supportsLongCacheRetention:e.Optional(e.Boolean()),sendSessionAffinityHeaders:e.Optional(e.Boolean()),supportsCacheControlOnTools:e.Optional(e.Boolean()),forceAdaptiveThinking:e.Optional(e.Boolean())}),f=e.Union([Z,ee,te]),oe=e.Object({id:e.String({minLength:1}),name:e.Optional(e.String({minLength:1})),api:e.Optional(e.String({minLength:1})),baseUrl:e.Optional(e.String({minLength:1})),reasoning:e.Optional(e.Boolean()),thinkingLevelMap:e.Optional(R),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())),compat:e.Optional(f)}),re=e.Object({name:e.Optional(e.String({minLength:1})),reasoning:e.Optional(e.Boolean()),thinkingLevelMap:e.Optional(R),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())),compat:e.Optional(f)}),ie=e.Object({name:e.Optional(e.String({minLength:1})),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())),compat:e.Optional(f),authHeader:e.Optional(e.Boolean()),models:e.Optional(e.Array(oe)),modelOverrides:e.Optional(e.Record(e.String(),re))}),ne=e.Object({providers:e.Record(e.String(),ie)}),M=I(ne);function se(d){if(d.keyword==="required"){const r=d.params.requiredProperties?.[0];if(r){const i=d.instancePath.replace(/^\//,"").replace(/\//g,".");return i?`${i}.${r}`:r}}return d.instancePath.replace(/^\//,"").replace(/\//g,".")||"root"}c(se,"formatValidationPath");function A(d,t,o){return z(o)?(_(`registerProvider("${d}") ${t} value "${o}" is treated as a legacy environment variable reference. This will no longer be detected as an environment variable reference in a future release. Pass "$${o}" instead.`),`$${o}`):o}c(A,"migrateLegacyRegisterProviderConfigValue");function k(d,t,o){if(!o)return;let r;for(const[i,s]of Object.entries(o)){const n=A(d,`${t} header "${i}"`,s);n!==s&&(r??={...o},r[i]=n)}return r??o}c(k,"migrateLegacyRegisterProviderHeaders");function ae(d,t){let o;const r=c((s,n)=>{o??={...t},o[s]=n},"setMigratedConfigValue");if(t.apiKey){const s=A(d,"apiKey",t.apiKey);s!==t.apiKey&&r("apiKey",s)}const i=k(d,"headers",t.headers);if(i!==t.headers&&r("headers",i),t.models){let s;for(let n=0;n<t.models.length;n++){const a=t.models[n],l=k(d,`model "${a.id}" headers`,a.headers);l!==a.headers&&(s??=[...t.models],s[n]={...a,headers:l})}s&&r("models",s)}return o??t}c(ae,"migrateLegacyRegisterProviderConfigValues");function m(d){return{models:[],overrides:new Map,modelOverrides:new Map,error:d}}c(m,"emptyCustomModelsResult");function O(d,t){if(!t)return d;const o=d,r=t,i={...o,...r},s=o,n=r,a=i;return(s?.openRouterRouting||n.openRouterRouting)&&(a.openRouterRouting={...s?.openRouterRouting,...n.openRouterRouting}),(s?.vercelGatewayRouting||n.vercelGatewayRouting)&&(a.vercelGatewayRouting={...s?.vercelGatewayRouting,...n.vercelGatewayRouting}),i}c(O,"mergeCompat");function le(d,t){const o={...d};return t.name!==void 0&&(o.name=t.name),t.reasoning!==void 0&&(o.reasoning=t.reasoning),t.thinkingLevelMap!==void 0&&(o.thinkingLevelMap={...d.thinkingLevelMap,...t.thinkingLevelMap}),t.input!==void 0&&(o.input=t.input),t.contextWindow!==void 0&&(o.contextWindow=t.contextWindow),t.maxTokens!==void 0&&(o.maxTokens=t.maxTokens),t.cost&&(o.cost={input:t.cost.input??d.cost.input,output:t.cost.output??d.cost.output,cacheRead:t.cost.cacheRead??d.cost.cacheRead,cacheWrite:t.cost.cacheWrite??d.cost.cacheWrite}),o.compat=O(d.compat,t.compat),o}c(le,"applyModelOverride");const we=D;class v{static{c(this,"ModelRegistry")}models=[];providerRequestConfigs=new Map;modelRequestHeaders=new Map;registeredProviders=new Map;loadError=void 0;authStorage;modelsJsonPath;constructor(t,o){this.authStorage=t,this.modelsJsonPath=o?W(o):void 0,this.loadModels()}static create(t,o=E(H(),"models.json")){return new v(t,o)}static inMemory(t){return new v(t,void 0)}refresh(){this.providerRequestConfigs.clear(),this.modelRequestHeaders.clear(),this.loadError=void 0,q(),K(),this.loadModels();for(const[t,o]of this.registeredProviders.entries())this.applyProviderConfig(t,o)}getError(){return this.loadError}loadModels(){const{models:t,overrides:o,modelOverrides:r,error:i}=this.modelsJsonPath?this.loadCustomModels(this.modelsJsonPath):m();i&&(this.loadError=i);const s=this.loadBuiltInModels(o,r);let n=this.mergeCustomModels(s,t);for(const a of this.authStorage.getOAuthProviders()){const l=this.authStorage.get(a.id);l?.type==="oauth"&&a.modifyModels&&(n=a.modifyModels(n,l))}this.models=n}loadBuiltInModels(t,o){return g().flatMap(r=>{const i=S(r),s=t.get(r),n=o.get(r);return i.map(a=>{let l=a;s&&(l={...l,baseUrl:s.baseUrl??l.baseUrl,compat:O(l.compat,s.compat)});const u=n?.get(a.id);return u&&(l=le(l,u)),l})})}mergeCustomModels(t,o){const r=[...t];for(const i of o){const s=r.findIndex(n=>n.provider===i.provider&&n.id===i.id);s>=0?r[s]=i:r.push(i)}return r}loadCustomModels(t){if(!B(t))return m();try{const o=T(t,"utf-8"),r=JSON.parse(V(o));if(!M.Check(r)){const a=M.Errors(r).map(l=>`  - ${se(l)}: ${l.message}`).join(`
+`)||"Unknown schema error";return m(`Invalid models.json schema:
+${a}
+
+File: ${t}`)}const i=r;this.validateConfig(i);const s=new Map,n=new Map;for(const[a,l]of Object.entries(i.providers))if((l.baseUrl||l.compat)&&s.set(a,{baseUrl:l.baseUrl,compat:l.compat}),this.storeProviderRequestConfig(a,l),l.modelOverrides){n.set(a,new Map(Object.entries(l.modelOverrides)));for(const[u,p]of Object.entries(l.modelOverrides))this.storeModelHeaders(a,u,p.headers)}return{models:this.parseModels(i),overrides:s,modelOverrides:n,error:void 0}}catch(o){return o instanceof SyntaxError?m(`Failed to parse models.json: ${o.message}
+
+File: ${t}`):m(`Failed to load models.json: ${o instanceof Error?o.message:o}
+
+File: ${t}`)}}validateConfig(t){const o=new Set(g());for(const[r,i]of Object.entries(t.providers)){const s=o.has(r),n=!!i.api,a=i.models??[],l=i.modelOverrides&&Object.keys(i.modelOverrides).length>0;if(a.length===0){if(!i.baseUrl&&!i.headers&&!i.compat&&!l)throw new Error(`Provider ${r}: must specify "baseUrl", "headers", "compat", "modelOverrides", or "models".`)}else if(!s){if(!i.baseUrl)throw new Error(`Provider ${r}: "baseUrl" is required when defining custom models.`);if(!i.apiKey)throw new Error(`Provider ${r}: "apiKey" is required when defining custom models.`)}for(const u of a){const p=!!u.api;if(!n&&!p&&!s)throw new Error(`Provider ${r}, model ${u.id}: no "api" specified. Set at provider or model level.`);if(!u.id)throw new Error(`Provider ${r}: model missing "id"`);if(u.contextWindow!==void 0&&u.contextWindow<=0)throw new Error(`Provider ${r}, model ${u.id}: invalid contextWindow`);if(u.maxTokens!==void 0&&u.maxTokens<=0)throw new Error(`Provider ${r}, model ${u.id}: invalid maxTokens`)}}}parseModels(t){const o=[],r=new Set(g()),i=new Map,s=c(n=>{if(!r.has(n))return;if(i.has(n))return i.get(n);const a=S(n);if(a.length===0)return;const l={api:a[0].api,baseUrl:a[0].baseUrl};return i.set(n,l),l},"getBuiltInDefaults");for(const[n,a]of Object.entries(t.providers)){const l=a.models??[];if(l.length===0)continue;const u=s(n);for(const p of l){const b=p.api??a.api??u?.api;if(!b)continue;const y=p.baseUrl??a.baseUrl??u?.baseUrl;if(!y)continue;const U=O(a.compat,p.compat);this.storeModelHeaders(n,p.id,p.headers);const L={input:0,output:0,cacheRead:0,cacheWrite:0};o.push({id:p.id,name:p.name??p.id,api:b,provider:n,baseUrl:y,reasoning:p.reasoning??!1,thinkingLevelMap:p.thinkingLevelMap,input:p.input??["text"],cost:p.cost??L,contextWindow:p.contextWindow??128e3,maxTokens:p.maxTokens??16384,headers:void 0,compat:U})}}return o}getAll(){return this.models}getAvailable(){return this.models.filter(t=>this.hasConfiguredAuth(t))}find(t,o){return this.models.find(r=>r.provider===t&&r.id===o)}hasConfiguredAuth(t){const o=this.providerRequestConfigs.get(t.provider)?.apiKey;return this.authStorage.hasAuth(t.provider)||o!==void 0&&w(o)}getModelRequestKey(t,o){return`${t}:${o}`}storeProviderRequestConfig(t,o){!o.apiKey&&!o.headers&&!o.authHeader||this.providerRequestConfigs.set(t,{apiKey:o.apiKey,headers:o.headers,authHeader:o.authHeader})}storeModelHeaders(t,o,r){const i=this.getModelRequestKey(t,o);if(!r||Object.keys(r).length===0){this.modelRequestHeaders.delete(i);return}this.modelRequestHeaders.set(i,r)}async getApiKeyAndHeaders(t){try{const o=this.providerRequestConfigs.get(t.provider),i=await this.authStorage.getApiKey(t.provider,{includeFallback:!1})??(o?.apiKey?J(o.apiKey,`API key for provider "${t.provider}"`):void 0),s=C(o?.headers,`provider "${t.provider}"`),n=C(this.modelRequestHeaders.get(this.getModelRequestKey(t.provider,t.id)),`model "${t.provider}/${t.id}"`);let a=t.headers||s||n?{...t.headers,...s,...n}:void 0;if(o?.authHeader){if(!i)return{ok:!1,error:`No API key found for "${t.provider}"`};a={...a,Authorization:`Bearer ${i}`}}return{ok:!0,apiKey:i,headers:a&&Object.keys(a).length>0?a:void 0}}catch(o){return{ok:!1,error:o instanceof Error?o.message:String(o)}}}getProviderAuthStatus(t){const o=this.authStorage.getAuthStatus(t);if(o.source)return o;const r=this.providerRequestConfigs.get(t)?.apiKey;if(!r)return o;if(G(r))return{configured:!0,source:"models_json_command"};const i=F(r);return i.length>0?w(r)?{configured:!0,source:"environment",label:i.join(", ")}:{configured:!1}:{configured:!0,source:"models_json_key"}}getProviderDisplayName(t){const o=this.registeredProviders.get(t),r=this.authStorage.getOAuthProviders().find(i=>i.id===t);return o?.name??o?.oauth?.name??r?.name??N[t]??t}async getApiKeyForProvider(t){const o=await this.authStorage.getApiKey(t,{includeFallback:!1});if(o!==void 0)return o;const r=this.providerRequestConfigs.get(t)?.apiKey;return r?Y(r):void 0}isUsingOAuth(t){return this.authStorage.get(t.provider)?.type==="oauth"}registerProvider(t,o){const r=ae(t,o);this.validateProviderConfig(t,r),this.applyProviderConfig(t,r),this.upsertRegisteredProvider(t,r)}unregisterProvider(t){this.registeredProviders.has(t)&&(this.registeredProviders.delete(t),this.refresh())}upsertRegisteredProvider(t,o){const r=this.registeredProviders.get(t);if(!r){this.registeredProviders.set(t,o);return}for(const i of Object.keys(o))o[i]!==void 0&&(r[i]=o[i])}validateProviderConfig(t,o){if(o.streamSimple&&!o.api)throw new Error(`Provider ${t}: "api" is required when registering streamSimple.`);if(!(!o.models||o.models.length===0)){if(!o.baseUrl)throw new Error(`Provider ${t}: "baseUrl" is required when defining models.`);if(!o.apiKey&&!o.oauth)throw new Error(`Provider ${t}: "apiKey" or "oauth" is required when defining models.`);for(const r of o.models)if(!(r.api||o.api))throw new Error(`Provider ${t}, model ${r.id}: no "api" specified.`)}}applyProviderConfig(t,o){if(o.oauth){const r={...o.oauth,id:t};j(r)}if(o.streamSimple){const r=o.streamSimple;$({api:o.api,stream:c((i,s,n)=>r(i,s,n),"stream"),streamSimple:r},`provider:${t}`)}if(this.storeProviderRequestConfig(t,o),o.models&&o.models.length>0){this.models=this.models.filter(r=>r.provider!==t);for(const r of o.models){const i=r.api||o.api;this.storeModelHeaders(t,r.id,r.headers),this.models.push({id:r.id,name:r.name,api:i,provider:t,baseUrl:r.baseUrl??o.baseUrl,reasoning:r.reasoning,thinkingLevelMap:r.thinkingLevelMap,input:r.input,cost:r.cost,contextWindow:r.contextWindow,maxTokens:r.maxTokens,headers:void 0,compat:r.compat})}if(o.oauth?.modifyModels){const r=this.authStorage.get(t);r?.type==="oauth"&&(this.models=o.oauth.modifyModels(this.models,r))}}else(o.baseUrl||o.headers)&&(this.models=this.models.map(r=>r.provider!==t?r:{...r,baseUrl:o.baseUrl??r.baseUrl}))}}export{v as ModelRegistry,we as clearApiKeyCache};

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

@@ -0,0 +1,109 @@
+/**
+ * Model resolution, scoping, and initial selection
+ */
+import type { ThinkingLevel } from "@openadapter/koda-agent-core";
+import { type Api, type KnownProvider, type Model } from "@openadapter/koda-ai";
+import type { ModelRegistry } from "./model-registry.ts";
+/** 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;
+}
+/**
+ * Find an exact model reference match.
+ * Supports either a bare model id or a canonical provider/modelId reference.
+ * When matching by bare id, ambiguous matches across providers are rejected.
+ */
+export declare function findExactModelReferenceMatch(modelReference: string, availableModels: Model<Api>[]): Model<Api> | undefined;
+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 h=(t,r)=>I(t,"name",{value:r,configurable:!0});import{modelsAreEqual as x}from"@openadapter/koda-ai";import v from"chalk";import{minimatch as M}from"minimatch";import{isValidThinkingLevel as C}from"../cli/args.js";import{DEFAULT_THINKING_LEVEL as w}from"./defaults.js";const L={"amazon-bedrock":"us.anthropic.claude-opus-4-6-v1",anthropic:"claude-opus-4-8",openai:"gpt-5.4","azure-openai-responses":"gpt-5.4","openai-codex":"gpt-5.5",nvidia:"nvidia/nemotron-3-super-120b-a12b",deepseek:"deepseek-v4-pro",google:"gemini-3.1-pro-preview","google-vertex":"gemini-3.1-pro-preview","github-copilot":"gpt-5.4",openrouter:"moonshotai/kimi-k2.6","vercel-ai-gateway":"zai/glm-5.1",xai:"grok-4.20-0309-reasoning",groq:"openai/gpt-oss-120b",cerebras:"zai-glm-4.7",zai:"glm-5.1",mistral:"devstral-medium-latest",minimax:"MiniMax-M2.7","minimax-cn":"MiniMax-M2.7",moonshotai:"kimi-k2.6","moonshotai-cn":"kimi-k2.6",huggingface:"moonshotai/Kimi-K2.6",fireworks:"accounts/fireworks/models/kimi-k2p6",together:"moonshotai/Kimi-K2.6",opencode:"kimi-k2.6","opencode-go":"kimi-k2.6","kimi-coding":"kimi-for-coding","cloudflare-workers-ai":"@cf/moonshotai/kimi-k2.6","cloudflare-ai-gateway":"workers-ai/@cf/moonshotai/kimi-k2.6",xiaomi:"mimo-v2.5-pro","xiaomi-token-plan-cn":"mimo-v2.5-pro","xiaomi-token-plan-ams":"mimo-v2.5-pro","xiaomi-token-plan-sgp":"mimo-v2.5-pro"};function y(t){return t.endsWith("-latest")?!0:!/-\d{8}$/.test(t)}h(y,"isAlias");function F(t,r){const i=t.trim();if(!i)return;const l=i.toLowerCase(),n=r.filter(o=>`${o.provider}/${o.id}`.toLowerCase()===l);if(n.length===1)return n[0];if(n.length>1)return;const a=i.indexOf("/");if(a!==-1){const o=i.substring(0,a).trim(),s=i.substring(a+1).trim();if(o&&s){const c=r.filter(u=>u.provider.toLowerCase()===o.toLowerCase()&&u.id.toLowerCase()===s.toLowerCase());if(c.length===1)return c[0];if(c.length>1)return}}const e=r.filter(o=>o.id.toLowerCase()===l);return e.length===1?e[0]:void 0}h(F,"findExactModelReferenceMatch");function A(t,r){const i=F(t,r);if(i)return i;const l=r.filter(e=>e.id.toLowerCase().includes(t.toLowerCase())||e.name?.toLowerCase().includes(t.toLowerCase()));if(l.length===0)return;const n=l.filter(e=>y(e.id)),a=l.filter(e=>!y(e.id));return n.length>0?(n.sort((e,o)=>o.id.localeCompare(e.id)),n[0]):(a.sort((e,o)=>o.id.localeCompare(e.id)),a[0])}h(A,"tryMatchModel");function U(t,r,i){const l=i.filter(e=>e.provider===t);if(l.length===0)return;const n=L[t];return{...n?l.find(e=>e.id===n)??l[0]:l[0],id:r,name:r}}h(U,"buildFallbackModel");function b(t,r,i){const l=A(t,r);if(l)return{model:l,thinkingLevel:void 0,warning:void 0};const n=t.lastIndexOf(":");if(n===-1)return{model:void 0,thinkingLevel:void 0,warning:void 0};const a=t.substring(0,n),e=t.substring(n+1);if(C(e)){const o=b(a,r,i);return o.model?{model:o.model,thinkingLevel:o.warning?void 0:e,warning:o.warning}:o}else{if(!(i?.allowInvalidThinkingLevelFallback??!0))return{model:void 0,thinkingLevel:void 0,warning:void 0};const s=b(a,r,i);return s.model?{model:s.model,thinkingLevel:void 0,warning:`Invalid thinking level "${e}" in pattern "${t}". Using default instead.`}:s}}h(b,"parseModelPattern");async function R(t,r){const i=await r.getAvailable(),l=[];for(const n of t){if(n.includes("*")||n.includes("?")||n.includes("[")){const s=n.lastIndexOf(":");let c=n,u;if(s!==-1){const d=n.substring(s+1);C(d)&&(u=d,c=n.substring(0,s))}const p=i.filter(d=>{const k=`${d.provider}/${d.id}`;return M(k,c,{nocase:!0})||M(d.id,c,{nocase:!0})});if(p.length===0){console.warn(v.yellow(`Warning: No models match pattern "${n}"`));continue}for(const d of p)l.find(k=>x(k.model,d))||l.push({model:d,thinkingLevel:u});continue}const{model:a,thinkingLevel:e,warning:o}=b(n,i);if(o&&console.warn(v.yellow(`Warning: ${o}`)),!a){console.warn(v.yellow(`Warning: No models match pattern "${n}"`));continue}l.find(s=>x(s.model,a))||l.push({model:a,thinkingLevel:e})}return l}h(R,"resolveModelScope");function T(t){const{cliProvider:r,cliModel:i,modelRegistry:l}=t;if(!i)return{model:void 0,warning:void 0,error:void 0};const n=l.getAll();if(n.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 f of n)a.set(f.provider.toLowerCase(),f.provider);let e=r?a.get(r.toLowerCase()):void 0;if(r&&!e)return{model:void 0,warning:void 0,error:`Unknown provider "${r}". Use --list-models to see available providers/models.`};let o=i,s=!1;if(!e){const f=i.indexOf("/");if(f!==-1){const g=i.substring(0,f),m=a.get(g.toLowerCase());m&&(e=m,o=i.substring(f+1),s=!0)}}if(!e){const f=i.toLowerCase(),g=n.find(m=>m.id.toLowerCase()===f||`${m.provider}/${m.id}`.toLowerCase()===f);if(g)return{model:g,warning:void 0,thinkingLevel:void 0,error:void 0}}if(r&&e){const f=`${e}/`;i.toLowerCase().startsWith(f.toLowerCase())&&(o=i.substring(f.length))}const c=e?n.filter(f=>f.provider===e):n,{model:u,thinkingLevel:p,warning:d}=b(o,c,{allowInvalidThinkingLevelFallback:!1});if(u)return{model:u,thinkingLevel:p,warning:d,error:void 0};if(s){const f=i.toLowerCase(),g=n.find($=>$.id.toLowerCase()===f||`${$.provider}/${$.id}`.toLowerCase()===f);if(g)return{model:g,warning:void 0,thinkingLevel:void 0,error:void 0};const m=b(i,n,{allowInvalidThinkingLevelFallback:!1});if(m.model)return{model:m.model,thinkingLevel:m.thinkingLevel,warning:m.warning,error:void 0}}if(e){const f=U(e,o,n);if(f){const g=d?`${d} Model "${o}" not found for provider "${e}". Using custom model id.`:`Model "${o}" not found for provider "${e}". Using custom model id.`;return{model:f,thinkingLevel:void 0,warning:g,error:void 0}}}const k=e?`${e}/${o}`:i;return{model:void 0,thinkingLevel:void 0,warning:d,error:`Model "${k}" not found. Use --list-models to see available models.`}}h(T,"resolveCliModel");async function j(t){const{cliProvider:r,cliModel:i,scopedModels:l,isContinuing:n,defaultProvider:a,defaultModelId:e,defaultThinkingLevel:o,modelRegistry:s}=t;let c,u=w;if(r&&i){const d=T({cliProvider:r,cliModel:i,modelRegistry:s});if(d.error&&(console.error(v.red(d.error)),process.exit(1)),d.model)return{model:d.model,thinkingLevel:w,fallbackMessage:void 0}}if(l.length>0&&!n)return{model:l[0].model,thinkingLevel:l[0].thinkingLevel??o??w,fallbackMessage:void 0};if(a&&e){const d=s.find(a,e);if(d)return c=d,o&&(u=o),{model:c,thinkingLevel:u,fallbackMessage:void 0}}const p=await s.getAvailable();if(p.length>0){for(const d of Object.keys(L)){const k=L[d],f=p.find(g=>g.provider===d&&g.id===k);if(f)return{model:f,thinkingLevel:w,fallbackMessage:void 0}}return{model:p[0],thinkingLevel:w,fallbackMessage:void 0}}return{model:void 0,thinkingLevel:w,fallbackMessage:void 0}}h(j,"findInitialModel");async function V(t,r,i,l,n){const a=n.find(t,r),e=a?n.hasConfiguredAuth(a):!1;if(a&&e)return l&&console.log(v.dim(`Restored model: ${t}/${r}`)),{model:a,fallbackMessage:void 0};const o=a?"no auth configured":"model no longer exists";if(l&&console.error(v.yellow(`Warning: Could not restore model ${t}/${r} (${o}).`)),i)return l&&console.log(v.dim(`Falling back to: ${i.provider}/${i.id}`)),{model:i,fallbackMessage:`Could not restore model ${t}/${r} (${o}). Using ${i.provider}/${i.id}.`};const s=await n.getAvailable();if(s.length>0){let c;for(const u of Object.keys(L)){const p=L[u],d=s.find(k=>k.provider===u&&k.id===p);if(d){c=d;break}}return c||(c=s[0]),l&&console.log(v.dim(`Falling back to: ${c.provider}/${c.id}`)),{model:c,fallbackMessage:`Could not restore model ${t}/${r} (${o}). Using ${c.provider}/${c.id}.`}}return{model:void 0,fallbackMessage:void 0}}h(V,"restoreModelFromSession");export{L as defaultModelPerProvider,F as findExactModelReferenceMatch,j as findInitialModel,b as parseModelPattern,T as resolveCliModel,R as resolveModelScope,V as restoreModelFromSession};

package/dist/core/output-guard.d.ts

@@ -0,0 +1,6 @@
+export declare function takeOverStdout(): void;
+export declare function restoreStdout(): void;
+export declare function isStdoutTakenOver(): boolean;
+export declare function writeRawStdout(text: string): void;
+export declare function waitForRawStdoutBackpressure(): Promise<void>;
+export declare function flushRawStdout(): Promise<void>;

package/dist/core/output-guard.js

@@ -0,0 +1 @@
+var d=Object.defineProperty;var o=(r,e)=>d(r,"name",{value:e,configurable:!0});let i;const p=10;let s=Promise.resolve();function w(){return i?i.rawStdoutWrite:process.stdout.write.bind(process.stdout)}o(w,"getRawStdoutWrite");async function c(r){for(;;)try{await new Promise((e,n)=>{try{w()(r,t=>{t?n(t):e()})}catch(t){n(t instanceof Error?t:new Error(String(t)))}});return}catch(e){const n=e instanceof Error?e:new Error(String(e)),t=n.code;if(t!=="ENOBUFS"&&t!=="EAGAIN"&&t!=="EWOULDBLOCK")throw n;await new Promise(u=>setTimeout(u,10))}}o(c,"writeRawStdoutChunk");function E(){if(i)return;const r=process.stdout.write.bind(process.stdout),e=process.stderr.write.bind(process.stderr),n=process.stdout.write;process.stdout.write=((t,u,a)=>typeof u=="function"?e(String(t),u):e(String(t),a)),i={rawStdoutWrite:r,rawStderrWrite:e,originalStdoutWrite:n}}o(E,"takeOverStdout");function R(){i&&(process.stdout.write=i.originalStdoutWrite,i=void 0)}o(R,"restoreStdout");function l(){return i!==void 0}o(l,"isStdoutTakenOver");function T(r){r.length!==0&&(s=s.then(()=>c(r)),s.catch(()=>{process.exit(1)}))}o(T,"writeRawStdout");async function S(){for(;;){const r=s;if(await r,r===s)return}}o(S,"waitForRawStdoutBackpressure");async function W(){await S(),await c("")}o(W,"flushRawStdout");export{W as flushRawStdout,l as isStdoutTakenOver,R as restoreStdout,E as takeOverStdout,S as waitForRawStdoutBackpressure,T as writeRawStdout};

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

@@ -0,0 +1,203 @@
+import type { SettingsManager } from "./settings-manager.ts";
+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 PackageUpdate {
+    source: string;
+    displayName: string;
+    type: "npm" | "git";
+    scope: Exclude<SourceScope, "temporary">;
+}
+export interface ConfiguredPackage {
+    source: string;
+    scope: "user" | "project";
+    filtered: boolean;
+    installedPath?: string;
+}
+export interface PackageManager {
+    resolve(onMissing?: (source: string) => Promise<MissingSourceAction>): Promise<ResolvedPaths>;
+    install(source: string, options?: {
+        local?: boolean;
+    }): Promise<void>;
+    installAndPersist(source: string, options?: {
+        local?: boolean;
+    }): Promise<void>;
+    remove(source: string, options?: {
+        local?: boolean;
+    }): Promise<void>;
+    removeAndPersist(source: string, options?: {
+        local?: boolean;
+    }): Promise<boolean>;
+    update(source?: string): Promise<void>;
+    listConfiguredPackages(): ConfiguredPackage[];
+    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 globalNpmRootCommandKey;
+    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>;
+    listConfiguredPackages(): ConfiguredPackage[];
+    install(source: string, options?: {
+        local?: boolean;
+    }): Promise<void>;
+    installAndPersist(source: string, options?: {
+        local?: boolean;
+    }): Promise<void>;
+    remove(source: string, options?: {
+        local?: boolean;
+    }): Promise<void>;
+    removeAndPersist(source: string, options?: {
+        local?: boolean;
+    }): Promise<boolean>;
+    update(source?: string): Promise<void>;
+    private updateConfiguredSources;
+    private shouldUpdateNpmSource;
+    private updateNpmBatch;
+    private installNpmBatch;
+    checkForAvailableUpdates(): Promise<PackageUpdate[]>;
+    private resolvePackageSources;
+    private resolveLocalExtensionSource;
+    private installParsedSource;
+    private getPackageSourceString;
+    private getSourceMatchKeyForInput;
+    private getSourceMatchKeyForSettings;
+    private buildNoMatchingPackageMessage;
+    private findSuggestedConfiguredSource;
+    private packageSourcesMatch;
+    private normalizePackageSourceForSettings;
+    private parseSource;
+    private installedNpmMatchesPinnedVersion;
+    private npmHasAvailableUpdate;
+    private getInstalledNpmVersion;
+    private getLatestNpmVersion;
+    private gitHasAvailableUpdate;
+    private getRemoteGitHead;
+    private getLocalGitUpdateTarget;
+    private getGitUpstreamRef;
+    private runGitRemoteCommand;
+    private runWithConcurrency;
+    /**
+     * 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 getNpmCommand;
+    private getPackageManagerName;
+    private runNpmCommand;
+    private getGitDependencyInstallArgs;
+    private runNpmCommandSync;
+    private getNpmInstallArgs;
+    private installNpm;
+    private uninstallNpm;
+    private installGit;
+    private updateGit;
+    private ensureGitRef;
+    private refreshTemporaryGitSource;
+    private removeGit;
+    private pruneEmptyGitParents;
+    private ensureNpmProject;
+    private ensureGitIgnore;
+    private getNpmInstallRoot;
+    private getGlobalNpmRoot;
+    private getPnpmGlobalPackagePath;
+    private getManagedNpmInstallPath;
+    private getLegacyGlobalNpmInstallPath;
+    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 spawnCommand;
+    private spawnCaptureCommand;
+    private runCommandCapture;
+    private runCommand;
+    private runCommandSync;
+}
+export {};

package/dist/core/package-manager.js

@@ -0,0 +1,3 @@
+var ut=Object.defineProperty;var f=(c,t)=>ut(c,"name",{value:t,configurable:!0});import{createHash as ht}from"node:crypto";import{existsSync as m,mkdirSync as O,readdirSync as E,readFileSync as I,rmSync as q,statSync as v,writeFileSync as Q}from"node:fs";import{homedir as pt,tmpdir as mt}from"node:os";function _(){if(process.platform!=="linux"||Object.keys(process.env).length>0)return process.env;try{const c=I("/proc/self/environ","utf-8"),t={};for(const e of c.split("\0")){const s=e.indexOf("=");s>0&&(t[e.slice(0,s)]=e.slice(s+1))}return t}catch{return process.env}}f(_,"getEnv");import{basename as G,dirname as P,join as p,relative as w,resolve as N,sep as ft}from"node:path";import{globSync as gt}from"glob";import $ from"ignore";import{minimatch as F}from"minimatch";import{CONFIG_DIR_NAME as b}from"../config.js";import{spawnProcess as X,spawnProcessSync as dt}from"../utils/child-process.js";import{parseGitUrl as yt}from"../utils/git.js";import{canonicalizePath as Pt,isLocalPath as wt,markPathIgnoredByCloudSync as kt,resolvePath as A}from"../utils/paths.js";import{isStdoutTakenOver as St}from"./output-guard.js";const S=1e4,Z=4,vt=4;function C(){const c=process.env.KODA_OFFLINE;return c?c==="1"||c.toLowerCase()==="true"||c.toLowerCase()==="yes":!1}f(C,"isOfflineModeEnabled");function tt(c){return c.origin==="package"?4:(c.scope==="project"?0:2)+(c.source==="local"?0:1)}f(tt,"resourcePrecedenceRank");const j=["extensions","skills","prompts","themes"],Nt={extensions:/\.(ts|js)$/,skills:/\.md$/,prompts:/\.md$/,themes:/\.json$/},Ct=[".gitignore",".ignore",".fdignore"];function d(c){return c.split(ft).join("/")}f(d,"toPosixPath");function V(){return process.env.HOME||pt()}f(V,"getHomeDir");function Mt(c,t){const e=c.trim();if(!e||e.startsWith("#")&&!e.startsWith("\\#"))return null;let s=c,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}f(Mt,"prefixIgnorePattern");function R(c,t,e){const s=w(e,t),n=s?`${d(s)}/`:"";for(const r of Ct){const i=p(t,r);if(m(i))try{const a=I(i,"utf-8").split(/\r?\n/).map(l=>Mt(l,n)).filter(l=>!!l);a.length>0&&c.add(a)}catch{}}}f(R,"addIgnoreRules");function Et(c){return c.startsWith("!")||c.startsWith("+")||c.startsWith("-")||c.includes("*")||c.includes("?")}f(Et,"isPattern");function B(c){return c.startsWith("!")||c.startsWith("+")||c.startsWith("-")}f(B,"isOverridePattern");function Ft(c){return c.includes("*")||c.includes("?")}f(Ft,"hasGlobPattern");function bt(c){const t=[],e=[];for(const s of c)Et(s)?e.push(s):t.push(s);return{plain:t,patterns:e}}f(bt,"splitPatterns");function et(c,t,e=!0,s,n){const r=[];if(!m(c))return r;const i=n??c,o=s??$();R(o,c,i);try{const a=E(c,{withFileTypes:!0});for(const l of a){if(l.name.startsWith(".")||e&&l.name==="node_modules")continue;const h=p(c,l.name);let u=l.isDirectory(),g=l.isFile();if(l.isSymbolicLink())try{const x=v(h);u=x.isDirectory(),g=x.isFile()}catch{continue}const k=d(w(i,h)),y=u?`${k}/`:k;o.ignores(y)||(u?r.push(...et(h,t,e,o,i)):g&&t.test(l.name)&&r.push(h))}}catch{}return r}f(et,"collectFiles");function J(c,t,e,s){const n=[];if(!m(c))return n;const r=s??c,i=e??$();R(i,c,r);try{const o=E(c,{withFileTypes:!0});for(const a of o){if(a.name!=="SKILL.md")continue;const l=p(c,a.name);let h=a.isFile();if(a.isSymbolicLink())try{h=v(l).isFile()}catch{continue}const u=d(w(r,l));if(h&&!i.ignores(u))return n.push(l),n}for(const a of o){if(a.name.startsWith(".")||a.name==="node_modules")continue;const l=p(c,a.name);let h=a.isDirectory(),u=a.isFile();if(a.isSymbolicLink())try{const k=v(l);h=k.isDirectory(),u=k.isFile()}catch{continue}const g=d(w(r,l));if(t==="pi"&&c===r&&u&&a.name.endsWith(".md")&&!i.ignores(g)){n.push(l);continue}h&&(i.ignores(`${g}/`)||n.push(...J(l,t,i,r)))}}catch{}return n}f(J,"collectSkillEntries");function W(c,t){return J(c,t)}f(W,"collectAutoSkillEntries");function xt(c){let t=N(c);for(;;){if(m(p(t,".git")))return t;const e=P(t);if(e===t)return null;t=e}}f(xt,"findGitRepoRoot");function It(c){const t=[],e=N(c),s=xt(e);let n=e;for(;t.push(p(n,".agents","skills")),!(s&&n===s);){const r=P(n);if(r===n)break;n=r}return t}f(It,"collectAncestorAgentsSkillDirs");function st(c){const t=[];if(!m(c))return t;const e=$();R(e,c,c);try{const s=E(c,{withFileTypes:!0});for(const n of s){if(n.name.startsWith(".")||n.name==="node_modules")continue;const r=p(c,n.name);let i=n.isFile();if(n.isSymbolicLink())try{i=v(r).isFile()}catch{continue}const o=d(w(c,r));e.ignores(o)||i&&n.name.endsWith(".md")&&t.push(r)}}catch{}return t}f(st,"collectAutoPromptEntries");function nt(c){const t=[];if(!m(c))return t;const e=$();R(e,c,c);try{const s=E(c,{withFileTypes:!0});for(const n of s){if(n.name.startsWith(".")||n.name==="node_modules")continue;const r=p(c,n.name);let i=n.isFile();if(n.isSymbolicLink())try{i=v(r).isFile()}catch{continue}const o=d(w(c,r));e.ignores(o)||i&&n.name.endsWith(".json")&&t.push(r)}}catch{}return t}f(nt,"collectAutoThemeEntries");function $t(c){try{const t=I(c,"utf-8");return JSON.parse(t).pi??null}catch{return null}}f($t,"readPiManifestFile");function rt(c){const t=p(c,"package.json");if(m(t)){const n=$t(t);if(n?.extensions?.length){const r=[];for(const i of n.extensions){const o=N(c,i);m(o)&&r.push(o)}if(r.length>0)return r}}const e=p(c,"index.ts"),s=p(c,"index.js");return m(e)?[e]:m(s)?[s]:null}f(rt,"resolveExtensionEntries");function K(c){const t=[];if(!m(c))return t;const e=rt(c);if(e)return e;const s=$();R(s,c,c);try{const n=E(c,{withFileTypes:!0});for(const r of n){if(r.name.startsWith(".")||r.name==="node_modules")continue;const i=p(c,r.name);let o=r.isDirectory(),a=r.isFile();if(r.isSymbolicLink())try{const u=v(i);o=u.isDirectory(),a=u.isFile()}catch{continue}const l=d(w(c,i)),h=o?`${l}/`:l;if(!s.ignores(h)){if(a&&(r.name.endsWith(".ts")||r.name.endsWith(".js")))t.push(i);else if(o){const u=rt(i);u&&t.push(...u)}}}}catch{}return t}f(K,"collectAutoExtensionEntries");function T(c,t){return t==="skills"?J(c,"pi"):t==="extensions"?K(c):et(c,Nt[t])}f(T,"collectResourceFiles");function z(c,t,e){const s=d(w(e,c)),n=G(c),r=d(c),i=n==="SKILL.md",o=i?P(c):void 0,a=i?d(w(e,o)):void 0,l=i?G(o):void 0,h=i?d(o):void 0;return t.some(u=>{const g=d(u);return F(s,g)||F(n,g)||F(r,g)?!0:i?F(a,g)||F(l,g)||F(h,g):!1})}f(z,"matchesAnyPattern");function Rt(c){const t=c.startsWith("./")||c.startsWith(".\\")?c.slice(2):c;return d(t)}f(Rt,"normalizeExactPattern");function U(c,t,e){if(t.length===0)return!1;const s=d(w(e,c)),n=G(c),r=d(c),i=n==="SKILL.md",o=i?P(c):void 0,a=i?d(w(e,o)):void 0,l=i?d(o):void 0;return t.some(h=>{const u=Rt(h);return u===s||u===r?!0:i?u===a||u===l:!1})}f(U,"matchesAnyExactPattern");function Dt(c){return c.filter(t=>t.startsWith("!")||t.startsWith("+")||t.startsWith("-"))}f(Dt,"getOverridePatterns");function Gt(c,t,e){const s=Dt(t),n=s.filter(a=>a.startsWith("!")).map(a=>a.slice(1)),r=s.filter(a=>a.startsWith("+")).map(a=>a.slice(1)),i=s.filter(a=>a.startsWith("-")).map(a=>a.slice(1));let o=!0;return n.length>0&&z(c,n,e)&&(o=!1),r.length>0&&U(c,r,e)&&(o=!0),i.length>0&&U(c,i,e)&&(o=!1),o}f(Gt,"isEnabledByOverrides");function H(c,t,e){const s=[],n=[],r=[],i=[];for(const a of t)a.startsWith("+")?r.push(a.slice(1)):a.startsWith("-")?i.push(a.slice(1)):a.startsWith("!")?n.push(a.slice(1)):s.push(a);let o;if(s.length===0?o=[...c]:o=c.filter(a=>z(a,s,e)),n.length>0&&(o=o.filter(a=>!z(a,n,e))),r.length>0)for(const a of c)!o.includes(a)&&U(a,r,e)&&o.push(a);return i.length>0&&(o=o.filter(a=>!U(a,i,e))),new Set(o)}f(H,"applyPatterns");class zt{static{f(this,"DefaultPackageManager")}cwd;agentDir;settingsManager;globalNpmRoot;globalNpmRootCommandKey;progressCallback;constructor(t){this.cwd=A(t.cwd),this.agentDir=A(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),o=r.findIndex(l=>this.packageSourcesMatch(l,t,s));if(o!==-1){const l=r[o];if(this.getPackageSourceString(l)===i)return!1;const h=[...r];return h[o]=typeof l=="string"?i:{...l,source:i},s==="project"?this.settingsManager.setProjectPackages(h):this.settingsManager.setPackages(h),!0}const a=[...r,i];return s==="project"?this.settingsManager.setProjectPackages(a):this.settingsManager.setPackages(a),!0}removeSourceFromSettings(t,e){const s=e?.local?"project":"user",r=(s==="project"?this.settingsManager.getProjectSettings():this.settingsManager.getGlobalSettings()).packages??[],i=r.filter(a=>!this.packageSourcesMatch(a,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 m(n)?n:void 0}if(s.type==="git"){const n=this.getGitInstallPath(s,e);return m(n)?n:void 0}if(s.type==="local"){const n=this.getBaseDirForScope(e),r=this.resolvePathFromBase(s.path,n);return m(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 o=this.agentDir,a=p(this.cwd,b);for(const l of j){const h=this.getTargetMap(e,l),u=s[l]??[],g=n[l]??[];this.resolveLocalEntries(g,l,h,{source:"local",scope:"project",origin:"top-level"},a),this.resolveLocalEntries(u,l,h,{source:"local",scope:"user",origin:"top-level"},o)}return this.addAutoDiscoveredResources(e,s,n,o,a),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)}listConfiguredPackages(){const t=this.settingsManager.getGlobalSettings(),e=this.settingsManager.getProjectSettings(),s=[];for(const n of t.packages??[]){const r=typeof n=="string"?n:n.source;s.push({source:r,scope:"user",filtered:typeof n=="object",installedPath:this.getInstalledPath(r,"user")})}for(const n of e.packages??[]){const r=typeof n=="string"?n:n.source;s.push({source:r,scope:"project",filtered:typeof n=="object",installedPath:this.getInstalledPath(r,"project")})}return 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(!m(r))throw new Error(`Path does not exist: ${r}`);return}throw new Error(`Unsupported install source: ${t}`)})}async installAndPersist(t,e){await this.install(t,e),this.addSourceToSettings(t,e)}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 removeAndPersist(t,e){return await this.remove(t,e),this.removeSourceFromSettings(t,e)}async update(t){const e=this.settingsManager.getGlobalSettings(),s=this.settingsManager.getProjectSettings(),n=t?this.getPackageIdentity(t):void 0;let r=!1;const i=[];for(const o of e.packages??[]){const a=typeof o=="string"?o:o.source;n&&this.getPackageIdentity(a,"user")!==n||(r=!0,i.push({source:a,scope:"user"}))}for(const o of s.packages??[]){const a=typeof o=="string"?o:o.source;n&&this.getPackageIdentity(a,"project")!==n||(r=!0,i.push({source:a,scope:"project"}))}if(t&&!r)throw new Error(this.buildNoMatchingPackageMessage(t,[...e.packages??[],...s.packages??[]]));await this.updateConfiguredSources(i)}async updateConfiguredSources(t){if(C()||t.length===0)return;const e=[],s=[];for(const l of t){const h=this.parseSource(l.source);h.type==="npm"?h.pinned||e.push({...l,parsed:h}):h.type==="git"&&s.push({...l,parsed:h})}const n=e.map(l=>async()=>({entry:l,shouldUpdate:await this.shouldUpdateNpmSource(l.parsed,l.scope)})),r=await this.runWithConcurrency(n,Z),i=[],o=[];for(const l of r)l.shouldUpdate&&(l.entry.scope==="user"?i.push(l.entry):o.push(l.entry));const a=[];if(i.length>0&&a.push(this.updateNpmBatch(i,"user")),o.length>0&&a.push(this.updateNpmBatch(o,"project")),s.length>0){const l=s.map(h=>async()=>this.withProgress("update",h.source,`Updating ${h.source}...`,async()=>{await this.updateGit(h.parsed,h.scope)}));a.push(this.runWithConcurrency(l,vt).then(()=>{}))}await Promise.all(a)}async shouldUpdateNpmSource(t,e){const s=this.getManagedNpmInstallPath(t,e),n=m(s)?this.getInstalledNpmVersion(s):void 0;if(!n)return!0;try{return await this.getLatestNpmVersion(t.name)!==n}catch{return!0}}async updateNpmBatch(t,e){if(t.length===0)return;const s=t.length===1?t[0].source:`${e} npm packages`,n=t.length===1?`Updating ${t[0].source}...`:`Updating ${e} npm packages...`,r=t.map(i=>`${i.parsed.name}@latest`);await this.withProgress("update",s,n,async()=>{await this.installNpmBatch(r,e)})}async installNpmBatch(t,e){const s=this.getNpmInstallRoot(e,!1);this.ensureNpmProject(s),await this.runNpmCommand(this.getNpmInstallArgs(t,s))}async checkForAvailableUpdates(){if(C())return[];const t=this.settingsManager.getGlobalSettings(),e=this.settingsManager.getProjectSettings(),s=[];for(const o of e.packages??[])s.push({pkg:o,scope:"project"});for(const o of t.packages??[])s.push({pkg:o,scope:"user"});const r=this.dedupePackages(s).filter(o=>o.scope!=="temporary").map(o=>async()=>{const a=typeof o.pkg=="string"?o.pkg:o.pkg.source,l=this.parseSource(a);if(l.type==="local"||l.pinned)return;if(l.type==="npm"){const g=this.getNpmInstallPath(l,o.scope);return!m(g)||!await this.npmHasAvailableUpdate(l,g)?void 0:{source:a,displayName:l.name,type:"npm",scope:o.scope}}const h=this.getGitInstallPath(l,o.scope);if(!(!m(h)||!await this.gitHasAvailableUpdate(h)))return{source:a,displayName:`${l.host}/${l.path}`,type:"git",scope:o.scope}});return(await this.runWithConcurrency(r,Z)).filter(o=>o!==void 0)}async resolvePackageSources(t,e,s){for(const{pkg:n,scope:r}of t){const i=typeof n=="string"?n:n.source,o=typeof n=="object"?n:void 0,a=this.parseSource(i),l={source:i,scope:r,origin:"package"};if(a.type==="local"){const u=this.getBaseDirForScope(r);this.resolveLocalExtensionSource(a,e,o,l,u);continue}const h=f(async()=>{if(C())return!1;if(!s)return await this.installParsedSource(a,r),!0;const u=await s(i);if(u==="skip")return!1;if(u==="error")throw new Error(`Missing source: ${i}`);return await this.installParsedSource(a,r),!0},"installMissing");if(a.type==="npm"){let u=this.getNpmInstallPath(a,r);if(!m(u)||a.pinned&&!await this.installedNpmMatchesPinnedVersion(a,u)){if(!await h())continue;u=this.getNpmInstallPath(a,r)}l.baseDir=u,this.collectPackageResources(u,e,o,l);continue}if(a.type==="git"){const u=this.getGitInstallPath(a,r);if(m(u))r==="temporary"&&!a.pinned&&!C()&&await this.refreshTemporaryGitSource(a,i);else if(!await h())continue;l.baseDir=u,this.collectPackageResources(u,e,o,l)}}}resolveLocalExtensionSource(t,e,s,n,r){const i=this.resolvePathFromBase(t.path,r);if(m(i))try{const o=v(i);if(o.isFile()){n.baseDir=P(i),this.addResource(e.extensions,i,n,!0);return}o.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)}`}buildNoMatchingPackageMessage(t,e){const s=this.findSuggestedConfiguredSource(t,e);return s?`No matching package found for ${t}. Did you mean ${s}?`:`No matching package found for ${t}`}findSuggestedConfiguredSource(t,e){const s=t.trim(),n=new Set;for(const r of e){const i=this.getPackageSourceString(r),o=this.parseSource(i);if(o.type==="npm"){(s===o.name||s===o.spec)&&n.add(i);continue}if(o.type==="git"){const a=`${o.host}/${o.path}`,l=o.ref?`${a}@${o.ref}`:void 0;(s===a||l&&s===l)&&n.add(i)}}return n.values().next().value}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 w(n,r)||"."}parseSource(t){if(t.startsWith("npm:")){const s=t.slice(4).trim(),{name:n,version:r}=this.parseNpmSpec(s);return{type:"npm",spec:s,name:n,pinned:!!r}}if(wt(t))return{type:"local",path:t};const e=yt(t);return e||{type:"local",path:t}}async installedNpmMatchesPinnedVersion(t,e){const s=this.getInstalledNpmVersion(e);if(!s)return!1;const{version:n}=this.parseNpmSpec(t.spec);return n?s===n:!0}async npmHasAvailableUpdate(t,e){if(C())return!1;const s=this.getInstalledNpmVersion(e);if(!s)return!1;try{return await this.getLatestNpmVersion(t.name)!==s}catch{return!1}}getInstalledNpmVersion(t){const e=p(t,"package.json");if(m(e))try{const s=I(e,"utf-8");return JSON.parse(s).version}catch{return}}async getLatestNpmVersion(t){const e=this.getNpmCommand(),n=(await this.runCommandCapture(e.command,[...e.args,"view",t,"version","--json"],{cwd:this.cwd,timeoutMs:S})).trim();if(!n)throw new Error("Empty response from npm view");return JSON.parse(n)}async gitHasAvailableUpdate(t){if(C())return!1;try{const e=await this.runCommandCapture("git",["rev-parse","HEAD"],{cwd:t,timeoutMs:S}),s=await this.getRemoteGitHead(t);return e.trim()!==s.trim()}catch{return!1}}async getRemoteGitHead(t){const e=await this.getGitUpstreamRef(t);if(e){const i=(await this.runGitRemoteCommand(t,["ls-remote","origin",e])).match(/^([0-9a-f]{40})\s+/m);if(i?.[1])return i[1]}const n=(await this.runGitRemoteCommand(t,["ls-remote","origin","HEAD"])).match(/^([0-9a-f]{40})\s+HEAD$/m);if(!n?.[1])throw new Error("Failed to determine remote HEAD");return n[1]}async getLocalGitUpdateTarget(t){try{const s=(await this.runCommandCapture("git",["rev-parse","--abbrev-ref","@{upstream}"],{cwd:t,timeoutMs:S})).trim();if(!s.startsWith("origin/"))throw new Error(`Unsupported upstream remote: ${s}`);const n=s.slice(7);if(!n)throw new Error("Missing upstream branch name");return{ref:"@{upstream}",head:await this.runCommandCapture("git",["rev-parse","@{upstream}"],{cwd:t,timeoutMs:S}),fetchArgs:["fetch","--prune","--no-tags","origin",`+refs/heads/${n}:refs/remotes/origin/${n}`]}}catch{await this.runCommand("git",["remote","set-head","origin","-a"],{cwd:t}).catch(()=>{});const e=await this.runCommandCapture("git",["rev-parse","origin/HEAD"],{cwd:t,timeoutMs:S}),n=(await this.runCommandCapture("git",["symbolic-ref","refs/remotes/origin/HEAD"],{cwd:t,timeoutMs:S}).catch(()=>"")).trim().replace(/^refs\/remotes\/origin\//,"");return n?{ref:"origin/HEAD",head:e,fetchArgs:["fetch","--prune","--no-tags","origin",`+refs/heads/${n}:refs/remotes/origin/${n}`]}:{ref:"origin/HEAD",head:e,fetchArgs:["fetch","--prune","--no-tags","origin","+HEAD:refs/remotes/origin/HEAD"]}}}async getGitUpstreamRef(t){try{const s=(await this.runCommandCapture("git",["rev-parse","--abbrev-ref","@{upstream}"],{cwd:t,timeoutMs:S})).trim();if(!s.startsWith("origin/"))return;const n=s.slice(7);return n?`refs/heads/${n}`:void 0}catch{return}}runGitRemoteCommand(t,e){return this.runCommandCapture("git",e,{cwd:t,timeoutMs:S,env:{GIT_TERMINAL_PROMPT:"0"}})}async runWithConcurrency(t,e){if(t.length===0)return[];const s=new Array(t.length);let n=0;const r=Math.max(1,Math.min(e,t.length)),i=f(async()=>{for(;;){const o=n;if(n+=1,o>=t.length)return;s[o]=await t[o]()}},"worker");return await Promise.all(Array.from({length:r},()=>i())),s}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}}getNpmCommand(){const t=this.settingsManager.getNpmCommand();if(!t||t.length===0)return{command:"npm",args:[]};const[e,...s]=t;if(!e)throw new Error("Invalid npmCommand: first array entry must be a non-empty command");return{command:e,args:s}}getPackageManagerName(){const t=this.getNpmCommand(),e=[t.command,...t.args],s=e.lastIndexOf("--"),n=s>=0?e[s+1]:t.command;return n?G(n).replace(/\.(cmd|exe)$/i,""):""}async runNpmCommand(t,e){const s=this.getNpmCommand();await this.runCommand(s.command,[...s.args,...t],e)}getGitDependencyInstallArgs(){const t=this.settingsManager.getNpmCommand();return t&&t.length>0?["install"]:["install","--omit=dev"]}runNpmCommandSync(t){const e=this.getNpmCommand();return this.runCommandSync(e.command,[...e.args,...t])}getNpmInstallArgs(t,e){const s=this.getPackageManagerName();return s==="bun"?["install",...t,"--cwd",e,"--omit=peer"]:s==="pnpm"?["install",...t,"--prefix",e,"--config.auto-install-peers=false","--config.strict-peer-dependencies=false","--config.strict-dep-builds=false"]:["install",...t,"--prefix",e,"--legacy-peer-deps"]}async installNpm(t,e,s){const n=this.getNpmInstallRoot(e,s);this.ensureNpmProject(n),await this.runNpmCommand(this.getNpmInstallArgs([t.spec],n))}async uninstallNpm(t,e){const s=this.getNpmInstallRoot(e,!1);if(m(s)){if(this.getPackageManagerName()==="bun"){await this.runNpmCommand(["uninstall",t.name,"--cwd",s]);return}await this.runNpmCommand(["uninstall",t.name,"--prefix",s])}}async installGit(t,e){const s=this.getGitInstallPath(t,e);if(m(s)){if(t.ref){await this.ensureGitRef(s,["fetch","origin",t.ref],"FETCH_HEAD");return}const i=await this.getLocalGitUpdateTarget(s);await this.ensureGitRef(s,i.fetchArgs,i.ref);return}const n=this.getGitInstallRoot(e);n&&this.ensureGitIgnore(n),O(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=p(s,"package.json");m(r)&&await this.runNpmCommand(this.getGitDependencyInstallArgs(),{cwd:s})}async updateGit(t,e){const s=this.getGitInstallPath(t,e);if(!m(s)){await this.installGit(t,e);return}if(t.ref){await this.ensureGitRef(s,["fetch","origin",t.ref],"FETCH_HEAD");return}const n=await this.getLocalGitUpdateTarget(s);await this.ensureGitRef(s,n.fetchArgs,n.ref)}async ensureGitRef(t,e,s){await this.runCommand("git",e,{cwd:t});const n=await this.runCommandCapture("git",["rev-parse","HEAD"],{cwd:t,timeoutMs:S}),r=`${s}^{commit}`,i=await this.runCommandCapture("git",["rev-parse",r],{cwd:t,timeoutMs:S});if(n.trim()===i.trim())return;await this.runCommand("git",["reset","--hard",r],{cwd:t}),await this.runCommand("git",["clean","-fdx"],{cwd:t});const o=p(t,"package.json");m(o)&&await this.runNpmCommand(this.getGitDependencyInstallArgs(),{cwd:t})}async refreshTemporaryGitSource(t,e){if(!C())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);m(s)&&(q(s,{recursive:!0,force:!0}),this.pruneEmptyGitParents(s,this.getGitInstallRoot(e)))}pruneEmptyGitParents(t,e){if(!e)return;const s=N(e);let n=P(t);for(;n.startsWith(s)&&n!==s;){if(!m(n)){n=P(n);continue}if(E(n).length>0)break;try{q(n,{recursive:!0,force:!0})}catch{break}n=P(n)}}ensureNpmProject(t){m(t)||O(t,{recursive:!0}),kt(t),this.ensureGitIgnore(t);const e=p(t,"package.json");m(e)||Q(e,JSON.stringify({name:"pi-extensions",private:!0},null,2),"utf-8")}ensureGitIgnore(t){m(t)||O(t,{recursive:!0});const e=p(t,".gitignore");m(e)||Q(e,`*
+!.gitignore
+`,"utf-8")}getNpmInstallRoot(t,e){return e?this.getTemporaryDir("npm"):t==="project"?p(this.cwd,b,"npm"):p(this.agentDir,"npm")}getGlobalNpmRoot(){const t=this.getNpmCommand(),e=[t.command,...t.args].join("\0");if(this.globalNpmRoot&&this.globalNpmRootCommandKey===e)return this.globalNpmRoot;if(this.getPackageManagerName()==="bun"){const s=this.runNpmCommandSync(["pm","bin","-g"]).trim();this.globalNpmRoot=p(P(s),"install","global","node_modules")}else this.globalNpmRoot=this.runNpmCommandSync(["root","-g"]).trim();return this.globalNpmRootCommandKey=e,this.globalNpmRoot}getPnpmGlobalPackagePath(t){if(this.getPackageManagerName()!=="pnpm")return;const e=this.runNpmCommandSync(["list","-g","--depth","0","--json"]),s=JSON.parse(e);for(const n of s){const r=n.dependencies?.[t]?.path;if(r)return r}}getManagedNpmInstallPath(t,e){return e==="temporary"?p(this.getTemporaryDir("npm"),"node_modules",t.name):e==="project"?p(this.cwd,b,"npm","node_modules",t.name):p(this.agentDir,"npm","node_modules",t.name)}getLegacyGlobalNpmInstallPath(t){try{return this.getPnpmGlobalPackagePath(t.name)??p(this.getGlobalNpmRoot(),t.name)}catch{return}}getNpmInstallPath(t,e){const s=this.getManagedNpmInstallPath(t,e);if(e!=="user"||m(s))return s;const n=this.getLegacyGlobalNpmInstallPath(t);return n&&m(n)?n:s}getGitInstallPath(t,e){return e==="temporary"?this.getTemporaryDir(`git-${t.host}`,t.path):e==="project"?p(this.cwd,b,"git",t.host,t.path):p(this.agentDir,"git",t.host,t.path)}getGitInstallRoot(t){if(t!=="temporary")return t==="project"?p(this.cwd,b,"git"):p(this.agentDir,"git")}getTemporaryDir(t,e){const s=ht("sha256").update(`${t}-${e??""}`).digest("hex").slice(0,8);return p(mt(),"pi-extensions",t,s,e??"")}getBaseDirForScope(t){return t==="project"?p(this.cwd,b):t==="user"?this.agentDir:this.cwd}resolvePath(t){return A(t,this.cwd,{homeDir:V(),trim:!0})}resolvePathFromBase(t,e){return A(t,e,{homeDir:V(),trim:!0})}collectPackageResources(t,e,s,n){if(s){for(const o of j){const a=s[o],l=this.getTargetMap(e,o);a!==void 0?this.applyPackageFilter(t,a,o,l,n):this.collectDefaultResources(t,o,l,n)}return!0}const r=this.readPiManifest(t);if(r){for(const o of j){const a=r[o];this.addManifestEntries(a,t,o,this.getTargetMap(e,o),n)}return!0}let i=!1;for(const o of j){const a=p(t,o);if(m(a)){const l=T(a,o);for(const h of l)this.addResource(this.getTargetMap(e,o),h,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 o=p(t,e);if(m(o)){const a=T(o,e);for(const l of a)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 a of i)this.addResource(n,a,r,!1);return}const o=H(i,e,t);for(const a of i){const l=o.has(a);this.addResource(n,a,r,l)}}collectManifestFiles(t,e){const n=this.readPiManifest(t)?.[e];if(n&&n.length>0){const o=this.collectFilesFromManifestEntries(n,t,e),a=n.filter(B),l=a.length>0?H(o,a,t):new Set(o);return{allFiles:Array.from(l),enabledByManifest:l}}const r=p(t,e);if(!m(r))return{allFiles:[],enabledByManifest:new Set};const i=T(r,e);return{allFiles:i,enabledByManifest:new Set(i)}}readPiManifest(t){const e=p(t,"package.json");if(!m(e))return null;try{const s=I(e,"utf-8");return JSON.parse(s).pi??null}catch{return null}}addManifestEntries(t,e,s,n,r){if(!t)return;const i=this.collectFilesFromManifestEntries(t,e,s),o=t.filter(B),a=H(i,o,e);for(const l of i)a.has(l)&&this.addResource(n,l,r,!0)}collectFilesFromManifestEntries(t,e,s){const r=t.filter(i=>!B(i)).flatMap(i=>Ft(i)?gt(i,{cwd:e,absolute:!0,dot:!1,nodir:!1}).map(o=>N(o)):[N(e,i)]);return this.collectFilesFromPaths(r,s)}resolveLocalEntries(t,e,s,n,r){if(t.length===0)return;const{plain:i,patterns:o}=bt(t),a=i.map(u=>this.resolvePathFromBase(u,r)),l=this.collectFilesFromPaths(a,e),h=H(l,o,r);for(const u of l)this.addResource(s,u,n,h.has(u))}addAutoDiscoveredResources(t,e,s,n,r){const i={source:"auto",scope:"user",origin:"top-level",baseDir:n},o={source:"auto",scope:"project",origin:"top-level",baseDir:r},a={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??[]},h={extensions:p(n,"extensions"),skills:p(n,"skills"),prompts:p(n,"prompts"),themes:p(n,"themes")},u={extensions:p(r,"extensions"),skills:p(r,"skills"),prompts:p(r,"prompts"),themes:p(r,"themes")},g=p(V(),".agents","skills"),k=It(this.cwd).filter(M=>N(M)!==N(g)),y=f((M,D,L,ot,at)=>{const ct=this.getTargetMap(t,M);for(const Y of D){const lt=Gt(Y,ot,at);this.addResource(ct,Y,L,lt)}},"addResources");y("extensions",K(u.extensions),o,l.extensions,r),y("skills",W(u.skills,"pi"),o,l.skills,r);for(const M of k){const D=P(M),L={...o,baseDir:D};y("skills",W(M,"agents"),L,l.skills,D)}y("prompts",st(u.prompts),o,l.prompts,r),y("themes",nt(u.themes),o,l.themes,r),y("extensions",K(h.extensions),i,a.extensions,n),y("skills",W(h.skills,"pi"),i,a.skills,n);const x=P(g),it={...i,baseDir:x};y("skills",W(g,"agents"),it,a.skills,x),y("prompts",st(h.prompts),i,a.prompts,n),y("themes",nt(h.themes),i,a.themes,n)}collectFilesFromPaths(t,e){const s=[];for(const n of t)if(m(n))try{const r=v(n);r.isFile()?s.push(n):r.isDirectory()&&s.push(...T(n,e))}catch{}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=f(s=>{const n=Array.from(s.entries()).map(([i,{metadata:o,enabled:a}])=>({path:i,enabled:a,metadata:o}));n.sort((i,o)=>tt(i.metadata)-tt(o.metadata));const r=new Set;return n.filter(i=>{const o=Pt(i.path);return r.has(o)?!1:(r.add(o),!0)})},"mapToResolved");return{extensions:e(t.extensions),skills:e(t.skills),prompts:e(t.prompts),themes:e(t.themes)}}spawnCommand(t,e,s){const n=_();return X(t,e,{cwd:s?.cwd,stdio:St()?["ignore",2,2]:"inherit",env:n})}spawnCaptureCommand(t,e,s){const n=_(),r=s?.env?{...n,...s.env}:n;return X(t,e,{cwd:s?.cwd,stdio:["ignore","pipe","pipe"],env:r})}runCommandCapture(t,e,s){return new Promise((n,r)=>{const i=this.spawnCaptureCommand(t,e,s);let o="",a="",l=!1;const h=typeof s?.timeoutMs=="number"?setTimeout(()=>{l=!0,i.kill()},s.timeoutMs):void 0;i.stdout?.on("data",u=>{o+=u.toString()}),i.stderr?.on("data",u=>{a+=u.toString()}),i.once("error",u=>{h&&clearTimeout(h),r(u)}),i.once("close",(u,g)=>{if(h&&clearTimeout(h),l){r(new Error(`${t} ${e.join(" ")} timed out after ${s?.timeoutMs}ms`));return}if(u===0){n(o.trim());return}const k=u===null?`signal ${g??"unknown"}`:`code ${u}`;r(new Error(`${t} ${e.join(" ")} failed with ${k}: ${a||o}`))})})}runCommand(t,e,s){return new Promise((n,r)=>{const i=this.spawnCommand(t,e,s);i.on("error",r),i.on("exit",o=>{o===0?n():r(new Error(`${t} ${e.join(" ")} failed with code ${o}`))})})}runCommandSync(t,e){const s=_(),n=dt(t,e,{stdio:["ignore","pipe","pipe"],encoding:"utf-8",env:s});if(n.error||n.status!==0)throw new Error(`Failed to run ${t} ${e.join(" ")}: ${n.error?.message||n.stderr||n.stdout}`);return(n.stdout||n.stderr||"").trim()}}export{zt as DefaultPackageManager};