@relkit/runtime-hono 0.4.0 → 0.5.0

package/dist/jobs/common.js

@@ -0,0 +1,127 @@
+import { assertJsonValue, isJsonValue } from "@relkit/contracts";
+import { assertExpectedIdentity, assertRpcSecurity } from "../rpc-identity.js";
+import { jobError } from "./support.js";
+import { jobsRuntime } from "./types.js";
+export const jobEnvelopeSchema = {
+    "~standard": {
+        version: 1,
+        vendor: "relkit-jobs-envelope",
+        validate(value) {
+            if (!isRecord(value))
+                return { issues: [{ message: "Job RPC input must be an object." }] };
+            assertJsonValue(value);
+            return { value };
+        },
+    },
+};
+export const jobItemSchema = {
+    "~standard": {
+        version: 1,
+        vendor: "relkit-jobs-frame",
+        validate(value) {
+            assertJsonValue(value);
+            return { value };
+        },
+    },
+};
+export function configFor(options) {
+    const config = jobsRuntime(options);
+    if (config === undefined)
+        throw jobError("RELKIT_JOB_RUN_NOT_FOUND", "Jobs runtime is unavailable.");
+    return config;
+}
+export async function guardJobRequest(options, context, input, operation) {
+    assertJobsNegotiation(options, context.hono.req.raw, context.rpcHeaders);
+    if (options.clientIdentity !== undefined) {
+        await assertExpectedIdentity(context, options.clientIdentity, expectedIdentity(input));
+    }
+    if (isMutation(operation) && options.transportSecurity !== undefined) {
+        await assertRpcSecurity(context, options.transportSecurity);
+    }
+}
+export function recordInput(value) {
+    if (!isRecord(value))
+        throw jobError("RELKIT_JOB_ACCESS_DENIED", "Job request is invalid.");
+    return value;
+}
+export function envelopeInput(value, allowed) {
+    const input = recordInput(value);
+    const fields = new Set(allowed);
+    if (Object.keys(input).some((key) => !fields.has(key))) {
+        throw jobError("RELKIT_JOB_ACCESS_DENIED", "Job request contains an unsupported field.");
+    }
+    return input;
+}
+export function requiredText(value, name) {
+    if (typeof value !== "string" ||
+        value.length === 0 ||
+        new TextEncoder().encode(value).byteLength > 256) {
+        throw jobError("RELKIT_JOB_ACCESS_DENIED", `Job ${name} is invalid.`);
+    }
+    return value;
+}
+export function optionalText(value, name) {
+    return value === undefined ? undefined : requiredText(value, name);
+}
+export function optionalCursor(value, name) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "string" ||
+        value.length === 0 ||
+        new TextEncoder().encode(value).byteLength > 4096) {
+        throw jobError("RELKIT_JOB_CURSOR_INVALID", `Job ${name} is invalid.`);
+    }
+    return value;
+}
+export function expectedIdentity(value) {
+    if (value.expectedIdentity === undefined)
+        return undefined;
+    const identity = recordInput(value.expectedIdentity);
+    if (Object.keys(identity).some((key) => key !== "identityScope" && key !== "sessionEpoch")) {
+        throw jobError("RELKIT_JOB_ACCESS_DENIED", "Job identity metadata is invalid.");
+    }
+    return {
+        identityScope: requiredText(identity.identityScope, "identity scope"),
+        sessionEpoch: requiredText(identity.sessionEpoch, "session epoch"),
+    };
+}
+export function operationOptions(value) {
+    if (value === undefined)
+        return {};
+    const options = recordInput(value);
+    for (const key of Object.keys(options)) {
+        if (!["operationId", "idempotencyKey", "delay", "at", "tags", "correlationId"].includes(key)) {
+            throw jobError("RELKIT_JOB_ACCESS_DENIED", "Job trigger options contain an unsupported field.");
+        }
+    }
+    return options;
+}
+export function isMutation(operation) {
+    return operation === "trigger" || operation === "cancel" || operation === "retry";
+}
+export function assertJobsNegotiation(options, request, rpcHeaders) {
+    const config = jobsRuntime(options);
+    const version = request.headers.get("x-relkit-jobs-protocol") ?? header(rpcHeaders, "x-relkit-jobs-protocol");
+    if (version !== null && version !== String(config?.protocolVersion ?? 1)) {
+        throw jobError("RELKIT_JOB_PROTOCOL_UNSUPPORTED", "The jobs protocol version is unsupported.");
+    }
+    const fingerprint = request.headers.get("x-relkit-public-fingerprint") ??
+        header(rpcHeaders, "x-relkit-public-fingerprint");
+    if (fingerprint !== null &&
+        config?.publicFingerprint !== undefined &&
+        fingerprint !== config.publicFingerprint) {
+        throw jobError("RELKIT_JOB_PUBLIC_CONTRACT_STALE", "The public job contract is stale.");
+    }
+}
+function header(headers, name) {
+    if (headers === undefined)
+        return null;
+    const entry = Object.entries(headers).find(([key]) => key.toLowerCase() === name);
+    if (entry === undefined)
+        return null;
+    return Array.isArray(entry[1]) ? (entry[1][0] ?? null) : (entry[1] ?? null);
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=common.js.map

package/dist/jobs/common.js.map

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

package/dist/jobs/cursors.d.ts

@@ -0,0 +1,10 @@
+import type { JsonValue } from "@relkit/contracts";
+import type { JobClientOperation, RunPage, RunSnapshot, RunWatchFrame } from "@relkit/contracts/jobs";
+import type { TaskJobNode } from "@relkit/graph";
+import type { JobsRpcRuntime, TrustedJobScope } from "./types.js";
+export declare function decodeJobCursor(config: JobsRpcRuntime, trusted: TrustedJobScope, job: TaskJobNode, operation: JobClientOperation, filters: JsonValue, cursor: string | undefined): string | undefined;
+export declare function encodeJobCursor(config: JobsRpcRuntime, trusted: TrustedJobScope, job: TaskJobNode, operation: JobClientOperation, filters: JsonValue, position: string): string;
+export declare function projectPageCursor(page: RunPage<RunSnapshot>, config: JobsRpcRuntime, trusted: TrustedJobScope, job: TaskJobNode, filters: JsonValue): RunPage<RunSnapshot>;
+export declare function projectWatchCursor(frame: RunWatchFrame<RunSnapshot>, config: JobsRpcRuntime, trusted: TrustedJobScope, job: TaskJobNode, filters: JsonValue): RunWatchFrame<RunSnapshot>;
+export declare function decodeCursorFilters(value: unknown): JsonValue;
+//# sourceMappingURL=cursors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cursors.d.ts","sourceRoot":"","sources":["../../src/jobs/cursors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EACV,kBAAkB,EAClB,OAAO,EACP,WAAW,EACX,aAAa,EACd,MAAM,wBAAwB,CAAC;AAOhC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElE,wBAAgB,eAAe,CAC7B,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,eAAe,EACxB,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,kBAAkB,EAC7B,OAAO,EAAE,SAAS,EAClB,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,MAAM,GAAG,SAAS,CAapB;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,eAAe,EACxB,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,kBAAkB,EAC7B,OAAO,EAAE,SAAS,EAClB,QAAQ,EAAE,MAAM,GACf,MAAM,CASR;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,EAC1B,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,eAAe,EACxB,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,SAAS,GACjB,OAAO,CAAC,WAAW,CAAC,CAOtB;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,EACjC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,eAAe,EACxB,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,SAAS,GACjB,aAAa,CAAC,WAAW,CAAC,CAM5B;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAM7D"}

package/dist/jobs/cursors.js

@@ -0,0 +1,64 @@
+import { createJobCursor, readJobCursor, } from "@relkit/jobs";
+import { jobError } from "./support.js";
+export function decodeJobCursor(config, trusted, job, operation, filters, cursor) {
+    if (cursor === undefined)
+        return undefined;
+    try {
+        const value = readJobCursor(cursor, binding(config, trusted, job, operation, filters), cursorOptions(config));
+        if (typeof value.position !== "string")
+            throw new Error("Cursor position is not text.");
+        return value.position;
+    }
+    catch {
+        throw jobError("RELKIT_JOB_CURSOR_INVALID", "Job cursor is invalid.");
+    }
+}
+export function encodeJobCursor(config, trusted, job, operation, filters, position) {
+    try {
+        return createJobCursor({ ...binding(config, trusted, job, operation, filters), position }, cursorOptions(config));
+    }
+    catch {
+        throw jobError("RELKIT_JOB_CURSOR_INVALID", "Job cursor is invalid.");
+    }
+}
+export function projectPageCursor(page, config, trusted, job, filters) {
+    return Object.freeze({
+        ...page,
+        ...(page.nextCursor === undefined
+            ? {}
+            : { nextCursor: encodeJobCursor(config, trusted, job, "list", filters, page.nextCursor) }),
+    });
+}
+export function projectWatchCursor(frame, config, trusted, job, filters) {
+    if (frame.cursor === undefined)
+        return frame;
+    return {
+        ...frame,
+        cursor: encodeJobCursor(config, trusted, job, "watch", filters, frame.cursor),
+    };
+}
+export function decodeCursorFilters(value) {
+    if (value === undefined)
+        return {};
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        throw jobError("RELKIT_JOB_CURSOR_INVALID", "Job cursor filters are invalid.");
+    }
+    return value;
+}
+function binding(config, trusted, job, operation, filters) {
+    return {
+        application: trusted.application,
+        environment: trusted.environment,
+        scope: trusted.scope,
+        ...(trusted.subject === undefined ? {} : { subject: trusted.subject }),
+        jobId: job.jobId,
+        operation,
+        filters,
+        schema: config.publicFingerprint ?? "relkit.jobs.v1",
+        position: null,
+    };
+}
+function cursorOptions(config) {
+    return config.cursorSecret === undefined ? undefined : { key: config.cursorSecret };
+}
+//# sourceMappingURL=cursors.js.map

