@graphrefly/ts 0.0.0 → 0.0.1

package/dist/data-structures/index.d.cts

@@ -1,13 +1,13 @@
-import { o as ReactiveIndexRestoreState, a as IndexRow, n as ReactiveIndexOptions, j as ReactiveIndex, p as ReactiveListRestoreState, q as ReactiveLogRestoreState, r as ReactiveMapRestoreState } from '../reactive-collection-BxBqtIOE.cjs';
-export { C as CapacityPolicy, I as IndexChange, L as ListChange, c as LogChange, M as MapChange, O as OrderedCapacityPolicy, k as ReactiveIndexCapacityOrder, l as ReactiveIndexCapacityPolicy, m as ReactiveIndexOpt, s as ReactiveOpt, t as ReactiveView, u as RetentionPolicy, V as ViewCachePolicy, H as reactiveIndex } from '../reactive-collection-BxBqtIOE.cjs';
-import { b as ReactiveListOptions, R as ReactiveList, d as ReactiveLogOptions, c as ReactiveLog, g as ReactiveMapOptions, e as ReactiveMap } from '../reactive-map-D-g3dv8I.cjs';
-export { a as ReactiveListOpt, f as ReactiveMapOpt, h as ReactiveMapRetentionEntry, i as ReactiveMapRetentionPolicy, m as mergeReactiveLogs, r as reactiveList, j as reactiveLog, k as reactiveMap, s as scanLog } from '../reactive-map-D-g3dv8I.cjs';
-import '../types-bNMSWKqF.cjs';
-import '../messages-BZqrGGm1.cjs';
-import '../graph-s23RbbFO.cjs';
+import { o as ReactiveIndexRestoreState, a as IndexRow, n as ReactiveIndexOptions, j as ReactiveIndex, p as ReactiveListRestoreState, q as ReactiveLogRestoreState, r as ReactiveMapRestoreState } from '../reactive-collection-DNV0-gFi.cjs';
+export { C as CapacityPolicy, I as IndexChange, L as ListChange, c as LogChange, M as MapChange, O as OrderedCapacityPolicy, k as ReactiveIndexCapacityOrder, l as ReactiveIndexCapacityPolicy, m as ReactiveIndexOpt, s as ReactiveOpt, t as ReactiveView, u as RetentionPolicy, V as ViewCachePolicy, H as reactiveIndex } from '../reactive-collection-DNV0-gFi.cjs';
+import { b as ReactiveListOptions, R as ReactiveList, d as ReactiveLogOptions, c as ReactiveLog, g as ReactiveMapOptions, e as ReactiveMap } from '../reactive-map-DRD1LJ2H.cjs';
+export { a as ReactiveListOpt, f as ReactiveMapOpt, h as ReactiveMapRetentionEntry, i as ReactiveMapRetentionPolicy, m as mergeReactiveLogs, r as reactiveList, j as reactiveLog, k as reactiveMap, s as scanLog } from '../reactive-map-DRD1LJ2H.cjs';
+import '../types-CcPIn7sy.cjs';
+import '../messages-CAzUPPJM.cjs';
+import '../graph-DCEWh4T2.cjs';
 import '../core/index.cjs';
 import '../codec-BB7p8fJc.cjs';
-import '../describe-Ciu8SUnN.cjs';
+import '../describe-DYMw_l1C.cjs';
 import '../append-log-DisvEReb.cjs';
 
 /** D161 synchronous collection-owned restore. This helper never reads storage. */

package/dist/data-structures/index.d.ts

@@ -1,13 +1,13 @@
-import { o as ReactiveIndexRestoreState, a as IndexRow, n as ReactiveIndexOptions, j as ReactiveIndex, p as ReactiveListRestoreState, q as ReactiveLogRestoreState, r as ReactiveMapRestoreState } from '../reactive-collection-Cb1II1Fi.js';
-export { C as CapacityPolicy, I as IndexChange, L as ListChange, c as LogChange, M as MapChange, O as OrderedCapacityPolicy, k as ReactiveIndexCapacityOrder, l as ReactiveIndexCapacityPolicy, m as ReactiveIndexOpt, s as ReactiveOpt, t as ReactiveView, u as RetentionPolicy, V as ViewCachePolicy, H as reactiveIndex } from '../reactive-collection-Cb1II1Fi.js';
-import { b as ReactiveListOptions, R as ReactiveList, d as ReactiveLogOptions, c as ReactiveLog, g as ReactiveMapOptions, e as ReactiveMap } from '../reactive-map-BcB4KsQR.js';
-export { a as ReactiveListOpt, f as ReactiveMapOpt, h as ReactiveMapRetentionEntry, i as ReactiveMapRetentionPolicy, m as mergeReactiveLogs, r as reactiveList, j as reactiveLog, k as reactiveMap, s as scanLog } from '../reactive-map-BcB4KsQR.js';
-import '../types-h12mNYbq.js';
-import '../messages-BZqrGGm1.js';
-import '../graph-DfdF9zy4.js';
+import { o as ReactiveIndexRestoreState, a as IndexRow, n as ReactiveIndexOptions, j as ReactiveIndex, p as ReactiveListRestoreState, q as ReactiveLogRestoreState, r as ReactiveMapRestoreState } from '../reactive-collection-BAmfrGjd.js';
+export { C as CapacityPolicy, I as IndexChange, L as ListChange, c as LogChange, M as MapChange, O as OrderedCapacityPolicy, k as ReactiveIndexCapacityOrder, l as ReactiveIndexCapacityPolicy, m as ReactiveIndexOpt, s as ReactiveOpt, t as ReactiveView, u as RetentionPolicy, V as ViewCachePolicy, H as reactiveIndex } from '../reactive-collection-BAmfrGjd.js';
+import { b as ReactiveListOptions, R as ReactiveList, d as ReactiveLogOptions, c as ReactiveLog, g as ReactiveMapOptions, e as ReactiveMap } from '../reactive-map-EsDiCmJk.js';
+export { a as ReactiveListOpt, f as ReactiveMapOpt, h as ReactiveMapRetentionEntry, i as ReactiveMapRetentionPolicy, m as mergeReactiveLogs, r as reactiveList, j as reactiveLog, k as reactiveMap, s as scanLog } from '../reactive-map-EsDiCmJk.js';
+import '../types-BsJvElYZ.js';
+import '../messages-CAzUPPJM.js';
+import '../graph-D-1-SQeC.js';
 import '../core/index.js';
 import '../codec-BB7p8fJc.js';
-import '../describe-BZb7AS2y.js';
+import '../describe-BpyJuWkw.js';
 import '../append-log-DzKMmjxx.js';
 
 /** D161 synchronous collection-owned restore. This helper never reads storage. */

package/dist/data-structures/index.js

@@ -9,13 +9,14 @@ import {
   restoreReactiveLog,
   restoreReactiveMap,
   scanLog
-} from "../chunk-RIIOUTGM.js";
-import "../chunk-G4M3NHRJ.js";
-import "../chunk-PKVBHGBM.js";
-import "../chunk-I3IHOHCJ.js";
+} from "../chunk-HKK2JD7Z.js";
+import "../chunk-V7CIJE4B.js";
+import "../chunk-SS2A464I.js";
+import "../chunk-XKXWK2KP.js";
+import "../chunk-WQIA3GFB.js";
+import "../chunk-S6HXABGL.js";
 import "../chunk-4VLAQHZI.js";
