@ironflow/browser 0.33.1 → 0.34.0

package/README.md

@@ -369,10 +369,16 @@ console.log(published.eventId, published.sequence);
 ### Emit and Wait, Batch Emit
 
 ```typescript
-// Wait for the triggered run to reach a terminal state.
-// Throws RunFailedError / RunCancelledError if it does not complete.
-const result = await ironflow.emitSync('order.placed', { orderId: '123' }, { timeout: 30000 });
-console.log(result.runId, result.status, result.output, result.durationMs);
+// Wait for EVERY run the event triggers. Returns EmitSyncResult[] -- an event
+// that matches nothing returns []. Run outcomes are never thrown: inspect
+// status, error and waitTimedOut per element. A wait timeout leaves the run active.
+const results = await ironflow.emitSync('order.placed', { orderId: '123' }, {
+  timeout: 30000,
+  idempotencyKey: 'order-123-placed',
+});
+for (const r of results) {
+  console.log(r.runId, r.functionId, r.status, r.output, r.waitTimedOut);
+}
 
 // One round trip, one EmitResult per event, in order
 const results = await ironflow.triggerBatch([
@@ -558,18 +564,28 @@ which mode you are in; results report `queued: false, pending: false`.
 
 ### Invoke a Workflow Function
 
+`invoke()` is keyed by **function ID** and blocks for that one run's result over
+`InvokeFunctionSync`. Because there is exactly one run, it throws
+`RunFailedError`, `RunCancelledError` and `RunWaitTimeoutError` on the outcome --
+the deliberate counterpart to `emitSync()`, which never does (ADR 0067).
+
 ```typescript
 import { ironflow } from '@ironflow/browser';
 
-// Invoke with typed input
+// Invoke one function by ID, with typed input
 const result = await ironflow.invoke<{ orderId: string }>('process-order', {
   data: { orderId: '123' },
+  timeout: 30000,        // server-side wait budget, not a transport deadline
+  idempotencyKey: 'order-123',
 });
 
-console.log(result.runIds);   // ['run_abc123']
-console.log(result.eventId);  // Event ID that triggered the run
+console.log(result.runId, result.status, result.output, result.durationMs);
 ```
 
+Aborting the request cancels the run server-side: `InvokeFunctionSync` ties the
+run's lifetime to the request context. To start a function *by event* without
+waiting, use `emit()`, which returns `{ runIds, eventId }`.
+
 ### Get Run Status
 
 ```typescript
@@ -707,7 +723,7 @@ Spec: `src/agents/spec.md`. Issue #625.
 
 ### `agents.invoke(name, payload, opts?)`
 
-Fire-and-wait. Triggers the agent, subscribes to its run events, resolves on the terminal `system.run.{runId}.completed` event.
+Fire-and-wait. One `InvokeFunctionSync` call: the server creates exactly one run, waits for it, and returns its outcome. There is no subscribe and no replay window (ADR 0067).
 
 ```typescript
 import { ironflow } from '@ironflow/browser';
@@ -718,9 +734,11 @@ const result = await ironflow.agents.invoke<{ category: string }>(
   {
     timeoutMs: 60_000,             // default 30s
     idempotencyKey: 'click-abc',   // server-side dedup
-    signal: ac.signal,             // AbortController
-    replay: 1000,                  // default; covers the race window
-    onRunStarted: (runId) => {},   // optional: surfaces runId before terminal
+    signal: ac.signal,             // AbortController; the server cancels the run
+    // replay:       DEPRECATED, unread -- there is no subscription to replay
+    // onRunStarted: DEPRECATED -- now fires AFTER the run settles, not before
+    //               the wait. Use agents.subscribe(runId, { replay }) for
+    //               live progress.
   }
 );
 console.log(result.runId, result.output, result.durationMs);
@@ -731,11 +749,10 @@ Errors:
 | Throws | When |
 |---|---|
 | `ValidationError` | empty/oversized `name` |
-| `AbortError` (DOMException) | `signal` aborts; SDK calls `cancelRun(runId)` server-side |
-| `AgentInvokeTimeoutError` | local `timeoutMs` elapsed; SDK calls `cancelRun(runId)` |
-| `NoRunCreatedError` | server returned empty `runIds` |
-| `RunFailedError` | `system.run.{runId}.failed` |
-| `RunCancelledError` | `system.run.{runId}.cancelled` |
+| `AbortError` (DOMException) | `signal` aborts; the request dies and the **server** cancels the run -- the SDK issues no `cancelRun` |
+| `AgentInvokeTimeoutError` | `timeoutMs` elapsed. An expired budget deliberately leaves the run alive, so here the SDK does best-effort `cancelRun(runId)` |
+| `RunFailedError` | the run failed |
+| `RunCancelledError` | the run was cancelled |
 
 ### `agents.subscribe(runId, callbacks, opts?)`
 
@@ -1612,10 +1629,10 @@ import {
   TimeoutError,            // Request timeouts
   ValidationError,         // Invalid response or input validation
   NotConfiguredError,      // Client used before configure() was called
+  RunWaitTimeoutError,     // invoke() wait expired; durable run continues
   RunFailedError,          // agents.invoke: terminal run failure
   RunCancelledError,       // agents.invoke: terminal run cancellation
   AgentInvokeTimeoutError, // agents.invoke: local timeoutMs elapsed
-  NoRunCreatedError,       // agents.invoke: server returned no runIds
   QueueFullError,          // offline queue at 500 writes or 5 MB
 } from '@ironflow/browser';
 ```
