@qlever-llc/trellis 0.10.22 → 0.11.0-rc.1

package/script/server/internal_jobs/runtime-worker.d.ts

@@ -117,6 +117,8 @@ type StartQueueWorkerLoopOptions<TResult> = {
     resultSchema?: SchemaRef;
     validateResult?: (args: ResultValidationArgs<TResult>) => Promise<void> | void;
     handler: (job: ActiveJob<unknown, TResult>) => Promise<TResult>;
+    instanceId?: string;
+    deferralBackoffMs?: number;
 };
 type StartNatsQueueWorkerOptions<TResult> = StartNatsRuntimeDeps & {
     manager: JobManager<unknown, TResult>;
@@ -128,6 +130,7 @@ type StartNatsQueueWorkerOptions<TResult> = StartNatsRuntimeDeps & {
     validatePayload?: (args: PayloadValidationArgs<TResult>) => Promise<void> | void;
     validateResult?: (args: ResultValidationArgs<TResult>) => Promise<void> | void;
     handler: (job: ActiveJob<unknown, TResult>) => Promise<TResult>;
+    instanceId?: string;
 };
 export declare function processWorkPayloadWithContextAndHeartbeat<TResult>(manager: JobManager<unknown, TResult>, payload: Uint8Array, cancellation: JobCancellationToken, heartbeat: () => Promise<void>, handler: (job: ActiveJob<unknown, TResult>) => Promise<TResult>, validation?: {
     payloadSchema?: SchemaRef;
@@ -135,8 +138,9 @@ export declare function processWorkPayloadWithContextAndHeartbeat<TResult>(manag
     resultSchema?: SchemaRef;
     validateResult?: (args: ResultValidationArgs<TResult>) => Promise<void> | void;
 }, runtime?: {
+    latestState?: Job["state"];
     redeliveryCount?: number;
-}): Promise<JobProcessOutcome<TResult> | undefined>;
+}, instanceId?: string): Promise<JobProcessOutcome<TResult> | undefined>;
 export declare function projectedWorkDecision(projected: Job | undefined, _work: Job): ProjectedWorkDecision;
 export declare function lifecycleWorkDecision(latest: JobEvent | undefined): ProjectedWorkDecision;
 export declare function ackActionForOutcome(outcome: JobProcessOutcome<unknown> | undefined): WorkerAckAction;

package/script/server/internal_jobs/runtime-worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-worker.d.ts","sourceRoot":"","sources":["../../../src/server/internal_jobs/runtime-worker.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runtime-worker.d.ts","sourceRoot":"","sources":["../../../src/server/internal_jobs/runtime-worker.ts"],"names":[],"mappings":"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"}

package/script/server/internal_jobs/runtime-worker.js

@@ -65,7 +65,7 @@ function toWorkerConsumer(consumer) {
         },
     };
 }
