@astralyn/pi 0.84.12 → 0.84.14

package/dist/extensions/web-search/results.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"results.js","sourceRoot":"","sources":["../../../src/extensions/web-search/results.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Result normalization, bounding, deduplication, and ranking for web_search providers.\n */\n\nimport type { ProviderSearchResult, SearchEngineSource, WebSearchHit } from \"./types.ts\";\n\nexport const MAX_OUTPUT_HITS = 12;\nexport const MAX_QUERY_LENGTH = 500;\nexport const MAX_TITLE_LENGTH = 200;\nexport const MAX_URL_LENGTH = 2048;\nexport const MAX_SNIPPET_LENGTH = 200;\nexport const MAX_DATE_LENGTH = 100;\nexport const MAX_RELATED_SEARCHES = 8;\nexport const MAX_RELATED_SEARCH_LENGTH = 200;\nexport const MAX_SYNTHESIS_LENGTH = 6000;\nexport const MAX_ERROR_MESSAGE_LENGTH = 500;\n\nconst RRF_K = 60;\nconst TRACKING_PARAMS = new Set([\n\t\"utm_source\",\n\t\"utm_medium\",\n\t\"utm_campaign\",\n\t\"utm_term\",\n\t\"utm_content\",\n\t\"ref\",\n\t\"fbclid\",\n\t\"gclid\",\n\t\"trk\",\n\t\"gi\",\n]);\n\ninterface FusionCandidate {\n\thit: WebSearchHit;\n\tranks: Map<SearchEngineSource, number>;\n}\n\nexport interface FusedSearchResults {\n\thits: WebSearchHit[];\n\trelatedSearches?: string[];\n\tdeepseekSynthesis?: string;\n}\n\nfunction truncateText(text: string, maxLength: number): string {\n\tif (text.length <= maxLength) return text;\n\tif (maxLength <= 3) return text.slice(0, maxLength);\n\treturn `${text.slice(0, maxLength - 3).trimEnd()}...`;\n}\n\n/** Normalize and bound a provider-controlled single-line text field. */\nexport function boundSingleLineText(value: string | undefined, maxLength: number): string | undefined {\n\tconst normalized = value?.replace(/\\s+/g, \" \").trim();\n\treturn normalized ? truncateText(normalized, maxLength) : undefined;\n}\n\n/** Trim and bound provider-controlled text that intentionally preserves lines. */\nexport function boundMultilineText(value: string | undefined, maxLength: number): string | undefined {\n\tconst normalized = value?.trim();\n\treturn normalized ? truncateText(normalized, maxLength) : undefined;\n}\n\n/** Normalize a usable HTTP(S) source URL without changing non-tracking query values. */\nexport function normalizeUrl(rawUrl: string): string | undefined {\n\tconst trimmed = rawUrl.trim();\n\tif (!trimmed || trimmed.length > MAX_URL_LENGTH) return undefined;\n\n\ttry {\n\t\tconst url = new URL(trimmed);\n\t\tif (url.protocol !== \"http:\" && url.protocol !== \"https:\") return undefined;\n\t\turl.hash = \"\";\n\t\tfor (const parameter of TRACKING_PARAMS) {\n\t\t\tif (url.searchParams.has(parameter)) url.searchParams.delete(parameter);\n\t\t}\n\t\tif (url.pathname.length > 1 && url.pathname.endsWith(\"/\")) {\n\t\t\turl.pathname = url.pathname.replace(/\\/+$/, \"\");\n\t\t}\n\t\tconst normalized = url.toString();\n\t\treturn normalized.length <= MAX_URL_LENGTH ? normalized : undefined;\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nfunction normalizeHit(hit: WebSearchHit, source: SearchEngineSource): WebSearchHit | undefined {\n\tconst url = normalizeUrl(hit.url);\n\tif (!url) return undefined;\n\n\treturn {\n\t\ttitle: boundSingleLineText(hit.title, MAX_TITLE_LENGTH) ?? url,\n\t\turl,\n\t\tsnippet: boundSingleLineText(hit.snippet, MAX_SNIPPET_LENGTH),\n\t\tdate: boundSingleLineText(hit.date, MAX_DATE_LENGTH),\n\t\tsources: [...new Set([...hit.sources, source])],\n\t};\n}\n\nfunction isUrlFallbackTitle(title: string, url: string): boolean {\n\tconst normalizedTitle = normalizeUrl(title);\n\treturn normalizedTitle !== undefined && normalizedTitle === normalizeUrl(url);\n}\n\nfunction reciprocalRankScore(candidate: FusionCandidate): number {\n\tlet score = 0;\n\tfor (const rank of candidate.ranks.values()) score += 1 / (RRF_K + rank);\n\treturn score;\n}\n\nfunction bestRank(candidate: FusionCandidate): number {\n\treturn Math.min(...candidate.ranks.values());\n}\n\n/** Bound provider results, deduplicate URLs, and rank them with reciprocal-rank fusion. */\nexport function fuseSearchHits(results: ProviderSearchResult[]): FusedSearchResults {\n\tconst candidates = new Map<string, FusionCandidate>();\n\tconst relatedSearches = new Set<string>();\n\tlet deepseekSynthesis: string | undefined;\n\n\tfor (const result of results) {\n\t\tfor (const related of result.relatedSearches ?? []) {\n\t\t\tif (relatedSearches.size >= MAX_RELATED_SEARCHES) break;\n\t\t\tconst normalized = boundSingleLineText(related, MAX_RELATED_SEARCH_LENGTH);\n\t\t\tif (normalized) relatedSearches.add(normalized);\n\t\t}\n\t\tconst synthesis = boundMultilineText(result.synthesisText, MAX_SYNTHESIS_LENGTH);\n\t\tif (synthesis) deepseekSynthesis = synthesis;\n\n\t\tfor (const [index, rawHit] of result.hits.entries()) {\n\t\t\tconst hit = normalizeHit(rawHit, result.source);\n\t\t\tif (!hit) continue;\n\t\t\tconst rank = index + 1;\n\t\t\tconst existing = candidates.get(hit.url);\n\n\t\t\tif (!existing) {\n\t\t\t\tcandidates.set(hit.url, { hit, ranks: new Map([[result.source, rank]]) });\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst previousRank = existing.ranks.get(result.source);\n\t\t\tif (previousRank === undefined || rank < previousRank) existing.ranks.set(result.source, rank);\n\t\t\tfor (const source of hit.sources) {\n\t\t\t\tif (!existing.hit.sources.includes(source)) existing.hit.sources.push(source);\n\t\t\t}\n\t\t\tif (isUrlFallbackTitle(existing.hit.title, existing.hit.url) && !isUrlFallbackTitle(hit.title, hit.url)) {\n\t\t\t\texisting.hit.title = hit.title;\n\t\t\t}\n\t\t\tif ((!existing.hit.snippet || existing.hit.snippet.length < (hit.snippet?.length ?? 0)) && hit.snippet) {\n\t\t\t\texisting.hit.snippet = hit.snippet;\n\t\t\t}\n\t\t\tif (!existing.hit.date && hit.date) existing.hit.date = hit.date;\n\t\t}\n\t}\n\n\tconst ranked = [...candidates.entries()]\n\t\t.sort(([leftUrl, left], [rightUrl, right]) => {\n\t\t\tconst scoreDifference = reciprocalRankScore(right) - reciprocalRankScore(left);\n\t\t\tif (scoreDifference !== 0) return scoreDifference;\n\t\t\tconst rankDifference = bestRank(left) - bestRank(right);\n\t\t\tif (rankDifference !== 0) return rankDifference;\n\t\t\treturn leftUrl.localeCompare(rightUrl);\n\t\t})\n\t\t.map(([, candidate]) => candidate.hit)\n\t\t.slice(0, MAX_OUTPUT_HITS);\n\n\treturn {\n\t\thits: ranked,\n\t\trelatedSearches: relatedSearches.size > 0 ? [...relatedSearches] : undefined,\n\t\tdeepseekSynthesis,\n\t};\n}\n"]}

