usesteady 0.1.0-alpha.1

package/dist/src/ucp/envelope.js

@@ -0,0 +1,241 @@
+/**
+ * UCP envelope factory.
+ *
+ * ?? Identity contract ?????????????????????????????????????????????????????????
+ *
+ *   id   = sha256({ type, payload, refs })
+ *          Content-addressed: same content ? same id.
+ *          Does NOT include ts ? never changes when only ts changes.
+ *
+ *   hash = sha256({ id, meta, payload, refs, type, version })
+ *          Integrity hash covering all fields except ts (mutable) and hash itself.
+ *          ts is excluded so the hash is stable regardless of wall-clock time.
+ *
+ * ?? Determinism guarantee ?????????????????????????????????????????????????????
+ *
+ *   Two calls to createEnvelope() with identical type, payload, source, and refs
+ *   will produce envelopes with the SAME id and SAME hash.
+ *   They will differ only in ts (timestamp).
+ *
+ * ?? No randomness ?????????????????????????????????????????????????????????????
+ *
+ *   createEnvelope does NOT use randomUUID or any non-deterministic input.
+ *   id is fully determined by content.
+ */
+import { hashObject } from "./hashes.js";
+// ??? Core factory ??????????????????????????????????????????????????????????????
+/**
+ * Create a UCPEnvelope from its constituent parts.
+ *
+ * @param type    Dot-notation type string, e.g. "ucp.intent.v1".
+ * @param payload The structured payload. Must map EXACTLY from the source type.
+ * @param source  The module name that produced this envelope (e.g. "completion").
+ * @param refs    Optional parent/root envelope references.
+ */
+export function createEnvelope(type, payload, source, refs) {
+    const meta = { source, deterministic: true };
+    // id: content-addressed. Same type + payload + refs ? same id.
+    // ts is intentionally excluded.
+    const idInput = refs !== undefined
+        ? { payload, refs, type }
+        : { payload, type };
+    const id = hashObject(idInput);
+    // hash: integrity over all stable fields. ts excluded.
+    const hashInput = refs !== undefined
+        ? { id, meta, payload, refs, type, version: 1 }
+        : { id, meta, payload, type, version: 1 };
+    const hash = hashObject(hashInput);
+    return {
+        id,
+        type,
+        version: 1,
+        ts: Date.now(),
+        payload,
+        meta,
+        ...(refs !== undefined ? { refs } : {}),
+        hash,
+    };
+}
+// ??? Typed factory helpers ????????????????????????????????????????????????????
+export function createIntentEnvelope(payload, refs) {
+    return createEnvelope("ucp.intent.v1", payload, "intake", refs);
+}
+export function createPRVEnvelope(payload, refs) {
+    return createEnvelope("ucp.prv.v1", payload, "prv", refs);
+}
+export function createSafetyEnvelope(payload, refs) {
+    return createEnvelope("ucp.safety.v1", payload, "safety", refs);
+}
+export function createContextAlignmentEnvelope(payload, refs) {
+    return createEnvelope("ucp.context.v1", payload, "context", refs);
+}
+export function createDisambiguationEnvelope(payload, refs) {
+    return createEnvelope("ucp.disambiguation.v1", payload, "disambiguation", refs);
+}
+export function createCompletionEnvelope(payload, refs) {
+    return createEnvelope("ucp.completion.v1", payload, "completion", refs);
+}
+export function createIntentInterpretationEnvelope(payload, refs) {
+    return createEnvelope("ucp.intent_interpretation.v1", payload, "intent_interpretation", refs);
+}
+export function createChangeInterpretationEnvelope(payload, refs) {
+    return createEnvelope("ucp.change_interpretation.v1", payload, "change_interpretation", refs);
+}
+export function createResponseEnvelope(payload, refs) {
+    return createEnvelope("ucp.response.v1", payload, "response_planner", refs);
+}
+export function createInteractionContractEnvelope(payload, refs) {
+    return createEnvelope("ucp.interaction_contract.v1", payload, "interaction", refs);
+}
+export function createInteractionEventEnvelope(payload, refs) {
+    return createEnvelope("ucp.interaction_event.v1", payload, "interaction", refs);
+}
+export function createDebugTraceEnvelope(payload, refs) {
+    return createEnvelope("ucp.debug_trace.v1", payload, "intake", refs);
+}
+// ??? Phase 3: post-execution envelope factories ???????????????????????????????
+/**
+ * Create an artifact envelope from a finalized run record.
+ *
+ * source = "artifact_finalizer" ? the component that calls finalizeArtifact().
+ * refs.rootId = intentId (ucp.intent.v1 ID) when available ? closes the provenance chain.
+ * refs.parentId = response envelope ID when available.
+ */
+export function createArtifactEnvelope(payload, refs) {
+    return createEnvelope("ucp.artifact.v1", payload, "artifact_finalizer", refs);
+}
+/**
+ * Create an execution trace envelope ? the sealed batch record of a run's timeline.
+ *
+ * source = "artifact_finalizer" ? emitted at the same point as the artifact envelope.
+ * refs.parentId = artifact envelope ID (immediate causal predecessor).
+ * refs.rootId   = intentId (propagated from artifact envelope).
+ */
+export function createExecutionTraceEnvelope(payload, refs) {
+    return createEnvelope("ucp.execution_trace.v1", payload, "artifact_finalizer", refs);
+}
+/**
+ * Create a replay report envelope ? the canonical record of a verification outcome.
+ *
+ * source = "replay_engine" ? the component that calls verifyArtifact().
+ * refs.parentId = artifact envelope ID (the artifact that was verified).
+ * refs.rootId   = intentId (propagated from artifact envelope, when available).
+ *
+ * NOTE: replay is a statement about an artifact, not an independent truth.
+ * The parentId link is the formal expression of that relationship.
+ */
+export function createReplayReportEnvelope(payload, refs) {
+    return createEnvelope("ucp.replay_report.v1", payload, "replay_engine", refs);
+}
+// ??? Phase 8: Cursor integration envelope factories ??????????????????????????
+/**
+ * Create a cursor handoff envelope ? persisted by the delivery gate BEFORE
+ * the artifact is passed to Cursor. Hard gate: if this fails, delivery is blocked.
+ *
+ * source = "cursor_delivery_gate"
+ * refs.parentId = response envelope ID (ucp.response.v1)
+ * refs.rootId   = intent envelope ID (ucp.intent.v1)
+ *
+ * Chain position: ucp.response.v1 ? ucp.cursor_handoff.v1
+ */
+export function createCursorHandoffEnvelope(payload, refs) {
+    return createEnvelope("ucp.cursor_handoff.v1", payload, "cursor_delivery_gate", refs);
+}
+/**
+ * Create a cursor receipt envelope ? persisted AFTER Cursor returns "accepted".
+ * Records that Cursor took ownership of the artifact.
+ *
+ * source = "cursor_delivery_gate"
+ * refs.parentId = cursor handoff envelope ID (ucp.cursor_handoff.v1)
+ * refs.rootId   = intent envelope ID (ucp.intent.v1)
+ *
+ * Chain position: ucp.cursor_handoff.v1 ? ucp.cursor_receipt.v1
+ *   ? [ucp.cursor_artifact.v1 ? RESERVED FUTURE SLOT]
+ *     ? ucp.execution_trace.v1
+ */
+export function createCursorReceiptEnvelope(payload, refs) {
+    return createEnvelope("ucp.cursor_receipt.v1", payload, "cursor_delivery_gate", refs);
+}
+/**
+ * Create a cursor refused envelope ? persisted when Cursor returns either
+ * refused_due_to_scope or refused_due_to_execution_error.
+ *
+ * source = "cursor_delivery_gate"
+ * refs.parentId = cursor handoff envelope ID (ucp.cursor_handoff.v1)
+ * refs.rootId   = intent envelope ID (ucp.intent.v1)
+ *
+ * Chain position: ucp.cursor_handoff.v1 ? ucp.cursor_refused.v1 (dead end or retry trigger)
+ */
+export function createCursorRefusedEnvelope(payload, refs) {
+    return createEnvelope("ucp.cursor_refused.v1", payload, "cursor_delivery_gate", refs);
+}
+// ??? Phase 8B: Claude Managed Agents envelope factories ??????????????????????
+/**
+ * Create a Claude handoff envelope ? persisted by the delivery gate BEFORE
+ * the artifact is passed to Claude Managed Agents. Hard gate: if this fails,
+ * delivery is blocked.
+ *
+ * source = "claude_delivery_gate"
+ * refs.parentId = response envelope ID (ucp.response.v1)
+ * refs.rootId   = intent envelope ID (ucp.intent.v1)
+ *
+ * Chain position: ucp.response.v1 ? ucp.claude_handoff.v1
+ */
+export function createClaudeHandoffEnvelope(payload, refs) {
+    return createEnvelope("ucp.claude_handoff.v1", payload, "claude_delivery_gate", refs);
+}
+/**
+ * Create a Claude receipt envelope ? persisted AFTER Claude accepts the task.
+ * Records that Claude started a managed agent session.
+ *
+ * source = "claude_delivery_gate"
+ * refs.parentId = claude handoff envelope ID (ucp.claude_handoff.v1)
+ * refs.rootId   = intent envelope ID (ucp.intent.v1)
+ *
+ * Chain position: ucp.claude_handoff.v1 ? ucp.claude_receipt.v1
+ */
+export function createClaudeReceiptEnvelope(payload, refs) {
+    return createEnvelope("ucp.claude_receipt.v1", payload, "claude_delivery_gate", refs);
+}
+/**
+ * Create a Claude refused envelope ? persisted when Claude responds with
+ * refused_due_to_scope or refused_due_to_execution_error.
+ *
+ * source = "claude_delivery_gate"
+ * refs.parentId = claude handoff envelope ID (ucp.claude_handoff.v1)
+ * refs.rootId   = intent envelope ID (ucp.intent.v1)
+ *
+ * Chain position: ucp.claude_handoff.v1 ? ucp.claude_refused.v1 (dead end or retry trigger)
+ */
+export function createClaudeRefusedEnvelope(payload, refs) {
+    return createEnvelope("ucp.claude_refused.v1", payload, "claude_delivery_gate", refs);
+}
+// ??? Phase 6: reminder execution envelope factory ????????????????????????????
+/**
+ * Create a reminder execution envelope from a finalized execution artifact.
+ *
+ * source = "reminder_executor" ? the reminder execution layer.
+ * refs.parentId = response envelope ID (the intake decision that led to this).
+ * refs.rootId   = intent envelope ID (the originating user intent).
+ *
+ * Both refs are optional in this slice ? they will be wired when the execution
+ * layer is integrated into the full intake?present?execute pipeline.
+ */
+export function createReminderExecutionEnvelope(payload, refs) {
+    return createEnvelope("ucp.reminder_execution.v1", payload, "reminder_executor", refs);
+}
+// ??? Phase 9F: workflow run envelope factory ??????????????????????????????????
+/**
+ * Create a workflow run envelope ? the terminal provenance record for one
+ * complete workflow run. Persisted ONLY when the run reaches "completed" or
+ * "stopped" (W5). Never written for in-progress runs.
+ *
+ * source = "workflow_coordinator"
+ *
+ * refs are optional because the workflow spans multiple sessions.
+ * Individual session chains are recoverable through sessionRefs entries.
+ */
+export function createWorkflowRunEnvelope(payload, refs) {
+    return createEnvelope("ucp.workflow_run.v1", payload, "workflow_coordinator", refs);
+}
+//# sourceMappingURL=envelope.js.map