-import "../chunk-SWTLEQL6.js";
-import "../chunk-DK554R7P.js";
+import "../chunk-DGUM43GV.js";
 export {
   mergeReactiveLogs,
   reactiveIndex,

package/dist/{describe-BZb7AS2y.d.ts → describe-BpyJuWkw.d.ts}

@@ -1,4 +1,4 @@
-import { B as Status, o as NodeVersion } from './types-h12mNYbq.js';
+import { B as Status, o as NodeVersion } from './types-BsJvElYZ.js';
 
 /**
  * topology()/describe() snapshot shapes (R-describe / D39 / D51 / D173).

package/dist/{describe-Ciu8SUnN.d.cts → describe-DYMw_l1C.d.cts}

@@ -1,4 +1,4 @@
-import { B as Status, o as NodeVersion } from './types-bNMSWKqF.cjs';
+import { B as Status, o as NodeVersion } from './types-CcPIn7sy.cjs';
 
 /**
  * topology()/describe() snapshot shapes (R-describe / D39 / D51 / D173).

package/dist/executors/work-queue.cjs

@@ -0,0 +1,342 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/executors/work-queue.ts
+var work_queue_exports = {};
+__export(work_queue_exports, {
+  executorSubmitCommand: () => executorSubmitCommand,
+  executorWorkQueueRecipe: () => executorWorkQueueRecipe
+});
+module.exports = __toCommonJS(work_queue_exports);
+
+// src/protocol/messages.ts
+var SENTINEL = void 0;
+
+// src/ctx/types.ts
+function depWaves(ctx, depIndex) {
+  return ctx.waveData[depIndex] ?? [];
+}
+function depBatch(ctx, depIndex) {
+  const waves = depWaves(ctx, depIndex);
+  if (waves.length === 0) return null;
+  const flattened = waves.flat().filter((v) => v !== SENTINEL);
+  return flattened.length === 0 ? [] : flattened;
+}
+
+// src/executors/work-queue.ts
+function executorWorkQueueRecipe(graph, opts) {
+  const name = opts.name ?? "executorWorkQueue";
+  const submitCommands = opts.requests === void 0 ? void 0 : graph.node(
+    [opts.requests],
+    (ctx) => {
+      for (const raw of depBatch(ctx, 0) ?? []) {
+        const request = raw;
+        ctx.down([["DATA", executorSubmitCommand(request, opts.policy)]]);
+      }
+    },
+    { name: `${name}/submitCommands`, factory: "executorWorkQueueSubmitCommands" }
+  );
+  const runtime = graph.node(
+    [opts.records, opts.outcomes],
+    (ctx) => {
+      const state = ctx.state.get() ?? emptyState();
+      for (const raw of depBatch(ctx, 0) ?? []) {
+        reduceRecord(ctx, state, raw, opts);
+      }
+      for (const raw of depBatch(ctx, 1) ?? []) {
+        reduceOutcome(ctx, state, raw, opts);
+      }
+      ctx.state.set(state);
+    },
+    {
+      name: `${name}/runtime`,
+      factory: "executorWorkQueueRuntime",
+      partial: true,
+      completeWhenDepsComplete: false,
+      errorWhenDepsError: false
+    }
+  );
+  return {
+    ...submitCommands === void 0 ? {} : { submitCommands },
+    attempts: project(
+      graph,
+      runtime,
+      `${name}/attempts`,
+      "executorWorkQueueAttempts",
+      (fact) => fact.kind === "attempt" ? fact.attempt : void 0
+    ),
+    commands: project(
+      graph,
+      runtime,
+      `${name}/commands`,
+      "executorWorkQueueCommands",
+      (fact) => fact.kind === "command" ? fact.command : void 0
+    ),
+    issues: project(
+      graph,
+      runtime,
+      `${name}/issues`,
+      "executorWorkQueueIssues",
+      (fact) => fact.kind === "issue" ? fact.issue : void 0
+    )
+  };
+}
+function executorSubmitCommand(request, policy) {
+  const payloadExtra = policy?.payload?.(request) ?? {};
+  const submit = policy?.submit?.(request) ?? {};
+  const payload = {
+    ...payloadExtra,
+    kind: "executor-queued-dispatch",
+    requestId: request.requestId,
+    operationId: request.operationId,
+    parentRequestId: request.parentRequestId,
+    inputId: request.input?.inputId,
+    effectRunId: request.effectRunId,
+    sourceRefs: request.sourceRefs,
+    idempotencyKey: request.requestId,
+    metadata: request.metadata
+  };
+  return {
+    kind: "submit",
+    commandId: `${request.requestId}:executor-work-queue-submit`,
+    payload,
+    workId: submit.workId ?? `executor:${request.requestId}`,
+    priority: submit.priority,
+    tags: submit.tags ?? ["executor", request.requestKind],
+    requirements: submit.requirements,
+    notBeforeMs: submit.notBeforeMs,
+    deadlineMs: submit.deadlineMs,
+    idempotencyKey: request.requestId,
+    sourceRefs: stringRefs(request.sourceRefs)
+  };
+}
+function reduceRecord(ctx, state, record, opts) {
+  if (record.kind === "work-admitted") {
+    state.payloads.set(record.workId, record.payload);
+    return;
+  }
+  retireClaimForRecord(state, record);
+  if (record.kind !== "work-claimed") return;
+  if (opts.workerId !== void 0 && record.workerId !== opts.workerId) return;
+  const payload = state.payloads.get(record.workId);
+  if (payload === void 0) {
+    emit(ctx, { kind: "issue", issue: queueIssue(record, "executor-claim-without-payload") });
+    return;
+  }
+  const attempt = {
+    kind: "executor-queued-dispatch-attempt",
+    workId: record.workId,
+    leaseId: record.leaseId,
+    queueAttempt: record.attempt,
+    workerId: record.workerId,
+    requestId: payload.requestId,
+    operationId: payload.operationId,
+    routeId: payload.routeId,
+    executorId: payload.executorId,
+    profileId: payload.profileId,
+    payload,
+    sourceRefs: [...payload.sourceRefs ?? [], ref("work-queue-record", String(record.recordSeq))]
+  };
+  const key = outcomeKey(payload, record.attempt);
+  state.activeClaims.set(key, attempt);
+  emit(ctx, { kind: "attempt", attempt });
+  const pending = state.pendingOutcomes.get(key);
+  if (pending !== void 0) {
+    state.pendingOutcomes.delete(key);
+    for (const outcome of pending) {
+      mapClaimedOutcome(ctx, state, key, attempt, outcome, opts);
+    }
+  }
+}
+function reduceOutcome(ctx, state, outcome, opts) {
+  if (state.seenOutcomes.has(outcome.outcomeId)) return;
+  const key = outcomeKey(outcome, outcome.attempt);
+  if (state.terminalClaims.has(key)) {
+    state.seenOutcomes.add(outcome.outcomeId);
+    emit(ctx, {
+      kind: "issue",
+      issue: {
+        kind: "issue",
+        code: "executor-duplicate-terminal-outcome-for-queue-claim",
+        message: `ExecutorOutcome '${outcome.outcomeId}' arrived after the queue claim was already terminal`,
+        refs: [`executor-outcome:${outcome.outcomeId}`]
+      }
+    });
+    return;
+  }
+  const claim = state.activeClaims.get(key);
+  if (claim === void 0) {
+    bufferPendingOutcome(state, key, outcome);
+    return;
+  }
+  mapClaimedOutcome(ctx, state, key, claim, outcome, opts);
+}
+function mapClaimedOutcome(ctx, state, key, claim, outcome, opts) {
+  if (state.seenOutcomes.has(outcome.outcomeId)) return;
+  state.seenOutcomes.add(outcome.outcomeId);
+  if (state.terminalClaims.has(key)) {
+    emit(ctx, {
+      kind: "issue",
+      issue: {
+        kind: "issue",
+        code: "executor-duplicate-terminal-outcome-for-queue-claim",
+        message: `ExecutorOutcome '${outcome.outcomeId}' arrived after the queue claim was already terminal`,
+        refs: [`executor-outcome:${outcome.outcomeId}`, `work-queue-work:${claim.workId}`]
+      }
+    });
+    return;
+  }
+  if (outcome.kind === "result") {
+    terminalizeClaim(state, key);
+    emit(ctx, {
+      kind: "command",
+      command: {
+        kind: "complete",
+        commandId: `${outcome.outcomeId}:queue-complete`,
+        workId: claim.workId,
+        leaseId: claim.leaseId,
+        attempt: claim.queueAttempt,
+        workerId: claim.workerId,
+        result: outcome.result,
+        sourceRefs: stringRefs(outcome.evidenceRefs)
+      }
+    });
+    return;
+  }
+  if (outcome.kind === "canceled") {
+    terminalizeClaim(state, key);
+    emit(ctx, {
+      kind: "command",
+      command: {
+        kind: "cancel",
+        commandId: `${outcome.outcomeId}:queue-cancel`,
+        workId: claim.workId,
+        reason: outcome.reason,
+        sourceRefs: stringRefs(outcome.evidenceRefs)
+      }
+    });
+    return;
+  }
+  terminalizeClaim(state, key);
+  emit(ctx, {
+    kind: "command",
+    command: {
+      kind: "fail",
+      commandId: `${outcome.outcomeId}:queue-fail`,
+      workId: claim.workId,
+      leaseId: claim.leaseId,
+      attempt: claim.queueAttempt,
+      workerId: claim.workerId,
+      error: outcomeError(outcome),
+      retryable: outcomeRetryable(outcome, opts.policy),
+      sourceRefs: stringRefs(outcome.evidenceRefs)
+    }
+  });
+}
+function outcomeError(outcome) {
+  if (outcome.kind === "failure") return outcome.error;
+  if (outcome.kind === "timeout") {
+    return {
+      kind: "issue",
+      code: "executor-timeout",
+      message: `ExecutorOutcome '${outcome.outcomeId}' timed out`,
+      metadata: { timeoutMs: outcome.timeoutMs }
+    };
+  }
+  return {
+    kind: "issue",
+    code: "executor-blocked",
+    message: `ExecutorOutcome '${outcome.outcomeId}' blocked`,
+    metadata: { needs: outcome.needs }
+  };
+}
+function outcomeRetryable(outcome, policy) {
+  if (outcome.kind === "failure") return outcome.retryable;
+  if (outcome.kind === "timeout") return outcome.retryable ?? policy?.retryableTimeout;
+  if (outcome.kind === "blocked") return policy?.retryableBlocked;
+  return void 0;
+}
+function project(graph, runtime, name, factory, select) {
+  return graph.node(
+    [runtime],
+    (ctx) => {
+      for (const raw of depBatch(ctx, 0) ?? []) {
+        const selected = select(raw);
+        if (selected !== void 0) ctx.down([["DATA", selected]]);
+      }
+    },
+    { name, factory, partial: true, completeWhenDepsComplete: false, errorWhenDepsError: false }
+  );
+}
+function emit(ctx, fact) {
+  ctx.down([["DATA", fact]]);
+}
+function emptyState() {
+  return {
+    payloads: /* @__PURE__ */ new Map(),
+    activeClaims: /* @__PURE__ */ new Map(),
+    pendingOutcomes: /* @__PURE__ */ new Map(),
+    terminalClaims: /* @__PURE__ */ new Set(),
+    seenOutcomes: /* @__PURE__ */ new Set()
+  };
+}
+function terminalizeClaim(state, key) {
+  state.terminalClaims.add(key);
+  state.activeClaims.delete(key);
+}
+function bufferPendingOutcome(state, key, outcome) {
+  const pending = state.pendingOutcomes.get(key) ?? [];
+  if (!pending.some((candidate) => candidate.outcomeId === outcome.outcomeId)) {
+    state.pendingOutcomes.set(key, [...pending, outcome]);
+  }
+}
+function retireClaimForRecord(state, record) {
+  if (record.kind !== "attempt-completed" && record.kind !== "work-completed" && record.kind !== "work-canceled" && record.kind !== "work-dead-lettered" && record.kind !== "work-released" && record.kind !== "lease-expired") {
+    return;
+  }
+  for (const [key, claim] of state.activeClaims) {
+    if (claim.workId !== record.workId) continue;
+    if ("attempt" in record && record.attempt !== claim.queueAttempt) continue;
+    terminalizeClaim(state, key);
+  }
+}
+function outcomeKey(value, attempt) {
+  return `${value.requestId}:${value.operationId}:${attempt}`;
+}
+function queueIssue(record, code) {
+  return {
+    kind: "issue",
+    code,
+    message: `WorkQueue record '${record.kind}' cannot be mapped to executor dispatch`,
+    refs: [`work-queue-record:${record.recordSeq}`],
+    metadata: { queueRecordKind: record.kind, workId: record.workId }
+  };
+}
+function ref(kind, id) {
+  return { kind, id };
+}
+function stringRefs(refs) {
+  return refs?.map((sourceRef) => `${sourceRef.kind}:${sourceRef.id}`);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  executorSubmitCommand,
+  executorWorkQueueRecipe
+});
+//# sourceMappingURL=work-queue.cjs.map

