@qlever-llc/trellis 0.10.1-rc.6 → 0.10.2

package/src/sdk/_generated/jobs/client.ts

@@ -0,0 +1,78 @@
+// Generated from ./generated/contracts/manifests/trellis.jobs@v1.json
+import type { AcceptedOperation, AsyncResult, BaseError, EventOpts, FeedSubscribeOpts, FeedSubscription, HandlerTrellis, MapStateStoreClient, MaybeAsync, OperationInputBuilder, OperationObserverCallbacks, OperationRef, OperationRefData, OperationRuntimeHandle, PreparedTrellisEvent, ReceiveTransferGrant, ReceiveTransferHandle, RequestOpts, Result, RpcHandlerContext, SendTransferGrant, SendTransferHandle, TerminalOperation, TransferCapableOperationInputBuilder, TrellisConnection, UnexpectedError, ValidationError, ValueStateStoreClient } from "@qlever-llc/trellis";
+import type { API, Api } from "./api.js";
+import type * as Types from "./types.js";
+import type * as AuthSdk from "../../auth.js";
+import type * as CoreSdk from "../../core.js";
+import type * as HealthSdk from "../../health.js";
+
+type EventCallback<TMessage> = {
+  bivarianceHack(message: TMessage): MaybeAsync<void, BaseError>;
+}["bivarianceHack"];
+
+type RpcHandler<TInput, TOutput> = (args: { input: TInput; context: RpcHandlerContext; client: HandlerClient }) => MaybeAsync<TOutput, BaseError>;
+
+export type TrellisJobsState = {};
+
+export interface TrellisJobsClient {
+  readonly name: string;
+  readonly timeout: number;
+  readonly stream: string;
+  readonly api: Api;
+  readonly state: TrellisJobsState;
+  readonly connection: TrellisConnection;
+  transfer(grant: SendTransferGrant): SendTransferHandle;
+  transfer(grant: ReceiveTransferGrant): ReceiveTransferHandle;
+  readonly rpc: {
+    readonly auth: {
+      requestsValidate(input: AuthSdk.AuthRequestsValidateInput, opts?: RequestOpts): AsyncResult<AuthSdk.AuthRequestsValidateOutput, BaseError>;
+    };
+    readonly jobs: {
+      cancel(input: Types.JobsCancelInput, opts?: RequestOpts): AsyncResult<Types.JobsCancelOutput, BaseError>;
+      dismissDLQ(input: Types.JobsDismissDLQInput, opts?: RequestOpts): AsyncResult<Types.JobsDismissDLQOutput, BaseError>;
+      get(input: Types.JobsGetInput, opts?: RequestOpts): AsyncResult<Types.JobsGetOutput, BaseError>;
+      health(input: Types.JobsHealthInput, opts?: RequestOpts): AsyncResult<Types.JobsHealthOutput, BaseError>;
+      list(input: Types.JobsListInput, opts?: RequestOpts): AsyncResult<Types.JobsListOutput, BaseError>;
+      listDLQ(input: Types.JobsListDLQInput, opts?: RequestOpts): AsyncResult<Types.JobsListDLQOutput, BaseError>;
+      listServices(input: Types.JobsListServicesInput, opts?: RequestOpts): AsyncResult<Types.JobsListServicesOutput, BaseError>;
+      replayDLQ(input: Types.JobsReplayDLQInput, opts?: RequestOpts): AsyncResult<Types.JobsReplayDLQOutput, BaseError>;
+      retry(input: Types.JobsRetryInput, opts?: RequestOpts): AsyncResult<Types.JobsRetryOutput, BaseError>;
+    };
+    readonly trellis: {
+      catalog(input: CoreSdk.TrellisCatalogInput, opts?: RequestOpts): AsyncResult<CoreSdk.TrellisCatalogOutput, BaseError>;
+    };
+  };
+  readonly event: {
+    readonly health: {
+      heartbeat: { publish(event: Omit<HealthSdk.HealthHeartbeatEvent, "header">): AsyncResult<void, ValidationError | UnexpectedError>; prepare(event: Omit<HealthSdk.HealthHeartbeatEvent, "header">): Result<PreparedTrellisEvent<Omit<HealthSdk.HealthHeartbeatEvent, "header">>, ValidationError | UnexpectedError>; listen(handler: EventCallback<HealthSdk.HealthHeartbeatEvent>, subjectData?: Record<string, unknown>, opts?: EventOpts): AsyncResult<void, ValidationError | UnexpectedError>; };
+    };
+  };
+  readonly feed: {};
+  readonly operation: {};
+  wait(): AsyncResult<void, BaseError>;
+}
+
+export interface Service extends Client {
+  readonly handle: ServiceHandle;
+}
+
+export interface ServiceHandle {
+  readonly rpc: {
+    readonly jobs: {
+      cancel(handler: RpcHandler<Types.JobsCancelInput, Types.JobsCancelOutput>): Promise<void>;
+      dismissDLQ(handler: RpcHandler<Types.JobsDismissDLQInput, Types.JobsDismissDLQOutput>): Promise<void>;
+      get(handler: RpcHandler<Types.JobsGetInput, Types.JobsGetOutput>): Promise<void>;
+      health(handler: RpcHandler<Types.JobsHealthInput, Types.JobsHealthOutput>): Promise<void>;
+      list(handler: RpcHandler<Types.JobsListInput, Types.JobsListOutput>): Promise<void>;
+      listDLQ(handler: RpcHandler<Types.JobsListDLQInput, Types.JobsListDLQOutput>): Promise<void>;
+      listServices(handler: RpcHandler<Types.JobsListServicesInput, Types.JobsListServicesOutput>): Promise<void>;
+      replayDLQ(handler: RpcHandler<Types.JobsReplayDLQInput, Types.JobsReplayDLQOutput>): Promise<void>;
+      retry(handler: RpcHandler<Types.JobsRetryInput, Types.JobsRetryOutput>): Promise<void>;
+    };
+  };
+  readonly feed: {};
+  readonly operation: {};
+}
+
+export type HandlerClient = HandlerTrellis<Api>;
+export type Client = TrellisJobsClient;

package/src/sdk/_generated/jobs/contract.ts

