document360-engine

Headless documentation-agent engine for document360-writer and future GUI wrappers (e.g. document360-desktop).

This package contains no UI. It exposes the agent session lifecycle, Document360 OAuth/profiles/config, and an in-process Document360 tool server, and emits a typed event stream that wrappers render however they like (terminal, GUI). It's the documentation analog of the Claude Agent SDK: one engine, many front-ends.

You almost certainly want document360-writer (the CLI), not this package directly. This is the shared core.

Concept

document360-engine            ← this package: headless, emits EngineEvents
   ├─ document360-writer      ← terminal wrapper (CLI + Ink TUI)
   └─ document360-desktop     ← (future) GUI wrapper

The engine never writes to a screen. Each wrapper does two things: render events and collect input → engine calls.

Minimal usage

import { createSession } from 'document360-engine';

const session = createSession({ cwd: process.cwd(), authMode: 'auto' });
for await (const event of session.send('analyze this repo and propose a docs structure')) {
  switch (event.type) {
    case 'text':   process.stdout.write(event.delta); break;       // streaming answer
    case 'tool':   console.error(`tool: ${event.name}`); break;    // a tool was invoked
    case 'result': console.error(`done: ${event.outputTokens} tokens`); break;
    case 'error':  console.error(`error: ${event.message}`); break;
  }
}
session.close();

All EngineEvent variants are plain JSON, so a wrapper can stream them over IPC to a GUI.

Also exported

• Document360 auth: loginPkce, whoami, token store, resolveActiveProfile, profile helpers.
• Claude auth: resolveAuth (api / subscription / auto).
• Config: readProjectConfig / writeProjectConfig, resolveProfile, types.
• Sessions: createSession, listSessions, getSession, renameSession, generateTitle.

License

Proprietary — © 2026 Kovai.co. All rights reserved. See LICENSE.