@relayfx/sdk 0.4.2 → 0.5.0

package/dist/http-server.js

@@ -4,7 +4,7 @@ import {
   Service,
   Service1 as Service2,
   StateVersionConflict
-} from "./index-3w6txjtg.js";
+} from "./index-fh2ftte9.js";
 import"./index-nb39b5ae.js";
 
 // src/http-server.ts

package/dist/{index-y9ncz0zd.js → index-8asvg7x0.js}

@@ -46,7 +46,7 @@ import {
   exports_workflow_schema,
   exports_workspace_schema,
   followExecutionFrom
-} from "./index-3w6txjtg.js";
+} from "./index-fh2ftte9.js";
 import {
   __export
 } from "./index-nb39b5ae.js";
@@ -15521,10 +15521,10 @@ var contentFromMessage = (message) => {
     return textParts;
   return [exports_content_schema.text(prompt.pipe(Schema81.encodeSync(Prompt5.Prompt), stringifyJson2))];
 };
-var steeringReceivedEvent = (config, kind, drain2, messages, sequence) => ({
-  id: exports_ids_schema.EventId.make(`event:${drain2.drainId}:received`),
+var steeringDeliveredEvent = (config, kind, drain2, messages, sequence) => ({
+  id: exports_ids_schema.EventId.make(`event:${drain2.drainId}:delivered`),
   execution_id: config.executionId,
-  type: "steering.received",
+  type: "steering.delivered",
   sequence,
   cursor: `${config.executionId}:steering:${kind}:${drain2.drainId}`,
   content: messages.flatMap((message) => message.content),
@@ -15547,7 +15547,7 @@ var drain2 = Effect89.fn("RelaySteering.drain")(function* (config, kind, mode) {
     consumedAt: createdAt,
     createdAt
   });
-  yield* appendIdempotentTo(config.eventLog, steeringReceivedEvent(config, kind, result.drain, result.messages, sequence));
+  yield* appendIdempotentTo(config.eventLog, steeringDeliveredEvent(config, kind, result.drain, result.messages, sequence));
   return result.messages.map((message) => ({ prompt: promptForContent(message.content) }));
 });
 var append4 = (config, kind, message) => Clock16.currentTimeMillis.pipe(Effect89.flatMap((createdAt) => config.repository.append({
@@ -18851,7 +18851,16 @@ var layerFromRuntime3 = Layer84.effect(Service, Effect109.gen(function* () {
         content: input.content,
         createdAt: input.created_at
       }).pipe(Effect109.mapError(toClientError));
-      return { execution_id: record2.executionId, kind: record2.kind, sequence: record2.sequence };
+      return {
+        execution_id: record2.executionId,
+        kind: record2.kind,
+        sequence: record2.sequence,
+        steering_message_id: exports_execution_schema.steeringMessageId({
+          execution_id: record2.executionId,
+          kind: record2.kind,
+          sequence: record2.sequence
+        })
+      };
     }),
     getExecution: getExecutionOperation,
     inspectExecution: inspectExecutionOperation,

package/dist/{index-3w6txjtg.js → index-fh2ftte9.js}

@@ -59,6 +59,7 @@ __export2(exports_ids_schema, {
   ToolAttemptId: () => ToolAttemptId,
   TenantId: () => TenantId,
   SystemTenantId: () => SystemTenantId,
+  SteeringMessageId: () => SteeringMessageId,
   SnapshotRef: () => SnapshotRef,
   SkillDefinitionId: () => SkillDefinitionId,
   SessionId: () => SessionId,
@@ -110,6 +111,7 @@ var ToolAttemptId = id("Relay.ToolAttemptId");
 var WaitId = id("Relay.WaitId");
 var ScheduleId = id("Relay.ScheduleId");
 var EventId = id("Relay.EventId");
+var SteeringMessageId = id("Relay.SteeringMessageId");
 var exports_shared_schema = {};
 __export2(exports_shared_schema, {
   canonicalValue: () => canonicalValue,
@@ -517,6 +519,7 @@ __export2(exports_child_orchestration_schema, {
 });
 var exports_execution_schema = {};
 __export2(exports_execution_schema, {
+  steeringMessageId: () => steeringMessageId,
   childSessionId: () => childSessionId,
   SpawnChildRunInput: () => SpawnChildRunInput,
   ExecutionStatus: () => ExecutionStatus,
@@ -659,6 +662,7 @@ var ChildRunAccepted = Schema7.Struct({
   execution_id: ExecutionId
 }).annotate({ identifier: "Relay.ChildRunAccepted" });
 var childSessionId = (childExecutionId) => SessionId.make(`session:child:${childExecutionId}`);
+var steeringMessageId = (input) => SteeringMessageId.make(`steering:${input.execution_id}:${input.kind}:${input.sequence}`);
 var ExecutionEventType = Schema7.Literals([
   "execution.accepted",
   "execution.started",
@@ -679,7 +683,7 @@ var ExecutionEventType = Schema7.Literals([
   "tool.approval.resolved",
   "permission.ask.requested",
   "permission.ask.resolved",
-  "steering.received",
+  "steering.delivered",
   "state.updated",
   "state.deleted",
   "inbox.enqueued",
@@ -1928,7 +1932,8 @@ var SteerInput = Schema22.Struct({
 var SteerAccepted = Schema22.Struct({
   execution_id: exports_ids_schema.ExecutionId,
   kind: SteeringKind,
-  sequence: Schema22.Int.check(Schema22.isGreaterThanOrEqualTo(0))
+  sequence: Schema22.Int.check(Schema22.isGreaterThanOrEqualTo(0)),
+  steering_message_id: exports_ids_schema.SteeringMessageId
 }).annotate({ identifier: "Relay.Operation.SteerAccepted" });
 var WakeInput = Schema22.Struct({
   wait_id: exports_ids_schema.WaitId,

package/dist/{index-4y9111jh.js → index-h1cf8za4.js}

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

package/dist/index.js

@@ -14,7 +14,7 @@ import {
   exports_tool_runtime,
   exports_workflow_definition_host,
   makeDatabaseIdentity
-} from "./index-y9ncz0zd.js";
+} from "./index-8asvg7x0.js";
 import {
   exports_model_registry
 } from "./index-x32kbvxv.js";
@@ -46,7 +46,7 @@ import {
   exports_wait_schema,
   exports_workflow_schema,
   followExecutionFrom
-} from "./index-3w6txjtg.js";
+} from "./index-fh2ftte9.js";
 import {
   __export
 } from "./index-nb39b5ae.js";
@@ -144,7 +144,7 @@ var runOnce = Effect2.fn("ToolWorker.runOnce")(function* (options) {
 });
 var run = Effect2.fn("ToolWorker.run")(function* (options) {
   const pollInterval = Duration.fromInputUnsafe(options.pollInterval ?? "1 second");
-  return yield* runOnce(options).pipe(Effect2.flatMap((worked) => worked ? Effect2.void : Effect2.sleep(pollInterval)), Effect2.forever);
+  return yield* runOnce(options).pipe(Effect2.catch((error) => Effect2.logWarning("relay tool worker poll failed", { message: error.message }).pipe(Effect2.as(false))), Effect2.flatMap((worked) => worked ? Effect2.void : Effect2.sleep(pollInterval)), Effect2.forever);
 });
 
 // src/language-model-registration.ts

package/dist/migrations/20260721120000_steering_delivered/migration.sql

@@ -0,0 +1,3 @@
+UPDATE "relay_execution_events"
+SET "type" = 'steering.delivered', "id" = replace("id", ':received', ':delivered')
+WHERE "type" = 'steering.received';

package/dist/migrations/mysql/0013_steering_delivered.sql

@@ -0,0 +1,3 @@
+UPDATE relay_execution_events
+SET type = 'steering.delivered', id = replace(id, ':received', ':delivered')
+WHERE type = 'steering.received';

package/dist/migrations/pg/20260721120000_steering_delivered/migration.sql

@@ -0,0 +1,3 @@
+UPDATE "relay_execution_events"
+SET "type" = 'steering.delivered', "id" = replace("id", ':received', ':delivered')
+WHERE "type" = 'steering.received';

package/dist/migrations/sqlite/0013_steering_delivered.sql

@@ -0,0 +1,3 @@
+UPDATE relay_execution_events
+SET type = 'steering.delivered', id = replace(id, ':received', ':delivered')
+WHERE type = 'steering.received';

package/dist/mysql.js

@@ -2,14 +2,14 @@
 import {
   database,
   normalizeMigrationCause
-} from "./index-4y9111jh.js";
+} from "./index-h1cf8za4.js";
 import {
   MigratorError,
   RuntimeMigrationError,
   SqlFailure
-} from "./index-y9ncz0zd.js";
+} from "./index-8asvg7x0.js";
 import"./index-x32kbvxv.js";
-import"./index-3w6txjtg.js";
+import"./index-fh2ftte9.js";
 import"./index-nb39b5ae.js";
 
 // src/mysql.ts
@@ -83,6 +83,12 @@ RENAME TABLE relay_entity_instances TO relay_resident_instances;
 ALTER TABLE relay_resident_instances RENAME INDEX idx_relay_entity_instances_kind_status TO idx_relay_resident_instances_kind_status;
 `;
 
+// ../../migrations/mysql/0013_steering_delivered.sql
+var _0013_steering_delivered_default = `UPDATE relay_execution_events
+SET type = 'steering.delivered', id = replace(id, ':received', ':delivered')
+WHERE type = 'steering.received';
+`;
+
 // src/mysql-migrations.ts
 var migrations = [
   [1, "baseline", _0001_baseline_default],
@@ -96,7 +102,8 @@ var migrations = [
   [9, "workflow_definitions", _0009_workflow_definitions_default],
   [10, "workflow_runtime", _0010_workflow_runtime_default],
   [11, "execution_scoped_tool_calls", _0011_execution_scoped_tool_calls_default],
-  [12, "rename_entity_to_resident", _0012_rename_entity_to_resident_default]
+  [12, "rename_entity_to_resident", _0012_rename_entity_to_resident_default],
+  [13, "steering_delivered", _0013_steering_delivered_default]
 ];
 
 // src/mysql.ts

package/dist/postgres.js

@@ -2,7 +2,7 @@
 import {
   database,
   normalizeMigrationCause
-} from "./index-4y9111jh.js";
+} from "./index-h1cf8za4.js";
 import {
   Dialect,
   RuntimeMigrationError,
@@ -14,11 +14,11 @@ import {
   fromDbTimestamp,
   fromNullableDbTimestamp,
   timestampParam
-} from "./index-y9ncz0zd.js";
+} from "./index-8asvg7x0.js";
 import"./index-x32kbvxv.js";
 import {
   exports_ids_schema
-} from "./index-3w6txjtg.js";
+} from "./index-fh2ftte9.js";
 import {
   __export
 } from "./index-nb39b5ae.js";
@@ -745,7 +745,7 @@ 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 = "20260719120000_rename_entity_to_resident";
+var schemaHead = "20260721120000_steering_delivered";
 var migrationNames = [
   "20260701002839_sour_cerebro",
   "20260701041134_acoustic_hulk",
@@ -773,6 +773,7 @@ var migrationNames = [
   "20260712190000_workflow_definitions",
   "20260712200000_workflow_runtime",
   "20260718140000_execution_scoped_tool_calls",
+  "20260719120000_rename_entity_to_resident",
   schemaHead
 ];
 var migrationsFolderUrl = import.meta.url.endsWith("/src/postgres.ts") ? new URL("../../../migrations/pg", import.meta.url) : new URL("./migrations/pg", import.meta.url);

package/dist/sqlite.js

@@ -2,7 +2,7 @@
 import {
   database,
   normalizeMigrationCause
-} from "./index-4y9111jh.js";
+} from "./index-h1cf8za4.js";
 import {
   DatabaseAlreadyOwned,
   RuntimeConfigurationError,
@@ -12,9 +12,9 @@ import {
   make,
   makeDatabaseIdentity,
   runtimeLayer
-} from "./index-y9ncz0zd.js";
+} from "./index-8asvg7x0.js";
 import"./index-x32kbvxv.js";
-import"./index-3w6txjtg.js";
+import"./index-fh2ftte9.js";
 import"./index-nb39b5ae.js";
 
 // src/sqlite-runtime.ts
@@ -668,6 +668,12 @@ DROP INDEX idx_relay_entity_instances_kind_status;
 CREATE INDEX idx_relay_resident_instances_kind_status ON relay_resident_instances (tenant_id, kind, status);
 `;
 
+// ../../migrations/sqlite/0013_steering_delivered.sql
+var _0013_steering_delivered_default = `UPDATE relay_execution_events
+SET type = 'steering.delivered', id = replace(id, ':received', ':delivered')
+WHERE type = 'steering.received';
+`;
+
 // src/sqlite-migrations.ts
 import { Effect } from "effect";
 import { SqlClient } from "effect/unstable/sql/SqlClient";
@@ -690,7 +696,8 @@ var migrations = [
   { id: 9, name: "workflow_definitions", file: "0009_workflow_definitions.sql", source: _0009_workflow_definitions_default },
   { id: 10, name: "workflow_runtime", file: "0010_workflow_runtime.sql", source: _0010_workflow_runtime_default },
   { 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: 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 }
 ];
 var loader = Effect.succeed(migrations.map(({ id, name, source }) => [id, name, Effect.succeed(execute(source))]));
 

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

@@ -31,7 +31,7 @@ export declare const followExecution: (input: FollowExecutionInput) => Stream.St
         readonly child_execution_id: import("effect/Schema").optionalKey<import("effect/Schema").brand<import("effect/Schema").String, "Relay.ChildExecutionId"> & {
             make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.ChildExecutionId">;
         }>;
-        readonly type: import("effect/Schema").Literals<readonly ["execution.accepted", "execution.started", "execution.completed", "execution.failed", "execution.cancelled", "model.input.prepared", "model.output.delta", "model.reasoning.delta", "model.toolcall.delta", "model.output.completed", "model.usage.reported", "agent.compaction.committed", "budget.exceeded", "tool.call.requested", "tool.result.received", "tool.approval.requested", "tool.approval.resolved", "permission.ask.requested", "permission.ask.resolved", "steering.received", "state.updated", "state.deleted", "inbox.enqueued", "inbox.drained", "resident.created", "resident.destroyed", "envelope.accepted", "envelope.routed", "envelope.ready", "delivery.attempt", "wait.created", "wait.woken", "wait.timed_out", "wait.cancelled", "child_run.spawned", "child_run.event", "child_fan_out.created", "child_fan_out.member.admitted", "child_fan_out.member.terminal", "child_fan_out.terminal", "workspace.lease.planned", "workspace.lease.acquired", "workspace.suspended", "workspace.resumed", "workspace.snapshot.created", "workspace.lease.released", "workspace.lease.failed"]>;
+        readonly type: import("effect/Schema").Literals<readonly ["execution.accepted", "execution.started", "execution.completed", "execution.failed", "execution.cancelled", "model.input.prepared", "model.output.delta", "model.reasoning.delta", "model.toolcall.delta", "model.output.completed", "model.usage.reported", "agent.compaction.committed", "budget.exceeded", "tool.call.requested", "tool.result.received", "tool.approval.requested", "tool.approval.resolved", "permission.ask.requested", "permission.ask.resolved", "steering.delivered", "state.updated", "state.deleted", "inbox.enqueued", "inbox.drained", "resident.created", "resident.destroyed", "envelope.accepted", "envelope.routed", "envelope.ready", "delivery.attempt", "wait.created", "wait.woken", "wait.timed_out", "wait.cancelled", "child_run.spawned", "child_run.event", "child_fan_out.created", "child_fan_out.member.admitted", "child_fan_out.member.terminal", "child_fan_out.terminal", "workspace.lease.planned", "workspace.lease.acquired", "workspace.suspended", "workspace.resumed", "workspace.snapshot.created", "workspace.lease.released", "workspace.lease.failed"]>;
         readonly sequence: import("effect/Schema").Int;
         readonly cursor: import("effect/Schema").String;
         readonly content: import("effect/Schema").optionalKey<import("effect/Schema").$Array<import("effect/Schema").Union<readonly [import("effect/Schema").Struct<{
@@ -151,7 +151,7 @@ export declare const streamSession: (input: StreamSessionInput) => Stream.Stream
         readonly child_execution_id: import("effect/Schema").optionalKey<import("effect/Schema").brand<import("effect/Schema").String, "Relay.ChildExecutionId"> & {
             make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.ChildExecutionId">;
         }>;
-        readonly type: import("effect/Schema").Literals<readonly ["execution.accepted", "execution.started", "execution.completed", "execution.failed", "execution.cancelled", "model.input.prepared", "model.output.delta", "model.reasoning.delta", "model.toolcall.delta", "model.output.completed", "model.usage.reported", "agent.compaction.committed", "budget.exceeded", "tool.call.requested", "tool.result.received", "tool.approval.requested", "tool.approval.resolved", "permission.ask.requested", "permission.ask.resolved", "steering.received", "state.updated", "state.deleted", "inbox.enqueued", "inbox.drained", "resident.created", "resident.destroyed", "envelope.accepted", "envelope.routed", "envelope.ready", "delivery.attempt", "wait.created", "wait.woken", "wait.timed_out", "wait.cancelled", "child_run.spawned", "child_run.event", "child_fan_out.created", "child_fan_out.member.admitted", "child_fan_out.member.terminal", "child_fan_out.terminal", "workspace.lease.planned", "workspace.lease.acquired", "workspace.suspended", "workspace.resumed", "workspace.snapshot.created", "workspace.lease.released", "workspace.lease.failed"]>;
+        readonly type: import("effect/Schema").Literals<readonly ["execution.accepted", "execution.started", "execution.completed", "execution.failed", "execution.cancelled", "model.input.prepared", "model.output.delta", "model.reasoning.delta", "model.toolcall.delta", "model.output.completed", "model.usage.reported", "agent.compaction.committed", "budget.exceeded", "tool.call.requested", "tool.result.received", "tool.approval.requested", "tool.approval.resolved", "permission.ask.requested", "permission.ask.resolved", "steering.delivered", "state.updated", "state.deleted", "inbox.enqueued", "inbox.drained", "resident.created", "resident.destroyed", "envelope.accepted", "envelope.routed", "envelope.ready", "delivery.attempt", "wait.created", "wait.woken", "wait.timed_out", "wait.cancelled", "child_run.spawned", "child_run.event", "child_fan_out.created", "child_fan_out.member.admitted", "child_fan_out.member.terminal", "child_fan_out.terminal", "workspace.lease.planned", "workspace.lease.acquired", "workspace.suspended", "workspace.resumed", "workspace.snapshot.created", "workspace.lease.released", "workspace.lease.failed"]>;
         readonly sequence: import("effect/Schema").Int;
         readonly cursor: import("effect/Schema").String;
         readonly content: import("effect/Schema").optionalKey<import("effect/Schema").$Array<import("effect/Schema").Union<readonly [import("effect/Schema").Struct<{

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]];
+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]];

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

@@ -504,6 +504,9 @@ export declare const SteerAccepted: Schema.Struct<{
     };
     readonly kind: Schema.Literals<readonly ["steering", "follow_up"]>;
     readonly sequence: Schema.Int;
+    readonly steering_message_id: Schema.brand<Schema.String, "Relay.SteeringMessageId"> & {
+        make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.SteeringMessageId">;
+    };
 }>;
 export interface SteerAccepted extends Schema.Schema.Type<typeof SteerAccepted> {
 }
@@ -647,7 +650,7 @@ export declare const FollowExecutionItem: Schema.Union<readonly [Schema.Struct<{
         readonly child_execution_id: Schema.optionalKey<Schema.brand<Schema.String, "Relay.ChildExecutionId"> & {
             make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.ChildExecutionId">;
         }>;
-        readonly type: Schema.Literals<readonly ["execution.accepted", "execution.started", "execution.completed", "execution.failed", "execution.cancelled", "model.input.prepared", "model.output.delta", "model.reasoning.delta", "model.toolcall.delta", "model.output.completed", "model.usage.reported", "agent.compaction.committed", "budget.exceeded", "tool.call.requested", "tool.result.received", "tool.approval.requested", "tool.approval.resolved", "permission.ask.requested", "permission.ask.resolved", "steering.received", "state.updated", "state.deleted", "inbox.enqueued", "inbox.drained", "resident.created", "resident.destroyed", "envelope.accepted", "envelope.routed", "envelope.ready", "delivery.attempt", "wait.created", "wait.woken", "wait.timed_out", "wait.cancelled", "child_run.spawned", "child_run.event", "child_fan_out.created", "child_fan_out.member.admitted", "child_fan_out.member.terminal", "child_fan_out.terminal", "workspace.lease.planned", "workspace.lease.acquired", "workspace.suspended", "workspace.resumed", "workspace.snapshot.created", "workspace.lease.released", "workspace.lease.failed"]>;
+        readonly type: Schema.Literals<readonly ["execution.accepted", "execution.started", "execution.completed", "execution.failed", "execution.cancelled", "model.input.prepared", "model.output.delta", "model.reasoning.delta", "model.toolcall.delta", "model.output.completed", "model.usage.reported", "agent.compaction.committed", "budget.exceeded", "tool.call.requested", "tool.result.received", "tool.approval.requested", "tool.approval.resolved", "permission.ask.requested", "permission.ask.resolved", "steering.delivered", "state.updated", "state.deleted", "inbox.enqueued", "inbox.drained", "resident.created", "resident.destroyed", "envelope.accepted", "envelope.routed", "envelope.ready", "delivery.attempt", "wait.created", "wait.woken", "wait.timed_out", "wait.cancelled", "child_run.spawned", "child_run.event", "child_fan_out.created", "child_fan_out.member.admitted", "child_fan_out.member.terminal", "child_fan_out.terminal", "workspace.lease.planned", "workspace.lease.acquired", "workspace.suspended", "workspace.resumed", "workspace.snapshot.created", "workspace.lease.released", "workspace.lease.failed"]>;
         readonly sequence: Schema.Int;
         readonly cursor: Schema.String;
         readonly content: Schema.optionalKey<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
@@ -2404,7 +2407,7 @@ export declare const SessionStreamItem: Schema.Union<readonly [Schema.TaggedStru
         readonly child_execution_id: Schema.optionalKey<Schema.brand<Schema.String, "Relay.ChildExecutionId"> & {
             make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.ChildExecutionId">;
         }>;
-        readonly type: Schema.Literals<readonly ["execution.accepted", "execution.started", "execution.completed", "execution.failed", "execution.cancelled", "model.input.prepared", "model.output.delta", "model.reasoning.delta", "model.toolcall.delta", "model.output.completed", "model.usage.reported", "agent.compaction.committed", "budget.exceeded", "tool.call.requested", "tool.result.received", "tool.approval.requested", "tool.approval.resolved", "permission.ask.requested", "permission.ask.resolved", "steering.received", "state.updated", "state.deleted", "inbox.enqueued", "inbox.drained", "resident.created", "resident.destroyed", "envelope.accepted", "envelope.routed", "envelope.ready", "delivery.attempt", "wait.created", "wait.woken", "wait.timed_out", "wait.cancelled", "child_run.spawned", "child_run.event", "child_fan_out.created", "child_fan_out.member.admitted", "child_fan_out.member.terminal", "child_fan_out.terminal", "workspace.lease.planned", "workspace.lease.acquired", "workspace.suspended", "workspace.resumed", "workspace.snapshot.created", "workspace.lease.released", "workspace.lease.failed"]>;
+        readonly type: Schema.Literals<readonly ["execution.accepted", "execution.started", "execution.completed", "execution.failed", "execution.cancelled", "model.input.prepared", "model.output.delta", "model.reasoning.delta", "model.toolcall.delta", "model.output.completed", "model.usage.reported", "agent.compaction.committed", "budget.exceeded", "tool.call.requested", "tool.result.received", "tool.approval.requested", "tool.approval.resolved", "permission.ask.requested", "permission.ask.resolved", "steering.delivered", "state.updated", "state.deleted", "inbox.enqueued", "inbox.drained", "resident.created", "resident.destroyed", "envelope.accepted", "envelope.routed", "envelope.ready", "delivery.attempt", "wait.created", "wait.woken", "wait.timed_out", "wait.cancelled", "child_run.spawned", "child_run.event", "child_fan_out.created", "child_fan_out.member.admitted", "child_fan_out.member.terminal", "child_fan_out.terminal", "workspace.lease.planned", "workspace.lease.acquired", "workspace.suspended", "workspace.resumed", "workspace.snapshot.created", "workspace.lease.released", "workspace.lease.failed"]>;
         readonly sequence: Schema.Int;
         readonly cursor: Schema.String;
         readonly content: Schema.optionalKey<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
@@ -2715,7 +2718,7 @@ export declare const ReplayExecutionResult: Schema.Struct<{
         readonly child_execution_id: Schema.optionalKey<Schema.brand<Schema.String, "Relay.ChildExecutionId"> & {
             make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.ChildExecutionId">;
         }>;
-        readonly type: Schema.Literals<readonly ["execution.accepted", "execution.started", "execution.completed", "execution.failed", "execution.cancelled", "model.input.prepared", "model.output.delta", "model.reasoning.delta", "model.toolcall.delta", "model.output.completed", "model.usage.reported", "agent.compaction.committed", "budget.exceeded", "tool.call.requested", "tool.result.received", "tool.approval.requested", "tool.approval.resolved", "permission.ask.requested", "permission.ask.resolved", "steering.received", "state.updated", "state.deleted", "inbox.enqueued", "inbox.drained", "resident.created", "resident.destroyed", "envelope.accepted", "envelope.routed", "envelope.ready", "delivery.attempt", "wait.created", "wait.woken", "wait.timed_out", "wait.cancelled", "child_run.spawned", "child_run.event", "child_fan_out.created", "child_fan_out.member.admitted", "child_fan_out.member.terminal", "child_fan_out.terminal", "workspace.lease.planned", "workspace.lease.acquired", "workspace.suspended", "workspace.resumed", "workspace.snapshot.created", "workspace.lease.released", "workspace.lease.failed"]>;
+        readonly type: Schema.Literals<readonly ["execution.accepted", "execution.started", "execution.completed", "execution.failed", "execution.cancelled", "model.input.prepared", "model.output.delta", "model.reasoning.delta", "model.toolcall.delta", "model.output.completed", "model.usage.reported", "agent.compaction.committed", "budget.exceeded", "tool.call.requested", "tool.result.received", "tool.approval.requested", "tool.approval.resolved", "permission.ask.requested", "permission.ask.resolved", "steering.delivered", "state.updated", "state.deleted", "inbox.enqueued", "inbox.drained", "resident.created", "resident.destroyed", "envelope.accepted", "envelope.routed", "envelope.ready", "delivery.attempt", "wait.created", "wait.woken", "wait.timed_out", "wait.cancelled", "child_run.spawned", "child_run.event", "child_fan_out.created", "child_fan_out.member.admitted", "child_fan_out.member.terminal", "child_fan_out.terminal", "workspace.lease.planned", "workspace.lease.acquired", "workspace.suspended", "workspace.resumed", "workspace.snapshot.created", "workspace.lease.released", "workspace.lease.failed"]>;
         readonly sequence: Schema.Int;
         readonly cursor: Schema.String;
         readonly content: Schema.optionalKey<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
@@ -2797,7 +2800,7 @@ export declare const PageExecutionEventsResult: Schema.Struct<{
         readonly child_execution_id: Schema.optionalKey<Schema.brand<Schema.String, "Relay.ChildExecutionId"> & {
             make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.ChildExecutionId">;
         }>;
-        readonly type: Schema.Literals<readonly ["execution.accepted", "execution.started", "execution.completed", "execution.failed", "execution.cancelled", "model.input.prepared", "model.output.delta", "model.reasoning.delta", "model.toolcall.delta", "model.output.completed", "model.usage.reported", "agent.compaction.committed", "budget.exceeded", "tool.call.requested", "tool.result.received", "tool.approval.requested", "tool.approval.resolved", "permission.ask.requested", "permission.ask.resolved", "steering.received", "state.updated", "state.deleted", "inbox.enqueued", "inbox.drained", "resident.created", "resident.destroyed", "envelope.accepted", "envelope.routed", "envelope.ready", "delivery.attempt", "wait.created", "wait.woken", "wait.timed_out", "wait.cancelled", "child_run.spawned", "child_run.event", "child_fan_out.created", "child_fan_out.member.admitted", "child_fan_out.member.terminal", "child_fan_out.terminal", "workspace.lease.planned", "workspace.lease.acquired", "workspace.suspended", "workspace.resumed", "workspace.snapshot.created", "workspace.lease.released", "workspace.lease.failed"]>;
+        readonly type: Schema.Literals<readonly ["execution.accepted", "execution.started", "execution.completed", "execution.failed", "execution.cancelled", "model.input.prepared", "model.output.delta", "model.reasoning.delta", "model.toolcall.delta", "model.output.completed", "model.usage.reported", "agent.compaction.committed", "budget.exceeded", "tool.call.requested", "tool.result.received", "tool.approval.requested", "tool.approval.resolved", "permission.ask.requested", "permission.ask.resolved", "steering.delivered", "state.updated", "state.deleted", "inbox.enqueued", "inbox.drained", "resident.created", "resident.destroyed", "envelope.accepted", "envelope.routed", "envelope.ready", "delivery.attempt", "wait.created", "wait.woken", "wait.timed_out", "wait.cancelled", "child_run.spawned", "child_run.event", "child_fan_out.created", "child_fan_out.member.admitted", "child_fan_out.member.terminal", "child_fan_out.terminal", "workspace.lease.planned", "workspace.lease.acquired", "workspace.suspended", "workspace.resumed", "workspace.snapshot.created", "workspace.lease.released", "workspace.lease.failed"]>;
         readonly sequence: Schema.Int;
         readonly cursor: Schema.String;
         readonly content: Schema.optionalKey<Schema.$Array<Schema.Union<readonly [Schema.Struct<{

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

@@ -60,5 +60,10 @@ export declare const migrations: readonly [{
     readonly name: "rename_entity_to_resident";
     readonly file: "0012_rename_entity_to_resident.sql";
     readonly source: string;
+}, {
+    readonly id: 13;
+    readonly name: "steering_delivered";
+    readonly file: "0013_steering_delivered.sql";
+    readonly source: string;
 }];
-export declare const loader: Effect.Effect<(readonly [1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12, "baseline" | "child_fan_out" | "durable_entities" | "durable_inbox" | "durable_tool_placement" | "ephemeral_presence" | "execution_scoped_tool_calls" | "execution_state" | "rename_entity_to_resident" | "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, "baseline" | "child_fan_out" | "durable_entities" | "durable_inbox" | "durable_tool_placement" | "ephemeral_presence" | "execution_scoped_tool_calls" | "execution_state" | "rename_entity_to_resident" | "steering_delivered" | "topic_subscriptions" | "workflow_definitions" | "workflow_runtime", Effect.Effect<Effect.Effect<void, import("effect/unstable/sql/SqlError").SqlError, SqlClient>, never, never>])[], never, never>;

package/dist/types/relay/tool-worker.d.ts

@@ -16,5 +16,5 @@ export interface Options<E = Error, R = never> {
     readonly handlers: Readonly<Record<string, Handler<E, R>>>;
 }
 export declare const runOnce: <E, R>(options: Options<E, R>) => Effect.Effect<boolean, ClientError, R | ClientService>;
-export declare const run: <E, R>(options: Options<E, R>) => Effect.Effect<never, ClientError, R | ClientService>;
+export declare const run: <E, R>(options: Options<E, R>) => Effect.Effect<never, never, R | ClientService>;
 export type Error = ClientError;

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

@@ -1,6 +1,6 @@
 import { Schema } from "effect";
 import { Definition } from "./agent-schema";
-import { ChildExecutionId } from "./ids-schema";
+import { ChildExecutionId, ExecutionId } from "./ids-schema";
 export declare const ExecutionStatus: Schema.Literals<readonly ["queued", "running", "waiting", "completed", "failed", "cancelled"]>;
 export type ExecutionStatus = typeof ExecutionStatus.Type;
 export declare const Execution: Schema.Struct<{
@@ -385,7 +385,12 @@ export declare const ChildRunAccepted: Schema.Struct<{
 export interface ChildRunAccepted extends Schema.Schema.Type<typeof ChildRunAccepted> {
 }
 export declare const childSessionId: (childExecutionId: ChildExecutionId) => string & import("effect/Brand").Brand<"Relay.SessionId">;
-export declare const ExecutionEventType: Schema.Literals<readonly ["execution.accepted", "execution.started", "execution.completed", "execution.failed", "execution.cancelled", "model.input.prepared", "model.output.delta", "model.reasoning.delta", "model.toolcall.delta", "model.output.completed", "model.usage.reported", "agent.compaction.committed", "budget.exceeded", "tool.call.requested", "tool.result.received", "tool.approval.requested", "tool.approval.resolved", "permission.ask.requested", "permission.ask.resolved", "steering.received", "state.updated", "state.deleted", "inbox.enqueued", "inbox.drained", "resident.created", "resident.destroyed", "envelope.accepted", "envelope.routed", "envelope.ready", "delivery.attempt", "wait.created", "wait.woken", "wait.timed_out", "wait.cancelled", "child_run.spawned", "child_run.event", "child_fan_out.created", "child_fan_out.member.admitted", "child_fan_out.member.terminal", "child_fan_out.terminal", "workspace.lease.planned", "workspace.lease.acquired", "workspace.suspended", "workspace.resumed", "workspace.snapshot.created", "workspace.lease.released", "workspace.lease.failed"]>;
+export declare const steeringMessageId: (input: {
+    readonly execution_id: ExecutionId;
+    readonly kind: "steering" | "follow_up";
+    readonly sequence: number;
+}) => string & import("effect/Brand").Brand<"Relay.SteeringMessageId">;
+export declare const ExecutionEventType: Schema.Literals<readonly ["execution.accepted", "execution.started", "execution.completed", "execution.failed", "execution.cancelled", "model.input.prepared", "model.output.delta", "model.reasoning.delta", "model.toolcall.delta", "model.output.completed", "model.usage.reported", "agent.compaction.committed", "budget.exceeded", "tool.call.requested", "tool.result.received", "tool.approval.requested", "tool.approval.resolved", "permission.ask.requested", "permission.ask.resolved", "steering.delivered", "state.updated", "state.deleted", "inbox.enqueued", "inbox.drained", "resident.created", "resident.destroyed", "envelope.accepted", "envelope.routed", "envelope.ready", "delivery.attempt", "wait.created", "wait.woken", "wait.timed_out", "wait.cancelled", "child_run.spawned", "child_run.event", "child_fan_out.created", "child_fan_out.member.admitted", "child_fan_out.member.terminal", "child_fan_out.terminal", "workspace.lease.planned", "workspace.lease.acquired", "workspace.suspended", "workspace.resumed", "workspace.snapshot.created", "workspace.lease.released", "workspace.lease.failed"]>;
 export type ExecutionEventType = typeof ExecutionEventType.Type;
 export declare const CompactionCommittedEventData: Schema.Struct<{
     readonly checkpoint_id: Schema.brand<Schema.String, "Relay.SessionEntryId"> & {
@@ -408,7 +413,7 @@ export declare const ExecutionEvent: Schema.Struct<{
     readonly child_execution_id: Schema.optionalKey<Schema.brand<Schema.String, "Relay.ChildExecutionId"> & {
         make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.ChildExecutionId">;
     }>;
-    readonly type: Schema.Literals<readonly ["execution.accepted", "execution.started", "execution.completed", "execution.failed", "execution.cancelled", "model.input.prepared", "model.output.delta", "model.reasoning.delta", "model.toolcall.delta", "model.output.completed", "model.usage.reported", "agent.compaction.committed", "budget.exceeded", "tool.call.requested", "tool.result.received", "tool.approval.requested", "tool.approval.resolved", "permission.ask.requested", "permission.ask.resolved", "steering.received", "state.updated", "state.deleted", "inbox.enqueued", "inbox.drained", "resident.created", "resident.destroyed", "envelope.accepted", "envelope.routed", "envelope.ready", "delivery.attempt", "wait.created", "wait.woken", "wait.timed_out", "wait.cancelled", "child_run.spawned", "child_run.event", "child_fan_out.created", "child_fan_out.member.admitted", "child_fan_out.member.terminal", "child_fan_out.terminal", "workspace.lease.planned", "workspace.lease.acquired", "workspace.suspended", "workspace.resumed", "workspace.snapshot.created", "workspace.lease.released", "workspace.lease.failed"]>;
+    readonly type: Schema.Literals<readonly ["execution.accepted", "execution.started", "execution.completed", "execution.failed", "execution.cancelled", "model.input.prepared", "model.output.delta", "model.reasoning.delta", "model.toolcall.delta", "model.output.completed", "model.usage.reported", "agent.compaction.committed", "budget.exceeded", "tool.call.requested", "tool.result.received", "tool.approval.requested", "tool.approval.resolved", "permission.ask.requested", "permission.ask.resolved", "steering.delivered", "state.updated", "state.deleted", "inbox.enqueued", "inbox.drained", "resident.created", "resident.destroyed", "envelope.accepted", "envelope.routed", "envelope.ready", "delivery.attempt", "wait.created", "wait.woken", "wait.timed_out", "wait.cancelled", "child_run.spawned", "child_run.event", "child_fan_out.created", "child_fan_out.member.admitted", "child_fan_out.member.terminal", "child_fan_out.terminal", "workspace.lease.planned", "workspace.lease.acquired", "workspace.suspended", "workspace.resumed", "workspace.snapshot.created", "workspace.lease.released", "workspace.lease.failed"]>;
     readonly sequence: Schema.Int;
     readonly cursor: Schema.String;
     readonly content: Schema.optionalKey<Schema.$Array<Schema.Union<readonly [Schema.Struct<{

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

@@ -104,3 +104,7 @@ export declare const EventId: Schema.brand<Schema.String, "Relay.EventId"> & {
     make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.EventId">;
 };
 export type EventId = typeof EventId.Type;
+export declare const SteeringMessageId: Schema.brand<Schema.String, "Relay.SteeringMessageId"> & {
+    make: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Relay.SteeringMessageId">;
+};
+export type SteeringMessageId = typeof SteeringMessageId.Type;

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@relayfx/sdk",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "description": "Effect-native durable execution SDK for addressable agents and tools",
   "type": "module",
   "exports": {