free-pi-cli 0.4.5 → 0.4.6

package/dist/index.js

@@ -27,4 +27,4 @@ if (err) {
   console.error(err);
   process.exit(1);
 }
-await import("./main-r61kpjqw.js");
+await import("./main-cksegxnv.js");

package/dist/{main-r61kpjqw.js → main-cksegxnv.js}

@@ -45,7 +45,7 @@ function openBrowser(url, platform = process.platform, spawnImpl = spawn) {
 // package.json
 var package_default = {
   name: "free-pi-cli",
-  version: "0.4.5",
+  version: "0.4.6",
   description: "Free, ad-supported distribution of the pi coding agent. Inference paid for by ads.",
   license: "MIT",
   type: "module",
@@ -5840,6 +5840,9 @@ var F64Out = new Uint8Array(F64.buffer);
 var encoder = new TextEncoder;
 // ../../node_modules/.bun/typebox@1.3.27/node_modules/typebox/build/type/types/integer.mjs
 var IntegerPattern = "-?(?:0|[1-9][0-9]*)";
+function Integer(options) {
+  return Create({ "~kind": "Integer" }, { type: "integer" }, options);
+}
 // ../../node_modules/.bun/typebox@1.3.27/node_modules/typebox/build/type/types/literal.mjs
 class InvalidLiteralValue extends Error {
   constructor(value) {
@@ -5970,6 +5973,106 @@ function createUsageToolExtension(opts) {
   };
 }
 
+// src/web-tools.ts
+var WEB_SEARCH_TOOL_NAME = "web_search";
+var DOCS_LOOKUP_TOOL_NAME = "docs_lookup";
+var COST_GUIDELINE = "Each web_search or docs_lookup call costs part of the user's daily allowance; one or two well-aimed calls usually suffice.";
+var DOCS_LOOKUP_GUIDELINES = [
+  "Use docs_lookup before writing or fixing code against a third-party library, framework, SDK or API whose exact signature or config you are not sure of, and whenever an import, method or option you used turns out not to exist.",
+  'Pass the package name as `library` (e.g. "next.js", "prisma", "@tanstack/react-query") and one specific question as `query` (e.g. "configure middleware matcher for API routes"), not a bare topic. Reuse the returned `library_id` for follow-up lookups on the same library.',
+  COST_GUIDELINE
+];
+var WEB_SEARCH_GUIDELINES = [
+  "Use web_search for things that change or are newer than your knowledge: release notes, current versions, exact error messages you cannot explain from the code, service status, and pages the user links or mentions. Prefer docs_lookup for library API docs, and read/grep for anything in the local project.",
+  "Write a specific query the way you would type it into a search engine (include the product name, the version and the exact error text). Read the returned page text before searching again, and do not repeat a query that already returned results. Cite the URLs you relied on in your answer.",
+  COST_GUIDELINE
+];
+var ERROR_TEXT = {
+  daily_cap: "The user's daily free usage is used up. Do not retry; tell the user and continue without this tool.",
+  rolling_cap: "The user's short-term usage limit is reached. Do not retry; continue without this tool.",
+  rate_limited: "Too many calls right now. Wait for the current call to finish, and do not call again in this turn unless needed.",
+  not_found: (library) => `No documentation library matched "${library}". Retry once with the package's exact name, or use web_search.`,
+  not_configured: "This tool is not available on this server. Do not call it again in this session.",
+  upstream_error: "The search provider failed. You may retry once."
+};
+async function post(opts, path, body, label, signal) {
+  try {
+    const timeout = AbortSignal.timeout(30000);
+    const res = await (opts.fetchImpl ?? fetch)(`${opts.baseUrl}${path}`, {
+      method: "POST",
+      headers: { Authorization: `Bearer ${await opts.getToken()}`, "Content-Type": "application/json" },
+      body: JSON.stringify(body),
+      signal: signal ? AbortSignal.any([signal, timeout]) : timeout
+    });
+    if (res.ok)
+      return { ok: true, data: await res.json() };
+    const err = await res.json().catch(() => ({}));
+    const mapped = ERROR_TEXT[err.code ?? ""];
+    if (mapped)
+      return { ok: false, text: typeof mapped === "function" ? mapped(label) : mapped };
+    return { ok: false, text: `Request failed (HTTP ${res.status}): ${err.message ?? "no message"}` };
+  } catch (e) {
+    if (e instanceof Error && e.name === "TimeoutError")
+      return { ok: false, text: "Request timed out after 30 seconds." };
+    return { ok: false, text: `Request failed: ${String(e)}` };
+  }
+}
+var done = (o) => ({ content: [{ type: "text", text: o.text }], details: o.details });
+function createWebToolsExtension(opts) {
+  return {
+    name: "free-pi-web-tools",
+    factory(pi) {
+      pi.registerTool({
+        name: WEB_SEARCH_TOOL_NAME,
+        label: "Web Search",
+        description: "Search the web and return a numbered list of results, each with title, URL, publish date and the page text. Use it for current or recent information that your training data may lack. Each call uses part of the user's daily allowance.",
+        promptSnippet: "Search the web for current information (counts against the user's daily allowance)",
+        promptGuidelines: WEB_SEARCH_GUIDELINES,
+        parameters: _Object_({
+          query: String2({ minLength: 1, maxLength: 500, description: 'Specific query as you would type it into a search engine, e.g. "vite 6 release notes breaking changes"' }),
+          num_results: Optional(Integer({ minimum: 1, maximum: 10, description: "1-10, default 5; use 3 for a quick fact, 8-10 for a survey" }))
+        }),
+        async execute(_id, params, signal) {
+          const r = await post(opts, "/tools/web-search", params, "", signal);
+          if (!r.ok)
+            return done({ text: r.text, details: { ok: false } });
+          const results = r.data.results ?? [];
+          const text = results.length ? `Web results for "${params.query}":
+
+` + results.map((x, i) => `${i + 1}. ${x.title}
+${x.url}${x.published_date ? `
+Published: ${x.published_date}` : ""}
+${x.text}`).join(`
+
+`) : `No results for "${params.query}". Try a broader or differently worded query.`;
+          return done({ text, details: { ok: true, cost_usd: r.data.cost_usd } });
+        }
+      });
+      pi.registerTool({
+        name: DOCS_LOOKUP_TOOL_NAME,
+        label: "Docs Lookup",
+        description: "Look up current documentation for a third-party library, framework or API. Returns the matching library's title and library_id, then documentation text relevant to your query. Use it instead of relying on memory for exact signatures and options. Each call uses part of the user's daily allowance.",
+        promptSnippet: "Look up library/framework documentation before relying on memory (counts against the user's daily allowance)",
+        promptGuidelines: DOCS_LOOKUP_GUIDELINES,
+        parameters: _Object_({
+          library: String2({ minLength: 1, maxLength: 200, description: 'Package or library name, e.g. "next.js", "prisma", "@tanstack/react-query"' }),
+          query: String2({ minLength: 1, maxLength: 500, description: 'One specific question, e.g. "configure middleware matcher for API routes"' }),
+          library_id: Optional(String2({ description: "The library_id printed by an earlier docs_lookup, e.g. /vercel/next.js; skips the name search" }))
+        }),
+        async execute(_id, params, signal) {
+          const r = await post(opts, "/tools/docs", params, params.library, signal);
+          if (!r.ok)
+            return done({ text: r.text, details: { ok: false } });
+          const d = r.data;
+          return done({ text: `${d.title} (library_id: ${d.library_id})
+
+${d.docs}`, details: { ok: true, cost_usd: d.cost_usd } });
+        }
+      });
+    }
+  };
+}
+
 // src/buy-tool.ts
 async function resolveBuyPage(opts) {
   try {
@@ -6602,6 +6705,12 @@ function installFooterRightAlign(mode) {
 
 // src/changelog.ts
 var CHANGELOG_HIGHLIGHTS = [
+  {
+    version: "0.4.6",
+    highlights: [
+      "Free web search and documentation lookup: the agent can now search the web (web_search) and look up current library docs (docs_lookup). Both run on the free-pi server and count toward your daily allowance."
+    ]
+  },
   {
     version: "0.4.5",
     highlights: [
@@ -7182,6 +7291,8 @@ var ALLOWED_TOOL_NAMES = [
   USAGE_TOOL_NAME,
   BUY_TOOL_NAME,
   DOCS_TOOL_NAME,
+  WEB_SEARCH_TOOL_NAME,
+  DOCS_LOOKUP_TOOL_NAME,
   TODO_TOOL_NAME,
   "codemode",
   "tool_search"
@@ -7240,6 +7351,10 @@ function buildRuntimeOptions(opts, sessionId) {
     getToken: () => opts.jwt
   });
   const docsToolExtension = createDocsToolExtension();
+  const webToolsExtension = createWebToolsExtension({
+    baseUrl: opts.baseUrl,
+    getToken: () => opts.jwt
+  });
   const errorNoticeExtension = createErrorNoticeExtension();
   const toolGuardExtension = createToolGuardExtension({
     baseUrl: opts.baseUrl,
@@ -7267,6 +7382,7 @@ function buildRuntimeOptions(opts, sessionId) {
     usageToolExtension,
     buyToolExtension,
     docsToolExtension,
+    webToolsExtension,
     errorNoticeExtension,
     toolGuardExtension,
     commandsExtension,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "free-pi-cli",
-  "version": "0.4.5",
+  "version": "0.4.6",
   "description": "Free, ad-supported distribution of the pi coding agent. Inference paid for by ads.",
   "license": "MIT",
   "type": "module",