Cogito

Res cogitans — the thinking thing

Agent identity & state management for persistent AI assistants.

Part of the Cartisien trilogy:

• Engram — Persistent semantic memory (the trace)
• Extensa — Vector infrastructure (the extended)
• Cogito — Identity & state management (the thinking)

Installation

npm install @cartisien/cogito

Quick Start

import { createCogito } from '@cartisien/cogito';

const agent = createCogito({
  identityConfig: {
    name: 'Charli',
    role: 'assistant',
    traits: {
      style: 'sharp',
      boundaries: 'strong'
    }
  }
});

// Wake the agent
await agent.wake();

// Check state
console.log(agent.getState());

// Hibernate
await agent.sleep();

Features

• Identity Management — Configurable agent personas with traits
• State Persistence — Automatic state save/restore with history
• Lifecycle Hooks — Wake/sleep rituals with custom handlers
• Memory Traces — Track significant moments and decisions
• Engram Integration — Seamless memory layer (peer dependency)

Philosophy

Cogito implements Descartes' res cogitans — the thinking substance.

In Cartisien architecture:

• Cogito provides the agent's sense of self
• Extensa provides the infrastructure (vectors, storage)
• Engram bridges them through persistent memory

The agent doesn't just remember. It knows who it is.

API

Cogito

const agent = new Cogito(config);
await agent.wake();
await agent.sleep();
agent.getState();

Identity

agent.identity.name = 'Charli';
agent.identity.setTrait('style', 'sharp');
const trait = agent.identity.getTrait('style');

State Manager

agent.state.set('key', value);
const value = agent.state.get('key');
const snapshot = agent.state.snapshot();

Lifecycle

agent.lifecycle.onWake(async (event) => {
  console.log('Agent waking up...');
});

agent.lifecycle.onSleep(async (event) => {
  console.log('Agent going to sleep...');
});

License

MIT © Cartisien Interactive