@relayflows/sdk 2.0.35 → 2.0.36

package/dist/adapters/base.d.ts

@@ -17,6 +17,17 @@ export interface CliInvocation {
     /** Set only for wrapper readiness probes; raw providers receive a model flag. */
     modelEnv?: string;
 }
+/**
+ * Why a model-scoped readiness probe exited non-zero, when the CLI's own
+ * output says so. `model_unknown` is the only cause that means the model name
+ * or the credential's access to it is wrong; the others are the environment.
+ */
+export type ModelProbeFailureCause = 'model_unknown' | 'cli_outdated' | 'provider_usage_limited';
+export interface ModelProbeFailure {
+    cause: ModelProbeFailureCause;
+    /** Minimum CLI version the provider named, for `cli_outdated`. */
+    requiredVersion?: string;
+}
 export interface CliAdapterIdentification {
     invocation: CliInvocation;
     expectedStdout?: string;
@@ -44,6 +55,11 @@ export interface HeadlessAdapter {
      * contract on `modelEnv`.
      */
     buildModelReadinessProbe(model: string): CliInvocation;
+    /**
+     * Classify a failed readiness probe from its combined output. Absent, or an
+     * `undefined` answer, means the output named no cause this adapter knows.
+     */
+    classifyModelProbeFailure?(output: string): ModelProbeFailure | undefined;
     /** Agent-step worker argv for an instruction under an optional model. */
     buildAgentInvocation(instruction: string, model?: string): CliInvocation;
     /** LLM-step worker argv for a prompt under an optional model. */

package/dist/adapters/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/adapters/base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,aAAa,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAE/B,iEAAiE;IACjE,mBAAmB,IAAI,wBAAwB,CAAC;IAEhD,yCAAyC;IACzC,cAAc,IAAI,aAAa,CAAC;IAEhC;;;;OAIG;IACH,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC;IAEvD,yEAAyE;IACzE,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC;IAEzE,iEAAiE;IACjE,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC;CACnE"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/adapters/base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,eAAe,GAAG,cAAc,GAAG,wBAAwB,CAAC;AAEjG,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,sBAAsB,CAAC;IAC9B,kEAAkE;IAClE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,aAAa,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAE/B,iEAAiE;IACjE,mBAAmB,IAAI,wBAAwB,CAAC;IAEhD,yCAAyC;IACzC,cAAc,IAAI,aAAa,CAAC;IAEhC;;;;OAIG;IACH,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC;IAEvD;;;OAGG;IACH,yBAAyB,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAAC;IAE1E,yEAAyE;IACzE,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC;IAEzE,iEAAiE;IACjE,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC;CACnE"}

package/dist/adapters/claude.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/adapters/claude.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,eAAe,EAChB,MAAM,WAAW,CAAC;AAInB;8EAC8E;AAC9E,eAAO,MAAM,aAAa,EAAE,eA6C3B,CAAC"}
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/adapters/claude.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,eAAe,EAEhB,MAAM,WAAW,CAAC;AAKnB;8EAC8E;AAC9E,eAAO,MAAM,aAAa,EAAE,eA0D3B,CAAC"}

package/dist/adapters/claude.js

@@ -1,3 +1,4 @@
+import { providerUsageLimited } from './usage-limit.js';
 const MODEL_PROBE_PROMPT = 'Reply with exactly RELAYFLOWS_MODEL_READY and nothing else.';
 /** Claude Code CLI headless contract. Wire and behavior identical to the
  *  pre-#141 inline shape in `cli-adapter.ts` — only the packaging changed. */
@@ -19,6 +20,20 @@ export const claudeAdapter = {
             timeoutMs: 60_000,
         };
     },