package/dist/executors/work-queue.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/executors/work-queue.ts","../../src/protocol/messages.ts","../../src/ctx/types.ts"],"sourcesContent":["/**\n * Durable executor dispatch recipe over workQueue (D328/D331).\n *\n * Claim records become graph-visible dispatch-attempt facts. Executor outcomes become queue\n * lifecycle commands. The recipe never calls ExecutorBinding or treats a queue claim as dispatch.\n */\n\nimport { type Ctx, depBatch } from \"../ctx/types.js\";\nimport type { DataIssue } from \"../data/index.js\";\nimport type { Graph } from \"../graph/graph.js\";\nimport type { Node } from \"../node/node.js\";\nimport type {\n\tAgentRequestIssued,\n\tExecutorOutcome,\n\tSourceRef,\n} from \"../orchestration/agent-runtime.js\";\nimport type { WorkQueueCommand, WorkQueueRecord } from \"../work-queue/index.js\";\n\nexport interface ExecutorQueuedDispatchPayload {\n\treadonly kind: \"executor-queued-dispatch\";\n\treadonly requestId: string;\n\treadonly operationId: string;\n\treadonly parentRequestId?: string;\n\treadonly sourceDecisionId?: string;\n\treadonly intentId?: string;\n\treadonly inputId?: string;\n\treadonly toolCallSeriesId?: string;\n\treadonly routeId?: string;\n\treadonly profileId?: string;\n\treadonly executorId?: string;\n\treadonly effectRunId?: string;\n\treadonly promptBundleRefs?: readonly SourceRef[];\n\treadonly toolDefinitionRefs?: readonly SourceRef[];\n\treadonly policyRefs?: readonly SourceRef[];\n\treadonly budgetRefs?: readonly SourceRef[];\n\treadonly permissionRefs?: readonly SourceRef[];\n\treadonly sandboxRefs?: readonly SourceRef[];\n\treadonly sourceRefs?: readonly SourceRef[];\n\treadonly artifactRefs?: readonly SourceRef[];\n\treadonly idempotencyKey?: string;\n\treadonly requirements?: readonly string[];\n\treadonly metadata?: Record<string, unknown>;\n}\n\nexport type ExecutorQueuedDispatchPayloadExtra = Partial<\n\tOmit<ExecutorQueuedDispatchPayload, \"kind\" | \"requestId\" | \"operationId\">\n>;\n\nexport interface ExecutorQueuedDispatchAttempt {\n\treadonly kind: \"executor-queued-dispatch-attempt\";\n\treadonly workId: string;\n\treadonly leaseId: string;\n\treadonly queueAttempt: number;\n\treadonly workerId: string;\n\treadonly requestId: string;\n\treadonly operationId: string;\n\treadonly routeId?: string;\n\treadonly executorId?: string;\n\treadonly profileId?: string;\n\treadonly payload: ExecutorQueuedDispatchPayload;\n\treadonly sourceRefs?: readonly SourceRef[];\n}\n\nexport interface ExecutorWorkQueueSubmitOptions {\n\treadonly workId?: string;\n\treadonly priority?: number;\n\treadonly tags?: readonly string[];\n\treadonly requirements?: readonly string[];\n\treadonly notBeforeMs?: number;\n\treadonly deadlineMs?: number;\n}\n\nexport interface ExecutorWorkQueuePolicy {\n\treadonly submit?: (request: AgentRequestIssued) => ExecutorWorkQueueSubmitOptions;\n\treadonly payload?: (request: AgentRequestIssued) => ExecutorQueuedDispatchPayloadExtra;\n\treadonly retryableBlocked?: boolean;\n\treadonly retryableTimeout?: boolean;\n}\n\nexport interface ExecutorWorkQueueRecipeOptions {\n\treadonly name?: string;\n\treadonly requests?: Node<AgentRequestIssued>;\n\treadonly records: Node<WorkQueueRecord<ExecutorQueuedDispatchPayload>>;\n\treadonly outcomes: Node<ExecutorOutcome>;\n\treadonly workerId?: string;\n\treadonly policy?: ExecutorWorkQueuePolicy;\n}\n\nexport interface ExecutorWorkQueueRecipeBundle {\n\treadonly submitCommands?: Node<WorkQueueCommand<ExecutorQueuedDispatchPayload>>;\n\treadonly attempts: Node<ExecutorQueuedDispatchAttempt>;\n\treadonly commands: Node<WorkQueueCommand<ExecutorQueuedDispatchPayload>>;\n\treadonly issues: Node<DataIssue>;\n}\n\ntype ExecutorQueueFact =\n\t| { readonly kind: \"attempt\"; readonly attempt: ExecutorQueuedDispatchAttempt }\n\t| { readonly kind: \"command\"; readonly command: WorkQueueCommand<ExecutorQueuedDispatchPayload> }\n\t| { readonly kind: \"issue\"; readonly issue: DataIssue };\n\ninterface ExecutorQueueState {\n\treadonly payloads: Map<string, ExecutorQueuedDispatchPayload>;\n\treadonly activeClaims: Map<string, ExecutorQueuedDispatchAttempt>;\n\treadonly pendingOutcomes: Map<string, ExecutorOutcome[]>;\n\treadonly terminalClaims: Set<string>;\n\treadonly seenOutcomes: Set<string>;\n}\n\nexport function executorWorkQueueRecipe(\n\tgraph: Graph,\n\topts: ExecutorWorkQueueRecipeOptions,\n): ExecutorWorkQueueRecipeBundle {\n\tconst name = opts.name ?? \"executorWorkQueue\";\n\tconst submitCommands =\n\t\topts.requests === undefined\n\t\t\t? undefined\n\t\t\t: graph.node<WorkQueueCommand<ExecutorQueuedDispatchPayload>>(\n\t\t\t\t\t[opts.requests],\n\t\t\t\t\t(ctx) => {\n\t\t\t\t\t\tfor (const raw of depBatch(ctx, 0) ?? []) {\n\t\t\t\t\t\t\tconst request = raw as AgentRequestIssued;\n\t\t\t\t\t\t\tctx.down([[\"DATA\", executorSubmitCommand(request, opts.policy)]]);\n\t\t\t\t\t\t}\n\t\t\t\t\t},\n\t\t\t\t\t{ name: `${name}/submitCommands`, factory: \"executorWorkQueueSubmitCommands\" },\n\t\t\t\t);\n\tconst runtime = graph.node<ExecutorQueueFact>(\n\t\t[opts.records, opts.outcomes],\n\t\t(ctx) => {\n\t\t\tconst state = ctx.state.get<ExecutorQueueState>() ?? emptyState();\n\t\t\tfor (const raw of depBatch(ctx, 0) ?? []) {\n\t\t\t\treduceRecord(ctx, state, raw as WorkQueueRecord<ExecutorQueuedDispatchPayload>, opts);\n\t\t\t}\n\t\t\tfor (const raw of depBatch(ctx, 1) ?? []) {\n\t\t\t\treduceOutcome(ctx, state, raw as ExecutorOutcome, opts);\n\t\t\t}\n\t\t\tctx.state.set(state);\n\t\t},\n\t\t{\n\t\t\tname: `${name}/runtime`,\n\t\t\tfactory: \"executorWorkQueueRuntime\",\n\t\t\tpartial: true,\n\t\t\tcompleteWhenDepsComplete: false,\n\t\t\terrorWhenDepsError: false,\n\t\t},\n\t);\n\treturn {\n\t\t...(submitCommands === undefined ? {} : { submitCommands }),\n\t\tattempts: project(graph, runtime, `${name}/attempts`, \"executorWorkQueueAttempts\", (fact) =>\n\t\t\tfact.kind === \"attempt\" ? fact.attempt : undefined,\n\t\t),\n\t\tcommands: project(graph, runtime, `${name}/commands`, \"executorWorkQueueCommands\", (fact) =>\n\t\t\tfact.kind === \"command\" ? fact.command : undefined,\n\t\t),\n\t\tissues: project(graph, runtime, `${name}/issues`, \"executorWorkQueueIssues\", (fact) =>\n\t\t\tfact.kind === \"issue\" ? fact.issue : undefined,\n\t\t),\n\t};\n}\n\nexport function executorSubmitCommand(\n\trequest: AgentRequestIssued,\n\tpolicy?: ExecutorWorkQueuePolicy,\n): WorkQueueCommand<ExecutorQueuedDispatchPayload> {\n\tconst payloadExtra = policy?.payload?.(request) ?? {};\n\tconst submit = policy?.submit?.(request) ?? {};\n\tconst payload: ExecutorQueuedDispatchPayload = {\n\t\t...payloadExtra,\n\t\tkind: \"executor-queued-dispatch\",\n\t\trequestId: request.requestId,\n\t\toperationId: request.operationId,\n\t\tparentRequestId: request.parentRequestId,\n\t\tinputId: request.input?.inputId,\n\t\teffectRunId: request.effectRunId,\n\t\tsourceRefs: request.sourceRefs,\n\t\tidempotencyKey: request.requestId,\n\t\tmetadata: request.metadata,\n\t};\n\treturn {\n\t\tkind: \"submit\",\n\t\tcommandId: `${request.requestId}:executor-work-queue-submit`,\n\t\tpayload,\n\t\tworkId: submit.workId ?? `executor:${request.requestId}`,\n\t\tpriority: submit.priority,\n\t\ttags: submit.tags ?? [\"executor\", request.requestKind],\n\t\trequirements: submit.requirements,\n\t\tnotBeforeMs: submit.notBeforeMs,\n\t\tdeadlineMs: submit.deadlineMs,\n\t\tidempotencyKey: request.requestId,\n\t\tsourceRefs: stringRefs(request.sourceRefs),\n\t};\n}\n\nfunction reduceRecord(\n\tctx: Ctx,\n\tstate: ExecutorQueueState,\n\trecord: WorkQueueRecord<ExecutorQueuedDispatchPayload>,\n\topts: ExecutorWorkQueueRecipeOptions,\n): void {\n\tif (record.kind === \"work-admitted\") {\n\t\tstate.payloads.set(record.workId, record.payload);\n\t\treturn;\n\t}\n\tretireClaimForRecord(state, record);\n\tif (record.kind !== \"work-claimed\") return;\n\tif (opts.workerId !== undefined && record.workerId !== opts.workerId) return;\n\tconst payload = state.payloads.get(record.workId);\n\tif (payload === undefined) {\n\t\temit(ctx, { kind: \"issue\", issue: queueIssue(record, \"executor-claim-without-payload\") });\n\t\treturn;\n\t}\n\tconst attempt: ExecutorQueuedDispatchAttempt = {\n\t\tkind: \"executor-queued-dispatch-attempt\",\n\t\tworkId: record.workId,\n\t\tleaseId: record.leaseId,\n\t\tqueueAttempt: record.attempt,\n\t\tworkerId: record.workerId,\n\t\trequestId: payload.requestId,\n\t\toperationId: payload.operationId,\n\t\trouteId: payload.routeId,\n\t\texecutorId: payload.executorId,\n\t\tprofileId: payload.profileId,\n\t\tpayload,\n\t\tsourceRefs: [...(payload.sourceRefs ?? []), ref(\"work-queue-record\", String(record.recordSeq))],\n\t};\n\tconst key = outcomeKey(payload, record.attempt);\n\tstate.activeClaims.set(key, attempt);\n\temit(ctx, { kind: \"attempt\", attempt });\n\tconst pending = state.pendingOutcomes.get(key);\n\tif (pending !== undefined) {\n\t\tstate.pendingOutcomes.delete(key);\n\t\tfor (const outcome of pending) {\n\t\t\tmapClaimedOutcome(ctx, state, key, attempt, outcome, opts);\n\t\t}\n\t}\n}\n\nfunction reduceOutcome(\n\tctx: Ctx,\n\tstate: ExecutorQueueState,\n\toutcome: ExecutorOutcome,\n\topts: ExecutorWorkQueueRecipeOptions,\n): void {\n\tif (state.seenOutcomes.has(outcome.outcomeId)) return;\n\tconst key = outcomeKey(outcome, outcome.attempt);\n\tif (state.terminalClaims.has(key)) {\n\t\tstate.seenOutcomes.add(outcome.outcomeId);\n\t\temit(ctx, {\n\t\t\tkind: \"issue\",\n\t\t\tissue: {\n\t\t\t\tkind: \"issue\",\n\t\t\t\tcode: \"executor-duplicate-terminal-outcome-for-queue-claim\",\n\t\t\t\tmessage: `ExecutorOutcome '${outcome.outcomeId}' arrived after the queue claim was already terminal`,\n\t\t\t\trefs: [`executor-outcome:${outcome.outcomeId}`],\n\t\t\t},\n\t\t});\n\t\treturn;\n\t}\n\tconst claim = state.activeClaims.get(key);\n\tif (claim === undefined) {\n\t\tbufferPendingOutcome(state, key, outcome);\n\t\treturn;\n\t}\n\tmapClaimedOutcome(ctx, state, key, claim, outcome, opts);\n}\n\nfunction mapClaimedOutcome(\n\tctx: Ctx,\n\tstate: ExecutorQueueState,\n\tkey: string,\n\tclaim: ExecutorQueuedDispatchAttempt,\n\toutcome: ExecutorOutcome,\n\topts: ExecutorWorkQueueRecipeOptions,\n): void {\n\tif (state.seenOutcomes.has(outcome.outcomeId)) return;\n\tstate.seenOutcomes.add(outcome.outcomeId);\n\tif (state.terminalClaims.has(key)) {\n\t\temit(ctx, {\n\t\t\tkind: \"issue\",\n\t\t\tissue: {\n\t\t\t\tkind: \"issue\",\n\t\t\t\tcode: \"executor-duplicate-terminal-outcome-for-queue-claim\",\n\t\t\t\tmessage: `ExecutorOutcome '${outcome.outcomeId}' arrived after the queue claim was already terminal`,\n\t\t\t\trefs: [`executor-outcome:${outcome.outcomeId}`, `work-queue-work:${claim.workId}`],\n\t\t\t},\n\t\t});\n\t\treturn;\n\t}\n\tif (outcome.kind === \"result\") {\n\t\tterminalizeClaim(state, key);\n\t\temit(ctx, {\n\t\t\tkind: \"command\",\n\t\t\tcommand: {\n\t\t\t\tkind: \"complete\",\n\t\t\t\tcommandId: `${outcome.outcomeId}:queue-complete`,\n\t\t\t\tworkId: claim.workId,\n\t\t\t\tleaseId: claim.leaseId,\n\t\t\t\tattempt: claim.queueAttempt,\n\t\t\t\tworkerId: claim.workerId,\n\t\t\t\tresult: outcome.result,\n\t\t\t\tsourceRefs: stringRefs(outcome.evidenceRefs),\n\t\t\t},\n\t\t});\n\t\treturn;\n\t}\n\tif (outcome.kind === \"canceled\") {\n\t\tterminalizeClaim(state, key);\n\t\temit(ctx, {\n\t\t\tkind: \"command\",\n\t\t\tcommand: {\n\t\t\t\tkind: \"cancel\",\n\t\t\t\tcommandId: `${outcome.outcomeId}:queue-cancel`,\n\t\t\t\tworkId: claim.workId,\n\t\t\t\treason: outcome.reason,\n\t\t\t\tsourceRefs: stringRefs(outcome.evidenceRefs),\n\t\t\t},\n\t\t});\n\t\treturn;\n\t}\n\tterminalizeClaim(state, key);\n\temit(ctx, {\n\t\tkind: \"command\",\n\t\tcommand: {\n\t\t\tkind: \"fail\",\n\t\t\tcommandId: `${outcome.outcomeId}:queue-fail`,\n\t\t\tworkId: claim.workId,\n\t\t\tleaseId: claim.leaseId,\n\t\t\tattempt: claim.queueAttempt,\n\t\t\tworkerId: claim.workerId,\n\t\t\terror: outcomeError(outcome),\n\t\t\tretryable: outcomeRetryable(outcome, opts.policy),\n\t\t\tsourceRefs: stringRefs(outcome.evidenceRefs),\n\t\t},\n\t});\n}\n\nfunction outcomeError(\n\toutcome: Extract<ExecutorOutcome, { kind: \"failure\" | \"timeout\" | \"blocked\" }>,\n): unknown {\n\tif (outcome.kind === \"failure\") return outcome.error;\n\tif (outcome.kind === \"timeout\") {\n\t\treturn {\n\t\t\tkind: \"issue\",\n\t\t\tcode: \"executor-timeout\",\n\t\t\tmessage: `ExecutorOutcome '${outcome.outcomeId}' timed out`,\n\t\t\tmetadata: { timeoutMs: outcome.timeoutMs },\n\t\t} satisfies DataIssue;\n\t}\n\treturn {\n\t\tkind: \"issue\",\n\t\tcode: \"executor-blocked\",\n\t\tmessage: `ExecutorOutcome '${outcome.outcomeId}' blocked`,\n\t\tmetadata: { needs: outcome.needs },\n\t} satisfies DataIssue;\n}\n\nfunction outcomeRetryable(\n\toutcome: ExecutorOutcome,\n\tpolicy: ExecutorWorkQueuePolicy | undefined,\n): boolean | undefined {\n\tif (outcome.kind === \"failure\") return outcome.retryable;\n\tif (outcome.kind === \"timeout\") return outcome.retryable ?? policy?.retryableTimeout;\n\tif (outcome.kind === \"blocked\") return policy?.retryableBlocked;\n\treturn undefined;\n}\n\nfunction project<T>(\n\tgraph: Graph,\n\truntime: Node<ExecutorQueueFact>,\n\tname: string,\n\tfactory: string,\n\tselect: (fact: ExecutorQueueFact) => T | undefined,\n): Node<T> {\n\treturn graph.node<T>(\n\t\t[runtime],\n\t\t(ctx) => {\n\t\t\tfor (const raw of depBatch(ctx, 0) ?? []) {\n\t\t\t\tconst selected = select(raw as ExecutorQueueFact);\n\t\t\t\tif (selected !== undefined) ctx.down([[\"DATA\", selected]]);\n\t\t\t}\n\t\t},\n\t\t{ name, factory, partial: true, completeWhenDepsComplete: false, errorWhenDepsError: false },\n\t);\n}\n\nfunction emit(ctx: Ctx, fact: ExecutorQueueFact): void {\n\tctx.down([[\"DATA\", fact]]);\n}\n\nfunction emptyState(): ExecutorQueueState {\n\treturn {\n\t\tpayloads: new Map(),\n\t\tactiveClaims: new Map(),\n\t\tpendingOutcomes: new Map(),\n\t\tterminalClaims: new Set(),\n\t\tseenOutcomes: new Set(),\n\t};\n}\n\nfunction terminalizeClaim(state: ExecutorQueueState, key: string): void {\n\tstate.terminalClaims.add(key);\n\tstate.activeClaims.delete(key);\n}\n\nfunction bufferPendingOutcome(\n\tstate: ExecutorQueueState,\n\tkey: string,\n\toutcome: ExecutorOutcome,\n): void {\n\tconst pending = state.pendingOutcomes.get(key) ?? [];\n\tif (!pending.some((candidate) => candidate.outcomeId === outcome.outcomeId)) {\n\t\tstate.pendingOutcomes.set(key, [...pending, outcome]);\n\t}\n}\n\nfunction retireClaimForRecord(\n\tstate: ExecutorQueueState,\n\trecord: WorkQueueRecord<ExecutorQueuedDispatchPayload>,\n): void {\n\tif (\n\t\trecord.kind !== \"attempt-completed\" &&\n\t\trecord.kind !== \"work-completed\" &&\n\t\trecord.kind !== \"work-canceled\" &&\n\t\trecord.kind !== \"work-dead-lettered\" &&\n\t\trecord.kind !== \"work-released\" &&\n\t\trecord.kind !== \"lease-expired\"\n\t) {\n\t\treturn;\n\t}\n\tfor (const [key, claim] of state.activeClaims) {\n\t\tif (claim.workId !== record.workId) continue;\n\t\tif (\"attempt\" in record && record.attempt !== claim.queueAttempt) continue;\n\t\tterminalizeClaim(state, key);\n\t}\n}\n\nfunction outcomeKey(\n\tvalue: Pick<ExecutorQueuedDispatchPayload | ExecutorOutcome, \"requestId\" | \"operationId\">,\n\tattempt: number,\n): string {\n\treturn `${value.requestId}:${value.operationId}:${attempt}`;\n}\n\nfunction queueIssue(record: WorkQueueRecord, code: string): DataIssue {\n\treturn {\n\t\tkind: \"issue\",\n\t\tcode,\n\t\tmessage: `WorkQueue record '${record.kind}' cannot be mapped to executor dispatch`,\n\t\trefs: [`work-queue-record:${record.recordSeq}`],\n\t\tmetadata: { queueRecordKind: record.kind, workId: record.workId },\n\t};\n}\n\nfunction ref(kind: string, id: string): SourceRef {\n\treturn { kind, id };\n}\n\nfunction stringRefs(refs: readonly SourceRef[] | undefined): readonly string[] | undefined {\n\treturn refs?.map((sourceRef) => `${sourceRef.kind}:${sourceRef.id}`);\n}\n","/**\n * Wave-protocol message types and the tier const table.\n *\n * Canonical authority: ~/src/graphrefly/spec/rules.jsonl\n *   R-msg-format, R-msg-closed-set, R-tier (D34), R-data-payload, R-sentinel.\n */\n\n/** Opaque pause-lock / pull identifier (R-pause-lockset, R-pull). */\nexport type LockId = string | symbol;\n\n/** Explicit pull demand payload (D269/D272). Params are holder-visible context, never DATA-up. */\nexport interface PullDemand {\n\treadonly pullId: LockId;\n\treadonly params?: unknown;\n}\n\n/**\n * The CLOSED set of 11 message types (R-msg-closed-set / D9 + D269 + START handshake).\n * No open set, no user-defined custom types. Adding a type is a spec change.\n */\nexport type Message =\n\t| readonly [\"START\"]\n\t| readonly [\"DIRTY\"]\n\t| readonly [\"DATA\", unknown]\n\t| readonly [\"RESOLVED\"]\n\t| readonly [\"INVALIDATE\"]\n\t| readonly [\"COMPLETE\"]\n\t| readonly [\"ERROR\", unknown]\n\t| readonly [\"TEARDOWN\"]\n\t| readonly [\"PAUSE\", LockId]\n\t| readonly [\"RESUME\", LockId]\n\t| readonly [\"PULL\", PullDemand];\n\n/** One array of messages delivered in one call = one Wave (R-wave-boundary). */\nexport type Wave = readonly Message[];\n\n/** The message-type tag (the first tuple element). */\nexport type MessageType = Message[0];\n\n/**\n * SENTINEL = absence-of-DATA (R-sentinel / D16). TS representation is `undefined`.\n * Never a valid DATA payload; `null` IS a valid DATA value (domain-level absence).\n */\nexport const SENTINEL = undefined;\n\n/** R-data-payload: ERROR payloads must not collide with terminal metadata shorthand. */\nexport function isInvalidErrorPayload(v: unknown): boolean {\n\treturn v === SENTINEL || typeof v === \"boolean\";\n}\n\n/** R-data-payload / D78: host-language failures that collide with ctx.terminal shorthand become diagnostics. */\nexport function errorPayload(reason: unknown, fallback = \"error without a valid payload\"): unknown {\n\treturn isInvalidErrorPayload(reason) ? new Error(fallback) : reason;\n}\n\nexport const TIER_START = 0;\nexport const TIER_CONTROL = 1;\nexport const TIER_NOTIFICATION = 2;\nexport const TIER_VALUE = 3;\nexport const TIER_SETTLE = 4;\nexport const TIER_TERMINAL = 5;\nexport const TIER_TEARDOWN = 6;\n\n/**\n * Tier const table (R-tier / D34). Tiers below value dispatch immediately; value\n * and above are batch-deferred. This is a compile-time const table (D18), not runtime config.\n */\nconst TIER: Record<MessageType, number> = {\n\tSTART: TIER_START,\n\tPAUSE: TIER_CONTROL,\n\tRESUME: TIER_CONTROL,\n\tPULL: TIER_CONTROL,\n\tDIRTY: TIER_NOTIFICATION,\n\tDATA: TIER_VALUE,\n\tRESOLVED: TIER_VALUE,\n\tINVALIDATE: TIER_SETTLE,\n\tCOMPLETE: TIER_TERMINAL,\n\tERROR: TIER_TERMINAL,\n\tTEARDOWN: TIER_TEARDOWN,\n};\n\nexport function messageTier(t: MessageType): number {\n\treturn TIER[t];\n}\n\n/** Value and above are deferred inside a batch (DATA/RESOLVED/INVALIDATE/terminal/teardown). */\nexport function isDeferredTier(t: MessageType): boolean {\n\treturn TIER[t] >= TIER_VALUE;\n}\n\n/** Value-tier messages (DATA/RESOLVED) occupy the tier-3 slot. */\nexport function isValueTier(t: MessageType): boolean {\n\treturn TIER[t] === TIER_VALUE;\n}\n\n/** The pause buffer holds the settle slice only: value-tier DATA/RESOLVED plus INVALIDATE. */\nexport function isPauseBufferedTier(t: MessageType): boolean {\n\tconst tier = TIER[t];\n\treturn tier === TIER_VALUE || tier === TIER_SETTLE;\n}\n\n/**\n * A TERMINAL message = tier 5 (COMPLETE | ERROR), R-tier / D34. Detected via the CENTRAL tier\n * table, NOT a per-variant `=== \"COMPLETE\" || === \"ERROR\"` check — so terminal routing stays\n * driven by the one const table (feedback_use_tier_for_signal_routing); discriminate COMPLETE vs\n * ERROR within the tier by the message type only where the handling actually differs.\n */\nexport function isTerminal(t: MessageType): boolean {\n\treturn TIER[t] === TIER_TERMINAL;\n}\n\n/**\n * ctx.up carries control/demand tiers only (R-ctx-up / D269): DIRTY, PAUSE, RESUME, PULL,\n * INVALIDATE, TEARDOWN. DATA/RESOLVED (tier 3) and COMPLETE/ERROR (tier 5) are\n * down-only.\n */\nexport function isUpAllowed(t: MessageType): boolean {\n\tconst tier = TIER[t];\n\treturn tier !== TIER_VALUE && tier !== TIER_TERMINAL;\n}\n","/**\n * The fn-invocation context and per-dep input shapes.\n *\n * Canonical authority: ~/src/graphrefly/spec/rules.jsonl\n *   R-fn-contract (D8/D27), R-ctx-state (D23/D29), R-cleanup-hooks (D28), R-ctx-up.\n */\n\nimport type { Dispatcher } from \"../dispatcher/index.js\";\nimport type { EnvironmentDrivers } from \"../graph/environment.js\";\nimport type { Node } from \"../node/node.js\";\nimport { type Message, type PullDemand, SENTINEL, type Wave } from \"../protocol/messages.js\";\n\n/** A downstream sink callback (the only way to connect to a node's output). */\nexport type Sink = (msg: Message, delivery?: DeliveryMeta) => void;\n\n/** Internal delivery metadata used to preserve the upstream `ctx.down(msgs)` wave boundary. */\nexport interface DeliveryMeta {\n\treadonly wave: object;\n\treadonly last: boolean;\n}\n\n/**\n * Internal current-value reader. It is deliberately a symbol-backed implementation detail:\n * raw ctx exposes `waveData` + `terminal`; helpers below derive from that plus this dep cache.\n */\nexport const CTX_DEP_CACHE: unique symbol = Symbol(\"graphrefly.ctx.depCache\");\n\nexport interface CtxDepCache {\n\treadonly latest: readonly unknown[];\n}\n\n/** Internal node-construction binding for graph-local helper-created deps. */\nexport const CTX_NODE_BINDING: unique symbol = Symbol(\"graphrefly.ctx.nodeBinding\");\n\nexport interface CtxNodeBinding {\n\treadonly dispatcher: Dispatcher;\n\tcreate<T>(factory: () => Node<T>): Node<T>;\n}\n\n/** Per-dep wave projections: dep -> waves -> values/SENTINEL markers. */\nexport type WaveData = readonly (readonly (readonly unknown[])[])[];\n\n/** Terminal metadata parallel to `waveData`: false = none, true = COMPLETE, otherwise ERROR payload. */\nexport type TerminalData = readonly unknown[];\n\nexport function isTerminalNone(t: unknown): boolean {\n\treturn t === false || t === undefined;\n}\n\nexport function isTerminalComplete(t: unknown): t is true {\n\treturn t === true;\n}\n\nexport function isTerminalError(t: unknown): boolean {\n\treturn !isTerminalNone(t) && !isTerminalComplete(t);\n}\n\nexport function terminalErrorValue(t: unknown): unknown {\n\treturn isTerminalError(t) ? t : undefined;\n}\n\n/**\n * Per-node private cross-wave state (R-ctx-state / D23,D29). Default fresh-lifecycle\n * wipe; `persist(true)` keeps it across lifecycle transitions.\n */\nexport interface CtxState {\n\tget<S = unknown>(): S | undefined;\n\tset<S = unknown>(v: S): void;\n\tpersist(on?: boolean): void;\n}\n\n/**\n * Deferred SELF-rewire (R-rewire-deferred / D47). A node fn may, DURING its run, request a\n * mutation of its OWN dep set; the request is QUEUED and applied at the committed wave boundary\n * (after the current wave settles / batch commit / final-lock RESUME) as a fresh wave, reusing\n * R-rewire surgical/Option-C semantics (D42). This is the ONLY legal self-triggered rewire — an\n * IMMEDIATE in-fn `node.subscribeDep/unsubscribeDep/replaceDeps` is the D37 mid-fn feedback-cycle ERROR. An\n * added cached dep pushes `[DIRTY,DATA]` on the boundary wave (R-push-subscribe); a removed dep\n * is drained and, if it loses its last subscriber, `_deactivate`s + fires `onDeactivation`\n * (input-side teardown — the basis for higher-order operator cancellation / abortInFlight).\n */\nexport interface RewireNext {\n\t/** Defer subscribing to a dep (paired with the re-supplied fn — positional fn-deps lock, SD-1). */\n\tsubscribeDep(dep: Node<unknown>, fn: NodeFn): void;\n\t/** Defer unsubscribing from a dep (its source is torn down if it loses its last subscriber). */\n\tunsubscribeDep(dep: Node<unknown>, fn: NodeFn): void;\n\t/** Defer replacing the whole dep set (surgical: kept deps untouched, removed drained, added fresh-subscribe). */\n\treplaceDeps(deps: Node<unknown>[], fn: NodeFn): void;\n}\n\n/**\n * The single argument to a node fn: `(ctx) => void` (R-fn-contract / D8). All emission\n * is explicit via `ctx.down`; there is no return-value framing.\n */\nexport interface Ctx {\n\t/**\n\t * Emit upstream toward deps — control tiers only (R-ctx-up). IMMEDIATE. `towardDep` (a dep index)\n\t * routes the wave up ONE declared edge (R-up-routing directed-up); omitted = broadcast up all deps.\n\t * A pull DEMAND is `up([[PULL, { pullId, params }]])` — but for a SELF-demand (demanding a dep\n\t * this fn also reads) use {@link Ctx.upNext} instead, since an immediate demand whose delivery loops back\n\t * re-enters this fn mid-wave (D37 / R-reentrancy).\n\t */\n\tup(msgs: Wave, towardDep?: number): void;\n\t/** Emit downstream toward sinks. */\n\tdown(msgs: Wave): void;\n\t/**\n\t * The single raw dep-value input surface (R-ctx-wave-data / D77): dep -> upstream waves ->\n\t * per-wave DATA payloads and INVALIDATE/SENTINEL markers. `waveData[i] = []` means dep i\n\t * delivered no wave to this invocation; `waveData[i] = [[]]` means RESOLVED-only.\n\t */\n\twaveData: WaveData;\n\t/** Terminal metadata for the same invocation; terminal values never enter `waveData`. */\n\tterminal: TerminalData;\n\tstate: CtxState;\n\t/** Release external resources on deactivation (R-cleanup-hooks). */\n\tonDeactivation(fn: () => void): void;\n\t/** Flush on INVALIDATE (R-cleanup-hooks). */\n\tonInvalidate(fn: () => void): void;\n\t/** Graph-owned environment drivers for source/adapter boundaries (D130/D131). */\n\tenvironment(): EnvironmentDrivers;\n\t/** Holder-visible context for a PULL-caused invocation (D272); absent for ordinary waves. */\n\treadonly pull?: PullDemand;\n\t/**\n\t * Deferred SELF-rewire (R-rewire-deferred / D47) — the substrate affordance higher-order\n\t * operators (switchMap/mergeMap/concatMap/exhaustMap/flatMap) use to grow/shrink their own\n\t * inner-source dep set in response to their own data. Always present; see {@link RewireNext}.\n\t */\n\trewireNext: RewireNext;\n\t/**\n\t * Deferred up — the boundary-deferred form of {@link Ctx.up} (R-up-routing / R-pull / D59). Routes\n\t * `msgs` up from this node at the COMMITTED wave boundary (broadcast, or up the single `towardDep`\n\t * edge), riding the same R-rewire-deferred (D47) drain as {@link RewireNext}. This is the\n\t * SELF-DEMAND path: a consumer issues `ctx.upNext([[PULL, { pullId, params }]])` to demand a pull\n\t * dep it ALSO reads — the cone-routed PULL reaches the pullId-holder, whose delivery loops back as a\n\t * FRESH wave (not a mid-fn re-entry → no D37). The consumer accepts one-wave latency (the\n\t * HTTP-request model). No node reference needed: the author writes the pullId verbatim.\n\t */\n\tupNext(msgs: Wave, towardDep?: number): void;\n\t/**\n\t * Read a dep's latest value by index (dynamicNode only, R-dynamic-node / D35).\n\t * Present only on dynamicNode fns; all declared deps still participate in wave\n\t * tracking. Under D49/R-resolved-undirty an unread dep's change still fires the fn,\n\t * which re-emits its (unchanged) output as a DATA occurrence — there is NO equals-\n\t * absorption; pair with distinctUntilChanged to suppress unchanged re-emits (opt-in).\n\t */\n\ttrack?(depIndex: number): unknown;\n\t[CTX_DEP_CACHE]?: CtxDepCache;\n\t[CTX_NODE_BINDING]?: CtxNodeBinding;\n}\n\n/** A node fn (R-fn-contract). Registered in a dispatcher pool, indexed by Handle. */\nexport type NodeFn = (ctx: Ctx) => void;\n\n/** Number of declared dep slots visible in this invocation. */\nexport function depCount(ctx: Ctx): number {\n\treturn ctx.waveData.length;\n}\n\n/** DATA/SENTINEL projection batches delivered by one dep in this invocation. */\nexport function depWaves(ctx: Ctx, depIndex: number): readonly (readonly unknown[])[] {\n\treturn ctx.waveData[depIndex] ?? [];\n}\n\n/** Flattened DATA projection for old event-counting operator bodies; null = no wave. */\nexport function depBatch(ctx: Ctx, depIndex: number): readonly unknown[] | null {\n\tconst waves = depWaves(ctx, depIndex);\n\tif (waves.length === 0) return null;\n\tconst flattened = waves.flat().filter((v) => v !== SENTINEL);\n\treturn flattened.length === 0 ? [] : flattened;\n}\n\n/** Latest cached DATA for a dep, derived from implementation-owned dep cache. */\nexport function depLatest(ctx: Ctx, depIndex: number): unknown {\n\treturn ctx[CTX_DEP_CACHE]?.latest[depIndex];\n}\n\n/** Terminal metadata for one dep: false = none, true = COMPLETE, otherwise ERROR payload. */\nexport function depTerminal(ctx: Ctx, depIndex: number): unknown {\n\tconst t = ctx.terminal[depIndex];\n\treturn t === undefined ? false : t;\n}\n"],"mappings":"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","names":[]}

