skills/vercel__eve
1
0
Fork 0
mirror of https://github.com/vercel/eve.git synced 2026-09-20 05:35:39 +08:00
Code Issues Packages Projects Releases Wiki Activity

feat(docs): add Hindsight memory extension (#1630)

Browse Source 
Signed-off-by: Casey Gowrie <ctgowrie@gmail.com>
This commit is contained in:
Casey Gowrie
2026-08-04 16:58:32 -04:00
committed by GitHub
parent da504b50cc
commit 56d137e11d
11 changed files with 148 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
apps/docs/lib/integrations/data.ts
+59
View File
@@ -1406,6 +1406,65 @@ 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.`,
},
hindsight: {
logo: "hindsight",
docsHref: "https://hindsight.vectorize.io/sdks/integrations/eve",
keywords: [
"memory",
"long-term memory",
"automatic recall",
"retention",
"user profile",
"context",
"Hindsight Cloud",
"self-hosted",
"Vectorize",
],
install: `Install Hindsight memory for eve:
\`\`\`bash
eve add extension/hindsight
\`\`\`
This installs \`@vectorize-io/hindsight-eve\` and writes \`agent/instructions/hindsight.ts\` for recall plus \`agent/hooks/hindsight.ts\` for retention. The package requires Node.js 24 or later.`,
quickStart: `Create a Hindsight Cloud API key and add it to the agent's environment. The API URL defaults to Hindsight Cloud, and the bank defaults to \`default\`:
\`\`\`bash title=".env.local"
HINDSIGHT_API_KEY=...
HINDSIGHT_BANK_ID=my-agent
\`\`\`
The registry creates both capability files:
\`\`\`ts title="agent/instructions/hindsight.ts"
import { hindsightMemory } from "@vectorize-io/hindsight-eve";
export default hindsightMemory();
\`\`\`
\`\`\`ts title="agent/hooks/hindsight.ts"
import { hindsightRetainHook } from "@vectorize-io/hindsight-eve";
export default hindsightRetainHook();
\`\`\`
Before each turn, the dynamic instructions resolver recalls the user's ambient profile and working context. After the turn, the hook retains the user message and assistant reply. Neither path depends on the model choosing to call a tool.`,
configure: `Recall uses a fixed broad query rather than the live user message. Tune the profile context and response budget in the instructions file when needed:
\`\`\`ts title="agent/instructions/hindsight.ts"
import { hindsightMemory } from "@vectorize-io/hindsight-eve";
export default hindsightMemory({
recallQuery: "user preferences, identity, projects, and working context",
budget: "high",
maxTokens: 2048,
});
\`\`\`
For a self-hosted server, set \`HINDSIGHT_API_URL\` and pass \`apiKey: null\` to both factories when the server has no authentication. Other shared options include \`bankId\`, \`context\`, \`includeAssistantReply\`, \`timeoutMs\`, and \`onError\`.
A bank is one isolated memory store, and both files must use the same bank. Do not share the default bank across untrusted users; use separate agent deployments with distinct \`HINDSIGHT_BANK_ID\` values for separate users or tenants. See the [Hindsight eve integration guide](https://hindsight.vectorize.io/sdks/integrations/eve) for Cloud, self-hosted, and factory configuration.`,
},
"agent-browser": {
logo: "agent-browser",
apps/docs/lib/integrations/discovery.test.ts
+13
View File
@@ -80,6 +80,19 @@ describe("integration discovery", () => {
expect(integrationSearchText(agentkit!)).toContain("long-term memory");
});
it("renders the Hindsight memory extension setup", () => {
const hindsight = getIntegration("hindsight");
expect(hindsight).toBeDefined();
const markdown = integrationMarkdown(hindsight!);
expect(markdown).toContain("eve add extension/hindsight");
expect(markdown).toContain('import { hindsightMemory } from "@vectorize-io/hindsight-eve"');
expect(markdown).toContain("hindsightRetainHook");
expect(markdown).toContain("HINDSIGHT_API_KEY");
expect(markdown).toContain("HINDSIGHT_BANK_ID");
expect(integrationSearchText(hindsight!)).toContain("long-term memory");
});
it("renders the GitHub Tools extension setup", () => {
const githubTools = getIntegration("github-tools");
expect(githubTools).toBeDefined();
apps/docs/lib/integrations/logos.tsx
+19
View File
@@ -177,6 +177,24 @@ export const notionLogo = (props: LogoProps) => <SiNotion {...props} />;
export const upstashLogo = (props: LogoProps) => <SiUpstash color="default" {...props} />;
export const hindsightLogo = (props: LogoProps) => (
<svg fill="none" viewBox="0 0 186 139" xmlns="http://www.w3.org/2000/svg" {...props}>
<g stroke="#078BC2" strokeLinecap="round" strokeLinejoin="round" strokeWidth="8">
<path d="m65 53-14-23M121 53l14-23M42 69l-20-5M144 69l20-5M61 96l-16 17M125 96l16 17" />
<circle cx="44" cy="19" fill="white" r="11" />
<circle cx="142" cy="19" fill="white" r="11" />
<circle cx="12" cy="61" fill="white" r="9" />
<circle cx="174" cy="61" fill="white" r="9" />
<circle cx="35" cy="121" fill="white" r="9" />
<circle cx="151" cy="121" fill="white" r="9" />
</g>
<path d="M37 72c14-21 34-33 56-33s42 12 56 33c-14 23-34 35-56 35S51 95 37 72Z" fill="#078BC2" />
<ellipse cx="93" cy="73" fill="white" rx="30" ry="21" />
<circle cx="93" cy="73" fill="#111827" r="17" />
<circle cx="102" cy="64" fill="white" r="7" />
</svg>
);
export const datadogLogo = (props: LogoProps) => <SiDatadog color="default" {...props} />;
export const honeycombLogo = (props: LogoProps) => (
@@ -616,6 +634,7 @@ export const logos = {
raindrop: raindropLogo,
kernel: kernelLogo,
upstash: upstashLogo,
hindsight: hindsightLogo,
airtable: airtableLogo,
bitly: bitlyLogo,
brex: brexLogo,
apps/docs/package.json
+1
View File
@@ -77,6 +77,7 @@
"@types/react": "catalog:",
"@types/react-dom": "catalog:",
"@upstash/agentkit-eve-extension": "^0.4.0",
"@vectorize-io/hindsight-eve": "^0.2.1",
"@veltdev/chat-sdk-adapter": "0.2.4",
"@vercel/connect": "catalog:",
"@vercel/otel": "catalog:",
apps/docs/registry.json
+24
View File
@@ -104,6 +104,30 @@
}
]
},
{
"name": "extension/hindsight",
"type": "registry:item",
"title": "Hindsight",
"description": "Recall relevant context before every turn and retain each exchange automatically.",
"dependencies": ["@vectorize-io/hindsight-eve"],
"envVars": {
"HINDSIGHT_API_KEY": "",
"HINDSIGHT_API_URL": "",
"HINDSIGHT_BANK_ID": ""
},
"files": [
{
"path": "registry/extensions/hindsight-instructions.ts",
"type": "registry:file",
"target": "agent/instructions/hindsight.ts"
},
{
"path": "registry/extensions/hindsight-hook.ts",
"type": "registry:file",
"target": "agent/hooks/hindsight.ts"
}
]
},
{
"name": "connection/browser-use",
"type": "registry:item",
apps/docs/registry/extensions/hindsight-hook.ts
+3
View File
@@ -0,0 +1,3 @@
import { hindsightRetainHook } from "@vectorize-io/hindsight-eve";
export default hindsightRetainHook();
apps/docs/registry/extensions/hindsight-instructions.ts
+3
View File
@@ -0,0 +1,3 @@
import { hindsightMemory } from "@vectorize-io/hindsight-eve";
export default hindsightMemory();
packages/eve-catalog/src/index.test.ts
+5
View File
@@ -93,6 +93,11 @@ describe("integration catalog", () => {
expect(getIntegrationEntry("upstash-agentkit")?.connection).toBeUndefined();
});
it("exposes Hindsight as an extension", () => {
expect(getIntegrationEntry("hindsight")?.kind).toBe("extension");
expect(getIntegrationEntry("hindsight")?.connection).toBeUndefined();
});
it("exposes GitHub Tools as an extension distinct from the GitHub channel", () => {
expect(getIntegrationEntry("github")?.kind).toBe("channel");
expect(getIntegrationEntry("github-tools")?.kind).toBe("extension");
packages/eve-catalog/src/index.ts
+7
View File
@@ -302,6 +302,13 @@ export const INTEGRATIONS: readonly IntegrationEntry[] = [
tagline: "Add long-term memory, Redis Search, and durable chat history with Upstash Redis.",
surfaces: { scaffoldable: false, gallery: true },
},
{
slug: "hindsight",
name: "Hindsight",
kind: "extension",
tagline: "Recall relevant context before every turn and retain each exchange automatically.",
surfaces: { scaffoldable: false, gallery: true },
},
{
slug: "browser-use",
name: "Browser Use",
pnpm-lock.yaml
Generated
+13
View File
@@ -306,6 +306,9 @@ importers:
'@upstash/agentkit-eve-extension':
specifier: ^0.4.0
version: 0.4.0(eve@packages+eve)
'@vectorize-io/hindsight-eve':
specifier: ^0.2.1
version: 0.2.1(eve@packages+eve)
'@veltdev/chat-sdk-adapter':
specifier: 0.2.4
version: 0.2.4(ai@7.0.38(zod@4.4.3))(chat@4.34.0(ai@7.0.38(zod@4.4.3))(supports-color@10.2.2)(zod@4.4.3))(supports-color@10.2.2)(zod@4.4.3)
@@ -7493,6 +7496,12 @@ packages:
'@upstash/redis@1.38.0':
resolution: {integrity: sha512-wu+dZBptlLy0+MCUEoHmzrY/TnmgDey3+c7EbIGwrLqAvkP8yi5MWZHYGIFtAygmL4Bkz2TdFu+eU0vFPncIcg==}
'@vectorize-io/hindsight-eve@0.2.1':
resolution: {integrity: sha512-dFrCRgX/fXNV7bCCXfifmKTEQnj4insbxOQ79GU9mHMwZ9XfjQ1Oq8679C9xHwpItCtx6cDPqWZkluq8iY+qNg==}
engines: {node: '>=24'}
peerDependencies:
eve: '>=0.11.0'
'@veltdev/chat-sdk-adapter@0.2.4':
resolution: {integrity: sha512-Amzn9rMKpkDjpC1uxpn9ztsIdFSF6sC+6KOUhyIPkQhinKCS5AUI1XCO8aLZTlolyDObPt4Gmib8XSmSg9Uclg==}
engines: {node: '>=18'}
@@ -21749,6 +21758,10 @@ snapshots:
dependencies:
uncrypto: 0.1.3
'@vectorize-io/hindsight-eve@0.2.1(eve@packages+eve)':
dependencies:
eve: link:packages/eve
'@veltdev/chat-sdk-adapter@0.2.4(ai@7.0.38(zod@4.4.3))(chat@4.34.0(ai@7.0.38(zod@4.4.3))(supports-color@10.2.2)(zod@4.4.3))(supports-color@10.2.2)(zod@4.4.3)':
dependencies:
'@chat-adapter/shared': 4.34.0(ai@7.0.38(zod@4.4.3))(supports-color@10.2.2)(zod@4.4.3)
pnpm-workspace.yaml
+1
View File
@@ -74,6 +74,7 @@ minimumReleaseAgeExclude:
- "@photon-ai/chat-adapter-imessage"
- "@resend/chat-sdk-adapter"
- "@upstash/agentkit-eve-extension"
- "@vectorize-io/hindsight-eve"
- "@veltdev/chat-sdk-adapter"
- "@zernio/chat-sdk-adapter"
- chat