agentvault 1.0.1 → 1.0.5

package/dist/src/wiki/query.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Wiki Query Service
+ *
+ * Implements Karpathy's "Query" operation: search the wiki for relevant pages,
+ * synthesize an answer with citations, and optionally file the exploration
+ * back into the wiki as a new page.
+ */
+import type { WikiPage, WikiQueryResult } from '../backbone/types.js';
+import type { WikiStore } from './wiki-store.js';
+/** LLM adapter for query synthesis */
+export interface WikiQueryLLMAdapter {
+    /**
+     * Given a question and relevant wiki pages, produce a synthesized answer
+     * with citations back to source pages.
+     */
+    answerQuery(question: string, relevantPages: WikiPage[], schemaPrompt?: string): Promise<WikiQueryResult>;
+}
+export declare class WikiQueryService {
+    private store;
+    private llm;
+    private wikiId;
+    constructor(store: WikiStore, llm: WikiQueryLLMAdapter, wikiId: string);
+    /**
+     * Query the wiki: find relevant pages, synthesize an answer.
+     */
+    query(question: string): Promise<WikiQueryResult>;
+    /**
+     * File a query result back into the wiki as an exploration page.
+     * This is what makes the wiki compound — valuable queries become pages.
+     */
+    fileExploration(question: string, result: WikiQueryResult): Promise<WikiPage>;
+    /**
+     * Simple relevance ranking using keyword overlap.
+     * In production, this would use embeddings or the LLM for semantic search.
+     */
+    private rankRelevance;
+}
+//# sourceMappingURL=query.d.ts.map

package/dist/src/wiki/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/wiki/query.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,sCAAsC;AACtC,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,WAAW,CACT,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,QAAQ,EAAE,EACzB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,eAAe,CAAC,CAAC;CAC7B;AAED,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,MAAM;gBAFN,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,mBAAmB,EACxB,MAAM,EAAE,MAAM;IAGxB;;OAEG;IACG,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IA0BvD;;;OAGG;IACG,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,QAAQ,CAAC;IAkDpB;;;OAGG;IACH,OAAO,CAAC,aAAa;CA0BtB"}

package/dist/src/wiki/query.js

@@ -0,0 +1,117 @@
+/**
+ * Wiki Query Service
+ *
+ * Implements Karpathy's "Query" operation: search the wiki for relevant pages,
+ * synthesize an answer with citations, and optionally file the exploration
+ * back into the wiki as a new page.
+ */
+import { randomUUID } from 'node:crypto';
+export class WikiQueryService {
+    store;
+    llm;
+    wikiId;
+    constructor(store, llm, wikiId) {
+        this.store = store;
+        this.llm = llm;
+        this.wikiId = wikiId;
+    }
+    /**
+     * Query the wiki: find relevant pages, synthesize an answer.
+     */
+    async query(question) {
+        // 1. Search for relevant pages
+        const allPages = await this.store.listPages(this.wikiId);
+        const relevantPages = this.rankRelevance(question, allPages);
+        // 2. Get schema for query prompt customization
+        const schema = await this.store.getSchema(this.wikiId);
+        // 3. LLM synthesis
+        const result = await this.llm.answerQuery(question, relevantPages, schema?.queryPrompt);
+        // 4. Log the query
+        await this.store.appendLog(this.wikiId, {
+            timestamp: new Date().toISOString(),
+            operation: 'query',
+            summary: `Query: "${question}" — consulted ${result.pagesConsulted.length} pages`,
+            pagesSlugs: result.pagesConsulted,
+        });
+        return result;
+    }
+    /**
+     * File a query result back into the wiki as an exploration page.
+     * This is what makes the wiki compound — valuable queries become pages.
+     */
+    async fileExploration(question, result) {
+        const slug = `exploration-${Date.now()}`;
+        const now = new Date().toISOString();
+        // Build citation section
+        const citations = result.citations
+            .map((c) => `- [[${c.slug}]] — ${c.title}: "${c.excerpt}"`)
+            .join('\n');
+        const content = [
+            `# ${question}`,
+            '',
+            result.answer,
+            '',
+            '## Sources',
+            '',
+            citations,
+            '',
+            `*Filed automatically on ${now}*`,
+        ].join('\n');
+        const page = {
+            id: randomUUID(),
+            companyId: this.wikiId,
+            title: question,
+            content,
+            category: 'exploration',
+            status: 'draft',
+            version: 1,
+            createdBy: 'wiki-query',
+            slug,
+            crossRefs: result.citations.map((c) => c.slug),
+            sourceRefs: [],
+            staleness: 'fresh',
+            createdAt: now,
+            updatedAt: now,
+        };
+        await this.store.createPage(page);
+        await this.store.appendLog(this.wikiId, {
+            timestamp: now,
+            operation: 'ingest',
+            summary: `Filed exploration: "${question}"`,
+            pagesSlugs: [slug],
+        });
+        return page;
+    }
+    /**
+     * Simple relevance ranking using keyword overlap.
+     * In production, this would use embeddings or the LLM for semantic search.
+     */
+    rankRelevance(question, pages) {
+        const queryTerms = question
+            .toLowerCase()
+            .split(/\s+/)
+            .filter((t) => t.length > 2);
+        const scored = pages
+            .filter((p) => p.category !== 'log')
+            .map((page) => {
+            const text = `${page.title} ${page.content} ${(page.tags ?? []).join(' ')}`.toLowerCase();
+            let score = 0;
+            for (const term of queryTerms) {
+                if (text.includes(term))
+                    score++;
+                // Boost title matches
+                if (page.title.toLowerCase().includes(term))
+                    score += 2;
+                // Boost tag matches
+                if ((page.tags ?? []).some((t) => t.toLowerCase().includes(term)))
+                    score += 1;
+            }
+            return { page, score };
+        })
+            .filter((s) => s.score > 0)
+            .sort((a, b) => b.score - a.score);
+        // Return top 20 most relevant pages
+        return scored.slice(0, 20).map((s) => s.page);
+    }
+}
+//# sourceMappingURL=query.js.map

