@byollm/server 0.1.0-alpha.1 → 0.1.0-alpha.100

package/dist/chunk-HL6EYHQ7.js

@@ -1,422 +0,0 @@
-// src/ids.ts
-import {
-  createHash,
-  randomBytes,
-  randomUUID,
-  timingSafeEqual
-} from "crypto";
-var USER_CODE_ALPHABET = "ABCDEFGHJKMNPQRTWXYZ2346789";
-function generateDeviceCode() {
-  return randomBytes(32).toString("base64url");
-}
-function generateRunnerToken() {
-  return randomBytes(32).toString("base64url");
-}
-function generateRunnerId() {
-  return `runner_${randomUUID()}`;
-}
-function generateJobId() {
-  return `job_${randomUUID()}`;
-}
-function generateUserCode() {
-  const chars = [];
-  while (chars.length < 8) {
-    for (const byte of randomBytes(16)) {
-      const limit = 256 - 256 % USER_CODE_ALPHABET.length;
-      if (byte >= limit) continue;
-      const symbol = USER_CODE_ALPHABET[byte % USER_CODE_ALPHABET.length];
-      if (symbol === void 0) continue;
-      chars.push(symbol);
-      if (chars.length === 8) break;
-    }
-  }
-  return `${chars.slice(0, 4).join("")}-${chars.slice(4).join("")}`;
-}
-function hashSecret(secret) {
-  return createHash("sha256").update(secret, "utf8").digest("hex");
-}
-function secretsMatch(aHex, bHex) {
-  if (aHex.length !== bHex.length) return false;
-  return timingSafeEqual(Buffer.from(aHex, "hex"), Buffer.from(bHex, "hex"));
-}
-
-// src/handlers.ts
-import {
-  ClaimRequest,
-  ERROR_STATUS,
-  HeartbeatRequest,
-  PairRequest,
-  PROTOCOL_VERSION,
-  ReleaseRequest,
-  ResultRequest,
-  provenanceFor
-} from "@byollm/protocol";
-var DEFAULTS = {
-  leaseMs: 6e4,
-  pairingTtlMs: 10 * 6e4,
-  pollIntervalMs: 2e3
-};
-function fail(error, message, retryAfterSeconds) {
-  return {
-    status: ERROR_STATUS[error],
-    body: {
-      error,
-      message,
-      ...retryAfterSeconds === void 0 ? {} : { retryAfter: retryAfterSeconds }
-    },
-    ...retryAfterSeconds === void 0 ? {} : { retryAfterSeconds }
-  };
-}
-function ok(body) {
-  return { status: 200, body };
-}
-var ByollmHandlers = class {
-  #store;
-  #verificationUrl;
-  #leaseMs;
-  #pairingTtlMs;
-  #pollIntervalMs;
-  #now;
-  constructor(config) {
-    this.#store = config.store;
-    this.#verificationUrl = config.verificationUrl;
-    this.#leaseMs = config.leaseMs ?? DEFAULTS.leaseMs;
-    this.#pairingTtlMs = config.pairingTtlMs ?? DEFAULTS.pairingTtlMs;
-    this.#pollIntervalMs = config.pollIntervalMs ?? DEFAULTS.pollIntervalMs;
-    this.#now = config.now ?? Date.now;
-  }
-  /**
-   * Dispatch one protocol call.
-   *
-   * @param endpoint - which of the five, already routed from the path
-   * @param body - the parsed JSON request body, untrusted
-   * @param bearer - the `Authorization: Bearer` value, if any
-   */
-  async handle(endpoint, body, bearer) {
-    switch (endpoint) {
-      case "pair":
-        return this.#pair(body);
-      case "claim":
-        return this.#authed(bearer, body, ClaimRequest, this.#claim.bind(this));
-      case "heartbeat":
-        return this.#authed(
-          bearer,
-          body,
-          HeartbeatRequest,
-          this.#heartbeat.bind(this),
-          { allowRevoked: true }
-        );
-      case "result":
-        return this.#authed(
-          bearer,
-          body,
-          ResultRequest,
-          this.#result.bind(this)
-        );
-      case "release":
-        return this.#authed(
-          bearer,
-          body,
-          ReleaseRequest,
-          this.#release.bind(this)
-        );
-    }
-  }
-  /**
-   * Shared preamble for the four authenticated endpoints: resolve the bearer
-   * token to a runner, reject a revoked one, and parse the body.
-   *
-   * The token→runner lookup happens before schema validation so a stranger
-   * probing the endpoint learns nothing about the wire format.
-   */
-  async #authed(bearer, body, schema, run, options = {}) {
-    if (bearer === void 0 || bearer.length === 0) {
-      return fail("unauthorized", "a runner token is required");
-    }
-    const runner = await this.#store.getRunnerByTokenHash(hashSecret(bearer));
-    if (!runner) {
-      return fail("unauthorized", "this runner token is not recognised");
-    }
-    if (runner.revokedAt !== null && options.allowRevoked !== true) {
-      return fail("revoked", "this runner has been revoked by its owner");
-    }
-    const parsed = schema.safeParse(body);
-    if (!parsed.success || parsed.data === void 0) {
-      return fail("bad-request", "request body failed schema validation");
-    }
-    return run(parsed.data, runner);
-  }
-  // -- 1. pair --------------------------------------------------------------
-  async #pair(body) {
-    const parsed = PairRequest.safeParse(body);
-    if (!parsed.success) {
-      return fail("bad-request", "pair request failed schema validation");
-    }
-    const request = parsed.data;
-    const now = this.#now();
-    if (request.action === "start") {
-      const deviceCode = generateDeviceCode();
-      const userCode = generateUserCode();
-      const expiresAt = now + this.#pairingTtlMs;
-      await this.#store.createPairing({
-        deviceCodeHash: hashSecret(deviceCode),
-        userCode,
-        state: "pending",
-        owner: null,
-        runnerId: null,
-        runnerTokenOnce: null,
-        label: request.daemon.label,
-        platform: request.daemon.platform,
-        daemonVersion: request.daemon.version,
-        capabilities: request.capabilities,
-        expiresAt,
-        createdAt: now
-      });
-      const response = {
-        deviceCode,
-        userCode,
-        verificationUrl: this.#verificationUrl,
-        expiresAt,
-        pollIntervalMs: this.#pollIntervalMs
-      };
-      return ok(response);
-    }
-    const pairing = await this.#store.getPairingByDeviceCodeHash(
-      hashSecret(request.deviceCode)
-    );
-    if (!pairing) {
-      return fail("not-found", "unknown device code");
-    }
-    if (pairing.state === "denied") {
-      return ok({ status: "denied" });
-    }
-    if (pairing.expiresAt <= now && pairing.state === "pending") {
-      return ok({ status: "expired" });
-    }
-    if (pairing.state === "approved" && pairing.runnerTokenOnce !== null && pairing.runnerId !== null && pairing.owner !== null) {
-      const response = {
-        status: "approved",
-        runnerToken: pairing.runnerTokenOnce,
-        runnerId: pairing.runnerId,
-        owner: pairing.owner
-      };
-      await this.#store.consumePairingToken(pairing.deviceCodeHash);
-      return ok(response);
-    }
-    if (pairing.state === "approved") {
-      return fail("not-found", "this pairing has already been collected");
-    }
-    return ok({ status: "pending" });
-  }
-  // -- 2. claim -------------------------------------------------------------
-  async #claim(request, runner) {
-    if (request.runnerId !== runner.id) {
-      return fail("unauthorized", "runner id does not match the bearer token");
-    }
-    const now = this.#now();
-    const jobs = await this.#store.claim({
-      runnerId: runner.id,
-      runnerOwner: runner.owner,
-      capabilities: request.capabilities,
-      max: request.max,
-      leaseMs: this.#leaseMs,
-      now
-    });
-    const response = {
-      jobs: jobs.map((job) => ({
-        id: job.id,
-        kind: job.kind,
-        payload: job.payload,
-        audience: job.audience,
-        owner: job.owner,
-        ...job.audienceAllow === void 0 ? {} : { audienceAllow: [...job.audienceAllow] },
-        lease: job.lease ?? {
-          runnerId: runner.id,
-          expiresAt: now + this.#leaseMs
-        }
-      })),
-      leaseMs: this.#leaseMs
-    };
-    return ok(response);
-  }
-  // -- 3. heartbeat ---------------------------------------------------------
-  async #heartbeat(request, runner) {
-    if (request.runnerId !== runner.id) {
-      return fail("unauthorized", "runner id does not match the bearer token");
-    }
-    const now = this.#now();
-    const revoked = runner.revokedAt !== null;
-    if (revoked) {
-      const held = await this.#store.listClaimedBy(runner.id);
-      const response2 = {
-        revoked: true,
-        cancel: [],
-        leases: [],
-        lost: held.map((job) => job.id),
-        serverTime: now
-      };
-      return ok(response2);
-    }
-    await this.#store.touchRunner({
-      runnerId: runner.id,
-      capabilities: request.capabilities,
-      daemonVersion: request.daemonVersion,
-      paused: request.paused,
-      now
-    });
-    const { renewed, lost } = await this.#store.renewLeases({
-      runnerId: runner.id,
-      jobIds: request.activeJobIds,
-      leaseMs: this.#leaseMs,
-      now
-    });
-    const cancel = await this.#store.listCancelRequests(runner.id);
-    const response = {
-      revoked: false,
-      cancel,
-      leases: renewed.map((r) => ({ jobId: r.jobId, expiresAt: r.expiresAt })),
-      lost: [...lost],
-      serverTime: now
-    };
-    return ok(response);
-  }
-  // -- 4. result ------------------------------------------------------------
-  async #result(request, runner) {
-    if (request.runnerId !== runner.id) {
-      return fail("unauthorized", "runner id does not match the bearer token");
-    }
-    const now = this.#now();
-    const job = await this.#store.get(request.jobId);
-    if (!job) return fail("not-found", "unknown job");
-    const provenance = provenanceFor({
-      audience: job.audience,
-      runnerId: runner.id,
-      runnerOwner: runner.owner,
-      backendClass: request.backendClass,
-      model: request.model
-    });
-    const { accepted, job: updated } = await this.#store.complete({
-      jobId: request.jobId,
-      runnerId: runner.id,
-      outcome: request.outcome,
-      provenance,
-      now
-    });
-    const response = {
-      accepted,
-      state: updated?.state ?? job.state
-    };
-    return ok(response);
-  }
-  // -- 5. release -----------------------------------------------------------
-  async #release(request, runner) {
-    if (request.runnerId !== runner.id) {
-      return fail("unauthorized", "runner id does not match the bearer token");
-    }
-    const released = await this.#store.release({
-      runnerId: runner.id,
-      jobIds: request.jobIds,
-      reason: request.reason,
-      now: this.#now()
-    });
-    const response = { released };
-    return ok(response);
-  }
-};
-var SERVED_PROTOCOL_VERSION = PROTOCOL_VERSION;
-
-// src/http.ts
-import { ENDPOINTS, PROTOCOL_PREFIX } from "@byollm/protocol";
-var MAX_BODY_BYTES = 8 * 1024 * 1024;
-function routeEndpoint(pathname) {
-  const index = pathname.lastIndexOf("/");
-  const last = index === -1 ? pathname : pathname.slice(index + 1);
-  return ENDPOINTS.includes(last) ? last : null;
-}
-function bearerFrom(header) {
-  if (!header) return void 0;
-  const match = /^Bearer[ ]+(.+)$/i.exec(header.trim());
-  return match?.[1];
-}
-function createFetchHandler(config) {
-  const handlers = new ByollmHandlers(config);
-  return async function handle(request) {
-    if (request.method !== "POST") {
-      return json(405, {
-        error: "bad-request",
-        message: "protocol endpoints accept POST only"
-      });
-    }
-    const endpoint = routeEndpoint(new URL(request.url).pathname);
-    if (endpoint === null) {
-      return json(404, {
-        error: "not-found",
-        message: `not a ${PROTOCOL_PREFIX} endpoint`
-      });
-    }
-    const declared = request.headers.get("content-length");
-    if (declared !== null && Number(declared) > MAX_BODY_BYTES) {
-      return json(400, {
-        error: "bad-request",
-        message: "request body too large"
-      });
-    }
-    let body;
-    try {
-      const text = await request.text();
-      if (text.length > MAX_BODY_BYTES) {
-        return json(400, {
-          error: "bad-request",
-          message: "request body too large"
-        });
-      }
-      body = JSON.parse(text);
-    } catch {
-      return json(400, {
-        error: "bad-request",
-        message: "request body is not valid JSON"
-      });
-    }
-    const result = await handlers.handle(
-      endpoint,
-      body,
-      bearerFrom(request.headers.get("authorization"))
-    );
-    const headers = {
-      "content-type": "application/json",
-      "cache-control": "no-store"
-    };
-    if (result.retryAfterSeconds !== void 0) {
-      headers["retry-after"] = String(result.retryAfterSeconds);
-    }
-    return new Response(JSON.stringify(result.body), {
-      status: result.status,
-      headers
-    });
-  };
-}
-function json(status, body) {
-  return new Response(JSON.stringify(body), {
-    status,
-    headers: {
-      "content-type": "application/json",
-      "cache-control": "no-store"
-    }
-  });
-}
-
-export {
-  generateDeviceCode,
-  generateRunnerToken,
-  generateRunnerId,
-  generateJobId,
-  generateUserCode,
-  hashSecret,
-  secretsMatch,
-  ByollmHandlers,
-  SERVED_PROTOCOL_VERSION,
-  routeEndpoint,
-  bearerFrom,
-  createFetchHandler
-};
-//# sourceMappingURL=chunk-HL6EYHQ7.js.map

