@stellar-agent-services/provider-kit 0.0.0-stage → 0.1.0

package/dist/http/router.js

@@ -0,0 +1,329 @@
+// HTTP routes (Fetch API). Job paths are fixed relative to baseUrl (docs/provider-standard.md §5).
+//
+//   GET  <manifest path>                 -> manifest
+//   POST {baseUrl}/services/{name}/jobs  -> create-job   (x402; Idempotency-Key + Job-Token, or neither)
+//   GET  {baseUrl}/jobs/{jobId}          -> check-status (Job-Token)
+//   GET  {baseUrl}/jobs/{jobId}/result   -> get-result   (Job-Token)
+//
+// create-job follows the processing order in §5.4. Errors are RFC 9457 problems that never echo
+// headers, payment payloads or tokens [E2]. CORS is open so browser wallets can call providers [J17].
+//
+// Capacity (§5.8) is step 5: the caller's rate limit (429), then a place in the service's lane (503),
+// both before the 402, so nobody signs or pays for a job the provider can't take [Q1]. A paid request
+// is checked again [Q3]. The place is held while the payment is checked, verified and claimed, and the
+// claim runs under the lane's lock, so the job is counted exactly once.
+//
+// Step 7 checks the payment locally before the facilitator sees it (payments/payload-checks.ts): a
+// payment for another recipient, amount or asset is refused with a 402 and never forwarded. So is one
+// whose signature expires further out than maxTimeoutSeconds allows, when the ledger clock can tell:
+// the facilitator refuses it too, and reconciliation relies on it (payments/onchain.ts).
+import { createHash, randomBytes, randomUUID, timingSafeEqual } from "node:crypto";
+import { bindingHash, chargedFor, CREATE_JOB_HOLD_MAX_SECONDS, IDEMPOTENCY_KEY, IDEMPOTENCY_KEY_PATTERN, JOB_TOKEN, JOB_TOKEN_PATTERN, jobStatusUrl, jobViewHttpStatus, problem, PROBLEM_CONTENT_TYPE, PROBLEMS, } from "@stellar-agent-services/protocol";
+import { encodePaymentRequiredHeader, encodePaymentResponseHeader } from "@x402/core/http";
+import { runOnSuccess, settleUpfront } from "../jobs/runner.js";
+import { FINAL_STATUSES } from "../jobs/store.js";
+import { EXPIRATION_TOLERANCE_LEDGERS } from "../payments/onchain.js";
+import { checkPayment, isRefused } from "../payments/payload-checks.js";
+import { paymentRequired, paymentRequirements, readPayment } from "../payments/x402-server.js";
+import { readBounded } from "./bounded.js";
+export const MAX_HOLD_SECONDS = CREATE_JOB_HOLD_MAX_SECONDS;
+const RETRY_AFTER_SECONDS = 2;
+/** Longest Retry-After on a 202 for a queued job [Q6]. */
+const QUEUED_RETRY_AFTER_MAX_SECONDS = 60;
+/** How often a held create-job looks at a job another process may be running. */
+const HOLD_POLL_MS = 1000;
+const CORS = {
+    "Access-Control-Allow-Origin": "*",
+    "Access-Control-Expose-Headers": "PAYMENT-REQUIRED, PAYMENT-RESPONSE, Location, Retry-After",
+};
+export async function route(request, context) {
+    const url = new URL(request.url);
+    if (request.method === "OPTIONS") {
+        return new Response(null, {
+            status: 204,
+            headers: {
+                ...CORS,
+                "Access-Control-Allow-Methods": "GET, POST",
+                "Access-Control-Allow-Headers": `Content-Type, ${IDEMPOTENCY_KEY}, ${JOB_TOKEN}, PAYMENT-SIGNATURE`,
+                "Access-Control-Max-Age": "600",
+            },
+        });
+    }
+    if (url.pathname === context.manifestPath && request.method === "GET") {
+        return json(context.manifest, 200, { "Cache-Control": "max-age=300" });
+    }
+    const basePath = new URL(context.manifest.baseUrl).pathname.replace(/\/$/, "");
+    if (!url.pathname.startsWith(`${basePath}/`))
+        return error("service_not_found");
+    const path = url.pathname.slice(basePath.length);
+    const createJob = /^\/services\/([^/]+)\/jobs$/.exec(path);
+    if (createJob !== null && request.method === "POST") {
+        let name;
+        try {
+            name = decodeURIComponent(createJob[1]);
+        }
+        catch {
+            return error("service_not_found");
+        }
+        return handleCreateJob(request, name, context);
+    }
+    const getJob = /^\/jobs\/([^/]+?)(\/result)?$/.exec(path);
+    if (getJob !== null && request.method === "GET")
+        return handleGetJob(request, getJob[1], getJob[2] !== undefined, context);
+    return error("service_not_found");
+}
+async function handleCreateJob(request, serviceName, context) {
+    // 1. Headers and body.
+    const jobIdHeader = request.headers.get(IDEMPOTENCY_KEY);
+    const tokenHeader = request.headers.get(JOB_TOKEN);
+    if ((jobIdHeader === null) !== (tokenHeader === null)) {
+        return error("invalid_request", `send both ${IDEMPOTENCY_KEY} and ${JOB_TOKEN}, or neither`);
+    }
+    if (jobIdHeader !== null && !IDEMPOTENCY_KEY_PATTERN.test(jobIdHeader))
+        return error("invalid_request", `${IDEMPOTENCY_KEY} must be a lowercase UUID`);
+    if (tokenHeader !== null && !JOB_TOKEN_PATTERN.test(tokenHeader))
+        return error("invalid_request", `${JOB_TOKEN} must be 43 base64url characters`);
+    if (!request.headers.get("Content-Type")?.startsWith("application/json"))
+        return error("invalid_request", "the body must be application/json");
+    // 2. Service.
+    const service = context.services.get(serviceName);
+    if (service === undefined)
+        return error("service_not_found");
+    const declared = Number(request.headers.get("Content-Length") ?? "0");
+    const body = declared > service.inputLimitBytes ? undefined : await readBounded(request.body, service.inputLimitBytes);
+    if (body === undefined)
+        return error("payload_too_large", `the body is larger than ${service.inputLimitBytes} bytes`);
+    let input;
+    try {
+        input = JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(body));
+    }
+    catch {
+        return error("invalid_request", "the body is not valid JSON");
+    }
+    if (typeof input !== "object" || input === null || Array.isArray(input))
+        return error("invalid_input", "the input must be a JSON object");
+    const binding = await bindingHash(service.name, input);
+    const tokenHash = tokenHeader === null ? undefined : sha256(tokenHeader);
+    // 3. An existing job [J5]–[J7].
+    if (jobIdHeader !== null) {
+        const existing = await context.store.get(jobIdHeader);
+        if (existing !== undefined)
+            return existingJob(existing, binding, tokenHash, context);
+    }
+    // 4. Input [P8].
+    if (!service.validateInput(input))
+        return error("invalid_input", undefined, inputErrors(service.validateInput.errors));
+    // 5. Capacity [P8], [Q1]–[Q3], once the provider can take payments at all.
+    try {
+        await context.ready();
+    }
+    catch (cause) {
+        console.error("[provider-kit] not ready to take payments:", cause);
+        return error("unavailable", "the provider can't take payments right now; nothing was charged");
+    }
+    const limited = context.rateLimit?.(request);
+    if (limited !== undefined) {
+        return error("rate_limited", "too many requests from this caller; nothing was charged", undefined, { "Retry-After": String(limited) });
+    }
+    const admission = await context.scheduler.admit(service.name);
+    if (!admission.accepted) {
+        const detail = `"${service.name}" is at capacity; nothing was charged`;
+        return error("unavailable", detail, undefined, { "Retry-After": String(admission.retryAfterSeconds) });
+    }
+    try {
+        const ids = { jobIdHeader, tokenHeader, tokenHash, binding };
+        return await payAndRun(request, service, input, ids, admission.reservation, context);
+    }
+    finally {
+        // A no-op once the job is claimed. Otherwise the request ended without a job, and the place is free again.
+        admission.reservation.release();
+    }
+}
+async function payAndRun(request, service, input, ids, reservation, context) {
+    const { manifest, store, facilitator, scheduler } = context;
+    const { jobIdHeader, tokenHeader, tokenHash, binding } = ids;
+    // 6. No payment: the challenge.
+    const requirements = paymentRequirements(manifest, service);
+    const paymentHeader = request.headers.get("PAYMENT-SIGNATURE");
+    if (paymentHeader === null)
+        return challenge(manifest, service);
+    // 7. Check the payment locally, then verify it with the facilitator.
+    const payload = readPayment(paymentHeader, requirements);
+    if (payload === undefined)
+        return challenge(manifest, service, "invalid_payment");
+    const payment = await checkPayment(payload, requirements);
+    if (isRefused(payment))
+        return challenge(manifest, service, payment.reason);
+    // A ledger takes at least a second, so maxTimeoutSeconds is also the most ledgers a payment may live.
+    const latestLedger = await context.clock?.latest().catch(() => undefined);
+    if (latestLedger !== undefined && payment.expirationLedger > latestLedger + requirements.maxTimeoutSeconds + EXPIRATION_TOLERANCE_LEDGERS) {
+        return challenge(manifest, service, "invalid_exact_stellar_payload_signature_expiration_too_far");
+    }
+    try {
+        const verified = await facilitator.verify(payload, requirements);
+        if (!verified.isValid)
+            return challenge(manifest, service, verified.invalidReason ?? "invalid_payment");
+        if (verified.payer !== undefined && verified.payer !== payment.payer) {
+            console.error(`[provider-kit] the facilitator verified payer ${verified.payer}, but the payment is from ${payment.payer}`);
+            return error("unavailable", "the payment could not be verified; nothing was charged");
+        }
+    }
+    catch (cause) {
+        console.error("[provider-kit] the facilitator could not verify a payment:", cause);
+        return error("unavailable", "the payment could not be verified; nothing was charged");
+    }
+    // 8. Claim the job id and the payment together [J4], [P9], under the lane's lock.
+    const generated = jobIdHeader === null;
+    const jobId = jobIdHeader ?? randomUUID();
+    const jobToken = tokenHeader ?? randomBytes(32).toString("base64url");
+    const now = new Date().toISOString();
+    const job = {
+        jobId,
+        service: service.name,
+        charge: service.charge,
+        bindingHash: binding,
+        tokenHash: sha256(jobToken),
+        // An upfront job settles right after the claim, so the claim marks it as settling.
+        ...(service.charge === "on-success" ? { status: "queued" } : { status: "pending", settlingSince: now }),
+        claim: { fingerprint: payment.fingerprint, payer: payment.payer, nonce: payment.nonce, expirationLedger: payment.expirationLedger },
+        input,
+        createdAt: now,
+        updatedAt: now,
+    };
+    const claim = await scheduler.exclusive(service.name, async () => {
+        const result = await store.claim(job);
+        reservation.release();
+        return result;
+    });
+    if (claim.outcome === "payment_used")
+        return challenge(manifest, service, "payment_already_used");
+    if (claim.outcome === "conflict")
+        return error("idempotency_key_reused");
+    // Raced with an identical request: that request owns the payment, this one must not settle it [J5].
+    if (claim.outcome === "existing")
+        return existingJob(claim.job, binding, tokenHash, context);
+    // 9. Settle and run, holding the response for at most holdSeconds [J9].
+    const deadline = Date.now() + context.holdSeconds * 1000;
+    const run = { store, facilitator, scheduler, service, input, payload, requirements, payment, settleTimeoutMs: context.settleTimeoutMs, clock: context.clock };
+    let settled;
+    const work = (service.charge === "on-success" ? runOnSuccess(claim.job, run) : settleUpfront(claim.job, run))
+        .then((response) => (settled = response))
+        .catch((cause) => console.error(`[provider-kit] job ${jobId} crashed:`, cause));
+    await Promise.race([work, sleep(context.holdSeconds * 1000)]);
+    if (service.charge === "upfront")
+        await untilFinal(jobId, deadline, context);
+    if (context.loseCreateJobResponse)
+        throw new Error(`response-loss drill: dropping the create-job response for ${jobId}`);
+    // 10. Respond.
+    const stored = (await store.get(jobId));
+    // Settlement outlasted the hold: ask the client to come back [J7].
+    if (stored.status === "pending")
+        return error("request_in_progress", undefined, undefined, { "Retry-After": String(RETRY_AFTER_SECONDS) });
+    const headers = {};
+    if (settled !== undefined)
+        headers["PAYMENT-RESPONSE"] = encodePaymentResponseHeader(settled);
+    return jobResponse(stored, context, { withOutput: true, create: true, ...(generated ? { jobToken } : {}), headers });
+}
+/** Waits until the job is final or uncertain, or the deadline passes: whichever process runs it. */
+async function untilFinal(jobId, deadline, context) {
+    while (Date.now() < deadline) {
+        const changed = context.scheduler.changed();
+        const job = await context.store.get(jobId);
+        if (job === undefined || FINAL_STATUSES.includes(job.status) || job.status === "payment_uncertain")
+            return;
+        await Promise.race([changed, sleep(Math.min(HOLD_POLL_MS, deadline - Date.now()))]);
+    }
+}
+async function handleGetJob(request, jobId, withOutput, context) {
+    const token = request.headers.get(JOB_TOKEN);
+    const job = IDEMPOTENCY_KEY_PATTERN.test(jobId) ? await context.store.get(jobId) : undefined;
+    // Unknown job, missing or wrong token, and an expired job all look the same [J10].
+    if (job === undefined || token === null || !sameHash(job.tokenHash, sha256(token)) || expired(job, context))
+        return error("job_not_found");
+    if (job.status === "pending")
+        return error("request_in_progress", undefined, undefined, { "Retry-After": String(RETRY_AFTER_SECONDS) });
+    return jobResponse(job, context, { withOutput });
+}
+function existingJob(job, binding, tokenHash, context) {
+    if (job.bindingHash !== binding || !sameHash(job.tokenHash, tokenHash))
+        return error("idempotency_key_reused");
+    if (expired(job, context))
+        return error("idempotency_key_reused", "this job id was used for a job that has expired");
+    if (job.status === "pending")
+        return error("request_in_progress", undefined, undefined, { "Retry-After": String(RETRY_AFTER_SECONDS) });
+    return jobResponse(job, context, { withOutput: true, create: true });
+}
+function expiresAt(job, context) {
+    return Date.parse(job.finishedAt ?? job.createdAt) + context.retentionSeconds * 1000;
+}
+/** A final job past its retention is gone, even before the sweep deletes it [J15]. */
+function expired(job, context) {
+    return FINAL_STATUSES.includes(job.status) && expiresAt(job, context) <= Date.now();
+}
+async function jobResponse(job, context, options) {
+    if (job.status === "pending")
+        throw new Error("a pending job has no view");
+    const charged = chargedFor(job.status, job.charge, job.error?.code);
+    const view = {
+        jobId: job.jobId,
+        service: job.service,
+        status: job.status,
+        charge: job.charge,
+        charged,
+        createdAt: job.createdAt,
+        updatedAt: job.updatedAt,
+        expiresAt: new Date(expiresAt(job, context)).toISOString(),
+    };
+    if (options.withOutput && job.status === "succeeded" && job.output !== undefined)
+        view.output = job.output;
+    if (job.status === "failed" && job.error !== undefined)
+        view.error = job.error;
+    if (charged === true && job.payment !== undefined)
+        view.payment = job.payment;
+    if (options.jobToken !== undefined)
+        view.jobToken = options.jobToken;
+    let retryAfter = RETRY_AFTER_SECONDS;
+    const queue = job.status === "queued" ? await context.scheduler.position(job) : undefined;
+    if (queue !== undefined) {
+        view.queue = queue;
+        const seconds = Math.ceil((Date.parse(queue.estimatedStartAt) - Date.now()) / 1000);
+        retryAfter = Math.min(QUEUED_RETRY_AFTER_MAX_SECONDS, Math.max(1, seconds));
+    }
+    const status = jobViewHttpStatus(job.status);
+    const headers = { ...options.headers };
+    if (status === 202) {
+        headers["Retry-After"] = String(retryAfter);
+        if (options.create)
+            headers["Location"] = jobStatusUrl(context.manifest.baseUrl, job.jobId);
+    }
+    return json(view, status, headers);
+}
+function challenge(manifest, service, reason) {
+    const body = paymentRequired(manifest, service, reason);
+    return json(body, 402, { "PAYMENT-REQUIRED": encodePaymentRequiredHeader(body) });
+}
+function error(code, detail, errors, headers = {}) {
+    const options = {};
+    if (detail !== undefined)
+        options.detail = detail;
+    if (errors !== undefined)
+        options.errors = errors;
+    const retry = "retryAfter" in PROBLEMS[code] ? { "Retry-After": String(RETRY_AFTER_SECONDS) } : {};
+    return json(problem(code, options), PROBLEMS[code].status, { ...retry, ...headers }, PROBLEM_CONTENT_TYPE);
+}
+function json(body, status, headers = {}, contentType = "application/json") {
+    return new Response(JSON.stringify(body), { status, headers: { ...CORS, "Content-Type": contentType, ...headers } });
+}
+function inputErrors(errors) {
+    return (errors ?? []).map((e) => ({ pointer: e.instancePath, message: e.message ?? "is invalid" }));
+}
+function sha256(value) {
+    return createHash("sha256").update(value).digest("hex");
+}
+function sameHash(a, b) {
+    return a.length === b.length && timingSafeEqual(Buffer.from(a), Buffer.from(b));
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms).unref());
+}
+//# sourceMappingURL=router.js.map