package/dist/jobs/cursors.js.map

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

package/dist/jobs/handlers-mutations.d.ts

@@ -0,0 +1,8 @@
+import type { RunCancellationReceipt, RunHandle, RunRetryReceipt } from "@relkit/contracts/jobs";
+import type { TaskJobNode } from "@relkit/graph";
+import type { RouteMaterializationOptions } from "../materialize-routes.js";
+import type { RpcContext } from "../rpc.js";
+export declare function triggerJob(options: RouteMaterializationOptions, context: RpcContext, job: TaskJobNode, value: unknown, signal?: AbortSignal): Promise<RunHandle>;
+export declare function cancelJobRun(options: RouteMaterializationOptions, context: RpcContext, job: TaskJobNode, value: unknown, signal?: AbortSignal): Promise<RunCancellationReceipt>;
+export declare function retryJobRun(options: RouteMaterializationOptions, context: RpcContext, job: TaskJobNode, value: unknown, signal?: AbortSignal): Promise<RunRetryReceipt>;
+//# sourceMappingURL=handlers-mutations.d.ts.map

package/dist/jobs/handlers-mutations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers-mutations.d.ts","sourceRoot":"","sources":["../../src/jobs/handlers-mutations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAQjG,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;AAqB5C,wBAAsB,UAAU,CAC9B,OAAO,EAAE,2BAA2B,EACpC,OAAO,EAAE,UAAU,EACnB,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,SAAS,CAAC,CAuCpB;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,2BAA2B,EACpC,OAAO,EAAE,UAAU,EACnB,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,sBAAsB,CAAC,CAiDjC;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,2BAA2B,EACpC,OAAO,EAAE,UAAU,EACnB,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,eAAe,CAAC,CA0C1B"}

