@agent-relay/harnesses 10.6.6 → 11.0.0

package/README.md

@@ -1,7 +1,74 @@
 # @agent-relay/harnesses
 
-Pre-built harness definitions for common local agent CLIs.
+Pre-built harness definitions for local coding agents. Requires Node.js 22 or newer.
 
-Use this package with `@agent-relay/harness-driver` when Agent Relay should create or
-supervise managed sessions for tools such as Claude Code, Codex, Gemini,
-OpenCode, Aider, Goose, Grok, Cursor, or Droid.
+Use this package with `@agent-relay/harness-driver` when Agent Relay should create or supervise managed sessions.
+
+## Runtime selection
+
+Claude Code, Codex, and OpenCode offer both an official AI SDK native harness runtime and the existing PTY runtime. Their adapters begin as experimental, so `auto` continues to select PTY until each adapter passes its promotion gates.
+
+```ts
+import { claude } from '@agent-relay/harnesses';
+
+await claude.create({ relay }); // auto: PTY while the adapter is experimental
+await claude.create({ relay, runtime: 'native' }); // explicit native harness runtime
+await claude.create({ relay, runtime: 'pty' }); // explicit terminal runtime
+```
+
+Runtime selection is final before the session starts. Relay does not switch a running session between PTY and AI SDK.
+
+| Harness         | AI SDK adapter                       | PTY | Initial selection                        |
+| --------------- | ------------------------------------ | --- | ---------------------------------------- |
+| Claude Code     | `@ai-sdk/harness-claude-code@1.0.35` | yes | PTY; native is explicit and experimental |
+| Codex           | `@ai-sdk/harness-codex@1.0.40`       | yes | PTY; native is explicit and experimental |
+| OpenCode        | `@ai-sdk/harness-opencode@1.0.35`    | yes | PTY; native is explicit and experimental |
+| Pi              | `@ai-sdk/harness-pi@1.0.34`          | no  | explicit experimental native             |
+| Deep Agents     | `@ai-sdk/harness-deepagents@1.0.33`  | no  | explicit experimental native             |
+| Other built-ins | none                                 | yes | PTY                                      |
+
+Pi and Deep Agents require `runtime: 'native'` while experimental. Deep Agents does not advertise manual compaction, and stopping its current adapter does not preserve in-memory conversation.
+
+Harness execution is `pty` or `native`. The broker may internally wrap native harnesses and attached app servers as `headless` processes, but `headless` is not an observability mode. Both execution paths publish the same normalized `AgentEvent` contract.
+
+Native sessions receive authenticated Agent Relay host tools and collaboration instructions at startup. They can discover agents and channels, check or search messages, send DMs, post to channels, and reply to threads without relying on a provider-global MCP configuration or extra prompting from the user.
+
+## Native harness attach
+
+AI SDK sessions expose agent-event history and live events instead of terminal bytes:
+
+```bash
+agent-relay node agent attach my-agent --mode view
+agent-relay node agent attach my-agent --mode drive
+agent-relay node agent attach my-agent --mode view --json
+agent-relay node agent attach my-agent --mode view --reasoning --diagnostics
+```
+
+`view` is read-only. `drive` sends each input line after broker acknowledgement; `/interrupt`, `/approve <id>`, `/reject <id>`, and `/detach` are local controls. `passthrough` is unavailable because a native harness session has no terminal byte stream. `--json` writes normalized NDJSON to stdout. Reasoning and diagnostics stay hidden unless requested.
+
+## Observability
+
+The AI SDK stream is Relay's reference observability profile. Relay publishes portable agent events and the activities `starting`, `thinking`, `typing`, `using_tool`, `waiting`, `idle`, and `error`. Every event carries its source and either `exact` or `inferred` fidelity.
+
+PTY sessions use the same capability matrix. Today the broker provides exact startup and runtime failure plus inferred busy and idle boundaries. Signals that terminal bytes cannot prove, including reasoning, text blocks, tools, approvals, files, and compaction, are reported as unavailable rather than guessed.
+
+Another Relay application can inspect events successfully accepted into Relaycast's durable agent log through the messaging surface:
+
+```ts
+const activity = await relay.messaging.sessionEvents?.list('my-agent', {
+  type: 'activity.changed',
+  limit: 100,
+});
+```
+
+The broker owns PTY publication for every spawn surface. A managed `create({ relay })` call additionally mirrors those broker events into listeners on that local `AgentRelay` instance.
+
+Hosted publication is operational observability, not a lossless audit ledger. The broker preserves order through a bounded publisher queue and logs queue, timeout, and Relaycast failures locally; events can be absent during a sustained outage or broker crash.
+
+## Local-host security and troubleshooting
+
+The AI SDK local-host provider is a process and filesystem lifecycle boundary, not an operating-system sandbox. It rejects lexical traversal and static symlink escapes on a best-effort basis for adapter file operations, holds bridge ports on loopback until handing them to the adapter process, and terminates only child processes it started. Concurrent filesystem mutation by another process is outside this boundary, so the path guard is not TOCTOU-safe and must not be used as isolation for untrusted code.
+
+The local-host AI SDK runtime currently supports macOS and Linux. On Windows, use the PTY runtime; an explicit native selection fails with a typed platform error instead of attempting POSIX adapter bootstrap commands. Preflight checks the platform, Node.js 22, `pnpm`, workspace access, cache access, and loopback port allocation. If startup fails, verify those commands and permissions first. Bootstrap work is cached by stable adapter identity under the runtime cache; deleting unrelated workspace files is never part of cleanup.
+
+Adapter upgrades must keep the `@ai-sdk/harness@1.0.34` family coherent and pass the registry, lifecycle, agent-event replay, observability, real-CLI, and 100-cycle soak contracts before changing an adapter's rollout state.

