@kadi.build/core 0.9.0 → 0.11.0

package/src/client.ts

@@ -59,6 +59,8 @@ import { resolveAbilityEntry, resolveAbilityScript } from './lockfile.js';
 import { loadNativeTransport } from './transports/native.js';
 import { loadStdioTransport } from './transports/stdio.js';
 import { loadBrokerTransport } from './transports/broker.js';
+import { AgentJsonManager } from './agent-json.js';
+import { ProcessManager } from './process-manager.js';
 
 // ═══════════════════════════════════════════════════════════════
 // CONSTANTS
@@ -204,6 +206,12 @@ export class KadiClient {
   /** Registered disconnect hooks */
   private readonly disconnectHooks: Array<() => Promise<void>> = [];
 
+  /** Lazy-initialized AgentJsonManager */
+  private _agentJson: AgentJsonManager | null = null;
+
+  /** Lazy-initialized ProcessManager */
+  private _processes: ProcessManager | null = null;
+
   // ─────────────────────────────────────────────────────────────
   // IDENTITY (single keypair shared across all broker connections)
   // ─────────────────────────────────────────────────────────────
@@ -2409,6 +2417,54 @@ export class KadiClient {
     await new Promise(() => {});
   }
 
+  // ─────────────────────────────────────────────────────────────
+  // AGENT JSON MANAGER
+  // ─────────────────────────────────────────────────────────────
+
+  /**
+   * 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 {
+    if (!this._agentJson) {
+      this._agentJson = new AgentJsonManager();
+    }
+    return this._agentJson;
+  }
+
+  // ─────────────────────────────────────────────────────────────
+  // PROCESS MANAGER
+  // ─────────────────────────────────────────────────────────────
+
+  /**
+   * 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 {
+    if (!this._processes) {
+      this._processes = new ProcessManager();
+    }
+    return this._processes;
+  }
+
   // ─────────────────────────────────────────────────────────────
   // UTILITY
   // ─────────────────────────────────────────────────────────────

package/src/errors.ts

@@ -65,6 +65,21 @@ export type ErrorCode =
   | 'INVALID_INPUT'
   | 'PROJECT_ROOT_NOT_FOUND'
 
+  // Agent.json errors
+  | 'AGENT_JSON_NOT_FOUND'
+  | 'AGENT_JSON_PARSE_ERROR'
+  | 'AGENT_JSON_WRITE_ERROR'
+  | 'AGENT_JSON_FIELD_NOT_FOUND'
+  | 'AGENT_JSON_VERSION_AMBIGUOUS'
+
+  // Process manager errors
+  | 'PROCESS_ALREADY_EXISTS'
+  | 'PROCESS_NOT_FOUND'
+  | 'PROCESS_NOT_RUNNING'
+  | 'PROCESS_BRIDGE_ERROR'
+  | 'PROCESS_SPAWN_FAILED'
+  | 'PROCESS_TIMEOUT'
+
   // Transport errors
   | 'STDIO_ERROR'
   | 'STDIO_PROCESS_FAILED'

package/src/index.ts

@@ -91,8 +91,40 @@ export type {
 
   // Script resolution
   ResolvedScript,
+
+  // Agent.json types
+  AgentJson,
+  AgentJsonScripts,
+  AgentJsonBuildProfile,
+  AgentJsonDeployProfile,
+  AgentJsonManagerOptions,
+  ReadAbilityOptions,
+  AbilityInfo,
+  AgentJsonPaths,
+
+  // Process manager types
+  ProcessMode,
+  ProcessState,
+  SpawnOptions,
+  ProcessInfo,
+  ProcessExitInfo,
+  ProcessOutput,
+  ProcessListOptions,
+  ProcessPruneOptions,
 } from './types.js';
 
+// Agent.json manager
+export { AgentJsonManager } from './agent-json.js';
+
+// Process manager
+export { ProcessManager, ManagedProcess } from './process-manager.js';
+
+// Dot-path utilities
+export { getByPath, setByPath, deleteByPath, deepMerge } from './utils.js';
+
+// Stdio framing (for advanced use cases — building custom bridge protocols)
+export { StdioMessageReader, StdioMessageWriter } from './stdio-framing.js';
+
 // Zod utilities
 export { zodToJsonSchema, isZodSchema } from './zod.js';