Allocate the next seq for this run. Cache-backed: O(1) after first use.

Apply NFC normalization. Caller has already run `validate_relative`, which rejects `//` so no slash-collapsing is needed.

* Parse timestamp, treating as UTC if no timezone specified. * This handles the case where PostgreSQL returns timestamps without explicit timezone.

Parse stdin content as a typed [`StructuredOutput`] payload. Validates against the schema at parse time: required fields (headline, status) must be p

Random slug fallback for `POST /api/traces` when no id is supplied: `rcp-<16 hex>`. Hyphen (not underscore) so the result satisfies the slug regex in

Read all of stdin into a string. Used by the CLI to pick up the structured-output payload piped in by the caller.

Render a minimal valid JSON example for the schema. Always ends with a newline so the output is line-clean when piped to a file or another command.

Render the raw JSON Schema for this target, pretty-printed. The schema is emitted as a `RootSchema`-equivalent: the target's `SchemaObject` becomes t

kubectl-style plaintext rendering.

Resolve `(commit_sha, committed_files)` for the run-detail response. Cache hits on `?at=` skip spawn_blocking entirely; everything else runs in a sing

Build the root JsonSchema for `reply` / `state` / `trace` / `run_detail`.

For a scope-relative path like `dream-analysis/runs/<id>/foo/x.png`, find the trace root that owns it. Returns (trace_root, path_relative_to_root).

Resolve `<scope-rel-path>` against scope roots → find the trace folder that owns it → ask libgit2 for the bytes at that commit. Sets `ETag: <blob_oid

Return the bytes of `rel_path` as it existed at commit `sha`. Errors if the commit or path does not exist in that tree.

Spawn the SSE keepalive heartbeat (every 15s). Without this the reverse-proxy may close the connection on idle.

Split `reply.evidence.figure` into (`reply`, `["evidence", "figure"]`). Errors with a hint if the root is unknown.

Descend one path segment. Handles: - object properties (`reply.headline`) - array elements as transparent (`evidence.figure` resolves directly to the

Strip YAML front-matter and parse a few useful fields (reads/writes/display_name).

Remove CDN/proxy injections (Cloudflare Rocket Loader, etc.).

Same as `tagged_variant_value` but returns the property *name* (e.g. `type`, `kind`) — the JSON key that holds the discriminator. Used so the variant

Unwrap nested {input: ...} wrappers.

Transparently unwrap one layer of container indirection (array → items, map → additionalProperties). Returns the element schema if a container, else r

Update the in-process seq cache after a collision: pick `max(observed + 1, cached + 1)`.

Validate a run-relative path. Returns the first reason it's not acceptable, or `Ok(())` if it can be stored as-is (after normalize).