+    classifyModelProbeFailure(output) {
+        // Checked first: an older Claude Code also prints its own
+        // `unrecognized_model` catalog warning for a model newer than it, which
+        // must not read as the model being unknown to the provider.
+        const outdated = /does not support this model; version (\S+) or newer is required/.exec(output);
+        if (outdated !== null)
+            return { cause: 'cli_outdated', requiredVersion: outdated[1] };
+        if (providerUsageLimited(output))
+            return { cause: 'provider_usage_limited' };
+        if (/issue with the selected model|not_found_error|may not exist or you may not have access/i.test(output)) {
+            return { cause: 'model_unknown' };
+        }
+        return undefined;
+    },
     buildAgentInvocation(instruction, model) {
         return {
             args: [

package/dist/adapters/claude.js.map

@@ -1 +1 @@
-{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../src/adapters/claude.ts"],"names":[],"mappings":"AAMA,MAAM,kBAAkB,GAAG,6DAA6D,CAAC;AAEzF;8EAC8E;AAC9E,MAAM,CAAC,MAAM,aAAa,GAAoB;IAC5C,IAAI,EAAE,QAAQ;IACd,YAAY,EAAE,eAAe;IAE7B,mBAAmB;QACjB,OAAO,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC;IACnF,CAAC;IAED,cAAc;QACZ,OAAO,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IACzD,CAAC;IAED,wBAAwB,CAAC,KAAa;QACpC,OAAO;YACL,IAAI,EAAE;gBACJ,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,0BAA0B;gBACjE,kBAAkB;aACnB;YACD,SAAS,EAAE,MAAM;SAClB,CAAC;IACJ,CAAC;IAED,oBAAoB,CAAC,WAAmB,EAAE,KAAc;QACtD,OAAO;YACL,IAAI,EAAE;gBACJ,IAAI;gBACJ,sEAAsE;gBACtE,gEAAgE;gBAChE,iEAAiE;gBACjE,uDAAuD;gBACvD,gCAAgC;gBAChC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;gBAClD,WAAW;aACZ;YACD,SAAS,EAAE,CAAC;SACb,CAAC;IACJ,CAAC;IAED,kBAAkB,CAAC,MAAc,EAAE,KAAc;QAC/C,OAAO;YACL,IAAI,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,0BAA0B;gBACpD,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC;YAC7D,SAAS,EAAE,CAAC;SACb,CAAC;IACJ,CAAC;CACF,CAAC"}
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../src/adapters/claude.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,MAAM,kBAAkB,GAAG,6DAA6D,CAAC;AAEzF;8EAC8E;AAC9E,MAAM,CAAC,MAAM,aAAa,GAAoB;IAC5C,IAAI,EAAE,QAAQ;IACd,YAAY,EAAE,eAAe;IAE7B,mBAAmB;QACjB,OAAO,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC;IACnF,CAAC;IAED,cAAc;QACZ,OAAO,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IACzD,CAAC;IAED,wBAAwB,CAAC,KAAa;QACpC,OAAO;YACL,IAAI,EAAE;gBACJ,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,0BAA0B;gBACjE,kBAAkB;aACnB;YACD,SAAS,EAAE,MAAM;SAClB,CAAC;IACJ,CAAC;IAED,yBAAyB,CAAC,MAAc;QACtC,0DAA0D;QAC1D,wEAAwE;QACxE,4DAA4D;QAC5D,MAAM,QAAQ,GAAG,iEAAiE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChG,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,QAAQ,CAAC,CAAC,CAAE,EAAE,CAAC;QACvF,IAAI,oBAAoB,CAAC,MAAM,CAAC;YAAE,OAAO,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC;QAC7E,IAAI,yFAAyF,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3G,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;QACpC,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,oBAAoB,CAAC,WAAmB,EAAE,KAAc;QACtD,OAAO;YACL,IAAI,EAAE;gBACJ,IAAI;gBACJ,sEAAsE;gBACtE,gEAAgE;gBAChE,iEAAiE;gBACjE,uDAAuD;gBACvD,gCAAgC;gBAChC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;gBAClD,WAAW;aACZ;YACD,SAAS,EAAE,CAAC;SACb,CAAC;IACJ,CAAC;IAED,kBAAkB,CAAC,MAAc,EAAE,KAAc;QAC/C,OAAO;YACL,IAAI,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,0BAA0B;gBACpD,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC;YAC7D,SAAS,EAAE,CAAC;SACb,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/adapters/codex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../src/adapters/codex.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,eAAe,EAChB,MAAM,WAAW,CAAC;AAInB;qEACqE;AACrE,eAAO,MAAM,YAAY,EAAE,eA6C1B,CAAC"}
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../src/adapters/codex.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,eAAe,EAEhB,MAAM,WAAW,CAAC;AAKnB;qEACqE;AACrE,eAAO,MAAM,YAAY,EAAE,eAiD1B,CAAC"}

package/dist/adapters/codex.js

@@ -1,3 +1,4 @@
+import { providerUsageLimited } from './usage-limit.js';
 const MODEL_PROBE_PROMPT = 'Reply with exactly RELAYFLOWS_MODEL_READY and nothing else.';
 /** OpenAI Codex CLI headless contract. Behavior identical to the pre-#141
  *  inline shape in `cli-adapter.ts` — only the packaging changed. */
@@ -18,6 +19,9 @@ export const codexAdapter = {
             timeoutMs: 60_000,
         };
     },
+    classifyModelProbeFailure(output) {
+        return providerUsageLimited(output) ? { cause: 'provider_usage_limited' } : undefined;
+    },
     buildAgentInvocation(instruction, model) {
         return {
             args: [

package/dist/adapters/codex.js.map

@@ -1 +1 @@
-{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../src/adapters/codex.ts"],"names":[],"mappings":"AAMA,MAAM,kBAAkB,GAAG,6DAA6D,CAAC;AAEzF;qEACqE;AACrE,MAAM,CAAC,MAAM,YAAY,GAAoB;IAC3C,IAAI,EAAE,OAAO;IAEb,mBAAmB;QACjB,OAAO,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC;IACpF,CAAC;IAED,cAAc;QACZ,OAAO,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAC1D,CAAC;IAED,wBAAwB,CAAC,KAAa;QACpC,OAAO;YACL,IAAI,EAAE;gBACJ,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,uBAAuB;gBACxE,SAAS,EAAE,KAAK,EAAE,kBAAkB;aACrC;YACD,SAAS,EAAE,MAAM;SAClB,CAAC;IACJ,CAAC;IAED,oBAAoB,CAAC,WAAmB,EAAE,KAAc;QACtD,OAAO;YACL,IAAI,EAAE;gBACJ,MAAM,EAAE,aAAa,EAAE,uBAAuB;gBAC9C,oEAAoE;gBACpE,iEAAiE;gBACjE,qEAAqE;gBACrE,kEAAkE;gBAClE,yCAAyC;gBACzC,4CAA4C;gBAC5C,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;gBAClD,WAAW;aACZ;YACD,SAAS,EAAE,CAAC;SACb,CAAC;IACJ,CAAC;IAED,kBAAkB,CAAC,MAAc,EAAE,KAAc;QAC/C,OAAO;YACL,IAAI,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,uBAAuB;gBAC7E,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC;YAC7D,SAAS,EAAE,CAAC;SACb,CAAC;IACJ,CAAC;CACF,CAAC"}
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../src/adapters/codex.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,MAAM,kBAAkB,GAAG,6DAA6D,CAAC;AAEzF;qEACqE;AACrE,MAAM,CAAC,MAAM,YAAY,GAAoB;IAC3C,IAAI,EAAE,OAAO;IAEb,mBAAmB;QACjB,OAAO,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC;IACpF,CAAC;IAED,cAAc;QACZ,OAAO,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAC1D,CAAC;IAED,wBAAwB,CAAC,KAAa;QACpC,OAAO;YACL,IAAI,EAAE;gBACJ,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,uBAAuB;gBACxE,SAAS,EAAE,KAAK,EAAE,kBAAkB;aACrC;YACD,SAAS,EAAE,MAAM;SAClB,CAAC;IACJ,CAAC;IAED,yBAAyB,CAAC,MAAc;QACtC,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACxF,CAAC;IAED,oBAAoB,CAAC,WAAmB,EAAE,KAAc;QACtD,OAAO;YACL,IAAI,EAAE;gBACJ,MAAM,EAAE,aAAa,EAAE,uBAAuB;gBAC9C,oEAAoE;gBACpE,iEAAiE;gBACjE,qEAAqE;gBACrE,kEAAkE;gBAClE,yCAAyC;gBACzC,4CAA4C;gBAC5C,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;gBAClD,WAAW;aACZ;YACD,SAAS,EAAE,CAAC;SACb,CAAC;IACJ,CAAC;IAED,kBAAkB,CAAC,MAAc,EAAE,KAAc;QAC/C,OAAO;YACL,IAAI,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,uBAAuB;gBAC7E,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC;YAC7D,SAAS,EAAE,CAAC;SACb,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/adapters/usage-limit.d.ts

@@ -0,0 +1,2 @@
+export declare function providerUsageLimited(output: string): boolean;
+//# sourceMappingURL=usage-limit.d.ts.map

package/dist/adapters/usage-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-limit.d.ts","sourceRoot":"","sources":["../../src/adapters/usage-limit.ts"],"names":[],"mappings":"AAcA,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE5D"}

package/dist/adapters/usage-limit.js

@@ -0,0 +1,17 @@
+/**
+ * Provider refusals that mean "this credential is out of capacity right now",
+ * not "this model does not exist". Shared by raw provider adapters because the
+ * wording overlaps (HTTP 429, `rate_limit_error`, subscription usage windows).
+ */
+const USAGE_LIMITED = [
+    /usage limit/i,
+    /hit your (?:usage )?limit/i,
+    /(?:5-hour|weekly|session) limit reached/i,
+    /rate_limit_error/,
+    /API Error: 429\b/,
+    /credit balance is too low/i,
+];
+export function providerUsageLimited(output) {
+    return USAGE_LIMITED.some(pattern => pattern.test(output));
+}
+//# sourceMappingURL=usage-limit.js.map

package/dist/adapters/usage-limit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-limit.js","sourceRoot":"","sources":["../../src/adapters/usage-limit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,aAAa,GAAG;IACpB,cAAc;IACd,4BAA4B;IAC5B,0CAA0C;IAC1C,kBAAkB;IAClB,kBAAkB;IAClB,4BAA4B;CAC7B,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,OAAO,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAC7D,CAAC"}

package/dist/authored-activity.d.ts

@@ -0,0 +1,17 @@
+import type { Activity, ActivityOptions, TriggerSource, Wake } from '@relayflows/surface';
+import type { SubscriptionNextResult } from './protocol.js';
+import { JournalClient } from './journal-client.js';
+type CloseReason = 'closed' | 'run_completed' | 'canceled';
+/** Owns body-local cursors that must close before the authored root completes. */
+export declare class AuthoredActivities {
+    private readonly journal;
+    private readonly runId;
+    private readonly activities;
+    constructor(journal: JournalClient, runId: string | undefined);
+    open(source: TriggerSource, options: ActivityOptions): Activity;
+    closeAll(reason: Exclude<CloseReason, 'closed'>): Promise<void>;
+}
+/** Decode the wire result at the journal boundary so malformed wakes fail closed. */
+export declare function decodeWake(value: SubscriptionNextResult): Wake;
+export {};
+//# sourceMappingURL=authored-activity.d.ts.map

package/dist/authored-activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authored-activity.d.ts","sourceRoot":"","sources":["../src/authored-activity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EAER,eAAe,EAEf,aAAa,EAEb,IAAI,EACL,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAE5D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,KAAK,WAAW,GAAG,QAAQ,GAAG,eAAe,GAAG,UAAU,CAAC;AAO3D,kFAAkF;AAClF,qBAAa,kBAAkB;IAI3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJxB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;gBAG9B,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,MAAM,GAAG,SAAS;IAG5C,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,eAAe,GAAG,QAAQ;IAczD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAGtE;AAwKD,qFAAqF;AACrF,wBAAgB,UAAU,CAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI,CAgB9D"}

package/dist/authored-activity.js

@@ -0,0 +1,218 @@
+import { AuthoredFlowExecutionError } from './authored-flow-error.js';
+/** Owns body-local cursors that must close before the authored root completes. */
+export class AuthoredActivities {
+    journal;
+    runId;
+    activities = [];
+    constructor(journal, runId) {
+        this.journal = journal;
+        this.runId = runId;
+    }
+    open(source, options) {
+        if (source?.kind !== 'webhook') {
+            throw new AuthoredFlowExecutionError('unsupported_header', 'f.on() requires an event source; schedule triggers start runs and cannot be awaited inside a body');
+        }
+        if (this.runId === undefined) {
+            throw new AuthoredFlowExecutionError('journal_protocol_violation', 'f.on() requires a durable authored root run');
+        }
+        const id = `activity-${this.activities.length + 1}`;
+        const activity = new JournalActivity(this.journal, this.runId, id, source, normalizeOptions(options));
+        this.activities.push(activity);
+        return activity.activity;
+    }
+    async closeAll(reason) {
+        for (const activity of this.activities)
+            await activity.close(reason);
+    }
+}
+class JournalActivity {
+    journal;
+    runId;
+    subscriptionId;
+    source;
+    options;
+    activity;
+    openPromise;
+    closed = false;
+    nextSequence = 0;
+    acknowledgeWaitId;
+    constructor(journal, runId, subscriptionId, source, options) {
+        this.journal = journal;
+        this.runId = runId;
+        this.subscriptionId = subscriptionId;
+        this.source = source;
+        this.options = options;
+        this.activity = Object.freeze({
+            next: () => this.next(),
+            close: () => this.close('closed'),
+        });
+        // Opening starts at f.on(), rather than at the first next(), so frames
+        // arriving while the body reads state or runs another step are inside the
+        // router's binding window. next()/close() await this same handshake.
+        this.openPromise = this.openNow();
+        void this.openPromise.catch(() => undefined);
+    }
+    async close(reason) {
+        if (this.closed)
+            return;
+        try {
+            await this.ensureOpen();
+        }
+        catch (error) {
+            // Failure cleanup has no active binding to close before activation.
+            // Re-throwing this handoff would disguise a real body failure as a
+            // normal suspension. Root termination fences any later activation.
+            if (reason !== 'closed' && error instanceof AuthoredFlowExecutionError
+                && error.code === 'subscription_suspended' && error.suspension?.kind === 'activation')
+                return;
+            throw error;
+        }
+        await this.journal.subscriptionClose({
+            run_id: this.runId,
+            subscription_id: this.subscriptionId,
+            completion_reason: reason,
+        });
+        this.closed = true;
+    }
+    async next() {
+        if (this.closed)
+            throw new AuthoredFlowExecutionError('activity_closed', 'activity is already closed');
+        await this.ensureOpen();
+        const result = await this.journal.subscriptionNext({
+            run_id: this.runId,
+            subscription_id: this.subscriptionId,
+            sequence: this.nextSequence,
+            ...(this.acknowledgeWaitId === undefined ? {} : { acknowledge_wait_id: this.acknowledgeWaitId }),
+        });
+        if (result.kind === 'suspended') {
+            throw suspended({
+                kind: 'event_wait', subscriptionId: result.subscription_id,
+                stream: result.stream, deadlineAtMs: result.deadline_at_ms,
+            }, this.runId);
+        }
+        const wake = decodeWake(result);
+        if (wake.kind === 'deadline' || wake.kind === 'overflow') {
+            this.closed = true;
+        }
+        else {
+            this.acknowledgeWaitId = receiptId(result) ?? `${this.subscriptionId}/next/${this.nextSequence}`;
+            this.nextSequence += 1;
+        }
+        return wake;
+    }
+    async ensureOpen() {
+        await this.openPromise;
+    }
+    async openNow() {
+        const result = await this.journal.subscriptionOpen({
+            run_id: this.runId,
+            subscription_id: this.subscriptionId,
+            event_types: [this.source.name],
+            ...(this.source.filter === undefined ? {} : { pattern: this.source.filter }),
+            settle_ms: this.options.settleMs,
+            idle_ms: this.options.idleMs,
+            deadline_ms: this.options.deadlineMs,
+            include_self: this.options.includeSelf,
+        });
+        if (result.state === 'prepared') {
+            throw suspended({
+                kind: 'activation', subscriptionId: result.subscription_id,
+                eventTypes: Object.freeze([...result.event_types]),
+                ...(result.pattern === undefined ? {} : { pattern: Object.freeze({ ...result.pattern }) }),
+                stream: result.stream, settleMs: result.settle_ms, idleMs: result.idle_ms,
+                deadlineAtMs: result.deadline_at_ms, includeSelf: result.include_self,
+            }, this.runId);
+        }
+    }
+}
+function suspended(value, runId) {
+    return new AuthoredFlowExecutionError('subscription_suspended', `subscription ${value.subscriptionId} is durably suspended for ${value.kind}`, undefined, runId, undefined, value);
+}
+function receiptId(result) {
+    const receipt = result.acknowledge_wait_id;
+    return typeof receipt === 'string' && receipt.length > 0 ? receipt : undefined;
+}
+function normalizeOptions(options) {
+    if (typeof options !== 'object' || options === null || Array.isArray(options)) {
+        throw unboundedSubscription('f.on() requires idle and deadline bounds');
+    }
+    const value = options;
+    const allowed = new Set(['settle', 'idle', 'deadline', 'includeSelf']);
+    for (const key of Object.keys(value)) {
+        if (!allowed.has(key))
+            throw new AuthoredFlowExecutionError('unbounded_subscription', `f.on() has unknown option ${JSON.stringify(key)}`);
+    }
+    if (!Object.hasOwn(value, 'idle') || !Object.hasOwn(value, 'deadline')) {
+        throw unboundedSubscription('f.on() requires both idle and deadline bounds');
+    }
+    if (value['includeSelf'] !== undefined && typeof value['includeSelf'] !== 'boolean') {
+        throw new AuthoredFlowExecutionError('unbounded_subscription', 'f.on() includeSelf must be a boolean');
+    }
+    return Object.freeze({
+        settleMs: parseDuration(value['settle'], 'settle', true),
+        idleMs: parseDuration(value['idle'], 'idle', false),
+        deadlineMs: parseDuration(value['deadline'], 'deadline', false),
+        includeSelf: value['includeSelf'] === true,
+    });
+}
+function parseDuration(value, field, zeroAllowed) {
+    if (value === undefined && zeroAllowed)
+        return 0;
+    let milliseconds;
+    if (typeof value === 'number')
+        milliseconds = value;
+    else if (typeof value === 'string') {
+        const match = /^(\d+(?:\.\d+)?)(ms|s|m|h|d)$/.exec(value);
+        const units = { ms: 1, s: 1_000, m: 60_000, h: 3_600_000, d: 86_400_000 };
+        const unit = match?.[2];
+        milliseconds = match === null || unit === undefined ? NaN : Math.round(Number(match[1]) * units[unit]);
+    }
+    else
+        milliseconds = NaN;
+    if (!Number.isSafeInteger(milliseconds) || milliseconds < 0 || (!zeroAllowed && milliseconds === 0)) {
+        throw new AuthoredFlowExecutionError('unbounded_subscription', `f.on() ${field} must be ${zeroAllowed ? 'a non-negative' : 'a positive'} whole number of milliseconds or a duration such as "72h"`);
+    }
+    return milliseconds;
+}
+function unboundedSubscription(message) {
+    return new AuthoredFlowExecutionError('unbounded_subscription', message);
+}
+/** Decode the wire result at the journal boundary so malformed wakes fail closed. */
+export function decodeWake(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return invalidWake();
+    if (value.kind === 'idle')
+        return Object.freeze({ kind: 'idle' });
+    if (value.kind === 'events') {
+        if (!Array.isArray(value.events) || !isOffset(value.offset) || !value.events.every(isEventFrame))
+            return invalidWake();
+        return Object.freeze({ kind: 'events', events: Object.freeze([...value.events]), offset: value.offset });
+    }
+    if (value.kind === 'deadline') {
+        if (value.pending !== null && !isPending(value.pending))
+            return invalidWake();
+        return Object.freeze({ kind: 'deadline', pending: value.pending === null ? null : Object.freeze({ ...value.pending }) });
+    }
+    if (value.kind === 'overflow') {
+        if (!isOffset(value.retained) || !isOffset(value.bytes) || !isOffset(value.from))
+            return invalidWake();
+        return Object.freeze({ kind: 'overflow', retained: value.retained, bytes: value.bytes, from: value.from });
+    }
+    return invalidWake();
+}
+function isEventFrame(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value)
+        && typeof value.type === 'string';
+}
+function isPending(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value)
+        && isOffset(value.from)
+        && isOffset(value.to);
+}
+function isOffset(value) {
+    return typeof value === 'number' && Number.isSafeInteger(value) && value >= 0;
+}
+function invalidWake() {
+    throw new AuthoredFlowExecutionError('journal_protocol_violation', 'subscription.next returned an invalid wake result');
+}
+//# sourceMappingURL=authored-activity.js.map

package/dist/authored-activity.js.map

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

package/dist/authored-child-run.d.ts

@@ -0,0 +1,34 @@
+import type { JournalClient } from './journal-client.js';
+import type { RunStatus } from './protocol.js';
+/**
+ * Every entry of a child run's journal, paged.
+ *
+ * A single unbounded read returns the first 100 entries only, and a reader
+ * that needs the LAST completion of a step cannot stop at a page boundary.
+ * A short page is the end of the journal.
+ */
+export declare function readChildJournal(journal: JournalClient, runId: string): Promise<unknown[]>;
+/**
+ * Wait until an authored operation's child run is terminal, and say whether
+ * it got there.
+ *
+ * A child adopted through its admission key is not necessarily finished: on
+ * `flows resume` of a root whose daemon survived, `run.start` returns the
+ * existing child's CURRENT outcome without driving it, so the child may still
+ * be executing an attempt, or sleeping out a retry backoff, on the request
+ * that originally started it. Reading its journal then judges a history that
+ * is still being written.
+ *
+ * The wait is read-only on purpose: it never resumes the child. The kernel
+ * drives a deterministic attempt inline on the request that started it, and a
+ * second driver would presume that attempt dead and run the command again.
+ *
+ * Bounded by the child's own journaled deadlines, never a fixed one: a running
+ * attempt by its lease (renewed as the lease renews) plus the kernel's
+ * lease-sweep grace, a backoff by the `sleep.until` it journaled (once that
+ * wake has passed, by the settling window). With nothing in flight, only the
+ * short settling window above; a child parked on a worker
+ * returns at once. Either way the caller gets the status and decides.
+ */
+export declare function waitForTerminalChildRun(journal: JournalClient, runId: string, signal?: AbortSignal): Promise<RunStatus>;
+//# sourceMappingURL=authored-child-run.d.ts.map

package/dist/authored-child-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authored-child-run.d.ts","sourceRoot":"","sources":["../src/authored-child-run.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAgB,SAAS,EAAE,MAAM,eAAe,CAAC;AAU7D;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAahG;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,SAAS,CAAC,CA0BpB"}

package/dist/authored-child-run.js

@@ -0,0 +1,128 @@
+import { delay, LEASE_SWEEP_GRACE_MS } from './cli/run.js';
+/** One `journal.read` page; the kernel caps an unbounded read at 100 entries. */
+const PAGE = 1_000;
+const POLL_MS = 50;
+// A run between two of its own actions can report `running` with nothing in
+// flight for a moment (a wait just completed, the next attempt not yet
+// journaled). The same bound `classifyOutcome` gives that window (#179).
+const MAX_IDLE_POLLS = 40;
+/**
+ * Every entry of a child run's journal, paged.
+ *
+ * A single unbounded read returns the first 100 entries only, and a reader
+ * that needs the LAST completion of a step cannot stop at a page boundary.
+ * A short page is the end of the journal.
+ */
+export async function readChildJournal(journal, runId) {
+    const all = [];
+    let fromSeq = 1;
+    while (true) {
+        const { entries } = await journal.journalRead(runId, fromSeq, PAGE);
+        all.push(...entries);
+        if (entries.length < PAGE)
+            return all;
+        const last = entries.at(-1);
+        if (typeof last?.seq !== 'number' || !Number.isSafeInteger(last.seq) || last.seq < fromSeq) {
+            throw new Error(`invalid journal sequence reading child run "${runId}"`);
+        }
+        fromSeq = last.seq + 1;
+    }
+}
+/**
+ * Wait until an authored operation's child run is terminal, and say whether
+ * it got there.
+ *
+ * A child adopted through its admission key is not necessarily finished: on
+ * `flows resume` of a root whose daemon survived, `run.start` returns the
+ * existing child's CURRENT outcome without driving it, so the child may still
+ * be executing an attempt, or sleeping out a retry backoff, on the request
+ * that originally started it. Reading its journal then judges a history that
+ * is still being written.
+ *
+ * The wait is read-only on purpose: it never resumes the child. The kernel
+ * drives a deterministic attempt inline on the request that started it, and a
+ * second driver would presume that attempt dead and run the command again.
+ *
+ * Bounded by the child's own journaled deadlines, never a fixed one: a running
+ * attempt by its lease (renewed as the lease renews) plus the kernel's
+ * lease-sweep grace, a backoff by the `sleep.until` it journaled (once that
+ * wake has passed, by the settling window). With nothing in flight, only the
+ * short settling window above; a child parked on a worker
+ * returns at once. Either way the caller gets the status and decides.
+ */
+export async function waitForTerminalChildRun(journal, runId, signal) {
+    let idlePolls = 0;
+    while (true) {
+        if (signal?.aborted === true)
+            throw new Error(`waiting for child run "${runId}" was canceled`);
+        const snapshot = await journal.runGet(runId);
+        if (snapshot.status === 'completed' || snapshot.status === 'failed')
+            return snapshot.status;
+        const inFlight = await inFlightDeadline(journal, runId, snapshot);
+        if (inFlight === 'parked')
+            return snapshot.status;
+        const remainingMs = inFlight === undefined ? 0 : inFlight.deadlineMs + inFlight.graceMs - Date.now();
+        if (inFlight !== undefined && remainingMs > 0) {
+            idlePolls = 0;
+            await delay(Math.min(POLL_MS, remainingMs), signal);
+            continue;
+        }
+        // Only a lease past its sweep grace is proof nothing is running the
+        // attempt. An elapsed retry wake is the kernel's normal transition to the
+        // next attempt — its driver may be folding the timer right now — so it is
+        // re-polled inside the settling window like any other in-between state.
+        if (inFlight?.what === 'lease') {
+            throw new Error(`child run "${runId}" step "${inFlight.stepId}" passed its lease`
+                + ` (${inFlight.deadlineMs}) without reaching a terminal state`);
+        }
+        if (idlePolls >= MAX_IDLE_POLLS)
+            return snapshot.status;
+        idlePolls += 1;
+        await delay(POLL_MS, signal);
+    }
+}
+/**
+ * What the child is waiting on, and until when; `parked` when it is waiting
+ * on nothing this process can wait out.
+ *
+ * A worker-typed (`agent`/`llm`) step that is runnable, or whose retry
+ * backoff has elapsed, with no attempt running, needs a worker — or the
+ * `run.resume` a caller like `classifyOutcome` issues — to move. That is the
+ * park `classifyOutcome` reports, and waiting on it would only delay the same
+ * answer. A deterministic step in that state is the kernel between two of its
+ * own actions, which the caller's settling window covers.
+ */
+async function inFlightDeadline(journal, runId, snapshot) {
+    const steps = Object.entries(snapshot.steps);
+    const running = steps.find(([, step]) => step.state === 'running' && step.lease_deadline_ms !== undefined);
+    if (running !== undefined) {
+        return {
+            stepId: running[0], what: 'lease', deadlineMs: running[1].lease_deadline_ms, graceMs: LEASE_SWEEP_GRACE_MS,
+        };
+    }
+    const worker = ([, step]) => step.type !== 'deterministic';
+    if (steps.some(entry => worker(entry) && entry[1].state === 'runnable'))
+        return 'parked';
+    const backoff = steps.find(([, step]) => step.state === 'backoff');
+    if (backoff === undefined)
+        return undefined;
+    const wakeAtMs = (await readChildJournal(journal, runId))
+        .map(entry => retryWake(entry, backoff[0]))
+        .filter((value) => value !== undefined)
+        .at(-1);
+    if (wakeAtMs === undefined)
+        return undefined;
+    if (wakeAtMs <= Date.now())
+        return worker(backoff) ? 'parked' : undefined;
+    return { stepId: backoff[0], what: 'retry backoff', deadlineMs: wakeAtMs, graceMs: 0 };
+}
+function retryWake(entry, stepId) {
+    if (typeof entry !== 'object' || entry === null)
+        return undefined;
+    const { entry_type: type, step_id: step, payload } = entry;
+    if (type !== 'sleep.until' || step !== stepId || typeof payload !== 'object' || payload === null)
+        return undefined;
+    const wakeAtMs = payload['wake_at_ms'];
+    return typeof wakeAtMs === 'number' && Number.isFinite(wakeAtMs) ? wakeAtMs : undefined;
+}
+//# sourceMappingURL=authored-child-run.js.map

package/dist/authored-child-run.js.map

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