Machine API

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

# The Machine Agent ships transcripts as storage-v2 envelopes
# (X-Longhouse-Storage-Lane: live|repair). That is the engine's wire format,
# not a scripting contract. To import a file by hand:
longhouse-server ship --file path/to/session.jsonl

# GET /api/agents/storage/v2/capabilities returns the protocol version,
# ingest path, and size limits for the calling machine
curl -H "X-Agents-Token: $LONGHOUSE_DEVICE_TOKEN" \
  http://localhost:8080/api/agents/storage/v2/capabilities

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

# Query parameters:
#   query              - search query
#   limit              - max results (default 20, max 100)
#   offset             - pagination offset
#   project            - filter by project name
#   provider           - filter by provider id (claude, codex, cursor, opencode, pi, omp, 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 50, 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 '{"session_id": "SESSION_ID", "state": "running", "provider": "claude"}'

# state: thinking|running|idle|needs_user|blocked|stalled. Returns 204.

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

# Returns status (healthy, degraded, or unhealthy with HTTP 503) and the
# build identity. Loopback, admin, and internal callers also get per-check detail.

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

# Readiness: returns 200 when the catalog service answers, 503 otherwise