@skaile/forge-agent-runtime 1.0.0 → 1.1.0

package/dist/index.d.mts

@@ -1,7 +1,8 @@
 import { EventEmitter } from 'node:events';
 import { AgentClient } from '@skaile/workspaces/sdk/client';
-import { AgentCommand as AgentCommand$1, AgentEvent as AgentEvent$1, MessageV2 } from '@skaile/workspaces/sdk/types';
+import { AgentCommand, AgentEvent as AgentEvent$1, MessageV2 } from '@skaile/workspaces/sdk/types';
 import { AIProviderRegistryView } from '@skaile/forge-settings/server';
+import { a as AgentAdapter, b as AgentAdapterConfig, c as AgentCommand$1, A as AgentEvent, d as AgentStatus } from './shared/forge-agent-runtime.DlNAoPjs.mjs';
 import { SubscriberTransport, SessionDispatcher, MessageStore } from '@skaile/workspaces/sdk/session';
 
 /**
@@ -118,7 +119,7 @@ declare class AgentProcessManager extends EventEmitter {
      * Send any AgentCommand to the managed process.
      * Used internally by ProcessManagerClientTransport.
      */
-    sendCommand(id: string, command: AgentCommand$1): void;
+    sendCommand(id: string, command: AgentCommand): void;
     /**
      * Create an AgentClient for a managed session.
      * Uses ProcessManagerClientTransport so there is no second subscription
@@ -133,125 +134,6 @@ declare class AgentProcessManager extends EventEmitter {
     private waitForReady;
 }
 
-/**
- * AgentAdapter — canonical interface for forge agent harnesses.
- *
- * Every harness (omp, claude-sdk, codex, …) runs behind an adapter that
- * implements this interface. Apps depend only on this contract, not the
- * concrete adapter type.
- *
- * Lifecycle:
- *   1. Call `connect(config)` — spawns the subprocess or initialises the SDK client.
- *   2. Call `sendCommand(cmd)` to dispatch prompts and control commands.
- *   3. Call `listen()` to consume the async event stream.
- *   4. Call `abort()` to cancel an in-flight turn.
- *   5. Call `disconnect()` to tear down cleanly.
- *
- * Adapters are STATEFUL: one instance per active agent session.
- */
-
-/** Input to the agent: a natural-language prompt or a control message. */
-interface AgentCommand {
-    type: string;
-    [key: string]: unknown;
-}
-/** Output from the agent: any typed event from the skaile protocol. */
-interface AgentEvent {
-    type: string;
-    [key: string]: unknown;
-}
-/** Observable lifecycle state of an adapter instance. */
-type AgentStatus = "idle" | "running" | "error" | "disconnected";
-/**
- * Configuration passed to `AgentAdapter.connect()`.
- *
- * All fields mirror `AgentProcessConfig` from `agent-process.ts`
- * so the ProcessManagerAdapter can pass them through unchanged.
- */
-interface AgentAdapterConfig {
-    /** Working directory for the agent (--project-dir) */
-    projectDir: string;
-    /** Bridge harness type (omp, claude-sdk). Defaults to 'omp'. */
-    harness?: string;
-    /**
-     * The AI provider registry the session runs against. The adapter resolves
-     * each enabled entry's credential reference and delivers it through the
-     * child environment.
-     */
-    registry?: AIProviderRegistryView;
-    /**
-     * Registry entry ids the session is restricted to (`--providers a,b`).
-     * Absent or empty: the session sees the whole registry. `registry` should
-     * already be narrowed to the same ids so only their credentials are delivered.
-     */
-    providers?: string[];
-    /**
-     * The layered environment `env:` references resolve against and the child
-     * env is based on; defaults to `process.env`.
-     */
-    credentialEnv?: Record<string, string | undefined>;
-    /** Model selection as `"<providerId>/<modelId>"`, a bare model id, or `@role` */
-    model?: string;
-    /** Environment variables injected into the subprocess */
-    env?: Record<string, string>;
-    /** System prompt written to .skaile/system-prompt.md before spawn */
-    systemPrompt?: string;
-    /** Max agentic turns */
-    maxTurns?: number;
-    /** GitAgent definition directory */
-    agentDir?: string;
-    /** OMP harness session ID for native resume */
-    harnessSessionId?: string;
-    /** Address the subprocess binds and the client dials. Absent: runtime default bind, dial `127.0.0.1`. */
-    host?: string;
-    /** Bearer token the subprocess WebSocket requires and the client presents. Absent: no authentication. */
-    wsAuthToken?: string;
-}
-/**
- * Canonical interface for all forge agent harnesses.
- *
- * Implementations wrap the `AgentProcessManager` pattern used by the existing
- * forge apps, exposing a minimal async API that higher-level managers consume.
- */
-interface AgentAdapter {
-    /**
-     * Connect to the agent harness and prepare it for commands.
-     * Must be called once before `sendCommand` or `listen`.
-     */
-    connect(config: AgentAdapterConfig): Promise<void>;
-    /**
-     * Send a command to the connected agent.
-     * Throws if `connect()` has not been called or the session has disconnected.
-     */
-    sendCommand(command: AgentCommand): Promise<void>;
-    /**
-     * Return an async iterable of agent events.
-     * The iterable completes when the adapter disconnects.
-     *
-     * Callers can use `for await (const event of adapter.listen()) { ... }` or
-     * subscribe via an EventEmitter bridge (see BaseAgentManager).
-     */
-    listen(): AsyncIterable<AgentEvent>;
-    /**
-     * Cancel the current in-flight agent turn.
-     * No-op if the agent is idle.
-     */
-    abort(): Promise<void>;
-    /**
-     * Whether the adapter is connected and the agent is ready to receive commands.
-     */
-    isConnected(): boolean;
-    /**
-     * Observable lifecycle state.
-     */
-    getStatus(): AgentStatus;
-    /**
-     * Tear down the adapter: disconnect, stop subprocess if applicable, release resources.
-     * Safe to call multiple times.
-     */
-    disconnect(): Promise<void>;
-}
-
 /**
  * ProcessManagerAdapter — AgentAdapter implementation backed by AgentProcessManager.
  *
@@ -268,7 +150,7 @@ declare class ProcessManagerAdapter implements AgentAdapter {
     private status;
     constructor();
     connect(config: AgentAdapterConfig): Promise<void>;
-    sendCommand(command: AgentCommand): Promise<void>;
+    sendCommand(command: AgentCommand$1): Promise<void>;
     listen(): AsyncIterable<AgentEvent>;
     abort(): Promise<void>;
     isConnected(): boolean;
@@ -589,5 +471,5 @@ declare class FanoutTransport {
     get subscriberCount(): number;
 }
 
-export { AgentProcessManager, BaseAgentManager, EventEmitterSubscriberTransport, FanoutTransport, JsonlMessageStore, ProcessManagerAdapter, createAdapterForHarness, listRegisteredHarnesses, registerHarness };
-export type { AgentAdapter, AgentAdapterConfig, AgentCommand, AgentEvent, AgentProcessConfig, AgentStatus, ManagedSession };
+export { AgentAdapter, AgentAdapterConfig, AgentCommand$1 as AgentCommand, AgentEvent, AgentProcessManager, AgentStatus, BaseAgentManager, EventEmitterSubscriberTransport, FanoutTransport, JsonlMessageStore, ProcessManagerAdapter, createAdapterForHarness, listRegisteredHarnesses, registerHarness };
+export type { AgentProcessConfig, ManagedSession };

package/dist/index.d.ts

@@ -1,7 +1,8 @@
 import { EventEmitter } from 'node:events';
 import { AgentClient } from '@skaile/workspaces/sdk/client';
-import { AgentCommand as AgentCommand$1, AgentEvent as AgentEvent$1, MessageV2 } from '@skaile/workspaces/sdk/types';
+import { AgentCommand, AgentEvent as AgentEvent$1, MessageV2 } from '@skaile/workspaces/sdk/types';
 import { AIProviderRegistryView } from '@skaile/forge-settings/server';
+import { a as AgentAdapter, b as AgentAdapterConfig, c as AgentCommand$1, A as AgentEvent, d as AgentStatus } from './shared/forge-agent-runtime.DlNAoPjs.js';
 import { SubscriberTransport, SessionDispatcher, MessageStore } from '@skaile/workspaces/sdk/session';
 
 /**
@@ -118,7 +119,7 @@ declare class AgentProcessManager extends EventEmitter {
      * Send any AgentCommand to the managed process.
      * Used internally by ProcessManagerClientTransport.
      */
