@render-harness/cap-search-tavily 0.1.1

package/README.md

@@ -0,0 +1,16 @@
+## @render-harness/cap-search-tavily
+
+Wires Tavily AI search into a Render harness entry. Drop into `render-harness.yaml`:
+
+```yaml
+capabilities:
+  - pack: "@render-harness/cap-search-tavily"
+```
+
+Set `TAVILY_API_KEY` in the entry's environment.
+
+The pack contributes:
+
+- An MCP server `cap-search-tavily.tavily` (stdio transport, runs `npx -y tavily-mcp`).
+- A skill (`web-search-tavily`).
+- A `TAVILY_API_KEY` entry in the effective env schema.

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+import * as _render_harness_registry from '@render-harness/registry';
+
+/**
+ * cap-search-tavily — wires up the Tavily AI-search MCP for any
+ * harness entry that wants quick, citation-friendly web answers.
+ *
+ * Usage in render-harness.yaml:
+ *
+ *   capabilities:
+ *     - pack: "@render-harness/cap-search-tavily"
+ *
+ * Surfaces:
+ *   - One MCP server (stdio transport) named "tavily".
+ *   - One skill (skills/web-search-tavily.md).
+ *   - envSchema entry for TAVILY_API_KEY.
+ *
+ * Config keys:
+ *   - `apiKeyEnv` (string, default "TAVILY_API_KEY")
+ *   - `command` (string, default "npx") — override for self-hosted MCP runners.
+ *   - `package` (string, default "tavily-mcp") — the npm package run by `npx -y`.
+ */
+declare const pack: _render_harness_registry.CapabilityPack;
+
+export { pack as default };

package/dist/index.js