package/dist/src/ucp/envelope.js.map

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

package/dist/src/ucp/hashes.d.ts

@@ -0,0 +1,36 @@
+/**
+ * UCP hashing — deterministic SHA-256 over canonically serialized objects.
+ *
+ * Rules:
+ *   - Object keys are sorted alphabetically at every level of nesting.
+ *   - Arrays preserve element order.
+ *   - The hash covers all fields provided; callers must omit `hash` before hashing.
+ *   - Uses Node's built-in crypto — no external deps.
+ *
+ * ── CRITICAL: undefined is NOT omitted ────────────────────────────────────────
+ *
+ *   stableStringify serializes `undefined` values as the string "undefined":
+ *
+ *     stableStringify({ a: undefined })  →  '{"a":"undefined"}'
+ *     stableStringify({})                →  '{}'
+ *
+ *   This differs from JSON.stringify, which silently drops keys with undefined
+ *   values. The consequence for content addressing:
+ *
+ *     computeId({ rejection_reason: undefined })  ≠  computeId({})
+ *
+ *   If a payload object with explicit undefined keys is passed to computeId,
+ *   and the same payload is later serialized to disk via JSON.stringify (which
+ *   strips undefined), the on-disk record will NOT reproduce the same id — the
+ *   content-addressing guarantee is broken.
+ *
+ *   Protocol rule: ALL payload objects passed to computeId (and therefore to
+ *   createEnvelope) MUST be undefined-free. Optional fields must be omitted
+ *   entirely when absent — never set to undefined.
+ *
+ *   See: src/ucp/types.ts — "PROTOCOL INVARIANT: Payloads must be undefined-free"
+ */
+export declare function stableStringify(value: unknown): string;
+export declare function sha256(input: string): string;
+export declare function hashObject(obj: unknown): string;
+//# sourceMappingURL=hashes.d.ts.map

