@kodax-ai/kodax 0.7.39 → 0.7.41

package/dist/sdk-repl.js

@@ -1,2 +1,2 @@
 // @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
-import{$ as ko,$a as kr,A,Aa as Ro,Ab as Rr,B,Ba as So,Bb as Sr,C,Ca as To,Cb as Tr,D,Da as Uo,Db as Ur,E,Ea as Vo,Eb as Vr,F,Fa as Wo,Fb as Wr,G,Ga as Xo,Gb as Xr,H,Ha as Yo,Hb as Yr,I,Ia as Zo,Ib as Zr,J,Ja as _o,Jb as _r,K,Ka as $o,Kb as $r,L,La as or,Lb as oe,M,Ma as rr,Mb as re,N,Na as er,Nb as ee,O,Oa as fr,Ob as fe,P,Pa as mr,Pb as me,Q,Qa as pr,R,Ra as tr,S,Sa as xr,T,Ta as ar,U,Ua as br,V,Va as cr,W,Wa as dr,X,Xa as gr,Y,Ya as hr,Z,Za as ir,_ as jo,_a as jr,a as o,aa as lo,ab as lr,b as r,ba as no,bb as nr,c as e,ca as qo,cb as qr,d as f,da as so,db as sr,e as m,ea as uo,eb as ur,f as p,fa as vo,fb as vr,g as t,ga as wo,gb as wr,h as x,ha as yo,hb as yr,i as a,ia as zo,ib as zr,j as b,ja as Ao,jb as Ar,k as c,ka as Bo,kb as Br,l as d,la as Co,lb as Cr,m as g,ma as Do,mb as Dr,n as h,na as Eo,nb as Er,o as i,oa as Fo,ob as Fr,p as j,pa as Go,pb as Gr,q as k,qa as Ho,qb as Hr,r as l,ra as Io,rb as Ir,s as n,sa as Jo,sb as Jr,t as q,ta as Ko,tb as Kr,u as s,ua as Lo,ub as Lr,v as u,va as Mo,vb as Mr,w as v,wa as No,wb as Nr,x as w,xa as Oo,xb as Or,y,ya as Po,yb as Pr,z,za as Qo,zb as Qr}from"./chunks/chunk-WEEQZYZS.js";import{D as io,b as _,c as $,d as oo,e as ro,f as eo,h as fo,i as mo,j as po,k as to,u as xo,v as ao,w as bo,x as co,y as go,z as ho}from"./chunks/chunk-SF7WD7E5.js";import"./chunks/chunk-HUAU4KB3.js";import"./chunks/chunk-7LQ2NCHF.js";import"./chunks/chunk-N2VZ2MJF.js";import"./chunks/chunk-SONW6AC7.js";import"./chunks/chunk-XI75LZIO.js";import"./chunks/chunk-4E76FLZ3.js";export{Wo as App,Eo as AutocompleteContextProvider,Bo as BUILTIN_COMMANDS,qr as BackgroundTaskBar,$r as ConsoleCapturer,Q as DEFAULT_UI_STATE,ir as DialogSurface,No as DotsIndicator,me as FileSessionStorage,Yo as FullscreenTranscriptLayout,Ro as HistoryItemRenderer,Ko as InputPrompt,oo as KODAX_CONFIG_FILE,_ as KODAX_DIR,$ as KODAX_SESSIONS_DIR,po as KODAX_VERSION,U as KeyMatchers,P as KeypressHandlerPriority,I as KeypressParser,S as KeypressProvider,j as LRUCache,Qo as LoadingIndicator,Dr as MemorySessionStorage,Zo as MessageActions,So as MessageList,_o as MessageSelector,kr as NotificationsSurface,V as PERMISSION_MODES,ro as PREVIEW_MAX_LENGTH,Tr as PendingInputsIndicator,Oo as ProgressIndicator,or as PromptComposer,fr as PromptFooter,rr as PromptFooterLeftSide,er as PromptFooterRightSide,mr as PromptHelpMenu,hr as PromptSuggestionsSurface,jr as QueuedCommandsSurface,Xo as SimpleApp,Lo as SimpleInputPrompt,To as SimpleMessageDisplay,Vo as SimpleStatusBar,G as SingleLineTextInput,Mo as Spinner,nr as StashNotice,Uo as StatusBar,lr as StatusNoticesSurface,ur as StreamingProvider,M as StreamingState,gr as SuggestionsDisplay,O as TOOL_STATUS_ICONS,Io as TextBuffer,F as TextInput,Po as ThinkingIndicator,Rr as ToolCallDisplay,N as ToolCallStatus,Sr as ToolGroup,Qr as ToolProgressBar,Pr as ToolStatusBadge,$o as TranscriptViewport,ar as UIStateProvider,z as calculateVisualCursorFromLayout,y as calculateVisualLayout,uo as collectBashWriteTargets,X as computeConfirmTools,Nr as createCliEvents,tr as createHistoryItem,Br as createInteractiveContext,Or as createJsonEvents,Ar as createKeyMatcher,R as createKeypressManager,Er as createMemorySessionStorage,Kr as createRecoveryHistoryItem,Ir as createRetryHistoryItem,sr as createStreamingManager,xr as createToolCall,A as darkTheme,_r as detectTerminalCapabilities,x as detectTerminalHostProfile,t as detectTerminalRenderHost,Lr as emitRecoveryHistoryItem,Jr as emitRetryHistoryItem,Do as executeCommand,Fr as executeShellCommand,yo as extractTextContent,zo as extractTitle,Ao as formatMessagePreview,pr as generateId,no as generateSavePattern,vo as getBashOutsideProjectWriteRisk,q as getCharAtCodePoint,k as getCodePointLength,ho as getGitRoot,L as getKeyDisplayName,wo as getPlanModeBlockReason,xo as getProviderList,to as getProviderModel,g as getTerminalHostCapabilities,Yr as getTerminalWidth,D as getTheme,E as getThemeNames,mo as getVersion,n as getVisualWidth,w as getVisualWidthCached,r as hasCursorUpViewportYankRisk,f as hasMainScreenRenderScrollRisk,eo as hydrateProcessEnvFromShell,qo as isAlwaysConfirmPath,jo as isBashReadCommand,ko as isBashWriteCommand,i as isClassicReplForced,J as isFunctionKey,h as isOwnedRendererPreferred,so as isPathInsideProject,Y as isPermissionMode,K as isPrintable,ao as isProviderConfigured,e as isRemoteConptyHost,Zr as isScreenReader,Gr as isShellCommand,Hr as isShellCommandSuccess,m as isTmuxControlMode,lo as isToolCallAllowed,o as isVsCodeTerminalHostEnv,l as isWideChar,bo as loadConfig,B as minimalTheme,Z as normalizePermissionMode,Co as parseCommand,H as parseKeypress,W as permissionModeDisplayName,co as prepareRuntimeConfig,fe as processSpecialSyntax,io as rateLimitedCall,fo as registerConfiguredCustomProviders,p as resetTmuxControlModeProbeForTesting,a as resolveConfiguredTuiRendererMode,b as resolveEffectiveTuiRendererMode,d as resolveFullscreenPolicy,c as resolveInteractiveSurfacePreference,Mr as runInkInteractiveMode,ee as runInteractiveMode,go as saveConfig,s as splitByCodePoints,Vr as supports256Colors,Xr as supportsEmoji,Ur as supportsTrueColor,Wr as supportsUnicode,C as themes,Cr as touchContext,u as truncateByVisualWidth,Go as useAutocomplete,Fo as useAutocompleteContext,Ho as useInputHistory,zr as useKeypress,T as useKeypressManager,yr as useStreaming,wr as useStreamingActions,vr as useStreamingState,Jo as useTextBuffer,dr as useUI,cr as useUIActions,br as useUIState,v as visualWidthCache,oe as withCapture,re as withCaptureSync};
+import{$ as ko,$a as kr,A,Aa as Ro,Ab as Rr,B,Ba as So,Bb as Sr,C,Ca as To,Cb as Tr,D,Da as Uo,Db as Ur,E,Ea as Vo,Eb as Vr,F,Fa as Wo,Fb as Wr,G,Ga as Xo,Gb as Xr,H,Ha as Yo,Hb as Yr,I,Ia as Zo,Ib as Zr,J,Ja as _o,Jb as _r,K,Ka as $o,Kb as $r,L,La as or,Lb as oe,M,Ma as rr,Mb as re,N,Na as er,Nb as ee,O,Oa as fr,Ob as fe,P,Pa as mr,Pb as me,Q,Qa as pr,Qb as pe,R,Ra as tr,Rb as te,S,Sa as xr,Sb as xe,T,Ta as ar,U,Ua as br,V,Va as cr,W,Wa as dr,X,Xa as gr,Y,Ya as hr,Z,Za as ir,_ as jo,_a as jr,a as o,aa as lo,ab as lr,b as r,ba as no,bb as nr,c as e,ca as qo,cb as qr,d as f,da as so,db as sr,e as m,ea as uo,eb as ur,f as p,fa as vo,fb as vr,g as t,ga as wo,gb as wr,h as x,ha as yo,hb as yr,i as a,ia as zo,ib as zr,j as b,ja as Ao,jb as Ar,k as c,ka as Bo,kb as Br,l as d,la as Co,lb as Cr,m as g,ma as Do,mb as Dr,n as h,na as Eo,nb as Er,o as i,oa as Fo,ob as Fr,p as j,pa as Go,pb as Gr,q as k,qa as Ho,qb as Hr,r as l,ra as Io,rb as Ir,s as n,sa as Jo,sb as Jr,t as q,ta as Ko,tb as Kr,u as s,ua as Lo,ub as Lr,v as u,va as Mo,vb as Mr,w as v,wa as No,wb as Nr,x as w,xa as Oo,xb as Or,y,ya as Po,yb as Pr,z,za as Qo,zb as Qr}from"./chunks/chunk-ZPJPNLBK.js";import{D as io,b as _,c as $,d as oo,e as ro,f as eo,h as fo,i as mo,j as po,k as to,u as xo,v as ao,w as bo,x as co,y as go,z as ho}from"./chunks/chunk-5TFLMGER.js";import"./chunks/chunk-6OB4AJOM.js";import"./chunks/chunk-EVIDQWMF.js";import"./chunks/chunk-HYWVRTFA.js";import"./chunks/chunk-SX2IS5JP.js";import"./chunks/chunk-EQ5DGS2W.js";import"./chunks/chunk-6QO6HWGU.js";import"./chunks/chunk-V4WSBIXB.js";export{Wo as App,Eo as AutocompleteContextProvider,Bo as BUILTIN_COMMANDS,qr as BackgroundTaskBar,ee as ConsoleCapturer,Q as DEFAULT_UI_STATE,ir as DialogSurface,No as DotsIndicator,xe as FileSessionStorage,Yo as FullscreenTranscriptLayout,Ro as HistoryItemRenderer,Ko as InputPrompt,oo as KODAX_CONFIG_FILE,_ as KODAX_DIR,$ as KODAX_SESSIONS_DIR,po as KODAX_VERSION,U as KeyMatchers,P as KeypressHandlerPriority,I as KeypressParser,S as KeypressProvider,j as LRUCache,Qo as LoadingIndicator,Gr as MemorySessionStorage,Zo as MessageActions,So as MessageList,_o as MessageSelector,kr as NotificationsSurface,V as PERMISSION_MODES,ro as PREVIEW_MAX_LENGTH,Wr as PendingInputsIndicator,Oo as ProgressIndicator,or as PromptComposer,fr as PromptFooter,rr as PromptFooterLeftSide,er as PromptFooterRightSide,mr as PromptHelpMenu,hr as PromptSuggestionsSurface,jr as QueuedCommandsSurface,Xo as SimpleApp,Lo as SimpleInputPrompt,To as SimpleMessageDisplay,Vo as SimpleStatusBar,G as SingleLineTextInput,Mo as Spinner,nr as StashNotice,Uo as StatusBar,lr as StatusNoticesSurface,ur as StreamingProvider,M as StreamingState,gr as SuggestionsDisplay,O as TOOL_STATUS_ICONS,Io as TextBuffer,F as TextInput,Po as ThinkingIndicator,Ur as ToolCallDisplay,N as ToolCallStatus,Vr as ToolGroup,Tr as ToolProgressBar,Sr as ToolStatusBadge,$o as TranscriptViewport,ar as UIStateProvider,Dr as _resetQueuedPromptsCacheForTests,z as calculateVisualCursorFromLayout,y as calculateVisualLayout,uo as collectBashWriteTargets,X as computeConfirmTools,Qr as createCliEvents,tr as createHistoryItem,Er as createInteractiveContext,Rr as createJsonEvents,Ar as createKeyMatcher,R as createKeypressManager,Hr as createMemorySessionStorage,Nr as createRecoveryHistoryItem,Lr as createRetryHistoryItem,sr as createStreamingManager,xr as createToolCall,A as darkTheme,re as detectTerminalCapabilities,x as detectTerminalHostProfile,t as detectTerminalRenderHost,Or as emitRecoveryHistoryItem,Mr as emitRetryHistoryItem,Do as executeCommand,Ir as executeShellCommand,yo as extractTextContent,zo as extractTitle,Ao as formatMessagePreview,pr as generateId,no as generateSavePattern,vo as getBashOutsideProjectWriteRisk,q as getCharAtCodePoint,k as getCodePointLength,ho as getGitRoot,L as getKeyDisplayName,wo as getPlanModeBlockReason,xo as getProviderList,to as getProviderModel,g as getTerminalHostCapabilities,$r as getTerminalWidth,D as getTheme,E as getThemeNames,mo as getVersion,n as getVisualWidth,w as getVisualWidthCached,r as hasCursorUpViewportYankRisk,f as hasMainScreenRenderScrollRisk,eo as hydrateProcessEnvFromShell,qo as isAlwaysConfirmPath,jo as isBashReadCommand,ko as isBashWriteCommand,i as isClassicReplForced,J as isFunctionKey,h as isOwnedRendererPreferred,so as isPathInsideProject,Y as isPermissionMode,K as isPrintable,ao as isProviderConfigured,e as isRemoteConptyHost,oe as isScreenReader,Jr as isShellCommand,Kr as isShellCommandSuccess,m as isTmuxControlMode,lo as isToolCallAllowed,o as isVsCodeTerminalHostEnv,l as isWideChar,bo as loadConfig,B as minimalTheme,Z as normalizePermissionMode,Co as parseCommand,H as parseKeypress,W as permissionModeDisplayName,co as prepareRuntimeConfig,te as processSpecialSyntax,io as rateLimitedCall,fo as registerConfiguredCustomProviders,p as resetTmuxControlModeProbeForTesting,a as resolveConfiguredTuiRendererMode,b as resolveEffectiveTuiRendererMode,d as resolveFullscreenPolicy,c as resolveInteractiveSurfacePreference,Pr as runInkInteractiveMode,pe as runInteractiveMode,go as saveConfig,s as splitByCodePoints,Yr as supports256Colors,_r as supportsEmoji,Xr as supportsTrueColor,Zr as supportsUnicode,C as themes,Fr as touchContext,u as truncateByVisualWidth,Go as useAutocomplete,Fo as useAutocompleteContext,Ho as useInputHistory,zr as useKeypress,T as useKeypressManager,Cr as useQueuedPromptContents,Br as useQueuedPrompts,yr as useStreaming,wr as useStreamingActions,vr as useStreamingState,Jo as useTextBuffer,dr as useUI,cr as useUIActions,br as useUIState,v as visualWidthCache,fe as withCapture,me as withCaptureSync};