-async function processWorkPayloadWithContextAndHeartbeat(manager, payload, cancellation, heartbeat, handler, validation, runtime) {
+async function processWorkPayloadWithContextAndHeartbeat(manager, payload, cancellation, heartbeat, handler, validation, runtime, instanceId) {
     const event = parseWorkPayloadEvent(payload);
     if (!event) {
         return undefined;
@@ -86,7 +86,9 @@ async function processWorkPayloadWithContextAndHeartbeat(manager, payload, cance
         }
         return await handler(activeJob);
     }, {
+        latestState: runtime?.latestState,
         redeliveryCount: runtime?.redeliveryCount,
+        instanceId,
     }, {
         validateResult: validation?.validateResult
             ? (result, resultJob) => validation.validateResult({
@@ -116,6 +118,7 @@ function ackActionForOutcome(outcome) {
     switch (outcome.outcome) {
         case "retry":
         case "interrupted":
+        case "deferred":
             return "nak";
         default:
             return "ack";
@@ -170,6 +173,7 @@ async function startQueueWorkerLoop(options) {
                 continue;
             }
             if (lifecycleWorkDecision(latestLifecycle) === "skip-ack") {
+                await options.manager.cleanupQueuedKeyedJob(job);
                 registry.clearPending(key);
                 await msg.ack();
                 continue;
@@ -183,6 +187,7 @@ async function startQueueWorkerLoop(options) {
                     continue;
                 }
                 if (projectedWorkDecision(projected, job) === "skip-ack") {
+                    await options.manager.cleanupQueuedKeyedJob(job);
                     registry.clearPending(key);
                     await msg.ack();
                     continue;
@@ -203,11 +208,15 @@ async function startQueueWorkerLoop(options) {
                     resultSchema: options.resultSchema,
                     validateResult: options.validateResult,
                 }, {
+                    latestState: latestLifecycle?.state,
                     redeliveryCount: msg.info?.redeliveryCount,
-                });
+                }, options.instanceId);
                 if (ackActionForOutcome(outcome) === "ack") {
                     await msg.ack();
                 }
+                else if (outcome?.outcome === "deferred") {
+                    await msg.nak(options.deferralBackoffMs ?? 1_000);
+                }
                 else {
                     await msg.nak();
                 }
@@ -280,6 +289,8 @@ async function startNatsQueueWorker(options) {
         resultSchema: queue.result,
         validateResult: options.validateResult,
         handler: options.handler,
+        instanceId: options.instanceId,
+        deferralBackoffMs: queue.backoffMs[0] ?? 1_000,
     });
 }
 async function startWorkerHostFromBinding(binding, options) {
@@ -369,6 +380,7 @@ async function startNatsWorkerHostFromBinding(binding, options) {
                 validatePayload: options.validatePayload,
                 validateResult: options.validateResult,
                 handler: options.handler,
+                instanceId: options.instanceId,
             };
             return await (isCustomNatsRuntimeDeps(options)
                 ? startNatsQueueWorker({

package/script/server/internal_jobs/types.d.ts

@@ -6,7 +6,7 @@ export declare const JobContextSchema: Type.TObject<{
     tracestate: Type.TOptional<Type.TString>;
 }>;
 export type JobContext = StaticDecode<typeof JobContextSchema>;
-export declare const JobStateSchema: Type.TUnion<[Type.TLiteral<"pending">, Type.TLiteral<"active">, Type.TLiteral<"retry">, Type.TLiteral<"completed">, Type.TLiteral<"failed">, Type.TLiteral<"cancelled">, Type.TLiteral<"expired">, Type.TLiteral<"dead">, Type.TLiteral<"dismissed">]>;
+export declare const JobStateSchema: Type.TUnion<[Type.TLiteral<"pending">, Type.TLiteral<"active">, Type.TLiteral<"retry">, Type.TLiteral<"completed">, Type.TLiteral<"failed">, Type.TLiteral<"cancelled">, Type.TLiteral<"expired">, Type.TLiteral<"skipped">, Type.TLiteral<"stale">, Type.TLiteral<"dead">, Type.TLiteral<"dismissed">]>;
 export type JobState = StaticDecode<typeof JobStateSchema>;
 export declare const JobLogEntrySchema: Type.TObject<{
     timestamp: Type.TString;
@@ -25,7 +25,7 @@ export declare const JobSchema: Type.TObject<{
     id: Type.TString;
     service: Type.TString;
     type: Type.TString;
-    state: Type.TUnion<[Type.TLiteral<"pending">, Type.TLiteral<"active">, Type.TLiteral<"retry">, Type.TLiteral<"completed">, Type.TLiteral<"failed">, Type.TLiteral<"cancelled">, Type.TLiteral<"expired">, Type.TLiteral<"dead">, Type.TLiteral<"dismissed">]>;
+    state: Type.TUnion<[Type.TLiteral<"pending">, Type.TLiteral<"active">, Type.TLiteral<"retry">, Type.TLiteral<"completed">, Type.TLiteral<"failed">, Type.TLiteral<"cancelled">, Type.TLiteral<"expired">, Type.TLiteral<"skipped">, Type.TLiteral<"stale">, Type.TLiteral<"dead">, Type.TLiteral<"dismissed">]>;
     context: Type.TObject<{
         requestId: Type.TString;
         traceId: Type.TString;
@@ -62,9 +62,9 @@ export declare const JobEventSchema: Type.TObject<{
     jobId: Type.TString;
     service: Type.TString;
     jobType: Type.TString;
-    eventType: Type.TUnion<[Type.TLiteral<"created">, Type.TLiteral<"started">, Type.TLiteral<"retry">, Type.TLiteral<"progress">, Type.TLiteral<"logged">, Type.TLiteral<"completed">, Type.TLiteral<"failed">, Type.TLiteral<"cancelled">, Type.TLiteral<"expired">, Type.TLiteral<"retried">, Type.TLiteral<"dead">, Type.TLiteral<"dismissed">]>;
-    state: Type.TUnion<[Type.TLiteral<"pending">, Type.TLiteral<"active">, Type.TLiteral<"retry">, Type.TLiteral<"completed">, Type.TLiteral<"failed">, Type.TLiteral<"cancelled">, Type.TLiteral<"expired">, Type.TLiteral<"dead">, Type.TLiteral<"dismissed">]>;
-    previousState: Type.TOptional<Type.TUnion<[Type.TLiteral<"pending">, Type.TLiteral<"active">, Type.TLiteral<"retry">, Type.TLiteral<"completed">, Type.TLiteral<"failed">, Type.TLiteral<"cancelled">, Type.TLiteral<"expired">, Type.TLiteral<"dead">, Type.TLiteral<"dismissed">]>>;
+    eventType: Type.TUnion<[Type.TLiteral<"created">, Type.TLiteral<"started">, Type.TLiteral<"retry">, Type.TLiteral<"progress">, Type.TLiteral<"logged">, Type.TLiteral<"completed">, Type.TLiteral<"failed">, Type.TLiteral<"cancelled">, Type.TLiteral<"expired">, Type.TLiteral<"skipped">, Type.TLiteral<"stale">, Type.TLiteral<"heartbeat">, Type.TLiteral<"staleCompletionIgnored">, Type.TLiteral<"retried">, Type.TLiteral<"dead">, Type.TLiteral<"dismissed">]>;
+    state: Type.TUnion<[Type.TLiteral<"pending">, Type.TLiteral<"active">, Type.TLiteral<"retry">, Type.TLiteral<"completed">, Type.TLiteral<"failed">, Type.TLiteral<"cancelled">, Type.TLiteral<"expired">, Type.TLiteral<"skipped">, Type.TLiteral<"stale">, Type.TLiteral<"dead">, Type.TLiteral<"dismissed">]>;
+    previousState: Type.TOptional<Type.TUnion<[Type.TLiteral<"pending">, Type.TLiteral<"active">, Type.TLiteral<"retry">, Type.TLiteral<"completed">, Type.TLiteral<"failed">, Type.TLiteral<"cancelled">, Type.TLiteral<"expired">, Type.TLiteral<"skipped">, Type.TLiteral<"stale">, Type.TLiteral<"dead">, Type.TLiteral<"dismissed">]>>;
     context: Type.TObject<{
         requestId: Type.TString;
         traceId: Type.TString;

package/script/server/internal_jobs/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/server/internal_jobs/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAElD,eAAO,MAAM,gBAAgB;;;;;EAO3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE/D,eAAO,MAAM,cAAc,wPAUzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,cAAc,CAAC,CAAC;AAE3D,eAAO,MAAM,iBAAiB;;;;EAQ5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,YAAY,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE,eAAO,MAAM,iBAAiB;;;;;EAK5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,YAAY,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBpB,CAAC;AAEH,MAAM,MAAM,GAAG,CAAC,QAAQ,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,IACjD,IAAI,CAAC,YAAY,CAAC,OAAO,SAAS,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC,GAC1D;IACA,OAAO,EAAE,QAAQ,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEJ,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8BzB,CAAC;AAEH,MAAM,MAAM,QAAQ,CAAC,QAAQ,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,IACtD,IAAI,CAAC,YAAY,CAAC,OAAO,cAAc,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC,GAC/D;IACA,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEJ,eAAO,MAAM,qBAAqB;;;;;;;EAOhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,YAAY,CAAC,OAAO,qBAAqB,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/server/internal_jobs/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAElD,eAAO,MAAM,gBAAgB;;;;;EAO3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE/D,eAAO,MAAM,cAAc,0SAYzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,cAAc,CAAC,CAAC;AAE3D,eAAO,MAAM,iBAAiB;;;;EAQ5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,YAAY,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE,eAAO,MAAM,iBAAiB;;;;;EAK5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,YAAY,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBpB,CAAC;AAEH,MAAM,MAAM,GAAG,CAAC,QAAQ,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,IACjD,IAAI,CAAC,YAAY,CAAC,OAAO,SAAS,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC,GAC1D;IACA,OAAO,EAAE,QAAQ,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEJ,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkCzB,CAAC;AAEH,MAAM,MAAM,QAAQ,CAAC,QAAQ,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,IACtD,IAAI,CAAC,YAAY,CAAC,OAAO,cAAc,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC,GAC/D;IACA,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEJ,eAAO,MAAM,qBAAqB;;;;;;;EAOhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,YAAY,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/script/server/internal_jobs/types.js

@@ -18,6 +18,8 @@ exports.JobStateSchema = typebox_1.Type.Union([
     typebox_1.Type.Literal("failed"),
     typebox_1.Type.Literal("cancelled"),
     typebox_1.Type.Literal("expired"),
+    typebox_1.Type.Literal("skipped"),
+    typebox_1.Type.Literal("stale"),
     typebox_1.Type.Literal("dead"),
     typebox_1.Type.Literal("dismissed"),
 ]);
@@ -69,6 +71,10 @@ exports.JobEventSchema = typebox_1.Type.Object({
         typebox_1.Type.Literal("failed"),
         typebox_1.Type.Literal("cancelled"),
         typebox_1.Type.Literal("expired"),
+        typebox_1.Type.Literal("skipped"),
+        typebox_1.Type.Literal("stale"),
+        typebox_1.Type.Literal("heartbeat"),
+        typebox_1.Type.Literal("staleCompletionIgnored"),
         typebox_1.Type.Literal("retried"),
         typebox_1.Type.Literal("dead"),
         typebox_1.Type.Literal("dismissed"),

package/script/server/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/server/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAOzD,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5B,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,eAAe,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;AAE/E,MAAM,MAAM,wBAAwB,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC;AAEtE,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,UAAU,CAAC;AAE1D,mDAAmD;AACnD,MAAM,MAAM,eAAe,GAAG,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;AAE5D,MAAM,MAAM,yBAAyB,GAAG;IACtC,OAAO,EAAE,aAAa,CAAC;IACvB,kBAAkB,CAAC,EAAE,wBAAwB,CAAC;IAC9C,YAAY,CAAC,EAAE,cAAc,CAAC;IAC9B,aAAa,CAAC,EAAE,eAAe,CAAC;CACjC,CAAC"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/server/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAQzD,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5B,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,eAAe,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;AAE/E,MAAM,MAAM,wBAAwB,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC;AAEtE,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,UAAU,CAAC;AAE1D,mDAAmD;AACnD,MAAM,MAAM,eAAe,GAAG,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;AAE5D,MAAM,MAAM,yBAAyB,GAAG;IACtC,OAAO,EAAE,aAAa,CAAC;IACvB,kBAAkB,CAAC,EAAE,wBAAwB,CAAC;IAC9C,YAAY,CAAC,EAAE,cAAc,CAAC;IAC9B,aAAa,CAAC,EAAE,eAAe,CAAC;CAIjC,CAAC"}

package/script/server/service.d.ts

@@ -8,15 +8,17 @@ import type { TrellisContractV1 } from "../contract_support/mod.js";
 import type { ContractJobsMetadata, ContractKvMetadata } from "../contract_support/mod.js";
 import { CONTRACT_JOBS_METADATA, CONTRACT_KV_METADATA } from "../contract_support/mod.js";
 import { AsyncResult, type BaseError, type MaybeAsync, Result } from "@qlever-llc/result";
-import { type HealthCheckFn, ServiceHealth, type ServiceHealthCheck, type ServiceHealthInfo } from "./health.js";
+import { type HealthCheckFn, ServiceHealth, type ServiceHealthCheckFn, type ServiceHealthInfoFn } from "./health.js";
 import type { EventDesc } from "../contracts.js";
-import type { AcceptedOperation, ActiveEventFacade, EventListenerContext, EventOpts, FeedEventOf, FeedInputOf, FeedRegistration as RootFeedRegistration, HandlerTrellis, OperationHandlerContext, OperationOutputOf, OperationProgressOf, OperationRuntimeHandle, OperationTransferContextOf, PreparedTrellisEvent, RpcHandlerContext, RpcHandlerErrorOf } from "../trellis.js";
+import type { AcceptedOperation, ActiveEventFacade, EventListenerContext, FeedEventOf, FeedInputOf, FeedRegistration as RootFeedRegistration, HandlerTrellis, OperationHandlerContext, OperationHandlerErrorOf, OperationOutputOf, OperationProgressOf, OperationRuntimeHandle, OperationTransferContextOf, PreparedTrellisEvent, RpcHandlerContext, RpcHandlerErrorOf } from "../trellis.js";
 import type { NatsConnectOpts } from "./runtime.js";
 import { type LoggerLike } from "../globals.js";
 import { TransferError, TransportError, UnexpectedError, ValidationError } from "../errors/index.js";
 import type { ReceiveTransferGrant } from "../transfer.js";
-import { ActiveJob as PublicActiveJob, JobRef } from "../jobs.js";
+import { ActiveJob as PublicActiveJob, JobRef, type JobSubmitOutcome } from "../jobs.js";
+import type { JobKeyConcurrencyBinding, JobQueuePolicyBinding } from "./internal_jobs/key-coordinator.js";
 import { type TrellisConnection } from "../connection.js";
+import { type OutboxDispatcherOptions, type OutboxMessage, type SqlDialect, type SqlExecutor, type SqlOutboxTables } from "../service/outbox_inbox.js";
 type ExtraNatsConnectOpts = Omit<NatsConnectOpts, "servers" | "token" | "inboxPrefix" | "authenticator">;
 type ResourceBindingJobsQueue = {
     queueType: string;
@@ -37,6 +39,8 @@ type ResourceBindingJobsQueue = {
     logs: boolean;
     dlq: boolean;
     concurrency: number;
+    keyConcurrency?: JobKeyConcurrencyBinding;
+    queue?: JobQueuePolicyBinding;
 };
 type ResourceBindingJobs = {
     namespace: string;
@@ -187,54 +191,31 @@ type ContractOwnedApi<TContract extends ServiceContract<TrellisAPI, TrellisAPI |
 type ContractTrellisApi<TContract extends ServiceContract<TrellisAPI, TrellisAPI | undefined, ContractJobsMetadata>> = NonNullable<TContract["API"]["trellis"]> extends TrellisAPI ? NonNullable<TContract["API"]["trellis"]> : ContractOwnedApi<TContract>;
 type ContractJobsOf<TContract extends ServiceContract<TrellisAPI, TrellisAPI | undefined, ContractJobsMetadata, ContractKvMetadata>> = NonNullable<TContract[typeof CONTRACT_JOBS_METADATA]>;
 type ContractKvOf<TContract extends ServiceContract<TrellisAPI, TrellisAPI | undefined, ContractJobsMetadata, ContractKvMetadata>> = NonNullable<TContract[typeof CONTRACT_KV_METADATA]>;
-type ContractJobName<TContract extends ServiceContract<TrellisAPI, TrellisAPI | undefined, ContractJobsMetadata>> = keyof ContractJobsOf<TContract> & string;
 type ContractEventName<TContract extends ServiceContract<TrellisAPI, TrellisAPI | undefined, ContractJobsMetadata>> = ServiceEventName<ContractTrellisApi<TContract>>;
-type ContractFeedName<TContract extends ServiceContract<TrellisAPI, TrellisAPI | undefined, ContractJobsMetadata>> = keyof ContractOwnedApi<TContract>["feeds"] & string;
 type ContractOperationName<TContract extends ServiceContract<TrellisAPI, TrellisAPI | undefined, ContractJobsMetadata>> = keyof ContractOwnedApi<TContract>["operations"] & string;
-type ContractJobPayload<TContract extends ServiceContract<TrellisAPI, TrellisAPI | undefined, ContractJobsMetadata>, TJob extends ContractJobName<TContract>> = ContractJobsOf<TContract>[TJob]["payload"];
-type ContractJobResult<TContract extends ServiceContract<TrellisAPI, TrellisAPI | undefined, ContractJobsMetadata>, TJob extends ContractJobName<TContract>> = ContractJobsOf<TContract>[TJob]["result"];
-/** Arguments passed to a typed Trellis service job handler. */
-export type JobArgs<TContract extends ServiceContract<TrellisAPI, TrellisAPI | undefined, ContractJobsMetadata, ContractKvMetadata>, TJob extends ContractJobName<TContract>, TDeps = undefined> = {
-    job: PublicActiveJob<ContractJobPayload<TContract, TJob>, ContractJobResult<TContract, TJob>>;
-    client: Trellis<ContractTrellisApi<TContract>, ContractKvOf<TContract>, ContractJobsOf<TContract>>;
-} & WithDeps<TDeps>;
-/** Result returned by a typed Trellis service job handler. */
-export type JobResult<TContract extends ServiceContract<TrellisAPI, TrellisAPI | undefined, ContractJobsMetadata, ContractKvMetadata>, TJob extends ContractJobName<TContract>> = Result<ContractJobResult<TContract, TJob>, BaseError>;
-type WithDeps<TDeps> = [TDeps] extends [undefined] ? {} : {
-    deps: TDeps;
-};
 /** Typed RPC handler function for an extracted Trellis service handler. */
-export type RpcHandler<TContract extends ServiceContract<TrellisAPI, TrellisAPI | undefined, ContractJobsMetadata, ContractKvMetadata>, M extends RpcMethodName<ContractOwnedApi<TContract>>, TDeps = undefined> = ({ input, context, client, }: {
+export type RpcHandler<TContract extends ServiceContract<TrellisAPI, TrellisAPI | undefined, ContractJobsMetadata, ContractKvMetadata>, M extends RpcMethodName<ContractOwnedApi<TContract>>> = ({ input, context, client, }: {
     input: RpcMethodInput<ContractOwnedApi<TContract>, M>;
     context: RpcHandlerContext;
     client: Trellis<ContractTrellisApi<TContract>, ContractKvOf<TContract>, ContractJobsOf<TContract>>;
-} & WithDeps<TDeps>) => Promise<Result<RpcMethodOutput<ContractOwnedApi<TContract>, M>, RpcHandlerErrorOf<ContractOwnedApi<TContract>, M>>> | Result<RpcMethodOutput<ContractOwnedApi<TContract>, M>, RpcHandlerErrorOf<ContractOwnedApi<TContract>, M>>;
+}) => Promise<Result<RpcMethodOutput<ContractOwnedApi<TContract>, M>, RpcHandlerErrorOf<ContractOwnedApi<TContract>, M>>> | Result<RpcMethodOutput<ContractOwnedApi<TContract>, M>, RpcHandlerErrorOf<ContractOwnedApi<TContract>, M>>;
 /** Typed event listener function for an extracted Trellis service listener. */
-export type ServiceEventHandler<TContract extends ServiceContract<TrellisAPI, TrellisAPI | undefined, ContractJobsMetadata, ContractKvMetadata>, E extends ContractEventName<TContract>, TDeps = undefined> = (args: {
+export type ServiceEventHandler<TContract extends ServiceContract<TrellisAPI, TrellisAPI | undefined, ContractJobsMetadata, ContractKvMetadata>, E extends ContractEventName<TContract>> = (args: {
     event: ServiceEventOf<ContractTrellisApi<TContract>, E>;
     context: EventListenerContext;
     client: Trellis<ContractTrellisApi<TContract>, ContractKvOf<TContract>, ContractJobsOf<TContract>>;
-} & WithDeps<TDeps>) => MaybeAsync<void, BaseError>;
-/** Typed feed handler function for an extracted Trellis service handler. */
-export type FeedHandler<TContract extends ServiceContract<TrellisAPI, TrellisAPI | undefined, ContractJobsMetadata, ContractKvMetadata>, F extends ContractFeedName<TContract>, TDeps = undefined> = (context: {
-    input: FeedInputOf<ContractOwnedApi<TContract>, F>;
-    caller: unknown;
-    signal: AbortSignal;
-    emit(event: FeedEventOf<ContractOwnedApi<TContract>, F>): AsyncResult<void, ValidationError | UnexpectedError>;
-    client: Trellis<ContractTrellisApi<TContract>, ContractKvOf<TContract>, ContractJobsOf<TContract>>;
-} & WithDeps<TDeps>) => unknown | Promise<unknown>;
-/** Typed job handler function for an extracted Trellis service job handler. */
-export type JobHandler<TContract extends ServiceContract<TrellisAPI, TrellisAPI | undefined, ContractJobsMetadata, ContractKvMetadata>, TJob extends ContractJobName<TContract>, TDeps = undefined> = (args: JobArgs<TContract, TJob, TDeps>) => Promise<JobResult<TContract, TJob>>;
+}) => MaybeAsync<void, BaseError>;
 /** Typed operation handler function for an extracted Trellis service handler. */
-export type OperationHandler<TContract extends ServiceContract<TrellisAPI, TrellisAPI | undefined, ContractJobsMetadata, ContractKvMetadata>, O extends ContractOperationName<TContract>, TDeps = undefined> = (args: OperationHandlerContext<InferSchemaType<ContractOwnedApi<TContract>["operations"][O]["input"]>, OperationProgressOf<ContractOwnedApi<TContract>, O>, OperationOutputOf<ContractOwnedApi<TContract>, O>, OperationTransferContextOf<ContractOwnedApi<TContract>, O>> & {
+export type OperationHandler<TContract extends ServiceContract<TrellisAPI, TrellisAPI | undefined, ContractJobsMetadata, ContractKvMetadata>, O extends ContractOperationName<TContract>> = (args: OperationHandlerContext<InferSchemaType<ContractOwnedApi<TContract>["operations"][O]["input"]>, OperationProgressOf<ContractOwnedApi<TContract>, O>, OperationOutputOf<ContractOwnedApi<TContract>, O>, OperationTransferContextOf<ContractOwnedApi<TContract>, O>, OperationHandlerErrorOf<ContractOwnedApi<TContract>, O>> & {
     client: Trellis<ContractTrellisApi<TContract>, ContractKvOf<TContract>, ContractJobsOf<TContract>>;
-} & WithDeps<TDeps>) => unknown | Promise<unknown>;
-/** Typed health info function for an extracted bound service health handler. */
-export type HealthInfoHandler<TDeps = undefined> = (args: WithDeps<TDeps>) => ServiceHealthInfo | undefined | Promise<ServiceHealthInfo | undefined>;
-/** Typed health check function for an extracted bound service health handler. */
-export type HealthCheckHandler<TDeps = undefined> = (args: WithDeps<TDeps>) => ServiceHealthCheck | Promise<ServiceHealthCheck>;
+}) => unknown | Promise<unknown>;
+/** Typed health info function for an extracted service health handler. */
+export type HealthInfoHandler = ServiceHealthInfoFn;
+/** Typed health check function for an extracted service health handler. */
+export type HealthCheckHandler = ServiceHealthCheckFn;
 export type JobQueue<TPayload, TResult, TTrellisApi extends TrellisAPI, TKv extends ContractKvMetadata = ContractKvMetadata, TJobs extends ContractJobsMetadata = {}> = {
     create(payload: TPayload): AsyncResult<JobRef<TPayload, TResult>, BaseError>;
+    submit(payload: TPayload): AsyncResult<JobSubmitOutcome<TPayload, TResult>, BaseError>;
     handle(handler: (args: {
         job: PublicActiveJob<TPayload, TResult>;
         client: Trellis<TTrellisApi, TKv, TJobs>;
@@ -245,80 +226,68 @@ export type JobsFacadeOf<TJobs extends ContractJobsMetadata, TTrellisApi extends
 };
 type ServiceEventName<TA extends TrellisAPI> = keyof TA["events"] & string;
 type ServiceEventOf<TA extends TrellisAPI, E extends ServiceEventName<TA>> = TA["events"][E] extends EventDesc<infer TEvent> ? InferSchemaType<TEvent> : never;
-type ServiceEventPayloadOf<TA extends TrellisAPI, E extends ServiceEventName<TA>> = Omit<ServiceEventOf<TA, E>, "header">;
-type BoundEventHandleFn<TEventApi extends TrellisAPI, TTrellisApi extends TrellisAPI, E extends ServiceEventName<TEventApi>, TKv extends ContractKvMetadata, TJobs extends ContractJobsMetadata, TDeps> = (args: {
-    event: ServiceEventOf<TEventApi, E>;
-    context: EventListenerContext;
-    client: Trellis<TTrellisApi, TKv, TJobs>;
-    deps: TDeps;
-}) => MaybeAsync<void, BaseError>;
-type BoundActiveEventFacade<TEventApi extends TrellisAPI, TTrellisApi extends TrellisAPI, TKv extends ContractKvMetadata, TJobs extends ContractJobsMetadata, TDeps> = {
+type ServiceEventPayloadOf<TA extends TrellisAPI, E extends ServiceEventName<TA>> = ServiceEventOf<TA, E> & Record<string, unknown>;
+/** Runs SQL outbox work inside a caller-owned service database transaction. */
+export type SqlOutboxTransactionRunner<TTx> = <TResult>(work: (context: {
+    tx: TTx;
+    executor: SqlExecutor;
+}) => Promise<TResult> | TResult) => Promise<TResult>;
+/** Options shared by all Trellis SQL outbox service bindings. */
+export type TrellisServiceSqlOutboxCommonOptions = {
+    /** SQL dialect used by the Trellis helper tables. */
+    readonly dialect: SqlDialect;
+    /** Optional Trellis helper-table names; omitted names use Trellis defaults. */
+    readonly tables?: Partial<SqlOutboxTables>;
+    /** Optional process-local dispatcher tuning. */
+    readonly dispatcher?: OutboxDispatcherOptions;
+};
+/** Options for binding a Trellis service to generic caller-owned SQL storage. */
+export type TrellisServiceSqlOutboxExecutorOptions<TTx> = TrellisServiceSqlOutboxCommonOptions & {
+    /** Non-transactional executor used by the process-local dispatcher. */
+    readonly executor: SqlExecutor;
+    /** Service-owned transaction runner for handler-scoped work. */
+    readonly transaction: SqlOutboxTransactionRunner<TTx>;
+};
+/** Options for binding a Trellis service to caller-owned SQL outbox storage. */
+export type TrellisServiceSqlOutboxOptions<TTx> = TrellisServiceSqlOutboxExecutorOptions<TTx>;
+/** Typed transaction-scoped event facade that enqueues prepared events. */
+export type SqlOutboxEventEnqueueFacade<TEventApi extends TrellisAPI = TrellisAPI> = {
     readonly [TGroup in SurfaceGroupName<ServiceEventName<TEventApi>>]: {
         readonly [E in SurfaceKeysForGroup<ServiceEventName<TEventApi>, TGroup> as SurfaceLeafName<E>]: {
-            prepare(event: ServiceEventPayloadOf<TEventApi, E>): Result<PreparedTrellisEvent<ServiceEventPayloadOf<TEventApi, E>>, ValidationError | UnexpectedError>;
-            publish(event: ServiceEventPayloadOf<TEventApi, E>): AsyncResult<void, ValidationError | UnexpectedError>;
-            listen(handler: BoundEventHandleFn<TEventApi, TTrellisApi, E, TKv, TJobs, TDeps>, subjectData?: Record<string, unknown>, opts?: EventOpts): AsyncResult<void, ValidationError | UnexpectedError>;
-        };
-    };
-};
-type BoundRpcHandleFn<TOwnedApi extends TrellisAPI, TTrellisApi extends TrellisAPI, M extends RpcMethodName<TOwnedApi>, TKv extends ContractKvMetadata, TJobs extends ContractJobsMetadata, TDeps> = (args: {
-    input: RpcMethodInput<TOwnedApi, M>;
-    context: RpcHandlerContext;
-    client: Trellis<TTrellisApi, TKv, TJobs>;
-    deps: TDeps;
-}) => Promise<Result<RpcMethodOutput<TOwnedApi, M>, RpcHandlerErrorOf<TOwnedApi, M>>> | Result<RpcMethodOutput<TOwnedApi, M>, RpcHandlerErrorOf<TOwnedApi, M>>;
-type BoundFeedHandleFn<TOwnedApi extends TrellisAPI, TTrellisApi extends TrellisAPI, F extends keyof TOwnedApi["feeds"] & string, TKv extends ContractKvMetadata, TJobs extends ContractJobsMetadata, TDeps> = (context: {
-    input: FeedInputOf<TOwnedApi, F>;
-    caller: unknown;
-    signal: AbortSignal;
-    emit(event: FeedEventOf<TOwnedApi, F>): AsyncResult<void, ValidationError | UnexpectedError>;
-    client: Trellis<TTrellisApi, TKv, TJobs>;
-    deps: TDeps;
-}) => unknown | Promise<unknown>;
-type BoundOperationHandleFn<TOwnedApi extends TrellisAPI, TTrellisApi extends TrellisAPI, O extends keyof TOwnedApi["operations"] & string, TKv extends ContractKvMetadata, TJobs extends ContractJobsMetadata, TDeps> = ((handler: (context: OperationHandlerContext<InferSchemaType<TOwnedApi["operations"][O]["input"]>, OperationProgressOf<TOwnedApi, O>, OperationOutputOf<TOwnedApi, O>, OperationTransferContextOf<TOwnedApi, O>> & {
-    client: Trellis<TTrellisApi, TKv, TJobs>;
-    deps: TDeps;
-}) => unknown | Promise<unknown>) => Promise<void>) & Pick<OperationHandleFn<TOwnedApi, TTrellisApi, O, TKv, TJobs>, "accept" | "control">;
-type BoundTypedServiceHandleFacade<TOwnedApi extends TrellisAPI, TTrellisApi extends TrellisAPI, TKv extends ContractKvMetadata, TJobs extends ContractJobsMetadata, TDeps> = {
-    readonly rpc: {
-        readonly [TGroup in SurfaceGroupName<RpcMethodName<TOwnedApi>>]: {
-            readonly [M in SurfaceKeysForGroup<RpcMethodName<TOwnedApi>, TGroup> as SurfaceLeafName<M>]: (handler: BoundRpcHandleFn<TOwnedApi, TTrellisApi, M, TKv, TJobs, TDeps>) => Promise<void>;
-        };
-    };
-    readonly feed: {
-        readonly [TGroup in SurfaceGroupName<keyof TOwnedApi["feeds"] & string>]: {
-            readonly [F in SurfaceKeysForGroup<keyof TOwnedApi["feeds"] & string, TGroup> as SurfaceLeafName<F>]: (handler: BoundFeedHandleFn<TOwnedApi, TTrellisApi, F, TKv, TJobs, TDeps>) => Promise<void>;
-        };
-    };
-    readonly operation: {
-        readonly [TGroup in SurfaceGroupName<keyof TOwnedApi["operations"] & string>]: {
-            readonly [O in SurfaceKeysForGroup<keyof TOwnedApi["operations"] & string, TGroup> as SurfaceLeafName<O>]: BoundOperationHandleFn<TOwnedApi, TTrellisApi, O, TKv, TJobs, TDeps>;
+            enqueue(event: ServiceEventPayloadOf<TEventApi, E>): AsyncResult<OutboxMessage, ValidationError | UnexpectedError>;
         };
     };
 };
-type BoundJobQueue<TPayload, TResult, TTrellisApi extends TrellisAPI, TKv extends ContractKvMetadata, TJobs extends ContractJobsMetadata, TDeps> = {
-    create(payload: TPayload): AsyncResult<JobRef<TPayload, TResult>, BaseError>;
-    handle(handler: (args: {
-        job: PublicActiveJob<TPayload, TResult>;
-        client: Trellis<TTrellisApi, TKv, TJobs>;
-        deps: TDeps;
-    }) => Promise<Result<TResult, BaseError>>): void;
+/** Returned by outbox.job.<queue>.create/submit inside a transaction. */
+export type SqlOutboxJobSubmission = {
+    readonly submissionId: string;
+    readonly jobId: string;
+    readonly queue: string;
+    readonly mode: "create" | "submit";
 };
-type BoundJobsFacadeOf<TJobs extends ContractJobsMetadata, TTrellisApi extends TrellisAPI, TKv extends ContractKvMetadata, TDeps> = {
-    [K in keyof TJobs]: BoundJobQueue<TJobs[K]["payload"], TJobs[K]["result"], TTrellisApi, TKv, TJobs, TDeps>;
+/** Transaction-scoped facade for enqueuing job creation/submission intents. */
+export type SqlOutboxJobEnqueueFacade<TJobs extends ContractJobsMetadata> = {
+    readonly [K in keyof TJobs]: {
+        create(payload: TJobs[K]["payload"]): AsyncResult<SqlOutboxJobSubmission, ValidationError | UnexpectedError>;
+        submit(payload: TJobs[K]["payload"]): AsyncResult<SqlOutboxJobSubmission, ValidationError | UnexpectedError>;
+    };
 };
-type BoundServiceHealth<TDeps> = Omit<ServiceHealth, "add" | "setInfo"> & {
-    setInfo(info: ServiceHealthInfo | HealthInfoHandler<TDeps>): void;
-    add(name: string, check: HealthCheckHandler<TDeps>): () => void;
+/** Context supplied to `outbox.transaction(...)` work callbacks. */
+export type SqlOutboxTransactionContext<TTx, TEventApi extends TrellisAPI = TrellisAPI, TJobs extends ContractJobsMetadata = ContractJobsMetadata> = {
+    /** Service-owned transaction object supplied by the configured runner. */
+    readonly tx: TTx;
+    /** Transaction-scoped typed event enqueue facade. */
+    readonly event: SqlOutboxEventEnqueueFacade<TEventApi>;
+    /** Transaction-scoped typed job enqueue facade. */
+    readonly job: SqlOutboxJobEnqueueFacade<TJobs>;
 };
-/** Service wrapper returned by `TrellisService.with(deps)`. */
-export type BoundTrellisService<TOwnedApi extends TrellisAPI = TrellisAPI, TTrellisApi extends TrellisAPI = TOwnedApi, TJobs extends ContractJobsMetadata = {}, TKv extends ContractKvMetadata = ContractKvMetadata, TDeps = unknown> = Pick<TrellisService<TOwnedApi, TTrellisApi, TJobs, TKv>, "name" | "auth" | "kv" | "store" | "connection" | "createTransfer" | "completeOperation" | "publishPrepared" | "wait" | "stop"> & {
-    readonly event: BoundActiveEventFacade<TTrellisApi, TTrellisApi, TKv, TJobs, TDeps>;
-    readonly health: BoundServiceHealth<TDeps>;
-    readonly jobs: BoundJobsFacadeOf<TJobs, TTrellisApi, TKv, TDeps>;
-    readonly handle: BoundTypedServiceHandleFacade<TOwnedApi, TTrellisApi, TKv, TJobs, TDeps>;
-    /** Returns a new bound wrapper that injects the provided dependencies. */
-    with<TNextDeps>(deps: TNextDeps): BoundTrellisService<TOwnedApi, TTrellisApi, TJobs, TKv, TNextDeps>;
+/** Startup-created SQL outbox dependency for transactional event/job enqueue. */
+export type SqlOutbox<TTx, TEventApi extends TrellisAPI = TrellisAPI, TJobs extends ContractJobsMetadata = ContractJobsMetadata> = {
+    /**
+     * Runs service DB work and typed event/job enqueue operations in one SQL
+     * transaction, notifying the dispatcher once after a successful commit.
+     */
+    transaction<TResult>(work: (context: SqlOutboxTransactionContext<TTx, TEventApi, TJobs>) => Promise<TResult> | TResult): AsyncResult<TResult, ValidationError | UnexpectedError>;
 };
 type PascalSurfaceName<T extends string> = T extends `${infer Head}.${infer Tail}` ? `${Capitalize<Head>}${PascalSurfaceName<Tail>}` : Capitalize<T>;
 type LowerCamelSurfaceName<T extends string> = Uncapitalize<PascalSurfaceName<T>>;
@@ -354,24 +323,24 @@ type FeedHandleFn<TOwnedApi extends TrellisAPI, TTrellisApi extends TrellisAPI,
     emit(event: FeedEventOf<TOwnedApi, F>): AsyncResult<void, ValidationError | UnexpectedError>;
     client: Trellis<TTrellisApi, TKv, TJobs>;
 }) => unknown | Promise<unknown>;
-type OperationHandleFn<TOwnedApi extends TrellisAPI, TTrellisApi extends TrellisAPI, O extends keyof TOwnedApi["operations"] & string, TKv extends ContractKvMetadata, TJobs extends ContractJobsMetadata> = ((handler: (context: OperationHandlerContext<InferSchemaType<TOwnedApi["operations"][O]["input"]>, OperationProgressOf<TOwnedApi, O>, OperationOutputOf<TOwnedApi, O>, OperationTransferContextOf<TOwnedApi, O>> & {
+type OperationHandleFn<TOwnedApi extends TrellisAPI, TTrellisApi extends TrellisAPI, O extends keyof TOwnedApi["operations"] & string, TKv extends ContractKvMetadata, TJobs extends ContractJobsMetadata> = ((handler: (context: OperationHandlerContext<InferSchemaType<TOwnedApi["operations"][O]["input"]>, OperationProgressOf<TOwnedApi, O>, OperationOutputOf<TOwnedApi, O>, OperationTransferContextOf<TOwnedApi, O>, OperationHandlerErrorOf<TOwnedApi, O>> & {
     client: Trellis<TTrellisApi, TKv, TJobs>;
 }) => unknown | Promise<unknown>) => Promise<void>) & {
     accept(args: {
         sessionKey: string;
-    }): AsyncResult<AcceptedOperation<OperationProgressOf<TOwnedApi, O>, OperationOutputOf<TOwnedApi, O>>, UnexpectedError>;
-    control(operationId: string): AsyncResult<OperationRuntimeHandle<OperationProgressOf<TOwnedApi, O>, OperationOutputOf<TOwnedApi, O>>, BaseError>;
+    }): AsyncResult<AcceptedOperation<OperationProgressOf<TOwnedApi, O>, OperationOutputOf<TOwnedApi, O>, OperationHandlerErrorOf<TOwnedApi, O>>, UnexpectedError>;
+    control(operationId: string): AsyncResult<OperationRuntimeHandle<OperationProgressOf<TOwnedApi, O>, OperationOutputOf<TOwnedApi, O>, OperationHandlerErrorOf<TOwnedApi, O>>, BaseError>;
 };
 export type OperationRegistration<TOwnedApi extends TrellisAPI, TTrellisApi extends TrellisAPI, O extends keyof TOwnedApi["operations"] & string, TKv extends ContractKvMetadata = ContractKvMetadata, TJobs extends ContractJobsMetadata = {}> = {
     accept(args: {
         sessionKey: string;
-    }): AsyncResult<AcceptedOperation<OperationProgressOf<TOwnedApi, O>, OperationOutputOf<TOwnedApi, O>>, UnexpectedError>;
+    }): AsyncResult<AcceptedOperation<OperationProgressOf<TOwnedApi, O>, OperationOutputOf<TOwnedApi, O>, OperationHandlerErrorOf<TOwnedApi, O>>, UnexpectedError>;
     /**
      * Loads an existing operation by id and returns a service-side control handle.
      * The operation must belong to this service and registration name.
      */
-    control(operationId: string): AsyncResult<OperationRuntimeHandle<OperationProgressOf<TOwnedApi, O>, OperationOutputOf<TOwnedApi, O>>, BaseError>;
-    handle(handler: (args: OperationHandlerContext<InferSchemaType<TOwnedApi["operations"][O]["input"]>, OperationProgressOf<TOwnedApi, O>, OperationOutputOf<TOwnedApi, O>, OperationTransferContextOf<TOwnedApi, O>> & {
+    control(operationId: string): AsyncResult<OperationRuntimeHandle<OperationProgressOf<TOwnedApi, O>, OperationOutputOf<TOwnedApi, O>, OperationHandlerErrorOf<TOwnedApi, O>>, BaseError>;
+    handle(handler: (args: OperationHandlerContext<InferSchemaType<TOwnedApi["operations"][O]["input"]>, OperationProgressOf<TOwnedApi, O>, OperationOutputOf<TOwnedApi, O>, OperationTransferContextOf<TOwnedApi, O>, OperationHandlerErrorOf<TOwnedApi, O>> & {
         client: Trellis<TTrellisApi, TKv, TJobs>;
     }) => unknown | Promise<unknown>): Promise<void>;
 };
@@ -408,10 +377,10 @@ export declare class TrellisService<TOwnedApi extends TrellisAPI = TrellisAPI, T
     readonly connection: TrellisConnection;
     private constructor();
     /**
-     * Returns a service wrapper that injects application dependencies into
-     * service-owned handler argument objects as `args.deps`.
+     * Creates an explicit SQL outbox helper for service-owned transactions.
+     * Services should create this at startup and close over it in handlers.
      */
-    with<TDeps>(deps: TDeps): BoundTrellisService<TOwnedApi, TTrellisApi, TJobs, TKv, TDeps>;
+    createSqlOutbox<TTx>(options: TrellisServiceSqlOutboxExecutorOptions<TTx>): SqlOutbox<TTx, TTrellisApi, TJobs>;
     /** Publishes a prepared event through the service runtime connection. */
     publishPrepared(event: PreparedTrellisEvent): AsyncResult<void, UnexpectedError>;
     /**