@cyanheads/hn-mcp-server 0.6.0 → 0.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cyanheads/hn-mcp-server",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Browse Hacker News feeds, threads, and user profiles with full-text search via MCP. STDIO or Streamable HTTP.",
   "type": "module",
   "main": "dist/index.js",
@@ -79,7 +79,7 @@
     }
   ],
   "engines": {
-    "bun": ">=1.4.0",
+    "bun": ">=1.4.4",
     "node": ">=24.0.0"
   },
   "packageManager": "bun@1.4.4",
@@ -87,19 +87,19 @@
     "access": "public"
   },
   "dependencies": {
-    "@cyanheads/mcp-ts-core": "^0.13.18",
+    "@cyanheads/mcp-ts-core": "^0.13.22",
     "pino-pretty": "^13.2.0",
     "zod": "^4.6.7"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.6.3",
+    "@biomejs/biome": "^2.6.7",
     "@socketsecurity/bun-security-scanner": "^1.1.3",
-    "@types/node": "^26.6.5",
-    "@vitest/coverage-istanbul": "^5.0.5",
+    "@types/node": "^26.6.6",
+    "@vitest/coverage-istanbul": "^5.1.0",
     "depcheck": "^1.4.7",
     "ignore": "^7.0.14",
-    "tsc-alias": "^1.9.9",
+    "tsc-alias": "^1.9.10",
     "typescript": "^7.0.2",
-    "vitest": "^5.0.5"
+    "vitest": "^5.1.0"
   }
 }

package/server.json

@@ -6,7 +6,7 @@
     "url": "https://github.com/cyanheads/hn-mcp-server",
     "source": "github"
   },
