HTTP/SSE API layer for Loki Mode autonomous agent orchestration.

# Start the API server
loki serve

# Or directly
./autonomy/serve.sh

# With options
loki serve --port 9000 --host 0.0.0.0

• Deno 1.40+ (for running the server)
• Loki Mode installed and configured

Install Deno:

curl -fsSL https://deno.land/install.sh | sh
# or
brew install deno

--port, -p <port>   Port to listen on
--host <host>       Host to bind to
--no-cors           Disable CORS
--no-auth           Disable authentication
--generate-token    Generate a secure API token

By default, the API only accepts requests from localhost without authentication.

For remote access:

# Generate a token
export LOKI_API_TOKEN=$(loki serve --generate-token)

# Start server allowing remote connections
loki serve --host 0.0.0.0

# Connect from another machine
curl -H "Authorization: Bearer $LOKI_API_TOKEN" http://server:57374/health

• session:started - Session started
• session:paused - Session paused
• session:resumed - Session resumed
• session:stopped - Session stopped
• session:completed - Session completed successfully
• session:failed - Session failed

• phase:started - Phase started
• phase:completed - Phase completed
• phase:failed - Phase failed

• task:created - Task created
• task:started - Task started
• task:progress - Task progress update
• task:completed - Task completed
• task:failed - Task failed

• agent:spawned - Agent spawned
• agent:output - Agent output
• agent:completed - Agent completed
• agent:failed - Agent failed

• log:debug - Debug log
• log:info - Info log
• log:warn - Warning log
• log:error - Error log

• metrics:update - Metrics update
• input:requested - Human input requested
• heartbeat - Keep-alive heartbeat

curl -X POST http://localhost:57374/api/sessions \
  -H "Content-Type: application/json" \
  -d '{"provider": "claude", "prdPath": "./docs/prd.md"}'

const events = new EventSource('http://localhost:57374/api/events');

events.addEventListener('task:completed', (e) => {
  const event = JSON.parse(e.data);
  console.log(`Task completed: ${event.data.title}`);
});

events.addEventListener('log:error', (e) => {
  const event = JSON.parse(e.data);
  console.error(`Error: ${event.data.message}`);
});

events.onerror = (err) => {
  console.error('Connection error:', err);
};

import { LokiClient } from './api/client.ts';

const client = new LokiClient('http://localhost:57374');

// Start a session
const { sessionId } = await client.startSession({
  provider: 'claude',
  prdPath: './docs/prd.md'
});

// Subscribe to events
const unsubscribe = client.subscribe((event) => {
  console.log(`${event.type}: ${JSON.stringify(event.data)}`);
});

// Get session status
const status = await client.getSession(sessionId);
console.log(`Status: ${status.session.status}`);

// Stop session
await client.stopSession(sessionId);

// Cleanup
unsubscribe();
client.close();

# Filter by session
curl "http://localhost:57374/api/events?sessionId=session_123"

# Filter by event types
curl "http://localhost:57374/api/events?types=task:completed,task:failed"

# Filter log level
curl "http://localhost:57374/api/events?minLevel=warn"

# Replay recent history
curl "http://localhost:57374/api/events?history=50"

deno test --allow-all api/server_test.ts

deno run --watch --allow-all api/server.ts

deno check api/server.ts

api/
  server.ts           # Main HTTP server
  client.ts           # TypeScript client SDK
  mod.ts              # Module exports
  openapi.yaml        # OpenAPI specification
  routes/
    sessions.ts       # Session endpoints
    tasks.ts          # Task endpoints
    events.ts         # SSE streaming
    health.ts         # Health checks
  services/
    cli-bridge.ts     # CLI integration
    state-watcher.ts  # File system watcher
    event-bus.ts      # Event distribution
  middleware/
    auth.ts           # Authentication
    cors.ts           # CORS handling
    error.ts          # Error handling
  types/
    api.ts            # API types
    events.ts         # Event types

The API watches the .loki/ directory for state changes:

• sessions/{id}/session.json - Session state
• sessions/{id}/tasks.json - Task list
• sessions/{id}/phase.json - Current phase
• sessions/{id}/agents.json - Active agents
• state.json - Global state

Changes are detected via file watching and emitted as SSE events.

MIT