package/dist/ai-sdk/adapter-registry.d.ts

@@ -0,0 +1,47 @@
+import type { HarnessV1 } from '@ai-sdk/harness';
+export type AiSdkAdapterRollout = 'experimental' | 'validated' | 'default';
+export interface AiSdkLifecycleCapabilities {
+    activeInput: boolean;
+    toolApprovals: boolean;
+    compact: boolean;
+    continueTurn: boolean;
+    suspendTurn: boolean;
+    detach: boolean;
+    stop: boolean;
+    destroy: boolean;
+    stopPreservesConversation: boolean;
+}
+export interface RelayAdapterSettings {
+    model?: string;
+    auth?: unknown;
+    port?: number;
+    startupTimeoutMs?: number;
+    maxTurns?: number;
+    thinking?: unknown;
+    thinkingLevel?: unknown;
+    reasoningEffort?: 'low' | 'medium' | 'high';
+    reasoningVariant?: string;
+    provider?: string;
+    webSearch?: boolean;
+    recursionLimit?: number;
+}
+export interface AiSdkAdapterRegistryEntry {
+    readonly name: string;
+    readonly aliases: readonly string[];
+    readonly packageName: string;
+    readonly execution: 'bridge' | 'host';
+    readonly lifecycle: AiSdkLifecycleCapabilities;
+    readonly ptyAvailable: boolean;
+    readonly rollout: AiSdkAdapterRollout;
+    readonly mapSettings: (settings: RelayAdapterSettings) => Record<string, unknown>;
+    readonly createHarness: (settings?: RelayAdapterSettings) => Promise<HarnessV1>;
+}
+export declare class AiSdkAdapterRegistry {
+    #private;
+    constructor(entries?: readonly AiSdkAdapterRegistryEntry[]);
+    list(): readonly AiSdkAdapterRegistryEntry[];
+    get(name: string): AiSdkAdapterRegistryEntry | undefined;
+    require(name: string): AiSdkAdapterRegistryEntry;
+}
+export declare const aiSdkAdapterRegistry: AiSdkAdapterRegistry;
+//# sourceMappingURL=adapter-registry.d.ts.map

package/dist/ai-sdk/adapter-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-registry.d.ts","sourceRoot":"","sources":["../../src/ai-sdk/adapter-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,MAAM,mBAAmB,GAAG,cAAc,GAAG,WAAW,GAAG,SAAS,CAAC;AAE3E,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,yBAAyB,EAAE,OAAO,CAAC;CACpC;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC5C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,QAAQ,GAAG,MAAM,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,0BAA0B,CAAC;IAC/C,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,oBAAoB,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClF,QAAQ,CAAC,aAAa,EAAE,CAAC,QAAQ,CAAC,EAAE,oBAAoB,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;CACjF;AA0JD,qBAAa,oBAAoB;;gBAInB,OAAO,GAAE,SAAS,yBAAyB,EAAY;IAWnE,IAAI,IAAI,SAAS,yBAAyB,EAAE;IAI5C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,yBAAyB,GAAG,SAAS;IAIxD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,yBAAyB;CAKjD;AAED,eAAO,MAAM,oBAAoB,sBAA6B,CAAC"}

package/dist/ai-sdk/adapter-registry.js

