deepline 0.1.227 → 0.1.229

package/dist/bundling-sources/shared_libs/play-runtime/child-run-id.ts

@@ -1,121 +0,0 @@
-import { sha256Hex, stableStringify } from '../plays/row-identity';
-
-/**
- * Canonical derivation of a `ctx.runPlay(...)` child run id.
- *
- * Both substrates that launch child runs derive the id here so a child's
- * durable run id is stable across replays and shared code:
- *
- *   - workers_edge: the coordinator (`apps/play-runner-workers`) derives the id
- *     from the durable child idempotency key it receives from the parent's
- *     runtime (`explicitIdempotencyKey`). Submit retries carry the same key, so
- *     the retry attaches to the same child run row.
- *   - in-process shared runtime (`context.ts`): there is no coordinator hop and
- *     no per-child idempotency key, so the id is derived from the semantic
- *     fallback (parent lineage + call key + input).
- *
- * The FORMAT (`play/<slug>/run/child-<digest>`) and the derivation CODE are
- * identical on both sides. The DIGEST INPUTS differ by substrate on purpose:
- *
- *   - `explicitIdempotencyKey` is only present on workers_edge (the coordinator
- *     path). When present it fully determines the digest; the other fields are
- *     ignored (they already fed the idempotency key upstream).
- *   - `graphHash` is only known on workers_edge (the compiled child manifest is
- *     threaded through the coordinator). In-process has no per-child manifest,
- *     so it passes `null`.
- *
- * Do NOT reorder or drop digest fields without accounting for coordinator
- * child-submit idempotency: two calls that must attach to the same child run
- * MUST produce the same id, byte-for-byte.
- */
-export interface ChildRunIdInputs {
-  /** Name of the child play being launched (`ctx.runPlay` target). */
-  childPlayName: string;
-  /** Run id of the parent making the `ctx.runPlay` call. */
-  parentRunId: string;
-  /**
-   * Durable child idempotency key when the launching substrate has one
-   * (workers_edge coordinator path). When set, it alone determines the digest.
-   */
-  explicitIdempotencyKey?: string | null;
-  /** Play name of the parent making the call (semantic-fallback input). */
-  parentPlayName?: string | null;
-  /** `ctx.runPlay(key, ...)` call key (semantic-fallback input). */
-  key?: string | null;
-  /**
-   * Canonical durable runPlay semantic key when the launching substrate has one.
-   * This scopes each fresh child invocation to its parent call site and row.
-   */
-  runPlaySemanticKey?: string | null;
-  /** Child input payload (semantic-fallback input). */
-  input?: unknown;
-  /**
-   * Compiled child graph hash. Only present on workers_edge; `null` in-process.
-   */
-  graphHash?: string | null;
-}
-
-/**
- * A failed child launch must use a fresh attempt identity while ordinary
- * transport retries keep attaching to the original child. The caller-provided
- * lease is the attempt fence.
- */
-export function childSubmitIdempotencyKey(input: {
-  receiptKey: string;
-  wasFailed: boolean;
-  leaseId?: string | null;
-}): string {
-  const leaseId = input.leaseId?.trim();
-  return input.wasFailed && leaseId
-    ? `${input.receiptKey}:claim:${leaseId}`
-    : input.receiptKey;
-}
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-
-/** Slugify a play name into the `play/<slug>/...` path segment. */
-export function slugifyPlayNameForRunId(playName: string): string {
-  return (
-    playName
-      .toLowerCase()
-      .replace(/[^a-z0-9-]/g, '-')
-      .replace(/-+/g, '-')
-      .replace(/^-+|-+$/g, '')
-      .slice(0, 64) || 'play'
-  );
-}
-
-export function buildChildRunId(inputs: ChildRunIdInputs): string {
-  const slug = slugifyPlayNameForRunId(inputs.childPlayName);
-  const explicitKey =
-    typeof inputs.explicitIdempotencyKey === 'string' &&
-    inputs.explicitIdempotencyKey.trim()
-      ? inputs.explicitIdempotencyKey.trim()
-      : null;
-  const runPlaySemanticKey =
-    typeof inputs.runPlaySemanticKey === 'string' &&
-    inputs.runPlaySemanticKey.trim()
-      ? inputs.runPlaySemanticKey.trim()
-      : null;
-  const semanticKey =
-    explicitKey ??
-    stableStringify({
-      parentRunId: inputs.parentRunId,
-      parentPlayName:
-        typeof inputs.parentPlayName === 'string'
-          ? inputs.parentPlayName
-          : null,
-      childPlayName: inputs.childPlayName,
-      key: typeof inputs.key === 'string' ? inputs.key : null,
-      ...(runPlaySemanticKey ? { runPlaySemanticKey } : {}),
-      input:
-        isRecord(inputs.input) || Array.isArray(inputs.input)
-          ? inputs.input
-          : {},
-      graphHash: typeof inputs.graphHash === 'string' ? inputs.graphHash : null,
-    });
-  const digest = sha256Hex(semanticKey).slice(0, 24);
-  return `play/${slug}/run/child-${digest}`;
-}