Machine API

curl -H "X-Agents-Token: YOUR_DEVICE_TOKEN" \
  http://localhost:8080/api/agents/sessions

curl -X POST http://localhost:8080/api/agents/ingest \
  -H "X-Agents-Token: YOUR_DEVICE_TOKEN" \
  -H "Content-Type: application/json" \
  -d @session.json

# Accepts gzip-compressed payloads: Content-Encoding: gzip
# Creates or updates a session and inserts events with deduplication

curl "http://localhost:8080/api/agents/sessions?query=auth+retry&limit=10"

# Query parameters:
#   query              - search query
#   limit              - max results (default 50)
#   offset             - pagination offset
#   project            - filter by project name
#   provider           - filter by provider id (claude, codex, cursor, opencode, pi, antigravity)
#   environment        - filter by environment (production, development, test, e2e)
#   device_id          - filter by device ID
#   days_back          - look back N days; with a query, omit to search all
#                         indexed history (default: 14-day window when listing
#                         without a query)
#   include_test       - include test/e2e sessions (default: false)
#   hide_autonomous    - hide sub-agents (default: true)
#   mode               - search mode: lexical|semantic|hybrid (default: lexical)
#   sort               - sort order: relevance|recency|balanced

curl http://localhost:8080/api/agents/sessions/SESSION_ID

curl "http://localhost:8080/api/agents/sessions/SESSION_ID/events?limit=100"

# Query parameters:
#   limit          - max results (default 100, max 1000)
#   offset         - pagination offset
#   roles          - comma-separated roles to filter (assistant, user, system, tool)
#   tool_name      - exact tool name filter (e.g., Bash)
#   query          - content search within session
#   context_mode   - forensic|active_context
#   branch_mode    - head|all (include abandoned branches)

curl "http://localhost:8080/api/agents/sessions/SESSION_ID/tail?limit=30"

# Returns the last N events from a session
# Useful for cross-session reading of recent activity

curl "http://localhost:8080/api/agents/sessions/SESSION_ID/thread"

# Returns all continuations in the logical thread

curl "http://localhost:8080/api/agents/sessions/SESSION_ID/projection?branch_mode=head"

# Returns the stitched lineage-path projection for a focused session
# Combines thread with events in one view

curl "http://localhost:8080/api/agents/sessions/SESSION_ID/workspace"

# Returns focused session, thread, and projection in one round trip
# Optimized for single HTTP call on session open

curl "http://localhost:8080/api/agents/sessions/SESSION_ID/export?branch_mode=head" \
  > session.jsonl

# Export session as JSONL for Claude Code --resume

curl "http://localhost:8080/api/agents/sessions/wall?project=zerg&days=7"

# Query parameters:
#   repo       - filter by git_repo (substring match)
#   project    - filter by project name
#   days       - look back N days (default 7)
#   limit      - max results (default 50, max 200)

curl -X POST http://localhost:8080/api/agents/directed-inputs \
  -H "X-Agents-Token: $LONGHOUSE_COORDINATION_TOKEN" \
  -H "X-Longhouse-Session-Id: $SOURCE_SESSION_ID" \
  -H "Content-Type: application/json" \
  -d '{"target_session_id": "TARGET_SESSION_ID", "text": "Check the failing test", "client_request_id": "check-test-1"}'

# Persists before any safe-boundary delivery attempt

curl "http://localhost:8080/api/agents/directed-inputs?direction=inbound&after_id=0&limit=20" \
  -H "X-Agents-Token: $LONGHOUSE_COORDINATION_TOKEN" \
  -H "X-Longhouse-Session-Id: $CURRENT_SESSION_ID"

# Query parameters:
#   direction  - inbound|outbound|all (default: inbound)
#   after_id   - stable input cursor (default: 0)
#   limit      - max results (default 20, max 200)

curl -X POST http://localhost:8080/api/agents/directed-inputs/INPUT_ID/reply \
  -H "X-Agents-Token: $LONGHOUSE_COORDINATION_TOKEN" \
  -H "X-Longhouse-Session-Id: $CURRENT_SESSION_ID" \
  -H "Content-Type: application/json" \
  -d '{"text": "The test is fixed", "client_request_id": "check-test-reply-1"}'

curl -X POST http://localhost:8080/api/agents/sessions/SESSION_ID/send-live \
  -H "X-Agents-Token: YOUR_DEVICE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text": "Check that test"}'

# Sends message to an actively running session (if connected)

curl -X POST http://localhost:8080/api/agents/sessions/SESSION_ID/action \
  -H "Content-Type: application/json" \
  -d '{"action": "park"}'

# Actions: park|snooze|archive|resume

curl -X POST http://localhost:8080/api/agents/presence \
  -H "X-Agents-Token: YOUR_DEVICE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"device_id": "DEVICE_ID", "work_state": "working"}'

curl http://localhost:8080/api/health

# Returns: server status, uptime, database stats, write serializer metrics

curl http://localhost:8080/api/readyz

# Lightweight check: returns 200 if the database is reachable