@relkit/runtime-hono 0.5.4 → 0.5.5

package/dist/jobs/projection.js

@@ -1,6 +1,12 @@
 import { projectRunPage, projectRunSnapshot } from "@relkit/jobs";
-import { jobError } from "./support.js";
 import { assertSafeRun, assertSafeWatchFrame, safeAvailability } from "./projection-validation.js";
+import { jobError } from "./support.js";
+/** Validate and redact a run according to its public field policy.
+ * @param run - Persisted run being inspected.
+ * @param policy - Allowed public fields and operations.
+ * @param descriptor - Job descriptor supplying canonical schemas and declared errors.
+ * @returns The public run snapshot with only selected fields.
+ */
 export function projectSnapshot(run, policy, descriptor) {
     try {
         assertSafeRun(run);
@@ -10,6 +16,12 @@ export function projectSnapshot(run, policy, descriptor) {
         throw jobError("RELKIT_JOB_ACCESS_DENIED", "Job run was not found.");
     }
 }
+/** Validate page metadata and apply the job's field projection.
+ * @param page - Provider page to validate or project.
+ * @param policy - Allowed public fields and operations.
+ * @param descriptor - Job descriptor supplying canonical schemas and declared errors.
+ * @returns The public page with safe service availability metadata.
+ */
 export function projectPage(page, policy, descriptor) {
     if (!Array.isArray(page.items) ||
         !Array.isArray(page.availability) ||
@@ -18,6 +30,12 @@ export function projectPage(page, policy, descriptor) {
     }
     return projectRunPage({ ...page, availability: safeAvailability(page.availability) }, policy.fields, projectionOptions(descriptor));
 }
+/** Validate a watch frame and project its embedded run.
+ * @param frame - Native frame to validate or encode.
+ * @param policy - Allowed public fields and operations.
+ * @param descriptor - Job descriptor supplying canonical schemas and declared errors.
+ * @returns A frozen frame containing only supported metadata and public run fields.
+ */
 export function projectWatchFrame(frame, policy, descriptor) {
     assertSafeWatchFrame(frame);
     const run = projectSnapshot(frame.run, policy, descriptor);
@@ -52,6 +70,12 @@ export function projectWatchFrame(frame, policy, descriptor) {
         ...(frame.cursor === undefined ? {} : { cursor: frame.cursor }),
     });
 }
+/** Project the optional run in a cancellation receipt.
+ * @param receipt - Provider cancellation or retry receipt.
+ * @param policy - Allowed public fields and operations.
+ * @param descriptor - Job descriptor supplying canonical schemas and declared errors.
+ * @returns A frozen receipt with any run restricted to public fields.
+ */
 export function projectCancellation(receipt, policy, descriptor) {
     return Object.freeze({
         runId: receipt.runId,
@@ -61,6 +85,11 @@ export function projectCancellation(receipt, policy, descriptor) {
         ...(receipt.run === undefined ? {} : { run: projectSnapshot(receipt.run, policy, descriptor) }),
     });
 }
+/** Verify retry identity and expose only supported acceptance fields.
+ * @param receipt - Provider cancellation or retry receipt.
+ * @param job - Compiled task job registration.
+ * @returns A frozen retry receipt matching the selected job/task version.
+ */
 export function projectRetry(receipt, job) {
     if (receipt.jobId !== job.jobId ||
         receipt.taskId !== job.taskId ||
@@ -81,6 +110,10 @@ export function projectRetry(receipt, job) {
             : { idempotencyExpiresAt: receipt.idempotencyExpiresAt }),
     });
 }
+/** Collect declared task error IDs for safe failure projection.
+ * @param descriptor - Job descriptor supplying canonical schemas and declared errors.
+ * @returns Projection options allowing only the descriptor's declared errors.
+ */
 function projectionOptions(descriptor) {
     const errors = descriptor?.task.errors;
     return errors === undefined ? {} : { declaredErrorIds: errors.map((error) => error.id) };

package/dist/jobs/projection.js.map

@@ -1 +1 @@
-{"version":3,"file":"projection.js","sourceRoot":"","sources":["../../src/jobs/projection.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"projection.js","sourceRoot":"","sources":["../../src/jobs/projection.ts"],"names":[],"mappings":"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"}

package/dist/jobs/rpc.d.ts

@@ -1,5 +1,9 @@
 import type { RouteMaterializationOptions } from "../materialize-routes.js";
 import { jobsErrorStatuses } from "./support.js";
 export { jobsErrorStatuses };
+/** Builds declared job procedures without exposing unavailable client operations.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns The exposed jobs procedure tree, or an empty object when none are available.
+ */
 export declare function jobsProcedures(options: RouteMaterializationOptions): Readonly<Record<string, unknown>>;
 //# sourceMappingURL=rpc.d.ts.map

package/dist/jobs/rpc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../../src/jobs/rpc.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAY5E,OAAO,EAA+B,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAG9E,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAE7B,wBAAgB,cAAc,CAC5B,OAAO,EAAE,2BAA2B,GACnC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAMnC"}
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../../src/jobs/rpc.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAY5E,OAAO,EAA+B,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAG9E,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAE7B;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,2BAA2B,GACnC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAMnC"}

package/dist/jobs/rpc.js

@@ -1,15 +1,24 @@
 import { asyncIteratorObject, ORPCError, os } from "@orpc/server";
-import { cancelJobRun, getJobRun, listJobRuns, retryJobRun, streamJobRun, triggerJob, watchJobRun, } from "./handlers.js";
 import { jobEnvelopeSchema, jobItemSchema } from "./common.js";
+import { cancelJobRun, getJobRun, listJobRuns, retryJobRun, streamJobRun, triggerJob, watchJobRun, } from "./handlers.js";
 import { exposedJobNodes, jobNodeFor, jobsErrorStatuses } from "./support.js";
 import { jobPolicy, jobsRuntime } from "./types.js";
 export { jobsErrorStatuses };
+/** Builds declared job procedures without exposing unavailable client operations.
+ * @param options - Application dependencies and configuration for this domain.
+ * @returns The exposed jobs procedure tree, or an empty object when none are available.
+ */
 export function jobsProcedures(options) {
     if (jobsRuntime(options) === undefined)
         return {};
     const jobs = Object.fromEntries(exposedJobNodes(options).map((job) => [job.name, proceduresFor(options, job)]));
     return Object.keys(jobs).length === 0 ? {} : { jobs };
 }
+/** Creates the enabled procedure set for one registered job.
+ * @param options - Application dependencies and configuration for this domain.
+ * @param job - Registered job declaration and its client operation policy.
+ * @returns The trigger and run procedures enabled by the job's declared client policy.
+ */
 function proceduresFor(options, job) {
     const policy = jobPolicy(job);
     const result = {};
@@ -33,6 +42,13 @@ function proceduresFor(options, job) {
         result.runs = runs;
     return result;
 }
+/** Builds a job request procedure with capability negotiation and error projection.
+ * @param options - Application dependencies and configuration for this domain.
+ * @param job - Registered job declaration and its client operation policy.
+ * @param operation - Bounded domain operation or public capability name.
+ * @param handler - Native handler executed within the configured boundary.
+ * @returns An oRPC procedure validating its input envelope before the job handler runs.
+ */
 function call(options, job, operation, handler) {
     return os
         .$context()
@@ -40,6 +56,13 @@ function call(options, job, operation, handler) {
         .input(jobEnvelopeSchema)
         .handler(({ input, context, signal }) => invoke(options, job, operation, () => handler(options, context, job, input, signal)));
 }
+/** Builds a streaming job procedure retaining lazy frame error projection.
+ * @param options - Application dependencies and configuration for this domain.
+ * @param job - Registered job declaration and its client operation policy.
+ * @param operation - Bounded domain operation or public capability name.
+ * @param handler - Native handler executed within the configured boundary.
+ * @returns An oRPC procedure exposing a validated asynchronous stream of job items.
+ */
 function streamCall(options, job, operation, handler) {
     return os
         .$context()
@@ -48,6 +71,13 @@ function streamCall(options, job, operation, handler) {
         .output(asyncIteratorObject(jobItemSchema))
         .handler(({ input, context, signal }) => invoke(options, job, operation, () => handler(options, context, job, input, signal)).then((value) => asAsyncIterator(value)));
 }
+/** Runs a negotiated job action and projects its failure into the public protocol.
+ * @param options - Application dependencies and configuration for this domain.
+ * @param job - Registered job declaration and its client operation policy.
+ * @param operation - Bounded domain operation or public capability name.
+ * @param action - Lazy protocol action executed after capability negotiation.
+ * @returns The job handler result, with recognized job failures projected to oRPC errors.
+ */
 async function invoke(options, job, operation, action) {
     if (jobNodeFor(options, job.name) === undefined) {
         throw new ORPCError("NOT_FOUND", { message: "Job was not found." });
@@ -69,6 +99,10 @@ async function invoke(options, job, operation, action) {
         throw error;
     }
 }
+/** Extracts bounded structured metadata from a public job error.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @returns Recovery metadata for an unknown submission or control outcome, otherwise undefined.
+ */
 function errorData(value) {
     if (!isRecord(value))
         return undefined;
@@ -96,9 +130,17 @@ function errorData(value) {
     };
 }
 const jobErrors = Object.fromEntries(Object.keys(jobsErrorStatuses).map((code) => [code, {}]));
+/** Normalizes a job stream value to its required native iterator contract.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @returns The native async iterator supplied by the job observation iterable.
+ */
 function asAsyncIterator(value) {
     return value[Symbol.asyncIterator]();
 }
+/** Selects the stable public job error code from an unknown failure.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @returns The failure's string code, or undefined when it has no public code.
+ */
 function errorCode(value) {
     return value !== null &&
         typeof value === "object" &&
@@ -106,9 +148,17 @@ function errorCode(value) {
         ? value.code
         : undefined;
 }
+/** Selects a safe job error message without serializing private causes.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @returns The Error message, or the fixed job-failure message for other thrown values.
+ */
 function errorMessage(value) {
     return value instanceof Error ? value.message : "Job operation failed.";
 }
+/** Recognizes a non-null object before reading its named properties.
+ * @param value - Value inspected, validated or projected by this operation.
+ * @returns Whether the inspected value satisfies the declared type guard.
+ */
 function isRecord(value) {
     return value !== null && typeof value === "object";
 }

package/dist/jobs/rpc.js.map

@@ -1 +1 @@
-{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../../src/jobs/rpc.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../../src/jobs/rpc.ts"],"names":[],"mappings":"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"}

package/dist/jobs/runtime.types.d.ts

@@ -0,0 +1,49 @@
+import type { MaybePromise } from "@relkit/contracts";
+import type { JobClientOperation, RunSnapshot } from "@relkit/contracts/jobs";
+import type { TaskJobNode } from "@relkit/graph";
+import type { JobDescriptorAny, JobsRuntime } from "@relkit/jobs";
+import type { HttpAuthInvocation } from "../auth.js";
+import type { ManifestEntries, RouteMaterializationOptions } from "../materialize-routes.js";
+/** Trusted resolver input containing the transport identity and selected job operation. */
+export interface JobsScopeRequest {
+    readonly request: Request;
+    readonly auth: HttpAuthInvocation | undefined;
+    readonly job: TaskJobNode;
+    readonly operation: JobClientOperation;
+    readonly input?: import("@relkit/contracts").JsonValue;
+    readonly run?: RunSnapshot;
+}
+/** Job providers, descriptor resolution, public identity and cursor-signing configuration. */
+export interface JobsRpcRuntime {
+    readonly runtimes?: JobsRuntime | ReadonlyMap<string, JobsRuntime> | Readonly<Record<string, JobsRuntime>> | (() => JobsRuntime | ReadonlyMap<string, JobsRuntime> | Readonly<Record<string, JobsRuntime>>);
+    readonly resolveRuntime?: (job: TaskJobNode) => MaybePromise<JobsRuntime | undefined>;
+    readonly descriptors?: ManifestEntries<unknown>;
+    readonly tasks?: ManifestEntries<unknown>;
+    readonly resolveDescriptor?: (job: TaskJobNode) => MaybePromise<JobDescriptorAny | undefined>;
+    readonly resolveScope?: (input: JobsScopeRequest) => MaybePromise<TrustedJobScope>;
+    readonly application?: string;
+    readonly environment?: string;
+    readonly publicScope?: string;
+    readonly publicFingerprint?: string;
+    readonly protocolVersion?: number;
+    readonly cursorSecret?: string | Uint8Array;
+    readonly authTimeoutMs?: number;
+}
+/** Validated application/environment partition and optional authenticated subject. */
+export interface TrustedJobScope {
+    readonly application: string;
+    readonly environment: string;
+    readonly scope: string;
+    readonly subject?: string;
+}
+/** Public operations, snapshot fields and stream names permitted for a job. */
+export interface JobPolicyProjection {
+    readonly operations: readonly JobClientOperation[];
+    readonly fields: readonly ("status" | "input" | "progress" | "output" | "error")[];
+    readonly streams: readonly string[];
+}
+/** Route materialization options requiring the jobs RPC configuration. */
+export interface JobRpcOptions extends RouteMaterializationOptions {
+    readonly jobs: JobsRpcRuntime;
+}
+//# sourceMappingURL=runtime.types.d.ts.map

package/dist/jobs/runtime.types.d.ts.map

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

package/dist/jobs/runtime.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime.types.js.map

package/dist/jobs/runtime.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.types.js","sourceRoot":"","sources":["../../src/jobs/runtime.types.ts"],"names":[],"mappings":""}

package/dist/jobs/support-lookups.d.ts

@@ -0,0 +1,20 @@
+import type { JobsRuntime } from "@relkit/jobs";
+import type { RouteMaterializationOptions } from "../materialize-routes.js";
+/** Read a manifest entry from either a map or record.
+ * @param entries - Job manifest descriptors indexed by job or graph node ID.
+ * @param key - Job or graph node ID to resolve.
+ * @returns The entry, or undefined when absent.
+ */
+export declare function mapEntry(entries: RouteMaterializationOptions["manifest"]["jobs"], key: string): unknown;
+/** Read a profile runtime from a map or record.
+ * @param source - Resolved singleton runtime or profile-indexed runtime collection.
+ * @param key - Provider profile name to resolve.
+ * @returns The matching runtime, excluding an already-resolved singleton.
+ */
+export declare function runtimeEntry(source: JobsRuntime | ReadonlyMap<string, JobsRuntime> | Readonly<Record<string, JobsRuntime>> | undefined, key: string): JobsRuntime | undefined;
+/** Recognize a runtime by its adapter and scope fields.
+ * @param value - Value to validate or project.
+ * @returns Whether the value has the runtime's required structural markers.
+ */
+export declare function isJobsRuntime(value: unknown): value is JobsRuntime;
+//# sourceMappingURL=support-lookups.d.ts.map

package/dist/jobs/support-lookups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"support-lookups.d.ts","sourceRoot":"","sources":["../../src/jobs/support-lookups.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAE5E;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,2BAA2B,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,EACxD,GAAG,EAAE,MAAM,GACV,OAAO,CAMT;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EACF,WAAW,GACX,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,GAChC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,GACrC,SAAS,EACb,GAAG,EAAE,MAAM,GACV,WAAW,GAAG,SAAS,CAMzB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE"}

package/dist/jobs/support-lookups.js

@@ -0,0 +1,34 @@
+/** Read a manifest entry from either a map or record.
+ * @param entries - Job manifest descriptors indexed by job or graph node ID.
+ * @param key - Job or graph node ID to resolve.
+ * @returns The entry, or undefined when absent.
+ */
+export function mapEntry(entries, key) {
+    if (entries === undefined)
+        return undefined;
+    if (typeof entries.get === "function") {
+        return entries.get(key);
+    }
+    return entries[key];
+}
+/** Read a profile runtime from a map or record.
+ * @param source - Resolved singleton runtime or profile-indexed runtime collection.
+ * @param key - Provider profile name to resolve.
+ * @returns The matching runtime, excluding an already-resolved singleton.
+ */
+export function runtimeEntry(source, key) {
+    if (source === undefined || isJobsRuntime(source))
+        return undefined;
+    if (typeof source.get === "function") {
+        return source.get(key);
+    }
+    return source[key];
+}
+/** Recognize a runtime by its adapter and scope fields.
+ * @param value - Value to validate or project.
+ * @returns Whether the value has the runtime's required structural markers.
+ */
+export function isJobsRuntime(value) {
+    return value !== null && typeof value === "object" && "adapter" in value && "scope" in value;
+}
+//# sourceMappingURL=support-lookups.js.map

package/dist/jobs/support-lookups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"support-lookups.js","sourceRoot":"","sources":["../../src/jobs/support-lookups.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CACtB,OAAwD,EACxD,GAAW;IAEX,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC5C,IAAI,OAAQ,OAAwC,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;QACxE,OAAQ,OAAwC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5D,CAAC;IACD,OAAQ,OAA6C,CAAC,GAAG,CAAC,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,MAIa,EACb,GAAW;IAEX,IAAI,MAAM,KAAK,SAAS,IAAI,aAAa,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IACpE,IAAI,OAAQ,MAA2C,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;QAC3E,OAAQ,MAA2C,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/D,CAAC;IACD,OAAQ,MAAgD,CAAC,GAAG,CAAC,CAAC;AAChE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,IAAI,KAAK,IAAI,OAAO,IAAI,KAAK,CAAC;AAC/F,CAAC"}

package/dist/jobs/support.d.ts

@@ -1,11 +1,12 @@
 import { ORPCError } from "@orpc/server";
 import type { JsonValue } from "@relkit/contracts";
 import type { JobClientOperation, RunSnapshot } from "@relkit/contracts/jobs";
-import type { JobDescriptorAny, JobsRuntime } from "@relkit/jobs";
 import type { TaskJobNode } from "@relkit/graph";
+import type { JobDescriptorAny, JobsRuntime } from "@relkit/jobs";
 import type { RouteMaterializationOptions } from "../materialize-routes.js";
 import type { RpcContext } from "../rpc.js";
 import { type JobsRpcRuntime, type TrustedJobScope } from "./types.js";
+/** Public jobs failure codes mapped to their transport status without native details. */
 export declare const jobsErrorStatuses: {
     readonly RELKIT_JOB_ACCESS_DENIED: 404;
     readonly RELKIT_JOB_CURSOR_INVALID: 400;
@@ -16,16 +17,70 @@ export declare const jobsErrorStatuses: {
     readonly RELKIT_JOB_SUBMISSION_UNKNOWN: 503;
     readonly RELKIT_JOB_CONTROL_UNKNOWN: 503;
 };
+/** Select durable task-backed jobs from the compiled execution plan.
+ * @param options - Runtime configuration and dependencies for this operation.
+ * @returns Task job nodes, excluding legacy function jobs.
+ */
 export declare function jobNodes(options: RouteMaterializationOptions): readonly TaskJobNode[];
+/** Select task jobs declaring at least one public client operation.
+ * @param options - Runtime configuration and dependencies for this operation.
+ * @returns The publicly addressable task job nodes.
+ */
 export declare function exposedJobNodes(options: RouteMaterializationOptions): readonly TaskJobNode[];
+/** Find an exposed job by its public name.
+ * @param options - Runtime configuration and dependencies for this operation.
+ * @param name - Field, job or stream name.
+ * @returns The matching task job node, or undefined.
+ */
 export declare function jobNodeFor(options: RouteMaterializationOptions, name: string): TaskJobNode | undefined;
+/** Resolve a job runtime using the explicit resolver or profile map.
+ * @param config - Configured jobs runtime and cursor policy.
+ * @param job - Compiled task job registration.
+ * @returns The runtime serving the job's configured profile.
+ */
 export declare function runtimeFor(config: JobsRpcRuntime, job: TaskJobNode): Promise<JobsRuntime>;
+/** Resolve a job descriptor by callback, job ID or graph node ID.
+ * @param config - Configured jobs runtime and cursor policy.
+ * @param job - Compiled task job registration.
+ * @returns The validated descriptor or a public not-found error.
+ */
 export declare function descriptorFor(config: JobsRpcRuntime, job: TaskJobNode): Promise<JobDescriptorAny>;
+/** Derive a validated job scope from the resolver, session or public defaults.
+ * @param config - Configured jobs runtime and cursor policy.
+ * @param context - Current Hono or RPC request context.
+ * @param job - Compiled task job registration.
+ * @param operation - Public job client operation.
+ * @param input - Public job request data.
+ * @param run - Persisted run being inspected.
+ * @returns A frozen application/environment/scope identity.
+ */
 export declare function trustedScopeFor(config: JobsRpcRuntime, context: RpcContext, job: TaskJobNode, operation: JobClientOperation, input?: JsonValue, run?: RunSnapshot): Promise<TrustedJobScope>;
+/** Constrain runtime operation contexts to one trusted job scope.
+ * @param runtime - Native jobs runtime.
+ * @param scope - Execution scope used to partition the operation.
+ * @returns A frozen runtime facade overriding the operation scope.
+ */
 export declare function scopedRuntime(runtime: JobsRuntime, scope: string): JobsRuntime;
+/** Require matching job, task version, build and trusted run scope.
+ * @param run - Persisted run being inspected.
+ * @param job - Compiled task job registration.
+ * @param scope - Execution scope used to partition the operation.
+ * @returns Nothing for a matching run; otherwise throws access denied.
+ */
 export declare function assertRunForJob(run: RunSnapshot, job: TaskJobNode, scope: TrustedJobScope): void;
+/** Require an authorization grant within the trusted scope hierarchy.
+ * @param grant - Authorization grant to compare with the trusted scope.
+ * @param scope - Execution scope used to partition the operation.
+ * @returns Nothing for the same scope or a colon-delimited child scope.
+ */
 export declare function assertGrantScope(grant: {
     readonly scope: string;
 }, scope: TrustedJobScope): void;
+/** Construct a public jobs RPC error without exposing native exceptions.
+ * @param code - Stable public error or mapping issue code.
+ * @param message - Public diagnostic message or browser message.
+ * @param data - Public event or error payload.
+ * @returns An ORPCError containing the explicit public message and data.
+ */
 export declare function jobError(code: string, message: string, data?: unknown): ORPCError<never, {} | null>;
 //# sourceMappingURL=support.d.ts.map

package/dist/jobs/support.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"support.d.ts","sourceRoot":"","sources":["../../src/jobs/support.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAoB,kBAAkB,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAChG,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAElE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAA0B,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAE/F,eAAO,MAAM,iBAAiB;;;;;;;;;CASpB,CAAC;AAEX,wBAAgB,QAAQ,CAAC,OAAO,EAAE,2BAA2B,GAAG,SAAS,WAAW,EAAE,CAErF;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,2BAA2B,GAAG,SAAS,WAAW,EAAE,CAE5F;AAED,wBAAgB,UAAU,CACxB,OAAO,EAAE,2BAA2B,EACpC,IAAI,EAAE,MAAM,GACX,WAAW,GAAG,SAAS,CAEzB;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAS/F;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,gBAAgB,CAAC,CAM3B;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,UAAU,EACnB,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,kBAAkB,EAC7B,KAAK,CAAC,EAAE,SAAS,EACjB,GAAG,CAAC,EAAE,WAAW,GAChB,OAAO,CAAC,eAAe,CAAC,CA8C1B;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAO9E;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAUhG;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAIhG;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,+BAKrE"}
+{"version":3,"file":"support.d.ts","sourceRoot":"","sources":["../../src/jobs/support.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAElE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,EAAa,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAElF,yFAAyF;AACzF,eAAO,MAAM,iBAAiB;;;;;;;;;CASpB,CAAC;AAEX;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,2BAA2B,GAAG,SAAS,WAAW,EAAE,CAErF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,2BAA2B,GAAG,SAAS,WAAW,EAAE,CAE5F;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,2BAA2B,EACpC,IAAI,EAAE,MAAM,GACX,WAAW,GAAG,SAAS,CAEzB;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAS/F;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,gBAAgB,CAAC,CAM3B;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,UAAU,EACnB,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,kBAAkB,EAC7B,KAAK,CAAC,EAAE,SAAS,EACjB,GAAG,CAAC,EAAE,WAAW,GAChB,OAAO,CAAC,eAAe,CAAC,CA8C1B;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAO9E;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAUhG;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAIhG;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,+BAKrE"}

package/dist/jobs/support.js

@@ -1,6 +1,8 @@
 import { ORPCError } from "@orpc/server";
 import { isJobDescriptor } from "@relkit/jobs";
-import { jobPolicy, jobsRuntime } from "./types.js";
+import { isJobsRuntime, mapEntry, runtimeEntry } from "./support-lookups.js";
+import { jobPolicy } from "./types.js";
+/** Public jobs failure codes mapped to their transport status without native details. */
 export const jobsErrorStatuses = {
     RELKIT_JOB_ACCESS_DENIED: 404,
     RELKIT_JOB_CURSOR_INVALID: 400,
@@ -11,15 +13,33 @@ export const jobsErrorStatuses = {
     RELKIT_JOB_SUBMISSION_UNKNOWN: 503,
     RELKIT_JOB_CONTROL_UNKNOWN: 503,
 };
+/** Select durable task-backed jobs from the compiled execution plan.
+ * @param options - Runtime configuration and dependencies for this operation.
+ * @returns Task job nodes, excluding legacy function jobs.
+ */
 export function jobNodes(options) {
     return (options.plan.jobs ?? []).filter((job) => job.executionModel === "task");
 }
+/** Select task jobs declaring at least one public client operation.
+ * @param options - Runtime configuration and dependencies for this operation.
+ * @returns The publicly addressable task job nodes.
+ */
 export function exposedJobNodes(options) {
     return jobNodes(options).filter((job) => jobPolicy(job).operations.length > 0);
 }
+/** Find an exposed job by its public name.
+ * @param options - Runtime configuration and dependencies for this operation.
+ * @param name - Field, job or stream name.
+ * @returns The matching task job node, or undefined.
+ */
 export function jobNodeFor(options, name) {
     return exposedJobNodes(options).find((job) => job.name === name);
 }
+/** Resolve a job runtime using the explicit resolver or profile map.
+ * @param config - Configured jobs runtime and cursor policy.
+ * @param job - Compiled task job registration.
+ * @returns The runtime serving the job's configured profile.
+ */
 export async function runtimeFor(config, job) {
     const resolved = await config.resolveRuntime?.(job);
     if (resolved !== undefined)
@@ -32,6 +52,11 @@ export async function runtimeFor(config, job) {
         throw jobError("RELKIT_JOB_RUN_NOT_FOUND", "Job service is unavailable.");
     return value;
 }
+/** Resolve a job descriptor by callback, job ID or graph node ID.
+ * @param config - Configured jobs runtime and cursor policy.
+ * @param job - Compiled task job registration.
+ * @returns The validated descriptor or a public not-found error.
+ */
 export async function descriptorFor(config, job) {
     const resolved = await config.resolveDescriptor?.(job);
     if (resolved !== undefined)
@@ -41,6 +66,15 @@ export async function descriptorFor(config, job) {
         return entry;
     throw jobError("RELKIT_JOB_RUN_NOT_FOUND", "Job descriptor is unavailable.");
 }
+/** Derive a validated job scope from the resolver, session or public defaults.
+ * @param config - Configured jobs runtime and cursor policy.
+ * @param context - Current Hono or RPC request context.
+ * @param job - Compiled task job registration.
+ * @param operation - Public job client operation.
+ * @param input - Public job request data.
+ * @param run - Persisted run being inspected.
+ * @returns A frozen application/environment/scope identity.
+ */
 export async function trustedScopeFor(config, context, job, operation, input, run) {
     if (config.resolveScope !== undefined) {
         return validateScope(await config.resolveScope({
@@ -85,6 +119,11 @@ export async function trustedScopeFor(config, context, job, operation, input, ru
         ...(subject === undefined ? {} : { subject }),
     });
 }
+/** Constrain runtime operation contexts to one trusted job scope.
+ * @param runtime - Native jobs runtime.
+ * @param scope - Execution scope used to partition the operation.
+ * @returns A frozen runtime facade overriding the operation scope.
+ */
 export function scopedRuntime(runtime, scope) {
     return Object.freeze({
         ...runtime,
@@ -92,6 +131,12 @@ export function scopedRuntime(runtime, scope) {
         operationContext: (options) => runtime.operationContext({ ...options, scope }),
     });
 }
+/** Require matching job, task version, build and trusted run scope.
+ * @param run - Persisted run being inspected.
+ * @param job - Compiled task job registration.
+ * @param scope - Execution scope used to partition the operation.
+ * @returns Nothing for a matching run; otherwise throws access denied.
+ */
 export function assertRunForJob(run, job, scope) {
     if (run.jobId !== job.jobId ||
         run.taskId !== job.taskId ||
@@ -101,36 +146,32 @@ export function assertRunForJob(run, job, scope) {
         throw jobError("RELKIT_JOB_ACCESS_DENIED", "Job run was not found.");
     }
 }
+/** Require an authorization grant within the trusted scope hierarchy.
+ * @param grant - Authorization grant to compare with the trusted scope.
+ * @param scope - Execution scope used to partition the operation.
+ * @returns Nothing for the same scope or a colon-delimited child scope.
+ */
 export function assertGrantScope(grant, scope) {
     if (grant.scope !== scope.scope && !grant.scope.startsWith(`${scope.scope}:`)) {
         throw jobError("RELKIT_JOB_ACCESS_DENIED", "Job operation is not authorized.");
     }
 }
+/** Construct a public jobs RPC error without exposing native exceptions.
+ * @param code - Stable public error or mapping issue code.
+ * @param message - Public diagnostic message or browser message.
+ * @param data - Public event or error payload.
+ * @returns An ORPCError containing the explicit public message and data.
+ */
 export function jobError(code, message, data) {
     return new ORPCError(code, {
         message,
         data: data ?? null,
     });
 }
-function mapEntry(entries, key) {
-    if (entries === undefined)
-        return undefined;
-    if (typeof entries.get === "function") {
-        return entries.get(key);
-    }
-    return entries[key];
-}
-function runtimeEntry(source, key) {
-    if (source === undefined || isJobsRuntime(source))
-        return undefined;
-    if (typeof source.get === "function") {
-        return source.get(key);
-    }
-    return source[key];
-}
-function isJobsRuntime(value) {
-    return value !== null && typeof value === "object" && "adapter" in value && "scope" in value;
-}
+/** Validate bounded application, environment and trusted scope identifiers.
+ * @param value - Value to validate or project.
+ * @returns The frozen scope, or a public authorization error.
+ */
 function validateScope(value) {
     for (const text of [value.application, value.environment, value.scope]) {
         if (typeof text !== "string" ||