@agent-relay/harnesses 10.6.7 → 11.0.0

package/dist/define.js

@@ -1,5 +1,10 @@
+import { randomUUID } from 'node:crypto';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { createAgentHandle, nextHarnessName, } from '@agent-relay/sdk';
 import { getHarnessDriver } from './broker-binding.js';
+import { aiSdkAdapterRegistry } from './ai-sdk/adapter-registry.js';
+import { AI_SDK_REFERENCE_OBSERVABILITY_PROFILE, createPtyObservabilityTranslator, getPtyObservabilityProfile, } from './observability.js';
 /** Wrap a static PTY harness definition in a factory with `create`/`new`. */
 export function definePtyHarness(definition) {
     const build = (input = {}) => {
@@ -17,6 +22,7 @@ export function definePtyHarness(definition) {
             cwd: input.cwd ?? definition.cwd,
             env: input.env ?? definition.env,
             definition,
+            observability: getPtyObservabilityProfile(definition.command),
         };
     };
     const spawnLive = async (input, relay) => {
@@ -32,6 +38,48 @@ export function definePtyHarness(definition) {
             channels: input.channels,
             cwd,
         });
+        const translator = createPtyObservabilityTranslator(definition.command);
+        let turnId;
+        const emitTranslated = (signal) => {
+            for (const event of translator.translate(signal)) {
+                // Broker-owned PTY observability is published to Relaycast for every
+                // spawn surface. This local bridge only feeds listeners on the
+                // AgentRelay instance that created this managed harness.
+                relay.emitSessionEvent(runtime.agent.name, event);
+            }
+        };
+        const signalFromBroker = async (event) => {
+            switch (event.kind) {
+                case 'agent_spawned':
+                    emitTranslated({ type: 'starting' });
+                    return;
+                case 'worker_stream':
+                    turnId ??= `pty-${randomUUID()}`;
+                    emitTranslated({ type: 'busy', turnId });
+                    return;
+                case 'agent_idle':
+                    if (turnId) {
+                        emitTranslated({ type: 'idle', turnId });
+                        turnId = undefined;
+                    }
+                    return;
+                case 'worker_error':
+                    emitTranslated({ type: 'error', error: event.message, code: event.code });
+                    return;
+                case 'agent_exit':
+                case 'agent_exited':
+                    if (event.kind === 'agent_exited' && event.code === 0)
+                        return;
+                    emitTranslated({
+                        type: 'error',
+                        error: event.reason ??
+                            `PTY runtime exited${event.kind === 'agent_exited' && event.code != null ? ` (${event.code})` : ''}`,
+                        ...(event.kind === 'agent_exited' && event.code != null ? { code: String(event.code) } : {}),
+                    });
+                    return;
+            }
+        };
+        await runtime.observeBrokerEvents?.(signalFromBroker);
         // Key the handle by the registered agent name so `agent.status.becomes(...)`
         // predicates match the workspace events emitted for that agent.
         const handle = createAgentHandle({ id: runtime.agent.name, name: runtime.agent.name });
@@ -47,13 +95,166 @@ export function definePtyHarness(definition) {
             cwd,
             env: input.env ?? definition.env,
             definition,
+            observability: getPtyObservabilityProfile(definition.command),
         };
     };
     return {
         ...definition,
         name: definition.command,
-        create: async (input = {}) => (input.relay ? spawnLive(input, input.relay) : build(input)),
+        create: async (input = {}) => {
+            if (input.runtime === 'native') {
+                throw new Error(`No native harness adapter is registered for ${definition.command}`);
+            }
+            return input.relay ? spawnLive(input, input.relay) : build(input);
+        },
         new: (input) => build(input),
     };
 }
