@pome-sh/cli 0.2.0 → 0.3.0

package/node_modules/@pome-sh/twin-github/node_modules/@pome-sh/shared-types/dist/run.d.ts

@@ -0,0 +1,208 @@
+/**
+ * run — completed-run shape, criterion result, lane/step correlator output
+ *
+ * Consumed by:
+ *   - `@pome-sh/evaluator` — produces CriterionResult, satisfaction_score
+ *   - `pome-cloud` correlator — produces `{ lanes, steps }` from RecorderEvent[]
+ *   - `pome-cloud` `runs` table writer — persists the full Run row
+ *   - dashboard `/runs/:id` — renders lane-timeline + state-inspector + handoff card
+ *
+ * Lane/Step are flat parallel arrays on Run (not nested), aligning with the
+ * `runs.lanes jsonb` + `runs.steps jsonb` two-column DB shape from FDRS-327.
+ * Cross-reference: `Lane.step_id` → `Step.id`; `Lane.request_ids[]` →
+ * `RecorderEvent.request_id`.
+ */
+import { z } from "zod";
+export declare const judgeModelSchema: z.ZodString;
+export type JudgeModel = z.infer<typeof judgeModelSchema>;
+export declare const correlatorKindSchema: z.ZodEnum<{
+    heuristic: "heuristic";
+    adapter_rich: "adapter_rich";
+    span_context: "span_context";
+}>;
+export type CorrelatorKind = z.infer<typeof correlatorKindSchema>;
+export declare const CRITERION_KINDS: readonly ["code", "model"];
+export declare const criterionKindSchema: z.ZodEnum<{
+    model: "model";
+    code: "code";
+}>;
+export type CriterionKind = z.infer<typeof criterionKindSchema>;
+export declare const criterionSchema: z.ZodObject<{
+    type: z.ZodPipe<z.ZodEnum<{
+        model: "model";
+        code: "code";
+        D: "D";
+        P: "P";
+    }>, z.ZodTransform<"model" | "code", "model" | "code" | "D" | "P">>;
+    text: z.ZodString;
+    twin: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type Criterion = z.infer<typeof criterionSchema>;
+export declare const deterministicCriterionResultSchema: z.ZodObject<{
+    criterion: z.ZodObject<{
+        type: z.ZodPipe<z.ZodEnum<{
+            model: "model";
+            code: "code";
+            D: "D";
+            P: "P";
+        }>, z.ZodTransform<"model" | "code", "model" | "code" | "D" | "P">>;
+        text: z.ZodString;
+        twin: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    passed: z.ZodBoolean;
+    skipped: z.ZodBoolean;
+    reason: z.ZodString;
+}, z.core.$strip>;
+export type DeterministicCriterionResult = z.infer<typeof deterministicCriterionResultSchema>;
+export declare const probabilisticCriterionResultSchema: z.ZodObject<{
+    criterion: z.ZodObject<{
+        type: z.ZodPipe<z.ZodEnum<{
+            model: "model";
+            code: "code";
+            D: "D";
+            P: "P";
+        }>, z.ZodTransform<"model" | "code", "model" | "code" | "D" | "P">>;
+        text: z.ZodString;
+        twin: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    passed: z.ZodBoolean;
+    skipped: z.ZodBoolean;
+    reason: z.ZodString;
+    confidence: z.ZodNumber;
+    judge_model: z.ZodString;
+}, z.core.$strip>;
+export type ProbabilisticCriterionResult = z.infer<typeof probabilisticCriterionResultSchema>;
+export declare const criterionResultSchema: z.ZodUnion<readonly [z.ZodObject<{
+    criterion: z.ZodObject<{
+        type: z.ZodPipe<z.ZodEnum<{
+            model: "model";
+            code: "code";
+            D: "D";
+            P: "P";
+        }>, z.ZodTransform<"model" | "code", "model" | "code" | "D" | "P">>;
+        text: z.ZodString;
+        twin: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    passed: z.ZodBoolean;
+    skipped: z.ZodBoolean;
+    reason: z.ZodString;
+    confidence: z.ZodNumber;
+    judge_model: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    criterion: z.ZodObject<{
+        type: z.ZodPipe<z.ZodEnum<{
+            model: "model";
+            code: "code";
+            D: "D";
+            P: "P";
+        }>, z.ZodTransform<"model" | "code", "model" | "code" | "D" | "P">>;
+        text: z.ZodString;
+        twin: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    passed: z.ZodBoolean;
+    skipped: z.ZodBoolean;
+    reason: z.ZodString;
+}, z.core.$strip>]>;
+export type CriterionResult = z.infer<typeof criterionResultSchema>;
+export declare const stepSchema: z.ZodObject<{
+    id: z.ZodString;
+    started_at: z.ZodString;
+    ended_at: z.ZodString;
+    label: z.ZodNullable<z.ZodString>;
+    lane_ids: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type Step = z.infer<typeof stepSchema>;
+export declare const laneSchema: z.ZodObject<{
+    id: z.ZodString;
+    step_id: z.ZodString;
+    twin: z.ZodString;
+    label: z.ZodNullable<z.ZodString>;
+    request_ids: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type Lane = z.infer<typeof laneSchema>;
+export declare const runSchema: z.ZodPreprocess<z.ZodObject<{
+    id: z.ZodString;
+    session_id: z.ZodString;
+    team_id: z.ZodString;
+    task_name: z.ZodString;
+    task_hash: z.ZodString;
+    satisfaction_score: z.ZodNumber;
+    criteria_results: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        criterion: z.ZodObject<{
+            type: z.ZodPipe<z.ZodEnum<{
+                model: "model";
+                code: "code";
+                D: "D";
+                P: "P";
+            }>, z.ZodTransform<"model" | "code", "model" | "code" | "D" | "P">>;
+            text: z.ZodString;
+            twin: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        passed: z.ZodBoolean;
+        skipped: z.ZodBoolean;
+        reason: z.ZodString;
+        confidence: z.ZodNumber;
+        judge_model: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        criterion: z.ZodObject<{
+            type: z.ZodPipe<z.ZodEnum<{
+                model: "model";
+                code: "code";
+                D: "D";
+                P: "P";
+            }>, z.ZodTransform<"model" | "code", "model" | "code" | "D" | "P">>;
+            text: z.ZodString;
+            twin: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        passed: z.ZodBoolean;
+        skipped: z.ZodBoolean;
+        reason: z.ZodString;
+    }, z.core.$strip>]>>;
+    trace_s3_key: z.ZodNullable<z.ZodString>;
+    state_s3_key: z.ZodNullable<z.ZodString>;
+    meta_s3_key: z.ZodNullable<z.ZodString>;
+    duration_ms: z.ZodNumber;
+    agent_model: z.ZodString;
+    judge_model: z.ZodString;
+    judge_tokens_in: z.ZodNullable<z.ZodNumber>;
+    judge_tokens_out: z.ZodNullable<z.ZodNumber>;
+    agent_tokens_in: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    agent_tokens_out: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    agent_latency_p50_ms: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    agent_latency_p95_ms: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    agent_latency_max_ms: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    agent_error_count: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    agent_telemetry_span_count: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    correlator_kind: z.ZodDefault<z.ZodEnum<{
+        heuristic: "heuristic";
+        adapter_rich: "adapter_rich";
+        span_context: "span_context";
+    }>>;
+    environment: z.ZodDefault<z.ZodEnum<{
+        production: "production";
+        simulation: "simulation";
+    }>>;
+    promoted_task_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    replay_run_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    state_archive_s3_key: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    lanes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        step_id: z.ZodString;
+        twin: z.ZodString;
+        label: z.ZodNullable<z.ZodString>;
+        request_ids: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>>;
+    steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        started_at: z.ZodString;
+        ended_at: z.ZodString;
+        label: z.ZodNullable<z.ZodString>;
+        lane_ids: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>>;
+    summary: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    fix_prompt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    events_jsonl_url: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    created_at: z.ZodString;
+    finished_at: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>>;
+export type Run = z.infer<typeof runSchema>;

package/node_modules/@pome-sh/twin-github/node_modules/@pome-sh/shared-types/dist/run.js

@@ -0,0 +1,170 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * run — completed-run shape, criterion result, lane/step correlator output
+ *
+ * Consumed by:
+ *   - `@pome-sh/evaluator` — produces CriterionResult, satisfaction_score
+ *   - `pome-cloud` correlator — produces `{ lanes, steps }` from RecorderEvent[]
+ *   - `pome-cloud` `runs` table writer — persists the full Run row
+ *   - dashboard `/runs/:id` — renders lane-timeline + state-inspector + handoff card
+ *
+ * Lane/Step are flat parallel arrays on Run (not nested), aligning with the
+ * `runs.lanes jsonb` + `runs.steps jsonb` two-column DB shape from FDRS-327.
+ * Cross-reference: `Lane.step_id` → `Step.id`; `Lane.request_ids[]` →
+ * `RecorderEvent.request_id`.
+ */
+import { z } from "zod";
+import { twinIdSchema } from "./recorder-events.js";
+import { LEGACY_CRITERION_KIND_MAP, normalizeTaskVocabKeys } from "./task-vocab.js";
+// Judge model is a free-form string (BYOK Flavor #1, OpenAI-compatible endpoint
+// passes through); not constrained at the schema level because the customer's
+// gateway decides what model identifiers it accepts.
+export const judgeModelSchema = z.string().min(1);
+// Which server-side correlator produced a run's lanes/steps. Reconciled from
+// pome-cloud /v1 (FDRS-613): OTEL M4/M6 clients distinguish heuristic legacy
+// timelines from exact span-context timelines.
+export const correlatorKindSchema = z.enum([
+    "heuristic",
+    "adapter_rich",
+    "span_context",
+]);
+// Criterion kind — W3 vocab (FDRS-653): `code` = deterministic/code-checked
+// predicate (formerly `D`), `model` = LLM-judged (formerly `P`). The canonical
+// enum is `code | model`; the INPUT schema below additionally accepts the
+// 0.3.0-era `D` / `P` spellings and normalizes them at parse time (tolerant
+// reader — shipped CLIs vendor 0.3.0 and keep sending D/P).
+export const CRITERION_KINDS = ["code", "model"];
+export const criterionKindSchema = z.enum(CRITERION_KINDS);
+// Single source of truth for the D/P→code/model rename is
+// LEGACY_CRITERION_KIND_MAP in ./task-vocab.ts.
+const criterionKindInputSchema = z
+    .enum(["D", "P", "code", "model"])
+    .transform((kind) => kind === "D" || kind === "P" ? LEGACY_CRITERION_KIND_MAP[kind] : kind);
+export const criterionSchema = z.object({
+    // Accepts D | P | code | model; parsed output is always code | model.
+    type: criterionKindInputSchema,
+    text: z.string().min(1),
+    // Multi-twin (M3): the twin this criterion attributes to. Rides through the
+    // D/P→code/model transform above untouched. Absent = the run's primary twin
+    // (the session's twins[0]). Additive — single-twin runs omit it.
+    twin: z.string().min(1).optional(),
+});
+// CriterionResult shape matches OSS evaluator's emit. The full Criterion is
+// included by reference (not just text) so consumers render type-aware UI
+// without rejoining. Discriminate on `criterion.type` (no separate `kind`
+// field) — normalized to `code` / `model` (0.3.0 artifacts carrying `D` / `P`
+// parse and normalize).
+const baseCriterionResultSchema = z.object({
+    criterion: criterionSchema, // full {type, text} object
+    passed: z.boolean(),
+    skipped: z.boolean(), // true if [code] fell back to [model] but the judge was unreachable, etc.
+    reason: z.string(), // human-readable evidence
+});
+export const deterministicCriterionResultSchema = baseCriterionResultSchema.extend({
+// [code] adds nothing further; criterion.type === "code" identifies it.
+});
+export const probabilisticCriterionResultSchema = baseCriterionResultSchema.extend({
+    confidence: z.number().min(0).max(1),
+    judge_model: judgeModelSchema,
+});
+// Probabilistic FIRST: it's the strict superset (requires confidence +
+// judge_model). z.union tries branches in order and picks the first match.
+// If deterministic were first, [model] payloads would parse cleanly but
+// .extend({}) would silently strip the [model]-only fields — we'd persist them
+// as null in runs.criteria_results JSON, breaking dashboard rendering of
+// confidence + per-criterion judge_model. [code] payloads (no confidence /
+// judge_model) fail probabilistic on the required fields and fall through.
+export const criterionResultSchema = z.union([
+    probabilisticCriterionResultSchema,
+    deterministicCriterionResultSchema,
+]);
+// Step is the correlator's top-level grouping: one Step per agent assistant
+// turn (adapter-rich path) or per heuristic-clustered HTTP burst (heuristic
+// path). started_at/ended_at bound the contained events. label is null when
+// heuristic-only (no assistant message to seed it from).
+export const stepSchema = z.object({
+    id: z.string(), // matches RecorderEvent.step_id
+    started_at: z.string().datetime(),
+    ended_at: z.string().datetime(),
+    label: z.string().nullable(),
+    lane_ids: z.array(z.string()), // child lanes, render order
+});
+// Lane is the correlator's per-step sub-grouping by twin + endpoint pattern.
+// One lane = one horizontal track in lane-timeline UI. request_ids reference
+// RecorderEvent.request_id back into events.jsonl (events are the source of
+// truth; Lane just records which events belong here, time-ordered).
+export const laneSchema = z.object({
+    id: z.string(),
+    step_id: z.string(), // parent Step.id
+    twin: twinIdSchema, // matches RecorderEvent.twin
+    label: z.string().nullable(), // e.g. "POST /v1/refunds (3 calls)"
+    request_ids: z.array(z.string()), // RecorderEvent.request_id, time-ordered
+});
+// Canonical Run row. W3 vocab (FDRS-653): `task_name` / `task_hash` /
+// `promoted_task_id` are the canonical wire keys (cloud DB: `tasks` table,
+// `runs.task_name`). The exported `runSchema` below wraps this object in the
+// tolerant-reader preprocess so 0.3.0-era rows carrying `scenario_name` /
+// `scenario_hash` / `promoted_scenario_id` parse and normalize.
+const runObjectSchema = z.object({
+    id: z.string(), // run_<nanoid>
+    session_id: z.string(),
+    team_id: z.string(),
+    task_name: z.string(), // 0.3.0 alias: scenario_name
+    task_hash: z.string(), // sha256 of source markdown; 0.3.0 alias: scenario_hash
+    satisfaction_score: z.number().int().min(0).max(100), // CLI-computed (BYOK Flavor #1)
+    criteria_results: z.array(criterionResultSchema),
+    trace_s3_key: z.string().nullable(), // s3 key for events.jsonl (hosted only; F-689 deleted tool_calls.jsonl)
+    state_s3_key: z.string().nullable(), // s3 key for state_final.json
+    meta_s3_key: z.string().nullable(),
+    duration_ms: z.number().int(),
+    agent_model: z.string(), // which model the agent used (informational)
+    judge_model: judgeModelSchema, // which model judged [P] (free-form)
+    judge_tokens_in: z.number().int().min(0).nullable(),
+    judge_tokens_out: z.number().int().min(0).nullable(),
+    // ── FDRS-613: reconciled from pome-cloud /v1 wire truth (all additive with
+    // defaults so pre-existing Run constructors stay valid) ────────────────────
+    // Sim deep-telemetry — per-run agent telemetry rollup, computed at finalize
+    // from the agent's independently-correlated `gen_ai` span tree. Null = no
+    // instrumentation / legacy / twin-only sim (dashboard renders `·`, never `0`).
+    agent_tokens_in: z.number().int().min(0).nullable().default(null),
+    agent_tokens_out: z.number().int().min(0).nullable().default(null),
+    agent_latency_p50_ms: z.number().int().min(0).nullable().default(null),
+    agent_latency_p95_ms: z.number().int().min(0).nullable().default(null),
+    agent_latency_max_ms: z.number().int().min(0).nullable().default(null),
+    agent_error_count: z.number().int().min(0).nullable().default(null),
+    agent_telemetry_span_count: z.number().int().min(0).nullable().default(null),
+    // Which server-side correlator produced lanes/steps.
+    correlator_kind: correlatorKindSchema.default("heuristic"),
+    // M0.2 (FDRS-509) — which surface this run belongs to. 'simulation' =
+    // CLI/staging scenario run (default for every legacy row); 'production' = an
+    // ingested OTLP production trace (M2).
+    environment: z.enum(["production", "simulation"]).default("simulation"),
+    // M0.5 (FDRS-512) — replay loop linkage (prod-run → task → replay-run).
+    // W3 vocab: canonical key; 0.3.0 alias: promoted_scenario_id.
+    promoted_task_id: z.string().nullable().default(null),
+    replay_run_id: z.string().nullable().default(null),
+    // Storage key for the tar-and-upload state archive the replay engine seeds a
+    // sandbox from. Null when no archive was captured.
+    state_archive_s3_key: z.string().nullable().default(null),
+    // Correlator output. Empty arrays for legacy runs (pre-M3i / pre-M4-1).
+    lanes: z.array(laneSchema).default([]),
+    steps: z.array(stepSchema).default([]),
+    // Server-generated by the managed judge (ADR-013). 1-2 sentence concise
+    // narrative of the run. Null for pre-ADR-013 rows / legacy /result runs.
+    summary: z.string().nullable().default(null),
+    // Originally CLI-generated (BYOK Flavor #1). Null on --no-fix-prompt opt-out,
+    // LLM endpoint failure, or legacy pre-M4-1 runs.
+    fix_prompt: z.string().nullable().default(null),
+    // Storage KEY (path) of the raw events.jsonl blob — NOT a URL (dashboard mints
+    // a signed GET URL on read). FDRS-613: relaxed from `.url()` to match the
+    // pome-cloud shape, since persisted storage keys are not URLs. Null in
+    // self-host mode, on upload failure, --no-upload opt-out, or legacy runs.
+    events_jsonl_url: z.string().nullable().default(null),
+    created_at: z.string().datetime(),
+    finished_at: z.string().datetime().nullable(),
+});
+// Tolerant reader (FDRS-653): accepts both the 0.3.0 `scenario_*` and the
+// canonical `task_*` keys and normalizes to the new vocabulary. When both are
+// present, the canonical key wins. The parsed output carries `task_*` only.
+export const runSchema = z.preprocess(normalizeTaskVocabKeys, runObjectSchema);
+//# sourceMappingURL=run.js.map

package/node_modules/@pome-sh/twin-github/node_modules/@pome-sh/shared-types/dist/run.js.map

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

package/node_modules/@pome-sh/twin-github/node_modules/@pome-sh/shared-types/dist/seed-envelope.d.ts

@@ -0,0 +1,14 @@
+import { z } from "zod";
+export declare const seedEnvelopeSchema: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+export type SeedEnvelope = z.infer<typeof seedEnvelopeSchema>;
+/**
+ * THE RULE, in code: a session's `seed` is a per-twin envelope iff the session
+ * has more than one twin. Decide from the `twins` array alone — never by
+ * sniffing the seed's shape.
+ *
+ * This is the shared PREDICATE, not the enforcement point. The actual
+ * envelope-iff-multi-twin check runs at the edges that know `twins`: the cloud
+ * at session create and the CLI at scenario parse time (follow-up PRs). The
+ * create-session request schema stays a shape-blind pass-through by design.
+ */
+export declare function isMultiTwinSeedEnvelope(twins: string[]): boolean;

package/node_modules/@pome-sh/twin-github/node_modules/@pome-sh/shared-types/dist/seed-envelope.js

@@ -0,0 +1,46 @@
+// SPDX-License-Identifier: Apache-2.0
+//
+// shared-types §3 — multi-twin seed envelope. Re-exported through the
+// `@pome-sh/shared-types` barrel (index.ts).
+//
+// THE RULE (no shape-sniffing anywhere): the create-session `seed` override is a
+// per-twin envelope `{ <twin>: <flat seed> }` IF AND ONLY IF the session has
+// more than one twin. Single-twin sessions ALWAYS use the flat single-twin seed
+// shape (the domain seed object the twin's own `parseSeed` owns — see
+// createSessionRequestSchema.seed). Callers decide which shape to send from the
+// session's `twins` array alone (`isMultiTwinSeedEnvelope`), never by inspecting
+// the seed's contents. This keeps the boundary shape-blind: a flat seed and an
+// envelope are both JSON objects, so sniffing would be ambiguous and brittle.
+import { z } from "zod";
+// Multi-twin (M3) seed envelope: twin id → that twin's flat domain seed. Like
+// createSessionRequestSchema.seed, each per-twin seed is a permissive,
+// shape-blind JSON object — the twin pod's `parseSeed` is the sole authority on
+// its domain shape. The envelope keeps only the two invariants that are the
+// boundary's business: the envelope is a JSON object, and each value is a JSON
+// object.
+//
+// WHERE THE ENVELOPE-IFF-MULTI-TWIN RULE IS ENFORCED (not here): this schema and
+// createSessionRequestSchema.seed are deliberately shape-blind — the request
+// boundary accepts any JSON-object `seed` for both single- and multi-twin
+// sessions and forwards it verbatim. The correlation between the `seed` shape and
+// `twins.length` is validated at the EDGES, where the `twins` array is known:
+//   - the cloud validates envelope-iff-multi-twin at session create; and
+//   - the CLI validates it at scenario parse time
+// (both landing in follow-up PRs). Do NOT add that cross-field check to the
+// request schema — the twin owns its seed shape, and sniffing here would be the
+// ambiguous, brittle coupling THE RULE exists to avoid.
+export const seedEnvelopeSchema = z.record(z.string(), z.record(z.string(), z.unknown()));
+/**
+ * THE RULE, in code: a session's `seed` is a per-twin envelope iff the session
+ * has more than one twin. Decide from the `twins` array alone — never by
+ * sniffing the seed's shape.
+ *
+ * This is the shared PREDICATE, not the enforcement point. The actual
+ * envelope-iff-multi-twin check runs at the edges that know `twins`: the cloud
+ * at session create and the CLI at scenario parse time (follow-up PRs). The
+ * create-session request schema stays a shape-blind pass-through by design.
+ */
+export function isMultiTwinSeedEnvelope(twins) {
+    return twins.length > 1;
+}
+//# sourceMappingURL=seed-envelope.js.map

package/node_modules/@pome-sh/twin-github/node_modules/@pome-sh/shared-types/dist/seed-envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed-envelope.js","sourceRoot":"","sources":["../src/seed-envelope.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,EAAE;AACF,sEAAsE;AACtE,6CAA6C;AAC7C,EAAE;AACF,iFAAiF;AACjF,6EAA6E;AAC7E,gFAAgF;AAChF,sEAAsE;AACtE,gFAAgF;AAChF,iFAAiF;AACjF,+EAA+E;AAC/E,8EAA8E;AAE9E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8EAA8E;AAC9E,uEAAuE;AACvE,gFAAgF;AAChF,4EAA4E;AAC5E,+EAA+E;AAC/E,UAAU;AACV,EAAE;AACF,iFAAiF;AACjF,6EAA6E;AAC7E,0EAA0E;AAC1E,kFAAkF;AAClF,8EAA8E;AAC9E,yEAAyE;AACzE,kDAAkD;AAClD,4EAA4E;AAC5E,gFAAgF;AAChF,wDAAwD;AACxD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CACxC,CAAC,CAAC,MAAM,EAAE,EACV,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAClC,CAAC;AAGF;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAe;IACrD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AAC1B,CAAC"}