package/dist/http/router.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+export * from "./define-service.js";
+export * from "./provider.js";
+export * from "./manifest.js";
+export * from "./registration.js";
+export * from "./validation-request.js";
+export * from "./gateway/config.js";
+export * from "./gateway/upstream.js";
+export * from "./jobs/store.js";
+export * from "./jobs/memory-store.js";
+export * from "./jobs/sqlite-store.js";
+export * from "./jobs/scheduler.js";
+export * from "./jobs/reconcile.js";
+export * from "./http/rate-limit.js";
+export * from "./http/node-server.js";
+export * from "./payments/chain.js";
+export * from "./payments/facilitator.js";
+export * from "./payments/onchain.js";
+export * from "./payments/payload-checks.js";
+export * from "./payments/settlement.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAYA,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,31 @@
+// @stellar-agent-services/provider-kit
+//
+// Turns a function, or an existing HTTP API, into a paid Stellar service that follows Provider
+// Standard v1:
+//   library:  defineService(...) -> createProvider(...) -> { fetch(request) } -> any Fetch-API server
+//   gateway:  provider-kit serve --config <file> -> forwards paid jobs to the upstream API
+//
+// Security rule: the provider runtime holds NO Stellar secret keys. It knows only its `payTo` public
+// address, and the x402 facilitator verifies and settles. Owner operations (the USDC trustline, 8004
+// registration, validation requests) run only from the CLI, signed in the owner's own wallet on a local
+// approval page, or by the Stellar CLI keychain with --source. The CLI never holds a key either.
+export * from "./define-service.js";
+export * from "./provider.js";
+export * from "./manifest.js";
+export * from "./registration.js";
+export * from "./validation-request.js";
+export * from "./gateway/config.js";
+export * from "./gateway/upstream.js";
+export * from "./jobs/store.js";
+export * from "./jobs/memory-store.js";
+export * from "./jobs/sqlite-store.js";
+export * from "./jobs/scheduler.js";
+export * from "./jobs/reconcile.js";
+export * from "./http/rate-limit.js";
+export * from "./http/node-server.js";
+export * from "./payments/chain.js";
+export * from "./payments/facilitator.js";
+export * from "./payments/onchain.js";
+export * from "./payments/payload-checks.js";
+export * from "./payments/settlement.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,EAAE;AACF,+FAA+F;AAC/F,eAAe;AACf,sGAAsG;AACtG,2FAA2F;AAC3F,EAAE;AACF,qGAAqG;AACrG,qGAAqG;AACrG,wGAAwG;AACxG,iGAAiG;AAEjG,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC"}

