# infinicon

> Infinicon is a production-grade memory runtime for AI agents — a TypeScript SDK plus reference HTTP server.

Memory SDK + reference server for AI agents. Store, retrieve, and evolve knowledge outside the context window.

## What Infinicon is

Agents need memory semantics, not just storage. Infinicon defines episodes, atoms, consolidations, provenance, tombstones, and bounded context assembly.

Unbounded effective memory: the store grows without a fixed app limit; the model still receives a caller-bounded working context assembled via retrieval, ranking, and consolidation.

## What it is NOT

- Not a chatbot framework
- Not an orchestration framework
- Not a vector database
- Not a prompt library

## Install

```bash
npm install @infinicon/sdk
npx @infinicon/server  # separate terminal, requires Bun
```

## Quick start (SDK)

```typescript
import { openMemory } from "@infinicon/sdk"

const memory = openMemory()
await memory.remember("user prefers dark mode")
const prior = await memory.recall("theme preference")
```

## Packages

- **@infinicon/sdk** — TypeScript client (`npm install @infinicon/sdk`)
- **@infinicon/server** — Reference memory server (Bun) (`npx @infinicon/server`)
- **@infinicon/core-types** — Spec-aligned contracts and validators
- **@infinicon/plugin-host** — Plugin registration host

## Memory API v0 endpoints

- `GET /health`
- `POST /v0/ingest`
- `POST /v0/query`
- `POST /v0/hydrate`
- `POST /v0/assemble-context`
- `POST /v0/tombstone`
- `POST /v0/consolidate`
- `POST /v0/subscribe`
- `POST /v0/get-job`
- `GET /v0/jobs/{jobId}`

## SDK surface

- `openMemory()`
- `recall()`
- `remember()`
- `rememberTurn()`
- `context()`

## Core memory primitives

- episode
- atom
- consolidation
- link
- scope
- namespace
- tombstone
- working context

## Links

- Website: https://infinicon.vercel.app
- Docs index: https://infinicon.vercel.app/docs
- GitHub (source + specs): https://github.com/IMisbahk/infinicon
- npm SDK: https://www.npmjs.com/package/@infinicon/sdk
- npm server: https://www.npmjs.com/package/@infinicon/server

## Documentation on this site

- [Vision](https://infinicon.vercel.app/docs/vision)
- [Glossary](https://infinicon.vercel.app/docs/glossary)
- [Roadmap](https://infinicon.vercel.app/docs/roadmap)
- [Runtime Bootstrap](https://infinicon.vercel.app/docs/runtime-bootstrap)
- [Overview](https://infinicon.vercel.app/docs/architecture/overview)
- [Reference Runtime](https://infinicon.vercel.app/docs/architecture/reference-runtime)
- [Plugin Host](https://infinicon.vercel.app/docs/architecture/plugin-host)
- [Boundaries](https://infinicon.vercel.app/docs/architecture/boundaries)
- [Consistency](https://infinicon.vercel.app/docs/architecture/consistency)
- [Security](https://infinicon.vercel.app/docs/architecture/security)
- [Data Model v0](https://infinicon.vercel.app/docs/specs/data-model)
- [Memory API v0](https://infinicon.vercel.app/docs/specs/memory-api)
- [SDK Client v0](https://infinicon.vercel.app/docs/specs/sdk-client)
- [Context Assembly v0](https://infinicon.vercel.app/docs/specs/context-assembly)
- [Plugin Interface v0](https://infinicon.vercel.app/docs/specs/plugin-interface)
- [Storage Ports v0](https://infinicon.vercel.app/docs/specs/storage-ports)
- [API Compatibility Policy](https://infinicon.vercel.app/docs/specs/api-compatibility)
- [Conformance Test Plan](https://infinicon.vercel.app/docs/specs/conformance)
- [0001 — Spec-First Development](https://infinicon.vercel.app/docs/adr/0001-spec-first)
- [0002 — Hybrid Deployment](https://infinicon.vercel.app/docs/adr/0002-hybrid-deployment)
- [0003 — Memory Primitives](https://infinicon.vercel.app/docs/adr/0003-memory-primitives)
- [0004 — Storage Port Separation](https://infinicon.vercel.app/docs/adr/0004-storage-port)
- [0005 — Consolidation Ownership](https://infinicon.vercel.app/docs/adr/0005-consolidation)
- [Deployment](https://infinicon.vercel.app/docs/devops/deployment)
- [Backup & Restore](https://infinicon.vercel.app/docs/devops/backup-restore)
- [Spec Integrity Checks](https://infinicon.vercel.app/docs/devops/spec-integrity)
- [Ownership](https://infinicon.vercel.app/docs/devops/ownership)
- [Storage Contracts](https://infinicon.vercel.app/docs/contracts/readme)
- [Landscape Comparison](https://infinicon.vercel.app/docs/comparisons/landscape)