package/dist/extensions/web-search/schema.d.ts

@@ -0,0 +1,10 @@
+/**
+ * schema.ts — TypeBox parameter schema and argument normalizer for web_search.
+ */
+import { type Static, Type } from "typebox";
+export declare const WebSearchParamsSchema: Type.TObject<{
+    query: Type.TString;
+}>;
+export type WebSearchParams = Static<typeof WebSearchParamsSchema>;
+export declare function normalizeWebSearchParams(raw: unknown): WebSearchParams;
+//# sourceMappingURL=schema.d.ts.map

package/dist/extensions/web-search/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/extensions/web-search/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAG5C,eAAO,MAAM,qBAAqB;;EAMhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEnE,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,eAAe,CAuBtE"}

package/dist/extensions/web-search/schema.js

@@ -0,0 +1,36 @@
+/**
+ * schema.ts — TypeBox parameter schema and argument normalizer for web_search.
+ */
+import { Type } from "typebox";
+import { MAX_QUERY_LENGTH } from "./results.js";
+export const WebSearchParamsSchema = Type.Object({
+    query: Type.String({
+        minLength: 1,
+        maxLength: MAX_QUERY_LENGTH,
+        description: "The search query. Aim for 3-5 keywords; include a year when freshness matters.",
+    }),
+});
+export function normalizeWebSearchParams(raw) {
+    if (typeof raw === "string") {
+        return { query: raw.trim() };
+    }
+    if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+        return { query: String(raw ?? "").trim() };
+    }
+    const record = raw;
+    let query = "";
+    if (typeof record.query === "string") {
+        query = record.query.trim();
+    }
+    else if (typeof record.q === "string") {
+        query = record.q.trim();
+    }
+    else if (typeof record.search_query === "string") {
+        query = record.search_query.trim();
+    }
+    else if (typeof record.prompt === "string") {
+        query = record.prompt.trim();
+    }
+    return { query };
+}
+//# sourceMappingURL=schema.js.map

