@relayfx/sdk 0.7.2 → 0.7.4

package/dist/types/schema/execution-analytics-schema.d.ts

@@ -0,0 +1,507 @@
+import { Schema } from "effect";
+export declare const ModelCallPurpose: Schema.Literals<readonly ["conversation", "structured-output", "compaction-summary"]>;
+export declare const ModelFailureCategory: Schema.Literals<readonly ["authentication", "rate-limit", "transport", "provider-response", "stream-decode", "context-overflow", "invalid-tool-call", "token-budget", "timeout", "cancellation", "unknown"]>;
+export declare const ModelFailureClassification: Schema.Literals<readonly ["transient", "terminal"]>;
+export declare const ModelRetryReason: Schema.Literals<readonly ["provider-resilience", "invalid-tool-call-correction"]>;
+export declare const ModelFirstOutputKind: Schema.Literals<readonly ["reasoning", "text", "tool-call"]>;
+export declare const ModelFinishReason: Schema.Literals<readonly ["stop", "length", "content-filter", "tool-calls", "error", "pause", "other", "unknown"]>;
+export declare const CompactionTrigger: Schema.Literals<readonly ["threshold", "overflow"]>;
+export declare const CompactionKind: Schema.Literals<readonly ["microcompact", "summarize", "unchanged"]>;
+export declare const ModelUsage: Schema.Struct<{
+    readonly input_tokens: Schema.NullOr<Schema.Int>;
+    readonly input_tokens_uncached: Schema.NullOr<Schema.Int>;
+    readonly input_tokens_cache_read: Schema.NullOr<Schema.Int>;
+    readonly input_tokens_cache_write: Schema.NullOr<Schema.Int>;
+    readonly output_tokens: Schema.NullOr<Schema.Int>;
+    readonly output_tokens_reasoning: Schema.NullOr<Schema.Int>;
+    readonly output_tokens_text: Schema.optionalKey<Schema.NullOr<Schema.Int>>;
+}>;
+export interface ModelUsage extends Schema.Schema.Type<typeof ModelUsage> {
+}
+export declare const ModelCallStartedEventData: Schema.Struct<{
+    readonly telemetry_session_id: Schema.optionalKey<Schema.String>;
+    readonly delivery_id: Schema.optionalKey<Schema.String>;
+    readonly turn: Schema.Int;
+    readonly model_call_id: Schema.String;
+    readonly purpose: Schema.Literals<readonly ["conversation", "structured-output", "compaction-summary"]>;
+    readonly provider: Schema.optionalKey<Schema.String>;
+    readonly model: Schema.optionalKey<Schema.String>;
+    readonly compaction_id: Schema.optionalKey<Schema.String>;
+    readonly started_at: Schema.Int;
+}>;
+export declare const ModelAttemptStartedEventData: Schema.Struct<{
+    readonly telemetry_session_id: Schema.optionalKey<Schema.String>;
+    readonly delivery_id: Schema.optionalKey<Schema.String>;
+    readonly turn: Schema.Int;
+    readonly model_call_id: Schema.String;
+    readonly model_attempt_id: Schema.String;
+    readonly attempt: Schema.Int;
+    readonly started_at: Schema.Int;
+}>;
+export declare const ModelAttemptFirstOutputEventData: Schema.Struct<{
+    readonly telemetry_session_id: Schema.optionalKey<Schema.String>;
+    readonly delivery_id: Schema.optionalKey<Schema.String>;
+    readonly turn: Schema.Int;
+    readonly model_call_id: Schema.String;
+    readonly model_attempt_id: Schema.String;
+    readonly attempt: Schema.Int;
+    readonly kind: Schema.Literals<readonly ["reasoning", "text", "tool-call"]>;
+    readonly at: Schema.Int;
+}>;
+export declare const ModelAttemptCompletedEventData: Schema.Struct<{
+    readonly telemetry_session_id: Schema.optionalKey<Schema.String>;
+    readonly delivery_id: Schema.optionalKey<Schema.String>;
+    readonly turn: Schema.Int;
+    readonly model_call_id: Schema.String;
+    readonly model_attempt_id: Schema.String;
+    readonly attempt: Schema.Int;
+    readonly completed_at: Schema.Int;
+    readonly usage: Schema.optionalKey<Schema.Struct<{
+        readonly input_tokens: Schema.NullOr<Schema.Int>;
+        readonly input_tokens_uncached: Schema.NullOr<Schema.Int>;
+        readonly input_tokens_cache_read: Schema.NullOr<Schema.Int>;
+        readonly input_tokens_cache_write: Schema.NullOr<Schema.Int>;
+        readonly output_tokens: Schema.NullOr<Schema.Int>;
+        readonly output_tokens_reasoning: Schema.NullOr<Schema.Int>;
+        readonly output_tokens_text: Schema.optionalKey<Schema.NullOr<Schema.Int>>;
+    }>>;
+    readonly usage_at: Schema.optionalKey<Schema.Int>;
+    readonly finish_reason: Schema.optionalKey<Schema.Literals<readonly ["stop", "length", "content-filter", "tool-calls", "error", "pause", "other", "unknown"]>>;
+    readonly request_id: Schema.optionalKey<Schema.String>;
+    readonly response_model: Schema.optionalKey<Schema.String>;
+    readonly service_tier: Schema.optionalKey<Schema.String>;
+    readonly cost: Schema.optionalKey<Schema.Struct<{
+        readonly amount: Schema.Finite;
+        readonly currency: Schema.String;
+    }>>;
+}>;
+export declare const ModelAttemptFailedEventData: Schema.Struct<{
+    readonly telemetry_session_id: Schema.optionalKey<Schema.String>;
+    readonly delivery_id: Schema.optionalKey<Schema.String>;
+    readonly turn: Schema.Int;
+    readonly model_call_id: Schema.String;
+    readonly model_attempt_id: Schema.String;
+    readonly attempt: Schema.Int;
+    readonly failed_at: Schema.Int;
+    readonly category: Schema.Literals<readonly ["authentication", "rate-limit", "transport", "provider-response", "stream-decode", "context-overflow", "invalid-tool-call", "token-budget", "timeout", "cancellation", "unknown"]>;
+    readonly classification: Schema.Literals<readonly ["transient", "terminal"]>;
+}>;
+export declare const ModelRetryScheduledEventData: Schema.Struct<{
+    readonly telemetry_session_id: Schema.optionalKey<Schema.String>;
+    readonly delivery_id: Schema.optionalKey<Schema.String>;
+    readonly turn: Schema.Int;
+    readonly model_call_id: Schema.String;
+    readonly attempt: Schema.Int;
+    readonly reason: Schema.Literals<readonly ["provider-resilience", "invalid-tool-call-correction"]>;
+    readonly category: Schema.Literals<readonly ["authentication", "rate-limit", "transport", "provider-response", "stream-decode", "context-overflow", "invalid-tool-call", "token-budget", "timeout", "cancellation", "unknown"]>;
+    readonly delay_millis: Schema.Finite;
+    readonly at: Schema.Int;
+}>;
+export declare const ModelCallCompletedEventData: Schema.Struct<{
+    readonly telemetry_session_id: Schema.optionalKey<Schema.String>;
+    readonly delivery_id: Schema.optionalKey<Schema.String>;
+    readonly turn: Schema.Int;
+    readonly model_call_id: Schema.String;
+    readonly purpose: Schema.Literals<readonly ["conversation", "structured-output", "compaction-summary"]>;
+    readonly attempts: Schema.Int;
+    readonly completed_at: Schema.Int;
+    readonly usage: Schema.optionalKey<Schema.Struct<{
+        readonly input_tokens: Schema.NullOr<Schema.Int>;
+        readonly input_tokens_uncached: Schema.NullOr<Schema.Int>;
+        readonly input_tokens_cache_read: Schema.NullOr<Schema.Int>;
+        readonly input_tokens_cache_write: Schema.NullOr<Schema.Int>;
+        readonly output_tokens: Schema.NullOr<Schema.Int>;
+        readonly output_tokens_reasoning: Schema.NullOr<Schema.Int>;
+        readonly output_tokens_text: Schema.optionalKey<Schema.NullOr<Schema.Int>>;
+    }>>;
+    readonly finish_reason: Schema.optionalKey<Schema.Literals<readonly ["stop", "length", "content-filter", "tool-calls", "error", "pause", "other", "unknown"]>>;
+}>;
+export declare const ModelCallFailedEventData: Schema.Struct<{
+    readonly telemetry_session_id: Schema.optionalKey<Schema.String>;
+    readonly delivery_id: Schema.optionalKey<Schema.String>;
+    readonly turn: Schema.Int;
+    readonly model_call_id: Schema.String;
+    readonly purpose: Schema.Literals<readonly ["conversation", "structured-output", "compaction-summary"]>;
+    readonly attempts: Schema.Int;
+    readonly failed_at: Schema.Int;
+    readonly category: Schema.Literals<readonly ["authentication", "rate-limit", "transport", "provider-response", "stream-decode", "context-overflow", "invalid-tool-call", "token-budget", "timeout", "cancellation", "unknown"]>;
+}>;
+export declare const CompactionStartedEventData: Schema.Struct<{
+    readonly telemetry_session_id: Schema.optionalKey<Schema.String>;
+    readonly delivery_id: Schema.optionalKey<Schema.String>;
+    readonly turn: Schema.Int;
+    readonly compaction_id: Schema.String;
+    readonly trigger: Schema.Literals<readonly ["threshold", "overflow"]>;
+    readonly started_at: Schema.Int;
+    readonly context_tokens_before: Schema.optionalKey<Schema.Finite>;
+    readonly entries_before: Schema.optionalKey<Schema.Finite>;
+}>;
+export declare const CompactionCompletedEventData: Schema.Struct<{
+    readonly telemetry_session_id: Schema.optionalKey<Schema.String>;
+    readonly delivery_id: Schema.optionalKey<Schema.String>;
+    readonly turn: Schema.Int;
+    readonly compaction_id: Schema.String;
+    readonly kind: Schema.Literals<readonly ["microcompact", "summarize", "unchanged"]>;
+    readonly completed_at: Schema.Int;
+    readonly summary_model_call_id: Schema.optionalKey<Schema.String>;
+}>;
+export declare const CompactionFailedEventData: Schema.Struct<{
+    readonly telemetry_session_id: Schema.optionalKey<Schema.String>;
+    readonly delivery_id: Schema.optionalKey<Schema.String>;
+    readonly turn: Schema.Int;
+    readonly compaction_id: Schema.String;
+    readonly failed_at: Schema.Int;
+}>;
+export declare const CompactionCommittedEventData: Schema.Struct<{
+    readonly checkpoint_id: Schema.brand<Schema.String, "Relay.SessionEntryId"> & {
+        make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.SessionEntryId">;
+    };
+    readonly session_id: Schema.brand<Schema.String, "Relay.SessionId"> & {
+        make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.SessionId">;
+    };
+    readonly compaction_id: Schema.String;
+    readonly summary_model_call_id: Schema.optionalKey<Schema.String>;
+    readonly context_tokens_before: Schema.optionalKey<Schema.Finite>;
+    readonly context_tokens_after: Schema.optionalKey<Schema.Finite>;
+    readonly entries_before: Schema.optionalKey<Schema.Finite>;
+    readonly entries_after: Schema.optionalKey<Schema.Finite>;
+}>;
+export interface CompactionCommittedEventData extends Schema.Schema.Type<typeof CompactionCommittedEventData> {
+}
+export declare const ModelUsageReportedEventData: Schema.Struct<{
+    readonly input_tokens: Schema.NullOr<Schema.Int>;
+    readonly input_tokens_uncached: Schema.NullOr<Schema.Int>;
+    readonly input_tokens_cache_read: Schema.NullOr<Schema.Int>;
+    readonly input_tokens_cache_write: Schema.NullOr<Schema.Int>;
+    readonly output_tokens: Schema.NullOr<Schema.Int>;
+    readonly output_tokens_reasoning: Schema.NullOr<Schema.Int>;
+    readonly output_tokens_text: Schema.optionalKey<Schema.NullOr<Schema.Int>>;
+    readonly telemetry_session_id: Schema.optionalKey<Schema.String>;
+    readonly delivery_id: Schema.optionalKey<Schema.String>;
+    readonly turn: Schema.Int;
+    readonly model_call_id: Schema.String;
+    readonly model_attempt_id: Schema.String;
+    readonly attempt: Schema.Int;
+    readonly provider: Schema.String;
+    readonly model: Schema.String;
+    readonly model_snapshot: Schema.optionalKey<Schema.String>;
+    readonly service_tier: Schema.optionalKey<Schema.String>;
+    readonly finish_reason: Schema.optionalKey<Schema.Literals<readonly ["stop", "length", "content-filter", "tool-calls", "error", "pause", "other", "unknown"]>>;
+    readonly usage_at: Schema.Int;
+}>;
+export interface ModelUsageReportedEventData extends Schema.Schema.Type<typeof ModelUsageReportedEventData> {
+}
+export declare const AnalyticalExecutionEvent: Schema.Union<readonly [Schema.Struct<{
+    readonly id: Schema.brand<Schema.String, "Relay.EventId"> & {
+        make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.EventId">;
+    };
+    readonly execution_id: Schema.brand<Schema.String, "Relay.ExecutionId"> & {
+        make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.ExecutionId">;
+    };
+    readonly sequence: Schema.Int;
+    readonly cursor: Schema.String;
+    readonly created_at: Schema.Int;
+    readonly type: Schema.Literal<"model.call.started">;
+    readonly data: Schema.Struct<{
+        readonly telemetry_session_id: Schema.optionalKey<Schema.String>;
+        readonly delivery_id: Schema.optionalKey<Schema.String>;
+        readonly turn: Schema.Int;
+        readonly model_call_id: Schema.String;
+        readonly purpose: Schema.Literals<readonly ["conversation", "structured-output", "compaction-summary"]>;
+        readonly provider: Schema.optionalKey<Schema.String>;
+        readonly model: Schema.optionalKey<Schema.String>;
+        readonly compaction_id: Schema.optionalKey<Schema.String>;
+        readonly started_at: Schema.Int;
+    }>;
+}>, Schema.Struct<{
+    readonly id: Schema.brand<Schema.String, "Relay.EventId"> & {
+        make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.EventId">;
+    };
+    readonly execution_id: Schema.brand<Schema.String, "Relay.ExecutionId"> & {
+        make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.ExecutionId">;
+    };
+    readonly sequence: Schema.Int;
+    readonly cursor: Schema.String;
+    readonly created_at: Schema.Int;
+    readonly type: Schema.Literal<"model.attempt.started">;
+    readonly data: Schema.Struct<{
+        readonly telemetry_session_id: Schema.optionalKey<Schema.String>;
+        readonly delivery_id: Schema.optionalKey<Schema.String>;
+        readonly turn: Schema.Int;
+        readonly model_call_id: Schema.String;
+        readonly model_attempt_id: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly started_at: Schema.Int;
+    }>;
+}>, Schema.Struct<{
+    readonly id: Schema.brand<Schema.String, "Relay.EventId"> & {
+        make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.EventId">;
+    };
+    readonly execution_id: Schema.brand<Schema.String, "Relay.ExecutionId"> & {
+        make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.ExecutionId">;
+    };
+    readonly sequence: Schema.Int;
+    readonly cursor: Schema.String;
+    readonly created_at: Schema.Int;
+    readonly type: Schema.Literal<"model.attempt.first_output">;
+    readonly data: Schema.Struct<{
+        readonly telemetry_session_id: Schema.optionalKey<Schema.String>;
+        readonly delivery_id: Schema.optionalKey<Schema.String>;
+        readonly turn: Schema.Int;
+        readonly model_call_id: Schema.String;
+        readonly model_attempt_id: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly kind: Schema.Literals<readonly ["reasoning", "text", "tool-call"]>;
+        readonly at: Schema.Int;
+    }>;
+}>, Schema.Struct<{
+    readonly id: Schema.brand<Schema.String, "Relay.EventId"> & {
+        make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.EventId">;
+    };
+    readonly execution_id: Schema.brand<Schema.String, "Relay.ExecutionId"> & {
+        make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.ExecutionId">;
+    };
+    readonly sequence: Schema.Int;
+    readonly cursor: Schema.String;
+    readonly created_at: Schema.Int;
+    readonly type: Schema.Literal<"model.attempt.completed">;
+    readonly data: Schema.Struct<{
+        readonly telemetry_session_id: Schema.optionalKey<Schema.String>;
+        readonly delivery_id: Schema.optionalKey<Schema.String>;
+        readonly turn: Schema.Int;
+        readonly model_call_id: Schema.String;
+        readonly model_attempt_id: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly completed_at: Schema.Int;
+        readonly usage: Schema.optionalKey<Schema.Struct<{
+            readonly input_tokens: Schema.NullOr<Schema.Int>;
+            readonly input_tokens_uncached: Schema.NullOr<Schema.Int>;
+            readonly input_tokens_cache_read: Schema.NullOr<Schema.Int>;
+            readonly input_tokens_cache_write: Schema.NullOr<Schema.Int>;
+            readonly output_tokens: Schema.NullOr<Schema.Int>;
+            readonly output_tokens_reasoning: Schema.NullOr<Schema.Int>;
+            readonly output_tokens_text: Schema.optionalKey<Schema.NullOr<Schema.Int>>;
+        }>>;
+        readonly usage_at: Schema.optionalKey<Schema.Int>;
+        readonly finish_reason: Schema.optionalKey<Schema.Literals<readonly ["stop", "length", "content-filter", "tool-calls", "error", "pause", "other", "unknown"]>>;
+        readonly request_id: Schema.optionalKey<Schema.String>;
+        readonly response_model: Schema.optionalKey<Schema.String>;
+        readonly service_tier: Schema.optionalKey<Schema.String>;
+        readonly cost: Schema.optionalKey<Schema.Struct<{
+            readonly amount: Schema.Finite;
+            readonly currency: Schema.String;
+        }>>;
+    }>;
+}>, Schema.Struct<{
+    readonly id: Schema.brand<Schema.String, "Relay.EventId"> & {
+        make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.EventId">;
+    };
+    readonly execution_id: Schema.brand<Schema.String, "Relay.ExecutionId"> & {
+        make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.ExecutionId">;
+    };
+    readonly sequence: Schema.Int;
+    readonly cursor: Schema.String;
+    readonly created_at: Schema.Int;
+    readonly type: Schema.Literal<"model.attempt.failed">;
+    readonly data: Schema.Struct<{
+        readonly telemetry_session_id: Schema.optionalKey<Schema.String>;
+        readonly delivery_id: Schema.optionalKey<Schema.String>;
+        readonly turn: Schema.Int;
+        readonly model_call_id: Schema.String;
+        readonly model_attempt_id: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly failed_at: Schema.Int;
+        readonly category: Schema.Literals<readonly ["authentication", "rate-limit", "transport", "provider-response", "stream-decode", "context-overflow", "invalid-tool-call", "token-budget", "timeout", "cancellation", "unknown"]>;
+        readonly classification: Schema.Literals<readonly ["transient", "terminal"]>;
+    }>;
+}>, Schema.Struct<{
+    readonly id: Schema.brand<Schema.String, "Relay.EventId"> & {
+        make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.EventId">;
+    };
+    readonly execution_id: Schema.brand<Schema.String, "Relay.ExecutionId"> & {
+        make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.ExecutionId">;
+    };
+    readonly sequence: Schema.Int;
+    readonly cursor: Schema.String;
+    readonly created_at: Schema.Int;
+    readonly type: Schema.Literal<"model.retry.scheduled">;
+    readonly data: Schema.Struct<{
+        readonly telemetry_session_id: Schema.optionalKey<Schema.String>;
+        readonly delivery_id: Schema.optionalKey<Schema.String>;
+        readonly turn: Schema.Int;
+        readonly model_call_id: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly reason: Schema.Literals<readonly ["provider-resilience", "invalid-tool-call-correction"]>;
+        readonly category: Schema.Literals<readonly ["authentication", "rate-limit", "transport", "provider-response", "stream-decode", "context-overflow", "invalid-tool-call", "token-budget", "timeout", "cancellation", "unknown"]>;
+        readonly delay_millis: Schema.Finite;
+        readonly at: Schema.Int;
+    }>;
+}>, Schema.Struct<{
+    readonly id: Schema.brand<Schema.String, "Relay.EventId"> & {
+        make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.EventId">;
+    };
+    readonly execution_id: Schema.brand<Schema.String, "Relay.ExecutionId"> & {
+        make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.ExecutionId">;
+    };
+    readonly sequence: Schema.Int;
+    readonly cursor: Schema.String;
+    readonly created_at: Schema.Int;
+    readonly type: Schema.Literal<"model.call.completed">;
+    readonly data: Schema.Struct<{
+        readonly telemetry_session_id: Schema.optionalKey<Schema.String>;
+        readonly delivery_id: Schema.optionalKey<Schema.String>;
+        readonly turn: Schema.Int;
+        readonly model_call_id: Schema.String;
+        readonly purpose: Schema.Literals<readonly ["conversation", "structured-output", "compaction-summary"]>;
+        readonly attempts: Schema.Int;
+        readonly completed_at: Schema.Int;
+        readonly usage: Schema.optionalKey<Schema.Struct<{
+            readonly input_tokens: Schema.NullOr<Schema.Int>;
+            readonly input_tokens_uncached: Schema.NullOr<Schema.Int>;
+            readonly input_tokens_cache_read: Schema.NullOr<Schema.Int>;
+            readonly input_tokens_cache_write: Schema.NullOr<Schema.Int>;
+            readonly output_tokens: Schema.NullOr<Schema.Int>;
+            readonly output_tokens_reasoning: Schema.NullOr<Schema.Int>;
+            readonly output_tokens_text: Schema.optionalKey<Schema.NullOr<Schema.Int>>;
+        }>>;
+        readonly finish_reason: Schema.optionalKey<Schema.Literals<readonly ["stop", "length", "content-filter", "tool-calls", "error", "pause", "other", "unknown"]>>;
+    }>;
+}>, Schema.Struct<{
+    readonly id: Schema.brand<Schema.String, "Relay.EventId"> & {
+        make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.EventId">;
+    };
+    readonly execution_id: Schema.brand<Schema.String, "Relay.ExecutionId"> & {
+        make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.ExecutionId">;
+    };
+    readonly sequence: Schema.Int;
+    readonly cursor: Schema.String;
+    readonly created_at: Schema.Int;
+    readonly type: Schema.Literal<"model.call.failed">;
+    readonly data: Schema.Struct<{
+        readonly telemetry_session_id: Schema.optionalKey<Schema.String>;
+        readonly delivery_id: Schema.optionalKey<Schema.String>;
+        readonly turn: Schema.Int;
+        readonly model_call_id: Schema.String;
+        readonly purpose: Schema.Literals<readonly ["conversation", "structured-output", "compaction-summary"]>;
+        readonly attempts: Schema.Int;
+        readonly failed_at: Schema.Int;
+        readonly category: Schema.Literals<readonly ["authentication", "rate-limit", "transport", "provider-response", "stream-decode", "context-overflow", "invalid-tool-call", "token-budget", "timeout", "cancellation", "unknown"]>;
+    }>;
+}>, Schema.Struct<{
+    readonly id: Schema.brand<Schema.String, "Relay.EventId"> & {
+        make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.EventId">;
+    };
+    readonly execution_id: Schema.brand<Schema.String, "Relay.ExecutionId"> & {
+        make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.ExecutionId">;
+    };
+    readonly sequence: Schema.Int;
+    readonly cursor: Schema.String;
+    readonly created_at: Schema.Int;
+    readonly type: Schema.Literal<"agent.compaction.started">;
+    readonly data: Schema.Struct<{
+        readonly telemetry_session_id: Schema.optionalKey<Schema.String>;
+        readonly delivery_id: Schema.optionalKey<Schema.String>;
+        readonly turn: Schema.Int;
+        readonly compaction_id: Schema.String;
+        readonly trigger: Schema.Literals<readonly ["threshold", "overflow"]>;
+        readonly started_at: Schema.Int;
+        readonly context_tokens_before: Schema.optionalKey<Schema.Finite>;
+        readonly entries_before: Schema.optionalKey<Schema.Finite>;
+    }>;
+}>, Schema.Struct<{
+    readonly id: Schema.brand<Schema.String, "Relay.EventId"> & {
+        make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.EventId">;
+    };
+    readonly execution_id: Schema.brand<Schema.String, "Relay.ExecutionId"> & {
+        make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.ExecutionId">;
+    };
+    readonly sequence: Schema.Int;
+    readonly cursor: Schema.String;
+    readonly created_at: Schema.Int;
+    readonly type: Schema.Literal<"agent.compaction.completed">;
+    readonly data: Schema.Struct<{
+        readonly telemetry_session_id: Schema.optionalKey<Schema.String>;
+        readonly delivery_id: Schema.optionalKey<Schema.String>;
+        readonly turn: Schema.Int;
+        readonly compaction_id: Schema.String;
+        readonly kind: Schema.Literals<readonly ["microcompact", "summarize", "unchanged"]>;
+        readonly completed_at: Schema.Int;
+        readonly summary_model_call_id: Schema.optionalKey<Schema.String>;
+    }>;
+}>, Schema.Struct<{
+    readonly id: Schema.brand<Schema.String, "Relay.EventId"> & {
+        make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.EventId">;
+    };
+    readonly execution_id: Schema.brand<Schema.String, "Relay.ExecutionId"> & {
+        make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.ExecutionId">;
+    };
+    readonly sequence: Schema.Int;
+    readonly cursor: Schema.String;
+    readonly created_at: Schema.Int;
+    readonly type: Schema.Literal<"agent.compaction.failed">;
+    readonly data: Schema.Struct<{
+        readonly telemetry_session_id: Schema.optionalKey<Schema.String>;
+        readonly delivery_id: Schema.optionalKey<Schema.String>;
+        readonly turn: Schema.Int;
+        readonly compaction_id: Schema.String;
+        readonly failed_at: Schema.Int;
+    }>;
+}>, Schema.Struct<{
+    readonly id: Schema.brand<Schema.String, "Relay.EventId"> & {
+        make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.EventId">;
+    };
+    readonly execution_id: Schema.brand<Schema.String, "Relay.ExecutionId"> & {
+        make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.ExecutionId">;
+    };
+    readonly sequence: Schema.Int;
+    readonly cursor: Schema.String;
+    readonly created_at: Schema.Int;
+    readonly type: Schema.Literal<"agent.compaction.committed">;
+    readonly data: Schema.Struct<{
+        readonly checkpoint_id: Schema.brand<Schema.String, "Relay.SessionEntryId"> & {
+            make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.SessionEntryId">;
+        };
+        readonly session_id: Schema.brand<Schema.String, "Relay.SessionId"> & {
+            make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.SessionId">;
+        };
+        readonly compaction_id: Schema.String;
+        readonly summary_model_call_id: Schema.optionalKey<Schema.String>;
+        readonly context_tokens_before: Schema.optionalKey<Schema.Finite>;
+        readonly context_tokens_after: Schema.optionalKey<Schema.Finite>;
+        readonly entries_before: Schema.optionalKey<Schema.Finite>;
+        readonly entries_after: Schema.optionalKey<Schema.Finite>;
+    }>;
+}>, Schema.Struct<{
+    readonly id: Schema.brand<Schema.String, "Relay.EventId"> & {
+        make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.EventId">;
+    };
+    readonly execution_id: Schema.brand<Schema.String, "Relay.ExecutionId"> & {
+        make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.ExecutionId">;
+    };
+    readonly sequence: Schema.Int;
+    readonly cursor: Schema.String;
+    readonly created_at: Schema.Int;
+    readonly type: Schema.Literal<"model.usage.reported">;
+    readonly data: Schema.Struct<{
+        readonly input_tokens: Schema.NullOr<Schema.Int>;
+        readonly input_tokens_uncached: Schema.NullOr<Schema.Int>;
+        readonly input_tokens_cache_read: Schema.NullOr<Schema.Int>;
+        readonly input_tokens_cache_write: Schema.NullOr<Schema.Int>;
+        readonly output_tokens: Schema.NullOr<Schema.Int>;
+        readonly output_tokens_reasoning: Schema.NullOr<Schema.Int>;
+        readonly output_tokens_text: Schema.optionalKey<Schema.NullOr<Schema.Int>>;
+        readonly telemetry_session_id: Schema.optionalKey<Schema.String>;
+        readonly delivery_id: Schema.optionalKey<Schema.String>;
+        readonly turn: Schema.Int;
+        readonly model_call_id: Schema.String;
+        readonly model_attempt_id: Schema.String;
+        readonly attempt: Schema.Int;
+        readonly provider: Schema.String;
+        readonly model: Schema.String;
+        readonly model_snapshot: Schema.optionalKey<Schema.String>;
+        readonly service_tier: Schema.optionalKey<Schema.String>;
+        readonly finish_reason: Schema.optionalKey<Schema.Literals<readonly ["stop", "length", "content-filter", "tool-calls", "error", "pause", "other", "unknown"]>>;
+        readonly usage_at: Schema.Int;
+    }>;
+}>]>;
+export type AnalyticalExecutionEvent = typeof AnalyticalExecutionEvent.Type;

