@nyte-ai/plugin 0.0.0-stage → 0.0.19

package/dist/src/web-search.js

@@ -0,0 +1,219 @@
+// src/web-search.ts
+import { dev } from "@nyte-ai/core";
+import { standard } from "@nyte-ai/schema";
+import { Type } from "typebox";
+import { Value } from "typebox/value";
+var PROVIDERS = ["exa", "tavily", "firecrawl", "parallel"];
+var providerSchema = Type.Union(PROVIDERS.map((name) => Type.Literal(name)));
+var provider = {
+  id: "web_search.provider",
+  label: "Web search provider",
+  schema: standard(providerSchema),
+  choices: [
+    { value: "exa", label: "Exa" },
+    { value: "tavily", label: "Tavily" },
+    { value: "firecrawl", label: "Firecrawl" },
+    { value: "parallel", label: "Parallel" }
+  ],
+  default: "exa",
+  scope: "host"
+};
+var textBlocks = Type.Object({
+  content: Type.Array(Type.Object({ type: Type.String(), text: Type.Optional(Type.String()) }))
+});
+var tavilyResponse = Type.Object({
+  results: Type.Array(Type.Object({ url: Type.String(), title: Type.String(), content: Type.String() }))
+});
+var firecrawlResponse = Type.Object({
+  data: Type.Object({
+    web: Type.Array(Type.Object({
+      url: Type.String(),
+      title: Type.Optional(Type.Union([Type.String(), Type.Null()])),
+      description: Type.Optional(Type.Union([Type.String(), Type.Null()]))
+    }))
+  })
+});
+var parallelResponse = Type.Object({
+  structuredContent: Type.Object({
+    results: Type.Array(Type.Object({
+      url: Type.String(),
+      title: Type.Optional(Type.Union([Type.String(), Type.Null()])),
+      excerpts: Type.Array(Type.String())
+    }))
+  })
+});
+var adapters = {
+  async tavily({ query, key, fetch, signal }) {
+    const response = await fetch("https://api.tavily.com/search", {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...key === undefined ? { "X-Tavily-Access-Mode": "keyless" } : { Authorization: `Bearer ${key}` }
+      },
+      body: JSON.stringify({ query, search_depth: "basic", max_results: 8 }),
+      signal
+    });
+    const body = parse(await answered(response));
+    return Value.Check(tavilyResponse, body) ? body.results.map((hit) => ({ url: hit.url, title: hit.title, content: hit.content })) : [];
+  },
+  async exa({ query, key, fetch, signal }) {
+    const endpoint = new URL("https://mcp.exa.ai/mcp");
+    if (key !== undefined)
+      endpoint.searchParams.set("exaApiKey", key);
+    const result = await callTool(fetch, endpoint, undefined, "web_search_exa", { query, numResults: 8 }, signal);
+    const text = Value.Check(textBlocks, result) ? result.content.find((block) => block.text !== undefined)?.text ?? "" : "";
+    return text.split(/\n\n---\n\n/).flatMap((block) => {
+      const url = field(block, "URL");
+      return url === null ? [] : [
+        {
+          url,
+          title: field(block, "Title"),
+          content: block.match(/^(?:Highlights|Text):\s*\n?([\s\S]*)$/m)?.[1]?.trim() ?? null
+        }
+      ];
+    });
+  },
+  async firecrawl({ query, key, fetch, signal }) {
+    const result = await callTool(fetch, new URL("https://mcp.firecrawl.dev/v2/mcp"), key, "firecrawl_search", { query, limit: 8 }, signal);
+    const text = Value.Check(textBlocks, result) ? result.content.find((block) => block.text !== undefined)?.text ?? "" : "";
+    const body = parse(text);
+    return Value.Check(firecrawlResponse, body) ? body.data.web.map((hit) => ({
+      url: hit.url,
+      title: hit.title ?? null,
+      content: hit.description ?? null
+    })) : [];
+  },
+  async parallel({ query, key, fetch, signal }) {
+    const result = await callTool(fetch, new URL("https://search.parallel.ai/mcp"), key, "web_search", { objective: query, search_queries: [query] }, signal);
+    return Value.Check(parallelResponse, result) ? result.structuredContent.results.map((hit) => ({
+      url: hit.url,
+      title: hit.title ?? null,
+      content: hit.excerpts.length === 0 ? null : hit.excerpts.join(`
+
+`)
+    })) : [];
+  }
+};
+async function callTool(fetch, url, key, tool, args, signal) {
+  const response = await fetch(url, {
+    method: "POST",
+    headers: {
+      Accept: "application/json, text/event-stream",
+      "Content-Type": "application/json",
+      ...key === undefined ? {} : { Authorization: `Bearer ${key}` }
+    },
+    body: JSON.stringify({
+      jsonrpc: "2.0",
+      id: 1,
+      method: "tools/call",
+      params: { name: tool, arguments: args }
+    }),
+    signal
+  });
+  const body = await answered(response);
+  const frames = [
+    body,
+    ...body.split(`
+`).flatMap((line) => line.startsWith("data: ") ? [line.slice(6)] : [])
+  ];
+  for (const frame of frames) {
+    const message = parse(frame);
+    if (typeof message === "object" && message !== null && "result" in message)
+      return message.result;
+  }
+  return;
+}
+async function answered(response) {
+  const body = await response.text();
+  if (!response.ok)
+    throw new Error(`HTTP ${response.status}: ${body.trim().slice(0, 200) || response.statusText}`);
+  return body;
+}
+function parse(text) {
+  try {
+    return JSON.parse(text);
+  } catch {
+    return;
+  }
+}
+function field(block, name) {
+  const value = block.match(new RegExp(`^${name}:\\s*(.+)$`, "m"))?.[1]?.trim();
+  return value === undefined || value === "" || value === "N/A" ? null : value;
+}
+var parameters = standard(Type.Object({ query: Type.String({ minLength: 1, description: "What to search the web for." }) }));
+function webSearch(api) {
+  return {
+    name: "web_search",
+    description: "Search the web for current information beyond your knowledge cutoff. Returns titles, URLs and excerpts.",
+    parameters,
+    class: (args) => ({ kind: "custom", label: `Searching ${args.query}` }),
+    effects: "none",
+    approval: "never",
+    replay: "safe",
+    async execute(args, invocation) {
+      const value = await api.contribute.settings.value(provider.id);
+      const name = PROVIDERS.find((known) => known === value) ?? provider.default;
+      const results = await invocation.memo("results", async () => {
+        const key = await api.storage.secrets.get(name);
+        dev("web-search", "search", {
+          call: invocation.call,
+          provider: name,
+          keyed: key !== undefined
+        });
+        const hits = await adapters[name]({
+          query: args.query,
+          key,
+          fetch: globalThis.fetch,
+          signal: AbortSignal.any([invocation.signal, AbortSignal.timeout(25000)])
+        });
+        return hits.map((hit) => ({ url: hit.url, title: hit.title, content: hit.content }));
+      });
+      const text = results.length === 0 ? "No results. Try a different query." : results.map((hit) => `## ${hit.title ?? hit.url}
+${hit.url}${hit.content === null ? "" : `
+
+${hit.content}`}`).join(`
+
+`);
+      return { content: [{ kind: "text", text }] };
+    }
+  };
+}
+var keyCommand = {
+  name: "websearch-key",
+  title: "Set a web search key",
+  description: "Store a web search provider's API key: <provider> <key>; no key removes it.",
+  complete(prefix) {
+    const typed = prefix.trimStart();
+    if (/\s/u.test(typed))
+      return [];
+    return PROVIDERS.filter((known) => known.startsWith(typed.toLowerCase())).map((known) => ({
+      value: `${known} `,
+      label: known
+    }));
+  },
+  async run(text, { api }) {
+    const [named = "", key = ""] = text.split(/\s+(.*)/su);
+    const chosen = PROVIDERS.find((known) => known === named.toLowerCase());
+    if (chosen === undefined)
+      throw new Error(`Name a provider first: ${PROVIDERS.join(", ")}.`);
+    if (key === "")
+      await api.storage.secrets.delete(chosen);
+    else
+      await api.storage.secrets.set(chosen, key);
+    return `Key for ${chosen} ${key === "" ? "removed" : "saved"}.`;
+  }
+};
+var web_search_default = {
+  id: "web-search",
+  contribute: {
+    settings: [provider],
+    commands: [keyCommand]
+  },
+  activate(api) {
+    api.contribute.tools.add(webSearch(api));
+  }
+};
+export {
+  adapters,
+  web_search_default as default
+};