package/dist/extensions/web-search/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/extensions/web-search/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAe,IAAI,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC;QAClB,SAAS,EAAE,CAAC;QACZ,SAAS,EAAE,gBAAgB;QAC3B,WAAW,EAAE,gFAAgF;KAC7F,CAAC;CACF,CAAC,CAAC;AAIH,MAAM,UAAU,wBAAwB,CAAC,GAAY;IACpD,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;IAC9B,CAAC;IAED,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;IAC5C,CAAC;IAED,MAAM,MAAM,GAAG,GAA8B,CAAC;IAE9C,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACtC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,CAAC;SAAM,IAAI,OAAO,MAAM,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;QACzC,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACzB,CAAC;SAAM,IAAI,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;QACpD,KAAK,GAAG,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;IACpC,CAAC;SAAM,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC9C,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,CAAC;AAClB,CAAC","sourcesContent":["/**\n * schema.ts — TypeBox parameter schema and argument normalizer for web_search.\n */\n\nimport { type Static, Type } from \"typebox\";\nimport { MAX_QUERY_LENGTH } from \"./results.ts\";\n\nexport const WebSearchParamsSchema = Type.Object({\n\tquery: Type.String({\n\t\tminLength: 1,\n\t\tmaxLength: MAX_QUERY_LENGTH,\n\t\tdescription: \"The search query. Aim for 3-5 keywords; include a year when freshness matters.\",\n\t}),\n});\n\nexport type WebSearchParams = Static<typeof WebSearchParamsSchema>;\n\nexport function normalizeWebSearchParams(raw: unknown): WebSearchParams {\n\tif (typeof raw === \"string\") {\n\t\treturn { query: raw.trim() };\n\t}\n\n\tif (!raw || typeof raw !== \"object\" || Array.isArray(raw)) {\n\t\treturn { query: String(raw ?? \"\").trim() };\n\t}\n\n\tconst record = raw as Record<string, unknown>;\n\n\tlet query = \"\";\n\tif (typeof record.query === \"string\") {\n\t\tquery = record.query.trim();\n\t} else if (typeof record.q === \"string\") {\n\t\tquery = record.q.trim();\n\t} else if (typeof record.search_query === \"string\") {\n\t\tquery = record.search_query.trim();\n\t} else if (typeof record.prompt === \"string\") {\n\t\tquery = record.prompt.trim();\n\t}\n\n\treturn { query };\n}\n"]}

