@astralyn/pi 0.81.1-1

package/dist/extensions/deepwiki/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/extensions/deepwiki/client.ts"],"names":[],"mappings":"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","sourcesContent":["import { PAGE_HEADER_RE } from \"./contents.ts\";\nimport { fetchWithRetry } from \"./http.ts\";\nimport { type DeepWikiParams, normalizeDeepWikiParams } from \"./schema.ts\";\n\nconst DEEPWIKI_MCP_URL = \"https://mcp.deepwiki.com/mcp\";\nconst MCP_PROTOCOL_VERSION = \"2024-11-05\";\nconst REQUEST_TIMEOUT_MS = 45_000;\nconst CACHE_TTL_MS = 10 * 60_000;\n/** Long-lived process guard: entries are only otherwise dropped on re-read after expiry. */\nconst MAX_CACHE_ENTRIES = 50;\n/** Transient-failure retries (network blips, 5xx, 429). Aborts/timeouts are not retried. */\nconst MAX_RETRIES = 2;\n\ntype DeepWikiToolName = \"read_wiki_structure\" | \"read_wiki_contents\" | \"ask_question\";\n\ninterface JsonRpcErrorPayload {\n\tcode?: number;\n\tmessage?: string;\n\tdata?: unknown;\n}\n\ninterface JsonRpcEnvelope {\n\tjsonrpc?: string;\n\tid?: string | number | null;\n\tresult?: unknown;\n\terror?: JsonRpcErrorPayload;\n}\n\ninterface McpTextContent {\n\ttype: \"text\";\n\ttext: string;\n}\n\ninterface McpToolCallResult {\n\tcontent?: unknown;\n\tstructuredContent?: unknown;\n\tisError?: boolean;\n}\n\nexport interface DeepWikiResponse {\n\ttoolName: DeepWikiToolName;\n\ttext: string;\n\toutputLength: number;\n\tpageTitles?: string[];\n\tcacheHit?: boolean;\n}\n\ninterface CacheEntry {\n\texpiresAt: number;\n\tresponse: DeepWikiResponse;\n}\n\nconst responseCache = new Map<string, CacheEntry>();\n\nfunction toolNameForAction(action: DeepWikiParams[\"action\"]): DeepWikiToolName {\n\tif (action === \"structure\") return \"read_wiki_structure\";\n\tif (action === \"contents\") return \"read_wiki_contents\";\n\treturn \"ask_question\";\n}\n\n// Callers pass params already normalized by callDeepWiki's entry gate; no re-normalization.\nfunction argumentsForParams(params: DeepWikiParams): Record<string, unknown> {\n\tif (params.action === \"question\") {\n\t\tconst question = params.question?.trim();\n\t\tif (!question) throw new Error(\"question is required when action is question\");\n\t\treturn { repoName: params.repoName, question };\n\t}\n\treturn { repoName: params.repoName };\n}\n\nfunction cacheKey(params: DeepWikiParams): string {\n\tconst repos = Array.isArray(params.repoName) ? params.repoName : [params.repoName];\n\treturn JSON.stringify([params.action, repos, params.question ?? \"\"]);\n}\n\nfunction cloneResponse(response: DeepWikiResponse, cacheHit: boolean): DeepWikiResponse {\n\treturn {\n\t\t...response,\n\t\t...(response.pageTitles ? { pageTitles: [...response.pageTitles] } : {}),\n\t\tcacheHit,\n\t};\n}\n\nfunction truncate(text: string, maxLength = 500): string {\n\tif (text.length <= maxLength) return text;\n\treturn `${text.slice(0, maxLength - 3)}...`;\n}\n\nfunction parseJson(text: string): JsonRpcEnvelope {\n\ttry {\n\t\treturn JSON.parse(text) as JsonRpcEnvelope;\n\t} catch (error) {\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\tthrow new Error(`DeepWiki returned invalid JSON: ${message}`);\n\t}\n}\n\nfunction parseSse(text: string): JsonRpcEnvelope {\n\tconst blocks = text.split(/\\r?\\n\\r?\\n/);\n\tlet fallback: JsonRpcEnvelope | undefined;\n\tfor (const block of blocks) {\n\t\tconst dataLines = block\n\t\t\t.split(/\\r?\\n/)\n\t\t\t.filter((line) => line.startsWith(\"data:\"))\n\t\t\t.map((line) => line.slice(5).replace(/^ /, \"\"));\n\t\tif (dataLines.length === 0) continue;\n\n\t\tconst data = dataLines.join(\"\\n\").trim();\n\t\tif (!data || data === \"[DONE]\") continue;\n\t\tconst envelope = parseJson(data);\n\t\tif (envelope.error || envelope.result !== undefined) return envelope;\n\t\tfallback = envelope;\n\t}\n\tif (fallback) return fallback;\n\tthrow new Error(\"DeepWiki returned an empty event stream\");\n}\n\nfunction parseEnvelope(text: string, contentType: string | null): JsonRpcEnvelope {\n\tif (contentType?.includes(\"text/event-stream\")) return parseSse(text);\n\treturn parseJson(text);\n}\n\nfunction extractStructuredResult(result: McpToolCallResult): string | undefined {\n\tif (!result.structuredContent || typeof result.structuredContent !== \"object\") return undefined;\n\tconst value = (result.structuredContent as Record<string, unknown>).result;\n\treturn typeof value === \"string\" ? value : undefined;\n}\n\nfunction extractContentResult(result: McpToolCallResult): string {\n\tif (!Array.isArray(result.content)) return \"\";\n\treturn result.content\n\t\t.filter((part): part is McpTextContent => {\n\t\t\tif (!part || typeof part !== \"object\") return false;\n\t\t\tconst record = part as Record<string, unknown>;\n\t\t\treturn record.type === \"text\" && typeof record.text === \"string\";\n\t\t})\n\t\t.map((part) => part.text)\n\t\t.join(\"\\n\")\n\t\t.trim();\n}\n\nfunction isDeepWikiErrorText(text: string): boolean {\n\tconst trimmed = text.trim();\n\treturn (\n\t\t/^Error fetching wiki for .+?: Repository not found\\./i.test(trimmed) ||\n\t\t/^Error processing question: Repository not found\\./i.test(trimmed)\n\t);\n}\n\nfunction extractToolText(result: unknown): string {\n\tif (!result || typeof result !== \"object\") throw new Error(\"DeepWiki returned no result object\");\n\n\tconst toolResult = result as McpToolCallResult;\n\tconst text = extractStructuredResult(toolResult) ?? extractContentResult(toolResult);\n\tif (!text) throw new Error(\"DeepWiki returned no text content\");\n\tif (toolResult.isError || isDeepWikiErrorText(text)) throw new Error(text);\n\treturn text;\n}\n\nexport function extractStructureSections(text: string): string[] {\n\treturn uniqueTitles(text.split(\"\\n\").map((line) => line.match(/^\\s*-\\s+\\d+\\s+(.+)$/)?.[1]?.trim()));\n}\n\nexport function extractContentPages(text: string): string[] {\n\treturn uniqueTitles(text.split(\"\\n\").map((line) => line.match(PAGE_HEADER_RE)?.[1]?.trim()));\n}\n\nfunction uniqueTitles(titles: Array<string | undefined>): string[] {\n\tconst seen = new Set<string>();\n\tconst result: string[] = [];\n\tfor (const title of titles) {\n\t\tif (!title || seen.has(title)) continue;\n\t\tseen.add(title);\n\t\tresult.push(title);\n\t}\n\treturn result;\n}\n\nfunction extractPageTitles(toolName: DeepWikiToolName, text: string): string[] {\n\tif (toolName === \"read_wiki_structure\") return extractStructureSections(text);\n\tif (toolName === \"read_wiki_contents\") return extractContentPages(text);\n\treturn [];\n}\n\nexport async function callDeepWiki(params: DeepWikiParams, signal: AbortSignal | undefined): Promise<DeepWikiResponse> {\n\tconst normalizedParams = normalizeDeepWikiParams(params);\n\tconst key = cacheKey(normalizedParams);\n\tconst cached = responseCache.get(key);\n\tif (cached && cached.expiresAt > Date.now()) {\n\t\treturn cloneResponse(cached.response, true);\n\t}\n\tif (cached) responseCache.delete(key);\n\n\tconst toolName = toolNameForAction(normalizedParams.action);\n\tconst bodyJson = JSON.stringify({\n\t\tjsonrpc: \"2.0\",\n\t\tid: 1,\n\t\tmethod: \"tools/call\",\n\t\tparams: {\n\t\t\tname: toolName,\n\t\t\targuments: argumentsForParams(normalizedParams),\n\t\t},\n\t});\n\n\t// Timeout + bounded transient retry live in this extension's http.ts; non-retryable\n\t// statuses come back here for the domain-specific HTTP error below.\n\tconst { response, text } = await fetchWithRetry(\n\t\tDEEPWIKI_MCP_URL,\n\t\t{\n\t\t\tmethod: \"POST\",\n\t\t\theaders: {\n\t\t\t\tAccept: \"application/json, text/event-stream\",\n\t\t\t\t\"Content-Type\": \"application/json\",\n\t\t\t\t\"MCP-Protocol-Version\": MCP_PROTOCOL_VERSION,\n\t\t\t},\n\t\t\tbody: bodyJson,\n\t\t},\n\t\t{ timeoutMs: REQUEST_TIMEOUT_MS, retries: MAX_RETRIES, signal, label: \"DeepWiki\" },\n\t);\n\n\tif (!response.ok) {\n\t\tthrow new Error(`DeepWiki HTTP ${response.status}: ${truncate(text)}`);\n\t}\n\n\tconst envelope = parseEnvelope(text, response.headers.get(\"content-type\"));\n\tif (envelope.error) {\n\t\tthrow new Error(envelope.error.message ?? `DeepWiki JSON-RPC error ${envelope.error.code ?? \"unknown\"}`);\n\t}\n\n\tconst resultText = extractToolText(envelope.result);\n\tconst pageTitles = extractPageTitles(toolName, resultText);\n\tconst result: DeepWikiResponse = {\n\t\ttoolName,\n\t\ttext: resultText,\n\t\toutputLength: resultText.length,\n\t\t...(pageTitles.length ? { pageTitles } : {}),\n\t};\n\tresponseCache.set(key, { expiresAt: Date.now() + CACHE_TTL_MS, response: cloneResponse(result, false) });\n\twhile (responseCache.size > MAX_CACHE_ENTRIES) {\n\t\tconst oldest = responseCache.keys().next().value;\n\t\tif (oldest === undefined) break;\n\t\tresponseCache.delete(oldest);\n\t}\n\treturn result;\n}\n"]}