+export function selectHarnessRuntime(adapter, requested = 'auto') {
+    if (requested === 'native')
+        return 'native';
+    if (requested === 'pty') {
+        if (!adapter.ptyAvailable)
+            throw new Error(`${adapter.name} does not provide a PTY runtime`);
+        return 'pty';
+    }
+    if (adapter.rollout === 'default')
+        return 'native';
+    if (adapter.ptyAvailable)
+        return 'pty';
+    throw new Error(`${adapter.name} is an experimental native-only harness; select runtime: 'native' explicitly`);
+}
+/** Resolve a public harness name or alias to the runtime the CLI should launch. */
+export function resolveHarnessRuntime(harness, requested = 'auto') {
+    const adapter = aiSdkAdapterRegistry.get(harness);
+    if (!adapter) {
+        if (requested === 'native') {
+            throw new Error(`No native harness adapter is registered for ${harness}`);
+        }
+        return 'pty';
+    }
+    return selectHarnessRuntime(adapter, requested);
+}
+function nativeDescriptor(adapter, input, name = nextHarnessName(adapter.name, input.name)) {
+    const handle = createAgentHandle({ id: `harness:${adapter.name}:${name}`, name });
+    return {
+        ...handle,
+        kind: 'native',
+        cli: adapter.name,
+        runtime: 'native',
+        adapter: adapter.name,
+        model: input.model,
+        task: input.task,
+        args: input.args,
+        channels: input.channels,
+        cwd: input.cwd,
+        env: input.env,
+        observability: AI_SDK_REFERENCE_OBSERVABILITY_PROFILE,
+    };
+}
+function publicNativeLifecycle(adapter) {
+    return {
+        activeInput: adapter.lifecycle.activeInput,
+        toolApprovals: adapter.lifecycle.toolApprovals,
+        compact: adapter.lifecycle.compact,
+        continueTurn: false,
+        suspendTurn: false,
+        detach: false,
+        stop: false,
+        destroy: false,
+        stopPreservesConversation: false,
+    };
+}
+function sessionEventFromAgentEventEnvelope(envelope) {
+    const { kind, ...payload } = envelope.event;
+    if (typeof kind !== 'string')
+        return undefined;
+    return { type: kind, ...payload };
+}
+/**
+ * Build the broker launch contract for an AI SDK-backed native harness.
+ *
+ * Keeping this as a public, side-effect-free resolver lets the CLI launch the
+ * sidecar through an already-running broker instead of starting a second one.
+ */
+export function createNativeHarnessLaunch(adapterName, input = {}, sidecarLaunch) {
+    const adapter = aiSdkAdapterRegistry.require(adapterName);
+    const name = nextHarnessName(adapter.name, input.name);
+    const cwd = path.resolve(input.cwd ?? process.cwd());
+    const sessionId = `native-${randomUUID()}`;
+    const sidecarEntry = fileURLToPath(new URL('./ai-sdk/sidecar-main.js', import.meta.url));
+    const sidecarConfig = {
+        name,
+        harness: adapter.name,
+        workspace: cwd,
+        sessionId,
+        settings: { ...(input.model ? { model: input.model } : {}) },
+    };
+    return {
+        name,
+        cli: adapter.name,
+        task: input.task,
+        model: input.model,
+        channels: input.channels,
+        cwd,
+        transport: 'headless',
+        harnessConfig: {
+            runtime: 'native',
+            command: sidecarLaunch?.command ?? process.execPath,
+            args: sidecarLaunch?.args ?? [sidecarEntry],
+            cwd,
+            env: {
+                ...input.env,
+                RELAY_AI_SDK_SIDECAR_CONFIG: JSON.stringify(sidecarConfig),
+            },
+            sessionId,
+            metadata: {
+                runtimeKind: 'native',
+                nativeHarnessProtocolVersion: 1,
+                // Only operations reachable through the versioned sidecar protocol are
+                // public runtime capabilities. The adapter may support additional
+                // in-process lifecycle methods that cannot safely cross this boundary.
+                nativeHarnessCapabilities: publicNativeLifecycle(adapter),
+                observability: AI_SDK_REFERENCE_OBSERVABILITY_PROFILE,
+            },
+        },
+    };
+}
+async function spawnNative(adapter, input, driver, relay) {
+    const launch = createNativeHarnessLaunch(adapter.name, input);
+    const runtime = await driver.spawn(launch);
+    await runtime.observeAgentEvents?.(async (envelope) => {
+        const event = sessionEventFromAgentEventEnvelope(envelope);
+        if (event)
+            relay.emitSessionEvent(runtime.agent.name, event);
+    });
+    const descriptor = nativeDescriptor(adapter, { ...input, cwd: launch.cwd }, runtime.agent.name);
+    return { ...descriptor, id: runtime.agent.name };
+}
+export function defineManagedHarness(adapterName, ptyDefinition) {
+    const adapter = aiSdkAdapterRegistry.require(adapterName);
+    if (Boolean(ptyDefinition) !== adapter.ptyAvailable) {
+        throw new Error(`PTY availability for ${adapter.name} does not match its registry declaration`);
+    }
+    const pty = ptyDefinition ? definePtyHarness(ptyDefinition) : undefined;
+    const build = (input = {}) => {
+        const runtime = selectHarnessRuntime(adapter, input.runtime);
+        return runtime === 'pty' ? pty.new({ ...input, runtime: 'pty' }) : nativeDescriptor(adapter, input);
+    };
+    return {
+        runtime: ptyDefinition ? 'pty' : 'native',
+        name: adapter.name,
+        command: ptyDefinition?.command ?? adapter.name,
+        adapter,
+        create: async (input = {}) => {
+            const runtime = selectHarnessRuntime(adapter, input.runtime);
+            if (runtime === 'pty')
+                return pty.create({ ...input, runtime: 'pty' });
+            return input.relay
+                ? spawnNative(adapter, input, getHarnessDriver(input.relay), input.relay)
+                : nativeDescriptor(adapter, input);
+        },
+        new: build,
+    };
+}
 //# sourceMappingURL=define.js.map

package/dist/define.js.map