package/dist/jobs/handlers-mutations.js

@@ -0,0 +1,73 @@
+import { createJobsControls, decodeJobWire, prepareCanonicalSubmission, submitPreparedSubmission, validateTaskInput, } from "@relkit/jobs";
+import { assertGrantLive, authorizeJobOperation } from "./authorization.js";
+import { configFor, envelopeInput, guardJobRequest, operationOptions, requiredText, } from "./common.js";
+import { assertRunForJob, descriptorFor, jobError, runtimeFor, scopedRuntime, trustedScopeFor, } from "./support.js";
+import { projectCancellation, projectRetry } from "./projection.js";
+import { readRun, validateCanonicalRun } from "./handlers-validation.js";
+import { jobPolicy } from "./types.js";
+export async function triggerJob(options, context, job, value, signal) {
+    const input = envelopeInput(value, ["input", "options", "expectedIdentity"]);
+    await guardJobRequest(options, context, input, "trigger");
+    const config = configFor(options);
+    const descriptor = await descriptorFor(config, job);
+    const runtime = await runtimeFor(config, job);
+    const validated = await validateTaskInput(descriptor.task.input, input.input);
+    const canonicalInput = decodeJobWire(validated.wire);
+    const trusted = await trustedScopeFor(config, context, job, "trigger", canonicalInput ?? null);
+    const admission = await prepareCanonicalSubmission(scopedRuntime(runtime, trusted.scope), descriptor.task, validated.wire, operationOptions(input.options), descriptor);
+    const authorized = await authorizeJobOperation(config, context, job, descriptor, "trigger", admission.input, undefined, signal);
+    const finalRuntime = scopedRuntime(runtime, authorized.grant.scope);
+    const finalAdmission = authorized.grant.scope === trusted.scope
+        ? admission
+        : await prepareCanonicalSubmission(finalRuntime, descriptor.task, validated.wire, operationOptions(input.options), descriptor);
+    assertGrantLive(authorized.grant);
+    return submitPreparedSubmission(finalRuntime, finalAdmission, signal);
+}
+export async function cancelJobRun(options, context, job, value, signal) {
+    const input = envelopeInput(value, ["runId", "operationId", "reason", "expectedIdentity"]);
+    await guardJobRequest(options, context, input, "cancel");
+    const config = configFor(options);
+    const descriptor = await descriptorFor(config, job);
+    const runtime = await runtimeFor(config, job);
+    const runId = requiredText(input.runId, "run ID");
+    const operationId = requiredText(input.operationId, "operation ID");
+    const trusted = await trustedScopeFor(config, context, job, "cancel");
+    const initial = await authorizeJobOperation(config, context, job, descriptor, "cancel", undefined, undefined, signal, runId);
+    const observed = await readRun(runtime, initial.grant.scope, runId, signal);
+    const authorized = await authorizeJobOperation(config, context, job, descriptor, "cancel", undefined, observed, signal, runId);
+    assertRunForJob(observed, job, { ...trusted, scope: authorized.grant.scope });
+    assertGrantLive(authorized.grant);
+    const receipt = await createJobsControls(scopedRuntime(runtime, authorized.grant.scope)).cancel(runId, {
+        operationId,
+        ...(input.reason === undefined ? {} : { reason: requiredText(input.reason, "reason") }),
+        ...(signal === undefined ? {} : { signal }),
+    });
+    if (receipt.run !== undefined) {
+        if (receipt.run.runId !== runId)
+            throw jobError("RELKIT_JOB_ACCESS_DENIED", "Job cancellation receipt is unavailable.");
+        assertRunForJob(receipt.run, job, { ...trusted, scope: authorized.grant.scope });
+        await validateCanonicalRun(descriptor, receipt.run);
+    }
+    return projectCancellation(receipt, jobPolicy(job), descriptor);
+}
+export async function retryJobRun(options, context, job, value, signal) {
+    const input = envelopeInput(value, ["runId", "operationId", "expectedIdentity"]);
+    await guardJobRequest(options, context, input, "retry");
+    const config = configFor(options);
+    const descriptor = await descriptorFor(config, job);
+    const runtime = await runtimeFor(config, job);
+    const runId = requiredText(input.runId, "run ID");
+    const operationId = requiredText(input.operationId, "operation ID");
+    const trusted = await trustedScopeFor(config, context, job, "retry");
+    const initial = await authorizeJobOperation(config, context, job, descriptor, "retry", undefined, undefined, signal, runId);
+    const observed = await readRun(runtime, initial.grant.scope, runId, signal);
+    const authorized = await authorizeJobOperation(config, context, job, descriptor, "retry", undefined, observed, signal, runId);
+    assertRunForJob(observed, job, { ...trusted, scope: authorized.grant.scope });
+    assertGrantLive(authorized.grant);
+    const receipt = await createJobsControls(scopedRuntime(runtime, authorized.grant.scope)).retry(runId, {
+        operationId,
+        ...(signal === undefined ? {} : { signal }),
+    });
+    return projectRetry(receipt, job);
+}
+//# sourceMappingURL=handlers-mutations.js.map