package/dist/src/ucp/hashes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashes.d.ts","sourceRoot":"","sources":["../../../src/ucp/hashes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAMH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAkBtD;AAID,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5C;AAID,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAE/C"}

package/dist/src/ucp/hashes.js

@@ -0,0 +1,59 @@
+/**
+ * UCP hashing — deterministic SHA-256 over canonically serialized objects.
+ *
+ * Rules:
+ *   - Object keys are sorted alphabetically at every level of nesting.
+ *   - Arrays preserve element order.
+ *   - The hash covers all fields provided; callers must omit `hash` before hashing.
+ *   - Uses Node's built-in crypto — no external deps.
+ *
+ * ── CRITICAL: undefined is NOT omitted ────────────────────────────────────────
+ *
+ *   stableStringify serializes `undefined` values as the string "undefined":
+ *
+ *     stableStringify({ a: undefined })  →  '{"a":"undefined"}'
+ *     stableStringify({})                →  '{}'
+ *
+ *   This differs from JSON.stringify, which silently drops keys with undefined
+ *   values. The consequence for content addressing:
+ *
+ *     computeId({ rejection_reason: undefined })  ≠  computeId({})
+ *
+ *   If a payload object with explicit undefined keys is passed to computeId,
+ *   and the same payload is later serialized to disk via JSON.stringify (which
+ *   strips undefined), the on-disk record will NOT reproduce the same id — the
+ *   content-addressing guarantee is broken.
+ *
+ *   Protocol rule: ALL payload objects passed to computeId (and therefore to
+ *   createEnvelope) MUST be undefined-free. Optional fields must be omitted
+ *   entirely when absent — never set to undefined.
+ *
+ *   See: src/ucp/types.ts — "PROTOCOL INVARIANT: Payloads must be undefined-free"
+ */
+import { createHash } from "node:crypto";
+// ─── Stable serialization ─────────────────────────────────────────────────────
+export function stableStringify(value) {
+    if (value === null)
+        return "null";
+    if (value === undefined)
+        return "undefined";
+    if (typeof value !== "object") {
+        return JSON.stringify(value);
+    }
+    if (Array.isArray(value)) {
+        return "[" + value.map(stableStringify).join(",") + "]";
+    }
+    const obj = value;
+    const sortedKeys = Object.keys(obj).sort();
+    const pairs = sortedKeys.map((k) => JSON.stringify(k) + ":" + stableStringify(obj[k]));
+    return "{" + pairs.join(",") + "}";
+}
+// ─── SHA-256 helper ───────────────────────────────────────────────────────────
+export function sha256(input) {
+    return createHash("sha256").update(input, "utf8").digest("hex");
+}
+// ─── Canonical hash for any serializable object ───────────────────────────────
+export function hashObject(obj) {
+    return sha256(stableStringify(obj));
+}
+//# sourceMappingURL=hashes.js.map

