Skip to content

armgit / eve

Public Imported from GitHub
0

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.ts
index 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.ts
index 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.tsx
index 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.json
index 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.json
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
index 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.yaml
index 5040f7bf4..d663c0645 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -454,6 +454,9 @@ importers:
'@moorcheh-ai/memanto':
specifier: 0.2.29
+ '@nimble-way/eve':
+ specifier: 0.1.1
+ version: 0.1.1(eve@packages+eve)
'@novu/chat-sdk-adapter':
specifier: 0.1.0
@@ -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:
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.yaml
index 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]"