@kadi.build/core 0.9.0 → 0.11.0

package/dist/agent-json.js

@@ -0,0 +1,554 @@
+/**
+ * AgentJsonManager for kadi-core
+ *
+ * Provides unified read/write access to agent.json files across the ecosystem.
+ * Three target locations:
+ *
+ * 1. **Project root** — the agent's own config (`/my-agent/agent.json`)
+ * 2. **Installed ability** — an ability's config (`/my-agent/abilities/calculator@1.0.0/agent.json`)
+ * 3. **KADI home** — global CLI config (`~/.kadi/agent.json`)
+ *
+ * @example
+ * ```typescript
+ * import { AgentJsonManager } from '@kadi.build/core';
+ *
+ * const ajm = new AgentJsonManager();
+ *
+ * // Read
+ * const config = await ajm.readProject();
+ * const deploy = await ajm.readProject('deploy.local');
+ * const abilityConfig = await ajm.readAbility('calculator');
+ *
+ * // Write
+ * await ajm.writeProject('deploy.staging', { target: 'akash' });
+ * await ajm.deleteProject('deploy.staging');
+ * ```
+ */
+import { readFile, writeFile, rename, mkdir } from 'fs/promises';
+import { existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { homedir } from 'os';
+import { randomBytes } from 'crypto';
+import { KadiError } from './errors.js';
+import { findProjectRoot, readLockFile, getInstalledAbilityNames } from './lockfile.js';
+import { getByPath, setByPath, deleteByPath } from './utils.js';
+// ═══════════════════════════════════════════════════════════════════════
+// CONSTANTS
+// ═══════════════════════════════════════════════════════════════════════
+const AGENT_JSON_FILENAME = 'agent.json';
+const DEFAULT_KADI_HOME = join(homedir(), '.kadi');
+// ═══════════════════════════════════════════════════════════════════════
+// AGENT JSON MANAGER
+// ═══════════════════════════════════════════════════════════════════════
+export class AgentJsonManager {
+    options;
+    /** Cached project root (resolved lazily) */
+    resolvedProjectRoot = null;
+    constructor(options = {}) {
+        this.options = {
+            projectRoot: options.projectRoot ?? '',
+            kadiHome: options.kadiHome ?? DEFAULT_KADI_HOME,
+            createOnWrite: options.createOnWrite ?? true,
+        };
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // PROJECT ROOT RESOLUTION
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Get the resolved project root path.
+     * Auto-detects if not explicitly set.
+     */
+    async getProjectRoot() {
+        if (this.resolvedProjectRoot) {
+            return this.resolvedProjectRoot;
+        }
+        if (this.options.projectRoot) {
+            this.resolvedProjectRoot = this.options.projectRoot;
+        }
+        else {
+            this.resolvedProjectRoot = await findProjectRoot();
+        }
+        return this.resolvedProjectRoot;
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // READ API
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Read the project root agent.json.
+     *
+     * @param field - Optional dot-notation path to a specific field
+     * @returns The full agent.json object, or a specific field value
+     * @throws KadiError with code AGENT_JSON_NOT_FOUND, AGENT_JSON_PARSE_ERROR,
+     *         or AGENT_JSON_FIELD_NOT_FOUND
+     *
+     * @example
+     * ```typescript
+     * const config = await ajm.readProject();                // Full object
+     * const name = await ajm.readProject('name');            // 'my-agent'
+     * const deploy = await ajm.readProject('deploy.local');  // { target: 'docker', ... }
+     * ```
+     */
+    async readProject(field) {
+        const root = await this.getProjectRoot();
+        const filePath = join(root, AGENT_JSON_FILENAME);
+        const data = await this.readJsonFile(filePath, 'project');
+        if (!field)
+            return data;
+        return this.resolveField(data, field, filePath);
+    }
+    /**
+     * Read an installed ability's agent.json.
+     *
+     * Resolution order for version ambiguity:
+     * 1. If `options.version` specified → exact match
+     * 2. Prefer `isTopLevel: true` entries (direct dependencies)
+     * 3. Use highest semver version
+     *
+     * @param name - Ability name (without version)
+     * @param options - Version targeting and field selection
+     * @returns The full agent.json object, or a specific field value
+     *
+     * @example
+     * ```typescript
+     * const config = await ajm.readAbility('calculator');
+     * const scripts = await ajm.readAbility('calculator', { field: 'scripts' });
+     * const specific = await ajm.readAbility('secret-ability', { version: '0.9.0' });
+     * ```
+     */
+    async readAbility(name, options = {}) {
+        const abilityPath = await this.resolveAbilityDir(name, options.version);
+        const filePath = join(abilityPath, AGENT_JSON_FILENAME);
+        const data = await this.readJsonFile(filePath, `ability "${name}"`);
+        if (!options.field)
+            return data;
+        return this.resolveField(data, options.field, filePath);
+    }
+    /**
+     * Read the global KADI home agent.json (~/.kadi/agent.json).
+     *
+     * @param field - Optional dot-notation path to a specific field
+     * @returns The full agent.json object, or a specific field value
+     *
+     * @example
+     * ```typescript
+     * const global = await ajm.readHome();
+     * const plugins = await ajm.readHome('cliPlugins');
+     * ```
+     */
+    async readHome(field) {
+        const filePath = join(this.options.kadiHome, AGENT_JSON_FILENAME);
+        const data = await this.readJsonFile(filePath, 'home (~/.kadi)');
+        if (!field)
+            return data;
+        return this.resolveField(data, field, filePath);
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // WRITE API
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Write a value to the project root agent.json.
+     *
+     * Uses deep-merge semantics for objects (preserves sibling keys).
+     * Scalars and arrays are directly replaced.
+     *
+     * @param path - Dot-notation path to the field to set
+     * @param value - The value to write
+     *
+     * @example
+     * ```typescript
+     * await ajm.writeProject('version', '2.0.0');
+     * await ajm.writeProject('deploy.staging', { target: 'akash', network: 'mainnet' });
+     * await ajm.writeProject('build.arm64', { from: 'node:22-slim', platform: 'linux/arm64' });
+     * ```
+     */
+    async writeProject(path, value) {
+        const root = await this.getProjectRoot();
+        const filePath = join(root, AGENT_JSON_FILENAME);
+        await this.writeField(filePath, path, value, 'project');
+    }
+    /**
+     * Write a value to an installed ability's agent.json.
+     *
+     * @param name - Ability name
+     * @param path - Dot-notation path to the field to set
+     * @param value - The value to write
+     * @param version - Optional specific version to target
+     *
+     * @example
+     * ```typescript
+     * await ajm.writeAbility('calculator', 'scripts.dev', 'node dist/index.js --debug');
+     * ```
+     */
+    async writeAbility(name, path, value, version) {
+        const abilityPath = await this.resolveAbilityDir(name, version);
+        const filePath = join(abilityPath, AGENT_JSON_FILENAME);
+        await this.writeField(filePath, path, value, `ability "${name}"`);
+    }
+    /**
+     * Write a value to the global KADI home agent.json.
+     *
+     * @param path - Dot-notation path to the field to set
+     * @param value - The value to write
+     *
+     * @example
+     * ```typescript
+     * await ajm.writeHome('cliPlugins.my-plugin', { version: '1.0.0' });
+     * ```
+     */
+    async writeHome(path, value) {
+        const filePath = join(this.options.kadiHome, AGENT_JSON_FILENAME);
+        await this.writeField(filePath, path, value, 'home (~/.kadi)');
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // DELETE API
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Delete a field from the project root agent.json.
+     *
+     * @param path - Dot-notation path to the field to delete
+     * @returns true if the field was found and deleted
+     *
+     * @example
+     * ```typescript
+     * await ajm.deleteProject('deploy.staging');
+     * ```
+     */
+    async deleteProject(path) {
+        const root = await this.getProjectRoot();
+        const filePath = join(root, AGENT_JSON_FILENAME);
+        return this.deleteField(filePath, path);
+    }
+    /**
+     * Delete a field from an ability's agent.json.
+     */
+    async deleteAbility(name, path, version) {
+        const abilityPath = await this.resolveAbilityDir(name, version);
+        const filePath = join(abilityPath, AGENT_JSON_FILENAME);
+        return this.deleteField(filePath, path);
+    }
+    /**
+     * Delete a field from the global KADI home agent.json.
+     */
+    async deleteHome(path) {
+        const filePath = join(this.options.kadiHome, AGENT_JSON_FILENAME);
+        return this.deleteField(filePath, path);
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // DISCOVERY API
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * List all installed abilities with their name, version, and path.
+     *
+     * @returns Array of AbilityInfo objects
+     *
+     * @example
+     * ```typescript
+     * const abilities = await ajm.listAbilities();
+     * // [
+     * //   { name: 'calculator', version: '1.0.0', path: '/abs/path/abilities/calculator@1.0.0' },
+     * //   { name: 'secret-ability', version: '0.9.0', path: '/abs/path/abilities/secret-ability@0.9.0' },
+     * // ]
+     * ```
+     */
+    async listAbilities() {
+        const root = await this.getProjectRoot();
+        let lockFile;
+        try {
+            lockFile = await readLockFile(root);
+        }
+        catch {
+            return []; // No lock file → no installed abilities
+        }
+        const abilities = [];
+        for (const [key, entry] of Object.entries(lockFile.abilities)) {
+            const lastAt = key.lastIndexOf('@');
+            const name = lastAt !== -1 ? key.substring(0, lastAt) : key;
+            abilities.push({
+                name,
+                version: entry.version,
+                path: join(root, entry.resolved),
+            });
+        }
+        return abilities;
+    }
+    /**
+     * Check if a specific ability is installed.
+     *
+     * @param name - Ability name (without version)
+     * @returns true if the ability exists in the lock file
+     */
+    async hasAbility(name) {
+        const root = await this.getProjectRoot();
+        let lockFile;
+        try {
+            lockFile = await readLockFile(root);
+        }
+        catch {
+            return false;
+        }
+        return this.findAbilityEntries(lockFile, name).length > 0;
+    }
+    /**
+     * Get all installed versions of a specific ability.
+     *
+     * @param name - Ability name (without version)
+     * @returns Array of version strings
+     *
+     * @example
+     * ```typescript
+     * const versions = await ajm.getAbilityVersions('secret-ability');
+     * // ['0.7.0', '0.9.0']
+     * ```
+     */
+    async getAbilityVersions(name) {
+        const root = await this.getProjectRoot();
+        let lockFile;
+        try {
+            lockFile = await readLockFile(root);
+        }
+        catch {
+            return [];
+        }
+        return this.findAbilityEntries(lockFile, name).map(e => e.version);
+    }
+    /**
+     * Get resolved paths for all known agent.json files.
+     *
+     * @returns Object with project, home, and abilities paths
+     */
+    async getPaths() {
+        const root = await this.getProjectRoot();
+        const abilities = {};
+        try {
+            const lockFile = await readLockFile(root);
+            for (const [key, entry] of Object.entries(lockFile.abilities)) {
+                abilities[key] = join(root, entry.resolved, AGENT_JSON_FILENAME);
+            }
+        }
+        catch {
+            // No lock file — abilities stays empty
+        }
+        return {
+            project: join(root, AGENT_JSON_FILENAME),
+            home: join(this.options.kadiHome, AGENT_JSON_FILENAME),
+            abilities,
+        };
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // INTERNAL: FILE I/O
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Read and parse a JSON file.
+     */
+    async readJsonFile(filePath, label) {
+        let content;
+        try {
+            content = await readFile(filePath, 'utf-8');
+        }
+        catch {
+            throw new KadiError(`${label} agent.json not found`, 'AGENT_JSON_NOT_FOUND', {
+                path: filePath,
+                hint: label === 'project'
+                    ? 'Make sure you are in a KADI project directory with an agent.json file'
+                    : `The ${label} agent.json was expected at: ${filePath}`,
+            });
+        }
+        try {
+            return JSON.parse(content);
+        }
+        catch {
+            throw new KadiError(`Failed to parse ${label} agent.json`, 'AGENT_JSON_PARSE_ERROR', {
+                path: filePath,
+                hint: 'The file contains invalid JSON. Check for syntax errors.',
+            });
+        }
+    }
+    /**
+     * Resolve a field from a parsed agent.json using dot-path notation.
+     */
+    resolveField(data, field, filePath) {
+        const value = getByPath(data, field);
+        if (value === undefined) {
+            throw new KadiError(`Field "${field}" not found in agent.json`, 'AGENT_JSON_FIELD_NOT_FOUND', {
+                path: filePath,
+                available: Object.keys(data),
+                hint: `Available top-level keys: ${Object.keys(data).join(', ')}`,
+            });
+        }
+        return value;
+    }
+    /**
+     * Write a field to a JSON file using dot-path notation.
+     * Atomic write: writes to a temp file then renames.
+     */
+    async writeField(filePath, path, value, label) {
+        // Read existing or create new
+        let data;
+        try {
+            const content = await readFile(filePath, 'utf-8');
+            data = JSON.parse(content);
+        }
+        catch {
+            if (!this.options.createOnWrite) {
+                throw new KadiError(`${label} agent.json not found (createOnWrite is false)`, 'AGENT_JSON_NOT_FOUND', { path: filePath });
+            }
+            data = {};
+        }
+        // Apply the change
+        setByPath(data, path, value);
+        // Atomic write
+        await this.atomicWriteJson(filePath, data);
+    }
+    /**
+     * Delete a field from a JSON file.
+     */
+    async deleteField(filePath, path) {
+        let content;
+        try {
+            content = await readFile(filePath, 'utf-8');
+        }
+        catch {
+            return false;
+        }
+        let data;
+        try {
+            data = JSON.parse(content);
+        }
+        catch {
+            return false;
+        }
+        const deleted = deleteByPath(data, path);
+        if (deleted) {
+            await this.atomicWriteJson(filePath, data);
+        }
+        return deleted;
+    }
+    /**
+     * Write JSON to a file atomically (write temp → rename).
+     */
+    async atomicWriteJson(filePath, data) {
+        const dir = dirname(filePath);
+        const tmpPath = join(dir, `.agent.json.${randomBytes(6).toString('hex')}.tmp`);
+        try {
+            // Ensure directory exists
+            if (!existsSync(dir)) {
+                await mkdir(dir, { recursive: true });
+            }
+            const json = JSON.stringify(data, null, 2) + '\n';
+            await writeFile(tmpPath, json, 'utf-8');
+            await rename(tmpPath, filePath);
+        }
+        catch (error) {
+            // Attempt cleanup of temp file
+            try {
+                const { unlink } = await import('fs/promises');
+                await unlink(tmpPath);
+            }
+            catch {
+                // Ignore cleanup failure
+            }
+            throw new KadiError('Failed to write agent.json', 'AGENT_JSON_WRITE_ERROR', {
+                path: filePath,
+                reason: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // INTERNAL: ABILITY RESOLUTION
+    // ─────────────────────────────────────────────────────────────────
+    /**
+     * Resolve the directory path for an installed ability.
+     * Handles version ambiguity with smart defaults.
+     */
+    async resolveAbilityDir(name, version) {
+        const root = await this.getProjectRoot();
+        const lockFile = await readLockFile(root);
+        const entries = this.findAbilityEntries(lockFile, name);
+        if (entries.length === 0) {
+            const available = getInstalledAbilityNames(lockFile);
+            throw new KadiError(`Ability "${name}" not found in agent-lock.json`, 'ABILITY_NOT_FOUND', {
+                abilityName: name,
+                searched: join(root, 'agent-lock.json'),
+                available: available.length > 0 ? available : undefined,
+                hint: `Run \`kadi install ${name}\` to install it`,
+            });
+        }
+        let selected;
+        if (version) {
+            // Exact version requested
+            const exact = entries.find(e => e.version === version);
+            if (!exact) {
+                throw new KadiError(`Ability "${name}" version "${version}" not found`, 'ABILITY_NOT_FOUND', {
+                    abilityName: name,
+                    available: entries.map(e => e.version),
+                    hint: `Available versions: ${entries.map(e => e.version).join(', ')}`,
+                });
+            }
+            selected = exact;
+        }
+        else if (entries.length === 1) {
+            // Only one version — no ambiguity
+            selected = entries[0];
+        }
+        else {
+            // Multiple versions — prefer isTopLevel
+            const topLevel = entries.filter(e => e.entry.isTopLevel);
+            if (topLevel.length === 1) {
+                selected = topLevel[0];
+            }
+            else if (topLevel.length > 1) {
+                // Multiple top-level — pick highest semver
+                selected = this.highestVersion(topLevel);
+            }
+            else {
+                // No top-level — ambiguous
+                throw new KadiError(`Multiple versions of "${name}" installed — specify a version`, 'AGENT_JSON_VERSION_AMBIGUOUS', {
+                    abilityName: name,
+                    available: entries.map(e => e.version),
+                    hint: `Installed versions: ${entries.map(e => e.version).join(', ')}. Use { version: "x.y.z" } to select one.`,
+                });
+            }
+        }
+        return join(root, selected.entry.resolved);
+    }
+    /**
+     * Find all lock file entries matching an ability name.
+     */
+    findAbilityEntries(lockFile, name) {
+        const results = [];
+        for (const [key, entry] of Object.entries(lockFile.abilities)) {
+            const lastAt = key.lastIndexOf('@');
+            const entryName = lastAt !== -1 ? key.substring(0, lastAt) : key;
+            if (entryName === name) {
+                results.push({ entry, key, version: entry.version });
+            }
+        }
+        return results;
+    }
+    /**
+     * Pick the entry with the highest semver version.
+     * Simple comparison — splits on dots and compares numerically.
+     */
+    highestVersion(entries) {
+        return entries.reduce((highest, current) => {
+            return this.compareSemver(current.version, highest.version) > 0
+                ? current
+                : highest;
+        });
+    }
+    /**
+     * Compare two semver strings. Returns > 0 if a > b, < 0 if a < b, 0 if equal.
+     */
+    compareSemver(a, b) {
+        const aParts = a.split('.').map(Number);
+        const bParts = b.split('.').map(Number);
+        for (let i = 0; i < Math.max(aParts.length, bParts.length); i++) {
+            const aVal = aParts[i] ?? 0;
+            const bVal = bParts[i] ?? 0;
+            if (aVal !== bVal)
+                return aVal - bVal;
+        }
+        return 0;
+    }
+}
+//# sourceMappingURL=agent-json.js.map

package/dist/agent-json.js.map

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

package/dist/client.d.ts

@@ -16,6 +16,8 @@
  */
 import { type EncryptionKeyPair } from './crypto.js';
 import type { ClientConfig, ClientIdentity, BrokerState, BrokerToolDefinition, ZodToolDefinition, ToolHandler, LoadedAbility, ToolExecutionBridge, RegisterToolOptions, LoadNativeOptions, LoadStdioOptions, LoadBrokerOptions, InvokeRemoteOptions, BrokerEventHandler, PublishOptions, SubscribeOptions, EmitOptions } from './types.js';
+import { AgentJsonManager } from './agent-json.js';
+import { ProcessManager } from './process-manager.js';
 /**
  * The main client for building KADI agents.
  *
@@ -63,6 +65,10 @@ export declare class KadiClient {
     private readonly loadedAbilities;
     /** Registered disconnect hooks */
     private readonly disconnectHooks;
+    /** Lazy-initialized AgentJsonManager */
+    private _agentJson;
+    /** Lazy-initialized ProcessManager */
+    private _processes;
     /** Ed25519 private key (DER format) - used for signing */
     private readonly _privateKey;
     /** Base64-encoded Ed25519 public key (SPKI DER format) */
@@ -700,6 +706,34 @@ export declare class KadiClient {
      * Sets up graceful shutdown to disconnect loaded abilities.
      */
     private serveBroker;
+    /**
+     * Access the AgentJsonManager for reading/writing agent.json files.
+     *
+     * Lazily created on first access. Provides unified API for project root,
+     * installed ability, and KADI home agent.json files.
+     *
+     * @example
+     * ```typescript
+     * const config = await client.agentJson.readProject();
+     * const deploy = await client.agentJson.readProject('deploy.local');
+     * await client.agentJson.writeProject('deploy.staging', { target: 'akash' });
+     * ```
+     */
+    get agentJson(): AgentJsonManager;
+    /**
+     * Access the ProcessManager for spawning and managing background processes.
+     *
+     * Lazily created on first access. Supports headless, piped, and bridge modes.
+     *
+     * @example
+     * ```typescript
+     * const build = await client.processes.spawn('build', {
+     *   command: 'docker', args: ['build', '.'], mode: 'piped',
+     * });
+     * build.on('exit', ({ exitCode }) => console.log('done:', exitCode));
+     * ```
+     */
+    get processes(): ProcessManager;
     /**
      * Get agent information (for readAgentJson protocol).
      */

package/dist/client.d.ts.map

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