@pome-sh/cli 0.1.0 → 0.2.0

package/node_modules/@pome-sh/sdk/node_modules/@pome-sh/shared-types/dist/recorder-events.d.ts

@@ -0,0 +1,418 @@
+/**
+ * recorder-events — twin runtime trace format
+ *
+ * Single source of truth for the per-request event a twin runtime emits into
+ * its recorder ring buffer. Consumed by:
+ *   - twin runtimes (`@pome-sh/twin-github`, `@pome-sh/twin-stripe`) — emit shape
+ *   - `@pome-sh/sdk` — read shape for post-run analysis
+ *   - `pome-cloud` correlator — input to trace correlation on ingest
+ *   - `pome-cloud` recorder writers — persisted shape for events.jsonl S3 blob
+ *
+ * v1.0 freeze of the twin runtime trace format. Breaking changes go through a
+ * documented deprecation policy.
+ */
+import { z } from "zod";
+export declare const KNOWN_TWIN_IDS: readonly ["github", "stripe", "slack"];
+export type KnownTwinId = (typeof KNOWN_TWIN_IDS)[number];
+export declare const twinIdSchema: z.ZodString;
+export type TwinId = z.infer<typeof twinIdSchema>;
+export declare const recorderFidelitySchema: z.ZodEnum<{
+    semantic: "semantic";
+    unsupported: "unsupported";
+}>;
+export type RecorderFidelity = z.infer<typeof recorderFidelitySchema>;
+export declare const stateDeltaSchema: z.ZodNullable<z.ZodObject<{
+    before: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    after: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>>;
+export type StateDelta = z.infer<typeof stateDeltaSchema>;
+export declare const recorderEventSchema: z.ZodPipe<z.ZodObject<{
+    ts: z.ZodString;
+    run_id: z.ZodString;
+    twin: z.ZodString;
+    request_id: z.ZodString;
+    correlation_id: z.ZodOptional<z.ZodString>;
+    task_step_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    scenario_step_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    step_id: z.ZodNullable<z.ZodString>;
+    tool_call_id: z.ZodNullable<z.ZodString>;
+    method: z.ZodString;
+    path: z.ZodString;
+    request_body: z.ZodUnknown;
+    status: z.ZodNumber;
+    response_body: z.ZodUnknown;
+    latency_ms: z.ZodNumber;
+    fidelity: z.ZodEnum<{
+        semantic: "semantic";
+        unsupported: "unsupported";
+    }>;
+    state_mutation: z.ZodBoolean;
+    state_delta: z.ZodNullable<z.ZodObject<{
+        before: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        after: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    idempotency_dedupe: z.ZodOptional<z.ZodBoolean>;
+    error: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>, z.ZodTransform<{
+    ts: string;
+    run_id: string;
+    twin: string;
+    request_id: string;
+    step_id: string | null;
+    tool_call_id: string | null;
+    method: string;
+    path: string;
+    request_body: unknown;
+    status: number;
+    response_body: unknown;
+    latency_ms: number;
+    fidelity: "semantic" | "unsupported";
+    state_mutation: boolean;
+    state_delta: {
+        before: Record<string, unknown> | null;
+        after: Record<string, unknown> | null;
+    } | null;
+    error: string | null;
+    correlation_id?: string | undefined;
+    task_step_id?: string | null | undefined;
+    scenario_step_id?: string | null | undefined;
+    idempotency_dedupe?: boolean | undefined;
+}, {
+    ts: string;
+    run_id: string;
+    twin: string;
+    request_id: string;
+    step_id: string | null;
+    tool_call_id: string | null;
+    method: string;
+    path: string;
+    request_body: unknown;
+    status: number;
+    response_body: unknown;
+    latency_ms: number;
+    fidelity: "semantic" | "unsupported";
+    state_mutation: boolean;
+    state_delta: {
+        before: Record<string, unknown> | null;
+        after: Record<string, unknown> | null;
+    } | null;
+    error: string | null;
+    correlation_id?: string | undefined;
+    task_step_id?: string | null | undefined;
+    scenario_step_id?: string | null | undefined;
+    idempotency_dedupe?: boolean | undefined;
+}>>;
+export type RecorderEvent = z.infer<typeof recorderEventSchema>;
+export declare const twinHttpEventSchema: z.ZodObject<{
+    ts: z.ZodString;
+    run_id: z.ZodString;
+    twin: z.ZodString;
+    request_id: z.ZodString;
+    correlation_id: z.ZodOptional<z.ZodString>;
+    task_step_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    scenario_step_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    step_id: z.ZodNullable<z.ZodString>;
+    tool_call_id: z.ZodNullable<z.ZodString>;
+    method: z.ZodString;
+    path: z.ZodString;
+    request_body: z.ZodUnknown;
+    status: z.ZodNumber;
+    response_body: z.ZodUnknown;
+    latency_ms: z.ZodNumber;
+    fidelity: z.ZodEnum<{
+        semantic: "semantic";
+        unsupported: "unsupported";
+    }>;
+    state_mutation: z.ZodBoolean;
+    state_delta: z.ZodNullable<z.ZodObject<{
+        before: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        after: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    idempotency_dedupe: z.ZodOptional<z.ZodBoolean>;
+    error: z.ZodNullable<z.ZodString>;
+    kind: z.ZodLiteral<"TwinHttpEvent">;
+    event_id: z.ZodString;
+    parent_id: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type TwinHttpEvent = z.infer<typeof twinHttpEventSchema>;
+export declare const llmCallEventSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"LlmCallEvent">;
+    host: z.ZodString;
+    port: z.ZodNumber;
+    latency_ms: z.ZodNumber;
+    bytes_in: z.ZodNumber;
+    bytes_out: z.ZodNumber;
+    url: z.ZodNullable<z.ZodString>;
+    method: z.ZodNullable<z.ZodString>;
+    status: z.ZodNullable<z.ZodNumber>;
+    model: z.ZodNullable<z.ZodString>;
+    prompt_tokens: z.ZodNullable<z.ZodNumber>;
+    completion_tokens: z.ZodNullable<z.ZodNumber>;
+    cost_usd: z.ZodNullable<z.ZodNumber>;
+    ts: z.ZodString;
+    event_id: z.ZodString;
+    parent_id: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type LlmCallEvent = z.infer<typeof llmCallEventSchema>;
+export declare const toolUseEventSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"ToolUseEvent">;
+    tool_use_id: z.ZodString;
+    tool_name: z.ZodString;
+    input: z.ZodUnknown;
+    ts: z.ZodString;
+    event_id: z.ZodString;
+    parent_id: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type ToolUseEvent = z.infer<typeof toolUseEventSchema>;
+export declare const toolResultEventSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"ToolResultEvent">;
+    tool_use_id: z.ZodString;
+    output: z.ZodUnknown;
+    is_error: z.ZodBoolean;
+    ts: z.ZodString;
+    event_id: z.ZodString;
+    parent_id: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type ToolResultEvent = z.infer<typeof toolResultEventSchema>;
+export declare const subagentSpawnEventSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"SubagentSpawnEvent">;
+    parent_tool_use_id: z.ZodString;
+    ts: z.ZodString;
+    event_id: z.ZodString;
+    parent_id: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type SubagentSpawnEvent = z.infer<typeof subagentSpawnEventSchema>;
+export declare const hookEventSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"HookEvent">;
+    hook_name: z.ZodString;
+    tool_name: z.ZodNullable<z.ZodString>;
+    ts: z.ZodString;
+    event_id: z.ZodString;
+    parent_id: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type HookEvent = z.infer<typeof hookEventSchema>;
+export declare const eventSchema: z.ZodPipe<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    ts: z.ZodString;
+    run_id: z.ZodString;
+    twin: z.ZodString;
+    request_id: z.ZodString;
+    correlation_id: z.ZodOptional<z.ZodString>;
+    task_step_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    scenario_step_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    step_id: z.ZodNullable<z.ZodString>;
+    tool_call_id: z.ZodNullable<z.ZodString>;
+    method: z.ZodString;
+    path: z.ZodString;
+    request_body: z.ZodUnknown;
+    status: z.ZodNumber;
+    response_body: z.ZodUnknown;
+    latency_ms: z.ZodNumber;
+    fidelity: z.ZodEnum<{
+        semantic: "semantic";
+        unsupported: "unsupported";
+    }>;
+    state_mutation: z.ZodBoolean;
+    state_delta: z.ZodNullable<z.ZodObject<{
+        before: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        after: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    idempotency_dedupe: z.ZodOptional<z.ZodBoolean>;
+    error: z.ZodNullable<z.ZodString>;
+    kind: z.ZodLiteral<"TwinHttpEvent">;
+    event_id: z.ZodString;
+    parent_id: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"LlmCallEvent">;
+    host: z.ZodString;
+    port: z.ZodNumber;
+    latency_ms: z.ZodNumber;
+    bytes_in: z.ZodNumber;
+    bytes_out: z.ZodNumber;
+    url: z.ZodNullable<z.ZodString>;
+    method: z.ZodNullable<z.ZodString>;
+    status: z.ZodNullable<z.ZodNumber>;
+    model: z.ZodNullable<z.ZodString>;
+    prompt_tokens: z.ZodNullable<z.ZodNumber>;
+    completion_tokens: z.ZodNullable<z.ZodNumber>;
+    cost_usd: z.ZodNullable<z.ZodNumber>;
+    ts: z.ZodString;
+    event_id: z.ZodString;
+    parent_id: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"ToolUseEvent">;
+    tool_use_id: z.ZodString;
+    tool_name: z.ZodString;
+    input: z.ZodUnknown;
+    ts: z.ZodString;
+    event_id: z.ZodString;
+    parent_id: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"ToolResultEvent">;
+    tool_use_id: z.ZodString;
+    output: z.ZodUnknown;
+    is_error: z.ZodBoolean;
+    ts: z.ZodString;
+    event_id: z.ZodString;
+    parent_id: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"SubagentSpawnEvent">;
+    parent_tool_use_id: z.ZodString;
+    ts: z.ZodString;
+    event_id: z.ZodString;
+    parent_id: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"HookEvent">;
+    hook_name: z.ZodString;
+    tool_name: z.ZodNullable<z.ZodString>;
+    ts: z.ZodString;
+    event_id: z.ZodString;
+    parent_id: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>], "kind">, z.ZodTransform<{
+    ts: string;
+    run_id: string;
+    twin: string;
+    request_id: string;
+    step_id: string | null;
+    tool_call_id: string | null;
+    method: string;
+    path: string;
+    request_body: unknown;
+    status: number;
+    response_body: unknown;
+    latency_ms: number;
+    fidelity: "semantic" | "unsupported";
+    state_mutation: boolean;
+    state_delta: {
+        before: Record<string, unknown> | null;
+        after: Record<string, unknown> | null;
+    } | null;
+    error: string | null;
+    kind: "TwinHttpEvent";
+    event_id: string;
+    parent_id: string | null;
+    correlation_id?: string | undefined;
+    task_step_id?: string | null | undefined;
+    scenario_step_id?: string | null | undefined;
+    idempotency_dedupe?: boolean | undefined;
+} | {
+    kind: "LlmCallEvent";
+    host: string;
+    port: number;
+    latency_ms: number;
+    bytes_in: number;
+    bytes_out: number;
+    url: string | null;
+    method: string | null;
+    status: number | null;
+    model: string | null;
+    prompt_tokens: number | null;
+    completion_tokens: number | null;
+    cost_usd: number | null;
+    ts: string;
+    event_id: string;
+    parent_id: string | null;
+} | {
+    kind: "ToolUseEvent";
+    tool_use_id: string;
+    tool_name: string;
+    input: unknown;
+    ts: string;
+    event_id: string;
+    parent_id: string | null;
+} | {
+    kind: "ToolResultEvent";
+    tool_use_id: string;
+    output: unknown;
+    is_error: boolean;
+    ts: string;
+    event_id: string;
+    parent_id: string | null;
+} | {
+    kind: "SubagentSpawnEvent";
+    parent_tool_use_id: string;
+    ts: string;
+    event_id: string;
+    parent_id: string | null;
+} | {
+    kind: "HookEvent";
+    hook_name: string;
+    tool_name: string | null;
+    ts: string;
+    event_id: string;
+    parent_id: string | null;
+}, {
+    ts: string;
+    run_id: string;
+    twin: string;
+    request_id: string;
+    step_id: string | null;
+    tool_call_id: string | null;
+    method: string;
+    path: string;
+    request_body: unknown;
+    status: number;
+    response_body: unknown;
+    latency_ms: number;
+    fidelity: "semantic" | "unsupported";
+    state_mutation: boolean;
+    state_delta: {
+        before: Record<string, unknown> | null;
+        after: Record<string, unknown> | null;
+    } | null;
+    error: string | null;
+    kind: "TwinHttpEvent";
+    event_id: string;
+    parent_id: string | null;
+    correlation_id?: string | undefined;
+    task_step_id?: string | null | undefined;
+    scenario_step_id?: string | null | undefined;
+    idempotency_dedupe?: boolean | undefined;
+} | {
+    kind: "LlmCallEvent";
+    host: string;
+    port: number;
+    latency_ms: number;
+    bytes_in: number;
+    bytes_out: number;
+    url: string | null;
+    method: string | null;
+    status: number | null;
+    model: string | null;
+    prompt_tokens: number | null;
+    completion_tokens: number | null;
+    cost_usd: number | null;
+    ts: string;
+    event_id: string;
+    parent_id: string | null;
+} | {
+    kind: "ToolUseEvent";
+    tool_use_id: string;
+    tool_name: string;
+    input: unknown;
+    ts: string;
+    event_id: string;
+    parent_id: string | null;
+} | {
+    kind: "ToolResultEvent";
+    tool_use_id: string;
+    output: unknown;
+    is_error: boolean;
+    ts: string;
+    event_id: string;
+    parent_id: string | null;
+} | {
+    kind: "SubagentSpawnEvent";
+    parent_tool_use_id: string;
+    ts: string;
+    event_id: string;
+    parent_id: string | null;
+} | {
+    kind: "HookEvent";
+    hook_name: string;
+    tool_name: string | null;
+    ts: string;
+    event_id: string;
+    parent_id: string | null;
+}>>;
+export type Event = z.infer<typeof eventSchema>;
+export declare function isLegacyEventRow(row: unknown): boolean;

package/node_modules/@pome-sh/sdk/node_modules/@pome-sh/shared-types/dist/recorder-events.js

@@ -0,0 +1,234 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * recorder-events — twin runtime trace format
+ *
+ * Single source of truth for the per-request event a twin runtime emits into
+ * its recorder ring buffer. Consumed by:
+ *   - twin runtimes (`@pome-sh/twin-github`, `@pome-sh/twin-stripe`) — emit shape
+ *   - `@pome-sh/sdk` — read shape for post-run analysis
+ *   - `pome-cloud` correlator — input to trace correlation on ingest
+ *   - `pome-cloud` recorder writers — persisted shape for events.jsonl S3 blob
+ *
+ * v1.0 freeze of the twin runtime trace format. Breaking changes go through a
+ * documented deprecation policy.
+ */
+import { z } from "zod";
+// `twin` is an open string at the schema level so SDK-based community twins
+// can set their own id without forcing a shared-types schema bump. Dashboard
+// rendering pattern-matches against `KNOWN_TWIN_IDS` and falls back to
+// generic rendering for unknown values — losing a recording to parse failure
+// would be worse than rendering it generically. First-party twins SHOULD use
+// the canonical values for type-aware UI.
+export const KNOWN_TWIN_IDS = ["github", "stripe", "slack"];
+export const twinIdSchema = z.string().min(1);
+export const recorderFidelitySchema = z.enum(["semantic", "unsupported"]);
+// stateDelta captures the row-level before/after for a mutation. State-inspector
+// renders these as a key/value diff. `before: null` = row was inserted (no prior
+// state); `after: null` = row was deleted. Parent `null` = no mutation (read-only
+// call — should also have `state_mutation: false`). Per-twin types are NOT
+// enforced — each twin owns its row shape, and forcing a strong type here would
+// couple shared-types to twin schemas.
+export const stateDeltaSchema = z
+    .object({
+    before: z.record(z.string(), z.unknown()).nullable(),
+    after: z.record(z.string(), z.unknown()).nullable(),
+})
+    .nullable();
+// ─────────────────────────────────────────────────────────────────────────────
+// Legacy single-shape recorder event (pre-FDRS-398).
+//
+// Kept exported as-is for the 58 callers across twin runtimes, SDK, correlator,
+// CLI, and cloud control plane that still emit/consume this shape on disk.
+// Their migration to the unified discriminated-union `eventSchema` below is
+// owned by downstream M0 tickets (FDRS-402 / 403 / 412 / 415 / 417).
+// `isLegacyEventRow` lets readers detect this shape during the rollout.
+// ─────────────────────────────────────────────────────────────────────────────
+// Internal plain-object shape. Kept as a `ZodObject` so `twinHttpEventSchema`
+// can `.extend` it and stay a discriminated-union member; the exported
+// `recorderEventSchema` wraps it with the FDRS-653 task-vocab normalization.
+const recorderEventObjectSchema = z.object({
+    ts: z.string().datetime(),
+    run_id: z.string().min(1),
+    twin: twinIdSchema,
+    request_id: z.string().min(1),
+    correlation_id: z.string().min(1).optional(),
+    // task_step_id is set by the task author in .yaml (static expectation:
+    // "this HTTP call is expected at step 2"). step_id below is set post-hoc by
+    // the correlator (dynamic grouping: "this event landed in Step stp_xyz").
+    // 90% of events use only one; both can coexist.
+    //
+    // W3 vocab (FDRS-653): `task_step_id` is canonical; `scenario_step_id` is
+    // the 0.3.0-era spelling. BOTH stay in the schema for the tolerant-reader
+    // window — this row shape is the frozen v1 trace format and its emitters
+    // (twin runtimes, shipped CLIs on vendored 0.3.0) still write the old key.
+    // The exported reader schemas normalize: when only `scenario_step_id` is
+    // present, `task_step_id` is populated from it at parse time. New emitters
+    // write `task_step_id`.
+    task_step_id: z.string().min(1).nullable().optional(),
+    scenario_step_id: z.string().min(1).nullable().optional(),
+    step_id: z.string().nullable(),
+    // tool_call_id is set by the `@pome-sh/adapter-claude-sdk` adapter when active.
+    // Null for the heuristic-correlator path (no adapter signal available).
+    tool_call_id: z.string().nullable(),
+    method: z.string().min(1),
+    path: z.string(),
+    request_body: z.unknown(),
+    status: z.number().int(),
+    response_body: z.unknown(),
+    latency_ms: z.number().int().min(0),
+    fidelity: recorderFidelitySchema,
+    state_mutation: z.boolean(),
+    state_delta: stateDeltaSchema,
+    // True iff the twin's idempotency layer replayed a cached response without
+    // re-invoking the handler. Optional + additive so existing recordings parse
+    // unchanged; dashboards/SDKs can render dedupe hits distinctly without
+    // inferring from request_body. Absent on the original mutation, present and
+    // true on the replayed event.
+    idempotency_dedupe: z.boolean().optional(),
+    error: z.string().nullable(),
+});
+// FDRS-653 tolerant reader: populate the canonical `task_step_id` from the
+// 0.3.0-era `scenario_step_id` when only the old key was written. The old key
+// is preserved as-sent (additive normalization — a re-serialized row still
+// parses under a 0.3.0 reader, which treats both keys as optional).
+function normalizeTaskStepVocab(event) {
+    if (event.task_step_id == null && event.scenario_step_id != null) {
+        return { ...event, task_step_id: event.scenario_step_id };
+    }
+    return event;
+}
+export const recorderEventSchema = recorderEventObjectSchema.transform(normalizeTaskStepVocab);
+// ─────────────────────────────────────────────────────────────────────────────
+// FDRS-398 — unified events.jsonl discriminated-union schema (v1).
+//
+// Hard-cut from the legacy single-shape `RecorderEvent`. The on-disk row is
+// now a tagged union over `kind`. Every variant carries:
+//   - `event_id`  — unique row id (uuid/nanoid, set by emitter)
+//   - `parent_id` — points at the spawning row's `event_id`, or null at the
+//                   root of a parent chain (e.g. top-level twin HTTP calls,
+//                   the first LLM call in a turn).
+//   - `kind`      — the discriminator literal (see each schema below)
+//
+// Provenance:
+//   - PR/FAQ: linear.app/pome-sh/project/agent-trace-v1-af8924d607f0
+//   - Milestone M0 "Universal Floor"
+//   - /plan-eng-review 2026-05-26 amendments:
+//       • Dropped OtelSpanEvent from this frozen v1 union (FDRS-400 cancelled).
+//         It later shipped additively (FDRS-480): the schema + mapper live in
+//         `./otel/` and are composed into `otelEventSchema` (= eventSchema ∪
+//         OtelSpanEvent). This v1 union is intentionally left unchanged.
+//       • LlmCallEvent per-call token/model/cost reclassified
+//         "TLS-terminate-only" — they are `nullable()` across both baseline
+//         CONNECT-tunnel mode AND CAS adapter mode in v1. CAS surfaces those
+//         at the per-turn aggregate level on the run summary, NOT here.
+// ─────────────────────────────────────────────────────────────────────────────
+// Common fields on every event variant. Spread (not extend) so the resulting
+// Zod object types stay readable.
+const eventBaseShape = {
+    ts: z.string().datetime(),
+    event_id: z.string().min(1),
+    parent_id: z.string().min(1).nullable(),
+};
+// `TwinHttpEvent` is the legacy RecorderEvent shape extended with the union
+// discriminator + parent-chain fields. `extend` keeps it in lockstep with
+// the RecorderEvent object shape so updates to the underlying HTTP-call shape
+// flow through automatically. NOTE: as a discriminated-union member this stays
+// a plain `ZodObject` — the FDRS-653 task-vocab normalization is applied by
+// the exported `recorderEventSchema` / `eventSchema` readers, not here.
+export const twinHttpEventSchema = recorderEventObjectSchema.extend({
+    kind: z.literal("TwinHttpEvent"),
+    event_id: z.string().min(1),
+    parent_id: z.string().min(1).nullable(),
+});
+// `LlmCallEvent` baseline fields are populated by the HTTP_PROXY CONNECT
+// tunnel `pome capture-server` (M0). TLS-terminate-only fields stay null in
+// baseline mode and in CAS adapter mode; they get populated only by the v2
+// opt-in TLS-terminate proxy. Per-turn aggregate cost/model from CAS lives
+// on the run summary, not on individual LlmCallEvent rows.
+export const llmCallEventSchema = z.object({
+    ...eventBaseShape,
+    kind: z.literal("LlmCallEvent"),
+    // Baseline (always populated)
+    host: z.string().min(1),
+    port: z.number().int().min(1).max(65535),
+    latency_ms: z.number().int().min(0),
+    bytes_in: z.number().int().min(0),
+    bytes_out: z.number().int().min(0),
+    // TLS-terminate-only — nullable, not optional. Writers must emit explicit
+    // null in baseline/CAS mode so the on-disk JSON shape is stable.
+    url: z.string().nullable(),
+    method: z.string().nullable(),
+    status: z.number().int().nullable(),
+    model: z.string().nullable(),
+    prompt_tokens: z.number().int().min(0).nullable(),
+    completion_tokens: z.number().int().min(0).nullable(),
+    cost_usd: z.number().nullable(),
+});
+// `ToolUseEvent` — emitted by the CAS adapter (FDRS-408) for each tool_use
+// content block in an `SDKAssistantMessage`. `input` is opaque (already
+// redactor-scrubbed by the writer) so we type it as `unknown`.
+export const toolUseEventSchema = z.object({
+    ...eventBaseShape,
+    kind: z.literal("ToolUseEvent"),
+    tool_use_id: z.string().min(1),
+    tool_name: z.string().min(1),
+    input: z.unknown(),
+});
+// `ToolResultEvent` — emitted by the CAS adapter (FDRS-408) for each
+// tool_result content block in a user message. `tool_use_id` matches the
+// originating `ToolUseEvent.tool_use_id`; `parent_id` typically points at
+// that ToolUseEvent's `event_id`.
+export const toolResultEventSchema = z.object({
+    ...eventBaseShape,
+    kind: z.literal("ToolResultEvent"),
+    tool_use_id: z.string().min(1),
+    output: z.unknown(),
+    is_error: z.boolean(),
+});
+// `SubagentSpawnEvent` — emitted once per sub-agent (FDRS-409), the first
+// time the adapter sees a non-null `parent_tool_use_id` on an
+// `SDKAssistantMessage`.
+export const subagentSpawnEventSchema = z.object({
+    ...eventBaseShape,
+    kind: z.literal("SubagentSpawnEvent"),
+    parent_tool_use_id: z.string().min(1),
+});
+// `HookEvent` — thin audit-trail row written by the adapter for each of the
+// SDK's 25 hook invocations (FDRS-407). `tool_name` is null when the hook
+// isn't tool-scoped (e.g. SessionStarted, PreCompact, PermissionGranted on a
+// non-tool resource).
+export const hookEventSchema = z.object({
+    ...eventBaseShape,
+    kind: z.literal("HookEvent"),
+    hook_name: z.string().min(1),
+    tool_name: z.string().min(1).nullable(),
+});
+// The unified event row. Discriminated on `kind` — adding a future variant
+// (e.g. `OtelSpanEvent` in v2) is a non-breaking extension. The exported
+// reader applies the FDRS-653 task-vocab normalization to `TwinHttpEvent`
+// rows (the only variant carrying the step-expectation key).
+const eventUnionSchema = z.discriminatedUnion("kind", [
+    twinHttpEventSchema,
+    llmCallEventSchema,
+    toolUseEventSchema,
+    toolResultEventSchema,
+    subagentSpawnEventSchema,
+    hookEventSchema,
+]);
+export const eventSchema = eventUnionSchema.transform((event) => event.kind === "TwinHttpEvent" ? normalizeTaskStepVocab(event) : event);
+// Detect a pre-FDRS-398 legacy row on disk. A new-shape row always carries a
+// string `kind` discriminator; a legacy row does not. Non-object inputs
+// (`null`, arrays, primitives) are not event rows at all — return false so
+// the caller surfaces the underlying type error rather than treating them as
+// legacy.
+//
+// A row whose `kind` is present but not a string also routes through the
+// legacy path: the discriminated union will reject it with a clear error,
+// which is more useful than silently treating it as new-shape.
+export function isLegacyEventRow(row) {
+    if (typeof row !== "object" || row === null || Array.isArray(row)) {
+        return false;
+    }
+    return typeof row.kind !== "string";
+}
+//# sourceMappingURL=recorder-events.js.map

package/node_modules/@pome-sh/sdk/node_modules/@pome-sh/shared-types/dist/recorder-events.js.map

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

package/node_modules/@pome-sh/sdk/node_modules/@pome-sh/shared-types/dist/redaction.d.ts

@@ -0,0 +1,2 @@
+export declare function redactSecrets(value: unknown): unknown;
+export declare function redactEvent<T>(event: T): T;