package/dist/extensions/deepwiki/constants.d.ts

@@ -0,0 +1,13 @@
+/**
+ * constants.ts — deepwiki tool identity + prompt copy.
+ *
+ * Name/label/description/promptSnippet/promptGuidelines live here so
+ * `index.ts` only assembles the tool. Prompt copy is the model-facing
+ * contract; keep it stable.
+ */
+export declare const DEEPWIKI_TOOL_NAME = "deepwiki";
+export declare const DEEPWIKI_LABEL = "DeepWiki";
+export declare const DEEPWIKI_DESCRIPTION = "Query DeepWiki's AI-generated documentation for indexed public GitHub repositories. Recommended flow: structure lists the wiki's pages; contents with page (title or 1-based index) reads one page \u2014 read pages selectively rather than pulling the whole wiki (omitting page returns everything, truncated past ~120k chars); question answers a focused query (up to 10 repos for comparisons) \u2014 reach for it when the wiki pages don't cover what you need, or on its own for a quick answer without reading. Use it for architecture, module layout, APIs, extension points, and implementation patterns when designing or building. Results describe indexed public snapshots and may cite sources; they are not local workspace state, private code, or guaranteed-fresh facts.";
+export declare const DEEPWIKI_PROMPT_SNIPPET = "Query AI-generated docs for public GitHub repos: architecture, APIs, implementation patterns, cross-repo comparisons";
+export declare const DEEPWIKI_PROMPT_GUIDELINES: string[];
+//# sourceMappingURL=constants.d.ts.map

package/dist/extensions/deepwiki/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/extensions/deepwiki/constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,kBAAkB,aAAa,CAAC;AAC7C,eAAO,MAAM,cAAc,aAAa,CAAC;AAEzC,eAAO,MAAM,oBAAoB,owBACutB,CAAC;AAEzvB,eAAO,MAAM,uBAAuB,yHACmF,CAAC;AAExH,eAAO,MAAM,0BAA0B,UAKtC,CAAC","sourcesContent":["/**\n * constants.ts — deepwiki tool identity + prompt copy.\n *\n * Name/label/description/promptSnippet/promptGuidelines live here so\n * `index.ts` only assembles the tool. Prompt copy is the model-facing\n * contract; keep it stable.\n */\n\nexport const DEEPWIKI_TOOL_NAME = \"deepwiki\";\nexport const DEEPWIKI_LABEL = \"DeepWiki\";\n\nexport const DEEPWIKI_DESCRIPTION =\n\t\"Query DeepWiki's AI-generated documentation for indexed public GitHub repositories. Recommended flow: structure lists the wiki's pages; contents with page (title or 1-based index) reads one page — read pages selectively rather than pulling the whole wiki (omitting page returns everything, truncated past ~120k chars); question answers a focused query (up to 10 repos for comparisons) — reach for it when the wiki pages don't cover what you need, or on its own for a quick answer without reading. Use it for architecture, module layout, APIs, extension points, and implementation patterns when designing or building. Results describe indexed public snapshots and may cite sources; they are not local workspace state, private code, or guaranteed-fresh facts.\";\n\nexport const DEEPWIKI_PROMPT_SNIPPET =\n\t\"Query AI-generated docs for public GitHub repos: architecture, APIs, implementation patterns, cross-repo comparisons\";\n\nexport const DEEPWIKI_PROMPT_GUIDELINES = [\n\t\"Use `deepwiki` on public GitHub repos only: run `structure` first for that owner/repo. If structure fails with repository not found, the wiki is not indexed on DeepWiki — do not call contents or question for that repo; pick another repo (e.g. upstream `badlogic/pi-mono` for pi-mono docs).\",\n\t\"After structure, use `contents` with `page` set to a 1-based index or an exact page title from the structure list (titles are plain names like `Extension System`, not numbered outline lines like `4.4 Extension System`). Avoid `contents` without `page` unless the wiki is small.\",\n\t\"Use `deepwiki` action `question` for a focused answer without reading pages, or when structure/contents do not cover the topic. Single repo: `repoName` as a string. Compare 2-10 repos: `repoName` as an array of owner/repo strings (or comma-separated string).\",\n\t\"Do not use `deepwiki` for local workspace files, private repos, exact current HEAD, or freshness-sensitive facts (releases, pricing, advisories); use local tools or current primary sources instead.\",\n];\n"]}

package/dist/extensions/deepwiki/constants.js

@@ -0,0 +1,18 @@
+/**
+ * constants.ts — deepwiki tool identity + prompt copy.
+ *
+ * Name/label/description/promptSnippet/promptGuidelines live here so
+ * `index.ts` only assembles the tool. Prompt copy is the model-facing
+ * contract; keep it stable.
+ */
+export const DEEPWIKI_TOOL_NAME = "deepwiki";
+export const DEEPWIKI_LABEL = "DeepWiki";
+export const DEEPWIKI_DESCRIPTION = "Query DeepWiki's AI-generated documentation for indexed public GitHub repositories. Recommended flow: structure lists the wiki's pages; contents with page (title or 1-based index) reads one page — read pages selectively rather than pulling the whole wiki (omitting page returns everything, truncated past ~120k chars); question answers a focused query (up to 10 repos for comparisons) — reach for it when the wiki pages don't cover what you need, or on its own for a quick answer without reading. Use it for architecture, module layout, APIs, extension points, and implementation patterns when designing or building. Results describe indexed public snapshots and may cite sources; they are not local workspace state, private code, or guaranteed-fresh facts.";
+export const DEEPWIKI_PROMPT_SNIPPET = "Query AI-generated docs for public GitHub repos: architecture, APIs, implementation patterns, cross-repo comparisons";
+export const DEEPWIKI_PROMPT_GUIDELINES = [
+    "Use `deepwiki` on public GitHub repos only: run `structure` first for that owner/repo. If structure fails with repository not found, the wiki is not indexed on DeepWiki — do not call contents or question for that repo; pick another repo (e.g. upstream `badlogic/pi-mono` for pi-mono docs).",
+    "After structure, use `contents` with `page` set to a 1-based index or an exact page title from the structure list (titles are plain names like `Extension System`, not numbered outline lines like `4.4 Extension System`). Avoid `contents` without `page` unless the wiki is small.",
+    "Use `deepwiki` action `question` for a focused answer without reading pages, or when structure/contents do not cover the topic. Single repo: `repoName` as a string. Compare 2-10 repos: `repoName` as an array of owner/repo strings (or comma-separated string).",
+    "Do not use `deepwiki` for local workspace files, private repos, exact current HEAD, or freshness-sensitive facts (releases, pricing, advisories); use local tools or current primary sources instead.",
+];
+//# sourceMappingURL=constants.js.map

package/dist/extensions/deepwiki/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/extensions/deepwiki/constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC;AAC7C,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;AAEzC,MAAM,CAAC,MAAM,oBAAoB,GAChC,2vBAAuvB,CAAC;AAEzvB,MAAM,CAAC,MAAM,uBAAuB,GACnC,sHAAsH,CAAC;AAExH,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACzC,qSAAmS;IACnS,uRAAuR;IACvR,oQAAoQ;IACpQ,uMAAuM;CACvM,CAAC","sourcesContent":["/**\n * constants.ts — deepwiki tool identity + prompt copy.\n *\n * Name/label/description/promptSnippet/promptGuidelines live here so\n * `index.ts` only assembles the tool. Prompt copy is the model-facing\n * contract; keep it stable.\n */\n\nexport const DEEPWIKI_TOOL_NAME = \"deepwiki\";\nexport const DEEPWIKI_LABEL = \"DeepWiki\";\n\nexport const DEEPWIKI_DESCRIPTION =\n\t\"Query DeepWiki's AI-generated documentation for indexed public GitHub repositories. Recommended flow: structure lists the wiki's pages; contents with page (title or 1-based index) reads one page — read pages selectively rather than pulling the whole wiki (omitting page returns everything, truncated past ~120k chars); question answers a focused query (up to 10 repos for comparisons) — reach for it when the wiki pages don't cover what you need, or on its own for a quick answer without reading. Use it for architecture, module layout, APIs, extension points, and implementation patterns when designing or building. Results describe indexed public snapshots and may cite sources; they are not local workspace state, private code, or guaranteed-fresh facts.\";\n\nexport const DEEPWIKI_PROMPT_SNIPPET =\n\t\"Query AI-generated docs for public GitHub repos: architecture, APIs, implementation patterns, cross-repo comparisons\";\n\nexport const DEEPWIKI_PROMPT_GUIDELINES = [\n\t\"Use `deepwiki` on public GitHub repos only: run `structure` first for that owner/repo. If structure fails with repository not found, the wiki is not indexed on DeepWiki — do not call contents or question for that repo; pick another repo (e.g. upstream `badlogic/pi-mono` for pi-mono docs).\",\n\t\"After structure, use `contents` with `page` set to a 1-based index or an exact page title from the structure list (titles are plain names like `Extension System`, not numbered outline lines like `4.4 Extension System`). Avoid `contents` without `page` unless the wiki is small.\",\n\t\"Use `deepwiki` action `question` for a focused answer without reading pages, or when structure/contents do not cover the topic. Single repo: `repoName` as a string. Compare 2-10 repos: `repoName` as an array of owner/repo strings (or comma-separated string).\",\n\t\"Do not use `deepwiki` for local workspace files, private repos, exact current HEAD, or freshness-sensitive facts (releases, pricing, advisories); use local tools or current primary sources instead.\",\n];\n"]}

