{"_id":"@cartisien/cogito","_rev":"4-b29798b4d923688fd1229a94810425a2","name":"@cartisien/cogito","dist-tags":{"latest":"0.2.0"},"versions":{"0.1.0":{"name":"@cartisien/cogito","version":"0.1.0","keywords":["ai","agent","identity","state","cogito","cartisien","res-cogitans"],"author":{"name":"Cartisien Interactive"},"license":"MIT","_id":"@cartisien/cogito@0.1.0","maintainers":[{"name":"mrwitters","email":"cartisien@cartisien.com"}],"homepage":"https://cartisien.com/products/cogito","bugs":{"url":"https://github.com/cartisien/cogito/issues"},"dist":{"shasum":"2b9520fbbd74ca18aaa250b46ca1bc154ba5b73b","tarball":"https://registry.npmjs.org/@cartisien/cogito/-/cogito-0.1.0.tgz","fileCount":6,"integrity":"sha512-rwCJRvdgsaQkWl3Bzslncu4SDoYAKDAcCYJ/hdIHXI1GvZCC2wSu+aQjlgiN3+qDRCulHGKPpFzZOPk6DwF69g==","signatures":[{"sig":"MEUCIFSXD1pZZSCNAR6f1XiMx3AzaQs8oOu2haiGr8N9+HliAiEA/P2M0CCSB09Xv7vyFBpIqckXd//YBME57Hv2WMPhvsM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":32817},"main":"./dist/index.js","types":"./dist/index.d.ts","module":"./dist/index.mjs","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"}},"gitHead":"36126702c52c79abd274b029ad942edd3ca84233","scripts":{"dev":"tsup src/index.ts --format cjs,esm --dts --watch","test":"vitest run","build":"tsup src/index.ts --format cjs,esm --dts","typecheck":"tsc --noEmit","test:watch":"vitest","prepublishOnly":"npm run build"},"_npmUser":{"name":"mrwitters","email":"cartisien@cartisien.com"},"repository":{"url":"git+https://github.com/cartisien/cogito.git","type":"git"},"_npmVersion":"11.8.0","description":"Agent identity & state management. Res cogitans — the thinking thing.","directories":{},"_nodeVersion":"25.5.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.1","vitest":"^1.6.1","typescript":"^5.9.3","@types/node":"^20.19.35"},"peerDependencies":{"@cartisien/engram":"^0.2.0"},"_npmOperationalInternal":{"tmp":"tmp/cogito_0.1.0_1772242022588_0.5541812093692489","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@cartisien/cogito","version":"0.1.1","keywords":["ai","agents","memory","identity","state","persistence","cartisien"],"author":{"url":"https://cartisien.com","name":"Jeff Witters","email":"jeff@cartisien.com"},"license":"MIT","_id":"@cartisien/cogito@0.1.1","maintainers":[{"name":"mrwitters","email":"cartisien@cartisien.com"}],"homepage":"https://cartisien.com","bugs":{"url":"https://github.com/cartisien/sdk/issues"},"dist":{"shasum":"f54229205b7e1c7a263444e90d8cf260ea97c9ba","tarball":"https://registry.npmjs.org/@cartisien/cogito/-/cogito-0.1.1.tgz","fileCount":38,"integrity":"sha512-iEvzqS67ne0jKng/f1UaAFDXuFBbUczYKGZg7zpgDPSzCJS0rihWbD+T2gsIHUl0n6qmPK1HE4B7fkgeEtCkUQ==","signatures":[{"sig":"MEUCIQDIv9hc6iwCwjgnRhbQxrW20nH2WUR45N5TO24TIEA5egIgR1RKXqQ5vOshdxAj/FlTiOeDZ3oL9zRdftDDDGNGI8Y=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":103378},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"a05eec55d1e82249001930ef4fd510817b39d815","scripts":{"test":"vitest run","build":"tsc","check":"tsc --noEmit"},"_npmUser":{"name":"mrwitters","email":"cartisien@cartisien.com"},"repository":{"url":"git+https://github.com/Cartisien/cogito.git","type":"git"},"_npmVersion":"10.8.2","description":"Identity and state management for AI agents — part of the Cartisien platform","directories":{},"_nodeVersion":"20.20.0","dependencies":{"zod":"^3.22.0","@cartisien/extensa":"*"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.4.0","@types/node":"^25.3.3"},"_npmOperationalInternal":{"tmp":"tmp/cogito_0.1.1_1773150118919_0.7961797917359683","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@cartisien/cogito","version":"0.1.2","keywords":["ai","agent","memory","lifecycle","identity","belief-revision","local-first"],"author":{"name":"Cartisien"},"license":"MIT","_id":"@cartisien/cogito@0.1.2","maintainers":[{"name":"mrwitters","email":"cartisien@cartisien.com"}],"homepage":"https://github.com/Cartisien/cogito#readme","bugs":{"url":"https://github.com/Cartisien/cogito/issues"},"dist":{"shasum":"d90879fc28ad192c6dfafadbceec9a643ca7f620","tarball":"https://registry.npmjs.org/@cartisien/cogito/-/cogito-0.1.2.tgz","fileCount":6,"integrity":"sha512-JFfMxc6oQq2RypT4MGbZ0v+wzZOShYYi6wY093qsqK9bbcPGflMLfKIxWRmg3MQ1CY417x0WN1wu+2d5bTmn7w==","signatures":[{"sig":"MEUCIQDP4x5Ix37J7LyQA0GSdJfV1GFzadbLqiziS7hyCyyOpQIgKf0QR+kfH3YlwccLauzbVk1O+i5BSNFhPpDLcr8vVe0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":9157},"main":"dist/index.js","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"scripts":{"build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"mrwitters","email":"cartisien@cartisien.com"},"repository":{"url":"git+https://github.com/Cartisien/cogito.git","type":"git"},"_npmVersion":"11.8.0","description":"Agent identity, lifecycle management, and belief revision for AI agents.","directories":{},"_nodeVersion":"25.5.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.9.3","@types/node":"^20.19.37"},"_npmOperationalInternal":{"tmp":"tmp/cogito_0.1.2_1773345057027_0.31429971302086024","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@cartisien/cogito","version":"0.2.0","description":"Agent identity, lifecycle management, and belief revision for AI agents.","main":"dist/index.js","types":"dist/index.d.ts","scripts":{"build":"tsc","prepublishOnly":"npm run build"},"keywords":["ai","agent","memory","lifecycle","identity","belief-revision","local-first"],"author":{"name":"Cartisien"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/Cartisien/cogito.git"},"devDependencies":{"@types/node":"^20.19.37","typescript":"^5.9.3"},"engines":{"node":">=18.0.0"},"gitHead":"2ff4513384164f461fc61985e11779595e4008cb","_id":"@cartisien/cogito@0.2.0","bugs":{"url":"https://github.com/Cartisien/cogito/issues"},"homepage":"https://github.com/Cartisien/cogito#readme","_nodeVersion":"25.5.0","_npmVersion":"11.8.0","dist":{"integrity":"sha512-2Ftj0/3yp8rwrB6SqL2HFCPADyoBu4igCoPiKdZmPzmckSsnO1XFY2DGhAVM8OaQLX3nkS1nKLCBj7O9y1PXBw==","shasum":"6ebf688bdf38cf6759dc566b9cc860afb501b763","tarball":"https://registry.npmjs.org/@cartisien/cogito/-/cogito-0.2.0.tgz","fileCount":15,"unpackedSize":21572,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCRdnGuXlfMPPnz/ogsPhnoTSxnRiQTgfAWzHc5l+V0eQIgAukbjPPXBv5+LLjTOSGP8Wtzpo1izLZUeM2HEFgh4/g="}]},"_npmUser":{"name":"mrwitters","email":"cartisien@cartisien.com"},"directories":{},"maintainers":[{"name":"mrwitters","email":"cartisien@cartisien.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/cogito_0.2.0_1773345422603_0.5916373906961829"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-28T01:27:02.481Z","modified":"2026-03-12T19:57:02.883Z","0.1.0":"2026-02-28T01:27:02.776Z","0.1.1":"2026-03-10T13:41:59.090Z","0.1.2":"2026-03-12T19:50:57.165Z","0.2.0":"2026-03-12T19:57:02.751Z"},"bugs":{"url":"https://github.com/Cartisien/cogito/issues"},"author":{"name":"Cartisien"},"license":"MIT","homepage":"https://github.com/Cartisien/cogito#readme","keywords":["ai","agent","memory","lifecycle","identity","belief-revision","local-first"],"repository":{"type":"git","url":"git+https://github.com/Cartisien/cogito.git"},"description":"Agent identity, lifecycle management, and belief revision for AI agents.","maintainers":[{"name":"mrwitters","email":"cartisien@cartisien.com"}],"readme":"# @cartisien/cogito\n\n> **Agent identity, lifecycle management, and belief revision.**\n\nPart of the [Cartisien Memory Suite](https://github.com/Cartisien) — *res cogitans* to Engram's trace and Extensa's *res extensa*.\n\n[![npm](https://img.shields.io/npm/v/@cartisien/cogito)](https://www.npmjs.com/package/@cartisien/cogito)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n\n---\n\n## What is Cogito?\n\nCogito is the lifecycle and identity layer for AI agents. While [Engram](https://github.com/Cartisien/engram) handles memory storage and retrieval, Cogito manages *who the agent is* and *when it's running*:\n\n- **Identity** — stable agent ID, persona configuration, and session context\n- **Lifecycle** — `wake()` / `sleep()` protocol with session boundary tracking\n- **Belief revision** — structured certainty management across the agent's memory\n- **Wake briefing** — synthesize relevant context from Engram on startup\n- **Sleep digest** — summarize the session and commit important decisions before shutdown\n\n```typescript\nimport { Cogito } from '@cartisien/cogito';\nimport { Engram } from '@cartisien/engram';\n\nconst memory = new Engram({ adapter: 'sqlite', connectionString: './agent.db', agentId: 'my-agent' });\nconst agent  = new Cogito({ agentId: 'my-agent', memory });\n\n// On startup\nconst briefing = await agent.wake();\n// → \"Last session: 2h ago. 3 unresolved tasks. User preference updated: dark mode.\"\n\n// ... agent runs ...\n\n// On shutdown\nawait agent.sleep({ summary: 'Completed refactor. Deferred auth ticket to tomorrow.' });\n```\n\n---\n\n## Architecture\n\n```\n┌─────────────────────────────────────────┐\n│              Agent Application           │\n└────────────────────┬────────────────────┘\n                     │\n┌────────────────────▼────────────────────┐\n│              Cogito                      │\n│  wake() · sleep() · identify()          │\n│  reinforce() · contradict() · reflect() │\n└────────────────────┬────────────────────┘\n                     │\n┌────────────────────▼────────────────────┐\n│              Engram                      │\n│  store() · recall() · consolidate()     │\n└─────────────────────────────────────────┘\n```\n\n---\n\n## API (v0.2 — coming soon)\n\n### `new Cogito(config)`\n\n```typescript\nconst agent = new Cogito({\n  agentId: 'my-agent',      // stable identity key\n  memory: engramInstance,   // Engram instance\n  persona?: string,         // optional system prompt / personality\n  ollamaUrl?: string,       // local LLM for briefing synthesis\n});\n```\n\n### `wake(): Promise<WakeBriefing>`\n\nInitialize the agent, load recent context from Engram, and return a briefing summary.\n\n### `sleep(options?): Promise<void>`\n\nSummarize the session, store a session-digest memory, and close connections cleanly.\n\n### `reflect(query): Promise<string>`\n\nSynthesize insights across retrieved memories before a task.\n\n### Belief Revision\n\n```typescript\nawait agent.reinforce(memoryId);   // confirm a belief\nawait agent.contradict(memoryId);  // challenge a belief\nawait agent.invalidate(memoryId);  // supersede a belief\n```\n\n---\n\n## The Cartisien Memory Suite\n\n| Package | Role | Status |\n|---------|------|--------|\n| [`@cartisien/engram`](https://github.com/Cartisien/engram) | Persistent memory | ✅ Stable |\n| [`@cartisien/cogito`](https://github.com/Cartisien/cogito) | Agent lifecycle & identity | 🔧 In development |\n| [`@cartisien/extensa`](https://github.com/Cartisien/extensa) | Vector infrastructure | 🔧 In development |\n\n*\"Res cogitans meets res extensa.\"*\n\n---\n\n## Research\n\nThis package is part of the Cartisien Memory Suite described in:\n\n> Cartisien. (2026). *Engram: A Local-First Persistent Memory Architecture for Conversational AI Agents*. Zenodo. https://doi.org/10.5281/zenodo.18988892\n\n---\n\n## License\n\nMIT © [Cartisien](https://cartisien.com)\n","readmeFilename":"README.md"}