package/dist/src/ucp/hashes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashes.js","sourceRoot":"","sources":["../../../src/ucp/hashes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,iFAAiF;AAEjF,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAClC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC;IAE5C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IAC1D,CAAC;IAED,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAC1B,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CACzD,CAAC;IACF,OAAO,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;AACrC,CAAC;AAED,iFAAiF;AAEjF,MAAM,UAAU,MAAM,CAAC,KAAa;IAClC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC;AAED,iFAAiF;AAEjF,MAAM,UAAU,UAAU,CAAC,GAAY;IACrC,OAAO,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;AACtC,CAAC"}

package/dist/src/ucp/mappers/map-artifact.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Mapper: ArtifactLike → ArtifactEnvelope.
+ *
+ * Maps from a finalized run artifact to its canonical UCP envelope.
+ * This mapper is intentionally defined against a minimal structural type
+ * (ArtifactLike) rather than importing any branded FinalizedArtifact —
+ * avoiding circular dependencies while remaining fully type-safe via
+ * TypeScript's structural compatibility.
+ *
+ * ── Mapping rules (field-for-field) ──────────────────────────────────────────
+ *
+ *   runId         ← artifact.runId                     (direct copy)
+ *   goal          ← artifact.goal                      (direct copy)
+ *   status        ← artifact.status                    (direct copy)
+ *   checksum      ← artifact.checksum                  (direct copy — NEVER recomputed)
+ *   graphChecksum ← artifact.graph.checksum             (direct copy)
+ *   nodeCount     ← artifact.nodes.length              (count only)
+ *   startedAtMs   ← artifact.startedAtMs               (direct copy)
+ *   completedAtMs ← artifact.completedAtMs             (direct copy)
+ *
+ * ── What this mapper does NOT do ─────────────────────────────────────────────
+ *
+ *   ✗ Recompute artifact checksum
+ *   ✗ Copy nodes[], trace[], lineage, or explainSummary
+ *   ✗ Interpret or reinterpret any field
+ *   ✗ Add renderer-facing concerns
+ */
+import type { ArtifactEnvelope, UCPRefs } from "../types.js";
+/**
+ * Minimal structural type matching the relevant fields of FinalizedArtifact.
+ * No branded import needed — TypeScript structural typing ensures compatibility.
+ */
+export type ArtifactLike = {
+    readonly runId: string;
+    readonly goal: string;
+    readonly status: "COMPLETED" | "FAILED" | "DENIED";
+    /** SHA-256 of the sealed artifact — copied as-is, never recomputed. */
+    readonly checksum: string;
+    readonly graph: {
+        readonly checksum: string;
+    };
+    /** Only .length is accessed — the full node list is not mapped. */
+    readonly nodes: readonly unknown[];
+    readonly startedAtMs: number;
+    readonly completedAtMs: number;
+};
+/**
+ * Map a finalized artifact to its canonical UCP envelope.
+ *
+ * Pure function — same artifact → same envelope id (content-addressed).
+ *
+ * @param artifact  The finalized run artifact (must satisfy ArtifactLike shape)
+ * @param refs      Optional provenance refs:
+ *                    refs.rootId   = ucp.intent.v1 ID (closes provenance chain)
+ *                    refs.parentId = ucp.response.v1 ID (immediate predecessor)
+ */
+export declare function mapArtifactToEnvelope(artifact: ArtifactLike, refs?: UCPRefs): ArtifactEnvelope;
+//# sourceMappingURL=map-artifact.d.ts.map