package/dist/extensions/deepwiki/contents.d.ts

@@ -0,0 +1,63 @@
+/**
+ * contents.ts — page-boundary truncation for deepwiki `contents` responses.
+ *
+ * Zero-import pure module so `node scratch/<x>.ts` can drive it directly (this
+ * repo has no node_modules; bare-package imports would fail to resolve there).
+ * client.ts imports PAGE_HEADER_RE from here, so page-title extraction and
+ * truncation chunking share one definition and cannot drift apart.
+ *
+ * Model-facing output must stay bounded: a full generated wiki can reach
+ * hundreds of KB. Past CONTENTS_CHAR_BUDGET the text is cut at "# Page:"
+ * boundaries — whole pages are kept in order, at least the beginning of the
+ * first page always survives — and a trailing notice states what was omitted
+ * and how to get it (read a single page via the `page` parameter, or ask a
+ * focused question). extractPage implements that single-page read: upstream
+ * has no per-page fetch, so a page is sliced locally out of the full text.
+ *
+ * Determinism matters: callDeepWiki caches the FULL response and the caller
+ * re-truncates on every call, so cached and fresh calls must produce
+ * byte-identical text. Pure function + constant budget guarantees that.
+ */
+/** Page-header line of a DeepWiki contents response ("# Page: <title>"). */
+export declare const PAGE_HEADER_RE: RegExp;
+export declare const CONTENTS_CHAR_BUDGET = 120000;
+export interface ContentsTruncation {
+    /** Truncated body plus trailing notice; equals the input when not truncated. */
+    text: string;
+    truncated: boolean;
+    /** Page chunks found in the full text (0 = no "# Page:" markers). */
+    totalPages: number;
+    /** Pages fully or partially shown (a mid-page cut still counts its page). */
+    shownPages: number;
+    /** Body characters dropped by the cut (the notice is not counted). */
+    truncatedChars: number;
+}
+/**
+ * Truncate a contents response to `budget` chars at page boundaries and append
+ * an omission notice. Below budget the input is returned untouched.
+ */
+export declare function truncateContentsByPages(text: string, budget?: number): ContentsTruncation;
+export interface PageSlice {
+    /** Resolved page title as it appears in the header line. */
+    title: string;
+    /** Page text from its header line up to the next page header (or EOF). */
+    text: string;
+    /** 1-based position among the page chunks. */
+    index: number;
+}
+export interface PageLookup {
+    found?: PageSlice;
+    /** All page titles in document order — for self-healing not-found errors. */
+    titles: string[];
+}
+/** Strip outline numbers copied from structure TOC (e.g. `4.4 Extension System` → `Extension System`). */
+export declare function normalizePageRef(pageRef: string | number): string | number;
+/**
+ * Slice one wiki page out of a full contents response. `pageRef` is matched
+ * leniently, in this order: case-insensitive exact title, unique partial
+ * title, or a 1-based index for purely numeric refs (matching the order shown
+ * by structure and truncation notices). No match (or a wiki without page
+ * markers) returns just the title list so the caller can report what exists.
+ */
+export declare function extractPage(text: string, pageRef: string | number): PageLookup;
+//# sourceMappingURL=contents.d.ts.map

package/dist/extensions/deepwiki/contents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contents.d.ts","sourceRoot":"","sources":["../../../src/extensions/deepwiki/contents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,4EAA4E;AAC5E,eAAO,MAAM,cAAc,QAAuB,CAAC;AAEnD,eAAO,MAAM,oBAAoB,SAAU,CAAC;AAK5C,MAAM,WAAW,kBAAkB;IAClC,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,cAAc,EAAE,MAAM,CAAC;CACvB;AAyDD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,SAAuB,GAAG,kBAAkB,CAwDvG;AAED,MAAM,WAAW,SAAS;IACzB,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IAC1B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,+EAA6E;IAC7E,MAAM,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,4GAA0G;AAC1G,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAM1E;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,CA2B9E","sourcesContent":["/**\n * contents.ts — page-boundary truncation for deepwiki `contents` responses.\n *\n * Zero-import pure module so `node scratch/<x>.ts` can drive it directly (this\n * repo has no node_modules; bare-package imports would fail to resolve there).\n * client.ts imports PAGE_HEADER_RE from here, so page-title extraction and\n * truncation chunking share one definition and cannot drift apart.\n *\n * Model-facing output must stay bounded: a full generated wiki can reach\n * hundreds of KB. Past CONTENTS_CHAR_BUDGET the text is cut at \"# Page:\"\n * boundaries — whole pages are kept in order, at least the beginning of the\n * first page always survives — and a trailing notice states what was omitted\n * and how to get it (read a single page via the `page` parameter, or ask a\n * focused question). extractPage implements that single-page read: upstream\n * has no per-page fetch, so a page is sliced locally out of the full text.\n *\n * Determinism matters: callDeepWiki caches the FULL response and the caller\n * re-truncates on every call, so cached and fresh calls must produce\n * byte-identical text. Pure function + constant budget guarantees that.\n */\n\n/** Page-header line of a DeepWiki contents response (\"# Page: <title>\"). */\nexport const PAGE_HEADER_RE = /^#\\s+Page:\\s+(.+)$/;\n\nexport const CONTENTS_CHAR_BUDGET = 120_000;\n\n/** Cap for omitted page titles inside the notice — the notice itself is bounded. */\nconst OMITTED_TITLES_MAX = 20;\n\nexport interface ContentsTruncation {\n\t/** Truncated body plus trailing notice; equals the input when not truncated. */\n\ttext: string;\n\ttruncated: boolean;\n\t/** Page chunks found in the full text (0 = no \"# Page:\" markers). */\n\ttotalPages: number;\n\t/** Pages fully or partially shown (a mid-page cut still counts its page). */\n\tshownPages: number;\n\t/** Body characters dropped by the cut (the notice is not counted). */\n\ttruncatedChars: number;\n}\n\ninterface PageChunk {\n\ttitle: string;\n\tstart: number;\n}\n\n/** Locate every page-header line as a character offset into the full text. */\nfunction pageOffsets(text: string): PageChunk[] {\n\tconst re = new RegExp(PAGE_HEADER_RE.source, \"gm\");\n\tconst chunks: PageChunk[] = [];\n\tlet match = re.exec(text);\n\twhile (match !== null) {\n\t\tchunks.push({ title: match[1]!.trim(), start: match.index });\n\t\tmatch = re.exec(text);\n\t}\n\treturn chunks;\n}\n\n/**\n * Hard-cut `text` to at most `budget` chars, preferring the last newline within\n * the budget so the cut lands between lines. A newline too close to the start\n * (< 40% of the budget) is ignored — a hard cut keeps more content than a tiny\n * stub, using the same word-boundary heuristic as other bounded text output.\n */\nfunction cutAtLineBoundary(text: string, budget: number): string {\n\tif (text.length <= budget) return text;\n\tconst slice = text.slice(0, budget);\n\tconst lastNewline = slice.lastIndexOf(\"\\n\");\n\treturn lastNewline >= Math.floor(budget * 0.4) ? slice.slice(0, lastNewline) : slice;\n}\n\nfunction buildNotice(opts: {\n\tshownPages: number;\n\ttotalPages: number;\n\tkeptChars: number;\n\tfullChars: number;\n\tomittedTitles: string[];\n\tpartialLastPage: boolean;\n}): string {\n\tconst pagesPart =\n\t\topts.totalPages > 0 ? `showing ${opts.shownPages} of ${opts.totalPages} pages` : \"showing the beginning\";\n\tconst lines = [`[DeepWiki contents truncated — ${pagesPart} (${opts.keptChars} of ${opts.fullChars} chars).`];\n\tif (opts.partialLastPage) lines.push(\"The last shown page is itself truncated.\");\n\tif (opts.omittedTitles.length > 0) {\n\t\tconst shown = opts.omittedTitles.slice(0, OMITTED_TITLES_MAX).join(\"; \");\n\t\tconst more = opts.omittedTitles.length - OMITTED_TITLES_MAX;\n\t\tlines.push(`Omitted pages: ${shown}${more > 0 ? ` … +${more} more` : \"\"}.`);\n\t\tlines.push(\n\t\t\t`Read an omitted page with {action: \"contents\", page: \"<title>\"}, or use action \"question\" for a targeted answer.]`,\n\t\t);\n\t} else {\n\t\tlines.push(`For the missing remainder, use action \"question\" with a focused question.]`);\n\t}\n\treturn lines.join(\"\\n\");\n}\n\n/**\n * Truncate a contents response to `budget` chars at page boundaries and append\n * an omission notice. Below budget the input is returned untouched.\n */\nexport function truncateContentsByPages(text: string, budget = CONTENTS_CHAR_BUDGET): ContentsTruncation {\n\tconst chunks = pageOffsets(text);\n\tconst totalPages = chunks.length;\n\n\tif (text.length <= budget) {\n\t\treturn { text, truncated: false, totalPages, shownPages: totalPages, truncatedChars: 0 };\n\t}\n\n\tlet kept: string;\n\tlet shownPages: number;\n\tlet partialLastPage = false;\n\n\tif (totalPages === 0) {\n\t\t// No page markers: treat the whole text as one block and cut at a line.\n\t\tkept = cutAtLineBoundary(text, budget);\n\t\tshownPages = 0;\n\t} else {\n\t\t// Accumulate the preamble (anything before the first marker) plus whole\n\t\t// pages, in order, while they fit.\n\t\tconst preambleEnd = chunks[0]!.start;\n\t\tshownPages = 0;\n\t\tlet end = preambleEnd;\n\t\tfor (let i = 0; i < chunks.length; i++) {\n\t\t\tconst pageEnd = i + 1 < chunks.length ? chunks[i + 1]!.start : text.length;\n\t\t\tif (pageEnd > budget) break;\n\t\t\tend = pageEnd;\n\t\t\tshownPages++;\n\t\t}\n\t\tif (shownPages === 0) {\n\t\t\t// Even the first page does not fit: cut inside it so at least the\n\t\t\t// document head and the first page's opening survive.\n\t\t\tkept = cutAtLineBoundary(text, budget);\n\t\t\tshownPages = 1;\n\t\t\tpartialLastPage = true;\n\t\t} else {\n\t\t\tkept = text.slice(0, end);\n\t\t}\n\t}\n\n\tconst omittedTitles = chunks.slice(shownPages).map((chunk) => chunk.title);\n\tconst notice = buildNotice({\n\t\tshownPages,\n\t\ttotalPages,\n\t\tkeptChars: kept.length,\n\t\tfullChars: text.length,\n\t\tomittedTitles,\n\t\tpartialLastPage,\n\t});\n\n\treturn {\n\t\ttext: `${kept}\\n\\n${notice}`,\n\t\ttruncated: true,\n\t\ttotalPages,\n\t\tshownPages,\n\t\ttruncatedChars: text.length - kept.length,\n\t};\n}\n\nexport interface PageSlice {\n\t/** Resolved page title as it appears in the header line. */\n\ttitle: string;\n\t/** Page text from its header line up to the next page header (or EOF). */\n\ttext: string;\n\t/** 1-based position among the page chunks. */\n\tindex: number;\n}\n\nexport interface PageLookup {\n\tfound?: PageSlice;\n\t/** All page titles in document order — for self-healing not-found errors. */\n\ttitles: string[];\n}\n\n/** Strip outline numbers copied from structure TOC (e.g. `4.4 Extension System` → `Extension System`). */\nexport function normalizePageRef(pageRef: string | number): string | number {\n\tif (typeof pageRef === \"number\") return pageRef;\n\tconst trimmed = pageRef.trim();\n\tif (!trimmed) return trimmed;\n\tconst stripped = trimmed.replace(/^\\d+(?:\\.\\d+)*\\s+/, \"\");\n\treturn stripped.length > 0 ? stripped : trimmed;\n}\n\n/**\n * Slice one wiki page out of a full contents response. `pageRef` is matched\n * leniently, in this order: case-insensitive exact title, unique partial\n * title, or a 1-based index for purely numeric refs (matching the order shown\n * by structure and truncation notices). No match (or a wiki without page\n * markers) returns just the title list so the caller can report what exists.\n */\nexport function extractPage(text: string, pageRef: string | number): PageLookup {\n\tconst chunks = pageOffsets(text);\n\tconst titles = chunks.map((chunk) => chunk.title);\n\tif (chunks.length === 0) return { titles };\n\n\tconst normalized = normalizePageRef(pageRef);\n\tconst ref = String(normalized).trim();\n\tlet idx = -1;\n\tif (typeof normalized === \"number\" || /^\\d+$/.test(ref)) {\n\t\tconst ordinal = typeof normalized === \"number\" ? normalized : Number.parseInt(ref, 10);\n\t\tif (ordinal >= 1 && ordinal <= chunks.length) idx = ordinal - 1;\n\t} else if (ref) {\n\t\tconst lower = ref.toLowerCase();\n\t\tidx = titles.findIndex((title) => title.toLowerCase() === lower);\n\t\tif (idx === -1) {\n\t\t\tconst partial = titles.reduce<number[]>((acc, title, i) => {\n\t\t\t\tif (title.toLowerCase().includes(lower)) acc.push(i);\n\t\t\t\treturn acc;\n\t\t\t}, []);\n\t\t\tif (partial.length === 1) idx = partial[0]!;\n\t\t}\n\t}\n\tif (idx === -1) return { titles };\n\n\tconst start = chunks[idx]!.start;\n\tconst end = idx + 1 < chunks.length ? chunks[idx + 1]!.start : text.length;\n\treturn { found: { title: titles[idx]!, text: text.slice(start, end), index: idx + 1 }, titles };\n}\n"]}