-    sendCommand(id: string, command: AgentCommand$1): void;
+    sendCommand(id: string, command: AgentCommand): void;
     /**
      * Create an AgentClient for a managed session.
      * Uses ProcessManagerClientTransport so there is no second subscription
@@ -133,125 +134,6 @@ declare class AgentProcessManager extends EventEmitter {
     private waitForReady;
 }
 
-/**
- * AgentAdapter — canonical interface for forge agent harnesses.
- *
- * Every harness (omp, claude-sdk, codex, …) runs behind an adapter that
- * implements this interface. Apps depend only on this contract, not the
- * concrete adapter type.
- *
- * Lifecycle:
- *   1. Call `connect(config)` — spawns the subprocess or initialises the SDK client.
- *   2. Call `sendCommand(cmd)` to dispatch prompts and control commands.
- *   3. Call `listen()` to consume the async event stream.
- *   4. Call `abort()` to cancel an in-flight turn.
- *   5. Call `disconnect()` to tear down cleanly.
- *
- * Adapters are STATEFUL: one instance per active agent session.
- */
-
-/** Input to the agent: a natural-language prompt or a control message. */
-interface AgentCommand {
-    type: string;
-    [key: string]: unknown;
-}
-/** Output from the agent: any typed event from the skaile protocol. */
-interface AgentEvent {
-    type: string;
-    [key: string]: unknown;
-}
-/** Observable lifecycle state of an adapter instance. */
-type AgentStatus = "idle" | "running" | "error" | "disconnected";
-/**
- * Configuration passed to `AgentAdapter.connect()`.
- *
- * All fields mirror `AgentProcessConfig` from `agent-process.ts`
- * so the ProcessManagerAdapter can pass them through unchanged.
- */
-interface AgentAdapterConfig {
-    /** Working directory for the agent (--project-dir) */
-    projectDir: string;
-    /** Bridge harness type (omp, claude-sdk). Defaults to 'omp'. */
-    harness?: string;
-    /**
-     * The AI provider registry the session runs against. The adapter resolves
-     * each enabled entry's credential reference and delivers it through the
-     * child environment.
-     */
-    registry?: AIProviderRegistryView;
-    /**
-     * Registry entry ids the session is restricted to (`--providers a,b`).
-     * Absent or empty: the session sees the whole registry. `registry` should
-     * already be narrowed to the same ids so only their credentials are delivered.
-     */
-    providers?: string[];
-    /**
-     * The layered environment `env:` references resolve against and the child
-     * env is based on; defaults to `process.env`.
-     */
-    credentialEnv?: Record<string, string | undefined>;
-    /** Model selection as `"<providerId>/<modelId>"`, a bare model id, or `@role` */
-    model?: string;
-    /** Environment variables injected into the subprocess */
-    env?: Record<string, string>;
-    /** System prompt written to .skaile/system-prompt.md before spawn */
-    systemPrompt?: string;
-    /** Max agentic turns */
-    maxTurns?: number;
-    /** GitAgent definition directory */
-    agentDir?: string;
-    /** OMP harness session ID for native resume */
-    harnessSessionId?: string;
-    /** Address the subprocess binds and the client dials. Absent: runtime default bind, dial `127.0.0.1`. */
-    host?: string;
-    /** Bearer token the subprocess WebSocket requires and the client presents. Absent: no authentication. */
-    wsAuthToken?: string;
-}
-/**
- * Canonical interface for all forge agent harnesses.
- *
- * Implementations wrap the `AgentProcessManager` pattern used by the existing
- * forge apps, exposing a minimal async API that higher-level managers consume.
- */
-interface AgentAdapter {
-    /**
-     * Connect to the agent harness and prepare it for commands.
-     * Must be called once before `sendCommand` or `listen`.
-     */
-    connect(config: AgentAdapterConfig): Promise<void>;
-    /**
-     * Send a command to the connected agent.
-     * Throws if `connect()` has not been called or the session has disconnected.
-     */
-    sendCommand(command: AgentCommand): Promise<void>;
-    /**
-     * Return an async iterable of agent events.
-     * The iterable completes when the adapter disconnects.
-     *
-     * Callers can use `for await (const event of adapter.listen()) { ... }` or
-     * subscribe via an EventEmitter bridge (see BaseAgentManager).
-     */
-    listen(): AsyncIterable<AgentEvent>;
-    /**
-     * Cancel the current in-flight agent turn.
-     * No-op if the agent is idle.
-     */
-    abort(): Promise<void>;
-    /**
-     * Whether the adapter is connected and the agent is ready to receive commands.
-     */
-    isConnected(): boolean;
-    /**
-     * Observable lifecycle state.
-     */
-    getStatus(): AgentStatus;
-    /**
-     * Tear down the adapter: disconnect, stop subprocess if applicable, release resources.
-     * Safe to call multiple times.
-     */
-    disconnect(): Promise<void>;
-}
-
 /**
  * ProcessManagerAdapter — AgentAdapter implementation backed by AgentProcessManager.
  *
@@ -268,7 +150,7 @@ declare class ProcessManagerAdapter implements AgentAdapter {
     private status;
     constructor();
     connect(config: AgentAdapterConfig): Promise<void>;
-    sendCommand(command: AgentCommand): Promise<void>;
+    sendCommand(command: AgentCommand$1): Promise<void>;
     listen(): AsyncIterable<AgentEvent>;
     abort(): Promise<void>;
     isConnected(): boolean;
@@ -589,5 +471,5 @@ declare class FanoutTransport {
     get subscriberCount(): number;
 }
 
-export { AgentProcessManager, BaseAgentManager, EventEmitterSubscriberTransport, FanoutTransport, JsonlMessageStore, ProcessManagerAdapter, createAdapterForHarness, listRegisteredHarnesses, registerHarness };
-export type { AgentAdapter, AgentAdapterConfig, AgentCommand, AgentEvent, AgentProcessConfig, AgentStatus, ManagedSession };
+export { AgentAdapter, AgentAdapterConfig, AgentCommand$1 as AgentCommand, AgentEvent, AgentProcessManager, AgentStatus, BaseAgentManager, EventEmitterSubscriberTransport, FanoutTransport, JsonlMessageStore, ProcessManagerAdapter, createAdapterForHarness, listRegisteredHarnesses, registerHarness };
+export type { AgentProcessConfig, ManagedSession };