@relayfx/sdk 0.7.10 → 0.7.11

package/dist/{index-nb078xsy.js → index-j8k41y47.js}

@@ -1343,10 +1343,26 @@ var Classification = Schema18.Union([
 var scopedToolCallId = (waitId, namespace) => {
   const scope = waitId.slice(namespace.length);
   const separator = scope.indexOf(":");
-  return ToolCallId.make(decodeURIComponent(scope.slice(separator + 1)));
+  const toolScope = scope.slice(separator + 1);
+  if (!toolScope.startsWith("operation:"))
+    return ToolCallId.make(decodeURIComponent(toolScope));
+  const operationSeparator = toolScope.indexOf(":tool-call:", "operation:".length);
+  return ToolCallId.make(decodeURIComponent(toolScope.slice(operationSeparator + 11)));
+};
+var currentPermissionToolCallId = (waitId) => {
+  const encoded = waitId.slice("relay-permission-wait-v2:".length);
+  const identity = JSON.parse(decodeURIComponent(encoded));
+  return ToolCallId.make(identity[2]);
 };
 var classify = (input) => {
   const waitId = input.wait_id;
+  if (waitId.startsWith("relay-permission-wait-v2:")) {
+    return {
+      kind: "permission",
+      wait_id: waitId,
+      tool_call_id: currentPermissionToolCallId(waitId)
+    };
+  }
   if (waitId.startsWith("wait:permission:")) {
     return {
       kind: "permission",
@@ -1415,6 +1431,7 @@ var resolverFor = (classification) => {
 var externallyResolvable = (classification) => resolverFor(classification) !== undefined;
 var exports_workflow_schema = {};
 __export2(exports_workflow_schema, {
+  sha256String: () => sha256String,
   digestDefinition: () => digestDefinition,
   canonicalDefinition: () => canonicalDefinition,
   ToolOperation: () => ToolOperation,
@@ -1743,7 +1760,7 @@ var sha256Constants = [
   3329325298
 ];
 var rotateRight = (value, count) => value >>> count | value << 32 - count;
-var sha256 = (value) => {
+var sha256String = (value) => {
   const encoded = Encoding.encodeHex(value);
   const bytes = Array.from({ length: encoded.length / 2 }, (_, index) => Number.parseInt(encoded.slice(index * 2, index * 2 + 2), 16));
   const bitLength = bytes.length * 8;
@@ -1782,7 +1799,7 @@ var sha256 = (value) => {
   }
   return hash.map((part) => (part >>> 0).toString(16).padStart(8, "0")).join("");
 };
-var digestDefinition = (definition) => Schema19.decodeUnknownSync(DefinitionDigest)(`sha256:${sha256(canonicalDefinition(definition))}`);
+var digestDefinition = (definition) => Schema19.decodeUnknownSync(DefinitionDigest)(`sha256:${sha256String(canonicalDefinition(definition))}`);
 var DefinitionRevisionRecord3 = Schema19.Struct({
   id: WorkflowDefinitionId,
   revision: DefinitionRevision3,
@@ -1965,6 +1982,7 @@ __export(exports_operation, {
   StreamSessionInput: () => StreamSessionInput,
   StreamExecutionInput: () => StreamExecutionInput,
   SteeringKind: () => SteeringKind,
+  SteeringIdempotencyConflict: () => SteeringIdempotencyConflict,
   SteerInput: () => SteerInput,
   SteerAccepted: () => SteerAccepted,
   StartExecutionResult: () => StartExecutionResult,
@@ -2146,10 +2164,14 @@ var SteeringKind = Schema23.Literals(["steering", "follow_up"]).annotate({
 });
 var SteerInput = Schema23.Struct({
   execution_id: exports_ids_schema.ExecutionId,
+  idempotency_key: exports_shared_schema.NonEmptyString.check(Schema23.isMaxLength(191), Schema23.makeFilter((value) => !value.startsWith("relay:"))),
   kind: SteeringKind,
   content: Schema23.Array(exports_content_schema.Part),
   created_at: exports_shared_schema.TimestampMillis
 }).annotate({ identifier: "Relay.Operation.SteerInput" });
+
+class SteeringIdempotencyConflict extends Schema23.TaggedErrorClass()("SteeringIdempotencyConflict", { execution_id: exports_ids_schema.ExecutionId, idempotency_key: exports_shared_schema.NonEmptyString }) {
+}
 var SteerAccepted = Schema23.Struct({
   execution_id: exports_ids_schema.ExecutionId,
   kind: SteeringKind,
@@ -2747,4 +2769,4 @@ class Service2 extends Context2.Service()("@relayfx/runtime/presence/presence-co
 }
 var PresenceIdentity = Context2.Reference("@relayfx/runtime/PresenceIdentity", { defaultValue: () => ({}) });
 
-export { exports_address_schema, exports_ids_schema, exports_shared_schema, exports_agent_schema, exports_tool_schema, exports_child_orchestration_schema, exports_execution_schema, exports_content_schema, exports_envelope_schema, exports_resident_schema, exports_inbox_schema, exports_pagination_schema, exports_presence_schema, exports_schedule_schema, exports_skill_schema, exports_state_schema, exports_wait_schema, exports_workflow_schema, exports_workspace_schema, StateVersionConflict, EventLogCursorNotFound, exports_operation, ClientError, ExecutionNotFound, ResidentNamespaceReserved, WaitKindMismatch, Service, followExecutionFrom, PresenceError, Service2 as Service1, PresenceIdentity };
+export { exports_address_schema, exports_ids_schema, exports_shared_schema, exports_agent_schema, exports_tool_schema, exports_child_orchestration_schema, exports_execution_schema, exports_content_schema, exports_envelope_schema, exports_resident_schema, exports_inbox_schema, exports_pagination_schema, exports_presence_schema, exports_schedule_schema, exports_skill_schema, exports_state_schema, exports_wait_schema, exports_workflow_schema, exports_workspace_schema, StateVersionConflict, SteerInput, SteeringIdempotencyConflict, EventLogCursorNotFound, exports_operation, ClientError, ExecutionNotFound, ResidentNamespaceReserved, WaitKindMismatch, Service, followExecutionFrom, PresenceError, Service2 as Service1, PresenceIdentity };

package/dist/{index-m7dpw880.js → index-skcp0xvt.js}

@@ -8,7 +8,7 @@ import {
   SqlFailure,
   make,
   normalizeAcquisitionCause
-} from "./index-gwgea1te.js";
+} from "./index-d1je4njg.js";
 
 // src/migration-errors.ts
 import { Cause, Effect, Function } from "effect";

package/dist/index.js

@@ -14,7 +14,7 @@ import {
   exports_tool_runtime,
   exports_workflow_definition_host,
   makeDatabaseIdentity
-} from "./index-gwgea1te.js";
+} from "./index-d1je4njg.js";
 import {
   exports_context_overflow,
   exports_model_registry
@@ -47,7 +47,7 @@ import {
   exports_wait_schema,
   exports_workflow_schema,
   followExecutionFrom
-} from "./index-nb078xsy.js";
+} from "./index-j8k41y47.js";
 import {
   __export
 } from "./index-nb39b5ae.js";

package/dist/migrations/20260723190000_transactional_event_head/migration.sql

@@ -0,0 +1,22 @@
+CREATE TABLE "relay_execution_event_heads" (
+	"tenant_id" text DEFAULT 'system' NOT NULL,
+	"execution_id" text NOT NULL,
+	"next_sequence" integer DEFAULT 0 NOT NULL,
+	"max_sequence" integer,
+	"event_count" integer DEFAULT 0 NOT NULL,
+	"usage_tokens" bigint DEFAULT 0 NOT NULL,
+	CONSTRAINT "pk_relay_execution_event_heads" PRIMARY KEY("tenant_id","execution_id")
+);
+--> statement-breakpoint
+-- Drizzle runs this migration in one transaction. SHARE ROW EXCLUSIVE blocks
+-- legacy INSERT/UPDATE/DELETE writers while allowing ACCESS SHARE readers, so
+-- the backfill and the newly created head rows become visible atomically.
+LOCK TABLE "relay_executions", "relay_execution_events", "relay_execution_event_heads"
+  IN SHARE ROW EXCLUSIVE MODE;
+--> statement-breakpoint
+INSERT INTO "relay_execution_event_heads" ("tenant_id", "execution_id", "next_sequence", "max_sequence", "event_count", "usage_tokens")
+SELECT execution."tenant_id", execution."id", COALESCE(MAX(event."sequence") + 1, 0), MAX(event."sequence"), COUNT(event."id"), COALESCE(SUM(CASE WHEN event."type" = 'model.usage.reported' THEN CASE WHEN jsonb_typeof(event."data_json" -> 'input_tokens') = 'number' THEN trunc((event."data_json" ->> 'input_tokens')::numeric)::bigint ELSE 0 END + CASE WHEN jsonb_typeof(event."data_json" -> 'output_tokens') = 'number' THEN trunc((event."data_json" ->> 'output_tokens')::numeric)::bigint ELSE 0 END ELSE 0 END), 0)
+FROM "relay_executions" execution
+LEFT JOIN "relay_execution_events" event
+  ON event."tenant_id" = execution."tenant_id" AND event."execution_id" = execution."id"
+GROUP BY execution."tenant_id", execution."id";

package/dist/migrations/20260724010000_execution_event_archive_manifests/migration.sql

@@ -0,0 +1,66 @@
+ALTER TABLE "relay_execution_event_heads" ADD COLUMN "archived_through" integer;
+--> statement-breakpoint
+ALTER TABLE "relay_execution_event_heads" ADD COLUMN "archive_generation" integer;
+--> statement-breakpoint
+ALTER TABLE "relay_execution_event_heads" ADD CONSTRAINT "ck_relay_execution_event_heads_archive_pointer" CHECK (("archived_through" IS NULL) = ("archive_generation" IS NULL));
+--> statement-breakpoint
+CREATE TABLE "relay_execution_event_archive_manifests" (
+	"tenant_id" text DEFAULT 'system' NOT NULL,
+	"execution_id" text NOT NULL,
+	"generation" integer NOT NULL,
+	"archived_through" integer NOT NULL,
+	"event_count" integer NOT NULL,
+	"max_sequence" integer NOT NULL,
+	"usage_tokens" bigint NOT NULL,
+	"schema_version" integer NOT NULL,
+	CONSTRAINT "pk_relay_execution_event_archive_manifests" PRIMARY KEY("tenant_id","execution_id","generation"),
+	CONSTRAINT "ck_relay_execution_event_archive_manifests_generation" CHECK ("generation" > 0),
+	CONSTRAINT "ck_relay_execution_event_archive_manifests_frontier" CHECK ("archived_through" >= 0),
+	CONSTRAINT "ck_relay_execution_event_archive_manifests_count" CHECK ("event_count" > 0),
+	CONSTRAINT "ck_relay_execution_event_archive_manifests_max" CHECK ("max_sequence" = "archived_through"),
+	CONSTRAINT "ck_relay_execution_event_archive_manifests_gaps" CHECK ("event_count" <= "archived_through" + 1),
+	CONSTRAINT "ck_relay_execution_event_archive_manifests_usage" CHECK ("usage_tokens" >= 0),
+	CONSTRAINT "ck_relay_execution_event_archive_manifests_schema" CHECK ("schema_version" = 1)
+);
+--> statement-breakpoint
+CREATE TABLE "relay_execution_event_archive_blocks" (
+	"tenant_id" text DEFAULT 'system' NOT NULL,
+	"execution_id" text NOT NULL,
+	"generation" integer NOT NULL,
+	"block_index" integer NOT NULL,
+	"first_sequence" integer NOT NULL,
+	"last_sequence" integer NOT NULL,
+	"event_count" integer NOT NULL,
+	"object_key" text NOT NULL,
+	"object_checksum" text NOT NULL,
+	"object_size" integer NOT NULL,
+	"codec_version" integer NOT NULL,
+	"encoding" text NOT NULL,
+	"compression" text NOT NULL,
+	"payload_checksum" text NOT NULL,
+	"stored_payload_bytes" integer NOT NULL,
+	"uncompressed_bytes" integer NOT NULL,
+	CONSTRAINT "pk_relay_execution_event_archive_blocks" PRIMARY KEY("tenant_id","execution_id","generation","block_index"),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_index" CHECK ("block_index" >= 0),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_first" CHECK ("first_sequence" >= 0),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_bounds" CHECK ("last_sequence" >= "first_sequence"),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_count" CHECK ("event_count" > 0),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_count_limit" CHECK ("event_count" <= 4096),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_gaps" CHECK ("event_count" <= "last_sequence" - "first_sequence" + 1),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_object_size" CHECK ("object_size" > 0 AND "object_size" <= 16777216),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_stored_payload_size" CHECK ("stored_payload_bytes" > 0 AND "stored_payload_bytes" <= 15728640),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_uncompressed_size" CHECK ("uncompressed_bytes" > 0 AND "uncompressed_bytes" <= 15728640),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_stored_size" CHECK ("stored_payload_bytes" < "object_size"),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_expansion" CHECK ("stored_payload_bytes" <= "uncompressed_bytes"),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_codec" CHECK ("codec_version" IN (1, 2)),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_encoding" CHECK ("encoding" = 'json'),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_compression" CHECK (("codec_version" = 1 AND "compression" = 'none' AND "stored_payload_bytes" = "uncompressed_bytes") OR ("codec_version" = 2 AND "compression" = 'gzip')),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_object_key" CHECK (length("object_key") <= 80),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_checksum" CHECK (length("object_checksum") = 64),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_payload_checksum" CHECK (length("payload_checksum") = 64),
+	CONSTRAINT "uq_relay_execution_event_archive_blocks_first" UNIQUE("tenant_id","execution_id","generation","first_sequence")
+);
+--> statement-breakpoint
+ALTER TABLE "relay_execution_event_archive_manifests" ADD CONSTRAINT "fk_relay_execution_event_archive_manifests_execution" FOREIGN KEY ("tenant_id","execution_id") REFERENCES "relay_executions"("tenant_id","id") ON DELETE no action ON UPDATE no action;
+--> statement-breakpoint
+ALTER TABLE "relay_execution_event_archive_blocks" ADD CONSTRAINT "fk_relay_execution_event_archive_blocks_manifest" FOREIGN KEY ("tenant_id","execution_id","generation") REFERENCES "relay_execution_event_archive_manifests"("tenant_id","execution_id","generation") ON DELETE no action ON UPDATE no action;

package/dist/migrations/20260724120000_execution_event_identity_directory/migration.sql

@@ -0,0 +1,15 @@
+CREATE TABLE "relay_execution_event_identity_directory" (
+	"tenant_id" text NOT NULL,
+	"cursor" text NOT NULL,
+	"event_id" text NOT NULL,
+	"execution_id" text NOT NULL,
+	"sequence" integer NOT NULL,
+	CONSTRAINT "pk_relay_execution_event_identity_directory" PRIMARY KEY("tenant_id","cursor"),
+	CONSTRAINT "uq_relay_execution_event_identity_directory_event" UNIQUE("tenant_id","event_id"),
+	CONSTRAINT "uq_relay_execution_event_identity_directory_sequence" UNIQUE("tenant_id","execution_id","sequence")
+);
+--> statement-breakpoint
+LOCK TABLE "relay_execution_events" IN SHARE ROW EXCLUSIVE MODE;
+--> statement-breakpoint
+INSERT INTO "relay_execution_event_identity_directory" ("tenant_id", "cursor", "event_id", "execution_id", "sequence")
+SELECT "tenant_id", "cursor", "id", "execution_id", "sequence" FROM "relay_execution_events";

package/dist/migrations/20260724230000_idempotent_steering/migration.sql

@@ -0,0 +1,7 @@
+ALTER TABLE "relay_steering_messages" ADD COLUMN "idempotency_key" text;
+--> statement-breakpoint
+UPDATE "relay_steering_messages" SET "idempotency_key" = 'relay:legacy:' || "kind" || ':' || "sequence"::text;
+--> statement-breakpoint
+ALTER TABLE "relay_steering_messages" ALTER COLUMN "idempotency_key" SET NOT NULL;
+--> statement-breakpoint
+CREATE UNIQUE INDEX "uq_relay_steering_messages_idempotency" ON "relay_steering_messages" ("tenant_id", "execution_id", "idempotency_key");

package/dist/migrations/mysql/0015_transactional_event_head.sql

@@ -0,0 +1,32 @@
+ALTER TABLE `relay_execution_events`
+  MODIFY `id` varchar(512) CHARACTER SET utf8mb4 COLLATE utf8mb4_bin NOT NULL,
+  MODIFY `cursor` varchar(512) CHARACTER SET utf8mb4 COLLATE utf8mb4_bin NOT NULL;
+--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS `relay_execution_event_heads` (
+	`tenant_id` VARCHAR(191) NOT NULL DEFAULT 'system',
+	`execution_id` VARCHAR(191) NOT NULL,
+	`next_sequence` INT NOT NULL DEFAULT 0,
+	`max_sequence` INT NULL,
+	`event_count` INT NOT NULL DEFAULT 0,
+	`usage_tokens` BIGINT NOT NULL DEFAULT 0,
+	CONSTRAINT `pk_relay_execution_event_heads` PRIMARY KEY (`tenant_id`, `execution_id`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+--> statement-breakpoint
+-- Relay pins this migration to one reserved connection. These WRITE locks
+-- block legacy execution creation and event appends until every head has been
+-- backfilled and migration 15 is recorded. The runner guarantees UNLOCK TABLES
+-- on success or failure.
+LOCK TABLES
+  `relay_executions` WRITE,
+  `relay_execution_events` WRITE,
+  `relay_execution_event_heads` WRITE,
+  `relay_migrations` WRITE;
+--> statement-breakpoint
+DELETE FROM `relay_execution_event_heads`;
+--> statement-breakpoint
+INSERT INTO `relay_execution_event_heads` (`tenant_id`, `execution_id`, `next_sequence`, `max_sequence`, `event_count`, `usage_tokens`)
+SELECT `relay_executions`.`tenant_id`, `relay_executions`.`id`, COALESCE(MAX(`relay_execution_events`.`sequence`) + 1, 0), MAX(`relay_execution_events`.`sequence`), COUNT(`relay_execution_events`.`id`), COALESCE(SUM(CASE WHEN `relay_execution_events`.`type` = 'model.usage.reported' THEN COALESCE(CAST(JSON_EXTRACT(`relay_execution_events`.`data_json`, '$.input_tokens') AS SIGNED), 0) + COALESCE(CAST(JSON_EXTRACT(`relay_execution_events`.`data_json`, '$.output_tokens') AS SIGNED), 0) ELSE 0 END), 0)
+FROM `relay_executions`
+LEFT JOIN `relay_execution_events`
+  ON `relay_execution_events`.`tenant_id` = `relay_executions`.`tenant_id` AND `relay_execution_events`.`execution_id` = `relay_executions`.`id`
+GROUP BY `relay_executions`.`tenant_id`, `relay_executions`.`id`;

package/dist/migrations/mysql/0016_execution_event_archive_manifests.sql

@@ -0,0 +1,65 @@
+ALTER TABLE `relay_execution_event_heads`
+  ADD COLUMN `archived_through` INT NULL;
+--> statement-breakpoint
+ALTER TABLE `relay_execution_event_heads`
+  ADD COLUMN `archive_generation` INT NULL;
+--> statement-breakpoint
+ALTER TABLE `relay_execution_event_heads`
+  ADD CONSTRAINT `ck_relay_execution_event_heads_archive_pointer`
+    CHECK ((`archived_through` IS NULL) = (`archive_generation` IS NULL));
+--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS `relay_execution_event_archive_manifests` (
+	`tenant_id` VARCHAR(191) NOT NULL DEFAULT 'system',
+	`execution_id` VARCHAR(191) NOT NULL,
+	`generation` INT NOT NULL,
+	`archived_through` INT NOT NULL,
+	`event_count` INT NOT NULL,
+	`max_sequence` INT NOT NULL,
+	`usage_tokens` BIGINT NOT NULL,
+	`schema_version` INT NOT NULL,
+	CONSTRAINT `pk_relay_execution_event_archive_manifests` PRIMARY KEY (`tenant_id`, `execution_id`, `generation`),
+	CONSTRAINT `fk_relay_execution_event_archive_manifests_execution` FOREIGN KEY (`tenant_id`, `execution_id`) REFERENCES `relay_executions` (`tenant_id`, `id`),
+	CONSTRAINT `ck_relay_execution_event_archive_manifests_generation` CHECK (`generation` > 0),
+	CONSTRAINT `ck_relay_execution_event_archive_manifests_frontier` CHECK (`archived_through` >= 0),
+	CONSTRAINT `ck_relay_execution_event_archive_manifests_count` CHECK (`event_count` > 0),
+	CONSTRAINT `ck_relay_execution_event_archive_manifests_max` CHECK (`max_sequence` = `archived_through`),
+	CONSTRAINT `ck_relay_execution_event_archive_manifests_gaps` CHECK (`event_count` <= `archived_through` + 1),
+	CONSTRAINT `ck_relay_execution_event_archive_manifests_usage` CHECK (`usage_tokens` >= 0),
+	CONSTRAINT `ck_relay_execution_event_archive_manifests_schema` CHECK (`schema_version` = 1)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS `relay_execution_event_archive_blocks` (
+	`tenant_id` VARCHAR(191) NOT NULL DEFAULT 'system',
+	`execution_id` VARCHAR(191) NOT NULL,
+	`generation` INT NOT NULL,
+	`block_index` INT NOT NULL,
+	`first_sequence` INT NOT NULL,
+	`last_sequence` INT NOT NULL,
+	`event_count` INT NOT NULL,
+	`object_key` VARCHAR(80) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
+	`object_checksum` CHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
+	`object_size` INT NOT NULL,
+	`codec_version` INT NOT NULL,
+	`encoding` VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
+	`compression` VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
+	`payload_checksum` CHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,
+	`stored_payload_bytes` INT NOT NULL,
+	`uncompressed_bytes` INT NOT NULL,
+	CONSTRAINT `pk_relay_execution_event_archive_blocks` PRIMARY KEY (`tenant_id`, `execution_id`, `generation`, `block_index`),
+	CONSTRAINT `fk_relay_execution_event_archive_blocks_manifest` FOREIGN KEY (`tenant_id`, `execution_id`, `generation`) REFERENCES `relay_execution_event_archive_manifests` (`tenant_id`, `execution_id`, `generation`),
+	CONSTRAINT `uq_relay_execution_event_archive_blocks_first` UNIQUE (`tenant_id`, `execution_id`, `generation`, `first_sequence`),
+	CONSTRAINT `ck_relay_execution_event_archive_blocks_index` CHECK (`block_index` >= 0),
+	CONSTRAINT `ck_relay_execution_event_archive_blocks_first` CHECK (`first_sequence` >= 0),
+	CONSTRAINT `ck_relay_execution_event_archive_blocks_bounds` CHECK (`last_sequence` >= `first_sequence`),
+	CONSTRAINT `ck_relay_execution_event_archive_blocks_count` CHECK (`event_count` > 0),
+	CONSTRAINT `ck_relay_execution_event_archive_blocks_count_limit` CHECK (`event_count` <= 4096),
+	CONSTRAINT `ck_relay_execution_event_archive_blocks_gaps` CHECK (`event_count` <= `last_sequence` - `first_sequence` + 1),
+	CONSTRAINT `ck_relay_execution_event_archive_blocks_object_size` CHECK (`object_size` > 0 AND `object_size` <= 16777216),
+	CONSTRAINT `ck_relay_execution_event_archive_blocks_stored_payload_size` CHECK (`stored_payload_bytes` > 0 AND `stored_payload_bytes` <= 15728640),
+	CONSTRAINT `ck_relay_execution_event_archive_blocks_uncompressed_size` CHECK (`uncompressed_bytes` > 0 AND `uncompressed_bytes` <= 15728640),
+	CONSTRAINT `ck_relay_execution_event_archive_blocks_stored_size` CHECK (`stored_payload_bytes` < `object_size`),
+	CONSTRAINT `ck_relay_execution_event_archive_blocks_expansion` CHECK (`stored_payload_bytes` <= `uncompressed_bytes`),
+	CONSTRAINT `ck_relay_execution_event_archive_blocks_codec` CHECK (`codec_version` IN (1, 2)),
+	CONSTRAINT `ck_relay_execution_event_archive_blocks_encoding` CHECK (`encoding` = 'json'),
+	CONSTRAINT `ck_relay_execution_event_archive_blocks_compression` CHECK ((`codec_version` = 1 AND `compression` = 'none' AND `stored_payload_bytes` = `uncompressed_bytes`) OR (`codec_version` = 2 AND `compression` = 'gzip'))
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

package/dist/migrations/mysql/0017_execution_event_identity_directory.sql

@@ -0,0 +1,20 @@
+CREATE TABLE IF NOT EXISTS `relay_execution_event_identity_directory` (
+  `tenant_id` varchar(191) NOT NULL,
+  `cursor` varchar(512) COLLATE utf8mb4_bin NOT NULL,
+  `event_id` varchar(512) COLLATE utf8mb4_bin NOT NULL,
+  `execution_id` varchar(191) NOT NULL,
+  `sequence` int NOT NULL,
+  CONSTRAINT `pk_relay_execution_event_identity_directory` PRIMARY KEY (`tenant_id`, `cursor`),
+  CONSTRAINT `uq_relay_execution_event_identity_directory_event` UNIQUE (`tenant_id`, `event_id`),
+  CONSTRAINT `uq_relay_execution_event_identity_directory_sequence` UNIQUE (`tenant_id`, `execution_id`, `sequence`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
+--> statement-breakpoint
+LOCK TABLES
+  `relay_execution_events` WRITE,
+  `relay_execution_event_identity_directory` WRITE,
+  `relay_migrations` WRITE;
+--> statement-breakpoint
+DELETE FROM `relay_execution_event_identity_directory`;
+--> statement-breakpoint
+INSERT INTO `relay_execution_event_identity_directory` (`tenant_id`, `cursor`, `event_id`, `execution_id`, `sequence`)
+SELECT `tenant_id`, `cursor`, `id`, `execution_id`, `sequence` FROM `relay_execution_events`;

package/dist/migrations/mysql/0018_idempotent_steering.sql

@@ -0,0 +1,7 @@
+ALTER TABLE `relay_steering_messages` ADD COLUMN `idempotency_key` varchar(191) COLLATE utf8mb4_bin;
+--> statement-breakpoint
+UPDATE `relay_steering_messages` SET `idempotency_key` = CONCAT('relay:legacy:', `kind`, ':', `sequence`);
+--> statement-breakpoint
+ALTER TABLE `relay_steering_messages` MODIFY COLUMN `idempotency_key` varchar(191) COLLATE utf8mb4_bin NOT NULL;
+--> statement-breakpoint
+CREATE UNIQUE INDEX `uq_relay_steering_messages_idempotency` ON `relay_steering_messages` (`tenant_id`, `execution_id`, `idempotency_key`);

package/dist/migrations/pg/20260723190000_transactional_event_head/migration.sql

@@ -0,0 +1,22 @@
+CREATE TABLE "relay_execution_event_heads" (
+	"tenant_id" text DEFAULT 'system' NOT NULL,
+	"execution_id" text NOT NULL,
+	"next_sequence" integer DEFAULT 0 NOT NULL,
+	"max_sequence" integer,
+	"event_count" integer DEFAULT 0 NOT NULL,
+	"usage_tokens" bigint DEFAULT 0 NOT NULL,
+	CONSTRAINT "pk_relay_execution_event_heads" PRIMARY KEY("tenant_id","execution_id")
+);
+--> statement-breakpoint
+-- Drizzle runs this migration in one transaction. SHARE ROW EXCLUSIVE blocks
+-- legacy INSERT/UPDATE/DELETE writers while allowing ACCESS SHARE readers, so
+-- the backfill and the newly created head rows become visible atomically.
+LOCK TABLE "relay_executions", "relay_execution_events", "relay_execution_event_heads"
+  IN SHARE ROW EXCLUSIVE MODE;
+--> statement-breakpoint
+INSERT INTO "relay_execution_event_heads" ("tenant_id", "execution_id", "next_sequence", "max_sequence", "event_count", "usage_tokens")
+SELECT execution."tenant_id", execution."id", COALESCE(MAX(event."sequence") + 1, 0), MAX(event."sequence"), COUNT(event."id"), COALESCE(SUM(CASE WHEN event."type" = 'model.usage.reported' THEN CASE WHEN jsonb_typeof(event."data_json" -> 'input_tokens') = 'number' THEN trunc((event."data_json" ->> 'input_tokens')::numeric)::bigint ELSE 0 END + CASE WHEN jsonb_typeof(event."data_json" -> 'output_tokens') = 'number' THEN trunc((event."data_json" ->> 'output_tokens')::numeric)::bigint ELSE 0 END ELSE 0 END), 0)
+FROM "relay_executions" execution
+LEFT JOIN "relay_execution_events" event
+  ON event."tenant_id" = execution."tenant_id" AND event."execution_id" = execution."id"
+GROUP BY execution."tenant_id", execution."id";

package/dist/migrations/pg/20260724010000_execution_event_archive_manifests/migration.sql

@@ -0,0 +1,66 @@
+ALTER TABLE "relay_execution_event_heads" ADD COLUMN "archived_through" integer;
+--> statement-breakpoint
+ALTER TABLE "relay_execution_event_heads" ADD COLUMN "archive_generation" integer;
+--> statement-breakpoint
+ALTER TABLE "relay_execution_event_heads" ADD CONSTRAINT "ck_relay_execution_event_heads_archive_pointer" CHECK (("archived_through" IS NULL) = ("archive_generation" IS NULL));
+--> statement-breakpoint
+CREATE TABLE "relay_execution_event_archive_manifests" (
+	"tenant_id" text DEFAULT 'system' NOT NULL,
+	"execution_id" text NOT NULL,
+	"generation" integer NOT NULL,
+	"archived_through" integer NOT NULL,
+	"event_count" integer NOT NULL,
+	"max_sequence" integer NOT NULL,
+	"usage_tokens" bigint NOT NULL,
+	"schema_version" integer NOT NULL,
+	CONSTRAINT "pk_relay_execution_event_archive_manifests" PRIMARY KEY("tenant_id","execution_id","generation"),
+	CONSTRAINT "ck_relay_execution_event_archive_manifests_generation" CHECK ("generation" > 0),
+	CONSTRAINT "ck_relay_execution_event_archive_manifests_frontier" CHECK ("archived_through" >= 0),
+	CONSTRAINT "ck_relay_execution_event_archive_manifests_count" CHECK ("event_count" > 0),
+	CONSTRAINT "ck_relay_execution_event_archive_manifests_max" CHECK ("max_sequence" = "archived_through"),
+	CONSTRAINT "ck_relay_execution_event_archive_manifests_gaps" CHECK ("event_count" <= "archived_through" + 1),
+	CONSTRAINT "ck_relay_execution_event_archive_manifests_usage" CHECK ("usage_tokens" >= 0),
+	CONSTRAINT "ck_relay_execution_event_archive_manifests_schema" CHECK ("schema_version" = 1)
+);
+--> statement-breakpoint
+CREATE TABLE "relay_execution_event_archive_blocks" (
+	"tenant_id" text DEFAULT 'system' NOT NULL,
+	"execution_id" text NOT NULL,
+	"generation" integer NOT NULL,
+	"block_index" integer NOT NULL,
+	"first_sequence" integer NOT NULL,
+	"last_sequence" integer NOT NULL,
+	"event_count" integer NOT NULL,
+	"object_key" text NOT NULL,
+	"object_checksum" text NOT NULL,
+	"object_size" integer NOT NULL,
+	"codec_version" integer NOT NULL,
+	"encoding" text NOT NULL,
+	"compression" text NOT NULL,
+	"payload_checksum" text NOT NULL,
+	"stored_payload_bytes" integer NOT NULL,
+	"uncompressed_bytes" integer NOT NULL,
+	CONSTRAINT "pk_relay_execution_event_archive_blocks" PRIMARY KEY("tenant_id","execution_id","generation","block_index"),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_index" CHECK ("block_index" >= 0),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_first" CHECK ("first_sequence" >= 0),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_bounds" CHECK ("last_sequence" >= "first_sequence"),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_count" CHECK ("event_count" > 0),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_count_limit" CHECK ("event_count" <= 4096),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_gaps" CHECK ("event_count" <= "last_sequence" - "first_sequence" + 1),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_object_size" CHECK ("object_size" > 0 AND "object_size" <= 16777216),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_stored_payload_size" CHECK ("stored_payload_bytes" > 0 AND "stored_payload_bytes" <= 15728640),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_uncompressed_size" CHECK ("uncompressed_bytes" > 0 AND "uncompressed_bytes" <= 15728640),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_stored_size" CHECK ("stored_payload_bytes" < "object_size"),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_expansion" CHECK ("stored_payload_bytes" <= "uncompressed_bytes"),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_codec" CHECK ("codec_version" IN (1, 2)),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_encoding" CHECK ("encoding" = 'json'),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_compression" CHECK (("codec_version" = 1 AND "compression" = 'none' AND "stored_payload_bytes" = "uncompressed_bytes") OR ("codec_version" = 2 AND "compression" = 'gzip')),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_object_key" CHECK (length("object_key") <= 80),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_checksum" CHECK (length("object_checksum") = 64),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_payload_checksum" CHECK (length("payload_checksum") = 64),
+	CONSTRAINT "uq_relay_execution_event_archive_blocks_first" UNIQUE("tenant_id","execution_id","generation","first_sequence")
+);
+--> statement-breakpoint
+ALTER TABLE "relay_execution_event_archive_manifests" ADD CONSTRAINT "fk_relay_execution_event_archive_manifests_execution" FOREIGN KEY ("tenant_id","execution_id") REFERENCES "relay_executions"("tenant_id","id") ON DELETE no action ON UPDATE no action;
+--> statement-breakpoint
+ALTER TABLE "relay_execution_event_archive_blocks" ADD CONSTRAINT "fk_relay_execution_event_archive_blocks_manifest" FOREIGN KEY ("tenant_id","execution_id","generation") REFERENCES "relay_execution_event_archive_manifests"("tenant_id","execution_id","generation") ON DELETE no action ON UPDATE no action;

package/dist/migrations/pg/20260724120000_execution_event_identity_directory/migration.sql

@@ -0,0 +1,15 @@
+CREATE TABLE "relay_execution_event_identity_directory" (
+	"tenant_id" text NOT NULL,
+	"cursor" text NOT NULL,
+	"event_id" text NOT NULL,
+	"execution_id" text NOT NULL,
+	"sequence" integer NOT NULL,
+	CONSTRAINT "pk_relay_execution_event_identity_directory" PRIMARY KEY("tenant_id","cursor"),
+	CONSTRAINT "uq_relay_execution_event_identity_directory_event" UNIQUE("tenant_id","event_id"),
+	CONSTRAINT "uq_relay_execution_event_identity_directory_sequence" UNIQUE("tenant_id","execution_id","sequence")
+);
+--> statement-breakpoint
+LOCK TABLE "relay_execution_events" IN SHARE ROW EXCLUSIVE MODE;
+--> statement-breakpoint
+INSERT INTO "relay_execution_event_identity_directory" ("tenant_id", "cursor", "event_id", "execution_id", "sequence")
+SELECT "tenant_id", "cursor", "id", "execution_id", "sequence" FROM "relay_execution_events";

package/dist/migrations/pg/20260724230000_idempotent_steering/migration.sql

@@ -0,0 +1,7 @@
+ALTER TABLE "relay_steering_messages" ADD COLUMN "idempotency_key" text;
+--> statement-breakpoint
+UPDATE "relay_steering_messages" SET "idempotency_key" = 'relay:legacy:' || "kind" || ':' || "sequence"::text;
+--> statement-breakpoint
+ALTER TABLE "relay_steering_messages" ALTER COLUMN "idempotency_key" SET NOT NULL;
+--> statement-breakpoint
+CREATE UNIQUE INDEX "uq_relay_steering_messages_idempotency" ON "relay_steering_messages" ("tenant_id", "execution_id", "idempotency_key");

package/dist/migrations/sqlite/0015_transactional_event_head.sql

@@ -0,0 +1,22 @@
+CREATE TABLE "relay_execution_event_heads" (
+	"tenant_id" TEXT NOT NULL DEFAULT 'system',
+	"execution_id" TEXT NOT NULL,
+	"next_sequence" INTEGER NOT NULL DEFAULT 0,
+	"max_sequence" INTEGER,
+	"event_count" INTEGER NOT NULL DEFAULT 0,
+	"usage_tokens" INTEGER NOT NULL DEFAULT 0,
+	CONSTRAINT "pk_relay_execution_event_heads" PRIMARY KEY ("tenant_id", "execution_id")
+);
+--> statement-breakpoint
+INSERT INTO "relay_execution_event_heads" ("tenant_id", "execution_id", "next_sequence", "max_sequence", "event_count", "usage_tokens")
+SELECT execution."tenant_id", execution."id", COALESCE(MAX(event."sequence") + 1, 0), MAX(event."sequence"), COUNT(event."id"),
+  COALESCE(SUM(CASE WHEN event."type" = 'model.usage.reported' AND json_valid(event."data_json") THEN
+    CASE WHEN json_type(event."data_json", '$.input_tokens') IN ('integer', 'real')
+      THEN CAST(json_extract(event."data_json", '$.input_tokens') AS INTEGER) ELSE 0 END +
+    CASE WHEN json_type(event."data_json", '$.output_tokens') IN ('integer', 'real')
+      THEN CAST(json_extract(event."data_json", '$.output_tokens') AS INTEGER) ELSE 0 END
+    ELSE 0 END), 0)
+FROM "relay_executions" execution
+LEFT JOIN "relay_execution_events" event
+  ON event."tenant_id" = execution."tenant_id" AND event."execution_id" = execution."id"
+GROUP BY execution."tenant_id", execution."id";

package/dist/migrations/sqlite/0016_execution_event_archive_manifests.sql

@@ -0,0 +1,45 @@
+ALTER TABLE "relay_execution_event_heads" ADD COLUMN "archived_through" INTEGER;
+--> statement-breakpoint
+ALTER TABLE "relay_execution_event_heads" ADD COLUMN "archive_generation" INTEGER;
+--> statement-breakpoint
+CREATE TABLE "relay_execution_event_archive_manifests" (
+	"tenant_id" TEXT NOT NULL DEFAULT 'system',
+	"execution_id" TEXT NOT NULL,
+	"generation" INTEGER NOT NULL CHECK ("generation" > 0),
+	"archived_through" INTEGER NOT NULL CHECK ("archived_through" >= 0),
+	"event_count" INTEGER NOT NULL CHECK ("event_count" > 0),
+	"max_sequence" INTEGER NOT NULL,
+	"usage_tokens" INTEGER NOT NULL CHECK ("usage_tokens" >= 0),
+	"schema_version" INTEGER NOT NULL CHECK ("schema_version" = 1),
+	CONSTRAINT "pk_relay_execution_event_archive_manifests" PRIMARY KEY ("tenant_id", "execution_id", "generation"),
+	CONSTRAINT "fk_relay_execution_event_archive_manifests_execution" FOREIGN KEY ("tenant_id", "execution_id") REFERENCES "relay_executions" ("tenant_id", "id"),
+	CONSTRAINT "ck_relay_execution_event_archive_manifests_max" CHECK ("max_sequence" = "archived_through"),
+	CONSTRAINT "ck_relay_execution_event_archive_manifests_gaps" CHECK ("event_count" <= "archived_through" + 1)
+);
+--> statement-breakpoint
+CREATE TABLE "relay_execution_event_archive_blocks" (
+	"tenant_id" TEXT NOT NULL DEFAULT 'system',
+	"execution_id" TEXT NOT NULL,
+	"generation" INTEGER NOT NULL,
+	"block_index" INTEGER NOT NULL CHECK ("block_index" >= 0),
+	"first_sequence" INTEGER NOT NULL CHECK ("first_sequence" >= 0),
+	"last_sequence" INTEGER NOT NULL,
+	"event_count" INTEGER NOT NULL CHECK ("event_count" > 0 AND "event_count" <= 4096),
+	"object_key" TEXT NOT NULL CHECK (length("object_key") <= 80),
+	"object_checksum" TEXT NOT NULL CHECK (length("object_checksum") = 64),
+	"object_size" INTEGER NOT NULL CHECK ("object_size" > 0 AND "object_size" <= 16777216),
+	"codec_version" INTEGER NOT NULL CHECK ("codec_version" IN (1, 2)),
+	"encoding" TEXT NOT NULL CHECK ("encoding" = 'json'),
+	"compression" TEXT NOT NULL,
+	"payload_checksum" TEXT NOT NULL CHECK (length("payload_checksum") = 64),
+	"stored_payload_bytes" INTEGER NOT NULL CHECK ("stored_payload_bytes" > 0 AND "stored_payload_bytes" <= 15728640),
+	"uncompressed_bytes" INTEGER NOT NULL CHECK ("uncompressed_bytes" > 0 AND "uncompressed_bytes" <= 15728640),
+	CONSTRAINT "pk_relay_execution_event_archive_blocks" PRIMARY KEY ("tenant_id", "execution_id", "generation", "block_index"),
+	CONSTRAINT "fk_relay_execution_event_archive_blocks_manifest" FOREIGN KEY ("tenant_id", "execution_id", "generation") REFERENCES "relay_execution_event_archive_manifests" ("tenant_id", "execution_id", "generation"),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_bounds" CHECK ("last_sequence" >= "first_sequence"),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_gaps" CHECK ("event_count" <= "last_sequence" - "first_sequence" + 1),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_stored_size" CHECK ("stored_payload_bytes" < "object_size"),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_expansion" CHECK ("stored_payload_bytes" <= "uncompressed_bytes"),
+	CONSTRAINT "ck_relay_execution_event_archive_blocks_compression" CHECK (("codec_version" = 1 AND "compression" = 'none' AND "stored_payload_bytes" = "uncompressed_bytes") OR ("codec_version" = 2 AND "compression" = 'gzip')),
+	CONSTRAINT "uq_relay_execution_event_archive_blocks_first" UNIQUE ("tenant_id", "execution_id", "generation", "first_sequence")
+);

package/dist/migrations/sqlite/0017_execution_event_identity_directory.sql

@@ -0,0 +1,13 @@
+CREATE TABLE "relay_execution_event_identity_directory" (
+  "tenant_id" text NOT NULL,
+  "cursor" text NOT NULL,
+  "event_id" text NOT NULL,
+  "execution_id" text NOT NULL,
+  "sequence" integer NOT NULL,
+  CONSTRAINT "pk_relay_execution_event_identity_directory" PRIMARY KEY("tenant_id", "cursor"),
+  CONSTRAINT "uq_relay_execution_event_identity_directory_event" UNIQUE("tenant_id", "event_id"),
+  CONSTRAINT "uq_relay_execution_event_identity_directory_sequence" UNIQUE("tenant_id", "execution_id", "sequence")
+);
+--> statement-breakpoint
+INSERT INTO "relay_execution_event_identity_directory" ("tenant_id", "cursor", "event_id", "execution_id", "sequence")
+SELECT "tenant_id", "cursor", "id", "execution_id", "sequence" FROM "relay_execution_events";

package/dist/migrations/sqlite/0018_idempotent_steering.sql

@@ -0,0 +1,5 @@
+ALTER TABLE "relay_steering_messages" ADD COLUMN "idempotency_key" text NOT NULL DEFAULT '';
+--> statement-breakpoint
+UPDATE "relay_steering_messages" SET "idempotency_key" = 'relay:legacy:' || "kind" || ':' || CAST("sequence" AS text);
+--> statement-breakpoint
+CREATE UNIQUE INDEX "uq_relay_steering_messages_idempotency" ON "relay_steering_messages" ("tenant_id", "execution_id", "idempotency_key");