@astralyn/pi 0.84.12 → 0.84.13

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

@@ -0,0 +1,111 @@
+/**
+ * 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 MiniMaxOrganicHit {
+    title: string;
+    link: string;
+    snippet?: string;
+    date?: string;
+}
+export interface MiniMaxSearchResponse {
+    organic?: MiniMaxOrganicHit[];
+    related_searches?: {
+        query: string;
+    }[];
+    base_resp?: {
+        status_code: number;
+        status_msg: string;
+    };
+}
+export interface DeepSeekServerToolUseBlock {
+    type: "server_tool_use";
+    id: string;
+    name: "web_search";
+    input?: {
+        query?: string;
+    };
+}
+export interface DeepSeekWebSearchResultItem {
+    type: "web_search_result";
+    title: string;
+    url: string;
+    page_age?: string | null;
+    encrypted_content?: string;
+}
+export interface DeepSeekWebSearchToolResultBlock {
+    type: "web_search_tool_result";
+    tool_use_id: string;
+    content?: DeepSeekWebSearchResultItem[];
+}
+export interface DeepSeekTextBlock {
+    type: "text";
+    text?: string;
+    citations?: {
+        type: string;
+        title?: string;
+        url?: string;
+        cited_text?: string;
+    }[];
+}
+export type DeepSeekContentBlock = DeepSeekServerToolUseBlock | DeepSeekWebSearchToolResultBlock | DeepSeekTextBlock | {
+    type: string;
+    [key: string]: unknown;
+};
+export interface DeepSeekMessagesResponse {
+    id?: string;
+    type?: string;
+    role?: string;
+    model?: string;
+    content?: DeepSeekContentBlock[];
+    stop_reason?: string;
+    error?: {
+        type?: string;
+        message?: 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,iBAAiB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACrC,OAAO,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC9B,gBAAgB,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACvC,SAAS,CAAC,EAAE;QACX,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;KACnB,CAAC;CACF;AAED,MAAM,WAAW,0BAA0B;IAC1C,IAAI,EAAE,iBAAiB,CAAC;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3B;AAED,MAAM,WAAW,2BAA2B;IAC3C,IAAI,EAAE,mBAAmB,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gCAAgC;IAChD,IAAI,EAAE,wBAAwB,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,2BAA2B,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,CAAC;KACpB,EAAE,CAAC;CACJ;AAED,MAAM,MAAM,oBAAoB,GAC7B,0BAA0B,GAC1B,gCAAgC,GAChC,iBAAiB,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAE5C,MAAM,WAAW,wBAAwB;IACxC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACF;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 MiniMaxOrganicHit {\n\ttitle: string;\n\tlink: string;\n\tsnippet?: string;\n\tdate?: string;\n}\n\nexport interface MiniMaxSearchResponse {\n\torganic?: MiniMaxOrganicHit[];\n\trelated_searches?: { query: string }[];\n\tbase_resp?: {\n\t\tstatus_code: number;\n\t\tstatus_msg: string;\n\t};\n}\n\nexport interface DeepSeekServerToolUseBlock {\n\ttype: \"server_tool_use\";\n\tid: string;\n\tname: \"web_search\";\n\tinput?: { query?: string };\n}\n\nexport interface DeepSeekWebSearchResultItem {\n\ttype: \"web_search_result\";\n\ttitle: string;\n\turl: string;\n\tpage_age?: string | null;\n\tencrypted_content?: string;\n}\n\nexport interface DeepSeekWebSearchToolResultBlock {\n\ttype: \"web_search_tool_result\";\n\ttool_use_id: string;\n\tcontent?: DeepSeekWebSearchResultItem[];\n}\n\nexport interface DeepSeekTextBlock {\n\ttype: \"text\";\n\ttext?: string;\n\tcitations?: {\n\t\ttype: string;\n\t\ttitle?: string;\n\t\turl?: string;\n\t\tcited_text?: string;\n\t}[];\n}\n\nexport type DeepSeekContentBlock =\n\t| DeepSeekServerToolUseBlock\n\t| DeepSeekWebSearchToolResultBlock\n\t| DeepSeekTextBlock\n\t| { type: string; [key: string]: unknown };\n\nexport interface DeepSeekMessagesResponse {\n\tid?: string;\n\ttype?: string;\n\trole?: string;\n\tmodel?: string;\n\tcontent?: DeepSeekContentBlock[];\n\tstop_reason?: string;\n\terror?: {\n\t\ttype?: string;\n\t\tmessage?: string;\n\t};\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,50 @@
+# 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: URLs are normalized (tracking parameters and fragments stripped), duplicates merged, and hits verified by both engines rank first.
+
+| 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 — 3–5 keywords work best.
+- `allowed_domains`: optional list of domains to include (e.g. `["github.com", "react.dev"]`).
+- `blocked_domains`: optional list of domains to exclude.
+
+`allowed_domains` and `blocked_domains` are mutually exclusive; if both are supplied, `allowed_domains` wins. Domain filters apply both in the upstream query and as a local post-filter on result URLs (subdomains included).
+
+### Output
+
+The model-facing payload is Markdown containing up to 12 verified sources (snippets bounded to 200 characters each, dual-engine hits tagged), a DeepSeek synthesis section when available, and up to 8 related searches, followed by a requirement to cite a `Sources:` section.
+
+## 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 synthesis text is bounded by the request's `max_tokens` (1024).
+- Requests time out after 60 seconds (MiniMax) or 90 seconds (DeepSeek) and surface as Pi tool errors; upstream error bodies are truncated to 200 characters.
+
+## Implementation notes
+
+The extension keeps presentation Pi-native: the call line shows the query and active domain filters, 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/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
 	"name": "@astralyn/pi",
-	"version": "0.84.12",
+	"version": "0.84.13",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "@astralyn/pi",
-			"version": "0.84.12",
+			"version": "0.84.13",
 			"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.13",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"type": "module",
 	"piConfig": {