@@ -1 +1 @@
-{"version":3,"file":"define.js","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,eAAe,GAIhB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AA6DvD,6EAA6E;AAC7E,MAAM,UAAU,gBAAgB,CAAC,UAAsC;IACrE,MAAM,KAAK,GAAG,CAAC,QAA4B,EAAE,EAAgB,EAAE;QAC7D,MAAM,IAAI,GAAG,eAAe,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,iBAAiB,CAAC,EAAE,EAAE,EAAE,WAAW,UAAU,CAAC,OAAO,IAAI,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACxF,OAAO;YACL,GAAG,MAAM;YACT,IAAI,EAAE,KAAK;YACX,GAAG,EAAE,UAAU,CAAC,OAAO;YACvB,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,UAAU,CAAC,GAAG;YAChC,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,UAAU,CAAC,GAAG;YAChC,UAAU;SACX,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,KAAK,EAAE,KAAyB,EAAE,KAAiB,EAAyB,EAAE;QAC9F,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC;QACxC,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC;YACjC,IAAI,EAAE,eAAe,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC;YACrD,GAAG,EAAE,UAAU,CAAC,OAAO;YACvB,SAAS,EAAE,KAAK;YAChB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,GAAG;SACJ,CAAC,CAAC;QACH,6EAA6E;QAC7E,gEAAgE;QAChE,MAAM,MAAM,GAAG,iBAAiB,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACvF,OAAO;YACL,GAAG,MAAM;YACT,IAAI,EAAE,KAAK;YACX,GAAG,EAAE,UAAU,CAAC,OAAO;YACvB,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,GAAG;YACH,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,UAAU,CAAC,GAAG;YAChC,UAAU;SACX,CAAC;IACJ,CAAC,CAAC;IAEF,OAAO;QACL,GAAG,UAAU;QACb,IAAI,EAAE,UAAU,CAAC,OAAO;QACxB,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1F,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC;KAC7B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EACL,iBAAiB,EACjB,eAAe,GAKhB,MAAM,kBAAkB,CAAC;AAS1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAkC,MAAM,8BAA8B,CAAC;AACpG,OAAO,EACL,sCAAsC,EACtC,gCAAgC,EAChC,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAqG5B,6EAA6E;AAC7E,MAAM,UAAU,gBAAgB,CAAC,UAAsC;IACrE,MAAM,KAAK,GAAG,CAAC,QAA4B,EAAE,EAAgB,EAAE;QAC7D,MAAM,IAAI,GAAG,eAAe,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,iBAAiB,CAAC,EAAE,EAAE,EAAE,WAAW,UAAU,CAAC,OAAO,IAAI,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACxF,OAAO;YACL,GAAG,MAAM;YACT,IAAI,EAAE,KAAK;YACX,GAAG,EAAE,UAAU,CAAC,OAAO;YACvB,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,UAAU,CAAC,GAAG;YAChC,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,UAAU,CAAC,GAAG;YAChC,UAAU;YACV,aAAa,EAAE,0BAA0B,CAAC,UAAU,CAAC,OAAO,CAAC;SAC9D,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,KAAK,EAAE,KAAyB,EAAE,KAAiB,EAAyB,EAAE;QAC9F,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC;QACxC,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC;YACjC,IAAI,EAAE,eAAe,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC;YACrD,GAAG,EAAE,UAAU,CAAC,OAAO;YACvB,SAAS,EAAE,KAAK;YAChB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,GAAG;SACJ,CAAC,CAAC;QACH,MAAM,UAAU,GAAG,gCAAgC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACxE,IAAI,MAA0B,CAAC;QAC/B,MAAM,cAAc,GAAG,CAAC,MAAkD,EAAE,EAAE;YAC5E,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;gBACjD,qEAAqE;gBACrE,+DAA+D;gBAC/D,yDAAyD;gBACzD,KAAK,CAAC,gBAAgB,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACpD,CAAC;QACH,CAAC,CAAC;QACF,MAAM,gBAAgB,GAAG,KAAK,EAAE,KAAkB,EAAE,EAAE;YACpD,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;gBACnB,KAAK,eAAe;oBAClB,cAAc,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;oBACrC,OAAO;gBACT,KAAK,eAAe;oBAClB,MAAM,KAAK,OAAO,UAAU,EAAE,EAAE,CAAC;oBACjC,cAAc,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;oBACzC,OAAO;gBACT,KAAK,YAAY;oBACf,IAAI,MAAM,EAAE,CAAC;wBACX,cAAc,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;wBACzC,MAAM,GAAG,SAAS,CAAC;oBACrB,CAAC;oBACD,OAAO;gBACT,KAAK,cAAc;oBACjB,cAAc,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;oBAC1E,OAAO;gBACT,KAAK,YAAY,CAAC;gBAClB,KAAK,cAAc;oBACjB,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC;wBAAE,OAAO;oBAC9D,cAAc,CAAC;wBACb,IAAI,EAAE,OAAO;wBACb,KAAK,EACH,KAAK,CAAC,MAAM;4BACZ,qBAAqB,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;wBACtG,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;qBAC7F,CAAC,CAAC;oBACH,OAAO;YACX,CAAC;QACH,CAAC,CAAC;QACF,MAAM,OAAO,CAAC,mBAAmB,EAAE,CAAC,gBAAgB,CAAC,CAAC;QACtD,6EAA6E;QAC7E,gEAAgE;QAChE,MAAM,MAAM,GAAG,iBAAiB,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACvF,OAAO;YACL,GAAG,MAAM;YACT,IAAI,EAAE,KAAK;YACX,GAAG,EAAE,UAAU,CAAC,OAAO;YACvB,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,GAAG;YACH,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,UAAU,CAAC,GAAG;YAChC,UAAU;YACV,aAAa,EAAE,0BAA0B,CAAC,UAAU,CAAC,OAAO,CAAC;SAC9D,CAAC;IACJ,CAAC,CAAC;IAEF,OAAO;QACL,GAAG,UAAU;QACb,IAAI,EAAE,UAAU,CAAC,OAAO;QACxB,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,EAAE,EAAE,EAAE;YAC3B,IAAI,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAC/B,MAAM,IAAI,KAAK,CAAC,+CAA+C,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;YACvF,CAAC;YACD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACpE,CAAC;QACD,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC;KAC7B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,OAAkC,EAClC,YAA4B,MAAM;IAElC,IAAI,SAAS,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC5C,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,OAAO,CAAC,YAAY;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,iCAAiC,CAAC,CAAC;QAC7F,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACnD,IAAI,OAAO,CAAC,YAAY;QAAE,OAAO,KAAK,CAAC;IACvC,MAAM,IAAI,KAAK,CACb,GAAG,OAAO,CAAC,IAAI,8EAA8E,CAC9F,CAAC;AACJ,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,qBAAqB,CACnC,OAAe,EACf,YAA4B,MAAM;IAElC,MAAM,OAAO,GAAG,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,+CAA+C,OAAO,EAAE,CAAC,CAAC;QAC5E,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,oBAAoB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,gBAAgB,CACvB,OAAkC,EAClC,KAAyB,EACzB,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC;IAEhD,MAAM,MAAM,GAAG,iBAAiB,CAAC,EAAE,EAAE,EAAE,WAAW,OAAO,CAAC,IAAI,IAAI,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAClF,OAAO;QACL,GAAG,MAAM;QACT,IAAI,EAAE,QAAQ;QACd,GAAG,EAAE,OAAO,CAAC,IAAI;QACjB,OAAO,EAAE,QAAQ;QACjB,OAAO,EAAE,OAAO,CAAC,IAAI;QACrB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,aAAa,EAAE,sCAAsC;KACtD,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAkC;IAC/D,OAAO;QACL,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,WAAW;QAC1C,aAAa,EAAE,OAAO,CAAC,SAAS,CAAC,aAAa;QAC9C,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,OAAO;QAClC,YAAY,EAAE,KAAK;QACnB,WAAW,EAAE,KAAK;QAClB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,KAAK;QACd,yBAAyB,EAAE,KAAK;KACjC,CAAC;AACJ,CAAC;AAED,SAAS,kCAAkC,CAAC,QAA4B;IACtE,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC;IAC5C,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC/C,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,OAAO,EAAuB,CAAC;AACzD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CACvC,WAAmB,EACnB,QAA4B,EAAE,EAC9B,aAA0C;IAE1C,MAAM,OAAO,GAAG,oBAAoB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACvD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACrD,MAAM,SAAS,GAAG,UAAU,UAAU,EAAE,EAAE,CAAC;IAC3C,MAAM,YAAY,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,0BAA0B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACzF,MAAM,aAAa,GAAG;QACpB,IAAI;QACJ,OAAO,EAAE,OAAO,CAAC,IAAI;QACrB,SAAS,EAAE,GAAG;QACd,SAAS;QACT,QAAQ,EAAE,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;KAC7D,CAAC;IACF,OAAO;QACL,IAAI;QACJ,GAAG,EAAE,OAAO,CAAC,IAAI;QACjB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,GAAG;QACH,SAAS,EAAE,UAAU;QACrB,aAAa,EAAE;YACb,OAAO,EAAE,QAAQ;YACjB,OAAO,EAAE,aAAa,EAAE,OAAO,IAAI,OAAO,CAAC,QAAQ;YACnD,IAAI,EAAE,aAAa,EAAE,IAAI,IAAI,CAAC,YAAY,CAAC;YAC3C,GAAG;YACH,GAAG,EAAE;gBACH,GAAG,KAAK,CAAC,GAAG;gBACZ,2BAA2B,EAAE,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC;aAC3D;YACD,SAAS;YACT,QAAQ,EAAE;gBACR,WAAW,EAAE,QAAQ;gBACrB,4BAA4B,EAAE,CAAC;gBAC/B,uEAAuE;gBACvE,kEAAkE;gBAClE,uEAAuE;gBACvE,yBAAyB,EAAE,qBAAqB,CAAC,OAAO,CAAC;gBACzD,aAAa,EAAE,sCAAsC;aACtD;SACF;KACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,WAAW,CACxB,OAAkC,EAClC,KAAyB,EACzB,MAAmB,EACnB,KAAiB;IAEjB,MAAM,MAAM,GAAG,yBAAyB,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,OAAO,CAAC,kBAAkB,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;QACpD,MAAM,KAAK,GAAG,kCAAkC,CAAC,QAAQ,CAAC,CAAC;QAC3D,IAAI,KAAK;YAAE,KAAK,CAAC,gBAAgB,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,gBAAgB,CAAC,OAAO,EAAE,EAAE,GAAG,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChG,OAAO,EAAE,GAAG,UAAU,EAAE,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;AACnD,CAAC;AAQD,MAAM,UAAU,oBAAoB,CAClC,WAAmB,EACnB,aAA0C;IAE1C,MAAM,OAAO,GAAG,oBAAoB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1D,IAAI,OAAO,CAAC,aAAa,CAAC,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,wBAAwB,OAAO,CAAC,IAAI,0CAA0C,CAAC,CAAC;IAClG,CAAC;IACD,MAAM,GAAG,GAAG,aAAa,CAAC,CAAC,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAExE,MAAM,KAAK,GAAG,CAAC,QAA4B,EAAE,EAAuB,EAAE;QACpE,MAAM,OAAO,GAAG,oBAAoB,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7D,OAAO,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,GAAI,CAAC,GAAG,CAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACvG,CAAC,CAAC;IAEF,OAAO;QACL,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ;QACzC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,aAAa,EAAE,OAAO,IAAI,OAAO,CAAC,IAAI;QAC/C,OAAO;QACP,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,EAAE,EAAE,EAAE;YAC3B,MAAM,OAAO,GAAG,oBAAoB,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YAC7D,IAAI,OAAO,KAAK,KAAK;gBAAE,OAAO,GAAI,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YACxE,OAAO,KAAK,CAAC,KAAK;gBAChB,CAAC,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC;gBACzE,CAAC,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACvC,CAAC;QACD,GAAG,EAAE,KAAK;KACX,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -1,15 +1,19 @@
 import { type PtyHarness } from './define.js';
 export * from './define.js';
 export * from './create-human.js';
+export * from './observability.js';
+export * from './ai-sdk/index.js';
 export { defineHarness, normalizeAgentIdentity, MINIMAL_AGENT_SESSION_CAPABILITIES } from '@agent-relay/sdk';
 export type { AgentSession, AgentSessionCapabilities, HarnessConfig, HarnessCreateContext, } from '@agent-relay/sdk';
-export declare const claude: PtyHarness;
-export declare const codex: PtyHarness;
+export declare const claude: import("./define.js").ManagedPtyHarness;
+export declare const codex: import("./define.js").ManagedPtyHarness;
 export declare const gemini: PtyHarness;
 export declare const cursor: PtyHarness;
 export declare const droid: PtyHarness;
-export declare const opencode: PtyHarness;
+export declare const opencode: import("./define.js").ManagedPtyHarness;
 export declare const aider: PtyHarness;
 export declare const goose: PtyHarness;
 export declare const grok: PtyHarness;
+export declare const pi: import("./define.js").ManagedHarness;
+export declare const deepAgents: import("./define.js").ManagedHarness;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAEhE,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAIlC,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,kCAAkC,EAAE,MAAM,kBAAkB,CAAC;AAC7G,YAAY,EACV,YAAY,EACZ,wBAAwB,EACxB,aAAa,EACb,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,eAAO,MAAM,MAAM,EAAE,UAAoE,CAAC;AAE1F,eAAO,MAAM,KAAK,EAAE,UAAmE,CAAC;AAExF,eAAO,MAAM,MAAM,EAAE,UAAoE,CAAC;AAE1F,eAAO,MAAM,MAAM,EAAE,UAA0E,CAAC;AAEhG,eAAO,MAAM,KAAK,EAAE,UAAmE,CAAC;AAExF,eAAO,MAAM,QAAQ,EAAE,UAAsE,CAAC;AAE9F,eAAO,MAAM,KAAK,EAAE,UAAmE,CAAC;AAExF,eAAO,MAAM,KAAK,EAAE,UAAmE,CAAC;AAExF,eAAO,MAAM,IAAI,EAAE,UAAkE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0C,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAEtF,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAIlC,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,kCAAkC,EAAE,MAAM,kBAAkB,CAAC;AAC7G,YAAY,EACV,YAAY,EACZ,wBAAwB,EACxB,aAAa,EACb,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,eAAO,MAAM,MAAM,yCAAwE,CAAC;AAE5F,eAAO,MAAM,KAAK,yCAAsE,CAAC;AAEzF,eAAO,MAAM,MAAM,EAAE,UAAoE,CAAC;AAE1F,eAAO,MAAM,MAAM,EAAE,UAA0E,CAAC;AAEhG,eAAO,MAAM,KAAK,EAAE,UAAmE,CAAC;AAExF,eAAO,MAAM,QAAQ,yCAA4E,CAAC;AAElG,eAAO,MAAM,KAAK,EAAE,UAAmE,CAAC;AAExF,eAAO,MAAM,KAAK,EAAE,UAAmE,CAAC;AAExF,eAAO,MAAM,IAAI,EAAE,UAAkE,CAAC;AAEtF,eAAO,MAAM,EAAE,sCAA6B,CAAC;AAE7C,eAAO,MAAM,UAAU,sCAAqC,CAAC"}

package/dist/index.js

@@ -1,16 +1,20 @@
-import { definePtyHarness } from './define.js';
+import { defineManagedHarness, definePtyHarness } from './define.js';
 export * from './define.js';
 export * from './create-human.js';
+export * from './observability.js';
+export * from './ai-sdk/index.js';
 // Custom (non-PTY) harnesses are defined with the SDK's harness contract;
 // re-export it here so harness authors have one import surface.
 export { defineHarness, normalizeAgentIdentity, MINIMAL_AGENT_SESSION_CAPABILITIES } from '@agent-relay/sdk';
-export const claude = definePtyHarness({ runtime: 'pty', command: 'claude' });
-export const codex = definePtyHarness({ runtime: 'pty', command: 'codex' });
+export const claude = defineManagedHarness('claude', { runtime: 'pty', command: 'claude' });
+export const codex = defineManagedHarness('codex', { runtime: 'pty', command: 'codex' });
 export const gemini = definePtyHarness({ runtime: 'pty', command: 'gemini' });
 export const cursor = definePtyHarness({ runtime: 'pty', command: 'cursor-agent' });
 export const droid = definePtyHarness({ runtime: 'pty', command: 'droid' });
-export const opencode = definePtyHarness({ runtime: 'pty', command: 'opencode' });
+export const opencode = defineManagedHarness('opencode', { runtime: 'pty', command: 'opencode' });
 export const aider = definePtyHarness({ runtime: 'pty', command: 'aider' });
 export const goose = definePtyHarness({ runtime: 'pty', command: 'goose' });
 export const grok = definePtyHarness({ runtime: 'pty', command: 'grok' });
+export const pi = defineManagedHarness('pi');
+export const deepAgents = defineManagedHarness('deepagents');
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAmB,MAAM,aAAa,CAAC;AAEhE,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAElC,0EAA0E;AAC1E,gEAAgE;AAChE,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,kCAAkC,EAAE,MAAM,kBAAkB,CAAC;AAQ7G,MAAM,CAAC,MAAM,MAAM,GAAe,gBAAgB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;AAE1F,MAAM,CAAC,MAAM,KAAK,GAAe,gBAAgB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AAExF,MAAM,CAAC,MAAM,MAAM,GAAe,gBAAgB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;AAE1F,MAAM,CAAC,MAAM,MAAM,GAAe,gBAAgB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;AAEhG,MAAM,CAAC,MAAM,KAAK,GAAe,gBAAgB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AAExF,MAAM,CAAC,MAAM,QAAQ,GAAe,gBAAgB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;AAE9F,MAAM,CAAC,MAAM,KAAK,GAAe,gBAAgB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AAExF,MAAM,CAAC,MAAM,KAAK,GAAe,gBAAgB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AAExF,MAAM,CAAC,MAAM,IAAI,GAAe,gBAAgB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAmB,MAAM,aAAa,CAAC;AAEtF,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAElC,0EAA0E;AAC1E,gEAAgE;AAChE,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,kCAAkC,EAAE,MAAM,kBAAkB,CAAC;AAQ7G,MAAM,CAAC,MAAM,MAAM,GAAG,oBAAoB,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;AAE5F,MAAM,CAAC,MAAM,KAAK,GAAG,oBAAoB,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AAEzF,MAAM,CAAC,MAAM,MAAM,GAAe,gBAAgB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;AAE1F,MAAM,CAAC,MAAM,MAAM,GAAe,gBAAgB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;AAEhG,MAAM,CAAC,MAAM,KAAK,GAAe,gBAAgB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AAExF,MAAM,CAAC,MAAM,QAAQ,GAAG,oBAAoB,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;AAElG,MAAM,CAAC,MAAM,KAAK,GAAe,gBAAgB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AAExF,MAAM,CAAC,MAAM,KAAK,GAAe,gBAAgB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AAExF,MAAM,CAAC,MAAM,IAAI,GAAe,gBAAgB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;AAEtF,MAAM,CAAC,MAAM,EAAE,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;AAE7C,MAAM,CAAC,MAAM,UAAU,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAC"}

package/dist/observability.d.ts

@@ -0,0 +1,41 @@
+import { type AgentEvent, type AgentObservabilityCapabilities, type AgentSessionEvent } from '@agent-relay/sdk';
+export declare const AI_SDK_REFERENCE_OBSERVABILITY_PROFILE: AgentObservabilityCapabilities;
+declare const PTY_HARNESSES: readonly ["claude", "codex", "gemini", "cursor-agent", "droid", "opencode", "aider", "goose", "grok"];
+export type PtyHarnessName = (typeof PTY_HARNESSES)[number];
+/**
+ * PTY observability is deliberately conservative. The broker owns exact
+ * process lifecycle signals and can infer a busy/idle turn boundary, but raw
+ * terminal bytes are not treated as structured assistant, reasoning, or tool
+ * events.
+ */
+export declare const PTY_OBSERVABILITY_PROFILE: AgentObservabilityCapabilities;
+export declare const PTY_OBSERVABILITY_PROFILES: Record<PtyHarnessName, AgentObservabilityCapabilities>;
+export declare function getPtyObservabilityProfile(harnessName: string): AgentObservabilityCapabilities;
+export type PtyObservabilitySignal = {
+    type: 'starting';
+    at?: Date | string;
+} | {
+    type: 'busy';
+    turnId: string;
+    at?: Date | string;
+} | {
+    type: 'idle';
+    turnId: string;
+    at?: Date | string;
+} | {
+    type: 'error';
+    error: string;
+    code?: string;
+    at?: Date | string;
+};
+export type PtyAgentEvent = AgentEvent | Extract<AgentSessionEvent, {
+    type: 'activity.changed';
+}>;
+export interface PtyObservabilityTranslator {
+    readonly capabilities: AgentObservabilityCapabilities;
+    translate(signal: PtyObservabilitySignal): PtyAgentEvent[];
+}
+/** Translate broker-owned PTY lifecycle evidence into the canonical contract. */
+export declare function createPtyObservabilityTranslator(harnessName: string): PtyObservabilityTranslator;
+export {};
+//# sourceMappingURL=observability.d.ts.map

package/dist/observability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../src/observability.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,UAAU,EACf,KAAK,8BAA8B,EACnC,KAAK,iBAAiB,EACvB,MAAM,kBAAkB,CAAC;AAE1B,eAAO,MAAM,sCAAsC,EAAE,8BA0BjD,CAAC;AAEL,QAAA,MAAM,aAAa,uGAUT,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,EAAE,8BAcvC,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAElC,MAAM,CAAC,cAAc,EAAE,8BAA8B,CAAC,CAAC;AAgB5D,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,8BAA8B,CAM9F;AAED,MAAM,MAAM,sBAAsB,GAC9B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;CAAE,CAAC;AAExE,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,OAAO,CAAC,iBAAiB,EAAE;IAAE,IAAI,EAAE,kBAAkB,CAAA;CAAE,CAAC,CAAC;AAElG,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,YAAY,EAAE,8BAA8B,CAAC;IACtD,SAAS,CAAC,MAAM,EAAE,sBAAsB,GAAG,aAAa,EAAE,CAAC;CAC5D;AAED,iFAAiF;AACjF,wBAAgB,gCAAgC,CAAC,WAAW,EAAE,MAAM,GAAG,0BAA0B,CAmGhG"}

package/dist/observability.js

@@ -0,0 +1,178 @@
+import { createAgentObservabilityCapabilities, EXACT_AND_INFERRED_OBSERVABILITY, EXACT_OBSERVABILITY, INFERRED_OBSERVABILITY, } from '@agent-relay/sdk';
+export const AI_SDK_REFERENCE_OBSERVABILITY_PROFILE = createAgentObservabilityCapabilities({
+    activities: {
+        starting: EXACT_OBSERVABILITY,
+        thinking: EXACT_AND_INFERRED_OBSERVABILITY,
+        typing: EXACT_OBSERVABILITY,
+        using_tool: EXACT_OBSERVABILITY,
+        waiting: EXACT_OBSERVABILITY,
+        idle: EXACT_OBSERVABILITY,
+        error: EXACT_OBSERVABILITY,
+    },
+    events: {
+        lifecycle: EXACT_OBSERVABILITY,
+        turns: EXACT_OBSERVABILITY,
+        text: EXACT_OBSERVABILITY,
+        reasoning: EXACT_OBSERVABILITY,
+        tools: EXACT_OBSERVABILITY,
+        tool_approvals: EXACT_OBSERVABILITY,
+        files: EXACT_OBSERVABILITY,
+        compaction: EXACT_OBSERVABILITY,
+        model: EXACT_OBSERVABILITY,
+        warnings: EXACT_OBSERVABILITY,
+        usage: EXACT_OBSERVABILITY,
+        diagnostics: EXACT_OBSERVABILITY,
+        errors: EXACT_OBSERVABILITY,
+    },
+});
+const PTY_HARNESSES = [
+    'claude',
+    'codex',
+    'gemini',
+    'cursor-agent',
+    'droid',
+    'opencode',
+    'aider',
+    'goose',
+    'grok',
+];
+/**
+ * PTY observability is deliberately conservative. The broker owns exact
+ * process lifecycle signals and can infer a busy/idle turn boundary, but raw
+ * terminal bytes are not treated as structured assistant, reasoning, or tool
+ * events.
+ */
+export const PTY_OBSERVABILITY_PROFILE = createAgentObservabilityCapabilities({
+    activities: {
+        starting: EXACT_OBSERVABILITY,
+        thinking: INFERRED_OBSERVABILITY,
+        idle: INFERRED_OBSERVABILITY,
+        error: EXACT_OBSERVABILITY,
+    },
+    events: {
+        lifecycle: EXACT_OBSERVABILITY,
+        turns: INFERRED_OBSERVABILITY,
+        errors: EXACT_OBSERVABILITY,
+    },
+});
+export const PTY_OBSERVABILITY_PROFILES = Object.fromEntries(PTY_HARNESSES.map((name) => [name, PTY_OBSERVABILITY_PROFILE]));
+const PTY_ALIASES = {
+    claude: 'claude',
+    'claude-code': 'claude',
+    codex: 'codex',
+    gemini: 'gemini',
+    cursor: 'cursor-agent',
+    'cursor-agent': 'cursor-agent',
+    droid: 'droid',
+    opencode: 'opencode',
+    aider: 'aider',
+    goose: 'goose',
+    grok: 'grok',
+};
+export function getPtyObservabilityProfile(harnessName) {
+    const canonicalName = PTY_ALIASES[harnessName.toLowerCase()];
+    if (!canonicalName) {
+        throw new Error(`No PTY observability profile is registered for ${harnessName}`);
+    }
+    return PTY_OBSERVABILITY_PROFILES[canonicalName];
+}
+/** Translate broker-owned PTY lifecycle evidence into the canonical contract. */
+export function createPtyObservabilityTranslator(harnessName) {
+    const capabilities = getPtyObservabilityProfile(harnessName);
+    let sequence = 0;
+    let activity = 'idle';
+    let activeTurnId;
+    const observation = (fidelity, at, turnId) => ({
+        source: 'broker',
+        fidelity,
+        sequence: ++sequence,
+        timestamp: at,
+        ...(turnId ? { turnId } : {}),
+    });
+    const transition = (next, reason, fidelity, at, turnId) => {
+        if (activity === next)
+            return undefined;
+        const previousActivity = activity;
+        activity = next;
+        return {
+            type: 'activity.changed',
+            activity: next,
+            previousActivity,
+            reason,
+            at,
+            observability: observation(fidelity, at, turnId),
+        };
+    };
+    return {
+        capabilities,
+        translate(signal) {
+            const at = signal.at ?? new Date().toISOString();
+            switch (signal.type) {
+                case 'starting': {
+                    const events = [
+                        {
+                            type: 'session.starting',
+                            reason: 'broker_spawn',
+                            at,
+                            observability: observation('exact', at),
+                        },
+                    ];
+                    const changed = transition('starting', 'broker_spawn', 'exact', at);
+                    if (changed)
+                        events.push(changed);
+                    return events;
+                }
+                case 'busy': {
+                    if (activeTurnId === signal.turnId && activity === 'thinking')
+                        return [];
+                    activeTurnId = signal.turnId;
+                    const events = [
+                        {
+                            type: 'turn.started',
+                            turnId: signal.turnId,
+                            at,
+                            observability: observation('inferred', at, signal.turnId),
+                        },
+                    ];
+                    const changed = transition('thinking', 'broker_busy_boundary', 'inferred', at, signal.turnId);
+                    if (changed)
+                        events.push(changed);
+                    return events;
+                }
+                case 'idle': {
+                    if (activeTurnId !== signal.turnId)
+                        return [];
+                    activeTurnId = undefined;
+                    const events = [
+                        {
+                            type: 'turn.settled',
+                            turnId: signal.turnId,
+                            at,
+                            observability: observation('inferred', at, signal.turnId),
+                        },
+                    ];
+                    const changed = transition('idle', 'broker_idle_boundary', 'inferred', at, signal.turnId);
+                    if (changed)
+                        events.push(changed);
+                    return events;
+                }
+                case 'error': {
+                    const events = [
+                        {
+                            type: 'session.failed',
+                            error: signal.error,
+                            ...(signal.code ? { code: signal.code } : {}),
+                            at,
+                            observability: observation('exact', at, activeTurnId),
+                        },
+                    ];
+                    const changed = transition('error', 'broker_runtime_failure', 'exact', at, activeTurnId);
+                    if (changed)
+                        events.push(changed);
+                    return events;
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=observability.js.map

package/dist/observability.js.map

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

package/package.json

@@ -1,6 +1,9 @@
 {
   "name": "@agent-relay/harnesses",
-  "version": "10.6.7",
+  "version": "11.0.0",
+  "engines": {
+    "node": ">=22.0.0"
+  },
   "description": "Pre-built harness definitions for Agent Relay.",
   "type": "module",
   "main": "dist/index.js",
@@ -23,8 +26,14 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@agent-relay/harness-driver": "10.6.7",
-    "@agent-relay/sdk": "10.6.7"
+    "@agent-relay/harness-driver": "11.0.0",
+    "@agent-relay/sdk": "11.0.0",
+    "@ai-sdk/harness": "1.0.34",
+    "@ai-sdk/harness-claude-code": "1.0.35",
+    "@ai-sdk/harness-codex": "1.0.40",
+    "@ai-sdk/harness-deepagents": "1.0.33",
+    "@ai-sdk/harness-opencode": "1.0.35",
+    "@ai-sdk/harness-pi": "1.0.34"
   },
   "publishConfig": {
     "access": "public"