@relayfx/sdk 0.7.10 → 0.7.11

package/dist/mysql.js

@@ -2,14 +2,14 @@
 import {
   database,
   normalizeMigrationCause
-} from "./index-m7dpw880.js";
+} from "./index-skcp0xvt.js";
 import {
   MigratorError,
   RuntimeMigrationError,
   SqlFailure
-} from "./index-gwgea1te.js";
+} from "./index-d1je4njg.js";
 import"./index-d5563j6w.js";
-import"./index-nb078xsy.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({

package/dist/postgres.js

@@ -2,7 +2,7 @@
 import {
   database,
   normalizeMigrationCause
-} from "./index-m7dpw880.js";
+} from "./index-skcp0xvt.js";
 import {
   Dialect,
   RuntimeMigrationError,
@@ -14,11 +14,11 @@ import {
   fromDbTimestamp,
   fromNullableDbTimestamp,
   timestampParam
-} from "./index-gwgea1te.js";
+} from "./index-d1je4njg.js";
 import"./index-d5563j6w.js";
 import {
   exports_ids_schema
-} from "./index-nb078xsy.js";
+} from "./index-j8k41y47.js";
 import {
   __export
 } from "./index-nb39b5ae.js";
@@ -294,7 +294,21 @@ var relayPermissionRules = pgTable4("relay_permission_rules", {
   index2("idx_relay_permission_rules_agent_scope").on(table.tenantId, table.agent, table.scope)
 ]);
 // ../store-sql/src/schema/execution-schema.ts
-import { boolean as boolean2, index as index3, integer as integer4, jsonb as jsonb5, pgTable as pgTable5, primaryKey as primaryKey5, text as text6, timestamp as timestamp5, uniqueIndex as uniqueIndex3 } from "drizzle-orm/pg-core";
+import {
+  bigint,
+  boolean as boolean2,
+  check as check2,
+  foreignKey,
+  index as index3,
+  integer as integer4,
+  jsonb as jsonb5,
+  pgTable as pgTable5,
+  primaryKey as primaryKey5,
+  text as text6,
+  timestamp as timestamp5,
+  uniqueIndex as uniqueIndex3
+} from "drizzle-orm/pg-core";
+import { sql as sql2 } from "drizzle-orm";
 var relayExecutionState = pgTable5("relay_execution_state", {
   tenantId: tenantId(),
   executionId: text6("execution_id").$type().notNull(),
@@ -395,6 +409,96 @@ var relayChildFanOutMembers = pgTable5("relay_child_fan_out_members", {
   }),
   uniqueIndex3("uq_relay_child_fan_out_member_ordinal").on(table.tenantId, table.fanOutId, table.ordinal)
 ]);
