@smthrs/gateway 0.35.0 → 1.0.0-rc.3

package/dist/cjs/EngineTrace.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/EngineTrace.ts"],
+  "sourcesContent": ["/**\n * Recorded native evidence, decoded through the contracts that wrote it.\n *\n * @since 1.0.0\n */\n\nimport { RunState } from \"@smthrs/engine-store/RunState\"\nimport { ResultEncoded } from \"@smthrs/flow/Flow\"\nimport * as EngineEvent from \"@smthrs/journal/EngineEvent\"\nimport * as JournalEvent from \"@smthrs/journal/JournalEvent\"\nimport { Option, Schema } from \"effect\"\nimport { inspectLabel } from \"./internal/inspectLabels.ts\"\nimport type { JournalRecord, SpanDetail, TraceBuilder } from \"./RunTrace.ts\"\n\n// This is the private control bridge's envelope, not another engine contract.\nconst Envelope = Schema.Struct({\n  version: Schema.Literal(1),\n  executionId: JournalEvent.RunId,\n  generation: JournalEvent.NonNegativeQuantity,\n  sequence: JournalEvent.Seq,\n  eventId: Schema.String,\n  sourceId: JournalEvent.SourceId,\n  sourceSequence: JournalEvent.SourceSeq,\n  emittedAtMs: JournalEvent.TimestampMs,\n  eventType: Schema.NonEmptyString,\n  payload: Schema.Json,\n  meta: Schema.Json\n})\ntype Envelope = typeof Envelope.Type\n\nconst decodeEnvelope = Schema.decodeUnknownOption(Envelope)\nconst decodeGraph = Schema.decodeUnknownOption(EngineEvent.NodeGraph)\nconst decodeScheduled = Schema.decodeUnknownOption(EngineEvent.NodeScheduledPayload)\nconst decodeSettled = Schema.decodeUnknownOption(EngineEvent.NodeSettledPayload)\nconst decodeAttempt = Schema.decodeUnknownOption(EngineEvent.AttemptPayload, { onExcessProperty: \"error\" })\nconst decodeState = Schema.decodeUnknownOption(EngineEvent.StatePayload, { onExcessProperty: \"error\" })\nconst decodeMarker = Schema.decodeUnknownOption(EngineEvent.CurrentAttempt)\nconst stateDecisions = [\n  \"created\",\n  \"resumed\",\n  \"transitioned\",\n  \"handed-off\",\n  \"lineage-exhausted\",\n  \"round-invalid\",\n  \"quarantined\",\n  \"interrupt-released\"\n] as const\nconst decodeDecision = Schema.decodeUnknownOption(Schema.Struct({\n  decision: Schema.Literals(stateDecisions),\n  status: Schema.optionalKey(Schema.Literals([\"pending\", \"running\", \"suspended\", \"completed\", \"failed\", \"cancelled\"])),\n  state: RunState\n}))\n// RunDriver's durable cancellation record has no run-decision counterpart.\nconst decodeCancellation = Schema.decodeUnknownOption(Schema.Struct({\n  outcome: Schema.Literal(\"cancelled\"),\n  interruptedAtMs: JournalEvent.TimestampMs,\n  owner: Schema.String,\n  cascadedTo: Schema.optionalKey(Schema.Array(JournalEvent.RunId))\n}))\nconst decodeResult = Schema.decodeUnknownOption(ResultEncoded, { onExcessProperty: \"error\" })\n\nconst json = (value: unknown): string => typeof value === \"string\" ? value : JSON.stringify(value)\nconst identity = (...parts: ReadonlyArray<string | number>) =>\n  parts.map((part) => encodeURIComponent(String(part))).join(\":\")\nconst span = (id: string, kind: TraceBuilder[\"kind\"], label: string, at: number, detail: SpanDetail): TraceBuilder => ({\n  id,\n  kind,\n  label,\n  status: \"recorded\",\n  startedAt: at,\n  children: [],\n  detail\n})\nconst detail = (row: JournalRecord, envelope: Envelope): SpanDetail => ({\n  sequence: row.sequence,\n  event: envelope.eventType,\n  fields: { ...envelope }\n})\ninterface Execution {\n  readonly envelope: Envelope\n  readonly span: TraceBuilder\n  parentId?: string | undefined\n  parentExecutionId?: string | undefined\n  parentKnown?: boolean | undefined\n  flowName?: string | undefined\n  coherent: boolean\n  waits?: Map<string, { id: string; kind: \"sleep\" | \"signal\"; since: number; settledAt?: number }>\n  graph?: EngineEvent.NodeGraph | undefined\n  result?: { readonly value: unknown; readonly sequence: number } | undefined\n  failure?: EngineExecutionEvidence[\"failure\"] | undefined\n}\n\n/**\n * A render-only view of the same decoded execution facts; never persisted.\n *\n * @category models\n * @since 1.0.0\n */\nexport interface EngineExecutionEvidence {\n  readonly executionId: string\n  readonly generation: number\n  readonly spanId: string\n  readonly parentExecutionId?: string | undefined\n  readonly parentKnown: boolean\n  readonly flowName?: string | undefined\n  readonly input?: unknown | undefined\n  readonly coherent: boolean\n  /** Declared nodes, including work not reached at this journal cursor. */\n  readonly graph?: EngineEvent.NodeGraph | undefined\n  readonly status: string\n  /** Recorded clock and deferred registrations and their explicit settlements. */\n  readonly waits: ReadonlyArray<{ readonly id: string; readonly kind: \"sleep\" | \"signal\"; readonly since: number; readonly settledAt?: number }>\n  readonly result?: { readonly value: unknown; readonly sequence: number } | undefined\n  /** Original classified failure bytes, never parsed from rendered detail. */\n  readonly failure?: {\n    readonly kind: \"cause\" | \"error\" | \"defect\" | \"interrupted\" | \"encoding\"\n    readonly value: unknown\n    readonly sequence: number\n  } | undefined\n}\nconst decodeProjection = Schema.decodeUnknownOption(Schema.Struct({\n  version: Schema.Literal(1),\n  executionId: JournalEvent.RunId,\n  generation: JournalEvent.NonNegativeQuantity\n}))\n\n/**\n * Observation completion is separate from the control run's terminal verdict.\n *\n * @category utilities\n * @since 1.0.0\n */\nexport const engineProjectionPending = (records: ReadonlyArray<JournalRecord> = []): boolean => {\n  const states = new Map<string, { generation: number; pending: boolean }>()\n  for (const row of [...records].sort((left, right) => (left.sequence ?? 0) - (right.sequence ?? 0))) {\n    if (row.kind === \"control.engine.projection-gap\") {\n      // The gap is rendered as missing evidence. Stop polling rather than\n      // disguising an observation failure as an indefinitely running task.\n      for (const state of states.values()) state.pending = false\n      continue\n    }\n    if (row.kind !== \"control.engine.projection-started\" && row.kind !== \"control.engine.projection-settled\") continue\n    const decoded = decodeProjection(row.payload)\n    if (Option.isNone(decoded)) continue\n    const { executionId, generation } = decoded.value\n    const current = states.get(executionId)\n    if (row.kind === \"control.engine.projection-started\") {\n      if (current === undefined || generation > current.generation) {\n        states.set(executionId, { generation, pending: true })\n      }\n    } else if (current?.generation === generation) current.pending = false\n  }\n  return [...states.values()].some((state) => state.pending)\n}\n\n/**\n * Generations never share attempt identity. Native timestamps describe native\n * work; the outer control sequence still determines the historical UI cursor.\n * Only recorded parent IDs can nest executions. Ambiguous parent generations\n * remain beside the root instead of guessing which historical parent owned them.\n */\nconst foldEngineJournal = (records: ReadonlyArray<JournalRecord>) => {\n  const executions = new Map<string, Execution>()\n  const attempts = new Map<string, TraceBuilder>()\n  const notices: Array<TraceBuilder> = []\n  const nodes = new Map<string, TraceBuilder>()\n  const instances = new Map<string, number>()\n  const seen = new Map<string, string>()\n  for (const row of records) {\n    if (row.kind === \"control.engine.projection-gap\") {\n      const notice = span(\n        `engine-gap:${row.sequence ?? notices.length}`,\n        \"event\",\n        \"Engine evidence gap\",\n        row.occurredAt ?? 0,\n        {\n          sequence: row.sequence,\n          event: row.kind,\n          fields: { evidence: row.payload }\n        }\n      )\n      notice.status = \"unknown\"\n      notice.endedAt = notice.startedAt\n      notices.push(notice)\n      continue\n    }\n    if (row.kind !== \"control.engine.event\") continue\n    const decoded = decodeEnvelope(row.payload)\n    if (Option.isNone(decoded)) {\n      const notice = span(\n        `engine-invalid:${row.sequence ?? notices.length}`,\n        \"event\",\n        \"Unreadable engine evidence\",\n        row.occurredAt ?? 0,\n        {\n          sequence: row.sequence,\n          event: row.kind,\n          fields: { evidence: row.payload }\n        }\n      )\n      notice.status = \"unknown\"\n      notice.endedAt = notice.startedAt\n      notices.push(notice)\n      continue\n    }\n    const envelope = decoded.value\n    const key = identity(envelope.executionId, envelope.generation)\n    const eventKey = identity(key, envelope.sequence)\n    const previous = seen.get(eventKey)\n    if (previous !== undefined) {\n      if (previous !== JSON.stringify(envelope)) {\n        const conflict = executions.get(key)\n        conflict!.coherent = false\n      }\n      continue\n    }\n    seen.set(eventKey, JSON.stringify(envelope))\n    let execution = executions.get(key)\n    if (execution === undefined) {\n      execution = {\n        envelope,\n        coherent: true,\n        span: span(`engine:${key}`, \"execution\", envelope.executionId, envelope.emittedAtMs, detail(row, envelope))\n      }\n      executions.set(key, execution)\n    }\n    const parent = (parentId: string | undefined) => {\n      if (execution.parentKnown && execution.parentExecutionId !== parentId) execution.coherent = false\n      execution.parentKnown = true\n      execution.parentExecutionId = parentId\n      execution.parentId = parentId\n    }\n    const result = (value: unknown) => {\n      if (Number.isSafeInteger(row.sequence) && row.sequence! >= 0) {\n        execution.result = { value, sequence: row.sequence! }\n      }\n    }\n    const failure = (kind: NonNullable<EngineExecutionEvidence[\"failure\"]>[\"kind\"], value: unknown) => {\n      if (Number.isSafeInteger(row.sequence) && row.sequence! >= 0) {\n        execution.failure = { kind, value, sequence: row.sequence! }\n      }\n    }\n    const generic = () => {\n      const event = span(\n        `engine-event:${eventKey}`,\n        \"event\",\n        envelope.eventType,\n        envelope.emittedAtMs,\n        detail(row, envelope)\n      )\n      event.endedAt = event.startedAt\n      execution.span.children.push(event)\n    }\n    const attempt = (step: string, number: number) => {\n      const attemptKey = identity(key, step, number)\n      let current = attempts.get(attemptKey)\n      if (current === undefined) {\n        current = span(\n          `engine-attempt:${attemptKey}`,\n          \"attempt\",\n          `attempt ${number} \u00B7 ${step.slice(0, 12)}`,\n          envelope.emittedAtMs,\n          detail(row, envelope)\n        )\n        attempts.set(attemptKey, current)\n        execution.span.children.push(current)\n      }\n      return current\n    }\n    if (envelope.eventType === EngineEvent.nodeEventTypes.planRecorded || envelope.eventType === EngineEvent.nodeEventTypes.subgraphAppended) {\n      const payload = envelope.payload as { graph?: unknown }\n      const graph = decodeGraph(payload?.graph)\n      if (Option.isSome(graph)) {\n        const nodes = new Map(execution.graph?.nodes.map(node => [node.id, node]))\n        for (const node of graph.value.nodes) nodes.set(node.id, node)\n        execution.graph = { ...graph.value, nodes: [...nodes.values()] }\n      }\n      generic()\n      continue\n    }\n    if (envelope.eventType === EngineEvent.nodeEventTypes.nodeScheduled || envelope.eventType === EngineEvent.nodeEventTypes.nodeSettled) {\n      const scheduled = envelope.eventType === EngineEvent.nodeEventTypes.nodeScheduled\n        ? decodeScheduled(envelope.payload) : Option.none()\n      const settled = envelope.eventType === EngineEvent.nodeEventTypes.nodeSettled\n        ? decodeSettled(envelope.payload) : Option.none()\n      const recorded = Option.isSome(scheduled) ? scheduled.value : Option.isSome(settled) ? settled.value : undefined\n      if (recorded === undefined) {\n        generic()\n        continue\n      }\n      const nodeKey = identity(key, recorded.nodeId)\n      const action = recorded.action ?? execution.graph?.nodes.find(node => node.id === recorded.nodeId)?.action\n      let node = nodes.get(nodeKey)\n      if (node === undefined || Option.isSome(scheduled)) {\n        const instance = (instances.get(nodeKey) ?? 0) + 1\n        instances.set(nodeKey, instance)\n        node = span(`engine-node:${nodeKey}#${instance}`, \"call\", inspectLabel(action ?? recorded.nodeId), envelope.emittedAtMs, detail(row, envelope))\n        nodes.set(nodeKey, node)\n        execution.span.children.push(node)\n      }\n      if (action !== undefined) node.label = inspectLabel(action)\n      node.detail = { ...detail(row, envelope), sequence: node.detail.sequence }\n      if (Option.isSome(scheduled)) {\n        node.status = \"running\"\n      } else {\n        const value = Option.getOrThrow(settled)\n        node.status = value.outcome === \"failed\" ? \"failed\"\n          : value.outcome === \"deferred\" ? \"waiting\"\n          : value.outcome === \"skipped\" ? \"skipped\" : \"completed\"\n        if (value.outcome !== \"deferred\") node.endedAt = envelope.emittedAtMs\n        // The redacted preview is evidence, including when truncated. Never\n        // evaluate it, or mistake a JSON prefix for a complete return value.\n        if (value.result !== undefined) node.detail = { ...node.detail, output: value.result.preview }\n      }\n      continue\n    }\n    if (\n      envelope.eventType === \"flows.engine.attempt-started\" || envelope.eventType === \"flows.engine.attempt-finished\"\n    ) {\n      const marker = decodeMarker({ eventType: envelope.eventType, payload: envelope.payload })\n      if (Option.isNone(marker) || marker.value.payload.runId !== envelope.executionId) {\n        generic()\n        continue\n      }\n      const current = attempt(marker.value.payload.stepKeyDigest, marker.value.payload.attempt)\n      if (marker.value.eventType === \"flows.engine.attempt-started\") current.status = \"running\"\n      else {\n        current.status = marker.value.payload.state === \"succeeded\" ? \"completed\" : \"failed\"\n        current.endedAt = envelope.emittedAtMs\n      }\n      current.detail = { ...current.detail, fields: { ...envelope } }\n      continue\n    }\n    if (envelope.eventType === EngineEvent.attemptEventType) {\n      const recorded = decodeAttempt(envelope.payload)\n      if (Option.isNone(recorded) || recorded.value.executionId !== envelope.executionId) {\n        execution.coherent = false\n        generic()\n        continue\n      }\n      const { lifecycle, lineage, stepKeyDigest, attempt: number } = recorded.value\n      // Lineage may describe a trampoline predecessor, not a spawned parent.\n      // Product ancestry comes only from RunState.parentExecutionId below.\n      execution.parentId = lineage.parentRunId ?? undefined\n      const current = attempt(stepKeyDigest, number)\n      current.startedAt = lifecycle.startedAtMs\n      current.status = lifecycle.state === \"succeeded\"\n        ? \"completed\"\n        : lifecycle.state === \"suspended\"\n        ? \"waiting\"\n        : lifecycle.state\n      current.detail = { ...detail(row, envelope), sequence: current.detail.sequence }\n      if (lifecycle.state === \"succeeded\" || lifecycle.state === \"failed\") {\n        current.endedAt = lifecycle.finishedAtMs\n        current.detail = {\n          ...current.detail,\n          ...(lifecycle.result._tag === \"Success\"\n            ? { output: json(lifecycle.result.value) }\n            : { message: json(lifecycle.result.detail) })\n        }\n      }\n      continue\n    }\n    if (envelope.eventType === EngineEvent.stateEventType) {\n      const recorded = decodeState(envelope.payload)\n      if (Option.isNone(recorded) || recorded.value.executionId !== envelope.executionId) {\n        execution.coherent = false\n        generic()\n        continue\n      }\n      execution.parentId = recorded.value.lineage.parentRunId ?? undefined\n      const registerWait = (waitId: string, kind: \"sleep\" | \"signal\") => {\n        const waits = execution.waits ??= new Map()\n        const id = identity(key, waitId)\n        const existing = waits.get(id)\n        if (existing === undefined) waits.set(id, { id: `engine-wait:${id}`, kind, since: envelope.emittedAtMs })\n        // A later clock record refines a generic deferred identity without\n        // restarting the wait or dropping its recorded settlement.\n        else if (kind === \"sleep\") existing.kind = kind\n      }\n      if (recorded.value.event._tag === \"Execution\" && recorded.value.event.lifecycle.state !== \"completed\") {\n        for (const wait of recorded.value.event.lifecycle.waits) registerWait(wait.waitId, wait._tag === \"Clock\" ? \"sleep\" : \"signal\")\n      }\n      if (recorded.value.event._tag === \"ClockScheduled\") {\n        registerWait(recorded.value.event.waitId, \"sleep\")\n      } else if (recorded.value.event._tag === \"DeferredCompleted\") {\n        const wait = execution.waits?.get(identity(key, recorded.value.event.waitId))\n        if (wait !== undefined && wait.settledAt === undefined) wait.settledAt = envelope.emittedAtMs\n      }\n      if (recorded.value.event._tag !== \"Execution\") {\n        generic()\n        continue\n      }\n      const { lifecycle } = recorded.value.event\n      execution.result = undefined\n      execution.failure = undefined\n      execution.span.detail = {\n        ...detail(row, envelope),\n        sequence: execution.span.detail.sequence,\n        input: execution.span.detail.input\n      }\n      if (lifecycle.state === \"completed\") {\n        execution.span.status = lifecycle.result._tag === \"Success\" ? \"completed\" : \"failed\"\n        execution.span.endedAt = envelope.emittedAtMs\n        execution.span.detail = {\n          ...execution.span.detail,\n          ...(lifecycle.result._tag === \"Success\"\n            ? { output: json(lifecycle.result.value) }\n            : { message: json(lifecycle.result.detail) })\n        }\n        if (lifecycle.result._tag === \"Success\") result(lifecycle.result.value)\n        else failure(lifecycle.result.reason, lifecycle.result.detail)\n      } else execution.span.status = lifecycle.state === \"suspended\" ? \"waiting\" : \"running\"\n      continue\n    }\n    if (envelope.eventType === \"flows.engine.interrupted\") {\n      const cancelled = decodeCancellation(envelope.payload)\n      if (Option.isNone(cancelled)) {\n        generic()\n        continue\n      }\n      execution.result = undefined\n      execution.failure = undefined\n      execution.span.status = \"cancelled\"\n      execution.span.endedAt = cancelled.value.interruptedAtMs\n      execution.span.detail = {\n        ...detail(row, envelope),\n        sequence: execution.span.detail.sequence,\n        input: execution.span.detail.input\n      }\n      continue\n    }\n    if (envelope.eventType === \"flows.engine.run-decision\") {\n      const decision = decodeDecision(envelope.payload)\n      if (Option.isNone(decision)) {\n        const payload = envelope.payload\n        // Claim, owner-fence, wake and child-policy decisions deliberately do\n        // not carry RunState. Keep them visible without losing valid state\n        // evidence; malformed state-bearing decisions still refuse claims.\n        if (\n          typeof payload === \"object\" && payload !== null &&\n          (\"state\" in payload || (\"decision\" in payload && stateDecisions.some((name) => name === payload.decision)))\n        ) {\n          execution.coherent = false\n        }\n        generic()\n        continue\n      }\n      const { state, status } = decision.value\n      if (execution.flowName !== undefined && execution.flowName !== state.flowName) execution.coherent = false\n      execution.flowName = state.flowName\n      execution.span.label = inspectLabel(state.flowName)\n      parent(state.parentExecutionId)\n      execution.result = undefined\n      execution.failure = undefined\n      execution.span.detail = {\n        ...detail(row, envelope),\n        sequence: execution.span.detail.sequence,\n        input: state.payload\n      }\n      if (decision.value.decision === \"created\") execution.span.status = \"pending\"\n      // RunDriver commits this decision with suspended even when its payload\n      // omits status/result (a released host scope can retain no suspension).\n      else if (decision.value.decision === \"interrupt-released\") execution.span.status = \"waiting\"\n      else if (status === \"running\" || status === \"pending\" || status === \"suspended\") {\n        execution.span.status = status === \"suspended\" ? \"waiting\" : status\n      } else if (status !== undefined) {\n        const decodedResult = decodeResult(state.result)\n        if (\n          Option.isSome(decodedResult) && decodedResult.value._tag === \"Handoff\" && status === \"completed\" &&\n          decision.value.decision === \"handed-off\"\n        ) {\n          // A round handed off; its raw result describes the successor, not an output.\n          execution.span.status = \"completed\"\n          execution.span.endedAt = envelope.emittedAtMs\n          continue\n        }\n        if (\n          Option.isNone(decodedResult) || decodedResult.value._tag !== \"Complete\" ||\n          (status === \"completed\") !== (decodedResult.value.exit._tag === \"Success\")\n        ) {\n          execution.coherent = false\n          execution.span.status = \"unknown\"\n          generic()\n          continue\n        }\n        execution.span.status = status\n        execution.span.endedAt = envelope.emittedAtMs\n        execution.span.detail = {\n          ...execution.span.detail,\n          ...(decodedResult.value.exit._tag === \"Success\"\n            ? { output: json(decodedResult.value.exit.value) }\n            : { message: json(decodedResult.value.exit.cause) })\n        }\n        if (decodedResult.value.exit._tag === \"Success\") result(decodedResult.value.exit.value)\n        else failure(\"cause\", decodedResult.value.exit.cause)\n      }\n      continue\n    }\n    generic()\n  }\n  const byExecution = new Map<string, Array<Execution>>()\n  for (const current of executions.values()) {\n    const generations = byExecution.get(current.envelope.executionId) ?? []\n    generations.push(current)\n    byExecution.set(current.envelope.executionId, generations)\n  }\n  const roots: Array<TraceBuilder> = []\n  for (const current of executions.values()) {\n    const parents = current.parentId === undefined ? [] : byExecution.get(current.parentId) ?? []\n    // Build only a forest. Malformed cycles remain separate evidence rows.\n    const ancestors = new Set<string>([current.envelope.executionId])\n    let parent = parents.length === 1 ? parents[0] : undefined\n    let cursor = parent\n    while (cursor !== undefined) {\n      if (ancestors.has(cursor.envelope.executionId)) {\n        parent = undefined\n        break\n      }\n      ancestors.add(cursor.envelope.executionId)\n      const next = cursor.parentId === undefined ? [] : byExecution.get(cursor.parentId) ?? []\n      cursor = next.length === 1 ? next[0] : undefined\n    }\n    if (parent === undefined) roots.push(current.span)\n    else parent.span.children.push(current.span)\n  }\n  const evidence: Array<EngineExecutionEvidence> = [...executions.values()].map((current) => ({\n    executionId: current.envelope.executionId,\n    generation: current.envelope.generation,\n    spanId: current.span.id,\n    parentExecutionId: current.parentExecutionId,\n    parentKnown: current.parentKnown === true,\n    flowName: current.flowName,\n    input: current.span.detail.input,\n    coherent: current.coherent,\n    graph: current.graph,\n    status: current.span.status,\n    waits: [...current.waits?.values() ?? []],\n    result: current.result,\n    failure: current.failure\n  }))\n  return { trace: [...roots, ...notices], evidence }\n}\n\n/**\n * Folds native executions and attempts into trace spans with recorded ancestry.\n *\n * @category utilities\n * @since 1.0.0\n */\nexport const engineTraceFromJournal = (records: ReadonlyArray<JournalRecord>): Array<TraceBuilder> =>\n  foldEngineJournal(records).trace\n\n/**\n * Product claims use these typed facts, never text rendered into trace details.\n *\n * @category utilities\n * @since 1.0.0\n */\nexport const engineExecutionEvidence = (\n  records: ReadonlyArray<JournalRecord>\n): ReadonlyArray<EngineExecutionEvidence> => foldEngineJournal(records).evidence\n\n/**\n * Same recorded native ancestry and historical cursor for every product result projection.\n *\n * @category utilities\n * @since 1.0.0\n */\nexport const engineRunEvidence = (records: ReadonlyArray<JournalRecord>, rootId: string, cursorSeq?: number) => {\n  const visible: ReadonlyArray<JournalRecord> = records\n    .filter((row) =>\n      Number.isSafeInteger(row.sequence) && Number(row.sequence) >= 0 &&\n      (cursorSeq === undefined || Number(row.sequence) <= cursorSeq)\n    )\n    .sort((left, right) => Number(left.sequence) - Number(right.sequence))\n  const executions = engineExecutionEvidence(visible)\n  const generations = new Map<string, Array<EngineExecutionEvidence>>()\n  for (const execution of executions) {\n    const found = generations.get(execution.executionId) ?? []\n    found.push(execution)\n    generations.set(execution.executionId, found)\n  }\n  const current = (execution: EngineExecutionEvidence) =>\n    execution.coherent &&\n    execution.generation === Math.max(...generations.get(execution.executionId)!.map((row) => row.generation))\n  const belongs = (execution: EngineExecutionEvidence, ownerId = rootId): boolean => {\n    const visited = new Set<string>()\n    let candidate: EngineExecutionEvidence = execution\n    while (true) {\n      if (!candidate.coherent || !candidate.parentKnown || visited.has(candidate.executionId)) return false\n      visited.add(candidate.executionId)\n      if (candidate.executionId === ownerId) return ownerId !== rootId || candidate.parentExecutionId === undefined\n      if (candidate.parentExecutionId === undefined) return false\n      const parents: ReadonlyArray<EngineExecutionEvidence> = generations.get(candidate.parentExecutionId) ?? []\n      // A child names a native parent ID, not its generation. Never infer a\n      // parent generation from arrival time after a rewind.\n      if (parents.length !== 1) return false\n      candidate = parents[0]!\n    }\n  }\n  const owned = executions.filter((row) => current(row) && belongs(row))\n  const completed = owned.filter((row) => row.status === \"completed\" && row.result !== undefined)\n  return { executions: owned, completed, belongs }\n}\n"],
+  "mappings": "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",
+  "names": ["detail", "nodes", "node"]
+}