package/dist/chunk-HL6EYHQ7.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/ids.ts","../src/handlers.ts","../src/http.ts"],"sourcesContent":["import {\n  createHash,\n  randomBytes,\n  randomUUID,\n  timingSafeEqual,\n} from \"node:crypto\";\n\n/**\n * Alphabet for the user-facing pairing code.\n *\n * Excludes `0/O`, `1/I/L`, `5/S` and `U/V` — a code is read aloud or copied\n * off a terminal into a browser, and a user who mistypes it gets a failure\n * they cannot diagnose. 27 symbols over 8 characters is ~38 bits, which is\n * ample for a code that lives ten minutes, is single-use, and is rate-limited.\n */\nconst USER_CODE_ALPHABET = \"ABCDEFGHJKMNPQRTWXYZ2346789\";\n\n/** A device code: the secret the daemon polls with. Never shown to a user. */\nexport function generateDeviceCode(): string {\n  return randomBytes(32).toString(\"base64url\");\n}\n\n/** A runner bearer token. */\nexport function generateRunnerToken(): string {\n  return randomBytes(32).toString(\"base64url\");\n}\n\n/** A runner id. */\nexport function generateRunnerId(): string {\n  return `runner_${randomUUID()}`;\n}\n\n/** A job id. */\nexport function generateJobId(): string {\n  return `job_${randomUUID()}`;\n}\n\n/**\n * A short code the user reads and confirms, formatted `XXXX-XXXX`.\n * Drawn with rejection sampling so the alphabet stays uniform.\n */\nexport function generateUserCode(): string {\n  const chars: string[] = [];\n  while (chars.length < 8) {\n    for (const byte of randomBytes(16)) {\n      // 256 % 28 !== 0, so bytes at or above the largest whole multiple are\n      // discarded rather than folded — folding would bias the low symbols.\n      const limit = 256 - (256 % USER_CODE_ALPHABET.length);\n      if (byte >= limit) continue;\n      const symbol = USER_CODE_ALPHABET[byte % USER_CODE_ALPHABET.length];\n      if (symbol === undefined) continue;\n      chars.push(symbol);\n      if (chars.length === 8) break;\n    }\n  }\n  return `${chars.slice(0, 4).join(\"\")}-${chars.slice(4).join(\"\")}`;\n}\n\n/** SHA-256, hex. Tokens and device codes are stored only as this. */\nexport function hashSecret(secret: string): string {\n  return createHash(\"sha256\").update(secret, \"utf8\").digest(\"hex\");\n}\n\n/**\n * Compare two hex digests without leaking their difference through timing.\n * Lengths are compared first because `timingSafeEqual` throws on a mismatch.\n */\nexport function secretsMatch(aHex: string, bHex: string): boolean {\n  if (aHex.length !== bHex.length) return false;\n  return timingSafeEqual(Buffer.from(aHex, \"hex\"), Buffer.from(bHex, \"hex\"));\n}\n","import {\n  ClaimRequest,\n  type ClaimRequest as ClaimRequestType,\n  type HeartbeatRequest as HeartbeatRequestType,\n  type ReleaseRequest as ReleaseRequestType,\n  type ResultRequest as ResultRequestType,\n  ERROR_STATUS,\n  HeartbeatRequest,\n  PairRequest,\n  PROTOCOL_VERSION,\n  ReleaseRequest,\n  ResultRequest,\n  provenanceFor,\n  type ClaimResponse,\n  type Endpoint,\n  type HeartbeatResponse,\n  type PairPollResponse,\n  type PairStartResponse,\n  type ReleaseResponse,\n  type ResultResponse,\n  type WireErrorCode,\n} from \"@byollm/protocol\";\nimport { generateDeviceCode, generateUserCode, hashSecret } from \"./ids.js\";\nimport type { RunnerRecord } from \"./records.js\";\nimport type { ByollmStore } from \"./store.js\";\n\n/** Everything a mount needs to serve the protocol. */\nexport interface HandlerConfig {\n  readonly store: ByollmStore;\n  /**\n   * Absolute URL of the page where a user approves a pairing. The device code\n   * is *not* appended — the user types the short code into the app's own\n   * authenticated page, which is what keeps pairing interactive.\n   */\n  readonly verificationUrl: string;\n  /** How long a lease lasts. Default 60s — six heartbeats of headroom. */\n  readonly leaseMs?: number;\n  /** How long an unapproved pairing code lives. Default 10 minutes. */\n  readonly pairingTtlMs?: number;\n  /** How often a daemon may poll for pairing approval. Default 2s. */\n  readonly pollIntervalMs?: number;\n  /** Injectable clock, so tests can move time without sleeping. */\n  readonly now?: () => number;\n}\n\nconst DEFAULTS = {\n  leaseMs: 60_000,\n  pairingTtlMs: 10 * 60_000,\n  pollIntervalMs: 2_000,\n} as const;\n\n/** A handled protocol call: a status and a JSON body. */\nexport interface HandlerResult {\n  readonly status: number;\n  readonly body: unknown;\n  /** Set for `rate-limited` and `server-error`. */\n  readonly retryAfterSeconds?: number;\n}\n\nfunction fail(\n  error: WireErrorCode,\n  message: string,\n  retryAfterSeconds?: number,\n): HandlerResult {\n  return {\n    status: ERROR_STATUS[error],\n    body: {\n      error,\n      message,\n      ...(retryAfterSeconds === undefined\n        ? {}\n        : { retryAfter: retryAfterSeconds }),\n    },\n    ...(retryAfterSeconds === undefined ? {} : { retryAfterSeconds }),\n  };\n}\n\nfunction ok(body: unknown): HandlerResult {\n  return { status: 200, body };\n}\n\n/**\n * The five protocol endpoints, over any {@link ByollmStore}.\n *\n * Transport-free on purpose: a mount adapts `Request`/`Response` (or Express,\n * or whatever) onto {@link ByollmHandlers.handle}, and everything the\n * protocol actually specifies lives here where the conformance kit can reach\n * it without an HTTP server in the way.\n */\nexport class ByollmHandlers {\n  readonly #store: ByollmStore;\n  readonly #verificationUrl: string;\n  readonly #leaseMs: number;\n  readonly #pairingTtlMs: number;\n  readonly #pollIntervalMs: number;\n  readonly #now: () => number;\n\n  constructor(config: HandlerConfig) {\n    this.#store = config.store;\n    this.#verificationUrl = config.verificationUrl;\n    this.#leaseMs = config.leaseMs ?? DEFAULTS.leaseMs;\n    this.#pairingTtlMs = config.pairingTtlMs ?? DEFAULTS.pairingTtlMs;\n    this.#pollIntervalMs = config.pollIntervalMs ?? DEFAULTS.pollIntervalMs;\n    this.#now = config.now ?? Date.now;\n  }\n\n  /**\n   * Dispatch one protocol call.\n   *\n   * @param endpoint - which of the five, already routed from the path\n   * @param body - the parsed JSON request body, untrusted\n   * @param bearer - the `Authorization: Bearer` value, if any\n   */\n  async handle(\n    endpoint: Endpoint,\n    body: unknown,\n    bearer: string | undefined,\n  ): Promise<HandlerResult> {\n    switch (endpoint) {\n      case \"pair\":\n        return this.#pair(body);\n      case \"claim\":\n        return this.#authed(bearer, body, ClaimRequest, this.#claim.bind(this));\n      case \"heartbeat\":\n        // Heartbeat is the channel revocation travels on, so a revoked runner\n        // must reach the handler and be told `revoked: true` rather than be\n        // bounced with a 403 it would treat as a transport problem\n        // ({@link MUSTS.REVOCATION_HONORED}).\n        return this.#authed(\n          bearer,\n          body,\n          HeartbeatRequest,\n          this.#heartbeat.bind(this),\n          { allowRevoked: true },\n        );\n      case \"result\":\n        return this.#authed(\n          bearer,\n          body,\n          ResultRequest,\n          this.#result.bind(this),\n        );\n      case \"release\":\n        return this.#authed(\n          bearer,\n          body,\n          ReleaseRequest,\n          this.#release.bind(this),\n        );\n    }\n  }\n\n  /**\n   * Shared preamble for the four authenticated endpoints: resolve the bearer\n   * token to a runner, reject a revoked one, and parse the body.\n   *\n   * The token→runner lookup happens before schema validation so a stranger\n   * probing the endpoint learns nothing about the wire format.\n   */\n  async #authed<T>(\n    bearer: string | undefined,\n    body: unknown,\n    schema: { safeParse: (v: unknown) => { success: boolean; data?: T } },\n    run: (request: T, runner: RunnerRecord) => Promise<HandlerResult>,\n    options: { allowRevoked?: boolean } = {},\n  ): Promise<HandlerResult> {\n    if (bearer === undefined || bearer.length === 0) {\n      return fail(\"unauthorized\", \"a runner token is required\");\n    }\n    const runner = await this.#store.getRunnerByTokenHash(hashSecret(bearer));\n    if (!runner) {\n      return fail(\"unauthorized\", \"this runner token is not recognised\");\n    }\n    if (runner.revokedAt !== null && options.allowRevoked !== true) {\n      // A distinct truth from \"unauthorized\": the daemon should stop and say\n      // so, not retry or re-pair silently.\n      return fail(\"revoked\", \"this runner has been revoked by its owner\");\n    }\n\n    const parsed = schema.safeParse(body);\n    if (!parsed.success || parsed.data === undefined) {\n      return fail(\"bad-request\", \"request body failed schema validation\");\n    }\n    return run(parsed.data, runner);\n  }\n\n  // -- 1. pair --------------------------------------------------------------\n\n  async #pair(body: unknown): Promise<HandlerResult> {\n    const parsed = PairRequest.safeParse(body);\n    if (!parsed.success) {\n      return fail(\"bad-request\", \"pair request failed schema validation\");\n    }\n    const request = parsed.data;\n    const now = this.#now();\n\n    if (request.action === \"start\") {\n      const deviceCode = generateDeviceCode();\n      const userCode = generateUserCode();\n      const expiresAt = now + this.#pairingTtlMs;\n\n      await this.#store.createPairing({\n        deviceCodeHash: hashSecret(deviceCode),\n        userCode,\n        state: \"pending\",\n        owner: null,\n        runnerId: null,\n        runnerTokenOnce: null,\n        label: request.daemon.label,\n        platform: request.daemon.platform,\n        daemonVersion: request.daemon.version,\n        capabilities: request.capabilities,\n        expiresAt,\n        createdAt: now,\n      });\n\n      const response: PairStartResponse = {\n        deviceCode,\n        userCode,\n        verificationUrl: this.#verificationUrl,\n        expiresAt,\n        pollIntervalMs: this.#pollIntervalMs,\n      };\n      return ok(response);\n    }\n\n    // action === \"poll\"\n    const pairing = await this.#store.getPairingByDeviceCodeHash(\n      hashSecret(request.deviceCode),\n    );\n    if (!pairing) {\n      return fail(\"not-found\", \"unknown device code\");\n    }\n    if (pairing.state === \"denied\") {\n      return ok({ status: \"denied\" } satisfies PairPollResponse);\n    }\n    // Expiry is checked before approval state so a code approved after it\n    // lapsed is still dead ({@link MUSTS.PAIR_CODE_EXPIRES}).\n    if (pairing.expiresAt <= now && pairing.state === \"pending\") {\n      return ok({ status: \"expired\" } satisfies PairPollResponse);\n    }\n    if (\n      pairing.state === \"approved\" &&\n      pairing.runnerTokenOnce !== null &&\n      pairing.runnerId !== null &&\n      pairing.owner !== null\n    ) {\n      const response: PairPollResponse = {\n        status: \"approved\",\n        runnerToken: pairing.runnerTokenOnce,\n        runnerId: pairing.runnerId,\n        owner: pairing.owner,\n      };\n      // Delivered exactly once — a replayed device code gets nothing.\n      await this.#store.consumePairingToken(pairing.deviceCodeHash);\n      return ok(response);\n    }\n    if (pairing.state === \"approved\") {\n      return fail(\"not-found\", \"this pairing has already been collected\");\n    }\n    return ok({ status: \"pending\" } satisfies PairPollResponse);\n  }\n\n  // -- 2. claim -------------------------------------------------------------\n\n  async #claim(\n    request: ClaimRequestType,\n    runner: RunnerRecord,\n  ): Promise<HandlerResult> {\n    if (request.runnerId !== runner.id) {\n      return fail(\"unauthorized\", \"runner id does not match the bearer token\");\n    }\n    const now = this.#now();\n\n    // Capabilities from *this* request, never the stored matrix — a daemon\n    // that just lost a backend must not be handed work for it\n    // ({@link MUSTS.CLAIM_REQUIRES_CAPABILITY}).\n    const jobs = await this.#store.claim({\n      runnerId: runner.id,\n      runnerOwner: runner.owner,\n      capabilities: request.capabilities,\n      max: request.max,\n      leaseMs: this.#leaseMs,\n      now,\n    });\n\n    const response: ClaimResponse = {\n      jobs: jobs.map((job) => ({\n        id: job.id,\n        kind: job.kind,\n        payload: job.payload,\n        audience: job.audience,\n        owner: job.owner,\n        ...(job.audienceAllow === undefined\n          ? {}\n          : { audienceAllow: [...job.audienceAllow] }),\n        lease: job.lease ?? {\n          runnerId: runner.id,\n          expiresAt: now + this.#leaseMs,\n        },\n      })),\n      leaseMs: this.#leaseMs,\n    };\n    return ok(response);\n  }\n\n  // -- 3. heartbeat ---------------------------------------------------------\n\n  async #heartbeat(\n    request: HeartbeatRequestType,\n    runner: RunnerRecord,\n  ): Promise<HandlerResult> {\n    if (request.runnerId !== runner.id) {\n      return fail(\"unauthorized\", \"runner id does not match the bearer token\");\n    }\n    const now = this.#now();\n    const revoked = runner.revokedAt !== null;\n\n    if (revoked) {\n      // Nothing is renewed for a revoked runner: every job it holds is\n      // reported lost so it abandons the queue rather than finishing it.\n      const held = await this.#store.listClaimedBy(runner.id);\n      const response: HeartbeatResponse = {\n        revoked: true,\n        cancel: [],\n        leases: [],\n        lost: held.map((job) => job.id),\n        serverTime: now,\n      };\n      return ok(response);\n    }\n\n    await this.#store.touchRunner({\n      runnerId: runner.id,\n      capabilities: request.capabilities,\n      daemonVersion: request.daemonVersion,\n      paused: request.paused,\n      now,\n    });\n\n    const { renewed, lost } = await this.#store.renewLeases({\n      runnerId: runner.id,\n      jobIds: request.activeJobIds,\n      leaseMs: this.#leaseMs,\n      now,\n    });\n\n    const cancel = await this.#store.listCancelRequests(runner.id);\n\n    const response: HeartbeatResponse = {\n      revoked: false,\n      cancel,\n      leases: renewed.map((r) => ({ jobId: r.jobId, expiresAt: r.expiresAt })),\n      lost: [...lost],\n      serverTime: now,\n    };\n    return ok(response);\n  }\n\n  // -- 4. result ------------------------------------------------------------\n\n  async #result(\n    request: ResultRequestType,\n    runner: RunnerRecord,\n  ): Promise<HandlerResult> {\n    if (request.runnerId !== runner.id) {\n      return fail(\"unauthorized\", \"runner id does not match the bearer token\");\n    }\n    const now = this.#now();\n    const job = await this.#store.get(request.jobId);\n    if (!job) return fail(\"not-found\", \"unknown job\");\n\n    // Provenance is built here, from the job's audience and the authenticated\n    // runner — never from anything the daemon asserted\n    // ({@link MUSTS.RESULT_PROVENANCE}).\n    const provenance = provenanceFor({\n      audience: job.audience,\n      runnerId: runner.id,\n      runnerOwner: runner.owner,\n      backendClass: request.backendClass,\n      model: request.model,\n    });\n\n    const { accepted, job: updated } = await this.#store.complete({\n      jobId: request.jobId,\n      runnerId: runner.id,\n      outcome: request.outcome,\n      provenance,\n      now,\n    });\n\n    const response: ResultResponse = {\n      accepted,\n      state: updated?.state ?? job.state,\n    };\n    return ok(response);\n  }\n\n  // -- 5. release -----------------------------------------------------------\n\n  async #release(\n    request: ReleaseRequestType,\n    runner: RunnerRecord,\n  ): Promise<HandlerResult> {\n    if (request.runnerId !== runner.id) {\n      return fail(\"unauthorized\", \"runner id does not match the bearer token\");\n    }\n    const released = await this.#store.release({\n      runnerId: runner.id,\n      jobIds: request.jobIds,\n      reason: request.reason,\n      now: this.#now(),\n    });\n    const response: ReleaseResponse = { released };\n    return ok(response);\n  }\n}\n\n/** The protocol version this build speaks. */\nexport const SERVED_PROTOCOL_VERSION = PROTOCOL_VERSION;\n","import { ENDPOINTS, PROTOCOL_PREFIX, type Endpoint } from \"@byollm/protocol\";\nimport { ByollmHandlers, type HandlerConfig } from \"./handlers.js\";\n\n/**\n * Largest protocol request body accepted, before schema validation.\n *\n * A payload is capped at 4 MB of text by the protocol; this leaves room for\n * JSON overhead and a batch of results, and refuses anything wilder at the\n * door rather than after parsing it.\n */\nconst MAX_BODY_BYTES = 8 * 1024 * 1024;\n\n/** Pull the endpoint name out of a URL path, or null if it isn't ours. */\nexport function routeEndpoint(pathname: string): Endpoint | null {\n  const index = pathname.lastIndexOf(\"/\");\n  const last = index === -1 ? pathname : pathname.slice(index + 1);\n  return (ENDPOINTS as readonly string[]).includes(last)\n    ? (last as Endpoint)\n    : null;\n}\n\n/** Read the bearer token from an `Authorization` header. */\nexport function bearerFrom(header: string | null): string | undefined {\n  if (!header) return undefined;\n  const match = /^Bearer[ ]+(.+)$/i.exec(header.trim());\n  return match?.[1];\n}\n\n/**\n * A `Request` → `Response` handler for the whole protocol.\n *\n * Web-standard types, so this works unchanged in Next.js route handlers, Hono,\n * Bun, Deno, Cloudflare Workers, and anything else that speaks fetch.\n */\nexport function createFetchHandler(\n  config: HandlerConfig,\n): (request: Request) => Promise<Response> {\n  const handlers = new ByollmHandlers(config);\n\n  return async function handle(request: Request): Promise<Response> {\n    if (request.method !== \"POST\") {\n      return json(405, {\n        error: \"bad-request\",\n        message: \"protocol endpoints accept POST only\",\n      });\n    }\n\n    const endpoint = routeEndpoint(new URL(request.url).pathname);\n    if (endpoint === null) {\n      return json(404, {\n        error: \"not-found\",\n        message: `not a ${PROTOCOL_PREFIX} endpoint`,\n      });\n    }\n\n    const declared = request.headers.get(\"content-length\");\n    if (declared !== null && Number(declared) > MAX_BODY_BYTES) {\n      return json(400, {\n        error: \"bad-request\",\n        message: \"request body too large\",\n      });\n    }\n\n    let body: unknown;\n    try {\n      const text = await request.text();\n      if (text.length > MAX_BODY_BYTES) {\n        return json(400, {\n          error: \"bad-request\",\n          message: \"request body too large\",\n        });\n      }\n      body = JSON.parse(text);\n    } catch {\n      // Deliberately not echoing the parse error: it would quote attacker\n      // input back into a response an operator later reads in a terminal.\n      return json(400, {\n        error: \"bad-request\",\n        message: \"request body is not valid JSON\",\n      });\n    }\n\n    const result = await handlers.handle(\n      endpoint,\n      body,\n      bearerFrom(request.headers.get(\"authorization\")),\n    );\n\n    const headers: Record<string, string> = {\n      \"content-type\": \"application/json\",\n      \"cache-control\": \"no-store\",\n    };\n    if (result.retryAfterSeconds !== undefined) {\n      headers[\"retry-after\"] = String(result.retryAfterSeconds);\n    }\n    return new Response(JSON.stringify(result.body), {\n      status: result.status,\n      headers,\n    });\n  };\n}\n\nfunction json(status: number, body: unknown): Response {\n  return new Response(JSON.stringify(body), {\n    status,\n    headers: {\n      \"content-type\": \"application/json\",\n      \"cache-control\": \"no-store\",\n    },\n  });\n}\n"],"mappings":"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","names":["response"]}

