@kodax-ai/kodax 0.7.92 → 0.7.94

package/dist/sdk-skills.d.ts

@@ -1,333 +1,2 @@
-import { R as ResolvedSkillSource, c as Skill, f as SkillFile, S as SkillMetadata, g as SkillFrontmatter, j as SkillPathsConfig, b as IVariableResolver, e as SkillContext, I as ISkillRegistry, k as SkillResult } from './types-chunks/types.d-BEMcUOng.js';
-export { d as SkillArtifact, a as SkillDynamicContextExecutor, h as SkillHook, i as SkillHooks, l as SkillSource, m as getDefaultSkillPaths, n as getSkillPathsFlat } from './types-chunks/types.d-BEMcUOng.js';
-
-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: ResolvedSkillSource): Promise<SkillMetadata | null>;
-/**
- * Load full skill content
- */
-declare function loadFullSkill(skillDir: string, source: ResolvedSkillSource): 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).
-     *
-     * Three-tier dispatch (v0.7.42):
-     *   1. `context.disableDynamicContext === true` → throw immediately,
-     *      surfaced to the LLM as `[Error: …]`. Host-level kill switch.
-     *   2. `context.executeDynamicContext` provided → route there. Embedder
-     *      mediates shell execution (broker, audit, deny).
-     *   3. else → legacy built-in path (`isSafeDynamicContextCommand`
-     *      whitelist + `execSync` with 5s timeout).
-     *
-     * The resolver inlines an `[Error: …]` placeholder for any thrown
-     * exception so a single bad token doesn't poison the whole skill load.
-     */
-    private resolveDynamicContext;
-    /**
-     * Execute a dynamic context command via the appropriate dispatch tier.
-     * See `resolveDynamicContext` JSDoc for the 3-tier ordering rationale.
-     */
-    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
- *
- * 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
- *
- * @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
- */
-declare function formatSkillActivationMessage(skillName: string, args: string): string;
-
-export { ISkillRegistry, IVariableResolver, ResolvedSkillSource, Skill, SkillContext, SkillExecutor, SkillFile, SkillFrontmatter, SkillMetadata, SkillPathsConfig, SkillRegistry, SkillResult, VariableResolver, clearPluginSkillPaths, createExecutor, createResolver, discoverSkills, discoverSkillsWithMonorepo, executeSkill, expandSkillForLLM, formatSkillActivationMessage, getNestedSkillPaths, getSkillRegistry, initializeSkillRegistry, listPluginSkillPaths, loadFullSkill, loadSkillFileContent, loadSkillMetadata, parseArguments, parseSkillMarkdown, registerPluginSkillPath, resetSkillRegistry, resolveSkillContent, unregisterPluginSkillPath };
-export type { DiscoveryResult, ExecutionMode, ExecutionOptions, SkillExpansionResult };
+export { I as ISkillRegistry, c as IVariableResolver, R as ResolvedSkillSource, d as Skill, e as SkillArtifact, b as SkillContext, a as SkillDynamicContextExecutor, f as SkillFile, g as SkillFrontmatter, h as SkillHook, i as SkillHooks, S as SkillMetadata, j as SkillPathsConfig, k as SkillResult, l as SkillSource, m as getDefaultSkillPaths, n as getSkillPathsFlat } from './types-chunks/types.d-ssh6zRaf.js';
+export { D as DiscoveryResult, E as ExecutionMode, a as ExecutionOptions, S as SkillExecutor, b as SkillExpansionResult, c as SkillRegistry, V as VariableResolver, d as clearPluginSkillPaths, e as createExecutor, f as createResolver, g as discoverSkills, h as discoverSkillsWithMonorepo, i as executeSkill, j as expandSkillForLLM, k as formatSkillActivationMessage, m as getNestedSkillPaths, n as getSkillRegistry, o as initializeSkillRegistry, p as listPluginSkillPaths, q as loadFullSkill, r as loadSkillFileContent, s as loadSkillMetadata, t as parseArguments, u as parseSkillMarkdown, v as registerPluginSkillPath, w as resetSkillRegistry, x as resolveSkillContent, y as unregisterPluginSkillPath } from './types-chunks/sdk-skills-Bg1yL4i4.js';

package/dist/sdk-skills.js

@@ -1,2 +1,2 @@
 // @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
-import{Ad as g,Bd as u,Cd as c,Dd as d,Ed as x,Fd as P,Gd as R,Hd as h,Id as p,Jd as v,Kd as y,Ld as M,Md as f,Nd as m,Od as E,gc as l,hc as e,ic as i,jc as t,kc as o,lc as a,pc as k,qc as r,rc as S,sc as s,zd as n}from"./chunks/chunk-7XSZVOG7.js";import"./chunks/chunk-QFV6YCIH.js";import"./chunks/chunk-ONUPGMER.js";export{y as SkillExecutor,R as SkillRegistry,d as VariableResolver,t as clearPluginSkillPaths,M as createExecutor,x as createResolver,n as discoverSkills,u as discoverSkillsWithMonorepo,f as executeSkill,m as expandSkillForLLM,E as formatSkillActivationMessage,o as getDefaultSkillPaths,g as getNestedSkillPaths,a as getSkillPathsFlat,h as getSkillRegistry,p as initializeSkillRegistry,i as listPluginSkillPaths,S as loadFullSkill,s as loadSkillFileContent,r as loadSkillMetadata,c as parseArguments,k as parseSkillMarkdown,l as registerPluginSkillPath,v as resetSkillRegistry,P as resolveSkillContent,e as unregisterPluginSkillPath};
+import{Ad as g,Bd as u,Cd as c,Dd as d,Ed as x,Fd as P,Hd as R,Id as h,Jd as p,Kd as v,Ld as y,Md as M,Nd as f,Od as m,Pd as E,gc as l,hc as e,ic as i,jc as t,kc as o,lc as a,pc as k,qc as r,rc as S,sc as s,zd as n}from"./chunks/chunk-UNRHTOT5.js";import"./chunks/chunk-77PNP27P.js";import"./chunks/chunk-ONUPGMER.js";export{y as SkillExecutor,R as SkillRegistry,d as VariableResolver,t as clearPluginSkillPaths,M as createExecutor,x as createResolver,n as discoverSkills,u as discoverSkillsWithMonorepo,f as executeSkill,m as expandSkillForLLM,E as formatSkillActivationMessage,o as getDefaultSkillPaths,g as getNestedSkillPaths,a as getSkillPathsFlat,h as getSkillRegistry,p as initializeSkillRegistry,i as listPluginSkillPaths,S as loadFullSkill,s as loadSkillFileContent,r as loadSkillMetadata,c as parseArguments,k as parseSkillMarkdown,l as registerPluginSkillPath,v as resetSkillRegistry,P as resolveSkillContent,e as unregisterPluginSkillPath};