package/dist/extensions/deepwiki/contents.js

@@ -0,0 +1,174 @@
+/**
+ * contents.ts — page-boundary truncation for deepwiki `contents` responses.
+ *
+ * Zero-import pure module so `node scratch/<x>.ts` can drive it directly (this
+ * repo has no node_modules; bare-package imports would fail to resolve there).
+ * client.ts imports PAGE_HEADER_RE from here, so page-title extraction and
+ * truncation chunking share one definition and cannot drift apart.
+ *
+ * Model-facing output must stay bounded: a full generated wiki can reach
+ * hundreds of KB. Past CONTENTS_CHAR_BUDGET the text is cut at "# Page:"
+ * boundaries — whole pages are kept in order, at least the beginning of the
+ * first page always survives — and a trailing notice states what was omitted
+ * and how to get it (read a single page via the `page` parameter, or ask a
+ * focused question). extractPage implements that single-page read: upstream
+ * has no per-page fetch, so a page is sliced locally out of the full text.
+ *
+ * Determinism matters: callDeepWiki caches the FULL response and the caller
+ * re-truncates on every call, so cached and fresh calls must produce
+ * byte-identical text. Pure function + constant budget guarantees that.
+ */
+/** Page-header line of a DeepWiki contents response ("# Page: <title>"). */
+export const PAGE_HEADER_RE = /^#\s+Page:\s+(.+)$/;
+export const CONTENTS_CHAR_BUDGET = 120_000;
+/** Cap for omitted page titles inside the notice — the notice itself is bounded. */
+const OMITTED_TITLES_MAX = 20;
+/** Locate every page-header line as a character offset into the full text. */
+function pageOffsets(text) {
+    const re = new RegExp(PAGE_HEADER_RE.source, "gm");
+    const chunks = [];
+    let match = re.exec(text);
+    while (match !== null) {
+        chunks.push({ title: match[1].trim(), start: match.index });
+        match = re.exec(text);
+    }
+    return chunks;
+}
+/**
+ * Hard-cut `text` to at most `budget` chars, preferring the last newline within
+ * the budget so the cut lands between lines. A newline too close to the start
+ * (< 40% of the budget) is ignored — a hard cut keeps more content than a tiny
+ * stub, using the same word-boundary heuristic as other bounded text output.
+ */
+function cutAtLineBoundary(text, budget) {
+    if (text.length <= budget)
+        return text;
+    const slice = text.slice(0, budget);
+    const lastNewline = slice.lastIndexOf("\n");
+    return lastNewline >= Math.floor(budget * 0.4) ? slice.slice(0, lastNewline) : slice;
+}
+function buildNotice(opts) {
+    const pagesPart = opts.totalPages > 0 ? `showing ${opts.shownPages} of ${opts.totalPages} pages` : "showing the beginning";
+    const lines = [`[DeepWiki contents truncated — ${pagesPart} (${opts.keptChars} of ${opts.fullChars} chars).`];
+    if (opts.partialLastPage)
+        lines.push("The last shown page is itself truncated.");
+    if (opts.omittedTitles.length > 0) {
+        const shown = opts.omittedTitles.slice(0, OMITTED_TITLES_MAX).join("; ");
+        const more = opts.omittedTitles.length - OMITTED_TITLES_MAX;
+        lines.push(`Omitted pages: ${shown}${more > 0 ? ` … +${more} more` : ""}.`);
+        lines.push(`Read an omitted page with {action: "contents", page: "<title>"}, or use action "question" for a targeted answer.]`);
+    }
+    else {
+        lines.push(`For the missing remainder, use action "question" with a focused question.]`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Truncate a contents response to `budget` chars at page boundaries and append
+ * an omission notice. Below budget the input is returned untouched.
+ */
+export function truncateContentsByPages(text, budget = CONTENTS_CHAR_BUDGET) {
+    const chunks = pageOffsets(text);
+    const totalPages = chunks.length;
+    if (text.length <= budget) {
+        return { text, truncated: false, totalPages, shownPages: totalPages, truncatedChars: 0 };
+    }
+    let kept;
+    let shownPages;
+    let partialLastPage = false;
+    if (totalPages === 0) {
+        // No page markers: treat the whole text as one block and cut at a line.
+        kept = cutAtLineBoundary(text, budget);
+        shownPages = 0;
+    }
+    else {
+        // Accumulate the preamble (anything before the first marker) plus whole
+        // pages, in order, while they fit.
+        const preambleEnd = chunks[0].start;
+        shownPages = 0;
+        let end = preambleEnd;
+        for (let i = 0; i < chunks.length; i++) {
+            const pageEnd = i + 1 < chunks.length ? chunks[i + 1].start : text.length;
+            if (pageEnd > budget)
+                break;
+            end = pageEnd;
+            shownPages++;
+        }
+        if (shownPages === 0) {
+            // Even the first page does not fit: cut inside it so at least the
+            // document head and the first page's opening survive.
+            kept = cutAtLineBoundary(text, budget);
+            shownPages = 1;
+            partialLastPage = true;
+        }
+        else {
+            kept = text.slice(0, end);
+        }
+    }
+    const omittedTitles = chunks.slice(shownPages).map((chunk) => chunk.title);
+    const notice = buildNotice({
+        shownPages,
+        totalPages,
+        keptChars: kept.length,
+        fullChars: text.length,
+        omittedTitles,
+        partialLastPage,
+    });
+    return {
+        text: `${kept}\n\n${notice}`,
+        truncated: true,
+        totalPages,
+        shownPages,
+        truncatedChars: text.length - kept.length,
+    };
+}
+/** Strip outline numbers copied from structure TOC (e.g. `4.4 Extension System` → `Extension System`). */
+export function normalizePageRef(pageRef) {
+    if (typeof pageRef === "number")
+        return pageRef;
+    const trimmed = pageRef.trim();
+    if (!trimmed)
+        return trimmed;
+    const stripped = trimmed.replace(/^\d+(?:\.\d+)*\s+/, "");
+    return stripped.length > 0 ? stripped : trimmed;
+}
+/**
+ * Slice one wiki page out of a full contents response. `pageRef` is matched
+ * leniently, in this order: case-insensitive exact title, unique partial
+ * title, or a 1-based index for purely numeric refs (matching the order shown
+ * by structure and truncation notices). No match (or a wiki without page
+ * markers) returns just the title list so the caller can report what exists.
+ */
+export function extractPage(text, pageRef) {
+    const chunks = pageOffsets(text);
+    const titles = chunks.map((chunk) => chunk.title);
+    if (chunks.length === 0)
+        return { titles };
+    const normalized = normalizePageRef(pageRef);
+    const ref = String(normalized).trim();
+    let idx = -1;
+    if (typeof normalized === "number" || /^\d+$/.test(ref)) {
+        const ordinal = typeof normalized === "number" ? normalized : Number.parseInt(ref, 10);
+        if (ordinal >= 1 && ordinal <= chunks.length)
+            idx = ordinal - 1;
+    }
+    else if (ref) {
+        const lower = ref.toLowerCase();
+        idx = titles.findIndex((title) => title.toLowerCase() === lower);
+        if (idx === -1) {
+            const partial = titles.reduce((acc, title, i) => {
+                if (title.toLowerCase().includes(lower))
+                    acc.push(i);
+                return acc;
+            }, []);
+            if (partial.length === 1)
+                idx = partial[0];
+        }
+    }
+    if (idx === -1)
+        return { titles };
+    const start = chunks[idx].start;
+    const end = idx + 1 < chunks.length ? chunks[idx + 1].start : text.length;
+    return { found: { title: titles[idx], text: text.slice(start, end), index: idx + 1 }, titles };
+}
+//# sourceMappingURL=contents.js.map

package/dist/extensions/deepwiki/contents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contents.js","sourceRoot":"","sources":["../../../src/extensions/deepwiki/contents.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * contents.ts — page-boundary truncation for deepwiki `contents` responses.\n *\n * Zero-import pure module so `node scratch/<x>.ts` can drive it directly (this\n * repo has no node_modules; bare-package imports would fail to resolve there).\n * client.ts imports PAGE_HEADER_RE from here, so page-title extraction and\n * truncation chunking share one definition and cannot drift apart.\n *\n * Model-facing output must stay bounded: a full generated wiki can reach\n * hundreds of KB. Past CONTENTS_CHAR_BUDGET the text is cut at \"# Page:\"\n * boundaries — whole pages are kept in order, at least the beginning of the\n * first page always survives — and a trailing notice states what was omitted\n * and how to get it (read a single page via the `page` parameter, or ask a\n * focused question). extractPage implements that single-page read: upstream\n * has no per-page fetch, so a page is sliced locally out of the full text.\n *\n * Determinism matters: callDeepWiki caches the FULL response and the caller\n * re-truncates on every call, so cached and fresh calls must produce\n * byte-identical text. Pure function + constant budget guarantees that.\n */\n\n/** Page-header line of a DeepWiki contents response (\"# Page: <title>\"). */\nexport const PAGE_HEADER_RE = /^#\\s+Page:\\s+(.+)$/;\n\nexport const CONTENTS_CHAR_BUDGET = 120_000;\n\n/** Cap for omitted page titles inside the notice — the notice itself is bounded. */\nconst OMITTED_TITLES_MAX = 20;\n\nexport interface ContentsTruncation {\n\t/** Truncated body plus trailing notice; equals the input when not truncated. */\n\ttext: string;\n\ttruncated: boolean;\n\t/** Page chunks found in the full text (0 = no \"# Page:\" markers). */\n\ttotalPages: number;\n\t/** Pages fully or partially shown (a mid-page cut still counts its page). */\n\tshownPages: number;\n\t/** Body characters dropped by the cut (the notice is not counted). */\n\ttruncatedChars: number;\n}\n\ninterface PageChunk {\n\ttitle: string;\n\tstart: number;\n}\n\n/** Locate every page-header line as a character offset into the full text. */\nfunction pageOffsets(text: string): PageChunk[] {\n\tconst re = new RegExp(PAGE_HEADER_RE.source, \"gm\");\n\tconst chunks: PageChunk[] = [];\n\tlet match = re.exec(text);\n\twhile (match !== null) {\n\t\tchunks.push({ title: match[1]!.trim(), start: match.index });\n\t\tmatch = re.exec(text);\n\t}\n\treturn chunks;\n}\n\n/**\n * Hard-cut `text` to at most `budget` chars, preferring the last newline within\n * the budget so the cut lands between lines. A newline too close to the start\n * (< 40% of the budget) is ignored — a hard cut keeps more content than a tiny\n * stub, using the same word-boundary heuristic as other bounded text output.\n */\nfunction cutAtLineBoundary(text: string, budget: number): string {\n\tif (text.length <= budget) return text;\n\tconst slice = text.slice(0, budget);\n\tconst lastNewline = slice.lastIndexOf(\"\\n\");\n\treturn lastNewline >= Math.floor(budget * 0.4) ? slice.slice(0, lastNewline) : slice;\n}\n\nfunction buildNotice(opts: {\n\tshownPages: number;\n\ttotalPages: number;\n\tkeptChars: number;\n\tfullChars: number;\n\tomittedTitles: string[];\n\tpartialLastPage: boolean;\n}): string {\n\tconst pagesPart =\n\t\topts.totalPages > 0 ? `showing ${opts.shownPages} of ${opts.totalPages} pages` : \"showing the beginning\";\n\tconst lines = [`[DeepWiki contents truncated — ${pagesPart} (${opts.keptChars} of ${opts.fullChars} chars).`];\n\tif (opts.partialLastPage) lines.push(\"The last shown page is itself truncated.\");\n\tif (opts.omittedTitles.length > 0) {\n\t\tconst shown = opts.omittedTitles.slice(0, OMITTED_TITLES_MAX).join(\"; \");\n\t\tconst more = opts.omittedTitles.length - OMITTED_TITLES_MAX;\n\t\tlines.push(`Omitted pages: ${shown}${more > 0 ? ` … +${more} more` : \"\"}.`);\n\t\tlines.push(\n\t\t\t`Read an omitted page with {action: \"contents\", page: \"<title>\"}, or use action \"question\" for a targeted answer.]`,\n\t\t);\n\t} else {\n\t\tlines.push(`For the missing remainder, use action \"question\" with a focused question.]`);\n\t}\n\treturn lines.join(\"\\n\");\n}\n\n/**\n * Truncate a contents response to `budget` chars at page boundaries and append\n * an omission notice. Below budget the input is returned untouched.\n */\nexport function truncateContentsByPages(text: string, budget = CONTENTS_CHAR_BUDGET): ContentsTruncation {\n\tconst chunks = pageOffsets(text);\n\tconst totalPages = chunks.length;\n\n\tif (text.length <= budget) {\n\t\treturn { text, truncated: false, totalPages, shownPages: totalPages, truncatedChars: 0 };\n\t}\n\n\tlet kept: string;\n\tlet shownPages: number;\n\tlet partialLastPage = false;\n\n\tif (totalPages === 0) {\n\t\t// No page markers: treat the whole text as one block and cut at a line.\n\t\tkept = cutAtLineBoundary(text, budget);\n\t\tshownPages = 0;\n\t} else {\n\t\t// Accumulate the preamble (anything before the first marker) plus whole\n\t\t// pages, in order, while they fit.\n\t\tconst preambleEnd = chunks[0]!.start;\n\t\tshownPages = 0;\n\t\tlet end = preambleEnd;\n\t\tfor (let i = 0; i < chunks.length; i++) {\n\t\t\tconst pageEnd = i + 1 < chunks.length ? chunks[i + 1]!.start : text.length;\n\t\t\tif (pageEnd > budget) break;\n\t\t\tend = pageEnd;\n\t\t\tshownPages++;\n\t\t}\n\t\tif (shownPages === 0) {\n\t\t\t// Even the first page does not fit: cut inside it so at least the\n\t\t\t// document head and the first page's opening survive.\n\t\t\tkept = cutAtLineBoundary(text, budget);\n\t\t\tshownPages = 1;\n\t\t\tpartialLastPage = true;\n\t\t} else {\n\t\t\tkept = text.slice(0, end);\n\t\t}\n\t}\n\n\tconst omittedTitles = chunks.slice(shownPages).map((chunk) => chunk.title);\n\tconst notice = buildNotice({\n\t\tshownPages,\n\t\ttotalPages,\n\t\tkeptChars: kept.length,\n\t\tfullChars: text.length,\n\t\tomittedTitles,\n\t\tpartialLastPage,\n\t});\n\n\treturn {\n\t\ttext: `${kept}\\n\\n${notice}`,\n\t\ttruncated: true,\n\t\ttotalPages,\n\t\tshownPages,\n\t\ttruncatedChars: text.length - kept.length,\n\t};\n}\n\nexport interface PageSlice {\n\t/** Resolved page title as it appears in the header line. */\n\ttitle: string;\n\t/** Page text from its header line up to the next page header (or EOF). */\n\ttext: string;\n\t/** 1-based position among the page chunks. */\n\tindex: number;\n}\n\nexport interface PageLookup {\n\tfound?: PageSlice;\n\t/** All page titles in document order — for self-healing not-found errors. */\n\ttitles: string[];\n}\n\n/** Strip outline numbers copied from structure TOC (e.g. `4.4 Extension System` → `Extension System`). */\nexport function normalizePageRef(pageRef: string | number): string | number {\n\tif (typeof pageRef === \"number\") return pageRef;\n\tconst trimmed = pageRef.trim();\n\tif (!trimmed) return trimmed;\n\tconst stripped = trimmed.replace(/^\\d+(?:\\.\\d+)*\\s+/, \"\");\n\treturn stripped.length > 0 ? stripped : trimmed;\n}\n\n/**\n * Slice one wiki page out of a full contents response. `pageRef` is matched\n * leniently, in this order: case-insensitive exact title, unique partial\n * title, or a 1-based index for purely numeric refs (matching the order shown\n * by structure and truncation notices). No match (or a wiki without page\n * markers) returns just the title list so the caller can report what exists.\n */\nexport function extractPage(text: string, pageRef: string | number): PageLookup {\n\tconst chunks = pageOffsets(text);\n\tconst titles = chunks.map((chunk) => chunk.title);\n\tif (chunks.length === 0) return { titles };\n\n\tconst normalized = normalizePageRef(pageRef);\n\tconst ref = String(normalized).trim();\n\tlet idx = -1;\n\tif (typeof normalized === \"number\" || /^\\d+$/.test(ref)) {\n\t\tconst ordinal = typeof normalized === \"number\" ? normalized : Number.parseInt(ref, 10);\n\t\tif (ordinal >= 1 && ordinal <= chunks.length) idx = ordinal - 1;\n\t} else if (ref) {\n\t\tconst lower = ref.toLowerCase();\n\t\tidx = titles.findIndex((title) => title.toLowerCase() === lower);\n\t\tif (idx === -1) {\n\t\t\tconst partial = titles.reduce<number[]>((acc, title, i) => {\n\t\t\t\tif (title.toLowerCase().includes(lower)) acc.push(i);\n\t\t\t\treturn acc;\n\t\t\t}, []);\n\t\t\tif (partial.length === 1) idx = partial[0]!;\n\t\t}\n\t}\n\tif (idx === -1) return { titles };\n\n\tconst start = chunks[idx]!.start;\n\tconst end = idx + 1 < chunks.length ? chunks[idx + 1]!.start : text.length;\n\treturn { found: { title: titles[idx]!, text: text.slice(start, end), index: idx + 1 }, titles };\n}\n"]}

package/dist/extensions/deepwiki/execute.d.ts

@@ -0,0 +1,25 @@
+import type { AgentToolResult, AgentToolUpdateCallback } from "../../core/extensions/types.ts";
+import { type DeepWikiAction, type DeepWikiParams } from "./schema.ts";
+export interface DeepWikiDetails {
+    action: DeepWikiAction;
+    repoName: string;
+    repoNames?: string[];
+    question?: string;
+    toolName?: string;
+    outputLength?: number;
+    cacheHit?: boolean;
+    pageCount?: number;
+    pageTitles?: string[];
+    /** Resolved title and 1-based position of a single-page contents read. */
+    requestedPage?: string;
+    pageIndex?: number;
+    /** Set only when a contents response was truncated to the char budget. */
+    shownPages?: number;
+    truncatedChars?: number;
+    /** Legacy fields kept so older session entries still render. */
+    sectionCount?: number;
+    sectionTitles?: string[];
+    errorMessage?: string;
+}
+export declare function executeDeepWiki(params: DeepWikiParams, signal: AbortSignal | undefined, onUpdate: AgentToolUpdateCallback<DeepWikiDetails> | undefined): Promise<AgentToolResult<DeepWikiDetails>>;
+//# sourceMappingURL=execute.d.ts.map

package/dist/extensions/deepwiki/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../src/extensions/deepwiki/execute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAI/F,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAA2B,MAAM,aAAa,CAAC;AAEhG,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAoBD,wBAAsB,eAAe,CACpC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,QAAQ,EAAE,uBAAuB,CAAC,eAAe,CAAC,GAAG,SAAS,GAC5D,OAAO,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC,CAkE3C","sourcesContent":["import type { AgentToolResult, AgentToolUpdateCallback } from \"../../core/extensions/types.ts\";\n\nimport { callDeepWiki, type DeepWikiResponse } from \"./client.ts\";\nimport { extractPage, truncateContentsByPages } from \"./contents.ts\";\nimport { type DeepWikiAction, type DeepWikiParams, normalizeDeepWikiParams } from \"./schema.ts\";\n\nexport interface DeepWikiDetails {\n\taction: DeepWikiAction;\n\trepoName: string;\n\trepoNames?: string[];\n\tquestion?: string;\n\ttoolName?: string;\n\toutputLength?: number;\n\tcacheHit?: boolean;\n\tpageCount?: number;\n\tpageTitles?: string[];\n\t/** Resolved title and 1-based position of a single-page contents read. */\n\trequestedPage?: string;\n\tpageIndex?: number;\n\t/** Set only when a contents response was truncated to the char budget. */\n\tshownPages?: number;\n\ttruncatedChars?: number;\n\t/** Legacy fields kept so older session entries still render. */\n\tsectionCount?: number;\n\tsectionTitles?: string[];\n\terrorMessage?: string;\n}\n\nfunction buildResult(\n\tparams: DeepWikiParams,\n\ttext: string,\n\textra: Partial<DeepWikiDetails> = {},\n): AgentToolResult<DeepWikiDetails> {\n\tconst repoNames = Array.isArray(params.repoName) ? params.repoName : [params.repoName];\n\treturn {\n\t\tcontent: [{ type: \"text\", text }],\n\t\tdetails: {\n\t\t\taction: params.action,\n\t\t\trepoName: repoNames.join(\", \"),\n\t\t\t...(repoNames.length > 1 ? { repoNames } : {}),\n\t\t\t...(params.question ? { question: params.question } : {}),\n\t\t\t...extra,\n\t\t},\n\t};\n}\n\nexport async function executeDeepWiki(\n\tparams: DeepWikiParams,\n\tsignal: AbortSignal | undefined,\n\tonUpdate: AgentToolUpdateCallback<DeepWikiDetails> | undefined,\n): Promise<AgentToolResult<DeepWikiDetails>> {\n\tconst normalizedParams = normalizeDeepWikiParams(params);\n\tconst repoLabel = Array.isArray(normalizedParams.repoName)\n\t\t? normalizedParams.repoName.join(\", \")\n\t\t: normalizedParams.repoName;\n\n\tonUpdate?.(buildResult(normalizedParams, `Querying DeepWiki for ${repoLabel}...`));\n\n\tlet response: DeepWikiResponse;\n\ttry {\n\t\tresponse = await callDeepWiki(normalizedParams, signal);\n\t} catch (error) {\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\tthrow new Error(`DeepWiki call failed: ${message}`);\n\t}\n\n\tconst extra: Partial<DeepWikiDetails> = {\n\t\ttoolName: response.toolName,\n\t\toutputLength: response.outputLength,\n\t\t...(response.cacheHit ? { cacheHit: true } : {}),\n\t\t...(response.pageTitles\n\t\t\t? {\n\t\t\t\t\tpageCount: response.pageTitles.length,\n\t\t\t\t\tpageTitles: response.pageTitles,\n\t\t\t\t}\n\t\t\t: {}),\n\t};\n\n\t// Bounded model-facing output: the cache keeps the full response\n\t// (outputLength/pageTitles describe it); only the returned text is cut.\n\t// truncateContentsByPages/extractPage are deterministic, so cached and\n\t// fresh calls produce identical text.\n\tlet resultText = response.text;\n\tif (normalizedParams.action === \"contents\") {\n\t\tif (normalizedParams.page !== undefined) {\n\t\t\t// Single-page read: upstream has no per-page fetch, so slice the page\n\t\t\t// out of the (cached) full wiki locally.\n\t\t\tconst lookup = extractPage(response.text, normalizedParams.page);\n\t\t\tif (!lookup.found) {\n\t\t\t\tif (lookup.titles.length === 0) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t`page \"${normalizedParams.page}\" not found: this wiki has no page structure. Call contents without page.`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tconst list = lookup.titles.slice(0, 30).join(\"; \");\n\t\t\t\tconst more = lookup.titles.length > 30 ? ` … +${lookup.titles.length - 30} more` : \"\";\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`page \"${normalizedParams.page}\" not found in ${repoLabel} wiki (${lookup.titles.length} pages).\\nAvailable pages: ${list}${more}`,\n\t\t\t\t);\n\t\t\t}\n\t\t\tconst truncation = truncateContentsByPages(lookup.found.text);\n\t\t\tresultText = truncation.text;\n\t\t\textra.requestedPage = lookup.found.title;\n\t\t\textra.pageIndex = lookup.found.index;\n\t\t\tif (truncation.truncated) extra.truncatedChars = truncation.truncatedChars;\n\t\t} else {\n\t\t\tconst truncation = truncateContentsByPages(response.text);\n\t\t\tif (truncation.truncated) {\n\t\t\t\tresultText = truncation.text;\n\t\t\t\textra.shownPages = truncation.shownPages;\n\t\t\t\textra.truncatedChars = truncation.truncatedChars;\n\t\t\t}\n\t\t}\n\t}\n\n\treturn buildResult(normalizedParams, resultText, extra);\n}\n"]}

