@kadi.build/core 0.0.1-alpha.11 → 0.0.1-alpha.12

package/dist/abilities/AbilityLoader.d.ts

@@ -174,29 +174,29 @@ export declare class AbilityLoader {
      */
     private createBrokerTransport;
     /**
-     * Create native transport with path validation
+     * Create native transport with path auto-resolution
      *
-     * Validates the ability path and creates a NativeTransport instance
-     * for in-process ability loading.
+     * If path is provided, uses it directly (backwards compatible).
+     * If path is NOT provided, auto-resolves from agent-lock.json.
      *
      * @param name - Ability name
      * @param options - Load options (native-specific)
      * @returns Native transport instance
      *
-     * @throws {KadiError} If path is missing or invalid
+     * @throws {KadiError} If path is missing and auto-resolution fails
      */
     private createNativeTransport;
     /**
-     * Create stdio transport with command validation
+     * Create stdio transport with command auto-resolution
      *
-     * Validates the command and creates a StdioTransport instance
-     * for spawning the ability as a child process.
+     * If command is provided, uses it directly (backwards compatible).
+     * If command is NOT provided, auto-resolves from agent-lock.json.
      *
      * @param name - Ability name
      * @param options - Load options (stdio-specific)
      * @returns Stdio transport instance
      *
-     * @throws {KadiError} If command is missing
+     * @throws {KadiError} If command is missing and auto-resolution fails
      */
     private createStdioTransport;
 }