@@ -1653,9 +1670,9 @@ Common error codes returned by the client:
 |------|-------------|
 | `HTTP_4xx` / `HTTP_5xx` | HTTP status-based errors |
 | `TIMEOUT` | Request exceeded the configured timeout |
+| `RUN_WAIT_TIMEOUT` | `invoke()` stopped waiting; the durable run continues. `emitSync()` sets `waitTimedOut` per result instead of throwing |
 | `REQUEST_FAILED` | Network or fetch failure |
 | `PATCH_FAILED` | Step patch operation failed |
-| `RESUME_FAILED` | Run resume operation failed |
 | `NOT_CONFIGURED` | Client used before `configure()` |
 
 ## Browser Compatibility
@@ -1688,7 +1705,7 @@ The package re-exports the following types from `@ironflow/core` for convenience
 
 **Pub/Sub types:** `PublishOptions`, `PublishResult`
 
-**Invoke/Trigger types:** `InvokeResult`, `TriggerResult` (deprecated alias), `TriggerSyncOptions`, `TriggerSyncResult`
+**Invoke/Trigger types:** `InvokeResult`, `TriggerResult` (deprecated alias), `EmitSyncResult`, `InvokeSyncOptions`, `InvokeSyncResult`
 
 **Subscription types:** `SubscribeOptions`, `Subscription`, `AckableSubscription`, `SubscriptionEvent`, `SubscriptionErrorInfo`, `SubscriptionCallbacks`, `ConnectionState`, `AckHandle`
 

package/dist/agents/index.d.ts