@@ -0,0 +1,60 @@
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { definePack } from '@render-harness/registry';
+
+// src/index.ts
+var HERE = dirname(fileURLToPath(import.meta.url));
+var SKILLS_DIR = join(HERE, "..", "skills");
+function readConfig(ctx) {
+  const cfg = ctx.config;
+  return {
+    apiKeyEnv: cfg.apiKeyEnv ?? "TAVILY_API_KEY",
+    command: cfg.command ?? "npx",
+    pkg: cfg.package ?? "tavily-mcp"
+  };
+}
+var pack = definePack({
+  name: "cap-search-tavily",
+  version: "0.1.0",
+  envSchema: [
+    {
+      name: "TAVILY_API_KEY",
+      required: true,
+      secret: true,
+      description: "API key for Tavily search (https://tavily.com)."
+    }
+  ],
+  mcpServers(ctx) {
+    const cfg = readConfig(ctx);
+    const apiKey = ctx.env(cfg.apiKeyEnv);
+    if (!apiKey) {
+      throw new Error(
+        `cap-search-tavily: env var ${cfg.apiKeyEnv} is not set. Set it before building or starting the agent.`
+      );
+    }
+    return [
+      {
+        name: "tavily",
+        transport: "stdio",
+        command: cfg.command,
+        args: ["-y", cfg.pkg],
+        env: { TAVILY_API_KEY: apiKey }
+      }
+    ];
+  },
+  skills(_ctx) {
+    return [
+      {
+        name: "web-search-tavily",
+        description: "Use Tavily for fast, citation-friendly AI search.",
+        whenToUse: "When you want a concise, summarized answer with sources rather than raw search results. Tavily returns one synthesized response with citations.",
+        contentPath: join(SKILLS_DIR, "web-search-tavily.md")
+      }
+    ];
+  }
+});
+var src_default = pack;
+
+export { src_default as default };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;;;AAyBA,IAAM,IAAA,GAAO,OAAA,CAAQ,aAAA,CAAc,MAAA,CAAA,IAAA,CAAY,GAAG,CAAC,CAAA;AACnD,IAAM,UAAA,GAAa,IAAA,CAAK,IAAA,EAAM,IAAA,EAAM,QAAQ,CAAA;AAQ5C,SAAS,WAAW,GAAA,EAAkB;AACpC,EAAA,MAAM,MAAM,GAAA,CAAI,MAAA;AAChB,EAAA,OAAO;AAAA,IACL,SAAA,EAAW,IAAI,SAAA,IAAa,gBAAA;AAAA,IAC5B,OAAA,EAAS,IAAI,OAAA,IAAW,KAAA;AAAA,IACxB,GAAA,EAAK,IAAI,OAAA,IAAW;AAAA,GACtB;AACF;AAEA,IAAM,OAAO,UAAA,CAAW;AAAA,EACtB,IAAA,EAAM,mBAAA;AAAA,EACN,OAAA,EAAS,OAAA;AAAA,EACT,SAAA,EAAW;AAAA,IACT;AAAA,MACE,IAAA,EAAM,gBAAA;AAAA,MACN,QAAA,EAAU,IAAA;AAAA,MACV,MAAA,EAAQ,IAAA;AAAA,MACR,WAAA,EAAa;AAAA;AACf,GACF;AAAA,EACA,WAAW,GAAA,EAAqC;AAC9C,IAAA,MAAM,GAAA,GAAM,WAAW,GAAG,CAAA;AAC1B,IAAA,MAAM,MAAA,GAAS,GAAA,CAAI,GAAA,CAAI,GAAA,CAAI,SAAS,CAAA;AACpC,IAAA,IAAI,CAAC,MAAA,EAAQ;AACX,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,CAAA,2BAAA,EAA8B,IAAI,SAAS,CAAA,0DAAA;AAAA,OAC7C;AAAA,IACF;AACA,IAAA,OAAO;AAAA,MACL;AAAA,QACE,IAAA,EAAM,QAAA;AAAA,QACN,SAAA,EAAW,OAAA;AAAA,QACX,SAAS,GAAA,CAAI,OAAA;AAAA,QACb,IAAA,EAAM,CAAC,IAAA,EAAM,GAAA,CAAI,GAAG,CAAA;AAAA,QACpB,GAAA,EAAK,EAAE,cAAA,EAAgB,MAAA;AAAO;AAChC,KACF;AAAA,EACF,CAAA;AAAA,EACA,OAAO,IAAA,EAAoC;AACzC,IAAA,OAAO;AAAA,MACL;AAAA,QACE,IAAA,EAAM,mBAAA;AAAA,QACN,WAAA,EAAa,mDAAA;AAAA,QACb,SAAA,EACE,iJAAA;AAAA,QACF,WAAA,EAAa,IAAA,CAAK,UAAA,EAAY,sBAAsB;AAAA;AACtD,KACF;AAAA,EACF;AACF,CAAC,CAAA;AAED,IAAO,WAAA,GAAQ","file":"index.js","sourcesContent":["/**\n * cap-search-tavily — wires up the Tavily AI-search MCP for any\n * harness entry that wants quick, citation-friendly web answers.\n *\n * Usage in render-harness.yaml:\n *\n *   capabilities:\n *     - pack: \"@render-harness/cap-search-tavily\"\n *\n * Surfaces:\n *   - One MCP server (stdio transport) named \"tavily\".\n *   - One skill (skills/web-search-tavily.md).\n *   - envSchema entry for TAVILY_API_KEY.\n *\n * Config keys:\n *   - `apiKeyEnv` (string, default \"TAVILY_API_KEY\")\n *   - `command` (string, default \"npx\") — override for self-hosted MCP runners.\n *   - `package` (string, default \"tavily-mcp\") — the npm package run by `npx -y`.\n */\n\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport type { McpServerConfig, SkillMetadata } from \"@render-harness/core\";\nimport { definePack, type PackContext } from \"@render-harness/registry\";\n\nconst HERE = dirname(fileURLToPath(import.meta.url));\nconst SKILLS_DIR = join(HERE, \"..\", \"skills\");\n\ninterface TavilyConfig {\n  apiKeyEnv?: string;\n  command?: string;\n  package?: string;\n}\n\nfunction readConfig(ctx: PackContext) {\n  const cfg = ctx.config as TavilyConfig;\n  return {\n    apiKeyEnv: cfg.apiKeyEnv ?? \"TAVILY_API_KEY\",\n    command: cfg.command ?? \"npx\",\n    pkg: cfg.package ?? \"tavily-mcp\",\n  };\n}\n\nconst pack = definePack({\n  name: \"cap-search-tavily\",\n  version: \"0.1.0\",\n  envSchema: [\n    {\n      name: \"TAVILY_API_KEY\",\n      required: true,\n      secret: true,\n      description: \"API key for Tavily search (https://tavily.com).\",\n    },\n  ],\n  mcpServers(ctx: PackContext): McpServerConfig[] {\n    const cfg = readConfig(ctx);\n    const apiKey = ctx.env(cfg.apiKeyEnv);\n    if (!apiKey) {\n      throw new Error(\n        `cap-search-tavily: env var ${cfg.apiKeyEnv} is not set. Set it before building or starting the agent.`,\n      );\n    }\n    return [\n      {\n        name: \"tavily\",\n        transport: \"stdio\",\n        command: cfg.command,\n        args: [\"-y\", cfg.pkg],\n        env: { TAVILY_API_KEY: apiKey },\n      },\n    ];\n  },\n  skills(_ctx: PackContext): SkillMetadata[] {\n    return [\n      {\n        name: \"web-search-tavily\",\n        description: \"Use Tavily for fast, citation-friendly AI search.\",\n        whenToUse:\n          \"When you want a concise, summarized answer with sources rather than raw search results. Tavily returns one synthesized response with citations.\",\n        contentPath: join(SKILLS_DIR, \"web-search-tavily.md\"),\n      },\n    ];\n  },\n});\n\nexport default pack;\n"]}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@render-harness/cap-search-tavily",
+  "version": "0.1.1",
+  "description": "Tavily AI-search capability pack for the Render agent harness.",
+  "type": "module",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "skills"
+  ],
+  "keywords": [
+    "render-harness-cap",
+    "render-harness",
+    "tavily",
+    "search",
+    "mcp"
+  ],
+  "renderHarness": {
+    "gallery": {
+      "label": "Tavily web search",
+      "envHint": "TAVILY_API_KEY"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests"
+  },
+  "dependencies": {
+    "@render-harness/registry": "workspace:*"
+  },
+  "devDependencies": {
+    "@render-harness/core": "workspace:*",
+    "@types/node": "^25.6.2",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.5"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/skills/web-search-tavily.md

@@ -0,0 +1,25 @@
+---
+name: web-search-tavily
+description: Use Tavily for fast, citation-friendly AI search.
+when_to_use: When you want a concise, summarized answer with sources rather than raw search results. Tavily returns one synthesized response with citations.
+---
+
+# Web search with Tavily
+
+Tavily returns a synthesized answer plus a small list of source URLs. It's a good fit when the user wants a direct answer that you can quote with citations, without you having to rerank raw search results.
+
+## When to use Tavily
+
+- The user asks a factual question that has a clear answer ("when did X ship?", "what's the current price of Y?").
+- You want grounded text you can quote in your response.
+- You want fewer round-trips than a search-then-fetch flow.
+
+## When not to use Tavily
+
+- You need many candidate URLs to compare; use a wider-recall search (e.g. Exa) instead.
+- The query is exploratory ("what are the trade-offs of X vs Y") — the synthesized answer might be lossy.
+
+## Tips
+
+- Pass `search_depth: "advanced"` for higher-quality but slower results.
+- Always include the source URLs Tavily returns when you cite a fact.