+var relayExecutionEventHeads = pgTable5("relay_execution_event_heads", {
+  tenantId: tenantId(),
+  executionId: text6("execution_id").$type().notNull(),
+  nextSequence: integer4("next_sequence").notNull().default(0),
+  maxSequence: integer4("max_sequence"),
+  eventCount: integer4("event_count").notNull().default(0),
+  usageTokens: bigint("usage_tokens", { mode: "number" }).notNull().default(0),
+  archivedThrough: integer4("archived_through"),
+  archiveGeneration: integer4("archive_generation")
+}, (table) => [
+  primaryKey5({ columns: [table.tenantId, table.executionId], name: "pk_relay_execution_event_heads" }),
+  check2("ck_relay_execution_event_heads_archive_pointer", sql2`(${table.archivedThrough} IS NULL) = (${table.archiveGeneration} IS NULL)`)
+]);
+var relayExecutionEventArchiveManifests = pgTable5("relay_execution_event_archive_manifests", {
+  tenantId: tenantId(),
+  executionId: text6("execution_id").$type().notNull(),
+  generation: integer4("generation").notNull(),
+  archivedThrough: integer4("archived_through").notNull(),
+  eventCount: integer4("event_count").notNull(),
+  maxSequence: integer4("max_sequence").notNull(),
+  usageTokens: bigint("usage_tokens", { mode: "number" }).notNull(),
+  schemaVersion: integer4("schema_version").notNull()
+}, (table) => [
+  primaryKey5({
+    columns: [table.tenantId, table.executionId, table.generation],
+    name: "pk_relay_execution_event_archive_manifests"
+  }),
+  foreignKey({
+    columns: [table.tenantId, table.executionId],
+    foreignColumns: [relayExecutions.tenantId, relayExecutions.id],
+    name: "fk_relay_execution_event_archive_manifests_execution"
+  }),
+  check2("ck_relay_execution_event_archive_manifests_generation", sql2`${table.generation} > 0`),
+  check2("ck_relay_execution_event_archive_manifests_frontier", sql2`${table.archivedThrough} >= 0`),
+  check2("ck_relay_execution_event_archive_manifests_count", sql2`${table.eventCount} > 0`),
+  check2("ck_relay_execution_event_archive_manifests_max", sql2`${table.maxSequence} = ${table.archivedThrough}`),
+  check2("ck_relay_execution_event_archive_manifests_gaps", sql2`${table.eventCount} <= ${table.archivedThrough} + 1`),
+  check2("ck_relay_execution_event_archive_manifests_usage", sql2`${table.usageTokens} >= 0`),
+  check2("ck_relay_execution_event_archive_manifests_schema", sql2`${table.schemaVersion} = 1`)
+]);
+var relayExecutionEventArchiveBlocks = pgTable5("relay_execution_event_archive_blocks", {
+  tenantId: tenantId(),
+  executionId: text6("execution_id").$type().notNull(),
+  generation: integer4("generation").notNull(),
+  blockIndex: integer4("block_index").notNull(),
+  firstSequence: integer4("first_sequence").notNull(),
+  lastSequence: integer4("last_sequence").notNull(),
+  eventCount: integer4("event_count").notNull(),
+  objectKey: text6("object_key").notNull(),
+  objectChecksum: text6("object_checksum").notNull(),
+  objectSize: integer4("object_size").notNull(),
+  codecVersion: integer4("codec_version").notNull(),
+  encoding: text6("encoding").notNull(),
+  compression: text6("compression").notNull(),
+  payloadChecksum: text6("payload_checksum").notNull(),
+  storedPayloadBytes: integer4("stored_payload_bytes").notNull(),
+  uncompressedBytes: integer4("uncompressed_bytes").notNull()
+}, (table) => [
+  primaryKey5({
+    columns: [table.tenantId, table.executionId, table.generation, table.blockIndex],
+    name: "pk_relay_execution_event_archive_blocks"
+  }),
+  foreignKey({
+    columns: [table.tenantId, table.executionId, table.generation],
+    foreignColumns: [
+      relayExecutionEventArchiveManifests.tenantId,
+      relayExecutionEventArchiveManifests.executionId,
+      relayExecutionEventArchiveManifests.generation
+    ],
+    name: "fk_relay_execution_event_archive_blocks_manifest"
+  }),
+  uniqueIndex3("uq_relay_execution_event_archive_blocks_first").on(table.tenantId, table.executionId, table.generation, table.firstSequence),
+  check2("ck_relay_execution_event_archive_blocks_index", sql2`${table.blockIndex} >= 0`),
+  check2("ck_relay_execution_event_archive_blocks_first", sql2`${table.firstSequence} >= 0`),
+  check2("ck_relay_execution_event_archive_blocks_bounds", sql2`${table.lastSequence} >= ${table.firstSequence}`),
+  check2("ck_relay_execution_event_archive_blocks_count", sql2`${table.eventCount} > 0`),
+  check2("ck_relay_execution_event_archive_blocks_count_limit", sql2`${table.eventCount} <= 4096`),
+  check2("ck_relay_execution_event_archive_blocks_gaps", sql2`${table.eventCount} <= ${table.lastSequence} - ${table.firstSequence} + 1`),
+  check2("ck_relay_execution_event_archive_blocks_object_size", sql2`${table.objectSize} > 0 AND ${table.objectSize} <= 16777216`),
+  check2("ck_relay_execution_event_archive_blocks_stored_payload_size", sql2`${table.storedPayloadBytes} > 0 AND ${table.storedPayloadBytes} <= 15728640`),
+  check2("ck_relay_execution_event_archive_blocks_uncompressed_size", sql2`${table.uncompressedBytes} > 0 AND ${table.uncompressedBytes} <= 15728640`),
+  check2("ck_relay_execution_event_archive_blocks_stored_size", sql2`${table.storedPayloadBytes} < ${table.objectSize}`),
+  check2("ck_relay_execution_event_archive_blocks_expansion", sql2`${table.storedPayloadBytes} <= ${table.uncompressedBytes}`),
+  check2("ck_relay_execution_event_archive_blocks_codec", sql2`${table.codecVersion} IN (1, 2)`),
+  check2("ck_relay_execution_event_archive_blocks_encoding", sql2`${table.encoding} = 'json'`),
+  check2("ck_relay_execution_event_archive_blocks_compression", sql2`(${table.codecVersion} = 1 AND ${table.compression} = 'none' AND ${table.storedPayloadBytes} = ${table.uncompressedBytes}) OR (${table.codecVersion} = 2 AND ${table.compression} = 'gzip')`),
+  check2("ck_relay_execution_event_archive_blocks_object_key", sql2`length(${table.objectKey}) <= 80`),
+  check2("ck_relay_execution_event_archive_blocks_checksum", sql2`length(${table.objectChecksum}) = 64`),
+  check2("ck_relay_execution_event_archive_blocks_payload_checksum", sql2`length(${table.payloadChecksum}) = 64`)
+]);
 var relayExecutionEvents = pgTable5("relay_execution_events", {
   tenantId: tenantId(),
   id: text6("id").$type().notNull(),
@@ -412,11 +516,23 @@ var relayExecutionEvents = pgTable5("relay_execution_events", {
   uniqueIndex3("uq_relay_execution_events_sequence").on(table.tenantId, table.executionId, table.sequence),
   uniqueIndex3("uq_relay_execution_events_cursor").on(table.tenantId, table.cursor)
 ]);
+var relayExecutionEventIdentityDirectory = pgTable5("relay_execution_event_identity_directory", {
+  tenantId: tenantId(),
+  cursor: text6("cursor").notNull(),
+  eventId: text6("event_id").$type().notNull(),
+  executionId: text6("execution_id").$type().notNull(),
+  sequence: integer4("sequence").notNull()
+}, (table) => [
+  primaryKey5({ columns: [table.tenantId, table.cursor], name: "pk_relay_execution_event_identity_directory" }),
+  uniqueIndex3("uq_relay_execution_event_identity_directory_event").on(table.tenantId, table.eventId),
+  uniqueIndex3("uq_relay_execution_event_identity_directory_sequence").on(table.tenantId, table.executionId, table.sequence)
+]);
 // ../store-sql/src/schema/communication-schema.ts
 import { index as index4, integer as integer5, jsonb as jsonb6, pgTable as pgTable6, primaryKey as primaryKey6, text as text7, timestamp as timestamp6, uniqueIndex as uniqueIndex4 } from "drizzle-orm/pg-core";
 var relaySteeringMessages = pgTable6("relay_steering_messages", {
   tenantId: tenantId(),
   executionId: text7("execution_id").notNull(),
+  idempotencyKey: text7("idempotency_key").notNull(),
   kind: text7("kind").notNull(),
   sequence: integer5("sequence").notNull(),
   contentJson: jsonb6("content_json").$type().notNull(),
@@ -428,6 +544,7 @@ var relaySteeringMessages = pgTable6("relay_steering_messages", {
     columns: [table.tenantId, table.executionId, table.kind, table.sequence],
     name: "pk_relay_steering_messages"
   }),
+  uniqueIndex4("uq_relay_steering_messages_idempotency").on(table.tenantId, table.executionId, table.idempotencyKey),
   index4("idx_relay_steering_messages_unconsumed").on(table.tenantId, table.executionId, table.kind, table.consumedAt, table.sequence),
   index4("idx_relay_steering_messages_drain").on(table.tenantId, table.executionId, table.kind, table.drainId, table.sequence)
 ]);
@@ -487,14 +604,14 @@ var relayTopicSubscriptions = pgTable6("relay_topic_subscriptions", {
   index4("idx_relay_topic_subscriptions_subscriber").on(table.tenantId, table.subscriberExecutionId)
 ]);
 // ../store-sql/src/schema/session-schema.ts
-import { bigint, boolean as boolean3, index as index5, jsonb as jsonb7, pgTable as pgTable7, primaryKey as primaryKey7, text as text8, timestamp as timestamp7 } from "drizzle-orm/pg-core";
+import { bigint as bigint2, boolean as boolean3, index as index5, jsonb as jsonb7, pgTable as pgTable7, primaryKey as primaryKey7, text as text8, timestamp as timestamp7 } from "drizzle-orm/pg-core";
 var relaySessions = pgTable7("relay_sessions", {
   tenantId: tenantId(),
   id: text8("id").$type().notNull(),
   rootAddressId: text8("root_address_id").$type().notNull(),
   leafEntryId: text8("leaf_entry_id").$type(),
   ownerExecutionId: text8("owner_execution_id").$type(),
-  ownerEpoch: bigint("owner_epoch", { mode: "number" }).notNull().default(0),
+  ownerEpoch: bigint2("owner_epoch", { mode: "number" }).notNull().default(0),
   ownerReleased: boolean3("owner_released").notNull().default(true),
   metadataJson: jsonb7("metadata_json").$type().notNull().default({}),
   createdAt: timestamp7("created_at", { withTimezone: true }).notNull().defaultNow(),
@@ -588,7 +705,7 @@ var relayRouteAttempts = pgTable8("relay_route_attempts", {
 ]);
 // ../store-sql/src/schema/workspace-schema.ts
 import { index as index7, jsonb as jsonb9, pgTable as pgTable9, primaryKey as primaryKey9, text as text10, timestamp as timestamp9, uniqueIndex as uniqueIndex6 } from "drizzle-orm/pg-core";
-import { sql as sql2 } from "drizzle-orm";
+import { sql as sql3 } from "drizzle-orm";
 var relayWorkspaceLeases = pgTable9("relay_workspace_leases", {
   tenantId: tenantId(),
   id: text10("id").$type().notNull(),
@@ -605,7 +722,7 @@ var relayWorkspaceLeases = pgTable9("relay_workspace_leases", {
   updatedAt: timestamp9("updated_at", { withTimezone: true }).notNull().defaultNow()
 }, (table) => [
   primaryKey9({ columns: [table.tenantId, table.id], name: "pk_relay_workspace_leases" }),
-  uniqueIndex6("uq_relay_workspace_leases_active_execution").on(table.tenantId, table.executionId).where(sql2`${table.status} not in ('released', 'failed')`),
+  uniqueIndex6("uq_relay_workspace_leases_active_execution").on(table.tenantId, table.executionId).where(sql3`${table.status} not in ('released', 'failed')`),
   index7("idx_relay_workspace_leases_execution").on(table.tenantId, table.executionId),
   index7("idx_relay_workspace_leases_status_updated").on(table.tenantId, table.status, table.updatedAt)
 ]);
@@ -748,7 +865,8 @@ var relayIdempotencyKeys = pgTable13("relay_idempotency_keys", {
   uniqueIndex9("uq_relay_idempotency_scope_operation_key").on(table.tenantId, table.scope, table.operation, table.key)
 ]);
 // src/postgres.ts
-var schemaHead = "20260721170000_session_writer_ownership";
+var priorSchemaHead = "20260724120000_execution_event_identity_directory";
+var schemaHead = "20260724230000_idempotent_steering";
 var migrationNames = [
   "20260701002839_sour_cerebro",
   "20260701041134_acoustic_hulk",
@@ -778,13 +896,17 @@ var migrationNames = [
   "20260718140000_execution_scoped_tool_calls",
   "20260719120000_rename_entity_to_resident",
   "20260721120000_steering_delivered",
+  "20260721170000_session_writer_ownership",
+  "20260723190000_transactional_event_head",
+  "20260724010000_execution_event_archive_manifests",
+  priorSchemaHead,
   schemaHead
 ];
 var migrationsFolderUrl = import.meta.url.endsWith("/src/postgres.ts") ? new URL("../../../migrations/pg", import.meta.url) : new URL("./migrations/pg", import.meta.url);
 var migrationsFolder = fileURLToPath(migrationsFolderUrl);
 var verifySchema = Effect2.gen(function* () {
-  const sql3 = yield* SqlClient;
-  const rows = yield* sql3`SELECT name FROM drizzle.__drizzle_migrations ORDER BY id`;
+  const sql4 = yield* SqlClient;
+  const rows = yield* sql4`SELECT name FROM drizzle.__drizzle_migrations ORDER BY id`;
   const actual = rows.map((row) => row.name).join(",");
   const expected = migrationNames.join(",");
   if (actual !== expected) {
@@ -797,8 +919,8 @@ var verifySchema = Effect2.gen(function* () {
   }
 }).pipe((effect) => normalizeMigrationCause(effect, "pg", "verify"));
 var runMigrations = normalizeMigrationCause(Effect2.gen(function* () {
-  const sql3 = yield* SqlClient;
-  const pg = sql3;
+  const sql4 = yield* SqlClient;
+  const pg = sql4;
   const database2 = yield* makeWithDefaults2().pipe(Effect2.provideService(PgClient2, pg));
   yield* runDrizzleMigrator(database2, { migrationsFolder });
 }), "pg", "apply");

package/dist/sqlite.js

@@ -2,7 +2,7 @@
 import {
   database,
   normalizeMigrationCause
-} from "./index-m7dpw880.js";
+} from "./index-skcp0xvt.js";
 import {
   DatabaseAlreadyOwned,
   RuntimeConfigurationError,
@@ -12,9 +12,9 @@ import {
   make,
   makeDatabaseIdentity,
   runtimeLayer
-} from "./index-gwgea1te.js";
+} from "./index-d1je4njg.js";
 import"./index-d5563j6w.js";
-import"./index-nb078xsy.js";
+import"./index-j8k41y47.js";
 import"./index-nb39b5ae.js";
 
 // src/sqlite-runtime.ts
@@ -682,6 +682,103 @@ ALTER TABLE "relay_sessions" ADD COLUMN "owner_epoch" INTEGER NOT NULL DEFAULT 0
 ALTER TABLE "relay_sessions" ADD COLUMN "owner_released" INTEGER NOT NULL DEFAULT 1;
 `;
 
+// ../../migrations/sqlite/0015_transactional_event_head.sql
+var _0015_transactional_event_head_default = `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";
+`;
+
+// ../../migrations/sqlite/0016_execution_event_archive_manifests.sql
+var _0016_execution_event_archive_manifests_default = `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")
+);
+`;
+
+// ../../migrations/sqlite/0017_execution_event_identity_directory.sql
+var _0017_execution_event_identity_directory_default = `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";
+`;
+
+// ../../migrations/sqlite/0018_idempotent_steering.sql
+var _0018_idempotent_steering_default = `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");
+`;
+
 // src/sqlite-migrations.ts
 import { Effect } from "effect";
 import { SqlClient } from "effect/unstable/sql/SqlClient";
@@ -706,7 +803,21 @@ var migrations = [
   { id: 11, name: "execution_scoped_tool_calls", file: "0011_execution_scoped_tool_calls.sql", source: _0011_execution_scoped_tool_calls_default },
   { id: 12, name: "rename_entity_to_resident", file: "0012_rename_entity_to_resident.sql", source: _0012_rename_entity_to_resident_default },
   { id: 13, name: "steering_delivered", file: "0013_steering_delivered.sql", source: _0013_steering_delivered_default },
-  { id: 14, name: "session_writer_ownership", file: "0014_session_writer_ownership.sql", source: _0014_session_writer_ownership_default }
+  { id: 14, name: "session_writer_ownership", file: "0014_session_writer_ownership.sql", source: _0014_session_writer_ownership_default },
+  { id: 15, name: "transactional_event_head", file: "0015_transactional_event_head.sql", source: _0015_transactional_event_head_default },
+  {
+    id: 16,
+    name: "execution_event_archive_manifests",
+    file: "0016_execution_event_archive_manifests.sql",
+    source: _0016_execution_event_archive_manifests_default
+  },
+  {
+    id: 17,
+    name: "execution_event_identity_directory",
+    file: "0017_execution_event_identity_directory.sql",
+    source: _0017_execution_event_identity_directory_default
+  },
+  { id: 18, name: "idempotent_steering", file: "0018_idempotent_steering.sql", source: _0018_idempotent_steering_default }
 ];
 var loader = Effect.succeed(migrations.map(({ id, name, source }) => [id, name, Effect.succeed(execute(source))]));
 

package/dist/types/relay/client-public-executions.d.ts

@@ -7,7 +7,7 @@ export declare const startExecution: (input: StartExecutionInput) => Effect.Effe
 export declare const startExecutionByAddress: (input: StartExecutionByAddressInput) => Effect.Effect<import("./operation").StartExecutionResult, ClientError | import("./client-public").ResidentNamespaceReserved, Service>;
 export declare const startExecutionByAgentDefinition: (input: StartExecutionByAgentDefinitionInput) => Effect.Effect<import("./operation").StartExecutionResult, ClientError | import("./client-public").ResidentNamespaceReserved, Service>;
 export declare const cancelExecution: (input: CancelExecutionInput) => Effect.Effect<import("./operation").CancelExecutionAccepted, ClientError, Service>;
-export declare const steer: (input: SteerInput) => Effect.Effect<import("./operation").SteerAccepted, ClientError, Service>;
+export declare const steer: (input: SteerInput) => Effect.Effect<import("./operation").SteerAccepted, ClientError | import("./operation").SteeringIdempotencyConflict, Service>;
 export declare const getExecution: (id: Ids.ExecutionId) => Effect.Effect<Execution.Execution | undefined, ClientError, Service>;
 export declare const listExecutions: (input: ListExecutionsInput) => Effect.Effect<import("./operation").ListExecutionsResult, ClientError, Service>;
 export declare const listSessions: (input: ListSessionsInput) => Effect.Effect<import("./operation").ListSessionsResult, ClientError, Service>;

package/dist/types/relay/client-public.d.ts

@@ -4,7 +4,7 @@ import type { Agent as BatonAgent } from "@batonfx/core";
 import { Address, Agent, ChildOrchestration, Content, Resident, Envelope, Execution, Ids, Inbox, Presence, Shared, Skill, State, Tool, Workflow } from "../schema/index";
 import { Context, Effect, Schema, Stream } from "effect";
 import type { Tool as BatonTool } from "effect/unstable/ai";
-import type { AckEnvelopeReadyInput, CancelExecutionAccepted, CancelExecutionInput, CancelScheduleInput, CancelScheduleResult, ClaimEnvelopeReadyInput, CreateScheduleInput, CreateScheduleResult, EnvelopeReadyAcked, EnvelopeReadyLease, EnvelopeReadyReleased, ExecutionInspection, ExecutionListChange, GetSessionInput, GetSessionResult, GetResidentStateInput, PutResidentStateInput, DeleteResidentStateInput, ListResidentStateInput, SpawnResidentInput, GetResidentInput, DestroyResidentInput, ListResidentsInput, ListExecutionsInput, ListExecutionsResult, ListInboxMessagesInput, ListTopicSubscriptionsInput, PublishTopicInput, SubscribeTopicInput, TopicPublishAccepted, TopicSubscription, UnsubscribeTopicInput, ListPendingApprovalsInput, SessionStreamItem, StreamSessionInput, WatchExecutionsInput, ListRunnersResult, ListSchedulesInput, ListSchedulesResult, ListSessionsInput, ListSessionsResult, ListWaitsInput, PendingToolApprovalList, PendingToolCallList, ListPendingToolCallsInput, FulfillToolCallInput, ClaimToolWorkInput, CompleteToolWorkInput, ReleaseToolWorkInput, ListToolAttemptsInput, ToolAttemptList, ToolOutcomeAccepted, ToolWorkLease, ToolWorkReleased, ReleaseEnvelopeReadyInput, PageExecutionEventsInput, PageExecutionEventsResult, ReplayExecutionInput, ReplayExecutionResult, ResolvePermissionInput, ResolveToolApprovalInput, RouteExecutionResult, StartExecutionInput, StartExecutionResult, SpawnChildRunInput, CancelChildFanOutInput, CancelChildFanOutResult, CreateChildFanOutInput, InspectChildFanOutInput, InspectChildFanOutResult, SteerAccepted, SteerInput, StreamExecutionInput, SubmitInboundEnvelopeAccepted, SubmitInboundEnvelopeInput, WaitView, WakeAccepted, WakeInput } from "./operation";
+import type { AckEnvelopeReadyInput, CancelExecutionAccepted, CancelExecutionInput, CancelScheduleInput, CancelScheduleResult, ClaimEnvelopeReadyInput, CreateScheduleInput, CreateScheduleResult, EnvelopeReadyAcked, EnvelopeReadyLease, EnvelopeReadyReleased, ExecutionInspection, ExecutionListChange, GetSessionInput, GetSessionResult, GetResidentStateInput, PutResidentStateInput, DeleteResidentStateInput, ListResidentStateInput, SpawnResidentInput, GetResidentInput, DestroyResidentInput, ListResidentsInput, ListExecutionsInput, ListExecutionsResult, ListInboxMessagesInput, ListTopicSubscriptionsInput, PublishTopicInput, SubscribeTopicInput, TopicPublishAccepted, TopicSubscription, UnsubscribeTopicInput, ListPendingApprovalsInput, SessionStreamItem, StreamSessionInput, WatchExecutionsInput, ListRunnersResult, ListSchedulesInput, ListSchedulesResult, ListSessionsInput, ListSessionsResult, ListWaitsInput, PendingToolApprovalList, PendingToolCallList, ListPendingToolCallsInput, FulfillToolCallInput, ClaimToolWorkInput, CompleteToolWorkInput, ReleaseToolWorkInput, ListToolAttemptsInput, ToolAttemptList, ToolOutcomeAccepted, ToolWorkLease, ToolWorkReleased, ReleaseEnvelopeReadyInput, PageExecutionEventsInput, PageExecutionEventsResult, ReplayExecutionInput, ReplayExecutionResult, ResolvePermissionInput, ResolveToolApprovalInput, RouteExecutionResult, StartExecutionInput, StartExecutionResult, SpawnChildRunInput, CancelChildFanOutInput, CancelChildFanOutResult, CreateChildFanOutInput, InspectChildFanOutInput, InspectChildFanOutResult, SteerAccepted, SteerInput, SteeringIdempotencyConflict, StreamExecutionInput, SubmitInboundEnvelopeAccepted, SubmitInboundEnvelopeInput, WaitView, WakeAccepted, WakeInput } from "./operation";
 import { EventLogCursorNotFound } from "./operation";
 export { EventLogCursorNotFound } from "./operation";
 import { AwaitWaitInput, WaitOutcome } from "./operation";
@@ -130,7 +130,7 @@ export interface FlatInterface {
     readonly startExecutionByAddress: (input: StartExecutionByAddressInput) => Effect.Effect<StartExecutionResult, ResidentNamespaceReserved | ClientError>;
     readonly startExecutionByAgentDefinition: (input: StartExecutionByAgentDefinitionInput) => Effect.Effect<StartExecutionResult, ResidentNamespaceReserved | ClientError>;
     readonly cancelExecution: (input: CancelExecutionInput) => Effect.Effect<CancelExecutionAccepted, ClientError>;
-    readonly steer: (input: SteerInput) => Effect.Effect<SteerAccepted, ClientError>;
+    readonly steer: (input: SteerInput) => Effect.Effect<SteerAccepted, ClientError | SteeringIdempotencyConflict>;
     readonly getExecution: (id: Ids.ExecutionId) => Effect.Effect<Execution.Execution | undefined, ClientError>;
     readonly inspectExecution: (executionId: Ids.ExecutionId) => Effect.Effect<ExecutionInspection, ExecutionNotFound | ClientError>;
     readonly listExecutions: (input: ListExecutionsInput) => Effect.Effect<ListExecutionsResult, ClientError>;

package/dist/types/relay/http-server.d.ts

@@ -3,7 +3,7 @@ export { StateVersionConflict } from "./state-version-conflict";
 import type { StateVersionConflict } from "./state-version-conflict";
 import { Context } from "effect";
 import type { Effect, Scope, Stream } from "effect";
-import type { CancelExecutionAccepted, CancelExecutionInput, ClaimToolWorkInput, CompleteToolWorkInput, DeleteResidentStateInput, DestroyResidentInput, ExecutionInspection, ExecutionListChange, FulfillToolCallInput, GetResidentInput, GetResidentStateInput, ListResidentsInput, ListExecutionsInput, ListExecutionsResult, ListInboxMessagesInput, ListPendingToolCallsInput, ListResidentStateInput, ListToolAttemptsInput, ListWaitsInput, PendingToolCallList, PutResidentStateInput, ReleaseToolWorkInput, ResolvePermissionInput, SessionStreamItem, SpawnResidentInput, SpawnChildRunInput, StartExecutionResult, SteerAccepted, SteerInput, StreamExecutionInput, StreamSessionInput, ToolAttemptList, ToolOutcomeAccepted, ToolWorkLease, ToolWorkReleased, WaitView, WakeAccepted, WakeInput, WatchExecutionsInput } from "./operation";
+import type { CancelExecutionAccepted, CancelExecutionInput, ClaimToolWorkInput, CompleteToolWorkInput, DeleteResidentStateInput, DestroyResidentInput, ExecutionInspection, ExecutionListChange, FulfillToolCallInput, GetResidentInput, GetResidentStateInput, ListResidentsInput, ListExecutionsInput, ListExecutionsResult, ListInboxMessagesInput, ListPendingToolCallsInput, ListResidentStateInput, ListToolAttemptsInput, ListWaitsInput, PendingToolCallList, PutResidentStateInput, ReleaseToolWorkInput, ResolvePermissionInput, SessionStreamItem, SpawnResidentInput, SpawnChildRunInput, StartExecutionResult, SteerAccepted, SteerInput, SteeringIdempotencyConflict, StreamExecutionInput, StreamSessionInput, ToolAttemptList, ToolOutcomeAccepted, ToolWorkLease, ToolWorkReleased, WaitView, WakeAccepted, WakeInput, WatchExecutionsInput } from "./operation";
 export interface ClientError {
     readonly _tag: "ClientError";
     readonly message: string;
@@ -49,7 +49,7 @@ export interface ClientInterface {
     readonly executions: {
         readonly startByAddress: (input: StartExecutionByAddressInput) => Effect.Effect<StartExecutionResult, ResidentNamespaceReserved | ClientError>;
         readonly cancel: (input: CancelExecutionInput) => Effect.Effect<CancelExecutionAccepted, ClientError>;
-        readonly steer: (input: SteerInput) => Effect.Effect<SteerAccepted, ClientError>;
+        readonly steer: (input: SteerInput) => Effect.Effect<SteerAccepted, ClientError | SteeringIdempotencyConflict>;
         readonly get: (id: Ids.ExecutionId) => Effect.Effect<Execution.Execution | undefined, ClientError>;
         readonly inspect: (executionId: Ids.ExecutionId) => Effect.Effect<ExecutionInspection, ExecutionNotFound | ClientError>;
         readonly list: (input: ListExecutionsInput) => Effect.Effect<ListExecutionsResult, ClientError>;

package/dist/types/relay/mysql-migrations.d.ts

@@ -1 +1 @@
-export declare const migrations: readonly [readonly [1, "baseline", string], readonly [2, "durable_tool_placement", string], readonly [3, "durable_inbox", string], readonly [4, "execution_state", string], readonly [5, "durable_entities", string], readonly [6, "ephemeral_presence", string], readonly [7, "topic_subscriptions", string], readonly [8, "child_fan_out", string], readonly [9, "workflow_definitions", string], readonly [10, "workflow_runtime", string], readonly [11, "execution_scoped_tool_calls", string], readonly [12, "rename_entity_to_resident", string], readonly [13, "steering_delivered", string], readonly [14, "session_writer_ownership", string]];
+export declare const migrations: readonly [readonly [1, "baseline", string], readonly [2, "durable_tool_placement", string], readonly [3, "durable_inbox", string], readonly [4, "execution_state", string], readonly [5, "durable_entities", string], readonly [6, "ephemeral_presence", string], readonly [7, "topic_subscriptions", string], readonly [8, "child_fan_out", string], readonly [9, "workflow_definitions", string], readonly [10, "workflow_runtime", string], readonly [11, "execution_scoped_tool_calls", string], readonly [12, "rename_entity_to_resident", string], readonly [13, "steering_delivered", string], readonly [14, "session_writer_ownership", string], readonly [15, "transactional_event_head", string], readonly [16, "execution_event_archive_manifests", string], readonly [17, "execution_event_identity_directory", string], readonly [18, "idempotent_steering", string]];

package/dist/types/relay/operation.d.ts

@@ -454,6 +454,7 @@ export declare const SteerInput: Schema.Struct<{
     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 idempotency_key: Schema.String;
     readonly kind: Schema.Literals<readonly ["steering", "follow_up"]>;
     readonly content: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
         readonly type: Schema.Literal<"text">;
@@ -508,6 +509,14 @@ export declare const SteerInput: Schema.Struct<{
 }>;
 export interface SteerInput extends Schema.Schema.Type<typeof SteerInput> {
 }
+declare const SteeringIdempotencyConflict_base: Schema.Class<SteeringIdempotencyConflict, Schema.TaggedStruct<"SteeringIdempotencyConflict", {
+    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 idempotency_key: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class SteeringIdempotencyConflict extends SteeringIdempotencyConflict_base {
+}
 export declare const SteerAccepted: Schema.Struct<{
     readonly execution_id: Schema.brand<Schema.String, "Relay.ExecutionId"> & {
         make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.ExecutionId">;

package/dist/types/relay/sqlite-migrations.d.ts

@@ -70,5 +70,25 @@ export declare const migrations: readonly [{
     readonly name: "session_writer_ownership";
     readonly file: "0014_session_writer_ownership.sql";
     readonly source: string;
+}, {
+    readonly id: 15;
+    readonly name: "transactional_event_head";
+    readonly file: "0015_transactional_event_head.sql";
+    readonly source: string;
+}, {
+    readonly id: 16;
+    readonly name: "execution_event_archive_manifests";
+    readonly file: "0016_execution_event_archive_manifests.sql";
+    readonly source: string;
+}, {
+    readonly id: 17;
+    readonly name: "execution_event_identity_directory";
+    readonly file: "0017_execution_event_identity_directory.sql";
+    readonly source: string;
+}, {
+    readonly id: 18;
+    readonly name: "idempotent_steering";
+    readonly file: "0018_idempotent_steering.sql";
+    readonly source: string;
 }];
-export declare const loader: Effect.Effect<(readonly [1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14, "baseline" | "child_fan_out" | "durable_entities" | "durable_inbox" | "durable_tool_placement" | "ephemeral_presence" | "execution_scoped_tool_calls" | "execution_state" | "rename_entity_to_resident" | "session_writer_ownership" | "steering_delivered" | "topic_subscriptions" | "workflow_definitions" | "workflow_runtime", Effect.Effect<Effect.Effect<void, import("effect/unstable/sql/SqlError").SqlError, SqlClient>, never, never>])[], never, never>;
+export declare const loader: Effect.Effect<(readonly [1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18, "baseline" | "child_fan_out" | "durable_entities" | "durable_inbox" | "durable_tool_placement" | "ephemeral_presence" | "execution_event_archive_manifests" | "execution_event_identity_directory" | "execution_scoped_tool_calls" | "execution_state" | "idempotent_steering" | "rename_entity_to_resident" | "session_writer_ownership" | "steering_delivered" | "topic_subscriptions" | "transactional_event_head" | "workflow_definitions" | "workflow_runtime", Effect.Effect<Effect.Effect<void, import("effect/unstable/sql/SqlError").SqlError, SqlClient>, never, never>])[], never, never>;