@aliou/pi-linkup 0.3.1 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @aliou/pi-linkup
 
+## 0.4.0
+
+### Minor Changes
+
+- 052fc2b: Add fast mode support to linkup_web_search tool. The depth parameter now accepts "fast", "standard", or "deep" modes:
+  - fast: Sub-second latency using pre-indexed atoms of information
+  - standard: Single iteration retrieval, balanced speed/depth (default)
+  - deep: Up to 10 iterations with chain-of-thought reasoning
+
+### Patch Changes
+
+- a238ba7: Add User-Agent header to all Linkup API requests for attribution.
+
 ## 0.3.1
 
 ### Patch Changes

package/README.md

@@ -2,6 +2,8 @@
 
 Web search and content fetching extension for [Pi](https://buildwithpi.ai/) using the [Linkup API](https://linkup.so).
 
+
+
 ## Features
 
 - `linkup_web_search` - Search the web, get relevant sources with content
@@ -9,6 +11,10 @@ Web search and content fetching extension for [Pi](https://buildwithpi.ai/) usin
 - `linkup_web_fetch` - Extract clean markdown from URLs
 - `/linkup:balance` - Check API credit balance
 
+
+https://github.com/user-attachments/assets/a0f131a4-d57c-4162-aeb5-ffc1a0a8d7ff
+
+
 ## Installation
 
 ### Get API Key

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aliou/pi-linkup",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/aliou/pi-linkup"
@@ -17,11 +17,15 @@
     ],
     "video": "https://assets.aliou.me/pi-extensions/demos/pi-linkup.mp4"
   },
+  "peerDependencies": {
+    "@mariozechner/pi-coding-agent": ">=0.52.7",
+    "@mariozechner/pi-ai": ">=0.52.7"
+  },
   "devDependencies": {
     "@biomejs/biome": "^2.3.13",
     "@changesets/cli": "^2.27.11",
-    "@mariozechner/pi-coding-agent": "0.51.0",
-    "@mariozechner/pi-tui": "0.51.0",
+    "@mariozechner/pi-coding-agent": "0.52.7",
+    "@mariozechner/pi-tui": "0.52.7",
     "@sinclair/typebox": "^0.34.48",
     "@types/node": "^25.0.10",
     "husky": "^9.1.7",

package/skills/linkup/SKILL.md

@@ -14,11 +14,14 @@ Web search and content fetching tools powered by Linkup API.
 Search the web and get sources with content snippets.
 
 ```
-linkup_web_search(query: string, deep?: boolean)
+linkup_web_search(query: string, depth?: "fast" | "standard" | "deep")
 ```
 
 - `query`: Be specific and detailed. Include context like dates, locations, company names.
-- `deep`: Use for complex research requiring multiple searches. Default: false (faster).
+- `depth`: Search depth mode. Default: "standard".
+  - `fast`: Sub-second latency, uses pre-indexed "atoms of information". Best for quick facts and simple lookups.
+  - `standard`: Single iteration retrieval. Balanced speed and depth for most queries.
+  - `deep`: Up to 10 iterations with chain-of-thought reasoning. Best for complex multi-step research (slower).
 
 **Use when:** Discovering information across multiple sources, researching topics, comparing perspectives.
 
@@ -68,18 +71,23 @@ linkup_web_fetch(url: string, renderJs?: boolean)
 - Location: "French company Total", "US market"
 - Specifics: company names, version numbers, exact terms
 
-## When to Use Deep Mode
+## Depth Mode Selection
 
-**Standard (default):** Simple questions, quick lookups, known topics.
+**Fast:** Sub-second responses for quick facts, simple lookups, known facts.
+
+**Standard (default):** Single iteration, balanced speed/depth for most queries.
 
 **Deep:** Complex research, multi-step queries, comprehensive coverage needed.
 
 ```
-// Standard - one search is enough
-linkup_web_search("Node.js 22 release date")
+// Fast - instant facts, sub-second
+linkup_web_search("Node.js 22 release date", depth: "fast")
+
+// Standard - balanced, one search iteration
+linkup_web_search("React useEffect cleanup best practices")
 
-// Deep - needs multiple searches
-linkup_web_search("comparison of Rust web frameworks performance benchmarks 2025", deep: true)
+// Deep - complex research, multiple iterations
+linkup_web_search("comparison of Rust web frameworks performance benchmarks 2025", depth: "deep")
 ```
 
 ## Common Patterns

package/src/client.ts

@@ -1,3 +1,5 @@
+import packageJson from "../package.json" with { type: "json" };
+
 import type {
   LinkupBalanceResponse,
   LinkupErrorResponse,
@@ -24,6 +26,7 @@ export class LinkupClient {
       headers: {
         Authorization: `Bearer ${this.apiKey}`,
         "Content-Type": "application/json",
+        "User-Agent": `pi-linkup/${packageJson.version} (+https://github.com/aliou/pi-linkup)`,
         ...options.headers,
       },
     });
@@ -41,7 +44,7 @@ export class LinkupClient {
 
   async search(params: {
     query: string;
-    depth: "standard" | "deep";
+    depth: "standard" | "deep" | "fast";
     outputType: "searchResults" | "sourcedAnswer";
   }): Promise<LinkupSearchResponse | LinkupSourcedAnswerResponse> {
     return this.request("/search", {

package/src/tools/web-search.ts

@@ -1,3 +1,4 @@
+import { StringEnum } from "@mariozechner/pi-ai";
 import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
 import { Text } from "@mariozechner/pi-tui";
 import { Type } from "@sinclair/typebox";
@@ -22,10 +23,10 @@ export function registerWebSearchTool(pi: ExtensionAPI) {
         description:
           "The search query. Be specific and detailed for best results.",
       }),
-      deep: Type.Optional(
-        Type.Boolean({
+      depth: Type.Optional(
+        StringEnum(["deep", "standard", "fast"], {
           description:
-            "Use deep search for comprehensive results (slower). Default: false (standard search).",
+            "Search depth: 'fast' for sub-second quick facts, 'standard' (default) for balanced speed/depth, 'deep' for comprehensive multi-step research (slower).",
         }),
       ),
     }),
@@ -38,7 +39,7 @@ export function registerWebSearchTool(pi: ExtensionAPI) {
           content: [
             {
               type: "text",
-              text: `Searching${params.deep ? " (deep mode)" : ""}...`,
+              text: `Searching${params.depth && params.depth !== "standard" ? ` (${params.depth} mode)` : ""}...`,
             },
           ],
           details: {},
@@ -46,7 +47,7 @@ export function registerWebSearchTool(pi: ExtensionAPI) {
 
         const response = (await client.search({
           query: params.query,
-          depth: params.deep ? "deep" : "standard",
+          depth: (params.depth ?? "standard") as "standard" | "deep" | "fast",
           outputType: "searchResults",
         })) as LinkupSearchResponse;
 
@@ -77,8 +78,8 @@ export function registerWebSearchTool(pi: ExtensionAPI) {
     renderCall(args, theme) {
       let text = theme.fg("toolTitle", theme.bold("Linkup: WebSearch "));
       text += theme.fg("accent", `"${args.query}"`);
-      if (args.deep) {
-        text += theme.fg("dim", " (deep)");
+      if (args.depth && args.depth !== "standard") {
+        text += theme.fg("dim", ` (${args.depth})`);
       }
       return new Text(text, 0, 0);
     },