package/dist/jobs/handlers-mutations.js.map

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

package/dist/jobs/handlers-read.d.ts

@@ -0,0 +1,8 @@
+import type { RunPage, RunSnapshot, RunWatchFrame } from "@relkit/contracts/jobs";
+import type { TaskJobNode } from "@relkit/graph";
+import type { RouteMaterializationOptions } from "../materialize-routes.js";
+import type { RpcContext } from "../rpc.js";
+export declare function getJobRun(options: RouteMaterializationOptions, context: RpcContext, job: TaskJobNode, value: unknown, signal?: AbortSignal): Promise<RunSnapshot>;
+export declare function listJobRuns(options: RouteMaterializationOptions, context: RpcContext, job: TaskJobNode, value: unknown, signal?: AbortSignal): Promise<RunPage<RunSnapshot>>;
+export declare function watchJobRun(options: RouteMaterializationOptions, context: RpcContext, job: TaskJobNode, value: unknown, signal?: AbortSignal): Promise<AsyncIterable<RunWatchFrame<RunSnapshot>>>;
+//# sourceMappingURL=handlers-read.d.ts.map

package/dist/jobs/handlers-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers-read.d.ts","sourceRoot":"","sources":["../../src/jobs/handlers-read.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAgB,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEhG,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;AA2B5C,wBAAsB,SAAS,CAC7B,OAAO,EAAE,2BAA2B,EACpC,OAAO,EAAE,UAAU,EACnB,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,WAAW,CAAC,CAmCtB;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,2BAA2B,EACpC,OAAO,EAAE,UAAU,EACnB,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAuC/B;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,2BAA2B,EACpC,OAAO,EAAE,UAAU,EACnB,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CA+CpD"}