package/dist/extensions/deepwiki/execute.js

@@ -0,0 +1,78 @@
+import { callDeepWiki } from "./client.js";
+import { extractPage, truncateContentsByPages } from "./contents.js";
+import { normalizeDeepWikiParams } from "./schema.js";
+function buildResult(params, text, extra = {}) {
+    const repoNames = Array.isArray(params.repoName) ? params.repoName : [params.repoName];
+    return {
+        content: [{ type: "text", text }],
+        details: {
+            action: params.action,
+            repoName: repoNames.join(", "),
+            ...(repoNames.length > 1 ? { repoNames } : {}),
+            ...(params.question ? { question: params.question } : {}),
+            ...extra,
+        },
+    };
+}
+export async function executeDeepWiki(params, signal, onUpdate) {
+    const normalizedParams = normalizeDeepWikiParams(params);
+    const repoLabel = Array.isArray(normalizedParams.repoName)
+        ? normalizedParams.repoName.join(", ")
+        : normalizedParams.repoName;
+    onUpdate?.(buildResult(normalizedParams, `Querying DeepWiki for ${repoLabel}...`));
+    let response;
+    try {
+        response = await callDeepWiki(normalizedParams, signal);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`DeepWiki call failed: ${message}`);
+    }
+    const extra = {
+        toolName: response.toolName,
+        outputLength: response.outputLength,
+        ...(response.cacheHit ? { cacheHit: true } : {}),
+        ...(response.pageTitles
+            ? {
+                pageCount: response.pageTitles.length,
+                pageTitles: response.pageTitles,
+            }
+            : {}),
+    };
+    // Bounded model-facing output: the cache keeps the full response
+    // (outputLength/pageTitles describe it); only the returned text is cut.
+    // truncateContentsByPages/extractPage are deterministic, so cached and
+    // fresh calls produce identical text.
+    let resultText = response.text;
+    if (normalizedParams.action === "contents") {
+        if (normalizedParams.page !== undefined) {
+            // Single-page read: upstream has no per-page fetch, so slice the page
+            // out of the (cached) full wiki locally.
+            const lookup = extractPage(response.text, normalizedParams.page);
+            if (!lookup.found) {
+                if (lookup.titles.length === 0) {
+                    throw new Error(`page "${normalizedParams.page}" not found: this wiki has no page structure. Call contents without page.`);
+                }
+                const list = lookup.titles.slice(0, 30).join("; ");
+                const more = lookup.titles.length > 30 ? ` … +${lookup.titles.length - 30} more` : "";
+                throw new Error(`page "${normalizedParams.page}" not found in ${repoLabel} wiki (${lookup.titles.length} pages).\nAvailable pages: ${list}${more}`);
+            }
+            const truncation = truncateContentsByPages(lookup.found.text);
+            resultText = truncation.text;
+            extra.requestedPage = lookup.found.title;
+            extra.pageIndex = lookup.found.index;
+            if (truncation.truncated)
+                extra.truncatedChars = truncation.truncatedChars;
+        }
+        else {
+            const truncation = truncateContentsByPages(response.text);
+            if (truncation.truncated) {
+                resultText = truncation.text;
+                extra.shownPages = truncation.shownPages;
+                extra.truncatedChars = truncation.truncatedChars;
+            }
+        }
+    }
+    return buildResult(normalizedParams, resultText, extra);
+}
+//# sourceMappingURL=execute.js.map