package/dist/src/ucp/mappers/map-artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-artifact.d.ts","sourceRoot":"","sources":["../../../../src/ucp/mappers/map-artifact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE7D;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,KAAK,EAAU,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAW,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAS,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC1D,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAO,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAU;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAU,SAAS,OAAO,EAAE,CAAC;IAC3C,QAAQ,CAAC,WAAW,EAAI,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,YAAY,EACtB,IAAI,CAAC,EAAE,OAAO,GACb,gBAAgB,CAclB"}

package/dist/src/ucp/mappers/map-artifact.js

@@ -0,0 +1,51 @@
+/**
+ * Mapper: ArtifactLike → ArtifactEnvelope.
+ *
+ * Maps from a finalized run artifact to its canonical UCP envelope.
+ * This mapper is intentionally defined against a minimal structural type
+ * (ArtifactLike) rather than importing any branded FinalizedArtifact —
+ * avoiding circular dependencies while remaining fully type-safe via
+ * TypeScript's structural compatibility.
+ *
+ * ── Mapping rules (field-for-field) ──────────────────────────────────────────
+ *
+ *   runId         ← artifact.runId                     (direct copy)
+ *   goal          ← artifact.goal                      (direct copy)
+ *   status        ← artifact.status                    (direct copy)
+ *   checksum      ← artifact.checksum                  (direct copy — NEVER recomputed)
+ *   graphChecksum ← artifact.graph.checksum             (direct copy)
+ *   nodeCount     ← artifact.nodes.length              (count only)
+ *   startedAtMs   ← artifact.startedAtMs               (direct copy)
+ *   completedAtMs ← artifact.completedAtMs             (direct copy)
+ *
+ * ── What this mapper does NOT do ─────────────────────────────────────────────
+ *
+ *   ✗ Recompute artifact checksum
+ *   ✗ Copy nodes[], trace[], lineage, or explainSummary
+ *   ✗ Interpret or reinterpret any field
+ *   ✗ Add renderer-facing concerns
+ */
+import { createArtifactEnvelope } from "../envelope.js";
+/**
+ * Map a finalized artifact to its canonical UCP envelope.
+ *
+ * Pure function — same artifact → same envelope id (content-addressed).
+ *
+ * @param artifact  The finalized run artifact (must satisfy ArtifactLike shape)
+ * @param refs      Optional provenance refs:
+ *                    refs.rootId   = ucp.intent.v1 ID (closes provenance chain)
+ *                    refs.parentId = ucp.response.v1 ID (immediate predecessor)
+ */
+export function mapArtifactToEnvelope(artifact, refs) {
+    return createArtifactEnvelope({
+        runId: artifact.runId,
+        goal: artifact.goal,
+        status: artifact.status,
+        checksum: artifact.checksum, // copied — NEVER recomputed
+        graphChecksum: artifact.graph.checksum,
+        nodeCount: artifact.nodes.length,
+        startedAtMs: artifact.startedAtMs,
+        completedAtMs: artifact.completedAtMs,
+    }, refs);
+}
+//# sourceMappingURL=map-artifact.js.map