-  "version": "0.6.0",
+  "version": "0.7.0",
   "remotes": [
     {
       "type": "streamable-http",
@@ -19,7 +19,7 @@
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@cyanheads/hn-mcp-server",
       "runtimeHint": "npx",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "environmentVariables": [
         {
           "name": "HN_CONCURRENCY_LIMIT",
@@ -45,7 +45,7 @@
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@cyanheads/hn-mcp-server",
       "runtimeHint": "npx",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "environmentVariables": [
         {
           "name": "MCP_TRANSPORT_TYPE",

package/skills/hn-guide/SKILL.md

@@ -4,7 +4,7 @@ description: Find the Hacker News thread behind a link, search topics without Al
 license: Apache-2.0
 metadata:
   author: cyanheads
-  version: "1.0"
+  version: "1.2"
 ---
 
 ## Scope
@@ -17,21 +17,21 @@ Hacker News, read-only and keyless: live feeds, items, and profiles from HN's Fi
 |:--|:--|
 | A story's whole discussion | a feed story's or story hit's `id`; a comment hit's `storyId`; a comment root's `item.storyId` from `hn_get_thread` |
 | One comment and its replies | the comment's `id`, from a search hit, a thread page, or a user's submissions |
-| What a comment replied to | `parent` on a `hn_get_thread` comment root or a `hn_get_user` submission; search hits carry no parent |
+| What a comment replied to | `parent` on a `hn_get_thread` comment root or a `hn_get_user` submission; `parentId` on a comment search hit (its story's id for a top-level comment, otherwise the parent comment's id), and `storyUrl` when that story links out |
 | A user | a `by` or `author` field, copied exactly |
 
-Usernames match case-sensitively on every tool: `Animats` exists, while `animats` answers `user_not_found` and empties an author-filtered search. When the name came from the user rather than a field, confirm it with `hn_get_user`; on `user_not_found`, keyword-search the name (text search ignores case) and read the `author` of the hits that differ from it only in case.
+Usernames match case-sensitively on every tool: `Animats` exists, while `animats` answers `user_not_found` and empties an author-filtered search. When the name came from the user rather than a field, confirm it with `hn_get_user` (a leading `@` is dropped, a name with spaces is rejected as a display name); on `user_not_found`, keyword-search the name (text search ignores case) and read the `author` of the hits that differ from it only in case.
 
 ## Gates
 
 - **Find a link's thread with a story search.** A URL query searches comment text too, and comments that paste the link crowd out the submission: for `https://paulgraham.com/greatwork.html` the first six hits were all comments. Search it with the story type. One URL is often submitted many times, each a separate thread: that essay has about 11 story submissions, from 1,008 points and 432 comments down to reposts with a handful of points. Take the one with the most comments, or read several when the question is about reception over time.
-- **Quote a term to match it exactly.** Algolia's keyword matching is typo-tolerant and matches the last term as a prefix: `kubernetse` returns Kubernetes stories, and `zig` matches "Zigbee". Wrap a term in double quotes to match only that word, and put `-` before a word to exclude it. October 2026 stories for `zig` number "about 617"; for `"zig"`, exactly 28, and `"zig" -devlog` 27. The `<em>` span in `highlights.title` and `highlights.text` shows what actually matched; `highlights.text` is absent under the compact view and when `highlightsTextOmitted` is true, so read `highlights.title` and `matchedWords` there.
+- **Quote a term to match it exactly.** Algolia's keyword matching is typo-tolerant and matches the last term as a prefix: `kubernetse` returns Kubernetes stories, and `zig` matches "Zigbee". Wrap a term in double quotes to match only that word, and put `-` before a word to exclude it. October 2026 stories for `zig` number "about 595"; for `"zig"`, exactly 31, and `"zig" -devlog` 30. The `<em>` span in `highlights.title` and `highlights.text` shows what actually matched; `highlights.text` is absent under the compact view and on any body Algolia left unhighlighted, which does not mean the body lacks the term. Read `highlights.title` and `matchedWords` where present; on a hit Algolia left unhighlighted `matchedWords` is absent too, so read the body `text` (`view: "full"`).
 - **An estimate is not a count.** Report `totalHits` as a number only when `totalHitsExact` is true, and as "about N" otherwise. An unquoted estimate also counts the fuzzy matches: `rust` by one author is "about 1,633" with off-topic comments among the newest hits, `"rust"` an exact 906.
-- **Relevance is not popularity.** With a query, title matches outrank body-only matches whatever their score: a 57-point story that mentions `"zig"` only in its text ranked below 1-point title matches. For the biggest stories on a topic, set a points floor, or rank the hits by `points` or `numComments` yourself.
-- **One thread page is not the thread.** `hn_get_thread` walks breadth-first, so on a large story the default page holds only top-level comments: 50 of 544, every one at depth 0, no replies. Before summarizing a discussion, either follow `nextCursor` until it is absent, or drill into the first top-level comments: each comment's id as `itemId`, with a deeper depth, returns its subtree (one top-level comment returned 23 live replies over four levels in a single call). A story's thread is complete when the comments loaded across pages reach `totalAvailable`. A comment root reports no `totalAvailable`; its subtree is complete when `truncated` is absent.
+- **Relevance is not popularity.** With a query, title matches outrank body-only matches whatever their score: a 57-point story that mentions `"zig"` only in its text ranked below 1-point title matches. For the biggest stories on a topic, set a `minPoints` floor; for the most discussed, a `minComments` floor. Both filter rather than sort, so order the survivors by `points` or `numComments` yourself, and both drop comments and jobs (`minComments` drops poll options too, which carry votes but no comment count) and are rejected with `tags: "comment"` or `"job"`.
+- **One thread page is not the thread.** `hn_get_thread` walks breadth-first, so on a large story the default page holds only top-level comments: 25 of 544, every one at depth 0, no replies. Before summarizing a discussion, either follow `nextCursor` until it is absent, or drill into the first top-level comments: each comment's id as `itemId`, with a deeper depth, returns its subtree (one top-level comment returned 23 live replies over four levels in a single call). A story's thread is complete when the comments loaded across pages reach `totalAvailable`. A comment root reports no `totalAvailable`; its subtree is complete when `truncated` is absent.
 - **Comments have no scores.** HN exposes no comment votes: thread comments carry no `score` and comment hits no `points`. "Top comments" are the first top-level comments `hn_get_thread` returns, in HN's ranking order. Never call one the most upvoted.
-- **Feed order is HN's rank, not score.** `hn_get_stories` returns a feed in ranking order: on the top feed a 66-point story sat fifth, above a 1,137-point one. The `front_page` search tag returns the same 30 stories sorted by points instead. "Most discussed" is the highest `descendants` (feeds, threads) or `numComments` (search), and it often disagrees with score: 534 comments on a 387-point story, 364 on the 1,137-point one.
-- **Hiring threads are not the jobs feed.** The `jobs` feed and the `job` type hold YC company job ads, scored 1 with no comments. The monthly "Ask HN: Who is hiring?" and "Ask HN: Who wants to be hired?" threads are stories posted on the 1st by the user `whoishiring`, and each posting is a top-level comment. Find the month's thread with an author search for `whoishiring` sorted by date; list its postings with `hn_get_thread` at depth 1, or search them with a comment search scoped to its `storyId` (`remote rust`).
+- **Feed order is HN's rank, not score.** `hn_get_stories` returns a feed in ranking order: on the top feed a 66-point story sat fifth, above a 1,137-point one. The `front_page` search tag returns the same 30 stories sorted by points instead. "Most discussed" is the highest `descendants` (feeds, threads) or `numComments` (search), and it often disagrees with score: 534 comments on a 387-point story, 364 on the 1,137-point one. In a search window, `minComments` with the story type drops the lightly discussed stories before you rank; it does not sort.
+- **Hiring threads are not the jobs feed.** The `jobs` feed and the `job` type hold YC company job ads, scored 1 with no comments. The monthly "Ask HN: Who is hiring?" and "Ask HN: Who wants to be hired?" threads are stories posted by the user `whoishiring` on the month's first weekday, except January, when they went up on the 2nd in both 2025 and 2026 (in 14 of the 25 months from November 2024 to November 2026, that was the 1st), and each posting is a top-level comment. Find the month's thread with an author search for `whoishiring` and a `dateRange` from the last day of the previous month to the 5th, never the 1st alone, with the title in `query` to tell the two threads apart; list its postings with `hn_get_thread` at depth 1, or search them with a comment search scoped to its `storyId` (`remote rust`).
 - **A user's submissions are everything they posted.** `hn_get_user` returns every item type, newest first, with no topic filter, so an active user's page is mostly comments. For what a user said about a topic, search with the author filter and a quoted term, sorted by date for their recent views; each comment hit's `storyTitle` names the thread it was posted in.
 
 ## Workflows

package/dist/mcp-server/tools/response-budget.d.ts

@@ -1,111 +0,0 @@
-/**
- * @fileoverview The fixed byte budget a page-returning tool holds each response
- * surface to, and the arithmetic that keeps a page within it: measure both
- * surfaces as the caller receives them — whole, or as a page plus the
- * enrichment the framework adds — then either cut the longest bodies to the
- * largest byte limit they can share, on a code-point boundary, or serve the
- * longest prefix of the page that fits. The tool decides what is cuttable or
- * droppable and how the cut is disclosed.
- * @module mcp-server/tools/response-budget
- */
-/** Bytes each surface may carry: all `content[]` text, the enrichment trailer included, and the `structuredContent` JSON. */
-export declare const RESPONSE_BUDGET_BYTES = 64000;
-/** {@link RESPONSE_BUDGET_BYTES} as the descriptions and notices write it. */
-export declare const RESPONSE_BUDGET_TEXT: string;
-/** The line `content[]` puts after a body cut to the budget, outside its quote. */
-export declare const cutPointer: (id: number) => string;
-/** UTF-8 length of `text`. */
-export declare function byteLength(text: string): number;
-/**
- * The longest prefix of `text` within `maxBytes` UTF-8 bytes. It ends on a
- * code-point boundary: a character that would straddle the limit, a surrogate
- * pair included, is left out whole.
- */
-export declare function cutToBytes(text: string, maxBytes: number): string;
-/** A response as the handler is about to return it. */
-export interface ResponseDraft {
-    /** The blocks the definition's `format()` renders for `result`. */
-    content: readonly {
-        type: string;
-        text?: string;
-    }[];
-    /** Every enrichment field the call writes, `notice` included, as the framework will hold them. */
-    enrichment: Readonly<Record<string, unknown>>;
-    /** The handler's return value. */
-    result: Readonly<Record<string, unknown>>;
-    /** The definition's `enrichmentTrailer`. */
-    trailer?: Readonly<Record<string, {
-        label?: string;
-        render?: (value: never) => string;
-    } | undefined>> | undefined;
-}
-/** A response's size on each surface. */
-export interface ResponseBytes {
-    contentBytes: number;
-    structuredBytes: number;
-}
-/**
- * The bytes the framework adds to each surface for `enrichment`: its
- * `content[]` trailer, and the `"key":value` members it merges into the
- * `structuredContent` object, each with the comma before it. Exact for a
- * result that serializes with at least one member and shares no key with the
- * enrichment. A tool that sizes its page as it builds it adds this to the
- * page's own bytes; {@link measureResponse} does the same for a whole draft.
- *
- * @throws TypeError for a string or object field with no `render`, as
- * {@link measureResponse} does.
- */
-export declare function enrichmentBytes(enrichment: ResponseDraft['enrichment'], trailer?: ResponseDraft['trailer']): ResponseBytes;
-/**
- * Size a response on both surfaces as the caller receives it: every `content[]`
- * text block plus the enrichment trailer the framework appends, and the
- * `structuredContent` JSON — the handler's return merged with its enrichment,
- * which shares none of the return's keys.
- */
-export declare function measureResponse(draft: ResponseDraft): ResponseBytes;
-/** True when both surfaces are within {@link RESPONSE_BUDGET_BYTES}. */
-export declare function fitsBudget(bytes: ResponseBytes): boolean;
-/**
- * The largest byte limit at which the page fits the budget when every body
- * longer than the limit is cut to it and every other body stays whole.
- *
- * Every body reaches each surface at least once, whole or cut, so a page cut
- * at a limit carries at least the bodies' bytes at that limit on each surface.
- * No limit whose body bytes alone exceed the budget can fit, and none is
- * measured: every page `measure` renders is within the budget in body bytes,
- * however long the bodies are.
- *
- * A page's size is not monotone in the limit: raising it to a body's length
- * returns that body whole, which drops its cut disclosure, so a page can fit at
- * a body's length and not one byte below. The limits are therefore searched as
- * cut sets — the longest body alone, then the two longest — each tried at its
- * lowest limit, where it cuts its bodies furthest. The answer is the first set
- * that fits there, bisected within, where the size does grow with the limit.
- * The first set the body bytes allow is measured, then the last; between them
- * the sets are bisected, on the assumption that once one set fits every larger
- * one does — where an earlier set also fits, a smaller limit is served. That is
- * at most two measurements plus a bisection over the sets and one within.
- *
- * @param bodyBytes UTF-8 length of each cuttable body; 0 for an item without
- *   one. Each body must reach both surfaces, at least once, cut or whole.
- * @param measure Both surfaces with every body longer than `limitBytes` cut to
- *   it. With the same bodies cut, a larger limit must never measure smaller.
- * @returns 0 when even cutting every body to nothing leaves the page over
- *   budget — the smallest page cutting can make.
- */
-export declare function largestFittingLimit(bodyBytes: readonly number[], measure: (limitBytes: number) => ResponseBytes): number;
-/**
- * Which of a page's `count` prefixes to serve: the longest that fits the
- * budget, or the first — the shortest the caller allows, served even over
- * budget — when none does.
- *
- * Prefixes are measured from the longest down, each at most once and the first
- * never. A prefix's overflow says nothing about a shorter one: what a response
- * adds beyond its page, such as a cursor of the entries still unread, can shrink
- * as the page shortens as well as grow.
- *
- * @param measure The whole response serving prefix `index`.
- * @returns The index of the prefix to serve.
- */
-export declare function longestFittingPrefix(count: number, measure: (index: number) => ResponseBytes): number;
-//# sourceMappingURL=response-budget.d.ts.map

package/dist/mcp-server/tools/response-budget.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"response-budget.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/response-budget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,6HAA6H;AAC7H,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAE5C,8EAA8E;AAC9E,eAAO,MAAM,oBAAoB,QAAgD,CAAC;AAElF,mFAAmF;AACnF,eAAO,MAAM,UAAU,OAAQ,MAAM,WAC4D,CAAC;AAIlG,8BAA8B;AAC9B,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIjE;AAED,uDAAuD;AACvD,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,OAAO,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACpD,kGAAkG;IAClG,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9C,kCAAkC;IAClC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1C,4CAA4C;IAC5C,OAAO,CAAC,EACJ,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC,CAAC,GAC3F,SAAS,CAAC;CACf;AAED,yCAAyC;AACzC,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CACzB;AAqCD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,aAAa,CAAC,YAAY,CAAC,EACvC,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,GACjC,aAAa,CASf;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa,CAUnE;AAED,wEAAwE;AACxE,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAIxD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,aAAa,GAC7C,MAAM,CAyCR;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,aAAa,GACxC,MAAM,CAKR"}

package/dist/mcp-server/tools/response-budget.js

@@ -1,204 +0,0 @@
-/**
- * @fileoverview The fixed byte budget a page-returning tool holds each response
- * surface to, and the arithmetic that keeps a page within it: measure both
- * surfaces as the caller receives them — whole, or as a page plus the
- * enrichment the framework adds — then either cut the longest bodies to the
- * largest byte limit they can share, on a code-point boundary, or serve the
- * longest prefix of the page that fits. The tool decides what is cuttable or
- * droppable and how the cut is disclosed.
- * @module mcp-server/tools/response-budget
- */
-/** Bytes each surface may carry: all `content[]` text, the enrichment trailer included, and the `structuredContent` JSON. */
-export const RESPONSE_BUDGET_BYTES = 64_000;
-/** {@link RESPONSE_BUDGET_BYTES} as the descriptions and notices write it. */
-export const RESPONSE_BUDGET_TEXT = RESPONSE_BUDGET_BYTES.toLocaleString('en-US');
-/** The line `content[]` puts after a body cut to the budget, outside its quote. */
-export const cutPointer = (id) => `Text cut short to fit the response budget — hn_get_thread with itemId ${id} returns it whole.`;
-const utf8 = new TextEncoder();
-/** UTF-8 length of `text`. */
-export function byteLength(text) {
-    return utf8.encode(text).byteLength;
-}
-/**
- * The longest prefix of `text` within `maxBytes` UTF-8 bytes. It ends on a
- * code-point boundary: a character that would straddle the limit, a surrogate
- * pair included, is left out whole.
- */
-export function cutToBytes(text, maxBytes) {
-    /** `encodeInto` stops before the first code point that does not fit; `read` counts the UTF-16 units it consumed. */
-    const { read } = utf8.encodeInto(text, new Uint8Array(maxBytes));
-    return text.slice(0, read);
-}
-/**
- * The bytes the framework's `content[]` trailer takes for `enrichment`, at
- * most one byte per field over. The trailer is rendered after `format()`, out
- * of the handler's sight, so each field is sized as the framework renders it —
- * the definition's `render`, the `notice` as a block quote, any other value as
- * `**key:** value` — plus two bytes: the trailer opens with a blank line and
- * joins its fields with one line break, or two after a block quote.
- *
- * @throws TypeError for a string or object field with no `render`, which the
- * framework renders as a code literal this does not size.
- */
-function trailerBytes(enrichment, trailer) {
-    let bytes = 0;
-    for (const [key, value] of Object.entries(enrichment)) {
-        const field = trailer?.[key];
-        let line;
-        if (field?.render) {
-            line = field.render(value);
-        }
-        else if (key === 'notice') {
-            line = String(value)
-                .split(/\r\n|\r|\n/)
-                .map((part) => (part === '' ? '>' : `> ${part}`))
-                .join('\n');
-        }
-        else if (value == null || typeof value === 'number' || typeof value === 'boolean') {
-            line = `**${field?.label ?? key}:** ${String(value)}`;
-        }
-        else {
-            throw new TypeError(`Cannot size enrichment field "${key}" (${typeof value}) for the response budget: give it an enrichmentTrailer render.`);
-        }
-        bytes += 2 + byteLength(line);
-    }
-    return bytes;
-}
-/**
- * The bytes the framework adds to each surface for `enrichment`: its
- * `content[]` trailer, and the `"key":value` members it merges into the
- * `structuredContent` object, each with the comma before it. Exact for a
- * result that serializes with at least one member and shares no key with the
- * enrichment. A tool that sizes its page as it builds it adds this to the
- * page's own bytes; {@link measureResponse} does the same for a whole draft.
- *
- * @throws TypeError for a string or object field with no `render`, as
- * {@link measureResponse} does.
- */
-export function enrichmentBytes(enrichment, trailer) {
-    let structuredBytes = 0;
-    for (const [key, value] of Object.entries(enrichment)) {
-        /** `undefined` is what JSON.stringify returns for a value it leaves out of an object. */
-        const json = JSON.stringify(value);
-        if (json !== undefined)
-            structuredBytes += 2 + byteLength(JSON.stringify(key)) + byteLength(json);
-    }
-    return { contentBytes: trailerBytes(enrichment, trailer), structuredBytes };
-}
-/**
- * Size a response on both surfaces as the caller receives it: every `content[]`
- * text block plus the enrichment trailer the framework appends, and the
- * `structuredContent` JSON — the handler's return merged with its enrichment,
- * which shares none of the return's keys.
- */
-export function measureResponse(draft) {
-    const added = enrichmentBytes(draft.enrichment, draft.trailer);
-    let contentBytes = added.contentBytes;
-    for (const block of draft.content) {
-        if (block.type === 'text' && block.text != null)
-            contentBytes += byteLength(block.text);
-    }
-    const result = JSON.stringify(draft.result);
-    /** Merged into an object with no members, the first field takes no comma. */
-    const noComma = result === '{}' && added.structuredBytes > 0 ? 1 : 0;
-    return { contentBytes, structuredBytes: byteLength(result) + added.structuredBytes - noComma };
-}
-/** True when both surfaces are within {@link RESPONSE_BUDGET_BYTES}. */
-export function fitsBudget(bytes) {
-    return (bytes.contentBytes <= RESPONSE_BUDGET_BYTES && bytes.structuredBytes <= RESPONSE_BUDGET_BYTES);
-}
-/**
- * The largest byte limit at which the page fits the budget when every body
- * longer than the limit is cut to it and every other body stays whole.
- *
- * Every body reaches each surface at least once, whole or cut, so a page cut
- * at a limit carries at least the bodies' bytes at that limit on each surface.
- * No limit whose body bytes alone exceed the budget can fit, and none is
- * measured: every page `measure` renders is within the budget in body bytes,
- * however long the bodies are.
- *
- * A page's size is not monotone in the limit: raising it to a body's length
- * returns that body whole, which drops its cut disclosure, so a page can fit at
- * a body's length and not one byte below. The limits are therefore searched as
- * cut sets — the longest body alone, then the two longest — each tried at its
- * lowest limit, where it cuts its bodies furthest. The answer is the first set
- * that fits there, bisected within, where the size does grow with the limit.
- * The first set the body bytes allow is measured, then the last; between them
- * the sets are bisected, on the assumption that once one set fits every larger
- * one does — where an earlier set also fits, a smaller limit is served. That is
- * at most two measurements plus a bisection over the sets and one within.
- *
- * @param bodyBytes UTF-8 length of each cuttable body; 0 for an item without
- *   one. Each body must reach both surfaces, at least once, cut or whole.
- * @param measure Both surfaces with every body longer than `limitBytes` cut to
- *   it. With the same bodies cut, a larger limit must never measure smaller.
- * @returns 0 when even cutting every body to nothing leaves the page over
- *   budget — the smallest page cutting can make.
- */
-export function largestFittingLimit(bodyBytes, measure) {
-    const lengths = [...new Set(bodyBytes)].filter((n) => n > 0).sort((a, b) => b - a);
-    const longest = lengths[0];
-    if (longest === undefined)
-        return 0;
-    /** The body bytes a page cut at `limit` carries on each surface, at least. */
-    const bodiesAt = (limit) => bodyBytes.reduce((sum, bytes) => sum + Math.min(bytes, limit), 0);
-    /** The highest limit whose body bytes fit; nothing above it can. */
-    let ceiling = 0;
-    for (let high = longest; ceiling < high;) {
-        const mid = Math.ceil((ceiling + high) / 2);
-        if (bodiesAt(mid) <= RESPONSE_BUDGET_BYTES)
-            ceiling = mid;
-        else
-            high = mid - 1;
-    }
-    /** Cut set `i` takes limits from its lowest, `lowestOf(i)`, up to one below its own length. */
-    const lowestOf = (i) => lengths[i + 1] ?? 0;
-    const fitsAtLowest = (i) => fitsBudget(measure(lowestOf(i)));
-    const last = lengths.length - 1;
-    let set = lengths.findIndex((_, i) => lowestOf(i) <= ceiling);
-    if (!fitsAtLowest(set)) {
-        if (set === last || !fitsAtLowest(last))
-            return 0;
-        /** `set` overflows at its lowest limit and `fitting` fits at its own. */
-        let fitting = last;
-        while (fitting - set > 1) {
-            const mid = Math.floor((set + fitting) / 2);
-            if (fitsAtLowest(mid))
-                fitting = mid;
-            else
-                set = mid;
-        }
-        set = fitting;
-    }
-    let lowest = lowestOf(set);
-    let highest = Math.min(lengths[set] - 1, ceiling);
-    while (lowest < highest) {
-        const mid = Math.ceil((lowest + highest) / 2);
-        if (fitsBudget(measure(mid)))
-            lowest = mid;
-        else
-            highest = mid - 1;
-    }
-    return lowest;
-}
-/**
- * Which of a page's `count` prefixes to serve: the longest that fits the
- * budget, or the first — the shortest the caller allows, served even over
- * budget — when none does.
- *
- * Prefixes are measured from the longest down, each at most once and the first
- * never. A prefix's overflow says nothing about a shorter one: what a response
- * adds beyond its page, such as a cursor of the entries still unread, can shrink
- * as the page shortens as well as grow.
- *
- * @param measure The whole response serving prefix `index`.
- * @returns The index of the prefix to serve.
- */
-export function longestFittingPrefix(count, measure) {
-    for (let index = count - 1; index > 0; index--) {
-        if (fitsBudget(measure(index)))
-            return index;
-    }
-    return 0;
-}
-//# sourceMappingURL=response-budget.js.map

package/dist/mcp-server/tools/response-budget.js.map

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