package/dist/src/wiki/query.js.map

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

package/dist/src/wiki/wiki-store.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Wiki Store
+ *
+ * Storage adapter for wiki pages. Extends the KnowledgeStore pattern
+ * with wiki-specific operations (slug lookup, cross-ref queries, etc.).
+ *
+ * Default implementation is in-memory; consumers can inject a
+ * canister-backed or file-system adapter.
+ */
+import type { WikiPage, WikiStaleness, WikiLogEntry, WikiSchema } from '../backbone/types.js';
+import type { KnowledgeCategory, KnowledgeStatus } from '../backbone/constants.js';
+export interface WikiListFilters {
+    category?: KnowledgeCategory;
+    status?: KnowledgeStatus;
+    staleness?: WikiStaleness;
+    search?: string;
+    tags?: string[];
+}
+/** Storage adapter interface for wiki pages */
+export interface WikiStore {
+    listPages(wikiId: string, filters?: WikiListFilters): Promise<WikiPage[]>;
+    getPage(wikiId: string, slug: string): Promise<WikiPage | null>;
+    getPageById(id: string): Promise<WikiPage | null>;
+    createPage(page: WikiPage): Promise<WikiPage>;
+    updatePage(wikiId: string, slug: string, partial: Partial<WikiPage>): Promise<WikiPage | null>;
+    deletePage(wikiId: string, slug: string): Promise<boolean>;
+    getBacklinks(wikiId: string, slug: string): Promise<WikiPage[]>;
+    getOrphans(wikiId: string): Promise<WikiPage[]>;
+    appendLog(wikiId: string, entry: WikiLogEntry): Promise<void>;
+    getLog(wikiId: string, limit?: number): Promise<WikiLogEntry[]>;
+    getSchema(wikiId: string): Promise<WikiSchema | null>;
+    setSchema(wikiId: string, schema: WikiSchema): Promise<void>;
+}
+/** In-memory implementation of WikiStore */
+export declare class InMemoryWikiStore implements WikiStore {
+    private pages;
+    private logs;
+    private schemas;
+    private makeKey;
+    listPages(wikiId: string, filters?: WikiListFilters): Promise<WikiPage[]>;
+    getPage(wikiId: string, slug: string): Promise<WikiPage | null>;
+    getPageById(id: string): Promise<WikiPage | null>;
+    createPage(page: WikiPage): Promise<WikiPage>;
+    updatePage(wikiId: string, slug: string, partial: Partial<WikiPage>): Promise<WikiPage | null>;
+    deletePage(wikiId: string, slug: string): Promise<boolean>;
+    getBacklinks(wikiId: string, slug: string): Promise<WikiPage[]>;
+    getOrphans(wikiId: string): Promise<WikiPage[]>;
+    appendLog(wikiId: string, entry: WikiLogEntry): Promise<void>;
+    getLog(wikiId: string, limit?: number): Promise<WikiLogEntry[]>;
+    getSchema(wikiId: string): Promise<WikiSchema | null>;
+    setSchema(wikiId: string, schema: WikiSchema): Promise<void>;
+}
+//# sourceMappingURL=wiki-store.d.ts.map