package/package.json

@@ -1,6 +1,193 @@
 {
   "name": "@nyte-ai/plugin",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.0.19",
+  "private": false,
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/interfaces-lab/nyte.git",
+    "directory": "packages/plugin"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "THIRD-PARTY-NOTICES.md"
+  ],
+  "type": "module",
+  "exports": {
+    "./core": {
+      "types": "./dist/src/core.d.ts",
+      "import": "./dist/src/core.js"
+    },
+    "./core/approvals": {
+      "types": "./dist/src/approvals/approvals.d.ts",
+      "import": "./dist/src/approvals/approvals.js"
+    },
+    "./core/acp": {
+      "types": "./dist/src/acp/index.d.ts",
+      "import": "./dist/src/acp/index.js"
+    },
+    "./core/bash-description": {
+      "types": "./dist/src/bash-description.d.ts",
+      "import": "./dist/src/bash-description.js"
+    },
+    "./core/browser-tools": {
+      "types": "./dist/src/browser-tools.d.ts",
+      "import": "./dist/src/browser-tools.js"
+    },
+    "./core/canvas": {
+      "types": "./dist/src/canvas/canvas.d.ts",
+      "import": "./dist/src/canvas/canvas.js"
+    },
+    "./core/canvas-compile": {
+      "types": "./dist/src/canvas/canvas-compile.d.ts",
+      "import": "./dist/src/canvas/canvas-compile.js"
+    },
+    "./core/canvas-preview": {
+      "types": "./dist/src/canvas/canvas-preview.d.ts",
+      "import": "./dist/src/canvas/canvas-preview.js"
+    },
+    "./core/claude-code": {
+      "types": "./dist/examples/claude-code/index.d.ts",
+      "import": "./dist/examples/claude-code/index.js"
+    },
+    "./core/claude-code-sdk": {
+      "types": "./dist/src/claude-code-sdk/index.d.ts",
+      "import": "./dist/src/claude-code-sdk/index.js"
+    },
+    "./core/codemode": {
+      "types": "./dist/src/codemode.d.ts",
+      "import": "./dist/src/codemode.js"
+    },
+    "./core/codemode-runtime": {
+      "types": "./dist/src/codemode-runtime.d.ts",
+      "import": "./dist/src/codemode-runtime.js"
+    },
+    "./core/codemode-worker": {
+      "types": "./dist/src/codemode-worker.d.ts",
+      "import": "./dist/src/codemode-worker.js"
+    },
+    "./core/openai-astra-context": {
+      "types": "./dist/src/openai-astra-context.d.ts",
+      "import": "./dist/src/openai-astra-context.js"
+    },
+    "./core/openai-compaction": {
+      "types": "./dist/src/openai-compaction.d.ts",
+      "import": "./dist/src/openai-compaction.js"
+    },
+    "./core/question": {
+      "types": "./dist/src/question/question.d.ts",
+      "import": "./dist/src/question/question.js"
+    },
+    "./core/rename": {
+      "types": "./dist/src/rename.d.ts",
+      "import": "./dist/src/rename.js"
+    },
+    "./core/telemetry": {
+      "types": "./dist/src/telemetry.d.ts",
+      "import": "./dist/src/telemetry.js"
+    },
+    "./core/web-search": {
+      "types": "./dist/src/web-search.d.ts",
+      "import": "./dist/src/web-search.js"
+    },
+    "./client": {
+      "types": "./dist/src/client.d.ts",
+      "import": "./dist/src/client.js"
+    },
+    "./client/mount": {
+      "types": "./dist/src/client/mount.d.ts",
+      "import": "./dist/src/client/mount.js"
+    },
+    "./client/notifications": {
+      "types": "./dist/src/client/notifications.d.ts",
+      "import": "./dist/src/client/notifications.js"
+    },
+    "./client/presentation": {
+      "types": "./dist/src/client/presentation.d.ts",
+      "import": "./dist/src/client/presentation.js"
+    },
+    "./client/questions": {
+      "types": "./dist/src/question/client/questions.d.ts",
+      "import": "./dist/src/question/client/questions.js"
+    },
+    "./client/questions-tui": {
+      "types": "./dist/src/question/client/questions-tui.d.ts",
+      "import": "./dist/src/question/client/questions-tui.js"
+    },
+    "./client/transcript": {
+      "types": "./dist/src/client/transcript.d.ts",
+      "import": "./dist/src/client/transcript.js"
+    },
+    "./client/transcript-tui": {
+      "types": "./dist/src/client/transcript-tui.d.ts",
+      "import": "./dist/src/client/transcript-tui.js"
+    },
+    "./approvals/schema": {
+      "types": "./dist/src/approvals/schema.d.ts",
+      "import": "./dist/src/approvals/schema.js"
+    },
+    "./canvas/protocol": {
+      "types": "./dist/src/canvas/canvas-protocol.d.ts",
+      "import": "./dist/src/canvas/canvas-protocol.js"
+    },
+    "./canvas/schema": {
+      "types": "./dist/src/canvas/schema.d.ts",
+      "import": "./dist/src/canvas/schema.js"
+    },
+    "./question/schema": {
+      "types": "./dist/src/question/schema.d.ts",
+      "import": "./dist/src/question/schema.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@agentclientprotocol/sdk": "1.9.0",
+    "@anthropic-ai/claude-agent-sdk": "0.3.296",
+    "@earendil-works/pi-codemode": "1.0.0",
+    "@nyte-ai/ai": "0.0.19",
+    "@nyte-ai/core": "0.0.19",
+    "@nyte-ai/schema": "0.0.19",
+    "@opentelemetry/api": "^1.9.1",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.223.0",
+    "@opentelemetry/resources": "^2.12.0",
+    "@opentelemetry/sdk-trace": "^2.12.0",
+    "@opentelemetry/semantic-conventions": "^1.43.0",
+    "es-module-lexer": "2.3.2",
+    "sucrase": "3.35.1",
+    "typebox": "1.3.36",
+    "zod": "4.5.4"
+  },
+  "devDependencies": {
+    "@opentui/core": "^0.6.6",
+    "@types/node": "^26.6.5",
+    "@types/react": "19.3.0",
+    "react": "19.3.0",
+    "typescript": "6.0.3",
+    "vitest": "^5.0.5"
+  },
+  "peerDependencies": {
+    "@opentui/core": "^0.6.5",
+    "react": "^19.2.0"
+  },
+  "peerDependenciesMeta": {
+    "@opentui/core": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=26.4.0"
+  },
+  "scripts": {
+    "clean": "rm -rf node_modules .turbo",
+    "test": "vitest --run",
+    "typecheck": "tsrs --noEmit",
+    "build:package": "bun ../../scripts/sdk-packages.mjs build plugin"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.