package/dist/cjs/GatewayError.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Typed failures surfaced by the workspace gateway.
+ *
+ * @since 0.1.0
+ */
+import { Schema } from "effect";
+/**
+ * Stable failure codes exposed by gateway operations.
+ *
+ * @since 0.1.0
+ * @category errors
+ */
+export declare const GatewayErrorCode: Schema.Literals<readonly ["bind_failed", "invalid_host", "invalid_origin", "unauthorized", "malformed_request", "request_too_large", "resource_limit", "run_unavailable", "run_not_found"]>;
+/**
+ * A stable gateway failure code.
+ *
+ * @since 0.1.0
+ * @category errors
+ */
+export type GatewayErrorCode = typeof GatewayErrorCode.Type;
+declare const GatewayError_base: Schema.Class<GatewayError, Schema.TaggedStruct<"@smthrs/gateway/GatewayError", {
+    readonly code: Schema.Literals<readonly ["bind_failed", "invalid_host", "invalid_origin", "unauthorized", "malformed_request", "request_too_large", "resource_limit", "run_unavailable", "run_not_found"]>;
+    readonly message: Schema.String;
+    readonly cause: Schema.optional<Schema.Struct<{
+        readonly _tag: Schema.String;
+        readonly code: Schema.optional<Schema.String>;
+    }>>;
+}>, import("effect/Cause").YieldableError>;
+/**
+ * A normalized gateway operation failure.
+ *
+ * @since 0.1.0
+ * @category errors
+ */
+export declare class GatewayError extends GatewayError_base {
+}
+/**
+ * The refusal a numeric setting earns when it is not a positive safe integer,
+ * or `undefined` when the gateway can run under it.
+ *
+ * The keepalive cadence and the request body limit are the same kind of
+ * setting and are checked the same way. A cadence of zero turns the keepalive
+ * into a tight loop and a body limit of zero refuses every request, so a
+ * composition that asks for either is refused before it binds rather than
+ * after it is serving.
+ *
+ * @param name what the value configures, named as the message will read
+ * @param value the configured value, or undefined to accept the default
+ * @since 1.0.0
+ * @category constructors
+ */
+export declare const settingRefusal: (name: string, value: number | undefined) => GatewayError | undefined;
+export {};
+//# sourceMappingURL=GatewayError.d.ts.map