@@ -16,8 +16,9 @@ export type { AgentClientLike, AgentInvokeOptions, AgentInvokeResult, AgentMemor
 export interface AgentSubscribeRuntimeOptions {
     /**
      * Number of historical events to replay on attach. Default: 1000.
-     * Covers events emitted between `agents.invoke()` returning a runId
-     * via `onRunStarted` and this subscribe attaching.
+     * Covers events emitted before this subscribe attached — including the
+     * whole run when the runId came from a settled `agents.invoke()`, which
+     * waits on one synchronous call and surfaces the id only at the end.
      */
     replay?: number;
 }

package/dist/agents/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAInD,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,EACd,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,OAAO,GAAG,OAAO,EACtB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,kBAAkB,GACxB,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;IAEvC,SAAS,CACP,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,uBAAuB,EAClC,IAAI,CAAC,EAAE,4BAA4B,GAClC,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB,UAAU,CAAC,MAAM,GAAG,OAAO,EACzB,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,sBAAsB,GAC5B,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC;CACvC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,eAAe,GACtB,eAAe,CAOjB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAInD,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,cAAc,EACd,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,OAAO,GAAG,OAAO,EACtB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,kBAAkB,GACxB,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;IAEvC,SAAS,CACP,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,uBAAuB,EAClC,IAAI,CAAC,EAAE,4BAA4B,GAClC,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB,UAAU,CAAC,MAAM,GAAG,OAAO,EACzB,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,sBAAsB,GAC5B,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC;CACvC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,eAAe,GACtB,eAAe,CAOjB"}

package/dist/agents/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,MAAM,IAAI,WAAW,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,UAAU,IAAI,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,SAAS,IAAI,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAoD7D;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAuB;IAEvB,OAAO;QACL,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC;QACzE,SAAS,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CACpC,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC;QAChD,UAAU,EAAE,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC;KAC5E,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,MAAM,IAAI,WAAW,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,UAAU,IAAI,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,SAAS,IAAI,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAqD7D;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAuB;IAEvB,OAAO;QACL,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC;QACzE,SAAS,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CACpC,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC;QAChD,UAAU,EAAE,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC;KAC5E,CAAC;AACJ,CAAC"}

package/dist/agents/invoke.d.ts

@@ -1,16 +1,29 @@
 /**
  * `ironflow.agents.invoke()` — fire-and-wait against an agent function.
  *
- * Composes the existing async `client.invoke()` + `client.subscribe()` to
- * deliver a single Promise<{runId, output, durationMs}>.
+ * One `InvokeFunctionSync` call. The server keys on the function id, creates
+ * exactly one run, waits for it, and returns its outcome — so there is no
+ * Trigger→subscribe→race compose left to get wrong, and no window between the
+ * two for an event to slip through.
  *
- * Race window between Trigger return and subscribe attach is covered by
- * `subscribe({replay})` — see ./spec.md.
+ * Two behaviours are load-bearing and must not be "tidied":
+ *
+ * 1. `timeoutMs` is a wait budget, not a transport deadline. The client sends
+ *    it as `timeout_ms` and keeps the HTTP deadline longer. Wiring it to a
+ *    fetch abort would cancel the run on every timeout (see 2) and make the
+ *    "still running" outcome unobservable.
+ * 2. Aborting the HTTP request cancels the run server-side (ADR 0067 / Q19),
+ *    which is why the abort path no longer calls `cancelRun`. The timeout path
+ *    still does: an expired budget deliberately leaves the run alive, and an
+ *    agent run left alive is an agent run still spending money.
  */
 import type { AgentClientLike, AgentInvokeOptions, AgentInvokeResult } from "./types.js";
 /**
- * Fire-and-wait: trigger the named agent function, subscribe to its run
- * events, and resolve when a terminal event arrives.
+ * Fire-and-wait: invoke the named agent function and resolve with its output.
+ *
+ * Throws `RunFailedError` / `RunCancelledError` from the client for a failed
+ * or cancelled run, `AgentInvokeTimeoutError` when `timeoutMs` expires, and a
+ * DOMException `AbortError` when `opts.signal` fires.
  */
 export declare function invoke<TOutput = unknown>(client: AgentClientLike, name: string, payload: unknown, opts?: AgentInvokeOptions): Promise<AgentInvokeResult<TOutput>>;
 //# sourceMappingURL=invoke.d.ts.map

package/dist/agents/invoke.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"invoke.d.ts","sourceRoot":"","sources":["../../src/agents/invoke.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAsEpB;;;GAGG;AACH,wBAAsB,MAAM,CAAC,OAAO,GAAG,OAAO,EAC5C,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAiKrC"}
+{"version":3,"file":"invoke.d.ts","sourceRoot":"","sources":["../../src/agents/invoke.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAQH,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAoBpB;;;;;;GAMG;AACH,wBAAsB,MAAM,CAAC,OAAO,GAAG,OAAO,EAC5C,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAmDrC"}

package/dist/agents/invoke.js

@@ -1,25 +1,25 @@
 /**
  * `ironflow.agents.invoke()` — fire-and-wait against an agent function.
  *
- * Composes the existing async `client.invoke()` + `client.subscribe()` to
- * deliver a single Promise<{runId, output, durationMs}>.
+ * One `InvokeFunctionSync` call. The server keys on the function id, creates
+ * exactly one run, waits for it, and returns its outcome — so there is no
+ * Trigger→subscribe→race compose left to get wrong, and no window between the
+ * two for an event to slip through.
  *
- * Race window between Trigger return and subscribe attach is covered by
- * `subscribe({replay})` — see ./spec.md.
+ * Two behaviours are load-bearing and must not be "tidied":
+ *
+ * 1. `timeoutMs` is a wait budget, not a transport deadline. The client sends
+ *    it as `timeout_ms` and keeps the HTTP deadline longer. Wiring it to a
+ *    fetch abort would cancel the run on every timeout (see 2) and make the
+ *    "still running" outcome unobservable.
+ * 2. Aborting the HTTP request cancels the run server-side (ADR 0067 / Q19),
+ *    which is why the abort path no longer calls `cancelRun`. The timeout path
+ *    still does: an expired budget deliberately leaves the run alive, and an
+ *    agent run left alive is an agent run still spending money.
  */
-import { AgentInvokeTimeoutError, NoRunCreatedError, RunCancelledError, RunFailedError, ValidationError, } from "@ironflow/core";
+import { AgentInvokeTimeoutError, RunWaitTimeoutError, ValidationError, } from "@ironflow/core";
 const DEFAULT_TIMEOUT_MS = 30_000;
-// Match the server-side `ReplayMaxEvents` default (1000). Replay-from-zero
-// against a per-run subject is bounded by the run's own emission rate, so
-// 1000 covers ~500 steps (each emits `created`+`completed`) plus run
-// lifecycle events. Step-heavier agents should raise both this option and
-// the server's `ReplayMaxEvents` config.
-const DEFAULT_REPLAY = 1000;
 const MAX_NAME_LENGTH = 256;
-// Defense-in-depth: even though the server is the source of `runId`, we
-// guard against a misbehaving server or mock returning NATS metacharacters
-// (`*`, `>`, `.`) that would widen the subscribe pattern.
-const RUN_ID_PATTERN = /^[A-Za-z0-9_-]+$/;
 /**
  * Validate the function name argument. Server validates the rest; we just
  * catch the obviously broken cases client-side to fail fast.
@@ -33,42 +33,11 @@ function validateName(name) {
     }
 }
 /**
- * Extract terminal-event verdict from a topic suffix. Returns null for
- * non-terminal events.
+ * Fire-and-wait: invoke the named agent function and resolve with its output.
  *
- * Topics: `system.run.{runId}.{event}` where event ∈
- *   { created, updated, resumed, completed, failed, cancelled }.
- * Step events live under `.step.{stepId}.{type}`.
- */
-function classifyTerminal(topic) {
-    if (topic.includes(".step."))
-        return null;
-    if (topic.endsWith(".completed"))
-        return "completed";
-    if (topic.endsWith(".failed"))
-        return "failed";
-    if (topic.endsWith(".cancelled"))
-        return "cancelled";
-    return null;
-}
-function extractError(data) {
-    if (data && typeof data === "object" && "error" in data) {
-        const err = data.error;
-        if (typeof err === "string") {
-            return { message: err };
-        }
-        if (err && typeof err === "object") {
-            return {
-                message: err.message ?? "Run failed",
-                code: err.code,
-            };
-        }
-    }
-    return { message: "Run failed" };
-}
-/**
- * Fire-and-wait: trigger the named agent function, subscribe to its run
- * events, and resolve when a terminal event arrives.
+ * Throws `RunFailedError` / `RunCancelledError` from the client for a failed
+ * or cancelled run, `AgentInvokeTimeoutError` when `timeoutMs` expires, and a
+ * DOMException `AbortError` when `opts.signal` fires.
  */
 export async function invoke(client, name, payload, opts = {}) {
     validateName(name);
@@ -77,146 +46,46 @@ export async function invoke(client, name, payload, opts = {}) {
         throw new DOMException("Aborted", "AbortError");
     }
     const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
-    const replay = opts.replay ?? DEFAULT_REPLAY;
     const startedAt = Date.now();
-    // 1) Trigger the agent. Server returns runId.
-    const triggerResult = await client.invoke(name, {
-        data: payload,
-        idempotencyKey: opts.idempotencyKey,
-    });
-    const runId = triggerResult.runIds?.[0];
-    if (!runId) {
-        throw new NoRunCreatedError(name);
-    }
-    // Defense-in-depth: server is the source of truth, but reject obviously
-    // malformed runIds before interpolating them into a NATS subject.
-    if (!RUN_ID_PATTERN.test(runId)) {
-        throw new ValidationError(`agents.invoke: server returned invalid runId "${runId}" (must match ${RUN_ID_PATTERN})`);
-    }
-    // Single deferred. resolve/reject from subscribe callback, timeout, or abort.
-    let settled = false;
-    let resolveOuter = () => { };
-    let rejectOuter = () => { };
-    const settle = (fn) => {
-        if (settled)
-            return;
-        settled = true;
-        fn();
-    };
-    const outer = new Promise((res, rej) => {
-        resolveOuter = res;
-        rejectOuter = rej;
-    });
-    // Attach a no-op handler eagerly so a fast settle() (e.g., synchronous
-    // timer or pre-subscribe abort) does not surface as an unhandled
-    // rejection before the awaiter below attaches. The original `outer`
-    // promise is unchanged and will still reject through `await outer`.
-    outer.catch(() => {
-        /* observed; real consumer is `await outer` below */
-    });
-    // Arm timeout + abort BEFORE running the user-provided onRunStarted hook
-    // so a hanging hook cannot bypass `timeoutMs` / `signal`.
-    const timeoutHandle = setTimeout(() => {
-        settle(() => rejectOuter(new AgentInvokeTimeoutError(runId, timeoutMs)));
-    }, timeoutMs);
-    const abortHandler = () => {
-        settle(() => rejectOuter(new DOMException("Aborted", "AbortError")));
-    };
-    opts.signal?.addEventListener("abort", abortHandler, { once: true });
-    // Surface runId immediately so callers can attach a separate progress
-    // subscription via agents.subscribe(runId) without waiting for terminal.
-    // We await onRunStarted so the caller's async hook (e.g., attaching a
-    // watcher) completes before the SDK starts dispatching terminal events,
-    // preventing late events from leaking into a subsequent run's UI. The
-    // hook is bounded by the timeout/abort armed above.
-    if (opts.onRunStarted && !settled) {
-        try {
-            await opts.onRunStarted(runId);
-        }
-        catch {
-            /* swallow — caller's bug is not ours */
-        }
-    }
-    // Subscribe and wire dispatch. Race the attach against the deferred so
-    // a hung subscribe call cannot wedge the invoke past `timeoutMs`/abort.
-    let unsubscribe;
-    const subscribePromise = client
-        .subscribe(`system.run.${runId}.>`, {
-        replay,
-        onEvent: (event) => {
-            if (settled)
-                return;
-            const verdict = classifyTerminal(event.topic);
-            if (!verdict)
-                return;
-            if (verdict === "completed") {
-                const output = event.data?.output;
-                settle(() => resolveOuter({
-                    runId,
-                    output,
-                    durationMs: Date.now() - startedAt,
-                }));
-                return;
-            }
-            if (verdict === "failed") {
-                const err = extractError(event.data);
-                settle(() => rejectOuter(new RunFailedError(runId, event.data, err.message)));
-                return;
-            }
-            settle(() => rejectOuter(new RunCancelledError(runId)));
-        },
-        onError: (subErr) => {
-            settle(() => rejectOuter(new Error(`agents.invoke subscription error: ${subErr.message}`)));
-        },
-    })
-        .then((sub) => {
-        unsubscribe = () => {
-            try {
-                sub.unsubscribe();
-            }
-            catch {
-                /* idempotent */
-            }
-        };
-        // Race already settled before subscribe attached: clean up now.
-        if (settled)
-            unsubscribe();
-    })
-        .catch((err) => {
-        settle(() => rejectOuter(err));
-    });
-    // Don't block on subscribePromise; the outer race continues to fire on
-    // timeout/abort even if the attach never resolves.
-    void subscribePromise;
+    let result;
     try {
-        return await outer;
+        result = await client.invoke(name, {
+            data: payload,
+            timeout: timeoutMs,
+            idempotencyKey: opts.idempotencyKey,
+            signal: opts.signal,
+        });
     }
     catch (err) {
-        // Property check on `name` instead of `instanceof DOMException` for
-        // cross-runtime compatibility (some test runners and older Node
-        // builds don't share a DOMException prototype).
-        const isAbort = typeof err === "object" &&
-            err !== null &&
-            "name" in err &&
-            err.name === "AbortError";
-        if (err instanceof AgentInvokeTimeoutError || isAbort) {
-            // Fire-and-forget: do NOT await the cancel. A hanging cancelRun
-            // would block propagation of the original timeout/abort error to
-            // the caller. The unhandled-rejection guard preserves error
-            // observability without blocking.
-            void client
-                .cancelRun(runId, "agents.invoke aborted")
-                .catch(() => {
+        // The wait budget expired with the run still active. Translate to the
+        // agents-level error the public contract promises, and best-effort cancel:
+        // unlike an abort, an expired budget does NOT cancel the run server-side,
+        // so skipping this would leave a zombie agent running.
+        if (err instanceof RunWaitTimeoutError) {
+            // Fire-and-forget: a hanging cancelRun must not delay the timeout error.
+            void client.cancelRun(err.runId, "agents.invoke timed out").catch(() => {
                 /* swallow — best-effort */
             });
+            throw new AgentInvokeTimeoutError(err.runId, timeoutMs);
         }
         throw err;
     }
-    finally {
-        clearTimeout(timeoutHandle);
-        opts.signal?.removeEventListener("abort", abortHandler);
-        if (unsubscribe)
-            unsubscribe();
+    // Surface the runId to the caller's hook. It settles after the run rather
+    // than before the wait now — see the deprecation note on the option.
+    if (opts.onRunStarted) {
+        try {
+            await opts.onRunStarted(result.runId);
+        }
+        catch {
+            /* swallow — caller's bug is not ours */
+        }
     }
+    return {
+        runId: result.runId,
+        output: result.output,
+        // Client wall-clock, unchanged from the compose version. `result.durationMs`
+        // measures the run alone and would silently redefine this field.
+        durationMs: Date.now() - startedAt,
+    };
 }
 //# sourceMappingURL=invoke.js.map

package/dist/agents/invoke.js.map

@@ -1 +1 @@
-{"version":3,"file":"invoke.js","sourceRoot":"","sources":["../../src/agents/invoke.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"invoke.js","sourceRoot":"","sources":["../../src/agents/invoke.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAQxB,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAClC,MAAM,eAAe,GAAG,GAAG,CAAC;AAE5B;;;GAGG;AACH,SAAS,YAAY,CAAC,IAAY;IAChC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,eAAe,CAAC,gDAAgD,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,GAAG,eAAe,EAAE,CAAC;QAClC,MAAM,IAAI,eAAe,CACvB,+BAA+B,eAAe,QAAQ,CACvD,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,MAAuB,EACvB,IAAY,EACZ,OAAgB,EAChB,OAA2B,EAAE;IAE7B,YAAY,CAAC,IAAI,CAAC,CAAC;IAEnB,kDAAkD;IAClD,IAAI,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QACzB,MAAM,IAAI,YAAY,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,kBAAkB,CAAC;IACvD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;YACjC,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,SAAS;YAClB,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,sEAAsE;QACtE,2EAA2E;QAC3E,0EAA0E;QAC1E,uDAAuD;QACvD,IAAI,GAAG,YAAY,mBAAmB,EAAE,CAAC;YACvC,yEAAyE;YACzE,KAAK,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,yBAAyB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;gBACrE,2BAA2B;YAC7B,CAAC,CAAC,CAAC;YACH,MAAM,IAAI,uBAAuB,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAC1D,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,0EAA0E;IAC1E,qEAAqE;IACrE,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,wCAAwC;QAC1C,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAA6B;QAC5C,6EAA6E;QAC7E,iEAAiE;QACjE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;KACnC,CAAC;AACJ,CAAC"}

package/dist/agents/types.d.ts

@@ -3,20 +3,23 @@
  *
  * Spec: see ./spec.md
  */
-import type { InvokeResult, ProjectionStateResult, Run, Subscription, SubscriptionCallbacks, SubscriptionErrorInfo, WaitResult } from "@ironflow/core";
+import type { InvokeSyncResult, ProjectionStateResult, Run, Subscription, SubscriptionCallbacks, SubscriptionErrorInfo, WaitResult } from "@ironflow/core";
 /**
  * Options for `ironflow.agents.invoke()`.
  */
 export interface AgentInvokeOptions {
     /**
-     * Local timeout in milliseconds. When elapsed, throws
-     * `AgentInvokeTimeoutError` and best-effort calls
-     * `cancelRun(runId)` server-side. Default: 30000.
+     * Wait budget in milliseconds, sent to the server as `timeout_ms`. When it
+     * expires the server returns with the run still alive; the SDK throws
+     * `AgentInvokeTimeoutError` and best-effort calls `cancelRun(runId)`.
+     * Default: 30000.
      */
     timeoutMs?: number;
     /**
-     * Caller cancellation. When the signal aborts, throws an `AbortError`
-     * (DOMException) and best-effort calls `cancelRun(runId)`.
+     * Caller cancellation. Aborts the HTTP request, which the server reads as an
+     * abandoned caller and cancels the run for us (ADR 0067 / Q19); the call
+     * then throws an `AbortError` (DOMException). No client-side `cancelRun` is
+     * issued on this path — the server already did it.
      */
     signal?: AbortSignal;
     /**
@@ -25,16 +28,21 @@ export interface AgentInvokeOptions {
      */
     idempotencyKey?: string;
     /**
-     * Number of historical events to replay on subscribe. Default: 100.
-     * Replay covers the race window between Trigger return and subscribe attach.
+     * @deprecated Unread. `invoke()` no longer subscribes to run events — it
+     * waits on a single `InvokeFunctionSync` response — so there is no replay
+     * budget to size. Pass `replay` to `agents.subscribe(runId, ...)` instead.
      */
     replay?: number;
     /**
-     * Called once with the runId as soon as `Trigger` returns and before
-     * the wait begins. Lets callers attach a separate progress subscription
-     * (e.g., `agents.subscribe(runId)`) without waiting for the terminal
-     * event. May return a Promise; the SDK awaits it so any async setup
-     * (subscription attach) completes before terminal events dispatch.
+     * Called once with the runId. May return a Promise; the SDK awaits it
+     * before resolving.
+     *
+     * @deprecated Fires AFTER the run has settled, not before the wait. The
+     * synchronous RPC returns the runId and the terminal outcome in the same
+     * response, so there is no earlier moment at which the id exists on the
+     * client. Attaching a live progress subscription from this hook no longer
+     * works; use `agents.subscribe(runId, { replay })` after the call, or drive
+     * progress from a subscription you open before invoking.
      */
     onRunStarted?: (runId: string) => void | Promise<void>;
 }
@@ -135,8 +143,10 @@ export interface AgentMemoryResult<TState = unknown> {
 export interface AgentClientLike {
     invoke<T = unknown>(functionId: string, options: {
         data: T;
+        timeout?: number;
         idempotencyKey?: string;
-    }): Promise<InvokeResult>;
+        signal?: AbortSignal;
+    }): Promise<InvokeSyncResult>;
     subscribe<T = unknown>(pattern: string | string[], callbacks: SubscriptionCallbacks<T> & {
         replay?: number;
         includeMetadata?: boolean;

package/dist/agents/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,qBAAqB,EACrB,GAAG,EACH,YAAY,EACZ,qBAAqB,EACrB,qBAAqB,EACrB,UAAU,EACX,MAAM,gBAAgB,CAAC;AAExB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxD;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,OAAO,GAAG,OAAO;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,qEAAqE;IACrE,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACjD,wDAAwD;IACxD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IACzC,gCAAgC;IAChC,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IACnD,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC/D,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,IAAI,CAAC;CAChD;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEzB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,MAAM,GAAG,OAAO;IACjD,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,CAAC,GAAG,OAAO,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAC5C,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB,SAAS,CAAC,CAAC,GAAG,OAAO,EACnB,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,EAC1B,SAAS,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE,GACnF,OAAO,CAAC,YAAY,GAAG;QAAE,WAAW,IAAI,IAAI,CAAA;KAAE,CAAC,CAAC;IAEnD,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAExD,aAAa,CAAC,MAAM,GAAG,OAAO,EAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/B,OAAO,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC;IAE1C,wBAAwB,CACtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GACxE,OAAO,CAAC,UAAU,CAAC,CAAC;CACxB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"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"}