@agentctx/core

@agentctx/core

The main AgentCTX package. Provides the complete platform runtime: CTX parser, gateway, sidecar, storage, memory, and knowledge systems.

Installation

npm install @agentctx/core

Exports

CTXParser

The CTX language parser. Converts text statements into typed ASTs.

import { CTXParser } from '@agentctx/core';

const parser = new CTXParser();

// Strict parsing
const stmt = parser.parse('?k "auth" #code ^3');

// Hybrid parsing (prose + CTX)
const result = parser.parse('Search for ?k "auth" #code', { mode: 'hybrid' });

// Multi-statement
const stmts = parser.parseMulti('?t github\n>t github.issues.list');

Gateway

The central request router with 15-stage middleware pipeline.

import { Gateway } from '@agentctx/core';

const gateway = new Gateway(config, knowledge, memory);
const result = await gateway.process('?k "auth patterns" ^3');
// { ok: true, op: "?k", ms: 4, data: { results: [...] } }

await gateway.close();

Sidecar

Deterministic CTX-to-human translation with Ed25519 signing.

import { Sidecar } from '@agentctx/core';

const sidecar = new Sidecar();
const translation = sidecar.translate(ast, 'human');
const signed = await sidecar.signAndWrite(ast, crypto, contextDir);

CryptoManager

Ed25519 keypair management, signing, and convergent encryption.

import { CryptoManager } from '@agentctx/core';

const crypto = new CryptoManager(contextDir);
await crypto.init();
const signed = await crypto.signTranslation(ctx, human);

Storage

Content-addressed object store and reference manager.

import { ObjectStore, RefStore, MemoryManager } from '@agentctx/core';

const objects = new ObjectStore(contextDir, projectSalt);
const refs = new RefStore(contextDir);
const memory = new MemoryManager(objects, refs);
await memory.init();

Knowledge

Semantic search over indexed documents.

import { KnowledgePlane, KnowledgeWatcher } from '@agentctx/core';

const knowledge = new KnowledgePlane();
const watcher = new KnowledgeWatcher(knowledge);
await watcher.start(['docs/', 'src/']);

See Also

• API Reference — detailed method signatures
• Installation — setup instructions