@brain-protocol/mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Brain Protocol
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,216 @@
+# @brain-protocol/mcp
+
+Verifiable Memory-as-a-Service for AI Agents. An MCP server that gives any AI agent persistent knowledge with full-text search, a knowledge graph, and optional on-chain verification via Starknet.
+
+**Dual-mode**: SQLite local (zero config) or cloud (HTTP to your Brain Protocol API).
+
+## Quick Start
+
+```bash
+npx @brain-protocol/mcp
+```
+
+That's it. The server starts in local mode with a SQLite database at the XDG-compliant default path.
+
+## Installation
+
+```bash
+npm install -g @brain-protocol/mcp
+# or
+pnpm add -g @brain-protocol/mcp
+```
+
+## Configuration
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "brain": {
+      "command": "npx",
+      "args": ["@brain-protocol/mcp"]
+    }
+  }
+}
+```
+
+### Claude Code
+
+Add to `~/.claude.json`:
+
+```json
+{
+  "mcpServers": {
+    "brain": {
+      "command": "npx",
+      "args": ["@brain-protocol/mcp"]
+    }
+  }
+}
+```
+
+### Cursor
+
+Add to `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "brain": {
+      "command": "npx",
+      "args": ["@brain-protocol/mcp"]
+    }
+  }
+}
+```
+
+### Cloud Mode
+
+To connect to a Brain Protocol API instead of local SQLite:
+
+```json
+{
+  "mcpServers": {
+    "brain": {
+      "command": "npx",
+      "args": ["@brain-protocol/mcp"],
+      "env": {
+        "BRAIN_API_URL": "https://brain.api.vauban.tech",
+        "BRAIN_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+## Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `BRAIN_API_URL` | _(unset = local mode)_ | Cloud API URL. When set, uses HTTP instead of SQLite |
+| `BRAIN_API_KEY` | _(unset)_ | Bearer token for cloud API authentication |
+| `BRAIN_DB_PATH` | XDG default | Custom path for the SQLite database file |
+
+### Default Database Paths
+
+| Platform | Path |
+|----------|------|
+| Linux | `~/.local/share/brain-protocol/brain.db` |
+| macOS | `~/Library/Application Support/brain-protocol/brain.db` |
+| Windows | `%APPDATA%/brain-protocol/brain.db` |
+
+Override with `XDG_DATA_HOME` (Linux) or `BRAIN_DB_PATH` (any platform).
+
+## Tools Reference
+
+### query_knowledge
+
+Search the knowledge base using full-text search with filters.
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `q` | string | Search query |
+| `category` | string | Filter by category |
+| `author` | string | Filter by author |
+| `tags` | string | Filter by tags (comma-separated) |
+| `limit` | number | Max results (default 10, max 100) |
+| `offset` | number | Pagination offset |
+
+### archive_knowledge
+
+Store a new knowledge entry.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `content` | string | Yes | Knowledge content |
+| `content_type` | string | No | markdown, code, decision, pattern, documentation, git_commit, json, structured_data |
+| `author` | string | No | Author name (default: user) |
+| `category` | string | No | Category (default: documentation) |
+| `tags` | string[] | No | Tags array |
+| `confidence` | number | No | Confidence 0-1 (default: 0.8) |
+
+### create_edge
+
+Create a relationship between two knowledge entries.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `source_id` | string | Yes | Source entry UUID |
+| `target_id` | string | Yes | Target entry UUID |
+| `edge_type` | string | Yes | derives_from, conflicts_with, validates, extends, implements, supersedes, tested_by, documented_by, optimizes, related_to |
+| `confidence` | number | No | Edge confidence 0-1 |
+
+### get_graph
+
+Traverse the knowledge graph from an entry.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `entry_id` | string | Yes | Starting entry UUID |
+| `depth` | number | No | Max depth (default 3, max 5) |
+
+### get_stats
+
+Get knowledge base statistics. No parameters.
+
+### prove (cloud only)
+
+Anchor a knowledge entry on Starknet for verifiable proof.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `entry_id` | string | Yes | Entry UUID to anchor |
+
+### verify (cloud only)
+
+Verify a knowledge entry's on-chain proof.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `entry_id` | string | Yes | Entry UUID to verify |
+
+### export
+
+Export all knowledge entries and edges.
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `format` | string | Export format (json) |
+
+## Architecture
+
+```
+@brain-protocol/mcp
+├── index.ts          # Entry point: env detection, store init
+├── server.ts         # MCP Server factory
+├── store/
+│   ├── adapter.ts    # StoreAdapter interface
+│   ├── sqlite.ts     # SQLiteStore (better-sqlite3 + FTS5)
+│   ├── cloud.ts      # CloudStore (HTTP client)
+│   └── paths.ts      # XDG-compliant path resolution
+└── tools/            # 8 MCP tool handlers
+```
+
+**3 production dependencies**: `@modelcontextprotocol/sdk`, `better-sqlite3`, `zod`.
+
+## Local Mode Features
+
+- SQLite with WAL mode for concurrent reads
+- FTS5 full-text search with ranking
+- Knowledge graph with recursive CTE traversal
+- Cycle detection in graph traversal
+- Automatic schema creation on first run
+
+## Cloud Mode Features
+
+- All local features via HTTP API
+- `prove`: Anchor knowledge hashes on Starknet (Poseidon hash + L2)
+- `verify`: Verify on-chain proofs
+- Bearer token authentication
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+export { createMCPServer } from "./server.js";
+export { SQLiteStore } from "./store/sqlite.js";
+export { CloudStore } from "./store/cloud.js";
+export type { StoreAdapter } from "./store/adapter.js";
+export type * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAiDA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,mBAAmB,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createMCPServer } from "./server.js";
+import { CloudStore } from "./store/cloud.js";
+import { SQLiteStore } from "./store/sqlite.js";
+import { getDbPath } from "./store/paths.js";
+function createStore() {
+    const apiUrl = process.env.BRAIN_API_URL;
+    if (apiUrl) {
+        const apiKey = process.env.BRAIN_API_KEY;
+        return new CloudStore(apiUrl, apiKey);
+    }
+    return new SQLiteStore();
+}
+async function main() {
+    const store = createStore();
+    await store.initialize();
+    const mode = store.mode;
+    const location = mode === "local" ? getDbPath() : process.env.BRAIN_API_URL;
+    process.stderr.write(`brain-protocol MCP server starting (${mode} mode: ${location})\n`);
+    const server = createMCPServer(store);
+    const transport = new StdioServerTransport();
+    process.on("SIGINT", async () => {
+        await store.close();
+        process.exit(0);
+    });
+    process.on("SIGTERM", async () => {
+        await store.close();
+        process.exit(0);
+    });
+    await server.connect(transport);
+}
+main().catch((err) => {
+    process.stderr.write(`Fatal error: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});
+// Re-export for programmatic use
+export { createMCPServer } from "./server.js";
+export { SQLiteStore } from "./store/sqlite.js";
+export { CloudStore } from "./store/cloud.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,SAAS,WAAW;IAClB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAEzC,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;QACzC,OAAO,IAAI,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,IAAI,WAAW,EAAE,CAAC;AAC3B,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;IAC5B,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC;IAEzB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACxB,MAAM,QAAQ,GAAG,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAC5E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,IAAI,UAAU,QAAQ,KAAK,CAAC,CAAC;IAEzF,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;QAC9B,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;QAC/B,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC3F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,iCAAiC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/schemas.d.ts

@@ -0,0 +1,96 @@
+import { z } from "zod";
+export declare const queryKnowledgeSchema: z.ZodObject<{
+    q: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    offset: number;
+    q?: string | undefined;
+    category?: string | undefined;
+    author?: string | undefined;
+    tags?: string | undefined;
+}, {
+    q?: string | undefined;
+    category?: string | undefined;
+    author?: string | undefined;
+    tags?: string | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
+export declare const archiveKnowledgeSchema: z.ZodObject<{
+    content: z.ZodString;
+    content_type: z.ZodDefault<z.ZodOptional<z.ZodEnum<["markdown", "code", "decision", "pattern", "documentation", "git_commit", "json", "structured_data"]>>>;
+    author: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    category: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    tags: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    confidence: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    metadata: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, "strip", z.ZodTypeAny, {
+    category: string;
+    author: string;
+    tags: string[];
+    content: string;
+    content_type: "markdown" | "code" | "decision" | "pattern" | "documentation" | "git_commit" | "json" | "structured_data";
+    confidence: number;
+    metadata: Record<string, unknown>;
+}, {
+    content: string;
+    category?: string | undefined;
+    author?: string | undefined;
+    tags?: string[] | undefined;
+    content_type?: "markdown" | "code" | "decision" | "pattern" | "documentation" | "git_commit" | "json" | "structured_data" | undefined;
+    confidence?: number | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}>;
+export declare const createEdgeSchema: z.ZodObject<{
+    source_id: z.ZodString;
+    target_id: z.ZodString;
+    edge_type: z.ZodEnum<["derives_from", "conflicts_with", "validates", "extends", "implements", "supersedes", "tested_by", "documented_by", "optimizes", "related_to"]>;
+    confidence: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    source_id: string;
+    target_id: string;
+    edge_type: "derives_from" | "conflicts_with" | "validates" | "extends" | "implements" | "supersedes" | "tested_by" | "documented_by" | "optimizes" | "related_to";
+    confidence?: number | undefined;
+}, {
+    source_id: string;
+    target_id: string;
+    edge_type: "derives_from" | "conflicts_with" | "validates" | "extends" | "implements" | "supersedes" | "tested_by" | "documented_by" | "optimizes" | "related_to";
+    confidence?: number | undefined;
+}>;
+export declare const getGraphSchema: z.ZodObject<{
+    entry_id: z.ZodString;
+    depth: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    entry_id: string;
+    depth: number;
+}, {
+    entry_id: string;
+    depth?: number | undefined;
+}>;
+export declare const proveSchema: z.ZodObject<{
+    entry_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    entry_id: string;
+}, {
+    entry_id: string;
+}>;
+export declare const verifySchema: z.ZodObject<{
+    entry_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    entry_id: string;
+}, {
+    entry_id: string;
+}>;
+export declare const exportSchema: z.ZodObject<{
+    format: z.ZodDefault<z.ZodOptional<z.ZodEnum<["json"]>>>;
+}, "strip", z.ZodTypeAny, {
+    format: "json";
+}, {
+    format?: "json" | undefined;
+}>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;EAO/B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;EAWjC,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;EAgB3B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;EAGzB,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;EAEtB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;EAEvB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;EAEvB,CAAC"}

package/dist/schemas.js

@@ -0,0 +1,52 @@
+import { z } from "zod";
+export const queryKnowledgeSchema = z.object({
+    q: z.string().optional(),
+    category: z.string().optional(),
+    author: z.string().optional(),
+    tags: z.string().optional(),
+    limit: z.number().int().min(1).max(100).optional().default(10),
+    offset: z.number().int().min(0).optional().default(0),
+});
+export const archiveKnowledgeSchema = z.object({
+    content: z.string().min(1),
+    content_type: z
+        .enum(["markdown", "code", "decision", "pattern", "documentation", "git_commit", "json", "structured_data"])
+        .optional()
+        .default("markdown"),
+    author: z.string().optional().default("user"),
+    category: z.string().optional().default("documentation"),
+    tags: z.array(z.string()).optional().default([]),
+    confidence: z.number().min(0).max(1).optional().default(0.8),
+    metadata: z.record(z.unknown()).optional().default({}),
+});
+export const createEdgeSchema = z.object({
+    source_id: z.string().uuid(),
+    target_id: z.string().uuid(),
+    edge_type: z.enum([
+        "derives_from",
+        "conflicts_with",
+        "validates",
+        "extends",
+        "implements",
+        "supersedes",
+        "tested_by",
+        "documented_by",
+        "optimizes",
+        "related_to",
+    ]),
+    confidence: z.number().min(0).max(1).optional(),
+});
+export const getGraphSchema = z.object({
+    entry_id: z.string().uuid(),
+    depth: z.number().int().min(1).max(5).optional().default(3),
+});
+export const proveSchema = z.object({
+    entry_id: z.string().uuid(),
+});
+export const verifySchema = z.object({
+    entry_id: z.string().uuid(),
+});
+export const exportSchema = z.object({
+    format: z.enum(["json"]).optional().default("json"),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,4 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import type { StoreAdapter } from "./store/adapter.js";
+export declare function createMCPServer(store: StoreAdapter): Server;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAEnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CA4B3D"}

package/dist/server.js

@@ -0,0 +1,27 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { handleTool, toolDefinitions } from "./tools/index.js";
+export function createMCPServer(store) {
+    const server = new Server({ name: "brain-protocol", version: "0.1.0" }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: toolDefinitions,
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        try {
+            const result = await handleTool(store, name, (args || {}));
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Unknown error";
+            return {
+                content: [{ type: "text", text: JSON.stringify({ error: message }) }],
+                isError: true,
+            };
+        }
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAEnG,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE/D,MAAM,UAAU,eAAe,CAAC,KAAmB;IACjD,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,EAAE,EAC5C,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;IAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5D,KAAK,EAAE,eAAe;KACvB,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QAEjD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC,CAAC;YACtF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACnE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;YACzE,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;gBACrE,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/store/adapter.d.ts

@@ -0,0 +1,19 @@
+import type { CreateEdgeInput, CreateEntryInput, ExportData, GraphResult, KnowledgeEdge, KnowledgeEntry, ProveResult, QueryOptions, StoreStats, VerifyResult } from "../types.js";
+export interface StoreAdapter {
+    initialize(): Promise<void>;
+    close(): Promise<void>;
+    readonly mode: "local" | "cloud";
+    query(options: QueryOptions): Promise<{
+        entries: KnowledgeEntry[];
+        total: number;
+    }>;
+    create(input: CreateEntryInput): Promise<KnowledgeEntry>;
+    getById(id: string): Promise<KnowledgeEntry | null>;
+    createEdge(input: CreateEdgeInput): Promise<KnowledgeEdge>;
+    traverseGraph(entryId: string, depth: number): Promise<GraphResult>;
+    getStats(): Promise<StoreStats>;
+    exportAll(): Promise<ExportData>;
+    prove?(entryId: string): Promise<ProveResult>;
+    verify?(entryId: string): Promise<VerifyResult>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/store/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/store/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,aAAa,EACb,cAAc,EACd,WAAW,EACX,YAAY,EACZ,UAAU,EACV,YAAY,EACb,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,YAAY;IAC3B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IAEjC,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,cAAc,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpF,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACzD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAEpD,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC3D,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEpE,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;IAChC,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;IAEjC,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACjD"}

package/dist/store/adapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=adapter.js.map

package/dist/store/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/store/adapter.ts"],"names":[],"mappings":""}

package/dist/store/cloud.d.ts

@@ -0,0 +1,25 @@
+import type { StoreAdapter } from "./adapter.js";
+import type { CreateEdgeInput, CreateEntryInput, ExportData, GraphResult, KnowledgeEdge, KnowledgeEntry, ProveResult, QueryOptions, StoreStats, VerifyResult } from "../types.js";
+export declare class CloudStore implements StoreAdapter {
+    readonly mode: "cloud";
+    private baseUrl;
+    private apiKey;
+    constructor(baseUrl: string, apiKey?: string);
+    initialize(): Promise<void>;
+    close(): Promise<void>;
+    private fetch;
+    private fetchJson;
+    query(options: QueryOptions): Promise<{
+        entries: KnowledgeEntry[];
+        total: number;
+    }>;
+    create(input: CreateEntryInput): Promise<KnowledgeEntry>;
+    getById(id: string): Promise<KnowledgeEntry | null>;
+    createEdge(input: CreateEdgeInput): Promise<KnowledgeEdge>;
+    traverseGraph(entryId: string, depth: number): Promise<GraphResult>;
+    getStats(): Promise<StoreStats>;
+    exportAll(): Promise<ExportData>;
+    prove(entryId: string): Promise<ProveResult>;
+    verify(entryId: string): Promise<VerifyResult>;
+}
+//# sourceMappingURL=cloud.d.ts.map

package/dist/store/cloud.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud.d.ts","sourceRoot":"","sources":["../../src/store/cloud.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,aAAa,EACb,cAAc,EACd,WAAW,EACX,YAAY,EACZ,UAAU,EACV,YAAY,EACb,MAAM,aAAa,CAAC;AAErB,qBAAa,UAAW,YAAW,YAAY;IAC7C,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;IACjC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAqB;gBAEvB,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAKtC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAId,KAAK;YAgBL,SAAS;IAcjB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,cAAc,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAgCnF,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC;IAexD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAQnD,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC;IAO1D,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IASnE,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC;IAI/B,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC;IAqBhC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAM5C,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CASrD"}