@zoza/ai

Zero-retention LLM inference. Ask any model; the server keeps nothing — no prompts, no completions, no metadata, no training data. Protocol negotiation exposed today; end-to-end double-ratchet encrypted completion streaming lands in v0.2.

Install

npm install @zoza/ai

Quick start (v0.1 surface)

import { AIClient } from '@zoza/ai';

const ai = new AIClient({ apiKey: process.env.ZOZA_AI_KEY! });

// Discover models available to your key
const { models } = await ai.listModels();
// → [{ id, name, provider, categories, public_key, spk_pub }, ...]

// Open a zero-retention session. The server discards all session state
// the moment the socket closes.
const session = await ai.createSession(models[0].id);
// → { session_id, model_id, server_ephemeral_pub, user_public_key }

// v0.2: session.sendEncrypted(prompt) with streaming completions.
// For now, your backend negotiates the protocol and receives a session
// handle that can be advanced via the v0.2 API when it lands.

Why

Mainstream LLM APIs log prompts by default. Most enterprise uses (legal research, medical triage, internal strategy docs, compliance review) cannot tolerate that. Zoza AI opens a per-session X25519 channel, signs the initial key exchange, and deletes all derived state when the session closes. The server physically cannot replay a conversation after it ends.

Today (v0.1):

• listModels() — which models and what's their identity+SPK keys
• createSession(modelId) — negotiate a zero-retention channel
• Protocol is documented; completion transport ships with v0.2

v0.2 roadmap:

• session.complete(prompt) with streaming
• Ratchet-advanced message-level encryption
• Optional TEE-sealed inference attestation

API

new AIClient({ apiKey, apiUrl?, fetch? })

| Option | Type | Notes | |---|---|---| | apiKey | string (required) | Issued at zoza.world/developers/ai-agent. Format ai_<base64>. | | apiUrl | string | Default https://ai-api.zoza.world. | | fetch | typeof fetch | Optional — Node <18 or custom signers. |

Methods

| Method | Auth | Purpose | |---|---|---| | listModels() | API key | List available models with their identity + signed prekey | | createSession(modelId) | API key | Open a zero-retention session against one model |

Tests

npm install
npm test

License

MIT © Zoza