package/dist/src/ucp/mappers/map-artifact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-artifact.js","sourceRoot":"","sources":["../../../../src/ucp/mappers/map-artifact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAoBxD;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAsB,EACtB,IAAc;IAEd,OAAO,sBAAsB,CAC3B;QACE,KAAK,EAAU,QAAQ,CAAC,KAAK;QAC7B,IAAI,EAAW,QAAQ,CAAC,IAAI;QAC5B,MAAM,EAAS,QAAQ,CAAC,MAAM;QAC9B,QAAQ,EAAO,QAAQ,CAAC,QAAQ,EAAM,4BAA4B;QAClE,aAAa,EAAE,QAAQ,CAAC,KAAK,CAAC,QAAQ;QACtC,SAAS,EAAM,QAAQ,CAAC,KAAK,CAAC,MAAM;QACpC,WAAW,EAAI,QAAQ,CAAC,WAAW;QACnC,aAAa,EAAE,QAAQ,CAAC,aAAa;KACtC,EACD,IAAI,CACL,CAAC;AACJ,CAAC"}

package/dist/src/ucp/mappers/map-change-interpretation.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Mapper: InterpretationResult → ChangeInterpretationEnvelope.
+ *
+ * Maps exactly from InterpretationResult
+ * (src/understand/interpretation/types.ts).
+ * Only produced when mode === "execute" and the input matched a structured
+ * change pattern.
+ */
+import type { ChangeInterpretationEnvelope, UCPRefs } from "../types.js";
+import type { InterpretationResult } from "../../understand/interpretation/types.js";
+export declare function mapChangeInterpretationToEnvelope(result: InterpretationResult, refs?: UCPRefs): ChangeInterpretationEnvelope;
+//# sourceMappingURL=map-change-interpretation.d.ts.map

package/dist/src/ucp/mappers/map-change-interpretation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-change-interpretation.d.ts","sourceRoot":"","sources":["../../../../src/ucp/mappers/map-change-interpretation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,4BAA4B,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAErF,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,oBAAoB,EAC5B,IAAI,CAAC,EAAE,OAAO,GACb,4BAA4B,CAU9B"}

package/dist/src/ucp/mappers/map-change-interpretation.js

@@ -0,0 +1,18 @@
+/**
+ * Mapper: InterpretationResult → ChangeInterpretationEnvelope.
+ *
+ * Maps exactly from InterpretationResult
+ * (src/understand/interpretation/types.ts).
+ * Only produced when mode === "execute" and the input matched a structured
+ * change pattern.
+ */
+import { createChangeInterpretationEnvelope } from "../envelope.js";
+export function mapChangeInterpretationToEnvelope(result, refs) {
+    return createChangeInterpretationEnvelope({
+        summary: result.summary,
+        impact: result.impact,
+        confidence: result.confidence,
+        category: result.category,
+    }, refs);
+}
+//# sourceMappingURL=map-change-interpretation.js.map