package/dist/src/wiki/wiki-store.d.ts.map

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

package/dist/src/wiki/wiki-store.js

@@ -0,0 +1,132 @@
+/**
+ * Wiki Store
+ *
+ * Storage adapter for wiki pages. Extends the KnowledgeStore pattern
+ * with wiki-specific operations (slug lookup, cross-ref queries, etc.).
+ *
+ * Default implementation is in-memory; consumers can inject a
+ * canister-backed or file-system adapter.
+ */
+/** In-memory implementation of WikiStore */
+export class InMemoryWikiStore {
+    pages = new Map();
+    logs = new Map();
+    schemas = new Map();
+    makeKey(wikiId, slug) {
+        return `${wikiId}:${slug}`;
+    }
+    async listPages(wikiId, filters) {
+        const results = [];
+        for (const page of this.pages.values()) {
+            if (page.companyId !== wikiId)
+                continue;
+            if (filters?.category && page.category !== filters.category)
+                continue;
+            if (filters?.status && page.status !== filters.status)
+                continue;
+            if (filters?.staleness && page.staleness !== filters.staleness)
+                continue;
+            if (filters?.tags?.length) {
+                const pageTags = page.tags ?? [];
+                if (!filters.tags.some((t) => pageTags.includes(t)))
+                    continue;
+            }
+            if (filters?.search) {
+                const term = filters.search.toLowerCase();
+                if (!page.title.toLowerCase().includes(term) &&
+                    !page.content.toLowerCase().includes(term) &&
+                    !page.slug.toLowerCase().includes(term)) {
+                    continue;
+                }
+            }
+            results.push(page);
+        }
+        return results;
+    }
+    async getPage(wikiId, slug) {
+        return this.pages.get(this.makeKey(wikiId, slug)) ?? null;
+    }
+    async getPageById(id) {
+        for (const page of this.pages.values()) {
+            if (page.id === id)
+                return page;
+        }
+        return null;
+    }
+    async createPage(page) {
+        this.pages.set(this.makeKey(page.companyId, page.slug), page);
+        return page;
+    }
+    async updatePage(wikiId, slug, partial) {
+        const key = this.makeKey(wikiId, slug);
+        const existing = this.pages.get(key);
+        if (!existing)
+            return null;
+        const updated = {
+            ...existing,
+            ...partial,
+            updatedAt: new Date().toISOString(),
+        };
+        // If slug changed, re-key
+        if (partial.slug && partial.slug !== slug) {
+            this.pages.delete(key);
+            this.pages.set(this.makeKey(wikiId, partial.slug), updated);
+        }
+        else {
+            this.pages.set(key, updated);
+        }
+        return updated;
+    }
+    async deletePage(wikiId, slug) {
+        return this.pages.delete(this.makeKey(wikiId, slug));
+    }
+    async getBacklinks(wikiId, slug) {
+        const results = [];
+        for (const page of this.pages.values()) {
+            if (page.companyId !== wikiId)
+                continue;
+            if (page.crossRefs.includes(slug)) {
+                results.push(page);
+            }
+        }
+        return results;
+    }
+    async getOrphans(wikiId) {
+        // Pages that are not referenced by any other page and reference no pages
+        const allSlugs = new Set();
+        const referencedSlugs = new Set();
+        const wikiPages = [];
+        for (const page of this.pages.values()) {
+            if (page.companyId !== wikiId)
+                continue;
+            wikiPages.push(page);
+            allSlugs.add(page.slug);
+            for (const ref of page.crossRefs) {
+                referencedSlugs.add(ref);
+            }
+        }
+        return wikiPages.filter((page) => !referencedSlugs.has(page.slug) &&
+            page.crossRefs.length === 0 &&
+            page.category !== 'index' &&
+            page.category !== 'log');
+    }
+    async appendLog(wikiId, entry) {
+        const log = this.logs.get(wikiId) ?? [];
+        log.push(entry);
+        this.logs.set(wikiId, log);
+    }
+    async getLog(wikiId, limit) {
+        const log = this.logs.get(wikiId) ?? [];
+        if (limit) {
+            return log.slice(-limit);
+        }
+        return [...log];
+    }
+    async getSchema(wikiId) {
+        return this.schemas.get(wikiId) ?? null;
+    }
+    async setSchema(wikiId, schema) {
+        this.schemas.set(wikiId, schema);
+    }
+}
+//# sourceMappingURL=wiki-store.js.map

