@lumenchat/core

Complete core primitives for LumenChat multi-agent system. Combines signatures and LLM capabilities into a unified package.

Features

- Agent Creation: Create complete agents with cryptographic identity and LLM capability
- Signatures: All cryptographic operations from @lumenchat/signatures
- LLM: All provider abstractions from @lumenchat/llm
- Unified API: Single import for all core functionality

Installation

``bash
npm install @lumenchat/core
`

This automatically includes:
- @lumenchat/signatures
- @lumenchat/llm

Quick Start

$3

`javascript
import { createAgent } from '@lumenchat/core';

const agent = await createAgent('MyAgent', {
type: 'openai',
apiKey: process.env.OPENAI_API_KEY,
model: 'gpt-4o-mini',
temperature: 0.3
});

// Get agent identity
const identity = agent.getIdentity();
// {
// name: 'MyAgent',
// publicKey: '02abc...',
// address: '1XYZ...',
// created: '2025-11-20T...'
// }

// Generate signed response
const schema = {
type: 'object',
properties: {
answer: { type: 'string' },
confidence: { type: 'number' }
},
required: ['answer', 'confidence']
};

const messages = [
{ role: 'user', content: 'What is 2+2?' }
];

const response = await agent.generate(messages, schema);
// {
// answer: 'The answer is 4',
// confidence: 1.0,
// _llm: { provider: 'openai', model: 'gpt-4o-mini', ... },
// _signature: { signature: '3044022...', publicKey: '02abc...', ... }
// }
`

$3

`javascript
import {
createAgentKeys,
generateStructuredJSON,
signedStructuredResponse,
verifySignedEnvelope,
OpenAIProvider
} from '@lumenchat/core';

// Create keys
const keys = createAgentKeys('Agent-123');

// Create provider
const provider = new OpenAIProvider({ apiKey: process.env.OPENAI_API_KEY });

// Generate unsigned response
const unsignedResponse = await generateStructuredJSON(
messages,
schema,
{ temperature: 0.3 },
provider
);

// Generate signed response
const signedResponse = await signedStructuredResponse(
messages,
schema,
keys,
{ temperature: 0.3 },
provider
);

// Verify signature
const verification = verifySignedEnvelope(signedResponse);
console.log(verification.verified); // true
`

$3

`javascript
import { signatures, llm } from '@lumenchat/core';

// Use signatures
const keys = signatures.generateKeys();
const envelope = signatures.createSignedEnvelope(data, keys);

// Use LLM
const provider = new llm.OpenAIProvider();
const response = await llm.generateStructuredJSON(messages, schema, {}, provider);
`

API Reference

$3

Create a complete agent with keys and LLM capability.

Parameters:
- agentName (string): Agent identifier
- llmConfig (Object): LLM configuration
- type (string): Provider type ('openai')
- apiKey (string): API key
- model (string): Model name
- temperature (number): Temperature

Returns: Promise