@relayfx/sdk 0.7.9 → 0.7.11

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");

package/dist/mysql.js

@@ -2,14 +2,14 @@
 import {
   database,
   normalizeMigrationCause
-} from "./index-qjad95s5.js";
+} from "./index-skcp0xvt.js";
 import {
   MigratorError,
   RuntimeMigrationError,
   SqlFailure
-} from "./index-0gd9t134.js";
-import"./index-72hhs3mp.js";
-import"./index-nb078xsy.js";
+} from "./index-d1je4njg.js";
+import"./index-d5563j6w.js";
+import"./index-j8k41y47.js";
 import"./index-nb39b5ae.js";
 
 // src/mysql.ts
@@ -97,6 +97,18 @@ ALTER TABLE relay_sessions ADD COLUMN owner_epoch BIGINT NOT NULL DEFAULT 0;
 ALTER TABLE relay_sessions ADD COLUMN owner_released BOOLEAN NOT NULL DEFAULT TRUE;
 `;
 
+// ../../migrations/mysql/0015_transactional_event_head.sql
+var _0015_transactional_event_head_default = "ALTER TABLE `relay_execution_events`\n  MODIFY `id` varchar(512) CHARACTER SET utf8mb4 COLLATE utf8mb4_bin NOT NULL,\n  MODIFY `cursor` varchar(512) CHARACTER SET utf8mb4 COLLATE utf8mb4_bin NOT NULL;\n--> statement-breakpoint\nCREATE TABLE IF NOT EXISTS `relay_execution_event_heads` (\n\t`tenant_id` VARCHAR(191) NOT NULL DEFAULT 'system',\n\t`execution_id` VARCHAR(191) NOT NULL,\n\t`next_sequence` INT NOT NULL DEFAULT 0,\n\t`max_sequence` INT NULL,\n\t`event_count` INT NOT NULL DEFAULT 0,\n\t`usage_tokens` BIGINT NOT NULL DEFAULT 0,\n\tCONSTRAINT `pk_relay_execution_event_heads` PRIMARY KEY (`tenant_id`, `execution_id`)\n) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;\n--> statement-breakpoint\n-- Relay pins this migration to one reserved connection. These WRITE locks\n-- block legacy execution creation and event appends until every head has been\n-- backfilled and migration 15 is recorded. The runner guarantees UNLOCK TABLES\n-- on success or failure.\nLOCK TABLES\n  `relay_executions` WRITE,\n  `relay_execution_events` WRITE,\n  `relay_execution_event_heads` WRITE,\n  `relay_migrations` WRITE;\n--> statement-breakpoint\nDELETE FROM `relay_execution_event_heads`;\n--> statement-breakpoint\nINSERT INTO `relay_execution_event_heads` (`tenant_id`, `execution_id`, `next_sequence`, `max_sequence`, `event_count`, `usage_tokens`)\nSELECT `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)\nFROM `relay_executions`\nLEFT JOIN `relay_execution_events`\n  ON `relay_execution_events`.`tenant_id` = `relay_executions`.`tenant_id` AND `relay_execution_events`.`execution_id` = `relay_executions`.`id`\nGROUP BY `relay_executions`.`tenant_id`, `relay_executions`.`id`;\n";
+
+// ../../migrations/mysql/0016_execution_event_archive_manifests.sql
+var _0016_execution_event_archive_manifests_default = "ALTER TABLE `relay_execution_event_heads`\n  ADD COLUMN `archived_through` INT NULL;\n--> statement-breakpoint\nALTER TABLE `relay_execution_event_heads`\n  ADD COLUMN `archive_generation` INT NULL;\n--> statement-breakpoint\nALTER TABLE `relay_execution_event_heads`\n  ADD CONSTRAINT `ck_relay_execution_event_heads_archive_pointer`\n    CHECK ((`archived_through` IS NULL) = (`archive_generation` IS NULL));\n--> statement-breakpoint\nCREATE TABLE IF NOT EXISTS `relay_execution_event_archive_manifests` (\n\t`tenant_id` VARCHAR(191) NOT NULL DEFAULT 'system',\n\t`execution_id` VARCHAR(191) NOT NULL,\n\t`generation` INT NOT NULL,\n\t`archived_through` INT NOT NULL,\n\t`event_count` INT NOT NULL,\n\t`max_sequence` INT NOT NULL,\n\t`usage_tokens` BIGINT NOT NULL,\n\t`schema_version` INT NOT NULL,\n\tCONSTRAINT `pk_relay_execution_event_archive_manifests` PRIMARY KEY (`tenant_id`, `execution_id`, `generation`),\n\tCONSTRAINT `fk_relay_execution_event_archive_manifests_execution` FOREIGN KEY (`tenant_id`, `execution_id`) REFERENCES `relay_executions` (`tenant_id`, `id`),\n\tCONSTRAINT `ck_relay_execution_event_archive_manifests_generation` CHECK (`generation` > 0),\n\tCONSTRAINT `ck_relay_execution_event_archive_manifests_frontier` CHECK (`archived_through` >= 0),\n\tCONSTRAINT `ck_relay_execution_event_archive_manifests_count` CHECK (`event_count` > 0),\n\tCONSTRAINT `ck_relay_execution_event_archive_manifests_max` CHECK (`max_sequence` = `archived_through`),\n\tCONSTRAINT `ck_relay_execution_event_archive_manifests_gaps` CHECK (`event_count` <= `archived_through` + 1),\n\tCONSTRAINT `ck_relay_execution_event_archive_manifests_usage` CHECK (`usage_tokens` >= 0),\n\tCONSTRAINT `ck_relay_execution_event_archive_manifests_schema` CHECK (`schema_version` = 1)\n) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;\n--> statement-breakpoint\nCREATE TABLE IF NOT EXISTS `relay_execution_event_archive_blocks` (\n\t`tenant_id` VARCHAR(191) NOT NULL DEFAULT 'system',\n\t`execution_id` VARCHAR(191) NOT NULL,\n\t`generation` INT NOT NULL,\n\t`block_index` INT NOT NULL,\n\t`first_sequence` INT NOT NULL,\n\t`last_sequence` INT NOT NULL,\n\t`event_count` INT NOT NULL,\n\t`object_key` VARCHAR(80) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,\n\t`object_checksum` CHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,\n\t`object_size` INT NOT NULL,\n\t`codec_version` INT NOT NULL,\n\t`encoding` VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,\n\t`compression` VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,\n\t`payload_checksum` CHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL,\n\t`stored_payload_bytes` INT NOT NULL,\n\t`uncompressed_bytes` INT NOT NULL,\n\tCONSTRAINT `pk_relay_execution_event_archive_blocks` PRIMARY KEY (`tenant_id`, `execution_id`, `generation`, `block_index`),\n\tCONSTRAINT `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`),\n\tCONSTRAINT `uq_relay_execution_event_archive_blocks_first` UNIQUE (`tenant_id`, `execution_id`, `generation`, `first_sequence`),\n\tCONSTRAINT `ck_relay_execution_event_archive_blocks_index` CHECK (`block_index` >= 0),\n\tCONSTRAINT `ck_relay_execution_event_archive_blocks_first` CHECK (`first_sequence` >= 0),\n\tCONSTRAINT `ck_relay_execution_event_archive_blocks_bounds` CHECK (`last_sequence` >= `first_sequence`),\n\tCONSTRAINT `ck_relay_execution_event_archive_blocks_count` CHECK (`event_count` > 0),\n\tCONSTRAINT `ck_relay_execution_event_archive_blocks_count_limit` CHECK (`event_count` <= 4096),\n\tCONSTRAINT `ck_relay_execution_event_archive_blocks_gaps` CHECK (`event_count` <= `last_sequence` - `first_sequence` + 1),\n\tCONSTRAINT `ck_relay_execution_event_archive_blocks_object_size` CHECK (`object_size` > 0 AND `object_size` <= 16777216),\n\tCONSTRAINT `ck_relay_execution_event_archive_blocks_stored_payload_size` CHECK (`stored_payload_bytes` > 0 AND `stored_payload_bytes` <= 15728640),\n\tCONSTRAINT `ck_relay_execution_event_archive_blocks_uncompressed_size` CHECK (`uncompressed_bytes` > 0 AND `uncompressed_bytes` <= 15728640),\n\tCONSTRAINT `ck_relay_execution_event_archive_blocks_stored_size` CHECK (`stored_payload_bytes` < `object_size`),\n\tCONSTRAINT `ck_relay_execution_event_archive_blocks_expansion` CHECK (`stored_payload_bytes` <= `uncompressed_bytes`),\n\tCONSTRAINT `ck_relay_execution_event_archive_blocks_codec` CHECK (`codec_version` IN (1, 2)),\n\tCONSTRAINT `ck_relay_execution_event_archive_blocks_encoding` CHECK (`encoding` = 'json'),\n\tCONSTRAINT `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'))\n) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;\n";
+
+// ../../migrations/mysql/0017_execution_event_identity_directory.sql
+var _0017_execution_event_identity_directory_default = "CREATE TABLE IF NOT EXISTS `relay_execution_event_identity_directory` (\n  `tenant_id` varchar(191) NOT NULL,\n  `cursor` varchar(512) COLLATE utf8mb4_bin NOT NULL,\n  `event_id` varchar(512) COLLATE utf8mb4_bin NOT NULL,\n  `execution_id` varchar(191) NOT NULL,\n  `sequence` int NOT NULL,\n  CONSTRAINT `pk_relay_execution_event_identity_directory` PRIMARY KEY (`tenant_id`, `cursor`),\n  CONSTRAINT `uq_relay_execution_event_identity_directory_event` UNIQUE (`tenant_id`, `event_id`),\n  CONSTRAINT `uq_relay_execution_event_identity_directory_sequence` UNIQUE (`tenant_id`, `execution_id`, `sequence`)\n) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;\n--> statement-breakpoint\nLOCK TABLES\n  `relay_execution_events` WRITE,\n  `relay_execution_event_identity_directory` WRITE,\n  `relay_migrations` WRITE;\n--> statement-breakpoint\nDELETE FROM `relay_execution_event_identity_directory`;\n--> statement-breakpoint\nINSERT INTO `relay_execution_event_identity_directory` (`tenant_id`, `cursor`, `event_id`, `execution_id`, `sequence`)\nSELECT `tenant_id`, `cursor`, `id`, `execution_id`, `sequence` FROM `relay_execution_events`;\n";
+
+// ../../migrations/mysql/0018_idempotent_steering.sql
+var _0018_idempotent_steering_default = "ALTER TABLE `relay_steering_messages` ADD COLUMN `idempotency_key` varchar(191) COLLATE utf8mb4_bin;\n--> statement-breakpoint\nUPDATE `relay_steering_messages` SET `idempotency_key` = CONCAT('relay:legacy:', `kind`, ':', `sequence`);\n--> statement-breakpoint\nALTER TABLE `relay_steering_messages` MODIFY COLUMN `idempotency_key` varchar(191) COLLATE utf8mb4_bin NOT NULL;\n--> statement-breakpoint\nCREATE UNIQUE INDEX `uq_relay_steering_messages_idempotency` ON `relay_steering_messages` (`tenant_id`, `execution_id`, `idempotency_key`);\n";
+
 // src/mysql-migrations.ts
 var migrations = [
   [1, "baseline", _0001_baseline_default],
@@ -112,7 +124,11 @@ var migrations = [
   [11, "execution_scoped_tool_calls", _0011_execution_scoped_tool_calls_default],
   [12, "rename_entity_to_resident", _0012_rename_entity_to_resident_default],
   [13, "steering_delivered", _0013_steering_delivered_default],
-  [14, "session_writer_ownership", _0014_session_writer_ownership_default]
+  [14, "session_writer_ownership", _0014_session_writer_ownership_default],
+  [15, "transactional_event_head", _0015_transactional_event_head_default],
+  [16, "execution_event_archive_manifests", _0016_execution_event_archive_manifests_default],
+  [17, "execution_event_identity_directory", _0017_execution_event_identity_directory_default],
+  [18, "idempotent_steering", _0018_idempotent_steering_default]
 ];
 
 // src/mysql.ts
@@ -145,10 +161,35 @@ var runMigrations = Effect.gen(function* () {
     });
   }
   for (const [id, name, source] of migrations.slice(current.length)) {
-    for (const statement of source.split("--> statement-breakpoint").map((value) => value.trim()).filter(Boolean)) {
-      yield* sql.unsafe(statement);
-    }
-    yield* sql`INSERT INTO relay_migrations (migration_id, name) VALUES (${id}, ${name})`;
+    const statements = source.split("--> statement-breakpoint").map((value) => value.trim()).filter(Boolean);
+    yield* Effect.scoped(Effect.gen(function* () {
+      const connection = yield* sql.reserve;
+      return yield* Effect.gen(function* () {
+        const migration = yield* Effect.exit(Effect.gen(function* () {
+          for (const statement of statements) {
+            if (id === 16) {
+              const catalogQuery = statement.includes("ADD COLUMN") ? [
+                "SELECT COUNT(*) AS count FROM information_schema.columns WHERE table_schema = DATABASE() AND table_name = 'relay_execution_event_heads' AND column_name = ?",
+                [statement.includes("`archived_through`") ? "archived_through" : "archive_generation"]
+              ] : statement.includes("ADD CONSTRAINT") ? [
+                "SELECT COUNT(*) AS count FROM information_schema.table_constraints WHERE constraint_schema = DATABASE() AND table_name = 'relay_execution_event_heads' AND constraint_name = ?",
+                ["ck_relay_execution_event_heads_archive_pointer"]
+              ] : undefined;
+              if (catalogQuery !== undefined) {
+                const present = yield* connection.execute(catalogQuery[0], catalogQuery[1], undefined);
+                if (Number(present[0]?.count ?? 0) === 1) {
+                  continue;
+                }
+              }
+            }
+            yield* connection.executeUnprepared(statement, [], undefined);
+          }
+          yield* connection.execute("INSERT INTO relay_migrations (migration_id, name) VALUES (?, ?)", [id, name], undefined);
+        }));
+        yield* connection.executeUnprepared("UNLOCK TABLES", [], undefined);
+        return yield* migration;
+      }).pipe(Effect.uninterruptible);
+    }));
   }
 });
 var database2 = (options) => database({