package/dist/src/wiki/wiki-store.js.map

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

package/package.json

@@ -1,26 +1,51 @@
 {
   "name": "agentvault",
-  "version": "1.0.1",
-  "description": "Persistent On-Chain AI Agent Platform - Sovereign, Reconstructible, Autonomous",
-  "main": "src/index.ts",
+  "version": "1.0.5",
+  "description": "Production infrastructure for deploying and running AI agents on Internet Computer canisters",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    },
+    "./vault": {
+      "types": "./dist/src/vault/index.d.ts",
+      "import": "./dist/src/vault/index.js"
+    },
+    "./backbone": {
+      "types": "./dist/src/backbone/index.d.ts",
+      "import": "./dist/src/backbone/index.js"
+    }
+  },
   "bin": {
     "agentvault": "dist/cli/index.js"
   },
+  "files": [
+    "dist/src",
+    "dist/cli",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
   "type": "module",
   "scripts": {
     "dev": "npm run dev:core",
     "dev:core": "tsx watch src/index.ts",
     "dev:webapp": "npm --prefix webapp run dev",
     "dev:dashboard": "node scripts/dev-dashboard.mjs",
+    "clean": "node -e \"fs.rmSync('dist', { recursive: true, force: true })\"",
     "build": "tsc",
-    "start": "node dist/index.js",
+    "prepack": "npm run clean && npm run build",
+    "start": "node dist/src/index.js",
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit",
     "typecheck:webapp": "npm --prefix webapp run typecheck",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
-    "lint:webapp": "npm --prefix webapp run lint"
+    "lint:webapp": "npm --prefix webapp run lint",
+    "audio:catfish": "tsx scripts/generate-catfish-audio.ts"
   },
   "keywords": [
     "agent",
@@ -28,7 +53,6 @@
     "icp",
     "wasm",
     "blockchain",
-    "sovereign",
     "canister",
     "internet-computer",
     "clawdbot",
@@ -37,7 +61,7 @@
     "codeline",
     "autonomous",
     "persistent",
-    "reconstructible"
+    "deployment"
   ],
   "author": "AgentVault Contributors",
   "license": "MIT",
@@ -48,12 +72,11 @@
     "@eslint/js": "^9.18.0",
     "@types/inquirer": "^9.0.9",
     "@types/node": "^22.10.0",
-    "eslint": "^9.18.0",
+    "eslint": "^9.0.0",
     "tsx": "^4.19.0",
     "typescript": "^5.7.2",
     "typescript-eslint": "^8.20.0",
-    "vitest": "^2.1.0",
-    "zod": "^4.3.6"
+    "vitest": "^4.0.18"
   },
   "dependencies": {
     "@dfinity/agent": "^3.4.3",
@@ -61,6 +84,7 @@
     "@dfinity/principal": "^3.4.3",
     "@noble/curves": "^1.7.0",
     "@polkadot/api": "^16.5.4",
+    "@polkadot/keyring": "^14.0.1",
     "@polkadot/util": "^14.0.1",
     "@polkadot/util-crypto": "^14.0.1",
     "@solana/web3.js": "^1.98.4",
@@ -69,11 +93,19 @@
     "cbor-x": "^1.6.0",
     "chalk": "^5.4.1",
     "commander": "^12.1.0",
-    "esbuild": "^0.24.0",
+    "esbuild": "^0.28.1",
     "ethers": "^6.16.0",
     "execa": "^8.0.0",
     "inquirer": "^9.3.0",
     "ora": "^8.1.0",
-    "yaml": "^2.8.2"
+    "undici": "^7.25.0",
+    "yaml": "^2.8.2",
+    "zod": "^4.3.6"
+  },
+  "overrides": {
+    "brace-expansion": "^1.1.13",
+    "uuid": "^11.1.1",
+    "ws": "^8.20.1",
+    "postcss": "^8.5.10"
   }
 }

package/.dfx/local/network-id

