usesteady 0.1.0-alpha.1

package/dist/src/skills/validator.js

@@ -0,0 +1,366 @@
+/**
+ * UseSteady Skills v1 — validator (file 3 of 8).
+ *
+ * Single responsibility: given the raw output of parseSkillFile, enforce every
+ * constraint from the frozen UseSteady Skills Architecture v1 spec.
+ *
+ * Design rules followed here:
+ *   - Collect ALL issues before returning (never fail-fast on the first error)
+ *   - Return a discriminated SkillValidationResult — never throw
+ *   - Use SkillValidationIssue.type literals so tests can assert on exact reasons
+ *   - Apply guardrails as strict equality checks against boolean literals
+ *   - Enforce the kind→schema mapping from KIND_SCHEMA_MAP (single source of truth)
+ *   - Treat absent optional fields (risk_level, priority) correctly under
+ *     exactOptionalPropertyTypes: true
+ */
+import { KIND_SCHEMA_MAP, REQUIRED_BODY_SECTIONS, } from './types.js';
+// ---------------------------------------------------------------------------
+// Type guards — each is a precise predicate, no Set or cast required
+// ---------------------------------------------------------------------------
+function isNonEmptyString(v) {
+    return typeof v === 'string' && v.trim().length > 0;
+}
+function isSkillKind(v) {
+    return (v === 'interpretation' ||
+        v === 'workflow_generation' ||
+        v === 'recovery');
+}
+function isSkillOutputSchema(v) {
+    return (v === 'usesteady.intent_candidates.v1' ||
+        v === 'usesteady.workflow_draft.v1' ||
+        v === 'usesteady.recovery_suggestions.v1');
+}
+/**
+ * Minimal semver check: requires at least major.minor.patch digits.
+ * Pre-release and build-metadata suffixes are allowed (not validated).
+ */
+function isValidVersion(v) {
+    return typeof v === 'string' && /^\d+\.\d+\.\d+/.test(v);
+}
+function isStringArray(v) {
+    return Array.isArray(v) && v.every((item) => typeof item === 'string');
+}
+// ---------------------------------------------------------------------------
+// Per-field validators
+// Each function pushes zero or more SkillValidationIssue objects into `issues`.
+// None of them return early from validateSkill — full aggregation is the goal.
+// ---------------------------------------------------------------------------
+function checkRequiredString(fm, field, issues) {
+    const value = fm[field];
+    if (value === undefined || value === null) {
+        issues.push({
+            type: 'missing_field',
+            field,
+            message: `Required field "${field}" is absent.`,
+        });
+    }
+    else if (!isNonEmptyString(value)) {
+        issues.push({
+            type: 'invalid_field',
+            field,
+            message: `Field "${field}" must be a non-empty string; got ${JSON.stringify(value)}.`,
+        });
+    }
+}
+function checkVersion(fm, issues) {
+    const value = fm['version'];
+    if (value === undefined || value === null) {
+        issues.push({
+            type: 'missing_field',
+            field: 'version',
+            message: 'Required field "version" is absent.',
+        });
+    }
+    else if (!isValidVersion(value)) {
+        issues.push({
+            type: 'invalid_field',
+            field: 'version',
+            message: `Field "version" must be a semantic version string (e.g. "1.0.0"); ` +
+                `got ${JSON.stringify(value)}.`,
+        });
+    }
+}
+/**
+ * Check `kind` and return the valid SkillKind value, or null if invalid.
+ * Returning the validated kind lets checkOutputSchema enforce the mapping
+ * without re-reading the field.
+ */
+function checkKind(fm, issues) {
+    const value = fm['kind'];
+    if (value === undefined || value === null) {
+        issues.push({
+            type: 'missing_field',
+            field: 'kind',
+            message: 'Required field "kind" is absent.',
+        });
+        return null;
+    }
+    if (!isSkillKind(value)) {
+        issues.push({
+            type: 'invalid_kind',
+            field: 'kind',
+            message: `Field "kind" must be one of "interpretation", "workflow_generation", ` +
+                `"recovery"; got ${JSON.stringify(value)}.`,
+        });
+        return null;
+    }
+    return value;
+}
+/**
+ * Check `output_schema` presence, validity, and — when kind is also valid —
+ * the kind→schema mapping from KIND_SCHEMA_MAP.
+ * Called after checkKind so the kind parameter is already validated (or null).
+ */
+function checkOutputSchema(fm, validatedKind, issues) {
+    const value = fm['output_schema'];
+    if (value === undefined || value === null) {
+        issues.push({
+            type: 'missing_field',
+            field: 'output_schema',
+            message: 'Required field "output_schema" is absent.',
+        });
+        return;
+    }
+    if (!isSkillOutputSchema(value)) {
+        issues.push({
+            type: 'invalid_field',
+            field: 'output_schema',
+            message: `Field "output_schema" must be one of the three supported schema identifiers; ` +
+                `got ${JSON.stringify(value)}.`,
+        });
+        return;
+    }
+    // Kind→schema mapping — only checked when kind itself is also valid.
+    // A missing or invalid kind produces its own issue; conflating the two would
+    // create confusing double-error messages.
+    if (validatedKind !== null) {
+        const expectedSchema = KIND_SCHEMA_MAP[validatedKind];
+        if (value !== expectedSchema) {
+            issues.push({
+                type: 'schema_mismatch',
+                field: 'output_schema',
+                message: `Kind "${validatedKind}" requires output_schema "${expectedSchema}" ` +
+                    `but got "${value}".`,
+            });
+        }
+    }
+}
+/**
+ * Guardrail checks.
+ *
+ * Each boolean is compared with strict equality (===) against its required
+ * literal value. A missing field is treated as a guardrail_violation (not a
+ * missing_field) because intent matters: the spec requires these fields to be
+ * present AND set correctly. Absence is as dangerous as a wrong value.
+ */
+const GUARDRAIL_CHECKS = [
+    { field: 'requires_review', expected: true },
+    { field: 'can_execute', expected: false },
+    { field: 'can_call_tools', expected: false },
+    { field: 'can_bypass_policy', expected: false },
+    { field: 'can_bypass_approval', expected: false },
+];
+function checkGuardrails(fm, issues) {
+    for (const { field, expected } of GUARDRAIL_CHECKS) {
+        const value = fm[field];
+        if (value === undefined || value === null) {
+            issues.push({
+                type: 'guardrail_violation',
+                field,
+                message: `Guardrail "${field}" is absent; ` +
+                    `it must be present and set to exactly ${JSON.stringify(expected)}.`,
+            });
+        }
+        else if (value !== expected) {
+            issues.push({
+                type: 'guardrail_violation',
+                field,
+                message: `Guardrail "${field}" must be exactly ${JSON.stringify(expected)}; ` +
+                    `got ${JSON.stringify(value)}.`,
+            });
+        }
+    }
+}
+function checkTriggers(fm, issues) {
+    const value = fm['triggers'];
+    if (value === undefined || value === null) {
+        issues.push({
+            type: 'missing_field',
+            field: 'triggers',
+            message: 'Required field "triggers" is absent.',
+        });
+        return;
+    }
+    if (!isStringArray(value)) {
+        issues.push({
+            type: 'invalid_field',
+            field: 'triggers',
+            message: `Field "triggers" must be an array of strings; ` +
+                `got ${JSON.stringify(value)}.`,
+        });
+        return;
+    }
+    if (value.length === 0) {
+        issues.push({
+            type: 'invalid_field',
+            field: 'triggers',
+            message: 'Field "triggers" must contain at least one entry.',
+        });
+        return;
+    }
+    // Every trigger must be a non-empty, non-whitespace string.
+    const blankCount = value.filter((t) => t.trim().length === 0).length;
+    if (blankCount > 0) {
+        issues.push({
+            type: 'invalid_field',
+            field: 'triggers',
+            message: `Field "triggers" contains ${blankCount} empty or blank entry/entries.`,
+        });
+    }
+}
+/**
+ * Priority is optional. When present it must be a finite number.
+ * Validated priority defaults to 100 in buildMetadata when absent.
+ */
+function checkPriority(fm, issues) {
+    const value = fm['priority'];
+    if (value === undefined || value === null)
+        return; // absent is valid
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        issues.push({
+            type: 'invalid_field',
+            field: 'priority',
+            message: `Field "priority" must be a finite number when present; ` +
+                `got ${JSON.stringify(value)}.`,
+        });
+    }
+}
+/**
+ * Map the human-readable section name (from REQUIRED_BODY_SECTIONS) to the
+ * camelCase key used in ParsedSections.
+ *
+ * The switch is exhaustive over RequiredBodySection — TypeScript verifies that
+ * every member of the union is handled and the function always returns.
+ */
+function sectionNameToKey(name) {
+    switch (name) {
+        case 'Purpose': return 'purpose';
+        case 'When to use': return 'whenToUse';
+        case 'Output contract': return 'outputContract';
+        case 'Guardrails': return 'guardrails';
+        case 'Examples': return 'examples';
+    }
+}
+/**
+ * All five required body sections must be present and non-empty.
+ * Absent sections are reported as invalid_markdown (a content contract issue,
+ * not a field issue) to make them distinguishable from frontmatter problems in
+ * test assertions and audit logs.
+ */
+function checkBodySections(sections, issues) {
+    for (const sectionName of REQUIRED_BODY_SECTIONS) {
+        const key = sectionNameToKey(sectionName);
+        const content = sections[key];
+        if (content === undefined) {
+            issues.push({
+                type: 'invalid_markdown',
+                message: `Required body section "${sectionName}" is absent or has no content.`,
+            });
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Metadata builder — called only when the issues array is empty
+// ---------------------------------------------------------------------------
+/**
+ * Construct a fully typed, readonly SkillMetadata from a validated raw
+ * frontmatter record.
+ *
+ * All casts here are safe: each field was confirmed to the correct type by its
+ * check function before this builder is called. The builder's only job is to
+ * assemble the typed object and apply the default for the optional `priority`
+ * field.
+ *
+ * exactOptionalPropertyTypes compliance:
+ *   `risk_level` must be physically absent (not set to undefined) when not
+ *   present in the frontmatter. Conditional spread achieves this.
+ */
+function buildMetadata(fm) {
+    const riskLevel = fm['risk_level'];
+    return {
+        name: fm['name'],
+        description: fm['description'],
+        version: fm['version'],
+        kind: fm['kind'],
+        triggers: fm['triggers'],
+        output_schema: fm['output_schema'],
+        // Guardrail literals — the validator confirmed these exact values;
+        // `as const` casts satisfy the literal types true/false in SkillMetadata.
+        requires_review: true,
+        can_execute: false,
+        can_call_tools: false,
+        can_bypass_policy: false,
+        can_bypass_approval: false,
+        // priority defaults to 100 when absent (spec-defined default).
+        priority: typeof fm['priority'] === 'number' ? fm['priority'] : 100,
+        // Conditional spread: omit risk_level entirely when absent or blank.
+        ...(isNonEmptyString(riskLevel) ? { risk_level: riskLevel } : {}),
+    };
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Validate the parsed output of a SKILL.md file against the frozen spec.
+ *
+ *   valid: true  → metadata is fully typed and safe to store in the registry
+ *   valid: false → issues contains every violation found in one pass
+ *
+ * Never throws. All errors are returned as structured SkillValidationIssue
+ * objects so that tests can assert on issue.type rather than string messages.
+ *
+ * @param parsed     The ParsedSkillFile returned by parseSkillFile.
+ * @param sourcePath Absolute path to the SKILL.md file; used in error messages.
+ */
+export function validateSkill(parsed, sourcePath) {
+    // Defensive guard: the parser guarantees frontmatter is a Record, but the
+    // validator must not assume that — it is the authoritative trust boundary.
+    if (typeof parsed.frontmatter !== 'object' ||
+        parsed.frontmatter === null ||
+        Array.isArray(parsed.frontmatter)) {
+        return {
+            valid: false,
+            issues: [
+                {
+                    type: 'invalid_yaml',
+                    message: `${sourcePath}: frontmatter did not parse to a plain object.`,
+                },
+            ],
+        };
+    }
+    const fm = parsed.frontmatter;
+    const issues = [];
+    // ── Required string fields ────────────────────────────────────────────────
+    checkRequiredString(fm, 'name', issues);
+    checkRequiredString(fm, 'description', issues);
+    // ── Version ───────────────────────────────────────────────────────────────
+    checkVersion(fm, issues);
+    // ── Kind — validate and capture the value for schema cross-check ──────────
+    const validatedKind = checkKind(fm, issues);
+    // ── Output schema — validated against KIND_SCHEMA_MAP when kind is valid ──
+    checkOutputSchema(fm, validatedKind, issues);
+    // ── Guardrails — all five must be present and pinned to exact values ───────
+    checkGuardrails(fm, issues);
+    // ── Triggers ──────────────────────────────────────────────────────────────
+    checkTriggers(fm, issues);
+    // ── Priority (optional, typed when present) ───────────────────────────────
+    checkPriority(fm, issues);
+    // ── Required body sections ────────────────────────────────────────────────
+    checkBodySections(parsed.sections, issues);
+    // ── Result ────────────────────────────────────────────────────────────────
+    if (issues.length > 0) {
+        return { valid: false, issues };
+    }
+    return { valid: true, metadata: buildMetadata(fm) };
+}
+//# sourceMappingURL=validator.js.map

package/dist/src/skills/validator.js.map

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

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

@@ -0,0 +1,165 @@
+/**
+ * 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 type { UCPEnvelope, UCPType, UCPRefs, IntentPayload, PRVPayload, SafetyPayload, ContextAlignmentPayload, DisambiguationPayload, CompletionPayload, IntentInterpretationPayload, ChangeInterpretationPayload, ResponsePayload, InteractionContractPayload, InteractionEventPayload, DebugTracePayload, IntentEnvelope, PRVEnvelope, SafetyEnvelope, ContextAlignmentEnvelope, DisambiguationEnvelope, CompletionEnvelope, IntentInterpretationEnvelope, ChangeInterpretationEnvelope, ResponseEnvelope, InteractionContractEnvelope, InteractionEventEnvelope, DebugTraceEnvelope, ArtifactPayload, ExecutionTracePayload, ReplayReportPayload, ArtifactEnvelope, ExecutionTraceEnvelope, ReplayReportEnvelope, ReminderExecutionPayload, ReminderExecutionEnvelope, CursorHandoffPayload, CursorReceiptPayload, CursorRefusedPayload, CursorHandoffEnvelope, CursorReceiptEnvelope, CursorRefusedEnvelope, ClaudeHandoffPayload, ClaudeReceiptPayload, ClaudeRefusedPayload, ClaudeHandoffEnvelope, ClaudeReceiptEnvelope, ClaudeRefusedEnvelope, WorkflowRunPayload, WorkflowRunEnvelope } from "./types.js";
+/**
+ * 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 declare function createEnvelope<T>(type: UCPType, payload: T, source: string, refs?: UCPRefs): UCPEnvelope<T>;
+export declare function createIntentEnvelope(payload: IntentPayload, refs?: UCPRefs): IntentEnvelope;
+export declare function createPRVEnvelope(payload: PRVPayload, refs?: UCPRefs): PRVEnvelope;
+export declare function createSafetyEnvelope(payload: SafetyPayload, refs?: UCPRefs): SafetyEnvelope;
+export declare function createContextAlignmentEnvelope(payload: ContextAlignmentPayload, refs?: UCPRefs): ContextAlignmentEnvelope;
+export declare function createDisambiguationEnvelope(payload: DisambiguationPayload, refs?: UCPRefs): DisambiguationEnvelope;
+export declare function createCompletionEnvelope(payload: CompletionPayload, refs?: UCPRefs): CompletionEnvelope;
+export declare function createIntentInterpretationEnvelope(payload: IntentInterpretationPayload, refs?: UCPRefs): IntentInterpretationEnvelope;
+export declare function createChangeInterpretationEnvelope(payload: ChangeInterpretationPayload, refs?: UCPRefs): ChangeInterpretationEnvelope;
+export declare function createResponseEnvelope(payload: ResponsePayload, refs?: UCPRefs): ResponseEnvelope;
+export declare function createInteractionContractEnvelope(payload: InteractionContractPayload, refs?: UCPRefs): InteractionContractEnvelope;
+export declare function createInteractionEventEnvelope(payload: InteractionEventPayload, refs?: UCPRefs): InteractionEventEnvelope;
+export declare function createDebugTraceEnvelope(payload: DebugTracePayload, refs?: UCPRefs): DebugTraceEnvelope;
+/**
+ * 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 declare function createArtifactEnvelope(payload: ArtifactPayload, refs?: UCPRefs): ArtifactEnvelope;
+/**
+ * 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 declare function createExecutionTraceEnvelope(payload: ExecutionTracePayload, refs?: UCPRefs): ExecutionTraceEnvelope;
+/**
+ * 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 declare function createReplayReportEnvelope(payload: ReplayReportPayload, refs?: UCPRefs): ReplayReportEnvelope;
+/**
+ * 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 declare function createCursorHandoffEnvelope(payload: CursorHandoffPayload, refs?: UCPRefs): CursorHandoffEnvelope;
+/**
+ * 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 declare function createCursorReceiptEnvelope(payload: CursorReceiptPayload, refs?: UCPRefs): CursorReceiptEnvelope;
+/**
+ * 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 declare function createCursorRefusedEnvelope(payload: CursorRefusedPayload, refs?: UCPRefs): CursorRefusedEnvelope;
+/**
+ * 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 declare function createClaudeHandoffEnvelope(payload: ClaudeHandoffPayload, refs?: UCPRefs): ClaudeHandoffEnvelope;
+/**
+ * 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 declare function createClaudeReceiptEnvelope(payload: ClaudeReceiptPayload, refs?: UCPRefs): ClaudeReceiptEnvelope;
+/**
+ * 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 declare function createClaudeRefusedEnvelope(payload: ClaudeRefusedPayload, refs?: UCPRefs): ClaudeRefusedEnvelope;
+/**
+ * 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 declare function createReminderExecutionEnvelope(payload: ReminderExecutionPayload, refs?: UCPRefs): ReminderExecutionEnvelope;
+/**
+ * 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 declare function createWorkflowRunEnvelope(payload: WorkflowRunPayload, refs?: UCPRefs): WorkflowRunEnvelope;
+//# sourceMappingURL=envelope.d.ts.map

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

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