package/dist/jobs/handlers-read.js

@@ -0,0 +1,70 @@
+import { assertJsonValue } from "@relkit/contracts";
+import { createJobsControls } from "@relkit/jobs";
+import { authorizeJobOperation, assertGrantLive } from "./authorization.js";
+import { configFor, envelopeInput, guardJobRequest, optionalCursor, recordInput, requiredText, } from "./common.js";
+import { decodeJobCursor, encodeJobCursor, projectPageCursor, projectWatchCursor, } from "./cursors.js";
+import { assertRunForJob, descriptorFor, runtimeFor, scopedRuntime, trustedScopeFor, } from "./support.js";
+import { jobPolicy } from "./types.js";
+import { projectPage, projectSnapshot, projectWatchFrame } from "./projection.js";
+import { queryInput, readRun, validateCanonicalRun } from "./handlers-validation.js";
+export async function getJobRun(options, context, job, value, signal) {
+    const input = envelopeInput(value, ["runId", "expectedIdentity"]);
+    await guardJobRequest(options, context, input, "get");
+    const config = configFor(options);
+    const descriptor = await descriptorFor(config, job);
+    const runtime = await runtimeFor(config, job);
+    const runId = requiredText(input.runId, "run ID");
+    const trusted = await trustedScopeFor(config, context, job, "get");
+    const initial = await authorizeJobOperation(config, context, job, descriptor, "get", undefined, undefined, signal, runId);
+    const observed = await readRun(runtime, initial.grant.scope, runId, signal);
+    const authorized = await authorizeJobOperation(config, context, job, descriptor, "get", undefined, observed, signal, runId);
+    const owner = { ...trusted, scope: authorized.grant.scope };
+    assertRunForJob(observed, job, owner);
+    await validateCanonicalRun(descriptor, observed);
+    return projectSnapshot(observed, jobPolicy(job), descriptor);
+}
+export async function listJobRuns(options, context, job, value, signal) {
+    const input = envelopeInput(value, ["query", "expectedIdentity"]);
+    await guardJobRequest(options, context, input, "list");
+    const config = configFor(options);
+    const descriptor = await descriptorFor(config, job);
+    const runtime = await runtimeFor(config, job);
+    const trusted = await trustedScopeFor(config, context, job, "list");
+    const authorized = await authorizeJobOperation(config, context, job, descriptor, "list", undefined, undefined, signal);
+    const requestedQuery = queryInput(input.query);
+    const { cursor: requestedCursor, ...requestedFilters } = requestedQuery;
+    const filters = { ...requestedFilters, jobId: job.jobId };
+    assertJsonValue(filters);
+    const owner = { ...trusted, scope: authorized.grant.scope };
+    const cursor = decodeJobCursor(config, owner, job, "list", filters, requestedCursor);
+    const page = await createJobsControls(scopedRuntime(runtime, authorized.grant.scope)).list({ ...filters, ...(cursor === undefined ? {} : { cursor }) }, signal === undefined ? {} : { signal });
+    assertGrantLive(authorized.grant);
+    for (const run of page.items) {
+        assertRunForJob(run, job, owner);
+        await validateCanonicalRun(descriptor, run);
+    }
+    return projectPageCursor(projectPage(page, jobPolicy(job), descriptor), config, owner, job, filters);
+}
+export async function watchJobRun(options, context, job, value, signal) {
+    const input = envelopeInput(value, ["runId", "after", "expectedIdentity"]);
+    await guardJobRequest(options, context, input, "watch");
+    const config = configFor(options);
+    const descriptor = await descriptorFor(config, job);
+    const runtime = await runtimeFor(config, job);
+    const runId = requiredText(input.runId, "run ID");
+    const trusted = await trustedScopeFor(config, context, job, "watch");
+    const authorized = await authorizeJobOperation(config, context, job, descriptor, "watch", undefined, undefined, signal, runId);
+    const owner = { ...trusted, scope: authorized.grant.scope };
+    const filters = { runId };
+    const after = decodeJobCursor(config, owner, job, "watch", filters, optionalCursor(input.after, "cursor"));
+    const source = createJobsControls(scopedRuntime(runtime, owner.scope)).observe({ runId, ...(after === undefined ? {} : { after }) }, signal === undefined ? {} : { signal });
+    return (async function* () {
+        for await (const frame of source) {
+            assertGrantLive(authorized.grant);
+            assertRunForJob(frame.run, job, owner);
+            await validateCanonicalRun(descriptor, frame.run);
+            yield projectWatchCursor(projectWatchFrame(frame, jobPolicy(job), descriptor), config, owner, job, filters);
+        }
+    })();
+}
+//# sourceMappingURL=handlers-read.js.map