@@ -1,4 +0,0 @@
-{
-  "created": "2025-02-01 19:25:23.320109 +00:00:00",
-  "settings_digest": "a2c7b27b81377d6b5f7e38775792e6f435f034f3afc27553f2f3eed938fb7e9b"
-}

package/.next/trace

@@ -1,2 +0,0 @@
-[{"name":"next-dev","duration":358444,"timestamp":25456549822,"id":1,"tags":{},"startTime":1771290476315,"traceId":"bd0fc21499a468eb"}]
-[{"name":"generate-buildid","duration":73,"timestamp":25762683733,"id":4,"parentId":1,"tags":{},"startTime":1771290782449,"traceId":"e1799c79029c02c3"},{"name":"load-custom-routes","duration":105,"timestamp":25762683837,"id":5,"parentId":1,"tags":{},"startTime":1771290782449,"traceId":"e1799c79029c02c3"},{"name":"next-build","duration":35672,"timestamp":25762648918,"id":1,"tags":{"buildMode":"default","isTurboBuild":"false","version":"15.1.4"},"startTime":1771290782414,"traceId":"e1799c79029c02c3"}]

package/.vercel/README.txt

@@ -1,11 +0,0 @@
-> Why do I have a folder named ".vercel" in my project?
-The ".vercel" folder is created when you link a directory to a Vercel project.
-
-> What does the "project.json" file contain?
-The "project.json" file contains:
-- The ID of the Vercel project that you linked ("projectId")
-- The ID of the user or team your Vercel project is owned by ("orgId")
-
-> Should I commit the ".vercel" folder?
-No, you should not share the ".vercel" folder with anyone.
-Upon creation, it will be automatically added to your ".gitignore" file.

package/.vercel/project.json

@@ -1 +0,0 @@
-{"projectId":"prj_EhiMuGMYk4R83zWMg37kvloXRNpm","orgId":"team_nZSD33w3Dm3KxfwYqgrL4THr","projectName":"agentvault"}

package/AGENTS.md

@@ -1,43 +0,0 @@
-# Repository Guidelines
-
-## Project Structure & Module Organization
-- `src/`: core TypeScript library (packaging, deployment, security, monitoring, wallet, ICP tooling).
-- `cli/`: CLI entry points and command handlers (`cli/commands/*.ts`).
-- `canister/`: Motoko canister code and Candid interfaces.
-- `tests/`: Vitest suite (unit, integration, CLI, deployment, packaging).
-- `examples/`: sample agent projects and configs.
-- `docs/`, `AI_DOCS/`: product and design docs.
-- `dist/`, `dist-cli/`: build outputs (generated, do not edit).
-- Root configs: `dfx.json`, `icp.yaml`, `tsconfig.json`, `eslint.config.js`.
-
-## Build, Test, and Development Commands
-- `npm run dev`: run the local dev entry with `tsx` watch.
-- `npm run build`: compile TypeScript to `dist/`.
-- `npm run start`: run the built app from `dist/`.
-- `npm run test`: run Vitest in CI mode.
-- `npm run test:watch`: run Vitest in watch mode.
-- `npm run typecheck`: TypeScript typecheck without emit.
-- `npm run lint` / `npm run lint:fix`: lint and auto-fix with ESLint.
-
-## Coding Style & Naming Conventions
-- TypeScript, ESM (`module`/`moduleResolution: NodeNext`), ES2022 target.
-- 2-space indentation; keep exports explicit.
-- Use `camelCase` for variables/functions, `PascalCase` for types/classes.
-- Unused args should be prefixed with `_` (ESLint allows this).
-- Keep CLI command files in `cli/commands/` named with kebab-case (e.g., `wallet-import.ts`).
-
-## Testing Guidelines
-- Framework: Vitest.
-- Test files live under `tests/` and end with `*.test.ts`.
-- Group by domain: `tests/cli/`, `tests/deployment/`, `tests/icp/`, `tests/unit/`.
-- Prefer small, isolated tests for helpers and broader integration tests for CLI flows.
-
-## Commit & Pull Request Guidelines
-- Commit messages in this repo are plain, sentence-case descriptions (no strict prefix).
-- Keep the first line concise; add details in the body if needed.
-- PRs should include: summary of changes, relevant test output, and linked issues.
-- Add screenshots only when UX or CLI output changes are user-facing.
-
-## Security & Configuration Tips
-- Do not commit secrets; keep keys and seed phrases out of git.
-- Use `dfx` for local canister work and keep `dfx.json` in sync with canister changes.