package/dist/cjs/GatewayError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GatewayError.d.ts","sourceRoot":"","sources":["../../src/GatewayError.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,6LAU3B,CAAA;AAEF;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAA;;;;;;;;;AAE3D;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,iBAOhC;CAAG;AAEL;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,EAAE,OAAO,MAAM,GAAG,SAAS,KAAG,YAAY,GAAG,SAMlF,CAAA"}

package/dist/cjs/GatewayError.js

@@ -0,0 +1,51 @@
+"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);
+var GatewayError_exports = {};
+__export(GatewayError_exports, {
+  GatewayError: () => GatewayError,
+  GatewayErrorCode: () => GatewayErrorCode,
+  settingRefusal: () => settingRefusal
+});
+module.exports = __toCommonJS(GatewayError_exports);
+var import_effect = require("effect");
+const GatewayErrorCode = import_effect.Schema.Literals([
+  "bind_failed",
+  "invalid_host",
+  "invalid_origin",
+  "unauthorized",
+  "malformed_request",
+  "request_too_large",
+  "resource_limit",
+  "run_unavailable",
+  "run_not_found"
+]);
+class GatewayError extends import_effect.Schema.TaggedError()("@smthrs/gateway/GatewayError", {
+  code: GatewayErrorCode,
+  message: import_effect.Schema.String,
+  cause: import_effect.Schema.optional(import_effect.Schema.Struct({
+    _tag: import_effect.Schema.String,
+    code: import_effect.Schema.optional(import_effect.Schema.String)
+  }))
+}) {
+}
+const settingRefusal = (name, value) => value === void 0 || Number.isSafeInteger(value) && value > 0 ? void 0 : new GatewayError({
+  code: "bind_failed",
+  message: `${name} must be a positive safe integer, not ${value}`
+});
+//# sourceMappingURL=GatewayError.js.map