package/dist/sdk-skills.d.ts

@@ -1,16 +1,492 @@
 /**
- * SDK subpath entry — `@kodax-ai/kodax/skills`
+ * Agent Skills Standard Type Definitions
+ * Compliant with https://agentskills.io/ specification
  *
- * Re-exports the entire `@kodax-ai/skills` public API — skill loader,
- * resolver, registry, frontmatter parser, etc. The `@kodax-ai/skills`
- * package has zero external dependencies, making it the cheapest
- * subpath for SDK consumers to pull in.
+ * Also supports Claude Code extension fields for compatibility
+ */
+/**
+ * Skill frontmatter as defined in SKILL.md YAML header
+ */
+interface SkillFrontmatter {
+    /** Skill name in kebab-case, max 64 characters */
+    name: string;
+    /** Skill description, max 1024 characters, should include trigger conditions */
+    description: string;
+    /** Whether to disable automatic model invocation (default: false) */
+    disableModelInvocation?: boolean;
+    /** Whether skill appears in / menu (default: true) */
+    userInvocable?: boolean;
+    /** Tool restrictions, e.g., "Read, Grep, Bash(python:*)" */
+    allowedTools?: string;
+    /** Execution context - 'fork' for sub-agent execution */
+    context?: 'fork';
+    /** Sub-agent type: Explore, Plan, general-purpose, etc. */
+    agent?: string;
+    /** Argument hint for UI, e.g., "[file] [format]" */
+    argumentHint?: string;
+    /** Model preference: haiku, sonnet, opus, or a provider-specific model id */
+    model?: string;
+    /** Hooks scoped to this skill's lifecycle */
+    hooks?: SkillHooks;
+    license?: string;
+    compatibility?: string;
+    metadata?: Record<string, unknown>;
+}
+interface SkillHook {
+    matcher?: string;
+    command: string;
+}
+interface SkillHooks {
+    SessionStart?: SkillHook[];
+    UserPromptSubmit?: SkillHook[];
+    PreToolUse?: SkillHook[];
+    PostToolUse?: SkillHook[];
+    Stop?: SkillHook[];
+    SubagentStop?: SkillHook[];
+    Notification?: SkillHook[];
+}
+/**
+ * Lightweight skill metadata for system prompt injection
+ * Loaded at startup for progressive disclosure
+ */
+interface SkillMetadata {
+    name: string;
+    description: string;
+    userInvocable: boolean;
+    argumentHint?: string;
+    path: string;
+    source: SkillSource;
+    /** If true, exclude from system prompt (only invokable via /skill:name) */
+    disableModelInvocation: boolean;
+}
+/**
+ * Complete skill definition with all content loaded
+ */
+interface Skill extends SkillFrontmatter {
+    /** Skill directory absolute path */
+    path: string;
+    /** SKILL.md absolute path */
+    skillFilePath: string;
+    /** Markdown content (with variables resolved) */
+    content: string;
+    /** Raw markdown content (before variable resolution) */
+    rawContent: string;
+    /** Support files */
+    scripts?: SkillFile[];
+    references?: SkillFile[];
+    assets?: SkillFile[];
+    templates?: SkillFile[];
+    resources?: SkillFile[];
+    /** Runtime state */
+    loaded: boolean;
+    source: SkillSource;
+}
+/**
+ * File within a skill directory
+ */
+interface SkillFile {
+    name: string;
+    path: string;
+    relativePath: string;
+    content?: string;
+}
+type SkillSource = 'project' | 'user' | 'plugin' | 'builtin';
+/**
+ * Skill registry interface for managing discovered skills
+ */
+interface ISkillRegistry {
+    /** Read-only view of discovered skill metadata */
+    readonly skills: ReadonlyMap<string, SkillMetadata>;
+    /** Discover skills from all configured paths */
+    discover(): Promise<void>;
+    /** Get skill metadata by name */
+    get(name: string): SkillMetadata | undefined;
+    /** Load full skill content */
+    loadFull(name: string): Promise<Skill>;
+    /** Invoke a skill with arguments */
+    invoke(name: string, args: string, context: SkillContext): Promise<SkillResult>;
+    /** Reload skills from disk */
+    reload(): Promise<void>;
+    /** List all discovered skills */
+    list(): ReadonlyArray<SkillMetadata>;
+    /** List skills that can be invoked directly by users */
+    listUserInvocable(): ReadonlyArray<SkillMetadata>;
+    /** Check whether a skill exists */
+    has(name: string): boolean;
+    /** Number of discovered skills */
+    readonly size: number;
+}
+interface SkillContext {
+    workingDirectory: string;
+    projectRoot?: string;
+    sessionId: string;
+    environment?: Record<string, string>;
+    messages?: unknown[];
+}
+interface SkillResult {
+    success: boolean;
+    /** Processed prompt content */
+    content: string;
+    /** Generated artifacts */
+    artifacts?: SkillArtifact[];
+    error?: string;
+}
+interface SkillArtifact {
+    type: 'file' | 'code' | 'text';
+    name: string;
+    content: string;
+    path?: string;
+}
+interface IVariableResolver {
+    /** Resolve all variables in content */
+    resolve(content: string, args: string, context: SkillContext): Promise<string>;
+}
+interface SkillPathsConfig {
+    projectPaths: string[];
+    userPaths: string[];
+    pluginPaths: string[];
+    builtinPath: string;
+}
+/**
+ * Get default skill discovery paths
+ *
+ * Priority order (highest first):
+ * 1. Project - <projectRoot>/.kodax/skills/
+ * 2. User - ~/.kodax/skills/
+ * 3. User - ~/.agents/skills/ (AgentSkills standard)
+ * 4. Plugin - (dynamic)
+ * 5. Builtin - packages/skills/src/builtin/
+ */
+declare function getDefaultSkillPaths(projectRoot?: string): SkillPathsConfig;
+/**
+ * All skill paths in priority order (highest to lowest)
+ *
+ * Priority: Project > User > Plugin > Builtin
+ * - Project: Project-specific skills override everything else
+ * - User: User preferences (~/.kodax/ and ~/.agents/)
+ * - Plugin: Third-party plugins
+ * - Builtin: Default skills shipped with KodaX
+ */
+declare function getSkillPathsFlat(config: SkillPathsConfig): Array<{
+    path: string;
+    source: SkillSource;
+}>;
+
+declare function registerPluginSkillPath(skillPath: string): () => void;
+declare function unregisterPluginSkillPath(skillPath: string): boolean;
+declare function listPluginSkillPaths(): string[];
+declare function clearPluginSkillPaths(): void;
+
+/**
+ * Skill Loader - YAML Frontmatter Parsing and Skill Loading
+ *
+ * Parses SKILL.md files with YAML frontmatter and loads skill content.
+ * Implements fallback sanitization for non-standard YAML formats.
+ */
+
+/**
+ * Parse SKILL.md file with YAML frontmatter
+ */
+declare function parseSkillMarkdown(content: string): {
+    frontmatter: SkillFrontmatter;
+    body: string;
+};
+/**
+ * Load skill metadata from SKILL.md file
+ */
+declare function loadSkillMetadata(skillDir: string, source: SkillSource): Promise<SkillMetadata | null>;
+/**
+ * Load full skill content
+ */
+declare function loadFullSkill(skillDir: string, source: SkillSource): Promise<Skill | null>;
+/**
+ * Load a specific support file's content
+ */
+declare function loadSkillFileContent(file: SkillFile): Promise<string>;
+
+/**
+ * Skill Discovery - Multi-path skill scanning
+ *
+ * Discovers skills from multiple paths with priority handling.
+ * Supports nested directory discovery for monorepos.
+ */
+
+/**
+ * Result of skill discovery
+ */
+interface DiscoveryResult {
+    skills: Map<string, SkillMetadata>;
+    errors: Array<{
+        path: string;
+        error: string;
+    }>;
+}
+/**
+ * Discover all skills from configured paths
+ */
+declare function discoverSkills(projectRoot?: string, customPaths?: Partial<SkillPathsConfig>): Promise<DiscoveryResult>;
+/**
+ * Get nested skill paths for monorepo support
+ * When in a subdirectory, also check parent directories for skills
+ */
+declare function getNestedSkillPaths(currentDir: string, projectRoot: string): string[];
+/**
+ * Discover skills with monorepo support
+ */
+declare function discoverSkillsWithMonorepo(currentDir: string, projectRoot: string): Promise<DiscoveryResult>;
+
+/**
+ * Skill Resolver - Variable Replacement System
+ *
+ * Handles variable replacement in skill content:
+ * - $ARGUMENTS - All arguments
+ * - $0, $1, $2... - Positional arguments
+ * - ${VAR_NAME} - Environment variables
+ * - !`command` - Dynamic context injection
+ */
+
+/**
+ * Split arguments string into positional arguments
+ * Handles quoted strings correctly
+ */
+declare function parseArguments(args: string): string[];
+/**
+ * Variable resolver implementation
+ */
+declare class VariableResolver implements IVariableResolver {
+    private context;
+    constructor(context: SkillContext);
+    /**
+     * Resolve all variables in content
+     */
+    resolve(content: string, args: string): Promise<string>;
+    /**
+     * Replace $0, $1, $2... with positional arguments
+     */
+    private resolvePositionalArgs;
+    /**
+     * Replace $ARGUMENTS with all arguments
+     */
+    private resolveArguments;
+    /**
+     * Replace ${VAR_NAME} with environment variables
+     */
+    private resolveEnvVars;
+    /**
+     * Replace !`command` with command output (dynamic context)
+     */
+    private resolveDynamicContext;
+    /**
+     * Execute a dynamic context command
+     */
+    private executeDynamicCommand;
+}
+/**
+ * Create a variable resolver for a given context
+ */
+declare function createResolver(context: SkillContext): IVariableResolver;
+/**
+ * Resolve skill content with arguments and context
+ */
+declare function resolveSkillContent(content: string, args: string, context: SkillContext): Promise<string>;
+
+/**
+ * Skill Registry - Progressive Disclosure and Skill Management
+ *
+ * Manages skill discovery, loading, and invocation with progressive disclosure:
+ * - Level 1: Metadata preloaded at startup (name, description)
+ * - Level 2: Full content loaded on invoke
+ * - Level 3: Support files loaded on demand
+ */
+
+/**
+ * Skill Registry implementation
+ */
+declare class SkillRegistry implements ISkillRegistry {
+    private readonly skillsByName;
+    private readonly fullSkillsByName;
+    private readonly projectRoot?;
+    private readonly customPaths?;
+    constructor(projectRoot?: string, customPaths?: Partial<SkillPathsConfig>);
+    /**
+     * Discover skills from all configured paths
+     */
+    discover(): Promise<void>;
+    /**
+     * Get skill metadata by name
+     */
+    get skills(): ReadonlyMap<string, SkillMetadata>;
+    /**
+     * Get skill metadata by name
+     */
+    get(name: string): SkillMetadata | undefined;
+    /**
+     * Load full skill content
+     */
+    loadFull(name: string): Promise<Skill>;
+    /**
+     * Invoke a skill with arguments
+     */
+    invoke(name: string, args: string, context: SkillContext): Promise<SkillResult>;
+    /**
+     * Reload skills from disk
+     */
+    reload(): Promise<void>;
+    /**
+     * List all available skills
+     */
+    list(): SkillMetadata[];
+    /**
+     * List user-invocable skills (for / menu)
+     */
+    listUserInvocable(): SkillMetadata[];
+    /**
+     * Get skills formatted for system prompt injection.
+     *
+     * FEATURE_143 (v0.7.36): manifest wording hardened toward Claude
+     * Code-style strong constraints. The previous wording ("when a user
+     * request matches a skill description, use read to load the skill")
+     * was too soft — the LLM treated skill invocation as one option among
+     * many and frequently authored its own answer instead of loading the
+     * SKILL.md instructions. Aligns with the
+     * `c:/Works/claudecode/src/tools/SkillTool/prompt.ts` ruleset:
+     * BLOCKING REQUIREMENT to load the relevant skill BEFORE generating
+     * any other response when a skill matches.
+     *
+     * Filters out skills with disableModelInvocation=true (Issue 056).
+     */
+    getSystemPromptSnippet(): string;
+    /**
+     * Check if a name is a valid skill
+     */
+    has(name: string): boolean;
+    /**
+     * Get the count of discovered skills
+     */
+    get size(): number;
+}
+/**
+ * Get the global skill registry instance
+ *
+ * IMPORTANT: If projectRoot is undefined, returns existing instance without reset.
+ * This prevents accidental singleton reset when called without arguments.
+ */
+declare function getSkillRegistry(projectRoot?: string, customPaths?: Partial<SkillPathsConfig>): SkillRegistry;
+/**
+ * Initialize the skill registry and discover skills
+ */
+declare function initializeSkillRegistry(projectRoot?: string, customPaths?: Partial<SkillPathsConfig>): Promise<SkillRegistry>;
+/**
+ * Reset the global registry (for testing or hot reload)
+ */
+declare function resetSkillRegistry(): void;
+
+/**
+ * Skill Executor - Execution Engine
  *
- * Usage:
- * ```ts
- * import { loadSkill, SkillRegistry } from '@kodax-ai/kodax/skills';
- * ```
+ * Handles skill execution with support for:
+ * - Inline execution (default)
+ * - Fork execution (sub-agent)
+ * - Tool restrictions
+ */
+
+/**
+ * Execution mode
+ */
+type ExecutionMode = 'inline' | 'fork';
+/**
+ * Execution options
+ */
+interface ExecutionOptions {
+    /** Force a specific execution mode */
+    mode?: ExecutionMode;
+    /** Override model */
+    model?: string;
+    /** Override agent type (for fork mode) */
+    agent?: string;
+    /** Override allowed tools */
+    allowedTools?: string[];
+    /** Callback for inline execution */
+    onExecute?: (content: string, skill: Skill) => Promise<string>;
+}
+/**
+ * Skill executor class
+ */
+declare class SkillExecutor {
+    private context;
+    constructor(context: SkillContext);
+    /**
+     * Execute a skill
+     */
+    execute(skillName: string, args: string, options?: ExecutionOptions): Promise<SkillResult>;
+    /**
+     * Execute skill inline (in current context)
+     */
+    private executeInline;
+    /**
+     * Execute skill in fork mode (sub-agent)
+     */
+    private executeFork;
+    /**
+     * Build the execution prompt
+     */
+    private buildPrompt;
+    /**
+     * Parse allowed tools string into array
+     */
+    private parseAllowedTools;
+}
+/**
+ * Create a skill executor
+ */
+declare function createExecutor(context: SkillContext): SkillExecutor;
+/**
+ * Execute a skill with default context
+ */
+declare function executeSkill(skillName: string, args: string, context: SkillContext, options?: ExecutionOptions): Promise<SkillResult>;
+
+/**
+ * Skill Expander - Expand skill commands for LLM context injection
+ *
+ * Takes a skill invocation and produces content that can be injected
+ * into the user message for LLM execution.
+ *
+ * Design based on pi-mono's _expandSkillCommand:
+ * - Wraps content in XML blocks for clear context
+ * - Includes skill metadata (name, location)
+ * - Resolves all variables ($ARGUMENTS, $0, etc.)
+ * - Handles dynamic context (!`command`)
+ */
+
+/**
+ * Result of skill expansion
+ */
+interface SkillExpansionResult {
+    /** The expanded skill content ready for LLM injection */
+    content: string;
+    /** Whether the skill has model invocation disabled */
+    disableModelInvocation: boolean;
+    /** Original skill metadata */
+    skill: Skill;
+}
+/**
+ * Expand a skill into LLM-ready content
+ *
+ * This function:
+ * 1. Resolves all variables in the skill content ($ARGUMENTS, $0, $1, etc.)
+ * 2. Executes dynamic context commands (!`command`)
+ * 3. Wraps the content in an XML block for clear context boundaries
  *
- * See docs/ADR.md ADR-024 for the SDK formalization decision.
+ * @param skill - The full skill object with content
+ * @param args - Raw arguments string from user input
+ * @param context - Execution context (working directory, session ID, etc.)
+ * @returns Expansion result with content ready for LLM injection
+ */
+declare function expandSkillForLLM(skill: Skill, args: string, context: SkillContext): Promise<SkillExpansionResult>;
+/**
+ * Format skill activation message for user display
  */