package/dist/jobs/memory-store.d.ts

@@ -0,0 +1,3 @@
+import { type JobStore } from "./store.js";
+export declare function memoryStore(): JobStore;
+//# sourceMappingURL=memory-store.d.ts.map

package/dist/jobs/memory-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../src/jobs/memory-store.ts"],"names":[],"mappings":"AAMA,OAAO,EAAgD,KAAK,QAAQ,EAAkB,MAAM,YAAY,CAAC;AAEzG,wBAAgB,WAAW,IAAI,QAAQ,CAmHtC"}

package/dist/jobs/memory-store.js

@@ -0,0 +1,121 @@
+// In-memory JobStore for tests and local development. It is not durable: jobs, queued ones included,
+// are lost on restart, so a provider using it can't recover jobs beyond the process lifetime. Use
+// sqliteStore() for anything users pay for.
+//
+// No method awaits inside, so each check-and-write is atomic on the event loop.
+import { applyPatch, FINAL_STATUSES } from "./store.js";
+export function memoryStore() {
+    const jobs = new Map();
+    const payments = new Map();
+    let queueSeq = 0;
+    const copy = (job) => job && structuredClone(job);
+    const ofService = (service) => [...jobs.values()].filter((job) => job.service === service);
+    const enqueue = (job) => {
+        job.queueSeq = ++queueSeq;
+    };
+    const toRunning = (job, lease) => {
+        applyPatch(job, { status: "running" }, new Date());
+        if (lease !== undefined) {
+            job.lease = lease;
+            job.attempts = (job.attempts ?? 0) + 1;
+        }
+        return copy(job);
+    };
+    return {
+        async get(jobId) {
+            return copy(jobs.get(jobId));
+        },
+        async claim(job) {
+            const existing = jobs.get(job.jobId);
+            if (existing !== undefined) {
+                const same = existing.bindingHash === job.bindingHash && existing.tokenHash === job.tokenHash;
+                return same ? { outcome: "existing", job: copy(existing) } : { outcome: "conflict" };
+            }
+            if (payments.has(job.claim.fingerprint))
+                return { outcome: "payment_used" };
+            const stored = structuredClone(job);
+            if (stored.status === "queued")
+                enqueue(stored);
+            payments.set(job.claim.fingerprint, job.jobId);
+            jobs.set(job.jobId, stored);
+            return { outcome: "created", job: copy(stored) };
+        },
+        async update(jobId, from, patch, owner) {
+            const job = jobs.get(jobId);
+            if (job === undefined || job.status !== from || FINAL_STATUSES.includes(job.status))
+                return undefined;
+            if (owner !== undefined && job.lease?.owner !== owner)
+                return undefined;
+            applyPatch(job, patch, new Date());
+            if (patch.status === "queued" && from !== "queued")
+                enqueue(job);
+            return copy(job);
+        },
+        async load(service) {
+            const load = { pending: 0, queued: 0, running: 0 };
+            for (const job of ofService(service)) {
+                if (job.status === "pending" || job.status === "queued" || job.status === "running")
+                    load[job.status]++;
+            }
+            return load;
+        },
+        async position(jobId) {
+            const job = jobs.get(jobId);
+            if (job?.status !== "queued")
+                return undefined;
+            return ofService(job.service).filter((other) => other.status === "queued" && other.queueSeq < job.queueSeq).length + 1;
+        },
+        async start(jobId, concurrency) {
+            const job = jobs.get(jobId);
+            if (job?.status !== "queued")
+                return undefined;
+            const others = ofService(job.service);
+            const running = others.filter((other) => other.status === "running").length;
+            const ahead = others.filter((other) => other.status === "queued" && other.queueSeq < job.queueSeq).length;
+            return running + ahead < concurrency ? toRunning(job) : undefined;
+        },
+        async lease(service, concurrency, owner, leaseSeconds) {
+            const now = Date.now();
+            const lease = { owner, expiresAt: now + leaseSeconds * 1000 };
+            const upfront = ofService(service)
+                .filter((job) => job.charge === "upfront")
+                .sort((a, b) => a.queueSeq - b.queueSeq);
+            const orphan = upfront.find((job) => job.status === "running" && job.lease !== undefined && job.lease.expiresAt < now && job.lease.owner !== owner);
+            if (orphan !== undefined) {
+                orphan.lease = lease;
+                orphan.attempts = (orphan.attempts ?? 0) + 1;
+                orphan.updatedAt = new Date(now).toISOString();
+                return copy(orphan);
+            }
+            const running = ofService(service).filter((job) => job.status === "running").length;
+            const next = upfront.find((job) => job.status === "queued");
+            return next !== undefined && running < concurrency ? toRunning(next, lease) : undefined;
+        },
+        async renew(jobId, owner, leaseSeconds) {
+            const job = jobs.get(jobId);
+            if (job?.status !== "running" || job.lease?.owner !== owner)
+                return false;
+            job.lease.expiresAt = Date.now() + leaseSeconds * 1000;
+            return true;
+        },
+        async list({ statuses, createdBefore, limit }) {
+            return [...jobs.values()]
+                .filter((job) => statuses.includes(job.status) && job.createdAt < createdBefore)
+                .sort((a, b) => a.createdAt.localeCompare(b.createdAt))
+                .slice(0, limit)
+                .map((job) => copy(job));
+        },
+        async deleteFinishedBefore(before) {
+            let deleted = 0;
+            for (const [jobId, job] of jobs) {
+                if (FINAL_STATUSES.includes(job.status) && job.finishedAt !== undefined && job.finishedAt < before) {
+                    jobs.delete(jobId);
+                    payments.delete(job.claim.fingerprint);
+                    deleted++;
+                }
+            }
+            return deleted;
+        },
+    };
+}
+//# sourceMappingURL=memory-store.js.map