package/dist/types/schema/execution-schema.d.ts

@@ -1,8 +1,29 @@
 import { Schema } from "effect";
 import { Definition } from "./agent-schema";
 import { ChildExecutionId, ExecutionId } from "./ids-schema";
+export * from "./execution-analytics-schema";
 export declare const ExecutionStatus: Schema.Literals<readonly ["queued", "running", "waiting", "completed", "failed", "cancelled"]>;
 export type ExecutionStatus = typeof ExecutionStatus.Type;
+export declare const ExecutionOriginBuild: Schema.Struct<{
+    readonly name: Schema.String;
+    readonly version: Schema.optionalKey<Schema.String>;
+    readonly commit: Schema.optionalKey<Schema.String>;
+}>;
+export interface ExecutionOriginBuild extends Schema.Schema.Type<typeof ExecutionOriginBuild> {
+}
+export declare const ExecutionOrigin: Schema.Struct<{
+    readonly owner_kind: Schema.Literals<readonly ["service", "user", "workflow", "system"]>;
+    readonly owner: Schema.String;
+    readonly purpose: Schema.String;
+    readonly build: Schema.optionalKey<Schema.Struct<{
+        readonly name: Schema.String;
+        readonly version: Schema.optionalKey<Schema.String>;
+        readonly commit: Schema.optionalKey<Schema.String>;
+    }>>;
+}>;
+export interface ExecutionOrigin extends Schema.Schema.Type<typeof ExecutionOrigin> {
+}
+export declare const executionOriginMetadataKey = "relay_origin";
 export declare const Execution: Schema.Struct<{
     readonly id: Schema.brand<Schema.String, "Relay.ExecutionId"> & {
         make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.ExecutionId">;
@@ -51,7 +72,7 @@ export declare const Execution: Schema.Struct<{
         };
         readonly turn_policy?: import("./agent-schema").TurnPolicySnapshot;
         readonly tool_execution?: Schema.Struct.ReadonlySide<{
-            readonly concurrency: Schema.Finite;
+            readonly concurrency: Schema.Union<readonly [Schema.Finite, Schema.Literal<"unbounded">]>;
         }, "Encoded">;
         readonly compaction_policy?: {
             readonly context_window: number;
@@ -124,6 +145,16 @@ export declare const Execution: Schema.Struct<{
         };
     }, never, never>>;
     readonly agent_tool_input_schema_digests: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
+    readonly origin: Schema.optionalKey<Schema.Struct<{
+        readonly owner_kind: Schema.Literals<readonly ["service", "user", "workflow", "system"]>;
+        readonly owner: Schema.String;
+        readonly purpose: Schema.String;
+        readonly build: Schema.optionalKey<Schema.Struct<{
+            readonly name: Schema.String;
+            readonly version: Schema.optionalKey<Schema.String>;
+            readonly commit: Schema.optionalKey<Schema.String>;
+        }>>;
+    }>>;
     readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
     readonly created_at: Schema.Int;
     readonly updated_at: Schema.Int;
@@ -390,25 +421,8 @@ export declare const steeringMessageId: (input: {
     readonly kind: "steering" | "follow_up";
     readonly sequence: number;
 }) => string & import("effect/Brand").Brand<"Relay.SteeringMessageId">;
-export declare const ExecutionEventType: Schema.Literals<readonly ["execution.accepted", "execution.started", "execution.completed", "execution.failed", "execution.cancelled", "model.input.prepared", "model.output.delta", "model.reasoning.delta", "model.toolcall.delta", "model.output.completed", "model.usage.reported", "agent.compaction.started", "agent.compaction.committed", "budget.exceeded", "tool.call.requested", "tool.result.received", "tool.approval.requested", "tool.approval.resolved", "permission.ask.requested", "permission.ask.resolved", "steering.delivered", "state.updated", "state.deleted", "inbox.enqueued", "inbox.drained", "resident.created", "resident.destroyed", "envelope.accepted", "envelope.routed", "envelope.ready", "delivery.attempt", "wait.created", "wait.woken", "wait.timed_out", "wait.cancelled", "child_run.spawned", "child_run.event", "child_fan_out.created", "child_fan_out.member.admitted", "child_fan_out.member.terminal", "child_fan_out.terminal", "workspace.lease.planned", "workspace.lease.acquired", "workspace.suspended", "workspace.resumed", "workspace.snapshot.created", "workspace.lease.released", "workspace.lease.failed"]>;
+export declare const ExecutionEventType: Schema.Literals<readonly ["execution.accepted", "execution.started", "execution.completed", "execution.failed", "execution.cancelled", "model.input.prepared", "model.output.delta", "model.reasoning.delta", "model.toolcall.delta", "model.output.completed", "model.usage.reported", "model.call.started", "model.attempt.started", "model.attempt.first_output", "model.attempt.completed", "model.attempt.failed", "model.retry.scheduled", "model.call.completed", "model.call.failed", "agent.compaction.started", "agent.compaction.completed", "agent.compaction.failed", "agent.compaction.committed", "budget.exceeded", "tool.call.requested", "tool.result.received", "tool.approval.requested", "tool.approval.resolved", "permission.ask.requested", "permission.ask.resolved", "steering.delivered", "state.updated", "state.deleted", "inbox.enqueued", "inbox.drained", "resident.created", "resident.destroyed", "envelope.accepted", "envelope.routed", "envelope.ready", "delivery.attempt", "wait.created", "wait.woken", "wait.timed_out", "wait.cancelled", "child_run.spawned", "child_run.event", "child_fan_out.created", "child_fan_out.member.admitted", "child_fan_out.member.terminal", "child_fan_out.terminal", "workspace.lease.planned", "workspace.lease.acquired", "workspace.suspended", "workspace.resumed", "workspace.snapshot.created", "workspace.lease.released", "workspace.lease.failed"]>;
 export type ExecutionEventType = typeof ExecutionEventType.Type;
-export declare const CompactionStartedEventData: Schema.Struct<{
-    readonly turn: Schema.Finite;
-    readonly overflow: Schema.Boolean;
-}>;
-export interface CompactionStartedEventData extends Schema.Schema.Type<typeof CompactionStartedEventData> {
-}
-export declare const CompactionCommittedEventData: Schema.Struct<{
-    readonly checkpoint_id: Schema.brand<Schema.String, "Relay.SessionEntryId"> & {
-        make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.SessionEntryId">;
-    };
-    readonly session_id: Schema.brand<Schema.String, "Relay.SessionId"> & {
-        make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.SessionId">;
-    };
-    readonly summary_present: Schema.Boolean;
-}>;
-export interface CompactionCommittedEventData extends Schema.Schema.Type<typeof CompactionCommittedEventData> {
-}
 export declare const ExecutionEvent: Schema.Struct<{
     readonly id: Schema.brand<Schema.String, "Relay.EventId"> & {
         make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.EventId">;
@@ -419,7 +433,7 @@ export declare const ExecutionEvent: Schema.Struct<{
     readonly child_execution_id: Schema.optionalKey<Schema.brand<Schema.String, "Relay.ChildExecutionId"> & {
         make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.ChildExecutionId">;
     }>;
-    readonly type: Schema.Literals<readonly ["execution.accepted", "execution.started", "execution.completed", "execution.failed", "execution.cancelled", "model.input.prepared", "model.output.delta", "model.reasoning.delta", "model.toolcall.delta", "model.output.completed", "model.usage.reported", "agent.compaction.started", "agent.compaction.committed", "budget.exceeded", "tool.call.requested", "tool.result.received", "tool.approval.requested", "tool.approval.resolved", "permission.ask.requested", "permission.ask.resolved", "steering.delivered", "state.updated", "state.deleted", "inbox.enqueued", "inbox.drained", "resident.created", "resident.destroyed", "envelope.accepted", "envelope.routed", "envelope.ready", "delivery.attempt", "wait.created", "wait.woken", "wait.timed_out", "wait.cancelled", "child_run.spawned", "child_run.event", "child_fan_out.created", "child_fan_out.member.admitted", "child_fan_out.member.terminal", "child_fan_out.terminal", "workspace.lease.planned", "workspace.lease.acquired", "workspace.suspended", "workspace.resumed", "workspace.snapshot.created", "workspace.lease.released", "workspace.lease.failed"]>;
+    readonly type: Schema.Literals<readonly ["execution.accepted", "execution.started", "execution.completed", "execution.failed", "execution.cancelled", "model.input.prepared", "model.output.delta", "model.reasoning.delta", "model.toolcall.delta", "model.output.completed", "model.usage.reported", "model.call.started", "model.attempt.started", "model.attempt.first_output", "model.attempt.completed", "model.attempt.failed", "model.retry.scheduled", "model.call.completed", "model.call.failed", "agent.compaction.started", "agent.compaction.completed", "agent.compaction.failed", "agent.compaction.committed", "budget.exceeded", "tool.call.requested", "tool.result.received", "tool.approval.requested", "tool.approval.resolved", "permission.ask.requested", "permission.ask.resolved", "steering.delivered", "state.updated", "state.deleted", "inbox.enqueued", "inbox.drained", "resident.created", "resident.destroyed", "envelope.accepted", "envelope.routed", "envelope.ready", "delivery.attempt", "wait.created", "wait.woken", "wait.timed_out", "wait.cancelled", "child_run.spawned", "child_run.event", "child_fan_out.created", "child_fan_out.member.admitted", "child_fan_out.member.terminal", "child_fan_out.terminal", "workspace.lease.planned", "workspace.lease.acquired", "workspace.suspended", "workspace.resumed", "workspace.snapshot.created", "workspace.lease.released", "workspace.lease.failed"]>;
     readonly sequence: Schema.Int;
     readonly cursor: Schema.String;
     readonly content: Schema.optionalKey<Schema.$Array<Schema.Union<readonly [Schema.Struct<{

package/dist/types/store-sql/child/child-fan-out-repository.d.ts

@@ -20,6 +20,7 @@ export interface Interface {
     readonly recordTerminal: (input: RecordTerminalInput) => Effect.Effect<RecordTerminalResult | undefined, ChildFanOutRepositoryError>;
     readonly cancel: (id: Ids.ChildFanOutId, cancelledAt: number) => Effect.Effect<CancelResult | undefined, ChildFanOutRepositoryError>;
     readonly listNonTerminal: (parentExecutionId?: Ids.ExecutionId) => Effect.Effect<ReadonlyArray<ChildOrchestration.FanOutState>, ChildFanOutRepositoryError>;
+    readonly listByParent: (parentExecutionId: Ids.ExecutionId) => Effect.Effect<ReadonlyArray<ChildOrchestration.FanOutState>, ChildFanOutRepositoryError>;
 }
 export interface RecordTerminalInput {
     readonly childExecutionId: Ids.ChildExecutionId;
@@ -50,4 +51,5 @@ export declare const claimAdmissions: (id: string & import("effect/Brand").Brand
 export declare const recordTerminal: (input: RecordTerminalInput) => Effect.Effect<RecordTerminalResult | undefined, ChildFanOutRepositoryError, Service>;
 export declare const cancel: (id: string & import("effect/Brand").Brand<"Relay.ChildFanOutId">, cancelledAt: number) => Effect.Effect<CancelResult | undefined, ChildFanOutRepositoryError, Service>;
 export declare const listNonTerminal: (parentExecutionId?: (string & import("effect/Brand").Brand<"Relay.ExecutionId">) | undefined) => Effect.Effect<readonly ChildOrchestration.FanOutState[], ChildFanOutRepositoryError, Service>;
+export declare const listByParent: (parentExecutionId: string & import("effect/Brand").Brand<"Relay.ExecutionId">) => Effect.Effect<readonly ChildOrchestration.FanOutState[], ChildFanOutRepositoryError, Service>;
 export {};