package/dist/delivery-36nIe-b3.d.ts

@@ -1,73 +0,0 @@
-import { DeliveredResult } from '@byollm/protocol';
-
-/** Why a wait ended without a result. */
-declare class NoRunnerAvailableError extends Error {
-    readonly jobId: string;
-    readonly reason: string;
-    readonly name = "NoRunnerAvailableError";
-    constructor(jobId: string, reason: string);
-}
-/** The wait exceeded its timeout while a runner was still plausibly working. */
-declare class ResultTimeoutError extends Error {
-    readonly jobId: string;
-    readonly timeoutMs: number;
-    readonly name = "ResultTimeoutError";
-    constructor(jobId: string, timeoutMs: number);
-}
-interface WaitOptions {
-    /** Give up after this long. Default 5 minutes. */
-    readonly timeoutMs?: number;
-    /**
-     * Called instead of throwing when no runner can take the job. Return a
-     * substitute result (a hosted-model answer, say) and the wait resolves with
-     * it; return nothing and {@link NoRunnerAvailableError} is thrown.
-     */
-    readonly onNoRunner?: (reason: string) => DeliveredResult | undefined | Promise<DeliveredResult | undefined>;
-    /** Abort the wait. */
-    readonly signal?: AbortSignal;
-}
-/**
- * How an app learns a job finished.
- *
- * byollm_003 Rev 1 is explicit that this is a *channel* — webhook, Realtime
- * subscription, or poll — and never an implied in-request `await`. The
- * polling implementation below is the portable default; the Supabase adapter
- * substitutes Realtime for the same interface.
- */
-interface ResultDelivery {
-    waitFor(jobId: string, options?: WaitOptions): Promise<DeliveredResult>;
-}
-interface PollingDeliveryDeps {
-    /** Current state of the job, or null if unknown. */
-    readonly read: (jobId: string) => Promise<DeliveredResult | null>;
-    /** Whether a runner could still take this job. */
-    readonly availability: (jobId: string) => Promise<{
-        available: boolean;
-        reason?: string;
-        blocked: boolean;
-    }>;
-    readonly sleep?: (ms: number) => Promise<void>;
-    /**
-     * Injectable clock. It must advance in step with {@link sleep}: a test that
-     * stubs one and not the other gets a loop whose grace window never elapses.
-     */
-    readonly now?: () => number;
-    /**
-     * How long a sustained no-runner signal must persist before it is believed.
-     * Defaults to {@link NO_RUNNER_GRACE_MS}.
-     */
-    readonly graceMs?: number;
-}
-/**
- * The portable delivery channel: poll the store until the job is terminal.
- *
- * Correct everywhere and adequate for most apps. An adapter with a push
- * channel should replace it — see the Supabase adapter's Realtime delivery.
- */
-declare class PollingDelivery implements ResultDelivery {
-    #private;
-    constructor(deps: PollingDeliveryDeps);
-    waitFor(jobId: string, options?: WaitOptions): Promise<DeliveredResult>;
-}
-
-export { NoRunnerAvailableError as N, type PollingDeliveryDeps as P, type ResultDelivery as R, type WaitOptions as W, PollingDelivery as a, ResultTimeoutError as b };