package/dist/src/ucp/mappers/map-change-interpretation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-change-interpretation.js","sourceRoot":"","sources":["../../../../src/ucp/mappers/map-change-interpretation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,kCAAkC,EAAE,MAAM,gBAAgB,CAAC;AAIpE,MAAM,UAAU,iCAAiC,CAC/C,MAA4B,EAC5B,IAAc;IAEd,OAAO,kCAAkC,CACvC;QACE,OAAO,EAAK,MAAM,CAAC,OAAO;QAC1B,MAAM,EAAM,MAAM,CAAC,MAAM;QACzB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,QAAQ,EAAI,MAAM,CAAC,QAAQ;KAC5B,EACD,IAAI,CACL,CAAC;AACJ,CAAC"}

package/dist/src/ucp/mappers/map-completion.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Mapper: CompletionResult → CompletionEnvelope.
+ *
+ * Maps exactly from CompletionResult (src/understand/completion/types.ts).
+ * Covers all three completion kinds: complete, incomplete, guided_recovery.
+ */
+import type { CompletionEnvelope, UCPRefs } from "../types.js";
+import type { CompletionResult } from "../../understand/completion/types.js";
+export declare function mapCompletionToEnvelope(result: CompletionResult, refs?: UCPRefs): CompletionEnvelope;
+//# sourceMappingURL=map-completion.d.ts.map

package/dist/src/ucp/mappers/map-completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-completion.d.ts","sourceRoot":"","sources":["../../../../src/ucp/mappers/map-completion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAqB,OAAO,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAE7E,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,gBAAgB,EACxB,IAAI,CAAC,EAAE,OAAO,GACb,kBAAkB,CAgBpB"}

package/dist/src/ucp/mappers/map-completion.js

@@ -0,0 +1,24 @@
+/**
+ * Mapper: CompletionResult → CompletionEnvelope.
+ *
+ * Maps exactly from CompletionResult (src/understand/completion/types.ts).
+ * Covers all three completion kinds: complete, incomplete, guided_recovery.
+ */
+import { createCompletionEnvelope } from "../envelope.js";
+export function mapCompletionToEnvelope(result, refs) {
+    let payload;
+    if (result.kind === "complete") {
+        payload = { kind: "complete" };
+    }
+    else {
+        // incomplete or guided_recovery — both carry reason, missing, nextSteps
+        payload = {
+            kind: result.kind,
+            reason: result.reason,
+            missing: result.missing,
+            nextSteps: result.nextSteps,
+        };
+    }
+    return createCompletionEnvelope(payload, refs);
+}
+//# sourceMappingURL=map-completion.js.map

package/dist/src/ucp/mappers/map-completion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-completion.js","sourceRoot":"","sources":["../../../../src/ucp/mappers/map-completion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAI1D,MAAM,UAAU,uBAAuB,CACrC,MAAwB,EACxB,IAAc;IAEd,IAAI,OAA0B,CAAC;IAE/B,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,OAAO,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IACjC,CAAC;SAAM,CAAC;QACN,wEAAwE;QACxE,OAAO,GAAG;YACR,IAAI,EAAO,MAAM,CAAC,IAAI;YACtB,MAAM,EAAK,MAAM,CAAC,MAAM;YACxB,OAAO,EAAI,MAAM,CAAC,OAAO;YACzB,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B,CAAC;IACJ,CAAC;IAED,OAAO,wBAAwB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACjD,CAAC"}

package/dist/src/ucp/mappers/map-context.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Mapper: ContextAlignmentResult → ContextAlignmentEnvelope.
+ *
+ * Maps exactly from ContextAlignmentResult (src/understand/context/types.ts).
+ */
+import type { ContextAlignmentEnvelope, UCPRefs } from "../types.js";
+import type { ContextAlignmentResult } from "../../understand/context/types.js";
+export declare function mapContextToEnvelope(result: ContextAlignmentResult, refs?: UCPRefs): ContextAlignmentEnvelope;
+//# sourceMappingURL=map-context.d.ts.map

package/dist/src/ucp/mappers/map-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-context.d.ts","sourceRoot":"","sources":["../../../../src/ucp/mappers/map-context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,wBAAwB,EAA2B,OAAO,EAAE,MAAM,aAAa,CAAC;AAC9F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAEhF,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,sBAAsB,EAC9B,IAAI,CAAC,EAAE,OAAO,GACb,wBAAwB,CAM1B"}

package/dist/src/ucp/mappers/map-context.js

