taskchef 8.6.1 → 8.7.0

package/node_modules/unist-util-stringify-position/lib/index.js

@@ -0,0 +1,84 @@
+/**
+ * @typedef {import('unist').Node} Node
+ * @typedef {import('unist').Point} Point
+ * @typedef {import('unist').Position} Position
+ */
+
+/**
+ * @typedef NodeLike
+ * @property {string} type
+ * @property {PositionLike | null | undefined} [position]
+ *
+ * @typedef PointLike
+ * @property {number | null | undefined} [line]
+ * @property {number | null | undefined} [column]
+ * @property {number | null | undefined} [offset]
+ *
+ * @typedef PositionLike
+ * @property {PointLike | null | undefined} [start]
+ * @property {PointLike | null | undefined} [end]
+ */
+
+/**
+ * Serialize the positional info of a point, position (start and end points),
+ * or node.
+ *
+ * @param {Node | NodeLike | Point | PointLike | Position | PositionLike | null | undefined} [value]
+ *   Node, position, or point.
+ * @returns {string}
+ *   Pretty printed positional info of a node (`string`).
+ *
+ *   In the format of a range `ls:cs-le:ce` (when given `node` or `position`)
+ *   or a point `l:c` (when given `point`), where `l` stands for line, `c` for
+ *   column, `s` for `start`, and `e` for end.
+ *   An empty string (`''`) is returned if the given value is neither `node`,
+ *   `position`, nor `point`.
+ */
+export function stringifyPosition(value) {
+  // Nothing.
+  if (!value || typeof value !== 'object') {
+    return ''
+  }
+
+  // Node.
+  if ('position' in value || 'type' in value) {
+    return position(value.position)
+  }
+
+  // Position.
+  if ('start' in value || 'end' in value) {
+    return position(value)
+  }
+
+  // Point.
+  if ('line' in value || 'column' in value) {
+    return point(value)
+  }
+
+  // ?
+  return ''
+}
+
+/**
+ * @param {Point | PointLike | null | undefined} point
+ * @returns {string}
+ */
+function point(point) {
+  return index(point && point.line) + ':' + index(point && point.column)
+}
+
+/**
+ * @param {Position | PositionLike | null | undefined} pos
+ * @returns {string}
+ */
+function position(pos) {
+  return point(pos && pos.start) + '-' + point(pos && pos.end)
+}
+
+/**
+ * @param {number | null | undefined} value
+ * @returns {number}
+ */
+function index(value) {
+  return value && typeof value === 'number' ? value : 1
+}

package/node_modules/unist-util-stringify-position/license

@@ -0,0 +1,22 @@
+(The MIT License)
+
+Copyright (c) 2016 Titus Wormer <tituswormer@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/node_modules/unist-util-stringify-position/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "unist-util-stringify-position",
+  "version": "4.0.0",
+  "description": "unist utility to serialize a node, position, or point as a human readable location",
+  "license": "MIT",
+  "keywords": [
+    "unist",
+    "unist-util",
+    "util",
+    "utility",
+    "position",
+    "location",
+    "point",
+    "node",
+    "stringify",
+    "tostring"
+  ],
+  "repository": "syntax-tree/unist-util-stringify-position",
+  "bugs": "https://github.com/syntax-tree/unist-util-stringify-position/issues",
+  "funding": {
+    "type": "opencollective",
+    "url": "https://opencollective.com/unified"
+  },
+  "author": "Titus Wormer <tituswormer@gmail.com> (https://wooorm.com)",
+  "contributors": [
+    "Titus Wormer <tituswormer@gmail.com> (https://wooorm.com)"
+  ],
+  "sideEffects": false,
+  "type": "module",
+  "exports": "./index.js",
+  "files": [
+    "lib/",
+    "index.d.ts",
+    "index.js"
+  ],
+  "dependencies": {
+    "@types/unist": "^3.0.0"
+  },
+  "devDependencies": {
+    "@types/mdast": "^4.0.0",
+    "@types/node": "^20.0.0",
+    "c8": "^8.0.0",
+    "prettier": "^2.0.0",
+    "remark-cli": "^11.0.0",
+    "remark-preset-wooorm": "^9.0.0",
+    "type-coverage": "^2.0.0",
+    "typescript": "^5.0.0",
+    "xo": "^0.54.0"
+  },
+  "scripts": {
+    "prepack": "npm run build && npm run format",
+    "build": "tsc --build --clean && tsc --build && type-coverage",
+    "format": "remark . -qfo && prettier . -w --loglevel warn && xo --fix",
+    "test-api": "node --conditions development test.js",
+    "test-coverage": "c8 --100 --reporter lcov npm run test-api",
+    "test": "npm run build && npm run format && npm run test-coverage"
+  },
+  "prettier": {
+    "bracketSpacing": false,
+    "semi": false,
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "none",
+    "useTabs": false
+  },
+  "remarkConfig": {
+    "plugins": [
+      "remark-preset-wooorm"
+    ]
+  },
+  "typeCoverage": {
+    "atLeast": 100,
+    "detail": true,
+    "ignoreCatch": true,
+    "strict": true
+  },
+  "xo": {
+    "prettier": true
+  }
+}