package/dist/extensions/deepwiki/execute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../../src/extensions/deepwiki/execute.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAyB,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAA4C,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAwBhG,SAAS,WAAW,CACnB,MAAsB,EACtB,IAAY,EACZ,KAAK,GAA6B,EAAE,EACD;IACnC,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACvF,OAAO;QACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACjC,OAAO,EAAE;YACR,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;YAC9B,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9C,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,GAAG,KAAK;SACR;KACD,CAAC;AAAA,CACF;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACpC,MAAsB,EACtB,MAA+B,EAC/B,QAA8D,EAClB;IAC5C,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC;QACzD,CAAC,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;QACtC,CAAC,CAAC,gBAAgB,CAAC,QAAQ,CAAC;IAE7B,QAAQ,EAAE,CAAC,WAAW,CAAC,gBAAgB,EAAE,yBAAyB,SAAS,KAAK,CAAC,CAAC,CAAC;IAEnF,IAAI,QAA0B,CAAC;IAC/B,IAAI,CAAC;QACJ,QAAQ,GAAG,MAAM,YAAY,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;IACzD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,yBAAyB,OAAO,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,MAAM,KAAK,GAA6B;QACvC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,YAAY,EAAE,QAAQ,CAAC,YAAY;QACnC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChD,GAAG,CAAC,QAAQ,CAAC,UAAU;YACtB,CAAC,CAAC;gBACA,SAAS,EAAE,QAAQ,CAAC,UAAU,CAAC,MAAM;gBACrC,UAAU,EAAE,QAAQ,CAAC,UAAU;aAC/B;YACF,CAAC,CAAC,EAAE,CAAC;KACN,CAAC;IAEF,iEAAiE;IACjE,wEAAwE;IACxE,uEAAuE;IACvE,sCAAsC;IACtC,IAAI,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC/B,IAAI,gBAAgB,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QAC5C,IAAI,gBAAgB,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACzC,sEAAsE;YACtE,yCAAyC;YACzC,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;YACjE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBACnB,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAChC,MAAM,IAAI,KAAK,CACd,SAAS,gBAAgB,CAAC,IAAI,2EAA2E,CACzG,CAAC;gBACH,CAAC;gBACD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACnD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,SAAO,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtF,MAAM,IAAI,KAAK,CACd,SAAS,gBAAgB,CAAC,IAAI,kBAAkB,SAAS,UAAU,MAAM,CAAC,MAAM,CAAC,MAAM,8BAA8B,IAAI,GAAG,IAAI,EAAE,CAClI,CAAC;YACH,CAAC;YACD,MAAM,UAAU,GAAG,uBAAuB,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC9D,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC;YAC7B,KAAK,CAAC,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;YACzC,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;YACrC,IAAI,UAAU,CAAC,SAAS;gBAAE,KAAK,CAAC,cAAc,GAAG,UAAU,CAAC,cAAc,CAAC;QAC5E,CAAC;aAAM,CAAC;YACP,MAAM,UAAU,GAAG,uBAAuB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC1D,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;gBAC1B,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC;gBAC7B,KAAK,CAAC,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC;gBACzC,KAAK,CAAC,cAAc,GAAG,UAAU,CAAC,cAAc,CAAC;YAClD,CAAC;QACF,CAAC;IACF,CAAC;IAED,OAAO,WAAW,CAAC,gBAAgB,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;AAAA,CACxD","sourcesContent":["import type { AgentToolResult, AgentToolUpdateCallback } from \"../../core/extensions/types.ts\";\n\nimport { callDeepWiki, type DeepWikiResponse } from \"./client.ts\";\nimport { extractPage, truncateContentsByPages } from \"./contents.ts\";\nimport { type DeepWikiAction, type DeepWikiParams, normalizeDeepWikiParams } from \"./schema.ts\";\n\nexport interface DeepWikiDetails {\n\taction: DeepWikiAction;\n\trepoName: string;\n\trepoNames?: string[];\n\tquestion?: string;\n\ttoolName?: string;\n\toutputLength?: number;\n\tcacheHit?: boolean;\n\tpageCount?: number;\n\tpageTitles?: string[];\n\t/** Resolved title and 1-based position of a single-page contents read. */\n\trequestedPage?: string;\n\tpageIndex?: number;\n\t/** Set only when a contents response was truncated to the char budget. */\n\tshownPages?: number;\n\ttruncatedChars?: number;\n\t/** Legacy fields kept so older session entries still render. */\n\tsectionCount?: number;\n\tsectionTitles?: string[];\n\terrorMessage?: string;\n}\n\nfunction buildResult(\n\tparams: DeepWikiParams,\n\ttext: string,\n\textra: Partial<DeepWikiDetails> = {},\n): AgentToolResult<DeepWikiDetails> {\n\tconst repoNames = Array.isArray(params.repoName) ? params.repoName : [params.repoName];\n\treturn {\n\t\tcontent: [{ type: \"text\", text }],\n\t\tdetails: {\n\t\t\taction: params.action,\n\t\t\trepoName: repoNames.join(\", \"),\n\t\t\t...(repoNames.length > 1 ? { repoNames } : {}),\n\t\t\t...(params.question ? { question: params.question } : {}),\n\t\t\t...extra,\n\t\t},\n\t};\n}\n\nexport async function executeDeepWiki(\n\tparams: DeepWikiParams,\n\tsignal: AbortSignal | undefined,\n\tonUpdate: AgentToolUpdateCallback<DeepWikiDetails> | undefined,\n): Promise<AgentToolResult<DeepWikiDetails>> {\n\tconst normalizedParams = normalizeDeepWikiParams(params);\n\tconst repoLabel = Array.isArray(normalizedParams.repoName)\n\t\t? normalizedParams.repoName.join(\", \")\n\t\t: normalizedParams.repoName;\n\n\tonUpdate?.(buildResult(normalizedParams, `Querying DeepWiki for ${repoLabel}...`));\n\n\tlet response: DeepWikiResponse;\n\ttry {\n\t\tresponse = await callDeepWiki(normalizedParams, signal);\n\t} catch (error) {\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\tthrow new Error(`DeepWiki call failed: ${message}`);\n\t}\n\n\tconst extra: Partial<DeepWikiDetails> = {\n\t\ttoolName: response.toolName,\n\t\toutputLength: response.outputLength,\n\t\t...(response.cacheHit ? { cacheHit: true } : {}),\n\t\t...(response.pageTitles\n\t\t\t? {\n\t\t\t\t\tpageCount: response.pageTitles.length,\n\t\t\t\t\tpageTitles: response.pageTitles,\n\t\t\t\t}\n\t\t\t: {}),\n\t};\n\n\t// Bounded model-facing output: the cache keeps the full response\n\t// (outputLength/pageTitles describe it); only the returned text is cut.\n\t// truncateContentsByPages/extractPage are deterministic, so cached and\n\t// fresh calls produce identical text.\n\tlet resultText = response.text;\n\tif (normalizedParams.action === \"contents\") {\n\t\tif (normalizedParams.page !== undefined) {\n\t\t\t// Single-page read: upstream has no per-page fetch, so slice the page\n\t\t\t// out of the (cached) full wiki locally.\n\t\t\tconst lookup = extractPage(response.text, normalizedParams.page);\n\t\t\tif (!lookup.found) {\n\t\t\t\tif (lookup.titles.length === 0) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t`page \"${normalizedParams.page}\" not found: this wiki has no page structure. Call contents without page.`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tconst list = lookup.titles.slice(0, 30).join(\"; \");\n\t\t\t\tconst more = lookup.titles.length > 30 ? ` … +${lookup.titles.length - 30} more` : \"\";\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`page \"${normalizedParams.page}\" not found in ${repoLabel} wiki (${lookup.titles.length} pages).\\nAvailable pages: ${list}${more}`,\n\t\t\t\t);\n\t\t\t}\n\t\t\tconst truncation = truncateContentsByPages(lookup.found.text);\n\t\t\tresultText = truncation.text;\n\t\t\textra.requestedPage = lookup.found.title;\n\t\t\textra.pageIndex = lookup.found.index;\n\t\t\tif (truncation.truncated) extra.truncatedChars = truncation.truncatedChars;\n\t\t} else {\n\t\t\tconst truncation = truncateContentsByPages(response.text);\n\t\t\tif (truncation.truncated) {\n\t\t\t\tresultText = truncation.text;\n\t\t\t\textra.shownPages = truncation.shownPages;\n\t\t\t\textra.truncatedChars = truncation.truncatedChars;\n\t\t\t}\n\t\t}\n\t}\n\n\treturn buildResult(normalizedParams, resultText, extra);\n}\n"]}