package/dist/abilities/AbilityLoader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AbilityLoader.d.ts","sourceRoot":"","sources":["../../src/abilities/AbilityLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAuC,MAAM,YAAY,CAAC;AAGlG,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAGvF,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAIrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,aAAa;IACxB;;;;;;;OAOG;IACH,OAAO,CAAC,KAAK,CAAsB;IAEnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACG,IAAI,CACR,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,aAAa,EACxB,OAAO,GAAE,WAAgB,EACzB,YAAY,CAAC,EAAE,aAAa,GAC3B,OAAO,CAAC,aAAa,CAAC;IAwCzB;;;;;;;;;OASG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBhC;;;;;;;;;;OAUG;IACH,MAAM,IAAI,aAAa,EAAE;IAIzB;;;;;;;;;;;;OAYG;IACH,QAAQ,IAAI;QACV,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;KAC5C;IAID;;;;;;;;;;;;OAYG;IACH,OAAO,IAAI,MAAM;IAIjB;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,eAAe;IA6BvB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,qBAAqB;IAiD7B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,qBAAqB;IAsC7B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,oBAAoB;CAuC7B"}
+{"version":3,"file":"AbilityLoader.d.ts","sourceRoot":"","sources":["../../src/abilities/AbilityLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAuC,MAAM,YAAY,CAAC;AAGlG,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAGvF,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAMrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,aAAa;IACxB;;;;;;;OAOG;IACH,OAAO,CAAC,KAAK,CAAsB;IAEnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACG,IAAI,CACR,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,aAAa,EACxB,OAAO,GAAE,WAAgB,EACzB,YAAY,CAAC,EAAE,aAAa,GAC3B,OAAO,CAAC,aAAa,CAAC;IAwCzB;;;;;;;;;OASG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBhC;;;;;;;;;;OAUG;IACH,MAAM,IAAI,aAAa,EAAE;IAIzB;;;;;;;;;;;;OAYG;IACH,QAAQ,IAAI;QACV,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;KAC5C;IAID;;;;;;;;;;;;OAYG;IACH,OAAO,IAAI,MAAM;IAIjB;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,eAAe;IA6BvB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,qBAAqB;IAiD7B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,qBAAqB;IA4D7B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,oBAAoB;CA8E7B"}

package/dist/abilities/AbilityLoader.js

@@ -16,6 +16,8 @@ import { StdioTransport } from '../transports/StdioTransport.js';
 import { AbilityProxy } from './AbilityProxy.js';
 import { AbilityCache } from './AbilityCache.js';
 import { AbilityValidator } from './AbilityValidator.js';
+import { resolveAbilityConfig } from '../utils/LockfileResolver.js';
+import path from 'path';
 /**
  * Ability Loader
  *
@@ -260,83 +262,138 @@ export class AbilityLoader {
         }, brokerClient);
     }
     /**
-     * Create native transport with path validation
+     * Create native transport with path auto-resolution
      *
-     * Validates the ability path and creates a NativeTransport instance
-     * for in-process ability loading.
+     * If path is provided, uses it directly (backwards compatible).
+     * If path is NOT provided, auto-resolves from agent-lock.json.
      *
      * @param name - Ability name
      * @param options - Load options (native-specific)
      * @returns Native transport instance
      *
-     * @throws {KadiError} If path is missing or invalid
+     * @throws {KadiError} If path is missing and auto-resolution fails
      */
     createNativeTransport(name, options) {
         // Step 1: Extract native-specific options (type-safe!)
         const nativeOptions = options;
-        // Step 2: Validate path is provided
-        if (!nativeOptions.path) {
-            throw new KadiError('Native transport requires path option', ErrorCode.INVALID_CONFIG, 400, {
-                abilityName: name,
-                transport: 'native',
-                reason: 'Missing required "path" option for native transport',
-                suggestion: 'Provide path to ability module',
-                example: 'await client.load("calculator", "native", { path: "./abilities/calculator" })',
-                alternatives: [
-                    'Relative path: { path: "./abilities/calculator" }',
-                    'Absolute path: { path: "/usr/local/lib/abilities/calculator" }',
-                    'Package name: { path: "@kadi/calculator-ability" }'
-                ]
-            });
+        // Step 2: Determine ability path
+        let abilityPath;
+        let abilityVersion = options.version;
+        if (nativeOptions.path) {
+            // Explicit path provided - use it (backwards compatible)
+            abilityPath = nativeOptions.path;
+        }
+        else {
+            // No path provided - auto-resolve from lockfile
+            try {
+                const config = resolveAbilityConfig(name);
+                abilityPath = config.path;
+                abilityVersion = config.version;
+                // Log for debugging (if needed)
+                // console.debug(`Auto-resolved ${name} to ${abilityPath}`);
+            }
+            catch (error) {
+                // Re-throw lockfile resolution errors with context
+                if (error instanceof KadiError) {
+                    throw error;
+                }
+                throw new KadiError(`Failed to auto-resolve ability '${name}'`, ErrorCode.ABILITY_NOT_FOUND, 404, {
+                    abilityName: name,
+                    transport: 'native',
+                    reason: 'Could not auto-resolve path from lockfile',
+                    originalError: error instanceof Error ? error.message : String(error),
+                    suggestion: 'Provide explicit path or run `kadi install`',
+                    example: 'await client.load("calculator", "native", { path: "./abilities/calculator" })',
+                    alternatives: [
+                        'Install ability: kadi install ' + name,
+                        'Provide explicit path in options',
+                        'Check that agent-lock.json exists'
+                    ]
+                });
+            }
         }
-        // Step 3: Create NativeTransport with validated config
+        // Step 3: Create NativeTransport with resolved/provided path
         return new NativeTransport({
             abilityName: name,
-            abilityPath: nativeOptions.path,
-            abilityVersion: options.version,
+            abilityPath,
+            abilityVersion,
             timeout: options.timeout
             // entryPoint defaults to 'index.js' in NativeTransport constructor
         });
     }
     /**
-     * Create stdio transport with command validation
+     * Create stdio transport with command auto-resolution
      *
-     * Validates the command and creates a StdioTransport instance
-     * for spawning the ability as a child process.
+     * If command is provided, uses it directly (backwards compatible).
+     * If command is NOT provided, auto-resolves from agent-lock.json.
      *
      * @param name - Ability name
      * @param options - Load options (stdio-specific)
      * @returns Stdio transport instance
      *
-     * @throws {KadiError} If command is missing
+     * @throws {KadiError} If command is missing and auto-resolution fails
      */
     createStdioTransport(name, options) {
         // Step 1: Extract stdio-specific options (type-safe!)
         const stdioOptions = options;
-        // Step 2: Validate command is provided
-        if (!stdioOptions.command) {
-            throw new KadiError('Stdio transport requires command option', ErrorCode.INVALID_CONFIG, 400, {
-                abilityName: name,
-                transport: 'stdio',
-                reason: 'Missing required "command" option for stdio transport',
-                suggestion: 'Provide command to execute ability process',
-                example: 'await client.load("calculator", "stdio", { command: "node", args: ["./abilities/calculator/index.js"] })',
-                alternatives: [
-                    'Node.js: { command: "node", args: ["./ability.js"] }',
-                    'Python: { command: "python3", args: ["./ability.py"] }',
-                    'Binary: { command: "./ability-binary" }'
-                ]
-            });
+        // Step 2: Determine command and args
+        let command;
+        let args = stdioOptions.args;
+        let cwd = stdioOptions.cwd;
+        let abilityVersion = options.version;
+        if (stdioOptions.command) {
+            // Explicit command provided - use it (backwards compatible)
+            command = stdioOptions.command;
+        }
+        else {
+            // No command provided - auto-resolve from lockfile
+            try {
+                const config = resolveAbilityConfig(name);
+                // TODO: Runtime detection - currently assumes Node.js
+                // In the future, detect runtime from ability manifest:
+                // - runtime: "node" | "python" | "go" | "binary"
+                // - Or auto-detect from entry file extension (.js, .py, .go)
+                // For now, we assume Node.js for all abilities
+                command = 'node';
+                // Construct entry point path
+                const entryPath = path.join(config.path, config.entry);
+                args = [entryPath];
+                // Set working directory to ability directory
+                cwd = config.path;
+                // Use version from lockfile
+                abilityVersion = config.version;
+                // Log for debugging (if needed)
+                // console.debug(`Auto-resolved ${name} stdio command: node ${entryPath}`);
+            }
+            catch (error) {
+                // Re-throw lockfile resolution errors with context
+                if (error instanceof KadiError) {
+                    throw error;
+                }
+                throw new KadiError(`Failed to auto-resolve ability '${name}' for stdio`, ErrorCode.ABILITY_NOT_FOUND, 404, {
+                    abilityName: name,
+                    transport: 'stdio',
+                    reason: 'Could not auto-resolve command from lockfile',
+                    originalError: error instanceof Error ? error.message : String(error),
+                    suggestion: 'Provide explicit command or run `kadi install`',
+                    example: 'await client.load("calculator", "stdio", { command: "node", args: ["./service.js"] })',
+                    alternatives: [
+                        'Install ability: kadi install ' + name,
+                        'Provide explicit command in options',
+                        'Check that agent-lock.json exists'
+                    ]
+                });
+            }
         }
-        // Step 3: Create StdioTransport with validated config
+        // Step 3: Create StdioTransport with resolved/provided config
         return new StdioTransport({
             abilityName: name,
-            command: stdioOptions.command,
-            args: stdioOptions.args,
-            cwd: stdioOptions.cwd,
+            command,
+            args,
+            cwd,
             env: stdioOptions.env,
             timeout: options.timeout,
-            abilityVersion: options.version
+            abilityVersion
         });
     }
 }

package/dist/abilities/AbilityLoader.js.map

@@ -1 +1 @@
-{"version":3,"file":"AbilityLoader.js","sourceRoot":"","sources":["../../src/abilities/AbilityLoader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AbilityLoader.js","sourceRoot":"","sources":["../../src/abilities/AbilityLoader.ts"],"names":[],"mappings":"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"}

package/dist/utils/LockfileResolver.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Lockfile Resolver
+ *
+ * Utilities for resolving ability paths from agent-lock.json
+ * Integrates kadi-core with kadi-install's global cache architecture
+ *
+ * @module utils/LockfileResolver
+ */
+/**
+ * Minimal lockfile types (only what kadi-core needs)
+ *
+ * These types are a subset of the full lockfile format from kadi-install.
+ * We only include fields needed for ability path resolution.
+ */
+export interface LockfileAbilityEntry {
+    version: string;
+    kind: 'plugin' | 'ability';
+    resolved: string;
+    integrity: string;
+    installStrategy: 'hardlink' | 'clonefile' | 'copyfile' | 'symlink';
+    detached: boolean;
+}
+export interface AgentLockfile {
+    lockfileVersion: number;
+    abilities: Record<string, LockfileAbilityEntry>;
+    agent: {
+        name: string;
+        version: string;
+    };
+    generated: string;
+}
+/**
+ * Minimal ability manifest (agent.json)
+ *
+ * Only fields needed for loading abilities
+ */
+export interface AbilityManifest {
+    name: string;
+    version: string;
+    kind?: 'plugin' | 'ability';
+    entry?: string;
+    description?: string;
+    [key: string]: unknown;
+}
+/**
+ * Find project root by looking for agent.json
+ *
+ * Walks up directory tree from cwd until finding agent.json
+ *
+ * @param startDir - Directory to start search from (defaults to cwd)
+ * @returns Absolute path to project root
+ * @throws {KadiError} If no project root found
+ */
+export declare function findProjectRoot(startDir?: string): string;
+/**
+ * Read agent-lock.json from project root
+ *
+ * @param projectRoot - Project root directory
+ * @returns Parsed lockfile
+ * @throws {KadiError} If lockfile not found or invalid
+ */
+export declare function readLockfile(projectRoot: string): AgentLockfile;
+/**
+ * Resolve ability path from lockfile
+ *
+ * @param abilityName - Name of ability to resolve
+ * @param projectRoot - Project root directory
+ * @returns Resolved ability entry from lockfile
+ * @throws {KadiError} If ability not found in lockfile or path doesn't exist
+ */
+export declare function resolveAbilityPath(abilityName: string, projectRoot: string): LockfileAbilityEntry;
+/**
+ * Read ability's agent.json manifest
+ *
+ * @param abilityPath - Path to ability directory
+ * @returns Parsed ability manifest
+ * @throws {KadiError} If manifest not found or invalid
+ */
+export declare function readAbilityManifest(abilityPath: string): AbilityManifest;
+/**
+ * Auto-resolve ability configuration for loading
+ *
+ * Combines lockfile lookup with manifest reading to provide
+ * all information needed to load an ability.
+ *
+ * @param abilityName - Name of ability
+ * @param projectRoot - Project root directory (optional, will search if not provided)
+ * @returns Resolved ability configuration
+ *
+ * @example
+ * ```typescript
+ * const config = resolveAbilityConfig('math-lib');
+ * // Returns:
+ * // {
+ * //   path: '/path/to/project/abilities/math-lib@1.0.0',
+ * //   version: '1.0.0',
+ * //   entry: 'service.js',
+ * //   manifest: { ... }
+ * // }
+ * ```
+ */
+export declare function resolveAbilityConfig(abilityName: string, projectRoot?: string): {
+    path: string;
+    version: string;
+    entry: string;
+    manifest: AbilityManifest;
+};
+//# sourceMappingURL=LockfileResolver.d.ts.map

package/dist/utils/LockfileResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LockfileResolver.d.ts","sourceRoot":"","sources":["../../src/utils/LockfileResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;IACnE,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IAChD,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,QAAQ,GAAE,MAAsB,GAAG,MAAM,CA8BxE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CA2D/D;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,oBAAoB,CAqEtB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,CAkDxE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB;IACD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,eAAe,CAAC;CAC3B,CAmBA"}

package/dist/utils/LockfileResolver.js

@@ -0,0 +1,230 @@
+/**
+ * Lockfile Resolver
+ *
+ * Utilities for resolving ability paths from agent-lock.json
+ * Integrates kadi-core with kadi-install's global cache architecture
+ *
+ * @module utils/LockfileResolver
+ */
+import fs from 'fs';
+import path from 'path';
+import { KadiError, ErrorCode } from '../errors/index.js';
+/**
+ * Find project root by looking for agent.json
+ *
+ * Walks up directory tree from cwd until finding agent.json
+ *
+ * @param startDir - Directory to start search from (defaults to cwd)
+ * @returns Absolute path to project root
+ * @throws {KadiError} If no project root found
+ */
+export function findProjectRoot(startDir = process.cwd()) {
+    let current = path.resolve(startDir);
+    const root = path.parse(current).root;
+    while (current !== root) {
+        const agentJsonPath = path.join(current, 'agent.json');
+        if (fs.existsSync(agentJsonPath)) {
+            return current;
+        }
+        // Move up one directory
+        current = path.dirname(current);
+    }
+    throw new KadiError('No KADI project found - could not locate agent.json', ErrorCode.INVALID_CONFIG, 404, {
+        searchedFrom: startDir,
+        reason: 'No agent.json found in current directory or parent directories',
+        suggestion: 'Make sure you are running from within a KADI project',
+        alternatives: [
+            'Run from a directory containing agent.json',
+            'Initialize a new KADI project: kadi init',
+            'Provide explicit path when loading ability'
+        ]
+    });
+}
+/**
+ * Read agent-lock.json from project root
+ *
+ * @param projectRoot - Project root directory
+ * @returns Parsed lockfile
+ * @throws {KadiError} If lockfile not found or invalid
+ */
+export function readLockfile(projectRoot) {
+    const lockfilePath = path.join(projectRoot, 'agent-lock.json');
+    // Check if lockfile exists
+    if (!fs.existsSync(lockfilePath)) {
+        throw new KadiError('No agent-lock.json found - cannot auto-resolve ability paths', ErrorCode.INVALID_CONFIG, 404, {
+            projectRoot,
+            lockfilePath,
+            reason: 'agent-lock.json not found in project root',
+            suggestion: 'Run `kadi install` to generate lockfile',
+            alternatives: [
+                'Run: kadi install (to install all abilities from agent.json)',
+                'Run: kadi install <ability-name> (to install specific ability)',
+                'Provide explicit path: client.load("ability", "native", { path: "./abilities/..." })'
+            ],
+            hint: 'agent-lock.json is created by running `kadi install`'
+        });
+    }
+    // Read and parse lockfile
+    try {
+        const content = fs.readFileSync(lockfilePath, 'utf-8');
+        const lockfile = JSON.parse(content);
+        // Basic validation
+        if (!lockfile.abilities || typeof lockfile.abilities !== 'object') {
+            throw new Error('Invalid lockfile format: missing or invalid "abilities" field');
+        }
+        return lockfile;
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            throw new KadiError('Invalid agent-lock.json - malformed JSON', ErrorCode.INVALID_CONFIG, 400, {
+                lockfilePath,
+                parseError: error.message,
+                suggestion: 'Delete agent-lock.json and run `kadi install` to regenerate'
+            });
+        }
+        throw new KadiError('Failed to read agent-lock.json', ErrorCode.INTERNAL_ERROR, 500, {
+            lockfilePath,
+            error: error instanceof Error ? error.message : String(error)
+        });
+    }
+}
+/**
+ * Resolve ability path from lockfile
+ *
+ * @param abilityName - Name of ability to resolve
+ * @param projectRoot - Project root directory
+ * @returns Resolved ability entry from lockfile
+ * @throws {KadiError} If ability not found in lockfile or path doesn't exist
+ */
+export function resolveAbilityPath(abilityName, projectRoot) {
+    const lockfile = readLockfile(projectRoot);
+    // Check if ability exists in lockfile
+    const abilityEntry = lockfile.abilities[abilityName];
+    if (!abilityEntry) {
+        // Ability not in lockfile - show helpful error
+        const installedAbilities = Object.keys(lockfile.abilities);
+        throw new KadiError(`Ability '${abilityName}' not found in agent-lock.json`, ErrorCode.ABILITY_NOT_FOUND, 404, {
+            abilityName,
+            projectRoot,
+            installedAbilities,
+            installedCount: installedAbilities.length,
+            reason: `'${abilityName}' is not installed in this project`,
+            suggestion: `Run: kadi install ${abilityName}`,
+            alternatives: [
+                `Install ability: kadi install ${abilityName}`,
+                'View installed abilities in agent-lock.json',
+                'Provide explicit path when loading ability'
+            ],
+            hint: installedAbilities.length === 0
+                ? 'No abilities installed yet. Run `kadi install` to install from agent.json'
+                : `Currently installed: ${installedAbilities.slice(0, 5).join(', ')}${installedAbilities.length > 5 ? '...' : ''}`
+        });
+    }
+    // Resolve path (may be relative to project root)
+    const absolutePath = path.isAbsolute(abilityEntry.resolved)
+        ? abilityEntry.resolved
+        : path.resolve(projectRoot, abilityEntry.resolved);
+    // Verify the resolved path exists
+    if (!fs.existsSync(absolutePath)) {
+        throw new KadiError(`Ability '${abilityName}@${abilityEntry.version}' is in lockfile but directory not found`, ErrorCode.ABILITY_NOT_FOUND, 404, {
+            abilityName,
+            version: abilityEntry.version,
+            expectedPath: absolutePath,
+            reason: 'Directory listed in lockfile does not exist',
+            possibleCauses: [
+                'Ability was manually deleted',
+                'Project was moved without abilities/ folder',
+                'File system error or permissions issue'
+            ],
+            suggestion: `Run: kadi install --force ${abilityName}`,
+            alternatives: [
+                `Reinstall ability: kadi install --force ${abilityName}`,
+                'Check if abilities/ folder exists',
+                'Run `kadi install` to restore all abilities'
+            ]
+        });
+    }
+    // Return entry with absolute path
+    return {
+        ...abilityEntry,
+        resolved: absolutePath
+    };
+}
+/**
+ * Read ability's agent.json manifest
+ *
+ * @param abilityPath - Path to ability directory
+ * @returns Parsed ability manifest
+ * @throws {KadiError} If manifest not found or invalid
+ */
+export function readAbilityManifest(abilityPath) {
+    const manifestPath = path.join(abilityPath, 'agent.json');
+    if (!fs.existsSync(manifestPath)) {
+        throw new KadiError('Ability agent.json not found', ErrorCode.INVALID_CONFIG, 404, {
+            abilityPath,
+            manifestPath,
+            reason: 'agent.json not found in ability directory',
+            suggestion: 'Reinstall the ability: kadi install --force <ability-name>'
+        });
+    }
+    try {
+        const content = fs.readFileSync(manifestPath, 'utf-8');
+        const manifest = JSON.parse(content);
+        // Basic validation
+        if (!manifest.name || !manifest.version) {
+            throw new Error('Invalid manifest: missing name or version');
+        }
+        return manifest;
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            throw new KadiError('Invalid ability agent.json - malformed JSON', ErrorCode.INVALID_CONFIG, 400, {
+                manifestPath,
+                parseError: error.message
+            });
+        }
+        throw new KadiError('Failed to read ability agent.json', ErrorCode.INTERNAL_ERROR, 500, {
+            manifestPath,
+            error: error instanceof Error ? error.message : String(error)
+        });
+    }
+}
+/**
+ * Auto-resolve ability configuration for loading
+ *
+ * Combines lockfile lookup with manifest reading to provide
+ * all information needed to load an ability.
+ *
+ * @param abilityName - Name of ability
+ * @param projectRoot - Project root directory (optional, will search if not provided)
+ * @returns Resolved ability configuration
+ *
+ * @example
+ * ```typescript
+ * const config = resolveAbilityConfig('math-lib');
+ * // Returns:
+ * // {
+ * //   path: '/path/to/project/abilities/math-lib@1.0.0',
+ * //   version: '1.0.0',
+ * //   entry: 'service.js',
+ * //   manifest: { ... }
+ * // }
+ * ```
+ */
+export function resolveAbilityConfig(abilityName, projectRoot) {
+    // Find project root if not provided
+    const root = projectRoot || findProjectRoot();
+    // Resolve ability from lockfile
+    const entry = resolveAbilityPath(abilityName, root);
+    // Read ability manifest
+    const manifest = readAbilityManifest(entry.resolved);
+    // Get entry point (default to 'index.js' if not specified)
+    const entryPoint = manifest.entry || 'index.js';
+    return {
+        path: entry.resolved,
+        version: entry.version,
+        entry: entryPoint,
+        manifest
+    };
+}
+//# sourceMappingURL=LockfileResolver.js.map

package/dist/utils/LockfileResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LockfileResolver.js","sourceRoot":"","sources":["../../src/utils/LockfileResolver.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kadi.build/core",
-  "version": "0.0.1-alpha.11",
+  "version": "0.0.1-alpha.12",
   "description": "A module that is a comprehensive toolkit for developers integrating with the KADI infrastructure.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",