package/dist/extensions/web-search/types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * types.ts — Type definitions for web_search extension providers and fusion engine.
+ */
+export type SearchEngineType = "minimax" | "deepseek" | "dual" | "none";
+export type SearchEngineSource = "MiniMax" | "DeepSeek";
+export interface WebSearchHit {
+    title: string;
+    url: string;
+    snippet?: string;
+    date?: string;
+    sources: SearchEngineSource[];
+}
+export interface WebSearchDetails {
+    query: string;
+    durationMs: number;
+    status: "success" | "error" | "disabled";
+    engine: SearchEngineType;
+    totalHits: number;
+    hits: WebSearchHit[];
+    relatedSearches?: string[];
+    deepseekSynthesis?: string;
+    errorMessage?: string;
+}
+/**
+ * MiniMax search credential. `host` is always present alongside `key` so
+ * callers never guard the two separately.
+ */
+export interface MiniMaxSearchCredential {
+    key: string;
+    host: string;
+}
+/**
+ * Resolved credentials: presence of a group means that engine is configured,
+ * so impossible states (mode without key, key without host) are unrepresentable.
+ * Use `configuredEngine()` from auth.ts to derive the SearchEngineType label.
+ */
+export interface ResolvedSearchCredentials {
+    minimax?: MiniMaxSearchCredential;
+    deepseek?: {
+        key: string;
+    };
+}
+export interface ProviderSearchResult {
+    source: SearchEngineSource;
+    hits: WebSearchHit[];
+    relatedSearches?: string[];
+    synthesisText?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/extensions/web-search/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/extensions/web-search/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AACxE,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,UAAU,CAAC;AAExD,MAAM,WAAW,YAAY;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;IACzC,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACzC,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAClC,QAAQ,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACpC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/extensions/web-search/types.js

@@ -0,0 +1,5 @@
+/**
+ * types.ts — Type definitions for web_search extension providers and fusion engine.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/extensions/web-search/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/extensions/web-search/types.ts"],"names":[],"mappings":"AAAA;;GAEG","sourcesContent":["/**\n * types.ts — Type definitions for web_search extension providers and fusion engine.\n */\n\nexport type SearchEngineType = \"minimax\" | \"deepseek\" | \"dual\" | \"none\";\nexport type SearchEngineSource = \"MiniMax\" | \"DeepSeek\";\n\nexport interface WebSearchHit {\n\ttitle: string;\n\turl: string;\n\tsnippet?: string;\n\tdate?: string;\n\tsources: SearchEngineSource[];\n}\n\nexport interface WebSearchDetails {\n\tquery: string;\n\tdurationMs: number;\n\tstatus: \"success\" | \"error\" | \"disabled\";\n\tengine: SearchEngineType;\n\ttotalHits: number;\n\thits: WebSearchHit[];\n\trelatedSearches?: string[];\n\tdeepseekSynthesis?: string;\n\terrorMessage?: string;\n}\n\n/**\n * MiniMax search credential. `host` is always present alongside `key` so\n * callers never guard the two separately.\n */\nexport interface MiniMaxSearchCredential {\n\tkey: string;\n\thost: string;\n}\n\n/**\n * Resolved credentials: presence of a group means that engine is configured,\n * so impossible states (mode without key, key without host) are unrepresentable.\n * Use `configuredEngine()` from auth.ts to derive the SearchEngineType label.\n */\nexport interface ResolvedSearchCredentials {\n\tminimax?: MiniMaxSearchCredential;\n\tdeepseek?: { key: string };\n}\n\nexport interface ProviderSearchResult {\n\tsource: SearchEngineSource;\n\thits: WebSearchHit[];\n\trelatedSearches?: string[];\n\tsynthesisText?: string;\n}\n"]}

package/docs/bundled/README.md

@@ -16,6 +16,7 @@ These hidden built-ins use the same public Extension API available to external e
 | [Statusline](extensions/statusline.md) | Footer status | Show concise extension-managed activity state |
 | [Subagent](extensions/subagent.md) | `subagent`, `/agents` | Delegate bounded work to isolated child Pi sessions |
 | [Todo](extensions/todo.md) | `todo`, `/todos` | Track ordered multi-step work in a compact one-line widget |
+| [Web Search](extensions/web-search.md) | `web_search` | Search the live web through MiniMax and DeepSeek with fused results |
 
 ## Context safety
 

package/docs/bundled/extensions/web-search.md