@@ -0,0 +1,134 @@
+function pickSettings(settings, keys) {
+    const mapped = {};
+    for (const key of keys) {
+        const value = settings[key];
+        if (value !== undefined)
+            mapped[key] = value;
+    }
+    return mapped;
+}
+function lazyFactory(packageName, load, exportName, mapSettings) {
+    return async (settings) => {
+        let loaded;
+        try {
+            loaded = await load();
+        }
+        catch (error) {
+            throw new Error(`AI SDK harness adapter ${packageName} is unavailable`, { cause: error });
+        }
+        const factory = loaded[exportName];
+        if (typeof factory !== 'function') {
+            throw new Error(`AI SDK harness adapter ${packageName} does not export ${exportName}`);
+        }
+        return factory(mapSettings(settings ?? {}));
+    };
+}
+const FULL_LIFECYCLE = {
+    activeInput: true,
+    toolApprovals: true,
+    compact: true,
+    continueTurn: true,
+    suspendTurn: true,
+    detach: true,
+    stop: true,
+    destroy: true,
+    stopPreservesConversation: true,
+};
+// The upstream adapter currently defaults to gpt-5.3-codex, which ChatGPT-account
+// authentication no longer accepts. Keep Relay's default aligned with Codex CLI
+// while still allowing callers to select another supported model explicitly.
+const DEFAULT_CODEX_MODEL = 'gpt-5.6-terra';
+const codexSettings = (settings) => ({
+    model: settings.model ?? DEFAULT_CODEX_MODEL,
+    ...pickSettings(settings, ['auth', 'port', 'startupTimeoutMs', 'reasoningEffort', 'webSearch']),
+});
+const openCodeSettings = (settings) => pickSettings(settings, ['model', 'auth', 'port', 'startupTimeoutMs', 'provider', 'reasoningVariant']);
+const claudeSettings = (settings) => pickSettings(settings, ['model', 'auth', 'port', 'startupTimeoutMs', 'maxTurns', 'thinking']);
+const piSettings = (settings) => pickSettings(settings, ['model', 'auth', 'thinkingLevel']);
+const deepAgentsSettings = (settings) => pickSettings(settings, ['model', 'auth', 'port', 'startupTimeoutMs', 'recursionLimit']);
+const ENTRIES = [
+    {
+        name: 'claude',
+        aliases: ['claude-code'],
+        packageName: '@ai-sdk/harness-claude-code',
+        execution: 'bridge',
+        lifecycle: FULL_LIFECYCLE,
+        ptyAvailable: true,
+        rollout: 'experimental',
+        mapSettings: claudeSettings,
+        createHarness: lazyFactory('@ai-sdk/harness-claude-code', () => import('@ai-sdk/harness-claude-code'), 'createClaudeCode', claudeSettings),
+    },
+    {
+        name: 'codex',
+        aliases: [],
+        packageName: '@ai-sdk/harness-codex',
+        execution: 'bridge',
+        lifecycle: FULL_LIFECYCLE,
+        ptyAvailable: true,
+        rollout: 'experimental',
+        mapSettings: codexSettings,
+        createHarness: lazyFactory('@ai-sdk/harness-codex', () => import('@ai-sdk/harness-codex'), 'createCodex', codexSettings),
+    },
+    {
+        name: 'opencode',
+        aliases: ['open-code'],
+        packageName: '@ai-sdk/harness-opencode',
+        execution: 'bridge',
+        lifecycle: FULL_LIFECYCLE,
+        ptyAvailable: true,
+        rollout: 'experimental',
+        mapSettings: openCodeSettings,
+        createHarness: lazyFactory('@ai-sdk/harness-opencode', () => import('@ai-sdk/harness-opencode'), 'createOpenCode', openCodeSettings),
+    },
+    {
+        name: 'pi',
+        aliases: [],
+        packageName: '@ai-sdk/harness-pi',
+        execution: 'host',
+        lifecycle: FULL_LIFECYCLE,
+        ptyAvailable: false,
+        rollout: 'experimental',
+        mapSettings: piSettings,
+        createHarness: lazyFactory('@ai-sdk/harness-pi', () => import('@ai-sdk/harness-pi'), 'createPi', piSettings),
+    },
+    {
+        name: 'deepagents',
+        aliases: ['deep-agents'],
+        packageName: '@ai-sdk/harness-deepagents',
+        execution: 'bridge',
+        lifecycle: { ...FULL_LIFECYCLE, compact: false, stopPreservesConversation: false },
+        ptyAvailable: false,
+        rollout: 'experimental',
+        mapSettings: deepAgentsSettings,
+        createHarness: lazyFactory('@ai-sdk/harness-deepagents', () => import('@ai-sdk/harness-deepagents'), 'createDeepAgents', deepAgentsSettings),
+    },
+];
+export class AiSdkAdapterRegistry {
+    #byName = new Map();
+    #entries;
+    constructor(entries = ENTRIES) {
+        this.#entries = [...entries];
+        for (const entry of entries) {
+            for (const candidate of [entry.name, ...entry.aliases]) {
+                const key = candidate.toLowerCase();
+                if (this.#byName.has(key))
+                    throw new Error(`Duplicate AI SDK adapter alias: ${candidate}`);
+                this.#byName.set(key, entry);
+            }
+        }
+    }
+    list() {
+        return this.#entries;
+    }
+    get(name) {
+        return this.#byName.get(name.toLowerCase());
+    }
+    require(name) {
+        const entry = this.get(name);
+        if (!entry)
+            throw new Error(`No AI SDK harness adapter is registered for ${name}`);
+        return entry;
+    }
+}
+export const aiSdkAdapterRegistry = new AiSdkAdapterRegistry();
+//# sourceMappingURL=adapter-registry.js.map

package/dist/ai-sdk/adapter-registry.js.map

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

package/dist/ai-sdk/harness-host.d.ts

@@ -0,0 +1,83 @@
+import type { HarnessV1, HarnessV1Bootstrap, HarnessV1ContinueTurnState, HarnessV1Diagnostic, HarnessV1Observability, HarnessV1PermissionMode, HarnessV1ResumeSessionState, HarnessV1SandboxProvider, HarnessV1Skill, HarnessV1StreamPart, HarnessV1ToolSpec } from '@ai-sdk/harness';
+import type { Experimental_SandboxSession as SandboxSession } from '@ai-sdk/provider-utils';
+export type HarnessHostState = 'new' | 'starting' | 'ready' | 'running' | 'suspended' | 'detached' | 'stopped' | 'destroyed' | 'failed';
+export interface HarnessEventObservability {
+    source: 'ai-sdk';
+    fidelity: 'exact';
+    sequence: number;
+    timestamp: string;
+    turnId?: string;
+}
+export interface NormalizedHarnessEvent {
+    type: string;
+    observability: HarnessEventObservability;
+    [key: string]: unknown;
+}
+type NormalizedHarnessEventInput = {
+    type: string;
+    [key: string]: unknown;
+};
+export interface HarnessHostOptions {
+    harness: HarnessV1;
+    sandboxProvider: HarnessV1SandboxProvider;
+    workspace: string;
+    sessionId?: string;
+    permissionMode?: HarnessV1PermissionMode;
+    skills?: readonly HarnessV1Skill[];
+    instructions?: string;
+    tools?: readonly HarnessHostTool[];
+    observability?: HarnessV1Observability;
+    abortSignal?: AbortSignal;
+    resumeFrom?: HarnessV1ResumeSessionState;
+    continueFrom?: HarnessV1ContinueTurnState;
+    onEvent?: (event: NormalizedHarnessEvent) => void | Promise<void>;
+    onDiagnostic?: (diagnostic: HarnessV1Diagnostic) => void | Promise<void>;
+    /** Bounded retries with a fresh local port when an adapter bridge loses a bind race. */
+    portBindRetries?: number;
+}
+export interface HarnessHostTool {
+    spec: HarnessV1ToolSpec;
+    execute(input: unknown, options: {
+        abortSignal?: AbortSignal;
+    }): Promise<unknown> | unknown;
+}
+export interface HarnessTurnHandle {
+    turnId: string;
+    done: Promise<void>;
+}
+declare function applyBootstrap(recipe: HarnessV1Bootstrap, session: SandboxSession, abortSignal?: AbortSignal): Promise<void>;
+declare function streamEvents(part: HarnessV1StreamPart): NormalizedHarnessEventInput[];
+export declare class HarnessHost {
+    #private;
+    readonly harness: HarnessV1;
+    readonly sandboxProvider: HarnessV1SandboxProvider;
+    readonly workspace: string;
+    readonly sessionId: string;
+    constructor(options: HarnessHostOptions);
+    get state(): HarnessHostState;
+    get activeTurnId(): string | undefined;
+    get hasActiveTurn(): boolean;
+    onEvent(listener: (event: NormalizedHarnessEvent) => void | Promise<void>): () => void;
+    start(): Promise<void>;
+    startTurn(prompt: string, turnId?: string): Promise<HarnessTurnHandle>;
+    submitUserMessage(text: string): Promise<void>;
+    submitToolResult(input: {
+        toolCallId: string;
+        output: unknown;
+        isError?: boolean;
+    }): Promise<void>;
+    submitToolApproval(input: {
+        approvalId: string;
+        approved: boolean;
+        reason?: string;
+    }): Promise<void>;
+    interrupt(reason?: string): Promise<void>;
+    compact(customInstructions?: string): Promise<void>;
+    suspend(): Promise<HarnessV1ContinueTurnState>;
+    continue(state: HarnessV1ContinueTurnState, turnId?: string): Promise<HarnessTurnHandle>;
+    detach(): Promise<HarnessV1ResumeSessionState>;
+    stop(): Promise<HarnessV1ResumeSessionState>;
+    destroy(): Promise<void>;
+}
+export { applyBootstrap, streamEvents as normalizeHarnessStreamPart };
+//# sourceMappingURL=harness-host.d.ts.map

package/dist/ai-sdk/harness-host.d.ts.map

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