{"_id":"@aiq-cortex/client-knowledge","_rev":"7-2bdd0643edbffded7abd9743b738efbb","name":"@aiq-cortex/client-knowledge","dist-tags":{"latest":"0.7.0"},"versions":{"0.2.0":{"name":"@aiq-cortex/client-knowledge","version":"0.2.0","license":"UNLICENSED","_id":"@aiq-cortex/client-knowledge@0.2.0","maintainers":[{"name":"shamilton_aq","email":"shamilton@agencyq.com"}],"homepage":"https://github.com/agencyQ/aiq-client-knowledge#readme","bugs":{"url":"https://github.com/agencyQ/aiq-client-knowledge/issues"},"dist":{"shasum":"16294322655701f415458e94382596bf9996e037","tarball":"https://registry.npmjs.org/@aiq-cortex/client-knowledge/-/client-knowledge-0.2.0.tgz","fileCount":18,"integrity":"sha512-d3wrU2y8hkG4CuzRdUZbwO4uoC+7IZHlyzZgvaXMhZziYboBB2OGOxzkq6/CxuVfcKM5eyTd8ZwKAw2iV3JjhA==","signatures":[{"sig":"MEYCIQCReU1ZV5e+gZOxnVYdRIYtwRKeqcmMppRN6VDIteQq0wIhAJ4W/a1eAIQZGjEtBFZAVqz4PHCR/vivRWAAb0sPSX/d","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":22774},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","gitHead":"5b0a79f7e6a85f861d3615f9a82742a79dd27cef","scripts":{"dev":"tsx src/index.ts","seed":"tsx scripts/seed-ngs.ts","test":"vitest run","build":"tsc","start":"node dist/index.js","migrate":"tsx scripts/apply-migrations.ts","test:watch":"vitest","test:integration":"vitest run --project integration --no-file-parallelism"},"_npmUser":{"name":"shamilton_aq","email":"shamilton@agencyq.com"},"repository":{"url":"git+https://github.com/agencyQ/aiq-client-knowledge.git","type":"git"},"_npmVersion":"10.9.4","description":"MCP server for structured, semantic access to client knowledge","directories":{},"_nodeVersion":"22.22.1","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.11.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","openai":"^4.85.0","vitest":"^3.0.0","typescript":"^5.7.0","@types/node":"^22.0.0","gray-matter":"^4.0.3","@supabase/supabase-js":"^2.49.0"},"_npmOperationalInternal":{"tmp":"tmp/client-knowledge_0.2.0_1774458537487_0.472863624835022","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@aiq-cortex/client-knowledge","version":"0.3.0","license":"UNLICENSED","_id":"@aiq-cortex/client-knowledge@0.3.0","maintainers":[{"name":"shamilton_aq","email":"shamilton@agencyq.com"}],"homepage":"https://github.com/agencyQ/aiq-client-knowledge#readme","bugs":{"url":"https://github.com/agencyQ/aiq-client-knowledge/issues"},"dist":{"shasum":"127c89898c64d9c2242da16326ebc431ef240f77","tarball":"https://registry.npmjs.org/@aiq-cortex/client-knowledge/-/client-knowledge-0.3.0.tgz","fileCount":22,"integrity":"sha512-r8f4P4s4/BYNBSH5P0K6zu6YWyekNsWeC3sCKNjEX0Cm0f1bjHOsqBEHcgqtIxFd7L2KvL+PsMTPgehyCRNC1Q==","signatures":[{"sig":"MEQCID3nigScj/sI2hFjgHcQU32JDwAyjjGgcu3y829PsR4IAiBNTBXSG3i0j19NKURjdeT6Nj74YEnrs2iqh3KH7ppfgQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":40279},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","gitHead":"d33066847400860334ad0c2d65d69d8fec3dbb97","scripts":{"dev":"tsx src/index.ts","seed":"tsx scripts/seed-ngs.ts","test":"vitest run","build":"tsc","start":"node dist/index.js","migrate":"tsx scripts/apply-migrations.ts","test:watch":"vitest","test:integration":"vitest run --project integration --no-file-parallelism"},"_npmUser":{"name":"shamilton_aq","email":"shamilton@agencyq.com"},"repository":{"url":"git+https://github.com/agencyQ/aiq-client-knowledge.git","type":"git"},"_npmVersion":"10.9.4","description":"MCP server for structured, semantic access to client knowledge","directories":{},"_nodeVersion":"22.22.1","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.11.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","openai":"^4.85.0","vitest":"^3.0.0","typescript":"^5.7.0","@types/node":"^22.0.0","gray-matter":"^4.0.3","@supabase/supabase-js":"^2.49.0"},"_npmOperationalInternal":{"tmp":"tmp/client-knowledge_0.3.0_1774459837914_0.5180557095026253","host":"s3://npm-registry-packages-npm-production"}},"0.3.2":{"name":"@aiq-cortex/client-knowledge","version":"0.3.2","license":"UNLICENSED","_id":"@aiq-cortex/client-knowledge@0.3.2","maintainers":[{"name":"shamilton_aq","email":"shamilton@agencyq.com"}],"homepage":"https://github.com/agencyQ/aiq-client-knowledge#readme","bugs":{"url":"https://github.com/agencyQ/aiq-client-knowledge/issues"},"bin":{"aiq-client-knowledge":"dist/index.js"},"dist":{"shasum":"af3622165b2b898bae5a65d97405599787e8b022","tarball":"https://registry.npmjs.org/@aiq-cortex/client-knowledge/-/client-knowledge-0.3.2.tgz","fileCount":22,"integrity":"sha512-FA3/TFQwqSJ5bb+mK8AkXtmsTM6SIh6h9l4+YEqgXernqM80ymml8h9AIzmoZSbZZkMWcLwh2i0irka0bOlFAw==","signatures":[{"sig":"MEYCIQDnEXfQ868i1MylYZOgLfxmThKbef2cupqpycUQYe+yfAIhAJ19rhix83/GhHE2cUSgfZfpRpNHJiJV+nuhEqM7ThHg","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":40380},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","gitHead":"649c8b8fa590790cf62f29893f2b5216b0853074","scripts":{"dev":"tsx src/index.ts","seed":"tsx scripts/seed-ngs.ts","test":"vitest run","build":"tsc","start":"node dist/index.js","migrate":"tsx scripts/apply-migrations.ts","test:watch":"vitest","test:integration":"vitest run --project integration --no-file-parallelism"},"_npmUser":{"name":"shamilton_aq","email":"shamilton@agencyq.com"},"repository":{"url":"git+https://github.com/agencyQ/aiq-client-knowledge.git","type":"git"},"_npmVersion":"10.9.4","description":"MCP server for structured, semantic access to client knowledge","directories":{},"_nodeVersion":"22.22.1","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.11.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","openai":"^4.85.0","vitest":"^3.0.0","typescript":"^5.7.0","@types/node":"^22.0.0","gray-matter":"^4.0.3","@supabase/supabase-js":"^2.49.0"},"_npmOperationalInternal":{"tmp":"tmp/client-knowledge_0.3.2_1774466393270_0.07344605524610981","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@aiq-cortex/client-knowledge","version":"0.4.0","license":"UNLICENSED","_id":"@aiq-cortex/client-knowledge@0.4.0","maintainers":[{"name":"shamilton_aq","email":"shamilton@agencyq.com"}],"homepage":"https://github.com/agencyQ/aiq-client-knowledge#readme","bugs":{"url":"https://github.com/agencyQ/aiq-client-knowledge/issues"},"bin":{"aiq-client-knowledge":"dist/index.js"},"dist":{"shasum":"8325cf78c102a32fffe2bea68b994132c8b6775a","tarball":"https://registry.npmjs.org/@aiq-cortex/client-knowledge/-/client-knowledge-0.4.0.tgz","fileCount":22,"integrity":"sha512-hElVeWBqWuQGeftX1UAxv9jc8rqMnoz36l+mJCCWP17Vyh9X5NTs+x1SXmNMKC8ieJjHptBjpne8EBJqyFKnjA==","signatures":[{"sig":"MEUCIQCqgARXftwQCu/nUrfM50ba2p6NEyokM4OuX0pjvRoMfAIgbe0VoB28XXWbbR7+PpzmRxqbxQy1y9ymDCOn+NiiSFs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":39842},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","gitHead":"b33f72d22265e805b17cce9f4d0a47e059b474b6","scripts":{"dev":"tsx src/index.ts","seed":"tsx scripts/seed-ngs.ts","test":"vitest run","build":"tsc","start":"node dist/index.js","migrate":"tsx scripts/apply-migrations.ts","test:watch":"vitest","test:integration":"vitest run --project integration --no-file-parallelism"},"_npmUser":{"name":"shamilton_aq","email":"shamilton@agencyq.com"},"repository":{"url":"git+https://github.com/agencyQ/aiq-client-knowledge.git","type":"git"},"_npmVersion":"10.9.4","description":"MCP server for structured, semantic access to client knowledge","directories":{},"_nodeVersion":"22.22.1","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.11.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","openai":"^4.85.0","vitest":"^3.0.0","typescript":"^5.7.0","@types/node":"^22.0.0","gray-matter":"^4.0.3","@supabase/supabase-js":"^2.49.0"},"_npmOperationalInternal":{"tmp":"tmp/client-knowledge_0.4.0_1774471227265_0.3623594213995365","host":"s3://npm-registry-packages-npm-production"}},"0.5.0":{"name":"@aiq-cortex/client-knowledge","version":"0.5.0","license":"UNLICENSED","_id":"@aiq-cortex/client-knowledge@0.5.0","maintainers":[{"name":"shamilton_aq","email":"shamilton@agencyq.com"}],"homepage":"https://github.com/agencyQ/aiq-client-knowledge#readme","bugs":{"url":"https://github.com/agencyQ/aiq-client-knowledge/issues"},"bin":{"aiq-client-knowledge":"dist/index.js"},"dist":{"shasum":"0022fbdb1dd94f8b4a4842674fea53369d1b0463","tarball":"https://registry.npmjs.org/@aiq-cortex/client-knowledge/-/client-knowledge-0.5.0.tgz","fileCount":22,"integrity":"sha512-q56V8oqU5vCda6VFlhOeAkVN1pcCGvRGgfLmbWPXwTGRGmWiCUy6xbfFNQgsZSQM3p/RxsyGuN3iKjaQL1OJSA==","signatures":[{"sig":"MEQCICNLSlRtUBLanE3Z5vx9AaeaUnU/j3HnqIgKR+F1kGH9AiAUwvKRPkGgKVRq3sJYp8ZA1s9HzGbTVewP0sk2j0PEUg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":42948},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","gitHead":"40f191b4b064654b4513b74a68ca29f621fee18c","scripts":{"dev":"tsx src/index.ts","seed":"tsx scripts/seed-ngs.ts","test":"vitest run","build":"tsc","start":"node dist/index.js","migrate":"tsx scripts/apply-migrations.ts","test:watch":"vitest","test:integration":"vitest run --project integration --no-file-parallelism"},"_npmUser":{"name":"shamilton_aq","email":"shamilton@agencyq.com"},"repository":{"url":"git+https://github.com/agencyQ/aiq-client-knowledge.git","type":"git"},"_npmVersion":"10.9.4","description":"MCP server for structured, semantic access to client knowledge","directories":{},"_nodeVersion":"22.22.1","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.11.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","openai":"^4.85.0","vitest":"^3.0.0","jsforce":"^3.10.14","typescript":"^5.7.0","@types/node":"^22.0.0","gray-matter":"^4.0.3","@supabase/supabase-js":"^2.49.0"},"_npmOperationalInternal":{"tmp":"tmp/client-knowledge_0.5.0_1774730455744_0.11623684809567725","host":"s3://npm-registry-packages-npm-production"}},"0.6.0":{"name":"@aiq-cortex/client-knowledge","version":"0.6.0","license":"UNLICENSED","_id":"@aiq-cortex/client-knowledge@0.6.0","maintainers":[{"name":"shamilton_aq","email":"shamilton@agencyq.com"}],"homepage":"https://github.com/agencyQ/aiq-client-knowledge#readme","bugs":{"url":"https://github.com/agencyQ/aiq-client-knowledge/issues"},"bin":{"aiq-client-knowledge":"dist/index.js"},"dist":{"shasum":"88febb1931fef024342283cda55977da91ec6334","tarball":"https://registry.npmjs.org/@aiq-cortex/client-knowledge/-/client-knowledge-0.6.0.tgz","fileCount":22,"integrity":"sha512-U6oyQTSZoSG+UWTONezxMUWFmOQ6odmeYAe8n7pD+nqV5W+vu0bYpouHMPYUI+psgsTEg86TVWwdvyI74HB/7A==","signatures":[{"sig":"MEUCIAVrTYvkWw8cpkdN35IjhKBG+zoRp43K38BoBlwsrEgdAiEA7uokyD5uSrkb8cwFbQOzTXc7+Y6PoU3LdIUUc7maJIk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":42948},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","gitHead":"baffbde8aaf53c03226be78590779db93f2e53a1","scripts":{"dev":"tsx src/index.ts","seed":"tsx scripts/seed-ngs.ts","test":"vitest run","build":"tsc","start":"node dist/index.js","migrate":"tsx scripts/apply-migrations.ts","test:watch":"vitest","test:integration":"vitest run --project integration --no-file-parallelism"},"_npmUser":{"name":"shamilton_aq","email":"shamilton@agencyq.com"},"repository":{"url":"git+https://github.com/agencyQ/aiq-client-knowledge.git","type":"git"},"_npmVersion":"10.9.4","description":"MCP server for structured, semantic access to client knowledge","directories":{},"_nodeVersion":"22.22.1","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.11.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","openai":"^4.85.0","vitest":"^3.0.0","jsforce":"^3.10.14","typescript":"^5.7.0","@types/node":"^22.0.0","gray-matter":"^4.0.3","@supabase/supabase-js":"^2.49.0"},"_npmOperationalInternal":{"tmp":"tmp/client-knowledge_0.6.0_1774793274121_0.3988400678343391","host":"s3://npm-registry-packages-npm-production"}},"0.7.0":{"name":"@aiq-cortex/client-knowledge","version":"0.7.0","type":"module","description":"MCP server for structured, semantic access to client knowledge","main":"dist/index.js","types":"dist/index.d.ts","bin":{"aiq-client-knowledge":"dist/index.js"},"publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/agencyQ/aiq-client-knowledge.git"},"license":"UNLICENSED","scripts":{"build":"tsc","start":"node dist/index.js","dev":"tsx src/index.ts","test":"vitest run","test:watch":"vitest","test:integration":"vitest run --project integration --no-file-parallelism","seed":"tsx scripts/seed-ngs.ts","migrate":"tsx scripts/apply-migrations.ts"},"dependencies":{"@modelcontextprotocol/sdk":"^1.11.0","zod":"^3.24.0"},"devDependencies":{"@supabase/supabase-js":"^2.49.0","@types/node":"^22.0.0","gray-matter":"^4.0.3","jsforce":"^3.10.14","openai":"^4.85.0","tsx":"^4.19.0","typescript":"^5.7.0","vitest":"^3.0.0"},"_id":"@aiq-cortex/client-knowledge@0.7.0","gitHead":"ad05f369711c514bb0bbcc8f721d7e84ed838502","bugs":{"url":"https://github.com/agencyQ/aiq-client-knowledge/issues"},"homepage":"https://github.com/agencyQ/aiq-client-knowledge#readme","_nodeVersion":"22.22.2","_npmVersion":"10.9.7","dist":{"integrity":"sha512-ieVg+UiomnnhzaCs4OYsXwRF/kP+qWv6eMbsfecfrpTcSf11Ukz6oUk/hIu2ixG0gCeX7lAiPcSZeBimf2Oxyg==","shasum":"6890871640115417a7d341299efe6d295efee9eb","tarball":"https://registry.npmjs.org/@aiq-cortex/client-knowledge/-/client-knowledge-0.7.0.tgz","fileCount":22,"unpackedSize":42948,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCICKMS6M7XFNgHYY7rEMDeHf4j3pLZf0KiEOZzgwFU+0PAiEA0HpwdTAEBjVTmkz8yodbKTzzTZGamZ3YGe0kplC872g="}]},"_npmUser":{"name":"shamilton_aq","email":"shamilton@agencyq.com"},"directories":{},"maintainers":[{"name":"shamilton_aq","email":"shamilton@agencyq.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/client-knowledge_0.7.0_1775605112734_0.5844658866282362"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-25T17:08:56.445Z","modified":"2026-04-07T23:38:32.995Z","0.2.0":"2026-03-25T17:08:57.651Z","0.3.0":"2026-03-25T17:30:38.100Z","0.3.2":"2026-03-25T19:19:53.481Z","0.4.0":"2026-03-25T20:40:27.431Z","0.5.0":"2026-03-28T20:40:55.886Z","0.6.0":"2026-03-29T14:07:54.276Z","0.7.0":"2026-04-07T23:38:32.862Z"},"bugs":{"url":"https://github.com/agencyQ/aiq-client-knowledge/issues"},"license":"UNLICENSED","homepage":"https://github.com/agencyQ/aiq-client-knowledge#readme","repository":{"type":"git","url":"git+https://github.com/agencyQ/aiq-client-knowledge.git"},"description":"MCP server for structured, semantic access to client knowledge","maintainers":[{"name":"shamilton_aq","email":"shamilton@agencyq.com"}],"readme":"# AgencyQ Client Knowledge Engine\n\nA deployed, multi-tenant knowledge service that gives AI agents deep, queryable understanding of client content, brand, and data — exposed via authenticated MCP.\n\n## Why\n\nAI agents working on client projects lack structured access to client knowledge. They don't know the brand voice, can't look up real stats, and invent content instead of using what the client provided. This tool fixes that.\n\n## How It Works\n\n```\nAI Agent ──MCP──→ Knowledge Engine ──→ PostgreSQL + pgvector\n                                        (Supabase)\n```\n\nThree layers of client intelligence:\n\n1. **Session Brief** — client context loaded at session start via MCP resource/prompt\n2. **Semantic Search** — natural language queries over all client documents\n3. **Structured Records** — typed, extractable data (stats, colors, partners)\n\n## MCP Tools\n\n| Tool | Purpose |\n|------|---------|\n| `search_knowledge` | Semantic search over client documents |\n| `get_client_brief` | Concise client overview for passive context |\n| `get_brand_voice` | Detailed voice guidelines and example copy |\n| `get_structured_data` | Typed records (stats, colors, partners) |\n| `ingest_content` | Add curated content to the knowledge base |\n| `ingest_file` | Queue raw files for extraction (v0.5+) |\n| `list_knowledge` | Inventory of ingested content |\n\n## Stack\n\n- **MCP Server:** Local Node.js (v0.1), Cloudflare Worker (v0.5+)\n- **Database:** PostgreSQL + pgvector on Supabase\n- **Embeddings:** OpenAI `text-embedding-3-small`\n- **Auth:** API key per developer, scoped to client(s)\n\n## Status\n\n**Pre-development.** PRD complete at `docs/prd.md`.\n\n## Phased Rollout\n\n- **v0.1** — Local server + Supabase, NGS as client zero (2-3 days)\n- **v0.5** — Deployed to Supabase + Cloudflare, multi-client (1-2 weeks)\n- **v1.0** — Full ingestion pipeline, CLI, monitoring (2-4 weeks)\n","readmeFilename":"README.md"}