package/dist/jobs/memory-store.js.map

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

package/dist/jobs/reconcile.d.ts

@@ -0,0 +1,22 @@
+import { type PaymentLookup, type PaymentSearch } from "../payments/onchain.js";
+import type { JobStore, StoredStatus } from "./store.js";
+export interface ReconcileOptions extends PaymentSearch {
+    /** Report what would change, and change nothing. */
+    dryRun?: boolean;
+    /** At most this many jobs per run, oldest first. Default 500. */
+    limit?: number;
+}
+export interface Reconciled {
+    jobId: string;
+    service: string;
+    outcome: PaymentLookup["outcome"];
+    /** The job's status afterwards: what it would be, in a dry run. */
+    status: StoredStatus;
+    /** The settling transaction. */
+    transaction?: string;
+    /** Why it was not settled, or is undecided. */
+    reason?: string;
+}
+/** Decides the store's payment_uncertain jobs that the chain can decide. */
+export declare function reconcile(store: JobStore, options: ReconcileOptions): Promise<Reconciled[]>;
+//# sourceMappingURL=reconcile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.d.ts","sourceRoot":"","sources":["../../src/jobs/reconcile.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAe,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC7F,OAAO,KAAK,EAAY,QAAQ,EAAa,YAAY,EAAE,MAAM,YAAY,CAAC;AAE9E,MAAM,WAAW,gBAAiB,SAAQ,aAAa;IACrD,oDAAoD;IACpD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IAClC,mEAAmE;IACnE,MAAM,EAAE,YAAY,CAAC;IACrB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID,4EAA4E;AAC5E,wBAAsB,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAkBjG"}