package/dist/jobs/handlers-read.js.map

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

package/dist/jobs/handlers-stream.d.ts

@@ -0,0 +1,7 @@
+import type { JsonValue } from "@relkit/contracts";
+import type { NamedStreamFrame } from "@relkit/contracts/jobs";
+import type { TaskJobNode } from "@relkit/graph";
+import type { RouteMaterializationOptions } from "../materialize-routes.js";
+import type { RpcContext } from "../rpc.js";
+export declare function streamJobRun(options: RouteMaterializationOptions, context: RpcContext, job: TaskJobNode, value: unknown, signal?: AbortSignal): Promise<AsyncIterable<NamedStreamFrame<JsonValue>>>;
+//# sourceMappingURL=handlers-stream.d.ts.map

package/dist/jobs/handlers-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers-stream.d.ts","sourceRoot":"","sources":["../../src/jobs/handlers-stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,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,wBAAsB,YAAY,CAChC,OAAO,EAAE,2BAA2B,EACpC,OAAO,EAAE,UAAU,EACnB,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC,CAyDrD"}

package/dist/jobs/handlers-stream.js

@@ -0,0 +1,72 @@
+import { TASK_ITEM_MAX_BYTES, validateCanonicalOutput } from "@relkit/jobs";
+import { authorizeJobOperation, assertGrantLive } from "./authorization.js";
+import { configFor, envelopeInput, guardJobRequest, optionalCursor, requiredText, } from "./common.js";
+import { decodeJobCursor, encodeJobCursor } from "./cursors.js";
+import { descriptorFor, jobError, runtimeFor, trustedScopeFor } from "./support.js";
+import { jobPolicy } from "./types.js";
+import { projectStreamFrame } from "./projection.js";
+export async function streamJobRun(options, context, job, value, signal) {
+    const input = envelopeInput(value, ["runId", "name", "after", "expectedIdentity"]);
+    await guardJobRequest(options, context, input, "stream");
+    const config = configFor(options);
+    const descriptor = await descriptorFor(config, job);
+    const runtime = await runtimeFor(config, job);
+    const runId = requiredText(input.runId, "run ID");
+    const name = requiredText(input.name, "stream name");
+    const policy = jobPolicy(job);
+    if (!policy.streams.includes(name))
+        throw jobError("RELKIT_JOB_ACCESS_DENIED", "Job stream was not found.");
+    const trusted = await trustedScopeFor(config, context, job, "stream");
+    const authorized = await authorizeJobOperation(config, context, job, descriptor, "stream", undefined, undefined, signal, runId, name);
+    const owner = { ...trusted, scope: authorized.grant.scope };
+    const filters = { runId, name };
+    const after = decodeJobCursor(config, owner, job, "stream", filters, optionalCursor(input.after, "cursor"));
+    const source = nativeStream(runtime, runId, name, after, signal, owner.scope);
+    return (async function* () {
+        for await (const frame of source) {
+            assertGrantLive(authorized.grant);
+            const streamSchema = descriptor.task.streams?.[name];
+            if (frameIsChunk(frame) && streamSchema !== undefined) {
+                try {
+                    await validateCanonicalOutput(streamSchema, frame.item, TASK_ITEM_MAX_BYTES);
+                }
+                catch {
+                    throw jobError("RELKIT_JOB_ACCESS_DENIED", "Job stream data is not available.");
+                }
+            }
+            const projected = projectStreamFrame(frame, runId, name);
+            if (!("cursor" in projected) || projected.cursor === undefined) {
+                yield projected;
+                continue;
+            }
+            yield {
+                ...projected,
+                cursor: encodeJobCursor(config, owner, job, "stream", filters, projected.cursor),
+            };
+        }
+    })();
+}
+function nativeStream(runtime, runId, name, after, signal, scope) {
+    const streams = runtime.adapter.streams;
+    if (streams === undefined)
+        throw jobError("RELKIT_JOB_STREAM_UNSUPPORTED", "Job streams are unavailable.");
+    const candidate = streams;
+    const method = typeof candidate.observe === "function" ? candidate.observe : candidate.stream;
+    if (typeof method !== "function")
+        throw jobError("RELKIT_JOB_STREAM_UNSUPPORTED", "Job streams are unavailable.");
+    const source = method({ runId, name, ...(after === undefined ? {} : { after }) }, runtime.operationContext({ signal: signal ?? new AbortController().signal, scope }));
+    if (!isAsyncIterable(source))
+        throw jobError("RELKIT_JOB_STREAM_UNSUPPORTED", "Job stream is invalid.");
+    return source;
+}
+function frameIsChunk(value) {
+    return (value !== null &&
+        typeof value === "object" &&
+        value.kind === "chunk");
+}
+function isAsyncIterable(value) {
+    return (value !== null &&
+        typeof value === "object" &&
+        typeof value[Symbol.asyncIterator] === "function");
+}
+//# sourceMappingURL=handlers-stream.js.map

package/dist/jobs/handlers-stream.js.map

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

package/dist/jobs/handlers-validation.d.ts

@@ -0,0 +1,6 @@
+import type { RunListQuery, RunSnapshot } from "@relkit/contracts/jobs";
+import { type JobDescriptorAny, type JobsRuntime } from "@relkit/jobs";
+export declare function validateCanonicalRun(descriptor: JobDescriptorAny, run: RunSnapshot): Promise<void>;
+export declare function readRun(runtime: JobsRuntime, scope: string, runId: string, signal?: AbortSignal): Promise<RunSnapshot>;
+export declare function queryInput(value: unknown): RunListQuery;
+//# sourceMappingURL=handlers-validation.d.ts.map

package/dist/jobs/handlers-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers-validation.d.ts","sourceRoot":"","sources":["../../src/jobs/handlers-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAKL,KAAK,gBAAgB,EACrB,KAAK,WAAW,EACjB,MAAM,cAAc,CAAC;AAKtB,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,gBAAgB,EAC5B,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,IAAI,CAAC,CAef;AAED,wBAAsB,OAAO,CAC3B,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,WAAW,CAAC,CAUtB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAsEvD"}