audrey 0.23.1 → 1.0.1

package/docs/paper/output/submission-bundle/docs/paper/references.bib

@@ -0,0 +1,222 @@
+% Primary URL: https://arxiv.org/abs/2504.19413
+@misc{chhikara2025mem0,
+  title = {Mem0: Building Production-Ready AI Agents with Scalable Long-Term Memory},
+  author = {Chhikara, Prateek and Khant, Dev and Aryan, Saket and Singh, Taranjeet and Yadav, Deshraj},
+  year = {2025},
+  eprint = {2504.19413},
+  archivePrefix = {arXiv},
+  primaryClass = {cs.CL},
+  url = {https://arxiv.org/abs/2504.19413}
+}
+
+% Primary URL: https://arxiv.org/abs/2310.08560
+@misc{packer2024memgpt,
+  title = {MemGPT: Towards LLMs as Operating Systems},
+  author = {Packer, Charles and Wooders, Sarah and Lin, Kevin and Fang, Vivian and Patil, Shishir G. and Stoica, Ion and Gonzalez, Joseph E.},
+  year = {2024},
+  eprint = {2310.08560},
+  archivePrefix = {arXiv},
+  primaryClass = {cs.AI},
+  url = {https://arxiv.org/abs/2310.08560}
+}
+
+% Primary URL: https://arxiv.org/abs/2410.10813
+@misc{wu2025longmemeval,
+  title = {LongMemEval: Benchmarking Chat Assistants on Long-Term Interactive Memory},
+  author = {Wu, Di and Wang, Hongwei and Yu, Wenhao and Zhang, Yuwei and Chang, Kai-Wei and Yu, Dong},
+  year = {2025},
+  eprint = {2410.10813},
+  archivePrefix = {arXiv},
+  primaryClass = {cs.CL},
+  url = {https://arxiv.org/abs/2410.10813}
+}
+
+% Primary URL: https://arxiv.org/abs/2402.17753
+@misc{maharana2024locomo,
+  title = {Evaluating Very Long-Term Conversational Memory of LLM Agents},
+  author = {Maharana, Adyasha and Lee, Dong-Ho and Tulyakov, Sergey and Bansal, Mohit and Barbieri, Francesco and Fang, Yuwei},
+  year = {2024},
+  eprint = {2402.17753},
+  archivePrefix = {arXiv},
+  primaryClass = {cs.CL},
+  url = {https://arxiv.org/abs/2402.17753}
+}
+
+% Primary URL: https://arxiv.org/abs/2210.07316
+@misc{muennighoff2023mteb,
+  title = {MTEB: Massive Text Embedding Benchmark},
+  author = {Muennighoff, Niklas and Tazi, Nouamane and Magne, Loic and Reimers, Nils},
+  year = {2023},
+  eprint = {2210.07316},
+  archivePrefix = {arXiv},
+  primaryClass = {cs.CL},
+  url = {https://arxiv.org/abs/2210.07316}
+}
+
+% Primary URL: https://arxiv.org/abs/2510.17281
+@misc{ai2026memorybench,
+  title = {MemoryBench: A Benchmark for Memory and Continual Learning in LLM Systems},
+  author = {Ai, Qingyao and Tang, Yichen and Wang, Changyue and Long, Jianming and Su, Weihang and Liu, Yiqun},
+  year = {2026},
+  eprint = {2510.17281},
+  archivePrefix = {arXiv},
+  primaryClass = {cs.LG},
+  url = {https://arxiv.org/abs/2510.17281}
+}
+
+% Primary URL: https://arxiv.org/abs/2501.13956
+@misc{rasmussen2025zep,
+  title = {Zep: A Temporal Knowledge Graph Architecture for Agent Memory},
+  author = {Rasmussen, Preston and Paliychuk, Pavlo and Beauvais, Travis and Ryan, Jack and Chalef, Daniel},
+  year = {2025},
+  eprint = {2501.13956},
+  archivePrefix = {arXiv},
+  primaryClass = {cs.CL},
+  url = {https://arxiv.org/abs/2501.13956}
+}
+
+% Primary URL: https://github.com/getzep/graphiti
+@misc{zep2026graphiti,
+  title = {Graphiti: Build Real-Time Knowledge Graphs for AI Agents},
+  author = {{Zep}},
+  year = {2026},
+  howpublished = {GitHub repository},
+  url = {https://github.com/getzep/graphiti},
+  note = {Accessed 2026-05-08}
+}
+
+% Primary URL: https://arxiv.org/abs/2507.03724
+@misc{li2025memos,
+  title = {MemOS: A Memory OS for AI System},
+  author = {Li, Zhiyu and Xi, Chenyang and Li, Chunyu and Chen, Ding and Chen, Boyu and Song, Shichao and Niu, Simin and Wang, Hanyu and Yang, Jiawei and Tang, Chen and Yu, Qingchen and Zhao, Jihao and Wang, Yezhaohui and Liu, Peng and Lin, Zehao and Wang, Pengyuan and Huo, Jiahao and Chen, Tianyi and Chen, Kai and Li, Kehang and Tao, Zhen and Lai, Huayi and Wu, Hao and Tang, Bo and Wang, Zhengren and Fan, Zhaoxin and Zhang, Ningyu and Zhang, Linfeng and Yan, Junchi and Yang, Mingchuan and Xu, Tong and Xu, Wei and Chen, Huajun and Wang, Haofen and Yang, Hongkang and Zhang, Wentao and Xu, Zhi-Qin John and Chen, Siheng and Xiong, Feiyu},
+  year = {2025},
+  eprint = {2507.03724},
+  archivePrefix = {arXiv},
+  primaryClass = {cs.CL},
+  url = {https://arxiv.org/abs/2507.03724}
+}
+
+% Primary URL: https://langchain-ai.github.io/langmem/
+@misc{langchain2026langmem,
+  title = {LangMem Documentation},
+  author = {{LangChain}},
+  year = {2026},
+  howpublished = {Official documentation},
+  url = {https://langchain-ai.github.io/langmem/},
+  note = {Accessed 2026-05-08}
+}
+
+% Primary URL: https://github.com/langchain-ai/langmem
+@misc{langchain2026langmemrepo,
+  title = {LangMem},
+  author = {{LangChain}},
+  year = {2026},
+  howpublished = {GitHub repository},
+  url = {https://github.com/langchain-ai/langmem},
+  note = {Accessed 2026-05-08}
+}
+
+% Primary URL: https://supermemory.ai/docs
+@misc{supermemory2026docs,
+  title = {supermemory Documentation: Memory API for the AI Era},
+  author = {{Supermemory}},
+  year = {2026},
+  howpublished = {Official documentation},
+  url = {https://supermemory.ai/docs},
+  note = {Accessed 2026-05-08}
+}
+
+% Primary URL: https://github.com/supermemoryai/supermemory
+@misc{supermemory2026repo,
+  title = {Supermemory: Memory Engine and App},
+  author = {{Supermemory}},
+  year = {2026},
+  howpublished = {GitHub repository},
+  url = {https://github.com/supermemoryai/supermemory},
+  note = {Accessed 2026-05-08}
+}
+
+% Primary URL: https://arxiv.org/abs/2505.24478
+@misc{markovic2025cognee,
+  title = {Optimizing the Interface Between Knowledge Graphs and LLMs for Complex Reasoning},
+  author = {Markovic, Vasilije and Obradovic, Lazar and Hajdu, Laszlo and Pavlovic, Jovan},
+  year = {2025},
+  eprint = {2505.24478},
+  archivePrefix = {arXiv},
+  primaryClass = {cs.AI},
+  url = {https://arxiv.org/abs/2505.24478}
+}
+
+% Primary URL: https://github.com/topoteretes/cognee
+@misc{cognee2026repo,
+  title = {Cognee: Knowledge Engine for AI Agent Memory},
+  author = {{Cognee}},
+  year = {2026},
+  howpublished = {GitHub repository},
+  url = {https://github.com/topoteretes/cognee},
+  note = {Accessed 2026-05-08}
+}
+
+% Primary URL: https://modelcontextprotocol.io/specification/2025-11-25/schema
+@misc{mcp2025schema,
+  title = {Model Context Protocol Schema Reference, Protocol Revision 2025-11-25},
+  author = {{Model Context Protocol}},
+  year = {2025},
+  howpublished = {Official specification},
+  url = {https://modelcontextprotocol.io/specification/2025-11-25/schema},
+  note = {Accessed 2026-05-08}
+}
+
+% Primary URL: https://arxiv.org/abs/2510.15994
+@misc{zhang2026mcpsecuritybench,
+  title = {MCP Security Bench (MSB): Benchmarking Attacks Against Model Context Protocol in LLM Agents},
+  author = {Zhang, Dongsen and Li, Zekun and Luo, Xu and Liu, Xuannan and Li, Peipei and Xu, Wenjun},
+  year = {2026},
+  eprint = {2510.15994},
+  archivePrefix = {arXiv},
+  primaryClass = {cs.CR},
+  url = {https://arxiv.org/abs/2510.15994}
+}
+
+% Primary URL: https://arxiv.org/abs/2512.06556
+@misc{jamshidi2025toolpoisoning,
+  title = {Securing the Model Context Protocol: Defending LLMs Against Tool Poisoning and Adversarial Attacks},
+  author = {Jamshidi, Saeid and Nafi, Kawser Wazed and Dakhel, Arghavan Moradi and Shahabi, Negar and Khomh, Foutse and Ezzati-Jivan, Naser},
+  year = {2025},
+  eprint = {2512.06556},
+  archivePrefix = {arXiv},
+  primaryClass = {cs.CR},
+  url = {https://arxiv.org/abs/2512.06556}
+}
+
+% Primary URL: https://blog.modelcontextprotocol.io/posts/2026-03-16-tool-annotations/
+@misc{mcp2026toolannotations,
+  title = {Tool Annotations as Risk Vocabulary: What Hints Can and Can't Do},
+  author = {Hungerford, Ola and Morrow, Sam and Chang, Luca},
+  year = {2026},
+  month = {March},
+  howpublished = {Model Context Protocol Blog},
+  url = {https://blog.modelcontextprotocol.io/posts/2026-03-16-tool-annotations/},
+  note = {Accessed 2026-05-08}
+}
+
+% Primary URL: https://code.claude.com/docs/en/hooks
+@misc{anthropic2026claudecodehooks,
+  title = {Claude Code Hooks Reference},
+  author = {{Anthropic}},
+  year = {2026},
+  howpublished = {Official documentation},
+  url = {https://code.claude.com/docs/en/hooks},
+  note = {Accessed 2026-05-08}
+}
+
+% Primary URL: https://mem0.ai/blog/mem0-the-token-efficient-memory-algorithm
+@misc{mem02026tokenefficient,
+  title = {Introducing The Token-Efficient Memory Algorithm},
+  author = {Yadav, Deshraj},
+  year = {2026},
+  month = {April},
+  howpublished = {Mem0 Blog},
+  url = {https://mem0.ai/blog/mem0-the-token-efficient-memory-algorithm},
+  note = {Accessed 2026-05-08}
+}

package/docs/paper/output/submission-bundle/package.json

@@ -0,0 +1,212 @@
+{
+  "name": "audrey",
+  "version": "1.0.1",
+  "description": "Local-first memory runtime for AI agents with recall, consolidation, memory reflexes, contradiction detection, and tool-trace learning",
+  "type": "module",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
+    },
+    "./mcp": {
+      "types": "./dist/mcp-server/index.d.ts",
+      "default": "./dist/mcp-server/index.js"
+    },
+    "./server": {
+      "types": "./dist/src/server.d.ts",
+      "default": "./dist/src/server.js"
+    }
+  },
+  "bin": {
+    "audrey": "dist/mcp-server/index.js",
+    "audrey-mcp": "dist/mcp-server/index.js"
+  },
+  "files": [
+    "dist/",
+    "benchmarks/*.js",
+    "benchmarks/*.mjs",
+    "benchmarks/adapters/*.mjs",
+    "benchmarks/adapters/*.json",
+    "benchmarks/schemas/*.json",
+    "benchmarks/output/summary.json",
+    "benchmarks/output/guardbench-summary.json",
+    "benchmarks/output/guardbench-manifest.json",
+    "benchmarks/output/guardbench-raw.json",
+    "benchmarks/output/guardbench-conformance-card.json",
+    "benchmarks/output/adapter-self-test/",
+    "benchmarks/output/external/guardbench-external-dry-run.json",
+    "benchmarks/output/external/guardbench-external-evidence.json",
+    "benchmarks/output/submission-bundle/",
+    "benchmarks/output/leaderboard/",
+    "benchmarks/snapshots/*.json",
+    "benchmarks/snapshots/",
+    "scripts/*.mjs",
+    "scripts/*.py",
+    "scripts/smoke-cli.js",
+    "docs/AUDREY_PAPER_OUTLINE.md",
+    "docs/MEMORY_BENCHMARKING.md",
+    "docs/PRODUCTION_BACKLOG.md",
+    "docs/paper/*.md",
+    "docs/paper/*.bib",
+    "docs/paper/*.json",
+    "docs/paper/output/arxiv/",
+    "docs/paper/output/arxiv-compile-report.json",
+    "docs/paper/output/arxiv-compile/main.pdf",
+    "docs/paper/output/arxiv-compile/arxiv-compile.log",
+    "docs/paper/output/submission-bundle/",
+    "docs/assets/audrey-feature-grid.jpg",
+    "docs/assets/audrey-logo.svg",
+    "docs/assets/audrey-wordmark.png",
+    "examples/",
+    "CHANGELOG.md",
+    "README.md",
+    "SECURITY.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prebuild": "node --input-type=module -e \"import fs from 'node:fs'; fs.rmSync('dist',{recursive:true,force:true})\"",
+    "pretest": "npm run build && npm run test:artifacts",
+    "test": "node scripts/run-vitest.mjs",
+    "test:watch": "node scripts/run-vitest.mjs watch",
+    "test:artifacts": "npm run bench:perf && npm run bench:memory:check && npm run bench:guard:check && npm run bench:guard:card && npm run bench:guard:bundle && npm run bench:guard:bundle:verify && npm run bench:guard:leaderboard && npm run bench:guard:adapter-self-test && npm run bench:guard:adapter-self-test:validate && npm run bench:guard:external:dry-run && npm run bench:guard:external:evidence && npm run paper:sync && npm run paper:arxiv && npm run paper:arxiv:verify && npm run paper:arxiv:compile && npm run paper:bundle && npm run paper:bundle:verify && npm run paper:verify",
+    "release:gate": "npm run typecheck && npm test && npm run bench:memory:check && npm run bench:guard:check && npm run bench:guard:card && npm run bench:guard:bundle && npm run bench:guard:bundle:verify && npm run bench:guard:leaderboard && npm run bench:guard:adapter-registry:validate && npm run bench:guard:external:dry-run && npm run bench:guard:external:evidence && npm run bench:guard:adapter-module:validate && npm run bench:guard:adapter-self-test && npm run bench:guard:adapter-self-test:validate && npm run bench:guard:validate && npm run bench:guard:publication:verify && npm run python:release:check && npm run smoke:cli && npm run security:audit && npm run pack:check",
+    "release:gate:sandbox": "npm run build && npm run typecheck && npm run bench:perf && npm run bench:memory:check && npm run bench:guard:check && npm run bench:guard:card && npm run bench:guard:bundle && npm run bench:guard:bundle:verify && npm run bench:guard:leaderboard && npm run bench:guard:adapter-registry:validate && npm run bench:guard:external:dry-run && npm run bench:guard:external:evidence && npm run bench:guard:adapter-module:validate && npm run bench:guard:adapter-self-test && npm run bench:guard:adapter-self-test:validate && npm run bench:guard:validate && npm run bench:guard:publication:verify && npm run python:release:check && npm run smoke:cli && npm run security:audit && npm run pack:check",
+    "release:gate:paper": "npm run build && npm run typecheck && npm run bench:perf && npm run bench:memory:check && npm run bench:guard:check && npm run bench:guard:card && npm run bench:guard:bundle && npm run bench:guard:bundle:verify && npm run bench:guard:leaderboard && npm run bench:guard:adapter-registry:validate && npm run bench:guard:external:dry-run && npm run bench:guard:external:evidence && npm run bench:guard:adapter-module:validate && npm run bench:guard:adapter-self-test && npm run bench:guard:adapter-self-test:validate && npm run bench:guard:validate && npm run bench:guard:publication:verify && npm run python:release:check && npm run paper:sync && npm run paper:arxiv && npm run paper:arxiv:verify && npm run paper:arxiv:compile && npm run paper:launch-plan && npm run paper:launch-results && npm run paper:bundle && npm run paper:bundle:verify && npm run paper:verify && npm run release:readiness && npm run smoke:cli && npm run security:audit && npm run pack:check",
+    "release:cut:plan": "node scripts/prepare-release-cut.mjs --json",
+    "release:cut:apply": "node scripts/prepare-release-cut.mjs --apply",
+    "release:readiness": "node scripts/verify-release-readiness.mjs --allow-pending",
+    "release:readiness:strict": "node scripts/verify-release-readiness.mjs",
+    "release:finalize": "node scripts/finalize-release.mjs",
+    "release:finalize:plan": "node scripts/finalize-release.mjs --json",
+    "release:artifacts": "node scripts/finalize-release.mjs --apply --pack --source-bundle --json",
+    "release:completion-audit": "node scripts/audit-release-completion.mjs",
+    "release:publish-source": "node scripts/publish-release-bundle.mjs",
+    "release:publish-source:api": "node scripts/publish-release-github-api.mjs",
+    "python:build": "python -m build --no-isolation python",
+    "python:verify": "python scripts/verify-python-package.py",
+    "python:release:check": "npm run python:build && npm run python:verify",
+    "prepack": "npm run build",
+    "pack:check": "npm pack --dry-run",
+    "smoke:cli": "node scripts/smoke-cli.js",
+    "security:audit": "npm audit --omit=dev --audit-level=moderate",
+    "bench:memory": "node benchmarks/run.js",
+    "bench:perf": "node benchmarks/perf.bench.js",
+    "bench:perf-snapshot": "node benchmarks/perf-snapshot.js",
+    "bench:memory:retrieval": "node benchmarks/run.js --suite retrieval",
+    "bench:memory:operations": "node benchmarks/run.js --suite operations",
+    "bench:memory:guard": "node benchmarks/run.js --suite guard",
+    "bench:memory:json": "node benchmarks/run.js --json",
+    "bench:memory:check": "node benchmarks/run.js --check",
+    "bench:guard": "node benchmarks/guardbench.js",
+    "bench:guard:check": "node benchmarks/guardbench.js --check",
+    "bench:guard:manifest": "node benchmarks/guardbench.js --manifest",
+    "bench:guard:validate": "node benchmarks/validate-guardbench-artifacts.mjs",
+    "bench:guard:card": "node benchmarks/create-conformance-card.mjs",
+    "bench:guard:bundle": "node benchmarks/create-submission-bundle.mjs",
+    "bench:guard:bundle:verify": "node benchmarks/verify-submission-bundle.mjs",
+    "bench:guard:leaderboard": "node benchmarks/build-leaderboard.mjs",
+    "bench:guard:adapter-registry:validate": "node benchmarks/validate-adapter-registry.mjs",
+    "bench:guard:adapter-module:validate": "node benchmarks/validate-adapter-module.mjs",
+    "bench:guard:adapter-self-test": "node benchmarks/adapter-self-test.mjs",
+    "bench:guard:adapter-self-test:validate": "node benchmarks/validate-adapter-self-test.mjs",
+    "bench:guard:publication:verify": "node benchmarks/verify-publication-artifacts.mjs",
+    "bench:guard:external:evidence": "node benchmarks/verify-external-evidence.mjs --allow-pending",
+    "bench:guard:external:evidence:strict": "node benchmarks/verify-external-evidence.mjs",
+    "bench:guard:adapter-smoke": "node benchmarks/guardbench.js --adapter benchmarks/adapters/example-allow.mjs --check --out-dir benchmarks/output/adapter-smoke",
+    "bench:guard:adapter-conformance": "node benchmarks/run-external-guardbench.mjs --adapter benchmarks/adapters/example-allow.mjs --check --out-dir benchmarks/output/adapter-conformance",
+    "bench:guard:external": "node benchmarks/run-external-guardbench.mjs",
+    "bench:guard:external:dry-run": "node benchmarks/dry-run-external-adapters.mjs",
+    "bench:guard:mem0": "node benchmarks/run-external-guardbench.mjs --adapter mem0-platform --check",
+    "bench:guard:zep": "node benchmarks/run-external-guardbench.mjs --adapter zep-cloud --check",
+    "paper:claims": "node scripts/verify-paper-claims.mjs",
+    "paper:publication-pack": "node scripts/verify-publication-pack.mjs",
+    "paper:arxiv": "node scripts/create-arxiv-source.mjs",
+    "paper:arxiv:verify": "node scripts/verify-arxiv-source.mjs",
+    "paper:arxiv:compile": "node scripts/verify-arxiv-compile.mjs --allow-missing",
+    "paper:arxiv:compile:strict": "node scripts/verify-arxiv-compile.mjs",
+    "paper:launch-plan": "node scripts/verify-browser-launch-plan.mjs",
+    "paper:launch-results": "node scripts/verify-browser-launch-results.mjs",
+    "paper:launch-results:strict": "node scripts/verify-browser-launch-results.mjs --strict",
+    "paper:bundle": "node scripts/create-paper-submission-bundle.mjs",
+    "paper:bundle:verify": "node scripts/verify-paper-submission-bundle.mjs",
+    "paper:sync": "node scripts/sync-paper-artifacts.mjs",
+    "paper:verify": "node scripts/verify-paper-artifacts.mjs",
+    "typecheck": "tsc --noEmit",
+    "serve": "node dist/mcp-server/index.js serve",
+    "docker:build": "docker build -t audrey:local .",
+    "docker:up": "docker compose up -d --build",
+    "docker:down": "docker compose down",
+    "docker:logs": "docker compose logs -f audrey"
+  },
+  "keywords": [
+    "ai",
+    "memory",
+    "agents",
+    "llm",
+    "cognitive",
+    "sqlite",
+    "embedding",
+    "mcp",
+    "biological-memory",
+    "episodic-memory",
+    "semantic-memory",
+    "forgetting-curve",
+    "vector-search",
+    "knowledge-graph",
+    "causal-graph",
+    "ai-agent",
+    "model-context-protocol",
+    "recall",
+    "consolidation",
+    "confidence",
+    "long-term-memory",
+    "persistent-memory",
+    "memory-preflight",
+    "memory-reflexes",
+    "agent-reflexes",
+    "agent-safety",
+    "tool-trace-memory",
+    "local-first-memory",
+    "rag",
+    "claude",
+    "agent-framework",
+    "rest-api",
+    "http-server"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Evilander/Audrey.git"
+  },
+  "homepage": "https://github.com/Evilander/Audrey",
+  "bugs": {
+    "url": "https://github.com/Evilander/Audrey/issues"
+  },
+  "author": "evilander",
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@hono/node-server": "^1.19.14",
+    "@huggingface/transformers": "^3.8.1",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "better-sqlite3": "^12.9.0",
+    "hono": "^4.12.18",
+    "sqlite-vec": "^0.1.9",
+    "ulid": "^3.0.2",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^25.6.2",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.5"
+  },
+  "directories": {
+    "example": "examples",
+    "test": "tests"
+  }
+}