package/node_modules/unist-util-stringify-position/readme.md

@@ -0,0 +1,206 @@
+# unist-util-stringify-position
+
+[![Build][build-badge]][build]
+[![Coverage][coverage-badge]][coverage]
+[![Downloads][downloads-badge]][downloads]
+[![Size][size-badge]][size]
+[![Sponsors][sponsors-badge]][collective]
+[![Backers][backers-badge]][collective]
+[![Chat][chat-badge]][chat]
+
+[unist][] utility to pretty print the positional info of a node.
+
+## Contents
+
+*   [What is this?](#what-is-this)
+*   [When should I use this?](#when-should-i-use-this)
+*   [Install](#install)
+*   [Use](#use)
+*   [API](#api)
+    *   [`stringifyPosition(node|position|point)`](#stringifypositionnodepositionpoint)
+*   [Types](#types)
+*   [Compatibility](#compatibility)
+*   [Security](#security)
+*   [Related](#related)
+*   [Contribute](#contribute)
+*   [License](#license)
+
+## What is this?
+
+This package is a utility that takes any [unist][] (whether mdast, hast, etc)
+node, position, or point, and serializes its positional info.
+
+## When should I use this?
+
+This utility is useful to display where something occurred in the original
+document, in one standard way, for humans.
+For example, when throwing errors or warning messages about something.
+
+## Install
+
+This package is [ESM only][esm].
+In Node.js (version 16+), install with [npm][]:
+
+```sh
+npm install unist-util-stringify-position
+```
+
+In Deno with [`esm.sh`][esmsh]:
+
+```js
+import {stringifyPosition} from 'https://esm.sh/unist-util-stringify-position@4'
+```
+
+In browsers with [`esm.sh`][esmsh]:
+
+```html
+<script type="module">
+  import {stringifyPosition} from 'https://esm.sh/unist-util-stringify-position@4?bundle'
+</script>
+```
+
+## Use
+
+```js
+import {stringifyPosition} from 'unist-util-stringify-position'
+
+stringifyPosition({line: 2, column: 3}) // => '2:3' (point)
+stringifyPosition({start: {line: 2}, end: {line: 3}}) // => '2:1-3:1' (position)
+stringifyPosition({
+  type: 'text',
+  value: '!',
+  position: {
+    start: {line: 5, column: 11},
+    end: {line: 5, column: 12}
+  }
+}) // => '5:11-5:12' (node)
+```
+
+## API
+
+This package exports the identifier [`stringifyPosition`][stringifyposition].
+There is no default export.
+
+### `stringifyPosition(node|position|point)`
+
+Serialize the positional info of a point, position (start and end points), or
+node.
+
+###### Parameters
+
+*   `node` ([`Node`][node])
+    — node whose `position` fields to serialize
+*   `position` ([`Position`][position])
+    — position whose `start` and `end` points to serialize
+*   `point` ([`Point`][point])
+    — point whose `line` and `column` fields to serialize
+
+###### Returns
+
+Pretty printed positional info of a node (`string`).
+
+In the format of a range `ls:cs-le:ce` (when given `node` or `position`) or a
+point `l:c` (when given `point`), where `l` stands for line, `c` for column, `s`
+for `start`, and `e` for end.
+An empty string (`''`) is returned if the given value is neither `node`,
+`position`, nor `point`.
+
+## Types
+
+This package is fully typed with [TypeScript][].
+It exports no additional types.
+
+## Compatibility
+
+Projects maintained by the unified collective are compatible with maintained
+versions of Node.js.
+
+When we cut a new major release, we drop support for unmaintained versions of
+Node.
+This means we try to keep the current release line,
+`unist-util-stringify-position@^4`, compatible with Node.js 16.
+
+## Security
+
+This project is safe.
+
+## Related
+
+*   [`unist-util-generated`](https://github.com/syntax-tree/unist-util-generated)
+    — check if a node is generated
+*   [`unist-util-position`](https://github.com/syntax-tree/unist-util-position)
+    — get positional info of nodes
+*   [`unist-util-remove-position`](https://github.com/syntax-tree/unist-util-remove-position)
+    — remove positional info from trees
+*   [`unist-util-source`](https://github.com/syntax-tree/unist-util-source)
+    — get the source of a value (node or position) in a file
+
+## Contribute
+
+See [`contributing.md` in `syntax-tree/.github`][contributing] for ways to get
+started.
+See [`support.md`][support] for ways to get help.
+
+This project has a [code of conduct][coc].
+By interacting with this repository, organization, or community you agree to
+abide by its terms.
+
+## License
+
+[MIT][license] © [Titus Wormer][author]
+
+<!-- Definition -->
+
+[build-badge]: https://github.com/syntax-tree/unist-util-stringify-position/workflows/main/badge.svg
+
+[build]: https://github.com/syntax-tree/unist-util-stringify-position/actions
+
+[coverage-badge]: https://img.shields.io/codecov/c/github/syntax-tree/unist-util-stringify-position.svg
+
+[coverage]: https://codecov.io/github/syntax-tree/unist-util-stringify-position
+
+[downloads-badge]: https://img.shields.io/npm/dm/unist-util-stringify-position.svg
+
+[downloads]: https://www.npmjs.com/package/unist-util-stringify-position
+
+[size-badge]: https://img.shields.io/badge/dynamic/json?label=minzipped%20size&query=$.size.compressedSize&url=https://deno.bundlejs.com/?q=unist-util-stringify-position
+
+[size]: https://bundlejs.com/?q=unist-util-stringify-position
+
+[sponsors-badge]: https://opencollective.com/unified/sponsors/badge.svg
+
+[backers-badge]: https://opencollective.com/unified/backers/badge.svg
+
+[collective]: https://opencollective.com/unified
+
+[chat-badge]: https://img.shields.io/badge/chat-discussions-success.svg
+
+[chat]: https://github.com/syntax-tree/unist/discussions
+
+[npm]: https://docs.npmjs.com/cli/install
+
+[license]: license
+
+[author]: https://wooorm.com
+
+[esm]: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c
+
+[esmsh]: https://esm.sh
+
+[typescript]: https://www.typescriptlang.org
+
+[contributing]: https://github.com/syntax-tree/.github/blob/main/contributing.md
+
+[support]: https://github.com/syntax-tree/.github/blob/main/support.md
+
+[coc]: https://github.com/syntax-tree/.github/blob/main/code-of-conduct.md
+
+[unist]: https://github.com/syntax-tree/unist
+
+[node]: https://github.com/syntax-tree/unist#node
+
+[position]: https://github.com/syntax-tree/unist#position
+
+[point]: https://github.com/syntax-tree/unist#point
+
+[stringifyposition]: #stringifypositionnodepositionpoint

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taskchef",
-  "version": "8.6.1",
+  "version": "8.7.0",
   "description": "A non-blocking interactive dispatcher for visible Codex tasks.",
   "license": "Apache-2.0",
   "author": "Favo Yang",
@@ -29,8 +29,16 @@
     "docs/dashboard-lifecycle.md",
     "docs/dashboard-ui.md",
     "docs/mcp-app.md",
+    "docs/taskchef-next-storage.md",
+    "docs/diagrams/taskchef-next-storage.drawio",
+    "docs/diagrams/taskchef-next-storage.drawio.png",
+    "docs/diagrams/taskchef-next-reply-lookup.drawio",
+    "docs/diagrams/taskchef-next-reply-lookup.drawio.png",
+    "docs/taskchef-next-status-research.md",
     "docs/firstmate-taskchef-comparison.md",
     "docs/images/dashboard-identity.jpg",
+    "docs/images/taskchef-unified-status-popup.jpg",
+    "docs/images/taskchef-pr-icon-comparison.jpg",
     "docs/images/ccusage-token-consumption.png",
     "docs/images/notification-event-snapshots.jpg",
     "docs/images/result-history-dashboard.jpg",
@@ -53,7 +61,9 @@
     "skills/taskchef-dashboard",
     "skills/taskchef-delegate",
     "skills/taskchef-executor",
-    "skills/taskchef-copilot"
+    "skills/taskchef-copilot",
+    "docs/taskchef-next-github.md",
+    "scripts/prepare-github-keyring.js"
   ],
   "engines": {
     "node": ">=18"
@@ -81,30 +91,39 @@
     "benchmark:e2e": "node scripts/e2e-benchmark.js",
     "build:dashboard": "vite build --config vite.config.ts",
     "build:mcp-app": "vite build --config vite.mcp-app.config.ts",
+    "update:mcp-app-preview": "npm run build:mcp-app && node scripts/update-mcp-app-preview.js",
     "check:dashboard": "tsc --noEmit -p tsconfig.dashboard.json",
     "check:mcp-app": "tsc --noEmit -p tsconfig.mcp-app.json",
     "preview:dashboard": "node scripts/preview-dashboard.js",
     "test": "npm run test:node && npm run test:dashboard",
     "test:node": "node --test tests/*.test.js",
-    "test:dashboard": "vitest run --config vitest.config.ts"
+    "test:dashboard": "vitest run --config vitest.config.ts",
+    "prepack": "node scripts/prepare-github-keyring.js"
   },
   "dependencies": {
     "@mantine/core": "9.5.2",
     "@mantine/hooks": "9.5.2",
     "@mantine/notifications": "9.5.2",
     "@modelcontextprotocol/sdk": "^1.30.0",
+    "@napi-rs/keyring": "2.1.0",
     "@tabler/icons-react": "3.35.0",
+    "mdast-util-from-markdown": "2.0.2",
+    "micromark-util-sanitize-uri": "2.0.1",
     "proper-lockfile": "^4.1.2",
     "react": "19.2.0",
     "react-dom": "19.2.0",
+    "react-markdown": "10.1.0",
+    "remark-gfm": "4.0.1",
+    "smol-toml": "^1.9.0",
     "zod": "^4.4.3"
   },
   "bundleDependencies": [
     "@modelcontextprotocol/sdk",
     "proper-lockfile",
-    "zod"
-  ],
-  "optionalDependencies": {
-    "ccusage": "20.0.24"
-  }
+    "smol-toml",
+    "zod",
+    "mdast-util-from-markdown",
+    "@napi-rs/keyring",
+    "micromark-util-sanitize-uri"
+  ]
 }

package/scripts/prepare-github-keyring.js

@@ -0,0 +1,29 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { cp, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+// Codex extracts bundled plugins without installing platform-specific dependencies.
+// The release package must include native credential-store bindings for each desktop target.
+const root = fileURLToPath(new URL("../", import.meta.url));
+const targets = ["darwin-arm64", "darwin-x64", "win32-arm64-msvc", "win32-x64-msvc", "linux-arm64-gnu", "linux-arm64-musl", "linux-x64-gnu", "linux-x64-musl"];
+const version = JSON.parse(await readFile(join(root, "package.json"), "utf8")).dependencies["@napi-rs/keyring"];
+if (!/^\d+\.\d+\.\d+$/.test(version)) throw new Error("Keyring must have an exact release version.");
+const npmCli = process.env.npm_execpath;
+if (!npmCli) throw new Error("Run this packaging step through npm run prepack.");
+const temporary = await mkdtemp(join(tmpdir(), "taskchef-keyring-package-"));
+try {
+  await writeFile(join(temporary, "package.json"), JSON.stringify({ private: true }));
+  await promisify(execFile)(process.execPath, [npmCli,
+    "install", "--prefix", temporary, "--cache", join(temporary, "cache"),
+    "--registry", "https://registry.npmjs.org", "--force", "--dry-run=false", "--global=false", "--package-lock=false", "--ignore-scripts", "--no-save", "--no-audit", "--no-fund",
+    ...targets.map((target) => `@napi-rs/keyring-${target}@${version}`),
+  ], { timeout: 120_000, maxBuffer: 1024 * 1024 });
+  for (const target of targets) {
+    const name = `@napi-rs/keyring-${target}`;
+    await cp(join(temporary, "node_modules", name), join(root, "node_modules", name), { recursive: true });
+  }
+  console.error("Bundled GitHub credential-store bindings for macOS, Windows, and Linux.");
+} finally { await rm(temporary, { recursive: true, force: true }); }

package/skills/taskchef-delegate/SKILL.md

@@ -81,6 +81,11 @@ reloaded or installed.
 
 5. Before creating each executor, call `record_task` exactly once with `id`,
    `project`, `title`, the exact marked `instruction`, and `threadId: null`.
+   Pass the selected configured project's canonical `path` as `project`, not
+   its name, label, or native project ID. Require a successful tool result
+   whose returned `task.id` equals the prepared task ID before native creation.
+   If recording fails or cannot be confirmed, report the failure and stop;
+   do not create an executor with an unrecorded task marker.
 6. Create one real Codex task using the exact configured project, an appropriate
    native environment, the marked instruction, a short title, and the resolved
    orchestrator model and effort overrides when present.

package/src/codex-app.js

@@ -153,9 +153,28 @@ export async function openThreadInCodex(threadId, options = {}) {
   if (!isCodexThreadDeepLinkId(threadId)) {
     throw new Error("Codex thread ID is not supported by the desktop deep link");
   }
+  const url = `codex://threads/${encodeURIComponent(threadId)}`;
+  await openDesktopLink(url, options);
+  return { status: "requested", mechanism: "codex-deep-link", threadId, url };
+}
+
+export async function openPluginSettingsInCodex(url, options = {}) {
+  if (typeof url !== "string") throw new Error("Cannot resolve the installed plugin settings page. Open TaskChef from Plugins.");
+  const link = new URL(url);
+  if (link.protocol !== "codex:" || link.hostname !== "plugins" || !/^\/[^/]+$/.test(link.pathname)
+    || link.username || link.password || link.port || link.hash
+    || [...link.searchParams.keys()].some((key) => key !== "marketplacePath")
+    || link.searchParams.getAll("marketplacePath").length !== 1
+    || !path.isAbsolute(link.searchParams.get("marketplacePath"))) {
+    throw new Error("Cannot resolve the installed plugin settings page. Open TaskChef from Plugins.");
+  }
+  await openDesktopLink(url, options);
+  return { status: "requested", mechanism: "codex-deep-link", url };
+}
+
+async function openDesktopLink(url, options) {
   const run = options.run ?? execFile;
   const platform = options.platform ?? process.platform;
-  const url = `codex://threads/${encodeURIComponent(threadId)}`;
   if (platform === "darwin") {
     await runCodex(run, "/usr/bin/open", [url]);
   } else if (platform === "win32") {
@@ -163,7 +182,6 @@ export async function openThreadInCodex(threadId, options = {}) {
   } else {
     await runCodex(run, "xdg-open", [url]);
   }
-  return { status: "requested", mechanism: "codex-deep-link", threadId, url };
 }
 
 export async function archiveThreadInCodex(threadId, options = {}) {

package/src/codex-pricing.js

@@ -0,0 +1,79 @@
+import { migrateCache } from "./next-cache.js";
+import { readFile, mkdir } from "node:fs/promises";
+import { dirname } from "node:path";
+import { writeDurableAtomic } from "./state-store.js";
+
+export const PRICING_URL = "https://developers.openai.com/api/docs/pricing.md";
+const WEEK = 7 * 24 * 60 * 60_000;
+
+// Read only the explicitly labelled standard table. Never use batch/fast rates
+// as the default or invent a price for an unknown model.
+export function parsePricing(markdown) {
+  const section = markdown.split("### Standard pricing data\n")[1]?.split(/\n### |\nBatch\n/)[0];
+  if (!section) throw new Error("Standard pricing table is missing.");
+  const models = {};
+  for (const line of section.split("\n")) {
+    const cells = line.split("|").slice(1, -1).map(value => value.trim());
+    if (cells.length !== 9 || !/^(gpt-|o[134])/.test(cells[0])) continue;
+    const name = cells[0].replace(/ \(<272K context length\)$/, "");
+    const values = cells.slice(1).map(value => value === "-" ? null : /^\$\d+(?:\.\d+)?$/.test(value) ? Number(value.slice(1)) : NaN);
+    if (values.some(value => value !== null && !Number.isFinite(value)) || values[0] === null || values[3] === null) continue;
+    models[name] = { short: values.slice(0, 4), long: values.slice(4) };
+  }
+  if (!models["gpt-6.1-sol"] || !models["gpt-6-luna"]) throw new Error("Pricing table is incomplete.");
+  return models;
+}
+
+export function estimateCallCost(usage, model, models) {
+  const rates = models[model]?.[usage.input_tokens > 272_000 ? "long" : "short"];
+  if (!rates) return null;
+  const cached = usage.cached_input_tokens;
+  const writes = usage.cache_write_input_tokens;
+  const tokens = [usage.input_tokens - cached - writes, cached, writes, usage.output_tokens];
+  if (tokens.some((count, i) => count < 0 || (count > 0 && rates[i] == null))) return null;
+  // Reasoning output is already included in output_tokens.
+  return tokens.reduce((sum, count, i) => sum + count * (rates[i] ?? 0) / 1_000_000, 0);
+}
+
+export class CodexPricing {
+  constructor({ cachePath, legacyCachePath, now = Date.now, fetchImpl = globalThis.fetch } = {}) {
+    this.cachePath = cachePath; this.legacyCachePath = legacyCachePath; this.now = now; this.fetch = fetchImpl;
+    this.pending = null; this.nextCheck = 0;
+  }
+  async get({ refresh = true } = {}) {
+    this.loading ??= this.load();
+    await this.loading;
+    if (refresh && !this.pending && this.now() >= this.nextCheck) {
+      this.nextCheck = this.now() + WEEK;
+      this.pending = this.update().catch(() => { this.nextCheck = this.now() + 60 * 60_000; }).finally(() => { this.pending = null; });
+    }
+    return this.table;
+  }
+  async load() {
+    this.table = JSON.parse(await readFile(new URL("./data/codex-pricing.json", import.meta.url), "utf8"));
+    if (!this.cachePath) return;
+    try {
+      await migrateCache(this.legacyCachePath, this.cachePath);
+      const cached = JSON.parse(await readFile(this.cachePath, "utf8"));
+      // Validate cached content with the same parser used for the live source.
+      const models = parsePricing(cached.markdown);
+      if (Number.isFinite(cached.checkedAt) && cached.checkedAt <= this.now()) {
+        this.table = { date: new Date(cached.checkedAt).toISOString().slice(0, 10), models };
+        this.nextCheck = cached.checkedAt + WEEK;
+      }
+    } catch { /* The bundled table remains available offline. */ }
+  }
+  async update() {
+    const response = await this.fetch(PRICING_URL, { signal: AbortSignal.timeout(5000), redirect: "error" });
+    if (!response.ok) throw new Error("Pricing update failed.");
+    const markdown = await response.text();
+    if (markdown.length > 1_000_000) throw new Error("Pricing response is too large.");
+    const models = parsePricing(markdown);
+    const checkedAt = this.now();
+    if (this.cachePath) {
+      await mkdir(dirname(this.cachePath), { recursive: true, mode: 0o700 });
+      await writeDurableAtomic(this.cachePath, JSON.stringify({ markdown, checkedAt }) + "\n");
+    }
+    this.table = { date: new Date(checkedAt).toISOString().slice(0, 10), models };
+  }
+}