@@ -0,0 +1,46 @@
+# Web Search
+
+`web_search` is a Pi-native tool for querying live web information through MiniMax and DeepSeek search engines.
+
+When both engines are configured, searches run concurrently and results are fused with reciprocal-rank scoring: URLs are normalized (tracking parameters and fragments stripped), duplicates are merged, and high-ranked results from both engines remain represented.
+
+| Engine mode | Requirement |
+|---|---|
+| `dual` | Both MiniMax and DeepSeek keys configured |
+| `minimax` | Only a MiniMax key configured |
+| `deepseek` | Only a DeepSeek key configured |
+| `none` | No key found — the tool reports itself disabled |
+
+## Credentials
+
+Keys are resolved per provider through the runtime's canonical auth chain (`ModelRuntime.getAuth`: runtime API key → `auth.json` → `models.json` → environment). When no runtime is available (or it does not know the provider), the extension falls back to reading `auth.json` directly (provider IDs `minimax-cn`, `minimax`, `deepseek`, including command-configured keys such as `"!op read ..."`) and then the environment variables `MINIMAX_CN_API_KEY`, `MINIMAX_API_KEY`, `DEEPSEEK_API_KEY`.
+
+The MiniMax CN account (`minimax-cn`) is preferred over the global one (`minimax`) and selects the `api.minimaxi.com` search host; the global account uses `api.minimax.io`, overridable via `MINIMAX_API_HOST`.
+
+Configure with `/login minimax-cn` or `/login deepseek`, or by exporting the environment variables above.
+
+When no key is configured, `web_search` is removed from the model's tool set and system prompt entirely — the model never sees or calls it. This is re-evaluated on every session start (`startup`, `/new`, `/reload`, resume, fork), so a mid-session `/login` takes effect from the next session onward. The tool stays registered: it remains listed in `/tools` (where it can be force-enabled, in which case calls fail with the disabled message), and historical sessions render normally.
+
+## Usage
+
+### Parameters
+
+- `query`: the search query, up to 500 characters — 3–5 keywords work best; include a year when freshness matters.
+
+### Output
+
+The model-facing payload is Markdown containing up to 12 HTTP(S) source results. Titles and snippets are bounded to 200 characters each, source URLs to 2048 characters, DeepSeek synthesis to 6000 characters, and up to 8 related searches to 200 characters each. Results found by both providers are tagged as such; this means the URL appeared in both result sets, not that its claims were independently verified. When structured source URLs are present, the tool result reminds the model to cite the relevant URLs without prescribing a heading or response format.
+
+## Limits
+
+- With no configured key the tool is hidden from the model (see Credentials); the disabled message only appears when the tool was force-enabled via `/tools` without keys.
+- Engine failures are independent: if one engine errors, the other's results are still returned; the tool errors only when every configured engine fails.
+- MiniMax search uses the Coding Plan Search endpoint (`POST /v1/coding_plan/search`), which requires a Coding Plan key — a standard MiniMax API key may be rejected upstream.
+- DeepSeek search goes through the Anthropic-compatible endpoint (`/anthropic/v1/messages`, model `claude-sonnet-search`) with the server-side `web_search_20250305` tool; the request uses `max_tokens: 1024`, followed by the local output bound above.
+- Requests time out after 60 seconds (MiniMax) or 90 seconds (DeepSeek) and surface as Pi tool errors. Successful upstream response bodies are limited to 2 MiB, error bodies to 200 bytes, and model-facing error messages to 500 characters.
+
+## Implementation notes
+
+The extension keeps presentation Pi-native: the call line shows the query, in-flight renders show the engine label with elapsed time past 2s, the collapsed result shows hit count, engines, duration, and a top-domain preview with the configured expand hint, and expanding renders the result sections from `details` — without the model-facing agent directives — falling back to the raw payload for legacy entries.
+
+Credential resolution never inspects `getProviderAuthStatus` — that probe returns a truthy `AuthStatus` object even when nothing is configured and carries no key. Only `getAuth` returns usable key material.

package/docs/docs.json

@@ -84,6 +84,10 @@
           "title": "Todo",
           "path": "bundled/extensions/todo.md"
         },
+        {
+          "title": "Web Search",
+          "path": "bundled/extensions/web-search.md"
+        },
         {
           "title": "Bundled themes",
           "path": "bundled/themes.md"

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
 	"name": "@astralyn/pi",
-	"version": "0.84.12",
+	"version": "0.84.14",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "@astralyn/pi",
-			"version": "0.84.12",
+			"version": "0.84.14",
 			"license": "MIT",
 			"dependencies": {
 				"@earendil-works/pi-agent-core": "0.84.4",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@astralyn/pi",
-	"version": "0.84.12",
+	"version": "0.84.14",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"type": "module",
 	"piConfig": {