thinyai 0.1.5 → 0.1.7

package/dist/bin.js

@@ -11,7 +11,7 @@ import { stdin, stdout } from "process";
 import { mkdirSync as mkdirSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
 import { homedir as homedir2 } from "os";
 import { join as join2 } from "path";
-import { z as z6 } from "zod";
+import { z as z7 } from "zod";
 
 // ../../packages/core/src/domain/messages.ts
 var systemMessage = (content) => ({ role: "system", content });
@@ -1608,6 +1608,61 @@ async function mcpHttpPlugin(opts) {
   return buildMcpPlugin(transport, opts.name ?? "mcp");
 }
 
+// ../../packages/plugins/web-search/src/index.ts
+import { z as z6 } from "zod";
+function describeHttpError(status) {
+  if (status === 401) return "Authentication failed \u2014 verify your BRAVE_API_KEY is correct.";
+  if (status === 403) return "Access forbidden \u2014 check your API subscription level.";
+  if (status === 422) return "Invalid query \u2014 the search request was malformed.";
+  if (status === 429) return "Rate limit exceeded \u2014 slow down requests or upgrade your plan.";
+  if (status >= 500) return "Brave Search server error \u2014 try again later.";
+  return `Unexpected error \u2014 see Brave Search API docs for HTTP ${String(status)}.`;
+}
+function webSearchPlugin(opts) {
+  if (!opts.apiKey.trim()) {
+    throw new Error(
+      "webSearchPlugin: apiKey is required. Obtain a key at https://brave.com/search/api/ and set BRAVE_API_KEY in .env."
+    );
+  }
+  const endpoint = opts.endpoint ?? "https://api.search.brave.com/res/v1/web/search";
+  const fetchImpl = opts.fetchImpl ?? fetch;
+  return {
+    name: "web-search",
+    tools: [
+      defineTool({
+        name: "web_search",
+        description: "Search the public web and return the top results (title, url, snippet). Use when asked about current events, recent facts, or any topic you are not certain about.",
+        parameters: z6.object({
+          query: z6.string().min(1).describe("The search query."),
+          count: z6.number().int().min(1).max(10).default(5).describe("Number of results to return (1\u201310).")
+        }),
+        execute: async ({ query, count }) => {
+          const url = `${endpoint}?q=${encodeURIComponent(query)}&count=${String(count)}`;
+          const response = await fetchImpl(url, {
+            headers: {
+              Accept: "application/json",
+              "X-Subscription-Token": opts.apiKey
+            }
+          });
+          if (!response.ok) {
+            throw new Error(
+              `web_search failed: HTTP ${String(response.status)} \u2014 ${describeHttpError(response.status)}`
+            );
+          }
+          const data = await response.json();
+          return {
+            results: (data.web?.results ?? []).map((result) => ({
+              title: result.title,
+              url: result.url,
+              snippet: result.description
+            }))
+          };
+        }
+      })
+    ]
+  };
+}
+
 // ../../packages/skills/src/catalog.ts
 var BUILTIN_SKILLS = [
   {
@@ -2228,7 +2283,7 @@ function captureStats(base, turn) {
 var echoTool = defineTool({
   name: "echo",
   description: "Echo text back verbatim. Use when asked to repeat or echo something.",
-  parameters: z6.object({ text: z6.string().describe("the text to echo") }),
+  parameters: z7.object({ text: z7.string().describe("the text to echo") }),
   execute: ({ text: text2 }) => Promise.resolve({ echoed: text2 })
 });
 function parseSkillArgs() {
@@ -2327,11 +2382,11 @@ async function runCli() {
     name: "sui_setup",
     description: "Set up or change the agent's Sui wallet so it can read balances and sign transactions. Use when the user asks to enable Sui, create/import a wallet, or switch network. Modes: generate (new local key), import (a suiprivkey\u2026), rill (use a Rill MCP signer URL). Takes effect immediately; Rill's builder tools connect on the next start. Always remind the user to fund the returned address.",
     sensitive: true,
-    parameters: z6.object({
-      network: z6.enum(["testnet", "mainnet"]).default("testnet"),
-      wallet: z6.enum(["generate", "import", "rill"]).describe("generate a new key, import a suiprivkey\u2026, or use a Rill MCP signer"),
-      secretKey: z6.string().optional().describe("suiprivkey\u2026 \u2014 required when wallet=import"),
-      rillMcpUrl: z6.string().optional().describe("Rill MCP URL \u2014 used when wallet=rill")
+    parameters: z7.object({
+      network: z7.enum(["testnet", "mainnet"]).default("testnet"),
+      wallet: z7.enum(["generate", "import", "rill"]).describe("generate a new key, import a suiprivkey\u2026, or use a Rill MCP signer"),
+      secretKey: z7.string().optional().describe("suiprivkey\u2026 \u2014 required when wallet=import"),
+      rillMcpUrl: z7.string().optional().describe("Rill MCP URL \u2014 used when wallet=rill")
     }),
     execute: async ({ network: net, wallet, secretKey, rillMcpUrl }) => {
       const network2 = net === "mainnet" ? "mainnet" : "testnet";
@@ -2366,13 +2421,79 @@ async function runCli() {
       };
     }
   });
+  const fetchUrlTool = defineTool({
+    name: "fetch_url",
+    description: "Fetch the contents of an http(s) URL (markdown, text, JSON, HTML). ALWAYS use this when the user shares a link \u2014 e.g. a skill.md, docs page, or an API/MCP endpoint \u2014 instead of saying you can't open URLs. Returns the response text (truncated if very large).",
+    parameters: z7.object({
+      url: z7.string().url().describe("The http(s) URL to fetch."),
+      maxChars: z7.number().int().positive().optional().describe("Max characters of body to return (default 20000).")
+    }),
+    execute: async ({ url, maxChars }) => {
+      const limit = maxChars ?? 2e4;
+      const res = await fetch(url, {
+        headers: { "user-agent": "thiny-cli", accept: "*/*" },
+        signal: AbortSignal.timeout(15e3)
+      });
+      const body = await res.text();
+      return {
+        url,
+        status: res.status,
+        contentType: res.headers.get("content-type") ?? "",
+        truncated: body.length > limit,
+        content: body.slice(0, limit)
+      };
+    }
+  });
+  const exaKey = process.env.EXA_API_KEY;
+  const webPlugins = [];
+  const webTools = [];
+  if (exaKey) {
+    webTools.push(
+      defineTool({
+        name: "web_search",
+        description: "Search the WEB via Exa and get ranked results with text snippets. Use whenever you need current info, prices, docs, or to find a page \u2014 anything you don't already know. This is DIFFERENT from fetch_url: web_search finds pages by query; fetch_url reads one URL you have.",
+        parameters: z7.object({
+          query: z7.string().min(1).describe("The search query."),
+          numResults: z7.number().int().positive().optional().describe("Results to return (default 5).")
+        }),
+        execute: async ({ query, numResults }) => {
+          const res = await fetch("https://api.exa.ai/search", {
+            method: "POST",
+            headers: { "content-type": "application/json", "x-api-key": exaKey },
+            body: JSON.stringify({
+              query,
+              numResults: numResults ?? 5,
+              contents: { text: { maxCharacters: 1200 } }
+            }),
+            signal: AbortSignal.timeout(2e4)
+          });
+          if (!res.ok) throw new Error(`web_search: Exa HTTP ${String(res.status)} ${await res.text()}`);
+          const data = await res.json();
+          return {
+            query,
+            results: (data.results ?? []).map((r) => ({ title: r.title, url: r.url, text: r.text }))
+          };
+        }
+      })
+    );
+  } else if (process.env.BRAVE_API_KEY) {
+    webPlugins.push(webSearchPlugin({ apiKey: process.env.BRAVE_API_KEY }));
+  }
+  const webSearchOn = webTools.length > 0 || webPlugins.length > 0;
   const budget = budgetMiddleware({ maxCalls: 50, logger });
   const agent = await createAgent({
     model,
     logger: agentLogger,
     persona,
-    systemPrompt: "You are a helpful AI assistant. Use tools when they help you answer better. Be concise.\n\nMEMORY: You have persistent long-term memory across sessions, stored on Walrus. What you already know about the user is injected automatically at the start of each conversation under \u201C[User Memory \u2026]\u201D. When the user shares anything durable about themselves \u2014 their name, role, preferences, projects, or goals, even casually \u2014 immediately call remember_fact to save it. If asked what you remember, answer from the injected user memory (or call recall_memory). You DO remember across sessions \u2014 never say you lack memory or that each session starts fresh.\n\nFor multi-step work, call update_plan to track steps and delegate_task to hand focused sub-problems to a sub-agent.\n\nSUI: You can operate on the Sui blockchain directly with your own tools \u2014 do NOT tell the user to install a browser wallet extension. " + (suiSignerRef ? `A wallet IS configured on ${suiNetwork} at ${suiSignerRef.address ?? "(unknown)"}. ` : "No wallet is set up yet \u2014 when the user wants Sui, call sui_setup (generate / import / rill) to create or connect one, then tell them to fund the returned address. ") + "Your Sui tools: sui_setup (create/import a wallet), sui_balance and sui_object (read), sui_transfer (send SUI or any coin to an address \u2014 amounts in MIST, 1 SUI = 1e9), sui_move_call (call ANY Move function on any package \u2014 the general way to run any on-chain action), and sui_execute_ptb (sign a PTB an external builder/Rill produced). Prefer sui_transfer for sends and sui_move_call for contract calls. Always confirm details and remind the user to fund the wallet. Never claim you cannot transact on Sui \u2014 you can, via these tools.",
-    tools: [echoTool, suiSetupTool],
+    systemPrompt: `You are ${persona?.name ?? "ThinyAI"}, a capable assistant with real tools. Be concise.
+
+HOW TO ACT: When a request maps to one of your tools, CALL THE TOOL automatically \u2014 figure out the right tool yourself; do not ask the user which tool to run, do not ask permission for read-only actions, and never say you can't do something one of your tools covers. Chain tools when needed (e.g. web_search \u2192 fetch_url \u2192 act).
+
+YOUR TOOLS:
+\u2022 Memory \u2014 remember_fact, recall_memory: durable memory across sessions (stored on Walrus). Known facts are injected each turn under \u201C[User Memory \u2026]\u201D. Immediately save anything durable the user shares (name, role, preferences, projects, goals). Answer \u201Cwhat do you remember\u201D from it. You DO remember across sessions \u2014 never say otherwise.
+\u2022 Links \u2014 fetch_url: read ANY URL the user shares (a skill.md, docs, JSON, an API/MCP endpoint). Always fetch shared links instead of saying you can't open URLs.
+` + (webSearchOn ? "\u2022 Web search \u2014 web_search: search the web for anything you don't know (news, prices, docs). web_search FINDS pages by query; fetch_url READS a specific URL \u2014 use them together.\n" : "") + "\u2022 Planning \u2014 update_plan (track multi-step work), delegate_task (hand a focused subtask to a sub-agent).\n\u2022 Sui blockchain \u2014 you transact yourself; NEVER tell the user to install a browser wallet. " + (suiSignerRef ? `A wallet IS set up on ${suiNetwork} at ${suiSignerRef.address ?? "?"}. ` : "No wallet yet \u2014 call sui_setup (generate / import / rill) when the user wants Sui, then have them fund the address. ") + "sui_setup (create/import a wallet), sui_balance & sui_object (read), sui_transfer (send SUI or any coin \u2014 amounts in MIST, 1 SUI = 1e9), sui_move_call (call ANY Move function \u2014 any on-chain action), sui_execute_ptb (sign a PTB a builder/Rill produced). Prefer sui_transfer for sends and sui_move_call for contract calls; confirm details before signing.",
+    tools: [echoTool, suiSetupTool, fetchUrlTool, ...webTools],
     plugins: [
       {
         name: "observability",
@@ -2385,6 +2506,8 @@ async function runCli() {
       // always present; tools guide setup if no wallet
       ...suiPlugins,
       // Rill MCP builder tools (if connected)
+      ...webPlugins,
+      // web_search when BRAVE_API_KEY is set
       ...skillPlugins
     ]
   });
@@ -2430,6 +2553,9 @@ async function runCli() {
       `Sui: ${suiNetwork} \xB7 ${suiSignerRef.address ?? "?"}${process.env.MCP_URL ? " \xB7 Rill MCP connected" : ""}`
     );
   else renderInfo("Sui: no wallet \u2014 ask the agent to set one up, or run `thiny sui init`");
+  renderInfo(
+    `Web: fetch_url (any URL)${webSearchOn ? ` \xB7 web_search (${exaKey ? "Exa" : "Brave"})` : " \xB7 web_search off (set EXA_API_KEY)"}`
+  );
   notifyIfUpdate(thinyDir);
   const rl = createInterface({ input: stdin, output: stdout });
   emitKeypressEvents(stdin);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thinyai",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Thiny AI — a beautiful terminal agent: interactive chat, tools, Walrus memory, and Sui execution.",
   "type": "module",
   "license": "MIT",
@@ -38,13 +38,14 @@
     "tsup": "^8.5.1",
     "typescript": "^5.5.0",
     "@thiny/core": "0.1.0",
-    "@thiny/mcp": "0.1.0",
     "@thiny/logger-pino": "0.1.0",
-    "@thiny/walrus": "0.1.0",
-    "@thiny/model-aisdk": "0.1.0",
     "@thiny/plugin-agents": "0.1.0",
     "@thiny/memory-memwal": "0.1.0",
+    "@thiny/mcp": "0.1.0",
+    "@thiny/walrus": "0.1.0",
     "@thiny/signer-sui": "0.1.0",
+    "@thiny/plugin-web-search": "0.1.0",
+    "@thiny/model-aisdk": "0.1.0",
     "@thiny/plugin-sui": "0.1.0",
     "@thiny/skills": "0.1.0"
   },