@@ -0,0 +1,13 @@
+/**
+ * Mapper: ContextAlignmentResult → ContextAlignmentEnvelope.
+ *
+ * Maps exactly from ContextAlignmentResult (src/understand/context/types.ts).
+ */
+import { createContextAlignmentEnvelope } from "../envelope.js";
+export function mapContextToEnvelope(result, refs) {
+    const payload = result.kind === "hard_mismatch"
+        ? { kind: result.kind, reason: result.reason }
+        : { kind: result.kind };
+    return createContextAlignmentEnvelope(payload, refs);
+}
+//# sourceMappingURL=map-context.js.map

package/dist/src/ucp/mappers/map-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-context.js","sourceRoot":"","sources":["../../../../src/ucp/mappers/map-context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,8BAA8B,EAAE,MAAM,gBAAgB,CAAC;AAIhE,MAAM,UAAU,oBAAoB,CAClC,MAA8B,EAC9B,IAAc;IAEd,MAAM,OAAO,GACX,MAAM,CAAC,IAAI,KAAK,eAAe;QAC7B,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAC9C,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;IAC5B,OAAO,8BAA8B,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACvD,CAAC"}

package/dist/src/ucp/mappers/map-debug-trace.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Mapper: DebugTrace → DebugTraceEnvelope.
+ *
+ * Maps exactly from DebugTrace (src/intake/trace.ts).
+ * Zero-authority: this envelope records what happened; it changes nothing.
+ */
+import type { DebugTraceEnvelope, UCPRefs } from "../types.js";
+import type { DebugTrace } from "../../intake/trace.js";
+export declare function mapDebugTraceToEnvelope(trace: DebugTrace, refs?: UCPRefs): DebugTraceEnvelope;
+//# sourceMappingURL=map-debug-trace.d.ts.map

package/dist/src/ucp/mappers/map-debug-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-debug-trace.d.ts","sourceRoot":"","sources":["../../../../src/ucp/mappers/map-debug-trace.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,UAAU,EACjB,IAAI,CAAC,EAAE,OAAO,GACb,kBAAkB,CAYpB"}

package/dist/src/ucp/mappers/map-debug-trace.js

@@ -0,0 +1,18 @@
+/**
+ * Mapper: DebugTrace → DebugTraceEnvelope.
+ *
+ * Maps exactly from DebugTrace (src/intake/trace.ts).
+ * Zero-authority: this envelope records what happened; it changes nothing.
+ */
+import { createDebugTraceEnvelope } from "../envelope.js";
+export function mapDebugTraceToEnvelope(trace, refs) {
+    return createDebugTraceEnvelope({
+        prvPassed: trace.prvPassed,
+        safetyVerdict: trace.safetyVerdict,
+        contextKind: trace.contextKind,
+        disambigKind: trace.disambigKind,
+        completionKind: trace.completionKind,
+        bridgeFired: trace.bridgeFired,
+    }, refs);
+}
+//# sourceMappingURL=map-debug-trace.js.map

package/dist/src/ucp/mappers/map-debug-trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-debug-trace.js","sourceRoot":"","sources":["../../../../src/ucp/mappers/map-debug-trace.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAI1D,MAAM,UAAU,uBAAuB,CACrC,KAAiB,EACjB,IAAc;IAEd,OAAO,wBAAwB,CAC7B;QACE,SAAS,EAAO,KAAK,CAAC,SAAS;QAC/B,aAAa,EAAG,KAAK,CAAC,aAAa;QACnC,WAAW,EAAK,KAAK,CAAC,WAAW;QACjC,YAAY,EAAI,KAAK,CAAC,YAAY;QAClC,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,WAAW,EAAK,KAAK,CAAC,WAAW;KAClC,EACD,IAAI,CACL,CAAC;AACJ,CAAC"}

package/dist/src/ucp/mappers/map-disambiguation.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Mapper: DisambiguationResult → DisambiguationEnvelope.
+ *
+ * Maps exactly from DisambiguationResult (src/understand/disambiguation/types.ts).
+ * The "unknown" kind carries no extra fields — the input simply had no signal.
+ */
+import type { DisambiguationEnvelope, UCPRefs } from "../types.js";
+import type { DisambiguationResult } from "../../understand/disambiguation/types.js";
+export declare function mapDisambiguationToEnvelope(result: DisambiguationResult, refs?: UCPRefs): DisambiguationEnvelope;
+//# sourceMappingURL=map-disambiguation.d.ts.map