package/dist/extensions/deepwiki/http.d.ts

@@ -0,0 +1,12 @@
+export interface FetchRetryOptions {
+    timeoutMs: number;
+    retries?: number;
+    signal?: AbortSignal;
+    label?: string;
+}
+/** Fetch with a per-attempt timeout and bounded retries for transient failures. */
+export declare function fetchWithRetry(url: string, request: RequestInit, options: FetchRetryOptions): Promise<{
+    response: Response;
+    text: string;
+}>;
+//# sourceMappingURL=http.d.ts.map

package/dist/extensions/deepwiki/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/extensions/deepwiki/http.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAyDD,mFAAmF;AACnF,wBAAsB,cAAc,CACnC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,iBAAiB,GACxB,OAAO,CAAC;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAuB/C","sourcesContent":["export interface FetchRetryOptions {\n\ttimeoutMs: number;\n\tretries?: number;\n\tsignal?: AbortSignal;\n\tlabel?: string;\n}\n\nfunction delay(milliseconds: number, label: string, signal: AbortSignal | undefined): Promise<void> {\n\treturn new Promise((resolve, reject) => {\n\t\tconst handleAbort = () => {\n\t\t\tcleanup();\n\t\t\treject(new Error(`${label} request aborted`));\n\t\t};\n\t\tconst timer = setTimeout(() => {\n\t\t\tcleanup();\n\t\t\tresolve();\n\t\t}, milliseconds);\n\t\tconst cleanup = () => {\n\t\t\tclearTimeout(timer);\n\t\t\tsignal?.removeEventListener(\"abort\", handleAbort);\n\t\t};\n\n\t\tif (signal?.aborted) {\n\t\t\thandleAbort();\n\t\t\treturn;\n\t\t}\n\t\tsignal?.addEventListener(\"abort\", handleAbort, { once: true });\n\t});\n}\n\nasync function attemptOnce(\n\turl: string,\n\trequest: RequestInit,\n\ttimeoutMs: number,\n\tlabel: string,\n\tsignal: AbortSignal | undefined,\n): Promise<{ ok: true; response: Response; text: string } | { ok: false; error: Error }> {\n\tconst controller = new AbortController();\n\tlet timedOut = false;\n\tconst abortFromParent = () => controller.abort(signal?.reason);\n\tconst timeout = setTimeout(() => {\n\t\ttimedOut = true;\n\t\tcontroller.abort();\n\t}, timeoutMs);\n\n\tif (signal?.aborted) abortFromParent();\n\telse signal?.addEventListener(\"abort\", abortFromParent, { once: true });\n\n\ttry {\n\t\tconst response = await fetch(url, { ...request, signal: controller.signal });\n\t\tconst text = await response.text();\n\t\treturn { ok: true, response, text };\n\t} catch (error) {\n\t\tif (timedOut) throw new Error(`${label} request timed out after ${timeoutMs / 1000}s`);\n\t\tif (signal?.aborted) throw new Error(`${label} request aborted`);\n\t\treturn { ok: false, error: error instanceof Error ? error : new Error(String(error)) };\n\t} finally {\n\t\tclearTimeout(timeout);\n\t\tsignal?.removeEventListener(\"abort\", abortFromParent);\n\t}\n}\n\n/** Fetch with a per-attempt timeout and bounded retries for transient failures. */\nexport async function fetchWithRetry(\n\turl: string,\n\trequest: RequestInit,\n\toptions: FetchRetryOptions,\n): Promise<{ response: Response; text: string }> {\n\tconst retries = options.retries ?? 2;\n\tconst label = options.label ?? \"HTTP\";\n\tlet lastError: Error | undefined;\n\n\tfor (let attemptIndex = 0; attemptIndex <= retries; attemptIndex++) {\n\t\tif (attemptIndex > 0) await delay(1000 * attemptIndex, label, options.signal);\n\t\tconst outcome = await attemptOnce(url, request, options.timeoutMs, label, options.signal);\n\t\tif (!outcome.ok) {\n\t\t\tlastError = outcome.error;\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst { response, text } = outcome;\n\t\tconst retryable = response.status >= 500 || response.status === 429;\n\t\tif (!response.ok && retryable && attemptIndex < retries) {\n\t\t\tlastError = new Error(`${label} HTTP ${response.status}`);\n\t\t\tcontinue;\n\t\t}\n\t\treturn { response, text };\n\t}\n\n\tthrow lastError ?? new Error(`${label} request failed`);\n}\n"]}

package/dist/extensions/deepwiki/http.js

@@ -0,0 +1,74 @@
+function delay(milliseconds, label, signal) {
+    return new Promise((resolve, reject) => {
+        const handleAbort = () => {
+            cleanup();
+            reject(new Error(`${label} request aborted`));
+        };
+        const timer = setTimeout(() => {
+            cleanup();
+            resolve();
+        }, milliseconds);
+        const cleanup = () => {
+            clearTimeout(timer);
+            signal?.removeEventListener("abort", handleAbort);
+        };
+        if (signal?.aborted) {
+            handleAbort();
+            return;
+        }
+        signal?.addEventListener("abort", handleAbort, { once: true });
+    });
+}
+async function attemptOnce(url, request, timeoutMs, label, signal) {
+    const controller = new AbortController();
+    let timedOut = false;
+    const abortFromParent = () => controller.abort(signal?.reason);
+    const timeout = setTimeout(() => {
+        timedOut = true;
+        controller.abort();
+    }, timeoutMs);
+    if (signal?.aborted)
+        abortFromParent();
+    else
+        signal?.addEventListener("abort", abortFromParent, { once: true });
+    try {
+        const response = await fetch(url, { ...request, signal: controller.signal });
+        const text = await response.text();
+        return { ok: true, response, text };
+    }
+    catch (error) {
+        if (timedOut)
+            throw new Error(`${label} request timed out after ${timeoutMs / 1000}s`);
+        if (signal?.aborted)
+            throw new Error(`${label} request aborted`);
+        return { ok: false, error: error instanceof Error ? error : new Error(String(error)) };
+    }
+    finally {
+        clearTimeout(timeout);
+        signal?.removeEventListener("abort", abortFromParent);
+    }
+}
+/** Fetch with a per-attempt timeout and bounded retries for transient failures. */
+export async function fetchWithRetry(url, request, options) {
+    const retries = options.retries ?? 2;
+    const label = options.label ?? "HTTP";
+    let lastError;
+    for (let attemptIndex = 0; attemptIndex <= retries; attemptIndex++) {
+        if (attemptIndex > 0)
+            await delay(1000 * attemptIndex, label, options.signal);
+        const outcome = await attemptOnce(url, request, options.timeoutMs, label, options.signal);
+        if (!outcome.ok) {
+            lastError = outcome.error;
+            continue;
+        }
+        const { response, text } = outcome;
+        const retryable = response.status >= 500 || response.status === 429;
+        if (!response.ok && retryable && attemptIndex < retries) {
+            lastError = new Error(`${label} HTTP ${response.status}`);
+            continue;
+        }
+        return { response, text };
+    }
+    throw lastError ?? new Error(`${label} request failed`);
+}
+//# sourceMappingURL=http.js.map