@@ -0,0 +1,67 @@
+// Generated from ./generated/contracts/manifests/trellis.jobs@v1.json
+import type { ContractDependencyUse, SdkContractModule, TrellisContractV1, UseSpec } from "@qlever-llc/trellis";
+import { API } from "./api.js";
+
+const CONTRACT_MODULE_METADATA = Symbol.for("@qlever-llc/trellis/contracts/contract-module");
+
+export const CONTRACT_ID = "trellis.jobs@v1" as const;
+export const CONTRACT_DIGEST = "jSB8nKGOQqIxdFDdUqO-gOTt3Dijg--SOXJtJ1ChpoY" as const;
+export const CONTRACT = {"capabilities":{"trellis.jobs::admin.mutate":{"consequence":"Can change background job execution state.","description":"Cancel, retry, replay, or dismiss Jobs service work items.","displayName":"Mutate jobs admin data"},"trellis.jobs::admin.read":{"description":"View Jobs service health, services, jobs, and dead-letter queues.","displayName":"Read jobs admin data"}},"description":"Trellis-managed background job administration API.","displayName":"Trellis Jobs","docs":{"markdown":"Provides health, service, job, retry, cancel, and dead-letter queue RPCs for Trellis-managed background work.","summary":"Background job administration APIs."},"errors":{"NotFoundError":{"schema":{"schema":"NotFoundErrorData"},"type":"NotFoundError"}},"format":"trellis.contract.v1","id":"trellis.jobs@v1","kind":"service","rpc":{"Jobs.Cancel":{"capabilities":{"call":["trellis.jobs::admin.mutate"]},"docs":{"markdown":"Requests cancellation for one background job.","summary":"Cancel a job."},"errors":[{"type":"UnexpectedError"},{"type":"ValidationError"},{"type":"NotFoundError"}],"input":{"schema":"JobsCancelRequest"},"output":{"schema":"JobsCancelResponse"},"subject":"rpc.v1.Jobs.Cancel","version":"v1"},"Jobs.DismissDLQ":{"capabilities":{"call":["trellis.jobs::admin.mutate"]},"docs":{"markdown":"Marks one dead-letter job as dismissed.","summary":"Dismiss a dead-letter job."},"errors":[{"type":"UnexpectedError"},{"type":"ValidationError"},{"type":"NotFoundError"}],"input":{"schema":"JobsDismissDLQRequest"},"output":{"schema":"JobsDismissDLQResponse"},"subject":"rpc.v1.Jobs.DismissDLQ","version":"v1"},"Jobs.Get":{"capabilities":{"call":["trellis.jobs::admin.read"]},"docs":{"markdown":"Returns one background job by id.","summary":"Read a job."},"errors":[{"type":"UnexpectedError"},{"type":"ValidationError"},{"type":"NotFoundError"}],"input":{"schema":"JobsGetRequest"},"output":{"schema":"JobsGetResponse"},"subject":"rpc.v1.Jobs.Get","version":"v1"},"Jobs.Health":{"capabilities":{"call":["trellis.jobs::admin.read"]},"docs":{"markdown":"Returns Jobs service health and worker status details.","summary":"Read jobs health."},"errors":[{"type":"UnexpectedError"}],"input":{"schema":"Empty"},"output":{"schema":"JobsHealthResponse"},"subject":"rpc.v1.Jobs.Health","version":"v1"},"Jobs.List":{"capabilities":{"call":["trellis.jobs::admin.read"]},"docs":{"markdown":"Lists jobs matching the requested filters.","summary":"List jobs."},"errors":[{"type":"UnexpectedError"},{"type":"ValidationError"}],"input":{"schema":"JobsListRequest"},"output":{"schema":"JobsListResponse"},"subject":"rpc.v1.Jobs.List","version":"v1"},"Jobs.ListDLQ":{"capabilities":{"call":["trellis.jobs::admin.read"]},"docs":{"markdown":"Lists jobs currently in dead-letter queues.","summary":"List dead-letter jobs."},"errors":[{"type":"UnexpectedError"},{"type":"ValidationError"}],"input":{"schema":"JobsListDLQRequest"},"output":{"schema":"JobsListDLQResponse"},"subject":"rpc.v1.Jobs.ListDLQ","version":"v1"},"Jobs.ListServices":{"capabilities":{"call":["trellis.jobs::admin.read"]},"docs":{"markdown":"Lists services that own or execute background job queues.","summary":"List job services."},"errors":[{"type":"UnexpectedError"},{"type":"ValidationError"}],"input":{"schema":"JobsListServicesRequest"},"output":{"schema":"JobsListServicesResponse"},"subject":"rpc.v1.Jobs.ListServices","version":"v1"},"Jobs.ReplayDLQ":{"capabilities":{"call":["trellis.jobs::admin.mutate"]},"docs":{"markdown":"Moves one dead-letter job back to processing.","summary":"Replay a dead-letter job."},"errors":[{"type":"UnexpectedError"},{"type":"ValidationError"},{"type":"NotFoundError"}],"input":{"schema":"JobsReplayDLQRequest"},"output":{"schema":"JobsReplayDLQResponse"},"subject":"rpc.v1.Jobs.ReplayDLQ","version":"v1"},"Jobs.Retry":{"capabilities":{"call":["trellis.jobs::admin.mutate"]},"docs":{"markdown":"Moves a failed job back into retry processing.","summary":"Retry a job."},"errors":[{"type":"UnexpectedError"},{"type":"ValidationError"},{"type":"NotFoundError"}],"input":{"schema":"JobsRetryRequest"},"output":{"schema":"JobsRetryResponse"},"subject":"rpc.v1.Jobs.Retry","version":"v1"}},"schemas":{"Empty":{"properties":{},"type":"object"},"Job":{"properties":{"completedAt":{"format":"date-time","type":"string"},"context":{"properties":{"requestId":{"minLength":1,"type":"string"},"traceId":{"pattern":"^[0-9a-f]{32}$","type":"string"},"traceparent":{"pattern":"^[0-9a-f]{2}-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$","type":"string"},"tracestate":{"minLength":1,"type":"string"}},"required":["requestId","traceId","traceparent"],"type":"object"},"createdAt":{"format":"date-time","type":"string"},"deadline":{"format":"date-time","type":"string"},"id":{"minLength":1,"type":"string"},"lastError":{"type":"string"},"logs":{"items":{"properties":{"level":{"anyOf":[{"const":"info","type":"string"},{"const":"warn","type":"string"},{"const":"error","type":"string"}]},"message":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"required":["timestamp","level","message"],"type":"object"},"type":"array"},"maxTries":{"minimum":1,"type":"integer"},"payload":{},"progress":{"properties":{"current":{"minimum":0,"type":"integer"},"message":{"type":"string"},"step":{"type":"string"},"total":{"minimum":0,"type":"integer"}},"type":"object"},"result":{},"service":{"minLength":1,"type":"string"},"startedAt":{"format":"date-time","type":"string"},"state":{"anyOf":[{"const":"pending","type":"string"},{"const":"active","type":"string"},{"const":"retry","type":"string"},{"const":"completed","type":"string"},{"const":"failed","type":"string"},{"const":"cancelled","type":"string"},{"const":"expired","type":"string"},{"const":"dead","type":"string"},{"const":"dismissed","type":"string"}]},"tries":{"minimum":0,"type":"integer"},"type":{"minLength":1,"type":"string"},"updatedAt":{"format":"date-time","type":"string"}},"required":["id","context","service","type","state","payload","createdAt","updatedAt","tries","maxTries"],"type":"object"},"JobContext":{"properties":{"requestId":{"minLength":1,"type":"string"},"traceId":{"pattern":"^[0-9a-f]{32}$","type":"string"},"traceparent":{"pattern":"^[0-9a-f]{2}-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$","type":"string"},"tracestate":{"minLength":1,"type":"string"}},"required":["requestId","traceId","traceparent"],"type":"object"},"JobLogEntry":{"properties":{"level":{"anyOf":[{"const":"info","type":"string"},{"const":"warn","type":"string"},{"const":"error","type":"string"}]},"message":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"required":["timestamp","level","message"],"type":"object"},"JobProgress":{"properties":{"current":{"minimum":0,"type":"integer"},"message":{"type":"string"},"step":{"type":"string"},"total":{"minimum":0,"type":"integer"}},"type":"object"},"JobState":{"anyOf":[{"const":"pending","type":"string"},{"const":"active","type":"string"},{"const":"retry","type":"string"},{"const":"completed","type":"string"},{"const":"failed","type":"string"},{"const":"cancelled","type":"string"},{"const":"expired","type":"string"},{"const":"dead","type":"string"},{"const":"dismissed","type":"string"}]},"JobsCancelRequest":{"description":"Jobs admin ids are globally addressable; callers identify jobs by id only.","properties":{"id":{"minLength":1,"type":"string"}},"required":["id"],"type":"object"},"JobsCancelResponse":{"properties":{"job":{"properties":{"completedAt":{"format":"date-time","type":"string"},"context":{"properties":{"requestId":{"minLength":1,"type":"string"},"traceId":{"pattern":"^[0-9a-f]{32}$","type":"string"},"traceparent":{"pattern":"^[0-9a-f]{2}-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$","type":"string"},"tracestate":{"minLength":1,"type":"string"}},"required":["requestId","traceId","traceparent"],"type":"object"},"createdAt":{"format":"date-time","type":"string"},"deadline":{"format":"date-time","type":"string"},"id":{"minLength":1,"type":"string"},"lastError":{"type":"string"},"logs":{"items":{"properties":{"level":{"anyOf":[{"const":"info","type":"string"},{"const":"warn","type":"string"},{"const":"error","type":"string"}]},"message":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"required":["timestamp","level","message"],"type":"object"},"type":"array"},"maxTries":{"minimum":1,"type":"integer"},"payload":{},"progress":{"properties":{"current":{"minimum":0,"type":"integer"},"message":{"type":"string"},"step":{"type":"string"},"total":{"minimum":0,"type":"integer"}},"type":"object"},"result":{},"service":{"minLength":1,"type":"string"},"startedAt":{"format":"date-time","type":"string"},"state":{"anyOf":[{"const":"pending","type":"string"},{"const":"active","type":"string"},{"const":"retry","type":"string"},{"const":"completed","type":"string"},{"const":"failed","type":"string"},{"const":"cancelled","type":"string"},{"const":"expired","type":"string"},{"const":"dead","type":"string"},{"const":"dismissed","type":"string"}]},"tries":{"minimum":0,"type":"integer"},"type":{"minLength":1,"type":"string"},"updatedAt":{"format":"date-time","type":"string"}},"required":["id","context","service","type","state","payload","createdAt","updatedAt","tries","maxTries"],"type":"object"}},"required":["job"],"type":"object"},"JobsDismissDLQRequest":{"description":"Jobs admin ids are globally addressable; callers identify jobs by id only.","properties":{"id":{"minLength":1,"type":"string"}},"required":["id"],"type":"object"},"JobsDismissDLQResponse":{"properties":{"job":{"properties":{"completedAt":{"format":"date-time","type":"string"},"context":{"properties":{"requestId":{"minLength":1,"type":"string"},"traceId":{"pattern":"^[0-9a-f]{32}$","type":"string"},"traceparent":{"pattern":"^[0-9a-f]{2}-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$","type":"string"},"tracestate":{"minLength":1,"type":"string"}},"required":["requestId","traceId","traceparent"],"type":"object"},"createdAt":{"format":"date-time","type":"string"},"deadline":{"format":"date-time","type":"string"},"id":{"minLength":1,"type":"string"},"lastError":{"type":"string"},"logs":{"items":{"properties":{"level":{"anyOf":[{"const":"info","type":"string"},{"const":"warn","type":"string"},{"const":"error","type":"string"}]},"message":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"required":["timestamp","level","message"],"type":"object"},"type":"array"},"maxTries":{"minimum":1,"type":"integer"},"payload":{},"progress":{"properties":{"current":{"minimum":0,"type":"integer"},"message":{"type":"string"},"step":{"type":"string"},"total":{"minimum":0,"type":"integer"}},"type":"object"},"result":{},"service":{"minLength":1,"type":"string"},"startedAt":{"format":"date-time","type":"string"},"state":{"anyOf":[{"const":"pending","type":"string"},{"const":"active","type":"string"},{"const":"retry","type":"string"},{"const":"completed","type":"string"},{"const":"failed","type":"string"},{"const":"cancelled","type":"string"},{"const":"expired","type":"string"},{"const":"dead","type":"string"},{"const":"dismissed","type":"string"}]},"tries":{"minimum":0,"type":"integer"},"type":{"minLength":1,"type":"string"},"updatedAt":{"format":"date-time","type":"string"}},"required":["id","context","service","type","state","payload","createdAt","updatedAt","tries","maxTries"],"type":"object"}},"required":["job"],"type":"object"},"JobsGetRequest":{"description":"Jobs admin ids are globally addressable; callers identify jobs by id only.","properties":{"id":{"minLength":1,"type":"string"}},"required":["id"],"type":"object"},"JobsGetResponse":{"properties":{"job":{"properties":{"completedAt":{"format":"date-time","type":"string"},"context":{"properties":{"requestId":{"minLength":1,"type":"string"},"traceId":{"pattern":"^[0-9a-f]{32}$","type":"string"},"traceparent":{"pattern":"^[0-9a-f]{2}-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$","type":"string"},"tracestate":{"minLength":1,"type":"string"}},"required":["requestId","traceId","traceparent"],"type":"object"},"createdAt":{"format":"date-time","type":"string"},"deadline":{"format":"date-time","type":"string"},"id":{"minLength":1,"type":"string"},"lastError":{"type":"string"},"logs":{"items":{"properties":{"level":{"anyOf":[{"const":"info","type":"string"},{"const":"warn","type":"string"},{"const":"error","type":"string"}]},"message":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"required":["timestamp","level","message"],"type":"object"},"type":"array"},"maxTries":{"minimum":1,"type":"integer"},"payload":{},"progress":{"properties":{"current":{"minimum":0,"type":"integer"},"message":{"type":"string"},"step":{"type":"string"},"total":{"minimum":0,"type":"integer"}},"type":"object"},"result":{},"service":{"minLength":1,"type":"string"},"startedAt":{"format":"date-time","type":"string"},"state":{"anyOf":[{"const":"pending","type":"string"},{"const":"active","type":"string"},{"const":"retry","type":"string"},{"const":"completed","type":"string"},{"const":"failed","type":"string"},{"const":"cancelled","type":"string"},{"const":"expired","type":"string"},{"const":"dead","type":"string"},{"const":"dismissed","type":"string"}]},"tries":{"minimum":0,"type":"integer"},"type":{"minLength":1,"type":"string"},"updatedAt":{"format":"date-time","type":"string"}},"required":["id","context","service","type","state","payload","createdAt","updatedAt","tries","maxTries"],"type":"object"}},"required":["job"],"type":"object"},"JobsHealthResponse":{"properties":{"checks":{"items":{"patternProperties":{"^.*$":{}},"type":"object"},"type":"array"},"service":{"minLength":1,"type":"string"},"status":{},"timestamp":{"format":"date-time","type":"string"}},"required":["service","status","timestamp","checks"],"type":"object"},"JobsListDLQRequest":{"properties":{"limit":{"minimum":1,"type":"integer"},"offset":{"minimum":0,"type":"integer"},"service":{"minLength":1,"type":"string"},"since":{"format":"date-time","type":"string"},"type":{"minLength":1,"type":"string"}},"required":["limit"],"type":"object"},"JobsListDLQResponse":{"properties":{"count":{"minimum":0,"type":"integer"},"entries":{"items":{"properties":{"completedAt":{"format":"date-time","type":"string"},"context":{"properties":{"requestId":{"minLength":1,"type":"string"},"traceId":{"pattern":"^[0-9a-f]{32}$","type":"string"},"traceparent":{"pattern":"^[0-9a-f]{2}-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$","type":"string"},"tracestate":{"minLength":1,"type":"string"}},"required":["requestId","traceId","traceparent"],"type":"object"},"createdAt":{"format":"date-time","type":"string"},"deadline":{"format":"date-time","type":"string"},"id":{"minLength":1,"type":"string"},"lastError":{"type":"string"},"logs":{"items":{"properties":{"level":{"anyOf":[{"const":"info","type":"string"},{"const":"warn","type":"string"},{"const":"error","type":"string"}]},"message":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"required":["timestamp","level","message"],"type":"object"},"type":"array"},"maxTries":{"minimum":1,"type":"integer"},"payload":{},"progress":{"properties":{"current":{"minimum":0,"type":"integer"},"message":{"type":"string"},"step":{"type":"string"},"total":{"minimum":0,"type":"integer"}},"type":"object"},"result":{},"service":{"minLength":1,"type":"string"},"startedAt":{"format":"date-time","type":"string"},"state":{"anyOf":[{"const":"pending","type":"string"},{"const":"active","type":"string"},{"const":"retry","type":"string"},{"const":"completed","type":"string"},{"const":"failed","type":"string"},{"const":"cancelled","type":"string"},{"const":"expired","type":"string"},{"const":"dead","type":"string"},{"const":"dismissed","type":"string"}]},"tries":{"minimum":0,"type":"integer"},"type":{"minLength":1,"type":"string"},"updatedAt":{"format":"date-time","type":"string"}},"required":["id","context","service","type","state","payload","createdAt","updatedAt","tries","maxTries"],"type":"object"},"type":"array"},"limit":{"minimum":1,"type":"integer"},"nextOffset":{"minimum":0,"type":"integer"},"offset":{"minimum":0,"type":"integer"}},"required":["entries","count","offset","limit"],"type":"object"},"JobsListRequest":{"properties":{"limit":{"minimum":1,"type":"integer"},"offset":{"minimum":0,"type":"integer"},"service":{"minLength":1,"type":"string"},"since":{"format":"date-time","type":"string"},"state":{"items":{"anyOf":[{"const":"pending","type":"string"},{"const":"active","type":"string"},{"const":"retry","type":"string"},{"const":"completed","type":"string"},{"const":"failed","type":"string"},{"const":"cancelled","type":"string"},{"const":"expired","type":"string"},{"const":"dead","type":"string"},{"const":"dismissed","type":"string"}]},"type":"array"},"type":{"minLength":1,"type":"string"}},"required":["limit"],"type":"object"},"JobsListResponse":{"properties":{"count":{"minimum":0,"type":"integer"},"entries":{"items":{"properties":{"completedAt":{"format":"date-time","type":"string"},"context":{"properties":{"requestId":{"minLength":1,"type":"string"},"traceId":{"pattern":"^[0-9a-f]{32}$","type":"string"},"traceparent":{"pattern":"^[0-9a-f]{2}-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$","type":"string"},"tracestate":{"minLength":1,"type":"string"}},"required":["requestId","traceId","traceparent"],"type":"object"},"createdAt":{"format":"date-time","type":"string"},"deadline":{"format":"date-time","type":"string"},"id":{"minLength":1,"type":"string"},"lastError":{"type":"string"},"logs":{"items":{"properties":{"level":{"anyOf":[{"const":"info","type":"string"},{"const":"warn","type":"string"},{"const":"error","type":"string"}]},"message":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"required":["timestamp","level","message"],"type":"object"},"type":"array"},"maxTries":{"minimum":1,"type":"integer"},"payload":{},"progress":{"properties":{"current":{"minimum":0,"type":"integer"},"message":{"type":"string"},"step":{"type":"string"},"total":{"minimum":0,"type":"integer"}},"type":"object"},"result":{},"service":{"minLength":1,"type":"string"},"startedAt":{"format":"date-time","type":"string"},"state":{"anyOf":[{"const":"pending","type":"string"},{"const":"active","type":"string"},{"const":"retry","type":"string"},{"const":"completed","type":"string"},{"const":"failed","type":"string"},{"const":"cancelled","type":"string"},{"const":"expired","type":"string"},{"const":"dead","type":"string"},{"const":"dismissed","type":"string"}]},"tries":{"minimum":0,"type":"integer"},"type":{"minLength":1,"type":"string"},"updatedAt":{"format":"date-time","type":"string"}},"required":["id","context","service","type","state","payload","createdAt","updatedAt","tries","maxTries"],"type":"object"},"type":"array"},"limit":{"minimum":1,"type":"integer"},"nextOffset":{"minimum":0,"type":"integer"},"offset":{"minimum":0,"type":"integer"}},"required":["entries","count","offset","limit"],"type":"object"},"JobsListServicesRequest":{"properties":{"limit":{"minimum":1,"type":"integer"},"offset":{"minimum":0,"type":"integer"}},"required":["limit"],"type":"object"},"JobsListServicesResponse":{"properties":{"count":{"minimum":0,"type":"integer"},"entries":{"items":{"properties":{"healthy":{"type":"boolean"},"name":{"minLength":1,"type":"string"},"workers":{"items":{"properties":{"concurrency":{"minimum":1,"type":"integer"},"instanceId":{"minLength":1,"type":"string"},"jobType":{"minLength":1,"type":"string"},"service":{"minLength":1,"type":"string"},"timestamp":{"format":"date-time","type":"string"},"version":{"minLength":1,"type":"string"}},"required":["service","jobType","instanceId","timestamp"],"type":"object"},"type":"array"}},"required":["name","healthy","workers"],"type":"object"},"type":"array"},"limit":{"minimum":1,"type":"integer"},"nextOffset":{"minimum":0,"type":"integer"},"offset":{"minimum":0,"type":"integer"}},"required":["entries","count","offset","limit"],"type":"object"},"JobsReplayDLQRequest":{"description":"Jobs admin ids are globally addressable; callers identify jobs by id only.","properties":{"id":{"minLength":1,"type":"string"}},"required":["id"],"type":"object"},"JobsReplayDLQResponse":{"properties":{"job":{"properties":{"completedAt":{"format":"date-time","type":"string"},"context":{"properties":{"requestId":{"minLength":1,"type":"string"},"traceId":{"pattern":"^[0-9a-f]{32}$","type":"string"},"traceparent":{"pattern":"^[0-9a-f]{2}-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$","type":"string"},"tracestate":{"minLength":1,"type":"string"}},"required":["requestId","traceId","traceparent"],"type":"object"},"createdAt":{"format":"date-time","type":"string"},"deadline":{"format":"date-time","type":"string"},"id":{"minLength":1,"type":"string"},"lastError":{"type":"string"},"logs":{"items":{"properties":{"level":{"anyOf":[{"const":"info","type":"string"},{"const":"warn","type":"string"},{"const":"error","type":"string"}]},"message":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"required":["timestamp","level","message"],"type":"object"},"type":"array"},"maxTries":{"minimum":1,"type":"integer"},"payload":{},"progress":{"properties":{"current":{"minimum":0,"type":"integer"},"message":{"type":"string"},"step":{"type":"string"},"total":{"minimum":0,"type":"integer"}},"type":"object"},"result":{},"service":{"minLength":1,"type":"string"},"startedAt":{"format":"date-time","type":"string"},"state":{"anyOf":[{"const":"pending","type":"string"},{"const":"active","type":"string"},{"const":"retry","type":"string"},{"const":"completed","type":"string"},{"const":"failed","type":"string"},{"const":"cancelled","type":"string"},{"const":"expired","type":"string"},{"const":"dead","type":"string"},{"const":"dismissed","type":"string"}]},"tries":{"minimum":0,"type":"integer"},"type":{"minLength":1,"type":"string"},"updatedAt":{"format":"date-time","type":"string"}},"required":["id","context","service","type","state","payload","createdAt","updatedAt","tries","maxTries"],"type":"object"}},"required":["job"],"type":"object"},"JobsRetryRequest":{"description":"Jobs admin ids are globally addressable; callers identify jobs by id only.","properties":{"id":{"minLength":1,"type":"string"}},"required":["id"],"type":"object"},"JobsRetryResponse":{"properties":{"job":{"properties":{"completedAt":{"format":"date-time","type":"string"},"context":{"properties":{"requestId":{"minLength":1,"type":"string"},"traceId":{"pattern":"^[0-9a-f]{32}$","type":"string"},"traceparent":{"pattern":"^[0-9a-f]{2}-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$","type":"string"},"tracestate":{"minLength":1,"type":"string"}},"required":["requestId","traceId","traceparent"],"type":"object"},"createdAt":{"format":"date-time","type":"string"},"deadline":{"format":"date-time","type":"string"},"id":{"minLength":1,"type":"string"},"lastError":{"type":"string"},"logs":{"items":{"properties":{"level":{"anyOf":[{"const":"info","type":"string"},{"const":"warn","type":"string"},{"const":"error","type":"string"}]},"message":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"required":["timestamp","level","message"],"type":"object"},"type":"array"},"maxTries":{"minimum":1,"type":"integer"},"payload":{},"progress":{"properties":{"current":{"minimum":0,"type":"integer"},"message":{"type":"string"},"step":{"type":"string"},"total":{"minimum":0,"type":"integer"}},"type":"object"},"result":{},"service":{"minLength":1,"type":"string"},"startedAt":{"format":"date-time","type":"string"},"state":{"anyOf":[{"const":"pending","type":"string"},{"const":"active","type":"string"},{"const":"retry","type":"string"},{"const":"completed","type":"string"},{"const":"failed","type":"string"},{"const":"cancelled","type":"string"},{"const":"expired","type":"string"},{"const":"dead","type":"string"},{"const":"dismissed","type":"string"}]},"tries":{"minimum":0,"type":"integer"},"type":{"minLength":1,"type":"string"},"updatedAt":{"format":"date-time","type":"string"}},"required":["id","context","service","type","state","payload","createdAt","updatedAt","tries","maxTries"],"type":"object"}},"required":["job"],"type":"object"},"NotFoundErrorData":{"properties":{"context":{"patternProperties":{"^.*$":{}},"type":"object"},"id":{"minLength":1,"type":"string"},"jobId":{"minLength":1,"type":"string"},"message":{"type":"string"},"resource":{"minLength":1,"type":"string"},"traceId":{"type":"string"},"type":{"const":"NotFoundError","type":"string"}},"required":["id","type","message","resource"],"type":"object"}},"uses":{"required":{"auth":{"contract":"trellis.auth@v1","rpc":{"call":["Auth.Requests.Validate"]}},"core":{"contract":"trellis.core@v1","rpc":{"call":["Trellis.Bindings.Get","Trellis.Catalog"]}},"health":{"contract":"trellis.health@v1","events":{"publish":["Health.Heartbeat"]}}}}} as TrellisContractV1;
+
+function assertSelectedKeysExist(
+  kind: "rpc" | "operations" | "events" | "feeds",
+  keys: readonly string[] | undefined,
+  api: Record<string, unknown>,
+) {
+  if (!keys) {
+    return;
+  }
+
+  for (const key of keys) {
+    if (!Object.hasOwn(api, key)) {
+      throw new Error(`Contract '${CONTRACT_ID}' does not expose ${kind} key '${key}'`);
+    }
+  }
+}
+
+function assertValidUseSpec(spec: UseSpec<typeof API.owned>) {
+  assertSelectedKeysExist("rpc", spec.rpc?.call, API.owned.rpc);
+  assertSelectedKeysExist("operations", spec.operations?.call, API.owned.operations);
+  assertSelectedKeysExist("events", spec.events?.publish, API.owned.events);
+  assertSelectedKeysExist("events", spec.events?.subscribe, API.owned.events);
+  assertSelectedKeysExist("feeds", spec.feeds?.subscribe, API.owned.feeds);
+}
+
+export const sdk: SdkContractModule<typeof CONTRACT_ID, typeof API.owned> = {
+  CONTRACT_ID,
+  CONTRACT_DIGEST,
+  CONTRACT,
+  API,
+  use: (<const TSpec extends UseSpec<typeof API.owned>>(spec: TSpec) => {
+    assertValidUseSpec(spec);
+
+    const dependencyUse = {
+      contract: CONTRACT_ID,
+      ...(spec.rpc?.call ? { rpc: { call: [...spec.rpc.call] } } : {}),
+      ...(spec.operations?.call ? { operations: { call: [...spec.operations.call] } } : {}),
+      ...((spec.events?.publish || spec.events?.subscribe)
+        ? {
+          events: {
+            ...(spec.events.publish ? { publish: [...spec.events.publish] } : {}),
+            ...(spec.events.subscribe ? { subscribe: [...spec.events.subscribe] } : {}),
+          },
+        }
+        : {}),
+      ...(spec.feeds?.subscribe ? { feeds: { subscribe: [...spec.feeds.subscribe] } } : {}),
+    };
+
+    Object.defineProperty(dependencyUse, CONTRACT_MODULE_METADATA, {
+      value: sdk,
+      enumerable: false,
+    });
+
+    return dependencyUse as ContractDependencyUse<typeof CONTRACT_ID, typeof API.owned, TSpec>;
+  }),
+};
+
+export const use = sdk.use;

package/src/sdk/_generated/jobs/mod.ts

@@ -0,0 +1,6 @@
+export { API, OWNED_API } from "./api.js";
+export type { Api, ApiViews, OwnedApi } from "./api.js";
+export * from "./types.js";
+export * from "./schemas.js";
+export type { Client, HandlerClient, TrellisJobsClient, TrellisJobsState } from "./client.js";
+export { CONTRACT, CONTRACT_DIGEST, CONTRACT_ID, use, sdk } from "./contract.js";

package/src/sdk/_generated/jobs/owned_api.ts

@@ -0,0 +1,126 @@
+// Generated from ./generated/contracts/manifests/trellis.jobs@v1.json
+import type { TrellisAPI } from "@qlever-llc/trellis/contracts";
+import { schema } from "@qlever-llc/trellis/contracts";
+import * as Types from "./types.js";
+import { EmptySchema, JobsCancelRequestSchema, JobsCancelResponseSchema, JobsDismissDLQRequestSchema, JobsDismissDLQResponseSchema, JobsGetRequestSchema, JobsGetResponseSchema, JobsHealthResponseSchema, JobsListDLQRequestSchema, JobsListDLQResponseSchema, JobsListRequestSchema, JobsListResponseSchema, JobsListServicesRequestSchema, JobsListServicesResponseSchema, JobsReplayDLQRequestSchema, JobsReplayDLQResponseSchema, JobsRetryRequestSchema, JobsRetryResponseSchema, NotFoundErrorDataSchema } from "./schemas.js";
+
+export const OWNED_API = {
+  rpc: {
+    "Jobs.Cancel": {
+      subject: "rpc.v1.Jobs.Cancel",
+      input: schema<Types.JobsCancelInput>(JobsCancelRequestSchema),
+      output: schema<Types.JobsCancelOutput>(JobsCancelResponseSchema),
+      callerCapabilities: ["trellis.jobs::admin.mutate"],
+      errors: ["UnexpectedError","ValidationError","NotFoundError"] as const,
+      declaredErrorTypes: ["UnexpectedError","ValidationError","NotFoundError"] as const,
+      runtimeErrors: [
+        {
+          type: "NotFoundError",
+          schema: schema<Types.NotFoundErrorData>(NotFoundErrorDataSchema),
+          fromSerializable: Types.NotFoundError.fromSerializable,
+        },
+      ] as const,
+    },
+    "Jobs.DismissDLQ": {
+      subject: "rpc.v1.Jobs.DismissDLQ",
+      input: schema<Types.JobsDismissDLQInput>(JobsDismissDLQRequestSchema),
+      output: schema<Types.JobsDismissDLQOutput>(JobsDismissDLQResponseSchema),
+      callerCapabilities: ["trellis.jobs::admin.mutate"],
+      errors: ["UnexpectedError","ValidationError","NotFoundError"] as const,
+      declaredErrorTypes: ["UnexpectedError","ValidationError","NotFoundError"] as const,
+      runtimeErrors: [
+        {
+          type: "NotFoundError",
+          schema: schema<Types.NotFoundErrorData>(NotFoundErrorDataSchema),
+          fromSerializable: Types.NotFoundError.fromSerializable,
+        },
+      ] as const,
+    },
+    "Jobs.Get": {
+      subject: "rpc.v1.Jobs.Get",
+      input: schema<Types.JobsGetInput>(JobsGetRequestSchema),
+      output: schema<Types.JobsGetOutput>(JobsGetResponseSchema),
+      callerCapabilities: ["trellis.jobs::admin.read"],
+      errors: ["UnexpectedError","ValidationError","NotFoundError"] as const,
+      declaredErrorTypes: ["UnexpectedError","ValidationError","NotFoundError"] as const,
+      runtimeErrors: [
+        {
+          type: "NotFoundError",
+          schema: schema<Types.NotFoundErrorData>(NotFoundErrorDataSchema),
+          fromSerializable: Types.NotFoundError.fromSerializable,
+        },
+      ] as const,
+    },
+    "Jobs.Health": {
+      subject: "rpc.v1.Jobs.Health",
+      input: schema<Types.JobsHealthInput>(EmptySchema),
+      output: schema<Types.JobsHealthOutput>(JobsHealthResponseSchema),
+      callerCapabilities: ["trellis.jobs::admin.read"],
+      errors: ["UnexpectedError"] as const,
+      declaredErrorTypes: ["UnexpectedError"] as const,
+    },
+    "Jobs.List": {
+      subject: "rpc.v1.Jobs.List",
+      input: schema<Types.JobsListInput>(JobsListRequestSchema),
+      output: schema<Types.JobsListOutput>(JobsListResponseSchema),
+      callerCapabilities: ["trellis.jobs::admin.read"],
+      errors: ["UnexpectedError","ValidationError"] as const,
+      declaredErrorTypes: ["UnexpectedError","ValidationError"] as const,
+    },
+    "Jobs.ListDLQ": {
+      subject: "rpc.v1.Jobs.ListDLQ",
+      input: schema<Types.JobsListDLQInput>(JobsListDLQRequestSchema),
+      output: schema<Types.JobsListDLQOutput>(JobsListDLQResponseSchema),
+      callerCapabilities: ["trellis.jobs::admin.read"],
+      errors: ["UnexpectedError","ValidationError"] as const,
+      declaredErrorTypes: ["UnexpectedError","ValidationError"] as const,
+    },
+    "Jobs.ListServices": {
+      subject: "rpc.v1.Jobs.ListServices",
+      input: schema<Types.JobsListServicesInput>(JobsListServicesRequestSchema),
+      output: schema<Types.JobsListServicesOutput>(JobsListServicesResponseSchema),
+      callerCapabilities: ["trellis.jobs::admin.read"],
+      errors: ["UnexpectedError","ValidationError"] as const,
+      declaredErrorTypes: ["UnexpectedError","ValidationError"] as const,
+    },
+    "Jobs.ReplayDLQ": {
+      subject: "rpc.v1.Jobs.ReplayDLQ",
+      input: schema<Types.JobsReplayDLQInput>(JobsReplayDLQRequestSchema),
+      output: schema<Types.JobsReplayDLQOutput>(JobsReplayDLQResponseSchema),
+      callerCapabilities: ["trellis.jobs::admin.mutate"],
+      errors: ["UnexpectedError","ValidationError","NotFoundError"] as const,
+      declaredErrorTypes: ["UnexpectedError","ValidationError","NotFoundError"] as const,
+      runtimeErrors: [
+        {
+          type: "NotFoundError",
+          schema: schema<Types.NotFoundErrorData>(NotFoundErrorDataSchema),
+          fromSerializable: Types.NotFoundError.fromSerializable,
+        },
+      ] as const,
+    },
+    "Jobs.Retry": {
+      subject: "rpc.v1.Jobs.Retry",
+      input: schema<Types.JobsRetryInput>(JobsRetryRequestSchema),
+      output: schema<Types.JobsRetryOutput>(JobsRetryResponseSchema),
+      callerCapabilities: ["trellis.jobs::admin.mutate"],
+      errors: ["UnexpectedError","ValidationError","NotFoundError"] as const,
+      declaredErrorTypes: ["UnexpectedError","ValidationError","NotFoundError"] as const,
+      runtimeErrors: [
+        {
+          type: "NotFoundError",
+          schema: schema<Types.NotFoundErrorData>(NotFoundErrorDataSchema),
+          fromSerializable: Types.NotFoundError.fromSerializable,
+        },
+      ] as const,
+    },
+  },
+  operations: {
+  },
+  events: {
+  },
+  feeds: {
+  },
+  subjects: {
+  },
+} satisfies TrellisAPI;
+

package/src/sdk/_generated/jobs/schemas.ts

@@ -0,0 +1,39 @@
+// Generated from ./generated/contracts/manifests/trellis.jobs@v1.json
+export const EmptySchema = {"properties":{},"type":"object"} as const;
+
+export const JobsCancelRequestSchema = {"description":"Jobs admin ids are globally addressable; callers identify jobs by id only.","properties":{"id":{"minLength":1,"type":"string"}},"required":["id"],"type":"object"} as const;
+
+export const JobsCancelResponseSchema = {"properties":{"job":{"properties":{"completedAt":{"format":"date-time","type":"string"},"context":{"properties":{"requestId":{"minLength":1,"type":"string"},"traceId":{"pattern":"^[0-9a-f]{32}$","type":"string"},"traceparent":{"pattern":"^[0-9a-f]{2}-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$","type":"string"},"tracestate":{"minLength":1,"type":"string"}},"required":["requestId","traceId","traceparent"],"type":"object"},"createdAt":{"format":"date-time","type":"string"},"deadline":{"format":"date-time","type":"string"},"id":{"minLength":1,"type":"string"},"lastError":{"type":"string"},"logs":{"items":{"properties":{"level":{"anyOf":[{"const":"info","type":"string"},{"const":"warn","type":"string"},{"const":"error","type":"string"}]},"message":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"required":["timestamp","level","message"],"type":"object"},"type":"array"},"maxTries":{"minimum":1,"type":"integer"},"payload":{},"progress":{"properties":{"current":{"minimum":0,"type":"integer"},"message":{"type":"string"},"step":{"type":"string"},"total":{"minimum":0,"type":"integer"}},"type":"object"},"result":{},"service":{"minLength":1,"type":"string"},"startedAt":{"format":"date-time","type":"string"},"state":{"anyOf":[{"const":"pending","type":"string"},{"const":"active","type":"string"},{"const":"retry","type":"string"},{"const":"completed","type":"string"},{"const":"failed","type":"string"},{"const":"cancelled","type":"string"},{"const":"expired","type":"string"},{"const":"dead","type":"string"},{"const":"dismissed","type":"string"}]},"tries":{"minimum":0,"type":"integer"},"type":{"minLength":1,"type":"string"},"updatedAt":{"format":"date-time","type":"string"}},"required":["id","context","service","type","state","payload","createdAt","updatedAt","tries","maxTries"],"type":"object"}},"required":["job"],"type":"object"} as const;
+
+export const JobsDismissDLQRequestSchema = {"description":"Jobs admin ids are globally addressable; callers identify jobs by id only.","properties":{"id":{"minLength":1,"type":"string"}},"required":["id"],"type":"object"} as const;
+
+export const JobsDismissDLQResponseSchema = {"properties":{"job":{"properties":{"completedAt":{"format":"date-time","type":"string"},"context":{"properties":{"requestId":{"minLength":1,"type":"string"},"traceId":{"pattern":"^[0-9a-f]{32}$","type":"string"},"traceparent":{"pattern":"^[0-9a-f]{2}-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$","type":"string"},"tracestate":{"minLength":1,"type":"string"}},"required":["requestId","traceId","traceparent"],"type":"object"},"createdAt":{"format":"date-time","type":"string"},"deadline":{"format":"date-time","type":"string"},"id":{"minLength":1,"type":"string"},"lastError":{"type":"string"},"logs":{"items":{"properties":{"level":{"anyOf":[{"const":"info","type":"string"},{"const":"warn","type":"string"},{"const":"error","type":"string"}]},"message":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"required":["timestamp","level","message"],"type":"object"},"type":"array"},"maxTries":{"minimum":1,"type":"integer"},"payload":{},"progress":{"properties":{"current":{"minimum":0,"type":"integer"},"message":{"type":"string"},"step":{"type":"string"},"total":{"minimum":0,"type":"integer"}},"type":"object"},"result":{},"service":{"minLength":1,"type":"string"},"startedAt":{"format":"date-time","type":"string"},"state":{"anyOf":[{"const":"pending","type":"string"},{"const":"active","type":"string"},{"const":"retry","type":"string"},{"const":"completed","type":"string"},{"const":"failed","type":"string"},{"const":"cancelled","type":"string"},{"const":"expired","type":"string"},{"const":"dead","type":"string"},{"const":"dismissed","type":"string"}]},"tries":{"minimum":0,"type":"integer"},"type":{"minLength":1,"type":"string"},"updatedAt":{"format":"date-time","type":"string"}},"required":["id","context","service","type","state","payload","createdAt","updatedAt","tries","maxTries"],"type":"object"}},"required":["job"],"type":"object"} as const;
+
+export const JobsGetRequestSchema = {"description":"Jobs admin ids are globally addressable; callers identify jobs by id only.","properties":{"id":{"minLength":1,"type":"string"}},"required":["id"],"type":"object"} as const;
+
+export const JobsGetResponseSchema = {"properties":{"job":{"properties":{"completedAt":{"format":"date-time","type":"string"},"context":{"properties":{"requestId":{"minLength":1,"type":"string"},"traceId":{"pattern":"^[0-9a-f]{32}$","type":"string"},"traceparent":{"pattern":"^[0-9a-f]{2}-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$","type":"string"},"tracestate":{"minLength":1,"type":"string"}},"required":["requestId","traceId","traceparent"],"type":"object"},"createdAt":{"format":"date-time","type":"string"},"deadline":{"format":"date-time","type":"string"},"id":{"minLength":1,"type":"string"},"lastError":{"type":"string"},"logs":{"items":{"properties":{"level":{"anyOf":[{"const":"info","type":"string"},{"const":"warn","type":"string"},{"const":"error","type":"string"}]},"message":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"required":["timestamp","level","message"],"type":"object"},"type":"array"},"maxTries":{"minimum":1,"type":"integer"},"payload":{},"progress":{"properties":{"current":{"minimum":0,"type":"integer"},"message":{"type":"string"},"step":{"type":"string"},"total":{"minimum":0,"type":"integer"}},"type":"object"},"result":{},"service":{"minLength":1,"type":"string"},"startedAt":{"format":"date-time","type":"string"},"state":{"anyOf":[{"const":"pending","type":"string"},{"const":"active","type":"string"},{"const":"retry","type":"string"},{"const":"completed","type":"string"},{"const":"failed","type":"string"},{"const":"cancelled","type":"string"},{"const":"expired","type":"string"},{"const":"dead","type":"string"},{"const":"dismissed","type":"string"}]},"tries":{"minimum":0,"type":"integer"},"type":{"minLength":1,"type":"string"},"updatedAt":{"format":"date-time","type":"string"}},"required":["id","context","service","type","state","payload","createdAt","updatedAt","tries","maxTries"],"type":"object"}},"required":["job"],"type":"object"} as const;
+
+export const JobsHealthResponseSchema = {"properties":{"checks":{"items":{"patternProperties":{"^.*$":{}},"type":"object"},"type":"array"},"service":{"minLength":1,"type":"string"},"status":{},"timestamp":{"format":"date-time","type":"string"}},"required":["service","status","timestamp","checks"],"type":"object"} as const;
+
+export const JobsListDLQRequestSchema = {"properties":{"limit":{"minimum":1,"type":"integer"},"offset":{"minimum":0,"type":"integer"},"service":{"minLength":1,"type":"string"},"since":{"format":"date-time","type":"string"},"type":{"minLength":1,"type":"string"}},"required":["limit"],"type":"object"} as const;
+
+export const JobsListDLQResponseSchema = {"properties":{"count":{"minimum":0,"type":"integer"},"entries":{"items":{"properties":{"completedAt":{"format":"date-time","type":"string"},"context":{"properties":{"requestId":{"minLength":1,"type":"string"},"traceId":{"pattern":"^[0-9a-f]{32}$","type":"string"},"traceparent":{"pattern":"^[0-9a-f]{2}-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$","type":"string"},"tracestate":{"minLength":1,"type":"string"}},"required":["requestId","traceId","traceparent"],"type":"object"},"createdAt":{"format":"date-time","type":"string"},"deadline":{"format":"date-time","type":"string"},"id":{"minLength":1,"type":"string"},"lastError":{"type":"string"},"logs":{"items":{"properties":{"level":{"anyOf":[{"const":"info","type":"string"},{"const":"warn","type":"string"},{"const":"error","type":"string"}]},"message":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"required":["timestamp","level","message"],"type":"object"},"type":"array"},"maxTries":{"minimum":1,"type":"integer"},"payload":{},"progress":{"properties":{"current":{"minimum":0,"type":"integer"},"message":{"type":"string"},"step":{"type":"string"},"total":{"minimum":0,"type":"integer"}},"type":"object"},"result":{},"service":{"minLength":1,"type":"string"},"startedAt":{"format":"date-time","type":"string"},"state":{"anyOf":[{"const":"pending","type":"string"},{"const":"active","type":"string"},{"const":"retry","type":"string"},{"const":"completed","type":"string"},{"const":"failed","type":"string"},{"const":"cancelled","type":"string"},{"const":"expired","type":"string"},{"const":"dead","type":"string"},{"const":"dismissed","type":"string"}]},"tries":{"minimum":0,"type":"integer"},"type":{"minLength":1,"type":"string"},"updatedAt":{"format":"date-time","type":"string"}},"required":["id","context","service","type","state","payload","createdAt","updatedAt","tries","maxTries"],"type":"object"},"type":"array"},"limit":{"minimum":1,"type":"integer"},"nextOffset":{"minimum":0,"type":"integer"},"offset":{"minimum":0,"type":"integer"}},"required":["entries","count","offset","limit"],"type":"object"} as const;
+
+export const JobsListRequestSchema = {"properties":{"limit":{"minimum":1,"type":"integer"},"offset":{"minimum":0,"type":"integer"},"service":{"minLength":1,"type":"string"},"since":{"format":"date-time","type":"string"},"state":{"items":{"anyOf":[{"const":"pending","type":"string"},{"const":"active","type":"string"},{"const":"retry","type":"string"},{"const":"completed","type":"string"},{"const":"failed","type":"string"},{"const":"cancelled","type":"string"},{"const":"expired","type":"string"},{"const":"dead","type":"string"},{"const":"dismissed","type":"string"}]},"type":"array"},"type":{"minLength":1,"type":"string"}},"required":["limit"],"type":"object"} as const;
+
+export const JobsListResponseSchema = {"properties":{"count":{"minimum":0,"type":"integer"},"entries":{"items":{"properties":{"completedAt":{"format":"date-time","type":"string"},"context":{"properties":{"requestId":{"minLength":1,"type":"string"},"traceId":{"pattern":"^[0-9a-f]{32}$","type":"string"},"traceparent":{"pattern":"^[0-9a-f]{2}-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$","type":"string"},"tracestate":{"minLength":1,"type":"string"}},"required":["requestId","traceId","traceparent"],"type":"object"},"createdAt":{"format":"date-time","type":"string"},"deadline":{"format":"date-time","type":"string"},"id":{"minLength":1,"type":"string"},"lastError":{"type":"string"},"logs":{"items":{"properties":{"level":{"anyOf":[{"const":"info","type":"string"},{"const":"warn","type":"string"},{"const":"error","type":"string"}]},"message":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"required":["timestamp","level","message"],"type":"object"},"type":"array"},"maxTries":{"minimum":1,"type":"integer"},"payload":{},"progress":{"properties":{"current":{"minimum":0,"type":"integer"},"message":{"type":"string"},"step":{"type":"string"},"total":{"minimum":0,"type":"integer"}},"type":"object"},"result":{},"service":{"minLength":1,"type":"string"},"startedAt":{"format":"date-time","type":"string"},"state":{"anyOf":[{"const":"pending","type":"string"},{"const":"active","type":"string"},{"const":"retry","type":"string"},{"const":"completed","type":"string"},{"const":"failed","type":"string"},{"const":"cancelled","type":"string"},{"const":"expired","type":"string"},{"const":"dead","type":"string"},{"const":"dismissed","type":"string"}]},"tries":{"minimum":0,"type":"integer"},"type":{"minLength":1,"type":"string"},"updatedAt":{"format":"date-time","type":"string"}},"required":["id","context","service","type","state","payload","createdAt","updatedAt","tries","maxTries"],"type":"object"},"type":"array"},"limit":{"minimum":1,"type":"integer"},"nextOffset":{"minimum":0,"type":"integer"},"offset":{"minimum":0,"type":"integer"}},"required":["entries","count","offset","limit"],"type":"object"} as const;
+
+export const JobsListServicesRequestSchema = {"properties":{"limit":{"minimum":1,"type":"integer"},"offset":{"minimum":0,"type":"integer"}},"required":["limit"],"type":"object"} as const;
+
+export const JobsListServicesResponseSchema = {"properties":{"count":{"minimum":0,"type":"integer"},"entries":{"items":{"properties":{"healthy":{"type":"boolean"},"name":{"minLength":1,"type":"string"},"workers":{"items":{"properties":{"concurrency":{"minimum":1,"type":"integer"},"instanceId":{"minLength":1,"type":"string"},"jobType":{"minLength":1,"type":"string"},"service":{"minLength":1,"type":"string"},"timestamp":{"format":"date-time","type":"string"},"version":{"minLength":1,"type":"string"}},"required":["service","jobType","instanceId","timestamp"],"type":"object"},"type":"array"}},"required":["name","healthy","workers"],"type":"object"},"type":"array"},"limit":{"minimum":1,"type":"integer"},"nextOffset":{"minimum":0,"type":"integer"},"offset":{"minimum":0,"type":"integer"}},"required":["entries","count","offset","limit"],"type":"object"} as const;
+
+export const JobsReplayDLQRequestSchema = {"description":"Jobs admin ids are globally addressable; callers identify jobs by id only.","properties":{"id":{"minLength":1,"type":"string"}},"required":["id"],"type":"object"} as const;
+
+export const JobsReplayDLQResponseSchema = {"properties":{"job":{"properties":{"completedAt":{"format":"date-time","type":"string"},"context":{"properties":{"requestId":{"minLength":1,"type":"string"},"traceId":{"pattern":"^[0-9a-f]{32}$","type":"string"},"traceparent":{"pattern":"^[0-9a-f]{2}-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$","type":"string"},"tracestate":{"minLength":1,"type":"string"}},"required":["requestId","traceId","traceparent"],"type":"object"},"createdAt":{"format":"date-time","type":"string"},"deadline":{"format":"date-time","type":"string"},"id":{"minLength":1,"type":"string"},"lastError":{"type":"string"},"logs":{"items":{"properties":{"level":{"anyOf":[{"const":"info","type":"string"},{"const":"warn","type":"string"},{"const":"error","type":"string"}]},"message":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"required":["timestamp","level","message"],"type":"object"},"type":"array"},"maxTries":{"minimum":1,"type":"integer"},"payload":{},"progress":{"properties":{"current":{"minimum":0,"type":"integer"},"message":{"type":"string"},"step":{"type":"string"},"total":{"minimum":0,"type":"integer"}},"type":"object"},"result":{},"service":{"minLength":1,"type":"string"},"startedAt":{"format":"date-time","type":"string"},"state":{"anyOf":[{"const":"pending","type":"string"},{"const":"active","type":"string"},{"const":"retry","type":"string"},{"const":"completed","type":"string"},{"const":"failed","type":"string"},{"const":"cancelled","type":"string"},{"const":"expired","type":"string"},{"const":"dead","type":"string"},{"const":"dismissed","type":"string"}]},"tries":{"minimum":0,"type":"integer"},"type":{"minLength":1,"type":"string"},"updatedAt":{"format":"date-time","type":"string"}},"required":["id","context","service","type","state","payload","createdAt","updatedAt","tries","maxTries"],"type":"object"}},"required":["job"],"type":"object"} as const;
+
+export const JobsRetryRequestSchema = {"description":"Jobs admin ids are globally addressable; callers identify jobs by id only.","properties":{"id":{"minLength":1,"type":"string"}},"required":["id"],"type":"object"} as const;
+
+export const JobsRetryResponseSchema = {"properties":{"job":{"properties":{"completedAt":{"format":"date-time","type":"string"},"context":{"properties":{"requestId":{"minLength":1,"type":"string"},"traceId":{"pattern":"^[0-9a-f]{32}$","type":"string"},"traceparent":{"pattern":"^[0-9a-f]{2}-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2}$","type":"string"},"tracestate":{"minLength":1,"type":"string"}},"required":["requestId","traceId","traceparent"],"type":"object"},"createdAt":{"format":"date-time","type":"string"},"deadline":{"format":"date-time","type":"string"},"id":{"minLength":1,"type":"string"},"lastError":{"type":"string"},"logs":{"items":{"properties":{"level":{"anyOf":[{"const":"info","type":"string"},{"const":"warn","type":"string"},{"const":"error","type":"string"}]},"message":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"required":["timestamp","level","message"],"type":"object"},"type":"array"},"maxTries":{"minimum":1,"type":"integer"},"payload":{},"progress":{"properties":{"current":{"minimum":0,"type":"integer"},"message":{"type":"string"},"step":{"type":"string"},"total":{"minimum":0,"type":"integer"}},"type":"object"},"result":{},"service":{"minLength":1,"type":"string"},"startedAt":{"format":"date-time","type":"string"},"state":{"anyOf":[{"const":"pending","type":"string"},{"const":"active","type":"string"},{"const":"retry","type":"string"},{"const":"completed","type":"string"},{"const":"failed","type":"string"},{"const":"cancelled","type":"string"},{"const":"expired","type":"string"},{"const":"dead","type":"string"},{"const":"dismissed","type":"string"}]},"tries":{"minimum":0,"type":"integer"},"type":{"minLength":1,"type":"string"},"updatedAt":{"format":"date-time","type":"string"}},"required":["id","context","service","type","state","payload","createdAt","updatedAt","tries","maxTries"],"type":"object"}},"required":["job"],"type":"object"} as const;
+
+export const NotFoundErrorDataSchema = {"properties":{"context":{"patternProperties":{"^.*$":{}},"type":"object"},"id":{"minLength":1,"type":"string"},"jobId":{"minLength":1,"type":"string"},"message":{"type":"string"},"resource":{"minLength":1,"type":"string"},"traceId":{"type":"string"},"type":{"const":"NotFoundError","type":"string"}},"required":["id","type","message","resource"],"type":"object"} as const;
+

package/src/sdk/_generated/jobs/types.ts

@@ -0,0 +1,92 @@
+// Generated from ./generated/contracts/manifests/trellis.jobs@v1.json
+import type { RpcHandlerFn } from "@qlever-llc/trellis";
+import type { API } from "./api.js";
+
+import { TrellisError, type SerializableErrorData } from "@qlever-llc/trellis";
+
+import { NotFoundErrorDataSchema } from "./schemas.js";
+
+export const CONTRACT_ID = "trellis.jobs@v1" as const;
+export const CONTRACT_DIGEST = "jSB8nKGOQqIxdFDdUqO-gOTt3Dijg--SOXJtJ1ChpoY" as const;
+
+export type JobsCancelInput = { id: string; };
+export type JobsCancelOutput = { job: { completedAt?: string; context: { requestId: string; traceId: string; traceparent: string; tracestate?: string; }; createdAt: string; deadline?: string; id: string; lastError?: string; logs?: Array<{ level: ("info" | "warn" | "error"); message: string; timestamp: string; }>; maxTries: number; payload: unknown; progress?: { current?: number; message?: string; step?: string; total?: number; }; result?: unknown; service: string; startedAt?: string; state: ("pending" | "active" | "retry" | "completed" | "failed" | "cancelled" | "expired" | "dead" | "dismissed"); tries: number; type: string; updatedAt: string; }; };
+
+export type JobsDismissDLQInput = { id: string; };
+export type JobsDismissDLQOutput = { job: { completedAt?: string; context: { requestId: string; traceId: string; traceparent: string; tracestate?: string; }; createdAt: string; deadline?: string; id: string; lastError?: string; logs?: Array<{ level: ("info" | "warn" | "error"); message: string; timestamp: string; }>; maxTries: number; payload: unknown; progress?: { current?: number; message?: string; step?: string; total?: number; }; result?: unknown; service: string; startedAt?: string; state: ("pending" | "active" | "retry" | "completed" | "failed" | "cancelled" | "expired" | "dead" | "dismissed"); tries: number; type: string; updatedAt: string; }; };
+
+export type JobsGetInput = { id: string; };
+export type JobsGetOutput = { job: { completedAt?: string; context: { requestId: string; traceId: string; traceparent: string; tracestate?: string; }; createdAt: string; deadline?: string; id: string; lastError?: string; logs?: Array<{ level: ("info" | "warn" | "error"); message: string; timestamp: string; }>; maxTries: number; payload: unknown; progress?: { current?: number; message?: string; step?: string; total?: number; }; result?: unknown; service: string; startedAt?: string; state: ("pending" | "active" | "retry" | "completed" | "failed" | "cancelled" | "expired" | "dead" | "dismissed"); tries: number; type: string; updatedAt: string; }; };
+
+export type JobsHealthInput = {  };
+export type JobsHealthOutput = { checks: Array<{ [k: string]: unknown; }>; service: string; status: unknown; timestamp: string; };
+
+export type JobsListInput = { limit: number; offset?: number; service?: string; since?: string; state?: Array<("pending" | "active" | "retry" | "completed" | "failed" | "cancelled" | "expired" | "dead" | "dismissed")>; type?: string; };
+export type JobsListOutput = { count: number; entries: Array<{ completedAt?: string; context: { requestId: string; traceId: string; traceparent: string; tracestate?: string; }; createdAt: string; deadline?: string; id: string; lastError?: string; logs?: Array<{ level: ("info" | "warn" | "error"); message: string; timestamp: string; }>; maxTries: number; payload: unknown; progress?: { current?: number; message?: string; step?: string; total?: number; }; result?: unknown; service: string; startedAt?: string; state: ("pending" | "active" | "retry" | "completed" | "failed" | "cancelled" | "expired" | "dead" | "dismissed"); tries: number; type: string; updatedAt: string; }>; limit: number; nextOffset?: number; offset: number; };
+
+export type JobsListDLQInput = { limit: number; offset?: number; service?: string; since?: string; type?: string; };
+export type JobsListDLQOutput = { count: number; entries: Array<{ completedAt?: string; context: { requestId: string; traceId: string; traceparent: string; tracestate?: string; }; createdAt: string; deadline?: string; id: string; lastError?: string; logs?: Array<{ level: ("info" | "warn" | "error"); message: string; timestamp: string; }>; maxTries: number; payload: unknown; progress?: { current?: number; message?: string; step?: string; total?: number; }; result?: unknown; service: string; startedAt?: string; state: ("pending" | "active" | "retry" | "completed" | "failed" | "cancelled" | "expired" | "dead" | "dismissed"); tries: number; type: string; updatedAt: string; }>; limit: number; nextOffset?: number; offset: number; };
+
+export type JobsListServicesInput = { limit: number; offset?: number; };
+export type JobsListServicesOutput = { count: number; entries: Array<{ healthy: boolean; name: string; workers: Array<{ concurrency?: number; instanceId: string; jobType: string; service: string; timestamp: string; version?: string; }>; }>; limit: number; nextOffset?: number; offset: number; };
+
+export type JobsReplayDLQInput = { id: string; };
+export type JobsReplayDLQOutput = { job: { completedAt?: string; context: { requestId: string; traceId: string; traceparent: string; tracestate?: string; }; createdAt: string; deadline?: string; id: string; lastError?: string; logs?: Array<{ level: ("info" | "warn" | "error"); message: string; timestamp: string; }>; maxTries: number; payload: unknown; progress?: { current?: number; message?: string; step?: string; total?: number; }; result?: unknown; service: string; startedAt?: string; state: ("pending" | "active" | "retry" | "completed" | "failed" | "cancelled" | "expired" | "dead" | "dismissed"); tries: number; type: string; updatedAt: string; }; };
+
+export type JobsRetryInput = { id: string; };
+export type JobsRetryOutput = { job: { completedAt?: string; context: { requestId: string; traceId: string; traceparent: string; tracestate?: string; }; createdAt: string; deadline?: string; id: string; lastError?: string; logs?: Array<{ level: ("info" | "warn" | "error"); message: string; timestamp: string; }>; maxTries: number; payload: unknown; progress?: { current?: number; message?: string; step?: string; total?: number; }; result?: unknown; service: string; startedAt?: string; state: ("pending" | "active" | "retry" | "completed" | "failed" | "cancelled" | "expired" | "dead" | "dismissed"); tries: number; type: string; updatedAt: string; }; };
+
+export type NotFoundErrorData = { context?: { [k: string]: unknown; }; id: string; jobId?: string; message: string; resource: string; traceId?: string; type: "NotFoundError"; };
+export class NotFoundError extends TrellisError<NotFoundErrorData> {
+  static readonly schema = NotFoundErrorDataSchema;
+  override readonly name = "NotFoundError" as const;
+  readonly data: NotFoundErrorData;
+
+  constructor(data: NotFoundErrorData) {
+    super(data.message, {
+      id: data.id,
+      ...(data.context !== undefined ? { context: data.context } : {}),
+    });
+    this.data = data;
+  }
+
+  static fromSerializable(data: NotFoundErrorData): NotFoundError {
+    return new NotFoundError(data);
+  }
+
+  override toSerializable(): NotFoundErrorData {
+    return this.data;
+  }
+}
+
+export interface RpcMap {
+  "Jobs.Cancel": { input: JobsCancelInput; output: JobsCancelOutput; };
+  "Jobs.DismissDLQ": { input: JobsDismissDLQInput; output: JobsDismissDLQOutput; };
+  "Jobs.Get": { input: JobsGetInput; output: JobsGetOutput; };
+  "Jobs.Health": { input: JobsHealthInput; output: JobsHealthOutput; };
+  "Jobs.List": { input: JobsListInput; output: JobsListOutput; };
+  "Jobs.ListDLQ": { input: JobsListDLQInput; output: JobsListDLQOutput; };
+  "Jobs.ListServices": { input: JobsListServicesInput; output: JobsListServicesOutput; };
+  "Jobs.ReplayDLQ": { input: JobsReplayDLQInput; output: JobsReplayDLQOutput; };
+  "Jobs.Retry": { input: JobsRetryInput; output: JobsRetryOutput; };
+}
+
+export type JobsCancelHandler = RpcHandlerFn<typeof API.owned, "Jobs.Cancel">;
+export type JobsDismissDLQHandler = RpcHandlerFn<typeof API.owned, "Jobs.DismissDLQ">;
+export type JobsGetHandler = RpcHandlerFn<typeof API.owned, "Jobs.Get">;
+export type JobsHealthHandler = RpcHandlerFn<typeof API.owned, "Jobs.Health">;
+export type JobsListHandler = RpcHandlerFn<typeof API.owned, "Jobs.List">;
+export type JobsListDLQHandler = RpcHandlerFn<typeof API.owned, "Jobs.ListDLQ">;
+export type JobsListServicesHandler = RpcHandlerFn<typeof API.owned, "Jobs.ListServices">;
+export type JobsReplayDLQHandler = RpcHandlerFn<typeof API.owned, "Jobs.ReplayDLQ">;
+export type JobsRetryHandler = RpcHandlerFn<typeof API.owned, "Jobs.Retry">;
+
+export interface EventMap {
+}
+
+export interface FeedMap {
+}
+
+export interface SubjectMap {
+}
+