The Open Framework for Building Agents
feat(registry): add Nimble extension (#5255)
Colton Padden09f8de5904ab
diff --git a/apps/docs/lib/integrations/connection-setup.test.ts b/apps/docs/lib/integrations/connection-setup.test.tsindex 8ad279cfd..30e897d36 100644--- a/apps/docs/lib/integrations/connection-setup.test.ts+++ b/apps/docs/lib/integrations/connection-setup.test.ts@@ -197,6 +197,22 @@ describe("Kernel extension setup", () => {});});+describe("Nimble extension setup", () => {+ it("documents the API-key mount and approval-gated billable-run boundary", () => {+ const integration = getIntegration("nimble")!;++ expect(integration.type).toBe("extension");+ expect(integration.install).toContain("eve add extension/nimble");+ expect(integration.quickStart).toContain("NIMBLE_API_KEY");+ expect(integration.quickStart).toContain('import nimble from "@nimble-way/eve"');+ expect(integration.quickStart).toContain("agent/extensions/nimble/extension.ts");+ expect(integration.quickStart).toContain("require approval for every Agent API run");+ expect(integration.configure).toContain("untrusted third-party content");+ expect(integration.configure).toContain("billable, non-idempotent");+ expect(integration.configure).toContain("requires approval for every call");+ });+});+describe("Vercel MCP connection setup", () => {it("offers user OAuth and shared app credential setup", () => {const integration = getIntegration("vercel")!;diff --git a/apps/docs/lib/integrations/data.ts b/apps/docs/lib/integrations/data.tsindex 4d6814d69..cab1500a1 100644--- a/apps/docs/lib/integrations/data.ts+++ b/apps/docs/lib/integrations/data.ts@@ -1632,6 +1632,36 @@ export default githubExtension({For local or non-Vercel deployments, omit \`connector\` and set \`GITHUB_TOKEN\`; the extension also accepts an explicit \`token\`. Prefer fine-grained credentials, expose only the presets the agent needs, and keep approval enabled for writes. See the [GitHub Tools eve documentation](https://github-tools.com/frameworks/eve#eve-extension) for token authentication, per-tool overrides, commit attribution, and the complete tool catalog.`,relatedResources: [softwareFactoryGuide, incidentResponseGuide],},+ nimble: {+ logo: "nimble",+ docsHref: "https://docs.nimbleway.com/integrations/connectors/vercel-eve",+ keywords: ["web search", "web extraction", "research", "citations", "Nimble"],+ install: `Install the Nimble extension for eve:++\`\`\`bash+eve add extension/nimble+\`\`\`++The extension requires Node.js 24 or later and a Nimble API key. It adds web search, page extraction, and long-running research tools.`,+ quickStart: `Add your Nimble API key to the agent's environment:++\`\`\`bash title=".env.local"+NIMBLE_API_KEY=your_api_key+\`\`\`++The registry mounts Nimble as a directory under \`agent/extensions/\`:++\`\`\`ts title="agent/extensions/nimble/extension.ts"+import nimble from "@nimble-way/eve";++export default nimble({});+\`\`\`++The directory name supplies the \`nimble\` namespace. The extension adds \`nimble__search\`, \`nimble__extract\`, \`nimble__agent_start\`, and \`nimble__agent_result\`, plus the \`nimble__web-research\` skill. The registry overrides \`nimble__agent_start\` to require approval for every Agent API run.`,+ configure: `Keep \`NIMBLE_API_KEY\` in the environment rather than prompts or source control. Search queries, URLs, and Agent API inputs are sent to Nimble. Search results and extracted pages are untrusted third-party content, not instructions for the agent.++\`nimble__agent_start\` creates a billable, non-idempotent Agent API run. The registry requires approval for every call. Retain the returned identifiers for \`nimble__agent_result\` instead of starting a replacement run. See the [Nimble eve guide](https://docs.nimbleway.com/integrations/connectors/vercel-eve) for built-in tool overrides, configuration, data handling, and the complete tool reference.`,+ },};const memoryPresentations: Record<string, MemoryPresentation> = {diff --git a/apps/docs/lib/integrations/logos.tsx b/apps/docs/lib/integrations/logos.tsxindex 3c020a907..c154d6f90 100644--- a/apps/docs/lib/integrations/logos.tsx+++ b/apps/docs/lib/integrations/logos.tsx@@ -846,6 +846,31 @@ const agentBrowserLogo = (props: LogoProps) => (</svg>);+const nimbleLogo = (props: LogoProps) => (+ <svg fill="none" viewBox="0 0 170 144" xmlns="http://www.w3.org/2000/svg" {...props}>+ <path+ d="M169.877 57.1777V143.489L72.6543 68.9795V143.502L0 86.2119V0L97.2471 74.8311V0L169.877 57.1777Z"+ fill="currentColor"+ />+ <path+ d="M36.821 47.5725V43.0004L10.4609 23.4414V53.6052L36.821 73.6511V47.5725Z"+ fill="white"+ />+ <path+ d="M62.344 96.3458V91.8858L36.4023 72.8066V102.222L62.344 121.761V96.3458Z"+ fill="white"+ />+ <path+ d="M133.872 47.5725V43.0004L107.512 23.4414V53.6052L133.872 73.6511V47.5725Z"+ fill="white"+ />+ <path+ d="M159.408 96.3458V91.8858L133.467 72.8066V102.222L159.408 121.761V96.3458Z"+ fill="white"+ />+ </svg>+);+const braintrustLogo = (props: LogoProps) => <SiBraintrust {...props} />;const jaegerLogo = (props: LogoProps) => <SiJaeger color="default" {...props} />;@@ -1000,6 +1025,7 @@ export const logos = {browserbase: browserbaseLogo,jetty: jettyLogo,"agent-browser": agentBrowserLogo,+ nimble: nimbleLogo,} as const;export type LogoKey = keyof typeof logos;diff --git a/apps/docs/package.json b/apps/docs/package.jsonindex 150017686..01b970129 100644--- a/apps/docs/package.json+++ b/apps/docs/package.json@@ -70,6 +70,7 @@"@liveblocks/chat-sdk-adapter": "3.23.0","@mdx-js/mdx": "3.1.1","@moorcheh-ai/memanto": "0.2.29",+ "@nimble-way/eve": "0.1.1","@novu/chat-sdk-adapter": "0.1.0","@onkernel/eve-extension": "^0.1.3","@opentelemetry/api": "1.9.1",diff --git a/apps/docs/registry.json b/apps/docs/registry.jsonindex 2b50b59f6..24bf8fd1e 100644--- a/apps/docs/registry.json+++ b/apps/docs/registry.json@@ -216,6 +216,35 @@}]},+ {+ "name": "extension/nimble",+ "type": "registry:item",+ "title": "Nimble",+ "description": "Search the web, extract readable page content, and run multi-source research with Nimble.",+ "meta": {+ "eve": {+ "requires": ">=0.82.0"+ }+ },+ "dependencies": [+ "@nimble-way/eve"+ ],+ "envVars": {+ "NIMBLE_API_KEY": ""+ },+ "files": [+ {+ "path": "registry/extensions/nimble/extension.ts",+ "type": "registry:file",+ "target": "agent/extensions/nimble/extension.ts"+ },+ {+ "path": "registry/extensions/nimble/tools/agent_start.ts",+ "type": "registry:file",+ "target": "agent/extensions/nimble/tools/agent_start.ts"+ }+ ]+ },{"name": "extension/kernel","type": "registry:item",diff --git a/apps/docs/registry/extensions/nimble/extension.ts b/apps/docs/registry/extensions/nimble/extension.tsnew file mode 100644index 000000000..432bb61d0--- /dev/null+++ b/apps/docs/registry/extensions/nimble/extension.ts@@ -0,0 +1,3 @@+import nimble from "@nimble-way/eve";++export default nimble({});diff --git a/apps/docs/registry/extensions/nimble/tools/agent_start.ts b/apps/docs/registry/extensions/nimble/tools/agent_start.tsnew file mode 100644index 000000000..fd380bffd--- /dev/null+++ b/apps/docs/registry/extensions/nimble/tools/agent_start.ts@@ -0,0 +1,8 @@+import { agent_start } from "@nimble-way/eve/tools";+import { defineTool } from "eve/tools";+import { always } from "eve/tools/approval";++export default defineTool({+ ...agent_start,+ approval: always(),+});diff --git a/packages/eve-catalog/src/index.ts b/packages/eve-catalog/src/index.tsindex e3cfadadf..e448206b5 100644--- a/packages/eve-catalog/src/index.ts+++ b/packages/eve-catalog/src/index.ts@@ -325,6 +325,13 @@ export const INTEGRATIONS: readonly IntegrationEntry[] = [tagline: "Give your eve agent guarded access to Link wallet and purchase tools.",surfaces: { scaffoldable: false, registry: true, gallery: true },},+ {+ slug: "nimble",+ name: "Nimble",+ kind: "extension",+ tagline: "Search the web, extract page content, and run multi-source research with Nimble.",+ surfaces: { scaffoldable: false, registry: true, gallery: true },+ },{slug: "kernel",name: "KERNEL",diff --git a/pnpm-lock.yaml b/pnpm-lock.yamlindex 5040f7bf4..d663c0645 100644--- a/pnpm-lock.yaml+++ b/pnpm-lock.yaml@@ -454,6 +454,9 @@ importers:'@moorcheh-ai/memanto':specifier: 0.2.29version: 0.2.29([email protected]([email protected]))(eve@packages+eve)([email protected](@smithy/[email protected])([email protected]([email protected]))([email protected]))([email protected])+ '@nimble-way/eve':+ specifier: 0.1.1+ version: 0.1.1(eve@packages+eve)'@novu/chat-sdk-adapter':specifier: 0.1.0version: 0.1.0([email protected]([email protected]))([email protected]([email protected]([email protected]))([email protected])([email protected]))([email protected])([email protected])([email protected])@@ -4000,6 +4003,15 @@ packages:cpu: [x64]os: [win32]+ '@nimble-way/[email protected]':+ resolution: {integrity: sha512-Jvz6wQqM3HN168HWod6kn8LxywORWXmPXl95lkLFC7lnwWlOMeLyDzBdOAkvEhi3x/GUM+zZSXyRLeqXdspkxg==}+ engines: {node: '>=24'}+ peerDependencies:+ eve: '*'++ '@nimble-way/[email protected]':+ resolution: {integrity: sha512-qpiBt3cziPxPSrSJpTrv8jDYFQt3h6Y6vTjZC4EMXgZPZkS+JLJJbp5332k4euHRduRkoN6ZXR65l2eDhQhbcQ==}+'@nodable/[email protected]':resolution: {integrity: sha512-8L9xFeTYKhm49xfIypoe2W5wV1m/3Z58kT+7kR9A8OyFxcPduI4VmxaUMQyKYrRjUoLLSXv6EKKID5Tvj9cUVw==}@@ -17639,6 +17651,14 @@ snapshots:'@next/[email protected]':optional: true+ '@nimble-way/[email protected](eve@packages+eve)':+ dependencies:+ '@nimble-way/nimble-js': 1.5.0+ eve: link:packages/eve+ zod: 4.5.4++ '@nimble-way/[email protected]': {}+'@nodable/[email protected]': {}'@nodelib/[email protected]':diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yamlindex 5ffa613d6..48f158ab8 100644--- a/pnpm-workspace.yaml+++ b/pnpm-workspace.yaml@@ -88,6 +88,7 @@ minimumReleaseAgeExclude:- "@chat-adapter/[email protected]"- "@chat-adapter/[email protected]"- "@chat-adapter/[email protected]"+ - "@nimble-way/[email protected]"- "@shadcn/[email protected]"- "@stripe/[email protected]"- "@stripe/[email protected]"