-export * from '@kodax-ai/skills';
+declare function formatSkillActivationMessage(skillName: string, args: string): string;
+
+export { SkillExecutor, SkillRegistry, VariableResolver, clearPluginSkillPaths, createExecutor, createResolver, discoverSkills, discoverSkillsWithMonorepo, executeSkill, expandSkillForLLM, formatSkillActivationMessage, getDefaultSkillPaths, getNestedSkillPaths, getSkillPathsFlat, getSkillRegistry, initializeSkillRegistry, listPluginSkillPaths, loadFullSkill, loadSkillFileContent, loadSkillMetadata, parseArguments, parseSkillMarkdown, registerPluginSkillPath, resetSkillRegistry, resolveSkillContent, unregisterPluginSkillPath };
+export type { DiscoveryResult, ExecutionMode, ExecutionOptions, ISkillRegistry, IVariableResolver, Skill, SkillArtifact, SkillContext, SkillExpansionResult, SkillFile, SkillFrontmatter, SkillHook, SkillHooks, SkillMetadata, SkillPathsConfig, SkillResult, SkillSource };

package/dist/sdk-skills.js

@@ -1,2 +1,2 @@
 // @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
-import{A as w,B as y,C as z,a as o,b as r,c as e,d as f,e as m,f as p,j as t,k as x,l as a,m as b,n as c,o as d,p as g,q as h,r as i,s as j,t as k,u as l,v as n,w as q,x as s,y as u,z as v}from"./chunks/chunk-SONW6AC7.js";import"./chunks/chunk-4E76FLZ3.js";export{u as SkillExecutor,l as SkillRegistry,i as VariableResolver,f as clearPluginSkillPaths,v as createExecutor,j as createResolver,c as discoverSkills,g as discoverSkillsWithMonorepo,w as executeSkill,y as expandSkillForLLM,z as formatSkillActivationMessage,m as getDefaultSkillPaths,d as getNestedSkillPaths,p as getSkillPathsFlat,n as getSkillRegistry,q as initializeSkillRegistry,e as listPluginSkillPaths,a as loadFullSkill,b as loadSkillFileContent,x as loadSkillMetadata,h as parseArguments,t as parseSkillMarkdown,o as registerPluginSkillPath,s as resetSkillRegistry,k as resolveSkillContent,r as unregisterPluginSkillPath};
+import{A as w,B as y,C as z,a as o,b as r,c as e,d as f,e as m,f as p,j as t,k as x,l as a,m as b,n as c,o as d,p as g,q as h,r as i,s as j,t as k,u as l,v as n,w as q,x as s,y as u,z as v}from"./chunks/chunk-EQ5DGS2W.js";import"./chunks/chunk-V4WSBIXB.js";export{u as SkillExecutor,l as SkillRegistry,i as VariableResolver,f as clearPluginSkillPaths,v as createExecutor,j as createResolver,c as discoverSkills,g as discoverSkillsWithMonorepo,w as executeSkill,y as expandSkillForLLM,z as formatSkillActivationMessage,m as getDefaultSkillPaths,d as getNestedSkillPaths,p as getSkillPathsFlat,n as getSkillRegistry,q as initializeSkillRegistry,e as listPluginSkillPaths,a as loadFullSkill,b as loadSkillFileContent,x as loadSkillMetadata,h as parseArguments,t as parseSkillMarkdown,o as registerPluginSkillPath,s as resetSkillRegistry,k as resolveSkillContent,r as unregisterPluginSkillPath};