package/dist/cjs/GatewayError.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/GatewayError.ts"],
+  "sourcesContent": ["/**\n * Typed failures surfaced by the workspace gateway.\n *\n * @since 0.1.0\n */\n\nimport { Schema } from \"effect\"\n\n/**\n * Stable failure codes exposed by gateway operations.\n *\n * @since 0.1.0\n * @category errors\n */\nexport const GatewayErrorCode = Schema.Literals([\n  \"bind_failed\",\n  \"invalid_host\",\n  \"invalid_origin\",\n  \"unauthorized\",\n  \"malformed_request\",\n  \"request_too_large\",\n  \"resource_limit\",\n  \"run_unavailable\",\n  \"run_not_found\"\n])\n\n/**\n * A stable gateway failure code.\n *\n * @since 0.1.0\n * @category errors\n */\nexport type GatewayErrorCode = typeof GatewayErrorCode.Type\n\n/**\n * A normalized gateway operation failure.\n *\n * @since 0.1.0\n * @category errors\n */\nexport class GatewayError extends Schema.TaggedError<GatewayError>()(\"@smthrs/gateway/GatewayError\", {\n  code: GatewayErrorCode,\n  message: Schema.String,\n  cause: Schema.optional(Schema.Struct({\n    _tag: Schema.String,\n    code: Schema.optional(Schema.String)\n  }))\n}) {}\n\n/**\n * The refusal a numeric setting earns when it is not a positive safe integer,\n * or `undefined` when the gateway can run under it.\n *\n * The keepalive cadence and the request body limit are the same kind of\n * setting and are checked the same way. A cadence of zero turns the keepalive\n * into a tight loop and a body limit of zero refuses every request, so a\n * composition that asks for either is refused before it binds rather than\n * after it is serving.\n *\n * @param name what the value configures, named as the message will read\n * @param value the configured value, or undefined to accept the default\n * @since 1.0.0\n * @category constructors\n */\nexport const settingRefusal = (name: string, value: number | undefined): GatewayError | undefined =>\n  value === undefined || (Number.isSafeInteger(value) && value > 0)\n    ? undefined\n    : new GatewayError({\n      code: \"bind_failed\",\n      message: `${name} must be a positive safe integer, not ${value}`\n    })\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,oBAAuB;AAQhB,MAAM,mBAAmB,qBAAO,SAAS;AAAA,EAC9C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAgBM,MAAM,qBAAqB,qBAAO,YAA0B,EAAE,gCAAgC;AAAA,EACnG,MAAM;AAAA,EACN,SAAS,qBAAO;AAAA,EAChB,OAAO,qBAAO,SAAS,qBAAO,OAAO;AAAA,IACnC,MAAM,qBAAO;AAAA,IACb,MAAM,qBAAO,SAAS,qBAAO,MAAM;AAAA,EACrC,CAAC,CAAC;AACJ,CAAC,EAAE;AAAC;AAiBG,MAAM,iBAAiB,CAAC,MAAc,UAC3C,UAAU,UAAc,OAAO,cAAc,KAAK,KAAK,QAAQ,IAC3D,SACA,IAAI,aAAa;AAAA,EACjB,MAAM;AAAA,EACN,SAAS,GAAG,IAAI,yCAAyC,KAAK;AAChE,CAAC;",
+  "names": []
+}