package/dist/executors/work-queue.d.cts

@@ -0,0 +1,90 @@
+import { DataIssue } from '../data/index.cjs';
+import { d as Graph } from '../graph-DCEWh4T2.cjs';
+import { N as Node } from '../types-CcPIn7sy.cjs';
+import { S as SourceRef, A as AgentRequestIssued, E as ExecutorOutcome } from '../agent-runtime-DZTJ3C-p.cjs';
+import { WorkQueueCommand, WorkQueueRecord } from '../work-queue/index.cjs';
+import '../core/index.cjs';
+import '../messages-CAzUPPJM.cjs';
+import '../codec-BB7p8fJc.cjs';
+import '../describe-DYMw_l1C.cjs';
+import '../messaging/index.cjs';
+
+/**
+ * Durable executor dispatch recipe over workQueue (D328/D331).
+ *
+ * Claim records become graph-visible dispatch-attempt facts. Executor outcomes become queue
+ * lifecycle commands. The recipe never calls ExecutorBinding or treats a queue claim as dispatch.
+ */
+
+interface ExecutorQueuedDispatchPayload {
+    readonly kind: "executor-queued-dispatch";
+    readonly requestId: string;
+    readonly operationId: string;
+    readonly parentRequestId?: string;
+    readonly sourceDecisionId?: string;
+    readonly intentId?: string;
+    readonly inputId?: string;
+    readonly toolCallSeriesId?: string;
+    readonly routeId?: string;
+    readonly profileId?: string;
+    readonly executorId?: string;
+    readonly effectRunId?: string;
+    readonly promptBundleRefs?: readonly SourceRef[];
+    readonly toolDefinitionRefs?: readonly SourceRef[];
+    readonly policyRefs?: readonly SourceRef[];
+    readonly budgetRefs?: readonly SourceRef[];
+    readonly permissionRefs?: readonly SourceRef[];
+    readonly sandboxRefs?: readonly SourceRef[];
+    readonly sourceRefs?: readonly SourceRef[];
+    readonly artifactRefs?: readonly SourceRef[];
+    readonly idempotencyKey?: string;
+    readonly requirements?: readonly string[];
+    readonly metadata?: Record<string, unknown>;
+}
+type ExecutorQueuedDispatchPayloadExtra = Partial<Omit<ExecutorQueuedDispatchPayload, "kind" | "requestId" | "operationId">>;
+interface ExecutorQueuedDispatchAttempt {
+    readonly kind: "executor-queued-dispatch-attempt";
+    readonly workId: string;
+    readonly leaseId: string;
+    readonly queueAttempt: number;
+    readonly workerId: string;
+    readonly requestId: string;
+    readonly operationId: string;
+    readonly routeId?: string;
+    readonly executorId?: string;
+    readonly profileId?: string;
+    readonly payload: ExecutorQueuedDispatchPayload;
+    readonly sourceRefs?: readonly SourceRef[];
+}
+interface ExecutorWorkQueueSubmitOptions {
+    readonly workId?: string;
+    readonly priority?: number;
+    readonly tags?: readonly string[];
+    readonly requirements?: readonly string[];
+    readonly notBeforeMs?: number;
+    readonly deadlineMs?: number;
+}
+interface ExecutorWorkQueuePolicy {
+    readonly submit?: (request: AgentRequestIssued) => ExecutorWorkQueueSubmitOptions;
+    readonly payload?: (request: AgentRequestIssued) => ExecutorQueuedDispatchPayloadExtra;
+    readonly retryableBlocked?: boolean;
+    readonly retryableTimeout?: boolean;
+}
+interface ExecutorWorkQueueRecipeOptions {
+    readonly name?: string;
+    readonly requests?: Node<AgentRequestIssued>;
+    readonly records: Node<WorkQueueRecord<ExecutorQueuedDispatchPayload>>;
+    readonly outcomes: Node<ExecutorOutcome>;
+    readonly workerId?: string;
+    readonly policy?: ExecutorWorkQueuePolicy;
+}
+interface ExecutorWorkQueueRecipeBundle {
+    readonly submitCommands?: Node<WorkQueueCommand<ExecutorQueuedDispatchPayload>>;
+    readonly attempts: Node<ExecutorQueuedDispatchAttempt>;
+    readonly commands: Node<WorkQueueCommand<ExecutorQueuedDispatchPayload>>;
+    readonly issues: Node<DataIssue>;
+}
+declare function executorWorkQueueRecipe(graph: Graph, opts: ExecutorWorkQueueRecipeOptions): ExecutorWorkQueueRecipeBundle;
+declare function executorSubmitCommand(request: AgentRequestIssued, policy?: ExecutorWorkQueuePolicy): WorkQueueCommand<ExecutorQueuedDispatchPayload>;
+
+export { type ExecutorQueuedDispatchAttempt, type ExecutorQueuedDispatchPayload, type ExecutorQueuedDispatchPayloadExtra, type ExecutorWorkQueuePolicy, type ExecutorWorkQueueRecipeBundle, type ExecutorWorkQueueRecipeOptions, type ExecutorWorkQueueSubmitOptions, executorSubmitCommand, executorWorkQueueRecipe };