The Open Framework for Building Agents
feat(docs): add Kybernesis Arcana memory extension (#1728)
Colton Padden0b102bc90e7c
diff --git a/apps/docs/lib/integrations/data.ts b/apps/docs/lib/integrations/data.tsindex a5bdffdd4..3dcc8f5ca 100644--- a/apps/docs/lib/integrations/data.ts+++ b/apps/docs/lib/integrations/data.ts@@ -1404,6 +1404,64 @@ 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.`,+ },+ arcana: {+ logo: "arcana",+ docsHref: "https://github.com/KybernesisAI/platform/tree/master/packages/arcana#readme",+ keywords: [+ "memory",+ "long-term memory",+ "mcp",+ "semantic search",+ "entity graph",+ "timeline",+ "brain notes",+ "Kybernesis",+ ],+ install: `Install Kybernesis Arcana for eve:++\`\`\`bash+eve add extension/arcana+\`\`\`++This installs \`@kybernesis/arcana\` and writes an extension mount. The package requires Node.js 24 or later.`,+ quickStart: `Create an Arcana workspace and workspace-scoped API key, then add both values to the agent's environment:++\`\`\`bash title=".env.local"+ARCANA_API_KEY=kb_your_api_key_here+ARCANA_WORKSPACE=your-workspace+\`\`\`++The registry creates this mount:++\`\`\`ts title="agent/extensions/arcana.ts"+import arcana from "@kybernesis/arcana";++export default arcana({+ apiKey: process.env.ARCANA_API_KEY!,+ workspace: process.env.ARCANA_WORKSPACE!,+});+\`\`\`++The filename supplies the \`arcana\` namespace. The extension adds an MCP memory connection, recall, remember, and brain-note skills, and instructions that tell the model to search the workspace before it claims not to know something.`,+ configure: `An Arcana key is scoped to a workspace. Keep the key in a sensitive environment variable and use a separate workspace and key when people or tenants must not share memory. The model can choose what to store and retrieve, but it cannot choose the configured key or default workspace.++You can select a workspace per session with \`resolveWorkspace\`. Derive it only from verified session context, and only return workspaces that the configured key can access:++\`\`\`ts title="agent/extensions/arcana.ts"+import arcana from "@kybernesis/arcana";++export default arcana({+ apiKey: process.env.ARCANA_API_KEY!,+ workspace: process.env.ARCANA_WORKSPACE!,+ resolveWorkspace: (ctx) =>+ ctx.session.auth.current?.attributes.surface === "dm"+ ? process.env.ARCANA_DM_WORKSPACE+ : undefined,+});+\`\`\`++Arcana stores memories, embeddings, timeline entries, and brain notes in the selected workspace. The shipped instructions tell the model not to store passwords, access tokens, payment data, private keys, or one-time codes; add approval rules to memory-write tools when you need an enforced control. See the [Arcana package documentation](https://github.com/KybernesisAI/platform/tree/master/packages/arcana#readme) for the full configuration and tool reference.`,},hindsight: {logo: "hindsight",diff --git a/apps/docs/lib/integrations/discovery.test.ts b/apps/docs/lib/integrations/discovery.test.tsindex 6ee7de15d..d731099e3 100644--- a/apps/docs/lib/integrations/discovery.test.ts+++ b/apps/docs/lib/integrations/discovery.test.ts@@ -80,6 +80,18 @@ describe("integration discovery", () => {expect(integrationSearchText(agentkit!)).toContain("long-term memory");});+ it("renders the Kybernesis Arcana memory extension setup", () => {+ const arcana = getIntegration("arcana");+ expect(arcana).toBeDefined();++ const markdown = integrationMarkdown(arcana!);+ expect(markdown).toContain("eve add extension/arcana");+ expect(markdown).toContain('import arcana from "@kybernesis/arcana"');+ expect(markdown).toContain("ARCANA_API_KEY");+ expect(markdown).toContain("ARCANA_WORKSPACE");+ expect(integrationSearchText(arcana!)).toContain("long-term memory");+ });+it("renders the Hindsight memory extension setup", () => {const hindsight = getIntegration("hindsight");expect(hindsight).toBeDefined();diff --git a/apps/docs/lib/integrations/logos.tsx b/apps/docs/lib/integrations/logos.tsxindex 5797ed5d2..0a6df7385 100644--- a/apps/docs/lib/integrations/logos.tsx+++ b/apps/docs/lib/integrations/logos.tsx@@ -177,6 +177,21 @@ export const notionLogo = (props: LogoProps) => <SiNotion {...props} />;export const upstashLogo = (props: LogoProps) => <SiUpstash color="default" {...props} />;+export const arcanaLogo = (props: LogoProps) => (+ <svg fill="none" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg" {...props}>+ <circle cx="12" cy="12" r="3" fill="#1A1C1A" />+ <circle cx="5" cy="7" r="2" fill="#1A1C1A" />+ <circle cx="19" cy="7" r="2" fill="#69BE8B" />+ <circle cx="6" cy="18" r="2" fill="#69BE8B" />+ <circle cx="18" cy="18" r="2" fill="#1A1C1A" />+ <path+ d="m6.7 7.8 3.4 2.7m7.2-2.7-3.4 2.7m-6.5 6 3-2.7m4.2 0 3 2.7"+ stroke="#1A1C1A"+ strokeWidth="1.5"+ />+ </svg>+);+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">@@ -655,6 +670,7 @@ export const logos = {raindrop: raindropLogo,kernel: kernelLogo,upstash: upstashLogo,+ arcana: arcanaLogo,hindsight: hindsightLogo,airtable: airtableLogo,bitly: bitlyLogo,diff --git a/apps/docs/package.json b/apps/docs/package.jsonindex 6381913fe..0247e6029 100644--- a/apps/docs/package.json+++ b/apps/docs/package.json@@ -60,6 +60,7 @@"@github-tools/eve-extension": "^0.1.0","@jetty/eve": "^0.3.0","@kapso/chat-adapter": "0.1.1",+ "@kybernesis/arcana": "0.2.0","@larksuite/vercel-chat-adapter": "0.1.2","@linqapp/chat-sdk-adapter": "0.1.0","@liveblocks/chat-sdk-adapter": "3.23.0",diff --git a/apps/docs/registry.json b/apps/docs/registry.jsonindex 3b0cfe2fa..bf830149a 100644--- a/apps/docs/registry.json+++ b/apps/docs/registry.json@@ -129,6 +129,24 @@}]},+ {+ "name": "extension/arcana",+ "type": "registry:item",+ "title": "Kybernesis Arcana",+ "description": "Give an eve agent a workspace-scoped long-term memory with recall, storage, and brain notes.",+ "dependencies": ["@kybernesis/arcana"],+ "envVars": {+ "ARCANA_API_KEY": "",+ "ARCANA_WORKSPACE": ""+ },+ "files": [+ {+ "path": "registry/extensions/arcana.ts",+ "type": "registry:file",+ "target": "agent/extensions/arcana.ts"+ }+ ]+ },{"name": "extension/hindsight","type": "registry:item",diff --git a/apps/docs/registry/extensions/arcana.ts b/apps/docs/registry/extensions/arcana.tsnew file mode 100644index 000000000..d899380c9--- /dev/null+++ b/apps/docs/registry/extensions/arcana.ts@@ -0,0 +1,6 @@+import arcana from "@kybernesis/arcana";++export default arcana({+ apiKey: process.env.ARCANA_API_KEY!,+ workspace: process.env.ARCANA_WORKSPACE!,+});diff --git a/packages/eve-catalog/src/index.test.ts b/packages/eve-catalog/src/index.test.tsindex af93589ba..0d67656bd 100644--- a/packages/eve-catalog/src/index.test.ts+++ b/packages/eve-catalog/src/index.test.ts@@ -93,6 +93,11 @@ describe("integration catalog", () => {expect(getIntegrationEntry("upstash-agentkit")?.connection).toBeUndefined();});+ it("exposes Kybernesis Arcana as an extension", () => {+ expect(getIntegrationEntry("arcana")?.kind).toBe("extension");+ expect(getIntegrationEntry("arcana")?.connection).toBeUndefined();+ });+it("exposes Hindsight as an extension", () => {expect(getIntegrationEntry("hindsight")?.kind).toBe("extension");expect(getIntegrationEntry("hindsight")?.connection).toBeUndefined();diff --git a/packages/eve-catalog/src/index.ts b/packages/eve-catalog/src/index.tsindex 623dd64ac..74988635f 100644--- a/packages/eve-catalog/src/index.ts+++ b/packages/eve-catalog/src/index.ts@@ -303,6 +303,14 @@ 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: "arcana",+ name: "Kybernesis Arcana",+ kind: "extension",+ tagline:+ "Give your agent workspace-scoped long-term memory with recall, storage, and brain notes.",+ surfaces: { scaffoldable: false, gallery: true },+ },{slug: "hindsight",name: "Hindsight",diff --git a/pnpm-lock.yaml b/pnpm-lock.yamlindex d2f1f84bc..65158c854 100644--- a/pnpm-lock.yaml+++ b/pnpm-lock.yaml@@ -255,6 +255,9 @@ importers:'@kapso/chat-adapter':specifier: 0.1.1version: 0.1.1([email protected]([email protected]))([email protected]([email protected]([email protected]))([email protected])([email protected]))([email protected])([email protected])+ '@kybernesis/arcana':+ specifier: 0.2.0+ version: 0.2.0(eve@packages+eve)'@larksuite/vercel-chat-adapter':specifier: 0.1.2version: 0.1.2([email protected]([email protected]))([email protected])([email protected]([email protected]([email protected]))([email protected])([email protected]))([email protected]([email protected]))([email protected])([email protected])@@ -3235,6 +3238,12 @@ packages:'@kwsites/[email protected]':resolution: {integrity: sha512-GaHYm+c0O9MjZRu0ongGBRbinu8gVAMd2UZjji6jVmqKtZluZnptXGWhz1E8j8D2HJ3f/yMxKAUC0b+57wncIw==}+ '@kybernesis/[email protected]':+ resolution: {integrity: sha512-9F0zw/SDgutjOFXqnpgyJhBuePVbGKJRS+p0V37ejbcNe+GH/LTWLowEz8t/o9d98JgnJfxK0cuJcEPqjI2qrQ==}+ engines: {node: 24.x}+ peerDependencies:+ eve: '>=0.30.0 <0.31.0'+'@langchain/[email protected]':resolution: {integrity: sha512-GIrJktdsFPx8gM0C3VyikkeYGZAV7iRIzUJuS5tFatiKLExybou0LI0MuxH9kksN38quyfWdQDl20lIEAEVkVA==}engines: {node: '>=20'}@@ -17363,6 +17372,11 @@ snapshots:'@kwsites/[email protected]': {}+ '@kybernesis/[email protected](eve@packages+eve)':+ dependencies:+ eve: link:packages/eve+ zod: 4.4.3+'@langchain/[email protected](@opentelemetry/[email protected])(@opentelemetry/[email protected](@opentelemetry/[email protected]))([email protected]([email protected]([email protected]))([email protected]))([email protected]([email protected]))':dependencies:'@cfworker/json-schema': 4.1.1diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yamlindex 0c0edd932..d652fe22e 100644--- a/pnpm-workspace.yaml+++ b/pnpm-workspace.yaml@@ -66,6 +66,7 @@ minimumReleaseAgeExclude:- "@getdial/chat-sdk-adapter"- "@github-tools/eve-extension"- "@github-tools/sdk"+ - "@kybernesis/arcana"- "@kapso/chat-adapter"- "@larksuite/vercel-chat-adapter"- "@linqapp/chat-sdk-adapter"