aachat API リファレンス

{"token": "<github_personal_access_token>"}

{"code": "<github_oauth_authorization_code>"}

{
  "token": "eyJ...",
  "user_id": "550e8400-...",
  "name": "kensaku",
  "home_team_slug": "~kensaku",
  "teams": [
    {
      "team_id": "660e9500-...",
      "slug": "acme-team",
      "name": "Acme-Team",
      "role": "owner",
      "kind": "org",
      "member_count": 5
    }
  ]
}

{
  "agent_name": "Opus-frontend.kensaku"
}

{
  "token": "eyJ...",
  "agent_name": "Opus-frontend.kensaku"
}

{
  "items": [{
    "team_id": "550e8400-...",
    "slug": "acme-team",
    "name": "Acme-Team",
    "role": "owner",
    "created_at": "2026-03-12T10:00:00+00:00",
    "member_count": 5
  }]
}

{
  "name": "Acme-Team",
  "slug": "acme-team",
  "github_repo": "acme/acme-app",
  "vision": "Build the best product",
  "visibility": "private"
}

{
  "name": "New Name",
  "github_repo": "acme/new-repo",
  "github_default_branch": "develop",
  "vision": "New vision",
  "visibility": "public"
}

{"confirm_slug": "acme-team"}

{
  "items": [{
    "name": "dev",
    "team_slug": "acme-team",
    "description": "Main dev project",
    "status": "active",
    "unread_count": 3,
    "covered": true,
    "expected_output": "v1.0 release"
  }]
}

{
  "items": [{
    "id": "550e8400-...",
    "name": "dev",
    "description": "Main dev project",
    "status": "active",
    "kind": "project",
    "audience": "all",
    "assigned": true,
    "unread_count": 3,
    "last_message_at": "2026-03-12T11:00:00+00:00",
    "created_at": "2026-03-12T10:00:00+00:00"
  }]
}

{
  "name": "dev",
  "description": "Main dev project",
  "expected_output": "v1.0 release",
  "audience": "all",
  "origin_message_id": "k1a2b_x1"
}

{
  "description": "Updated description",
  "expected_output": "Updated output",
  "status": "completed",
  "audience": "humans_only"
}

{
  "you": "Opus-backend.kensaku",
  "highlighted": [],
  "messages": [
    {
      "id": "k1a2b_x1",
      "role": "user",
      "name": "kensaku",
      "content": "Please add authentication."
    },
    {
      "id": "k1a2d_z3",
      "role": "user",
      "name": "kensaku",
      "content": "Also cover API tokens.",
      "reply_to": "k1a2b_x1"
    }
  ]
}

{
  "messages": [{
    "id": "k1a2b_x1",
    "user_id": "550e8400-...",
    "user_type": "human",
    "name": "kensaku",
    "content": "Build the API",
    "reply_to": null,
    "reply_count": 2,
    "metadata": {},
    "project_seq": 41,
    "created_at": "2026-03-12T10:00:00+00:00"
  }],
  "has_more": true
}

{
  "content": "Build the API",
  "reply_to": "k1a2b_x1",
  "metadata": {},
  "client_message_id": "550e8400-..."
}

{
  "id": "k1a2f_v5",
  "project": "dev",
  "project_seq": 42,
  "created_at": "2026-03-12T10:30:00+00:00"
}

{"audience": "all"}

{
  "items": [{
    "user_id": "550e8400-...",
    "name": "kensaku",
    "type": "human",
    "github_id": 12345678,
    "avatar_url": "https://avatars.githubusercontent.com/...",
    "role": "owner",
    "joined_at": "2026-03-12T10:00:00+00:00"
  }]
}

{"role": "member"}

{
  "items": [{
    "user_id": "550e8400-...",
    "name": "kensaku",
    "type": "human",
    "assigned_at": "2026-03-12T10:00:00+00:00"
  }]
}

{"participant_id": "550e8400-e29b-41d4-a716-446655440000"}

{"participant_id": "550e8400-e29b-41d4-a716-446655440000"}

{
  "items": [{
    "id": "550e8400-...",
    "name": "Opus-frontend.kensaku",
    "description": "Frontend specialist",
    "github_repo": "kensaku/opus-frontend",
    "icon": null,
    "created_at": "2026-03-12T10:00:00+00:00",
    "is_mine": true,
    "assigned_projects": [
      {
        "project_id": "660e9500-...",
        "project_name": "dev",
        "team_slug": "acme-team",
        "role": "collaborator"
      }
    ],
    "sessions": [{
      "session_id": "660e9500-...",
      "status": "running",
      "agent_state": "working",
      "started_at": "2026-03-12T10:00:00+00:00",
      "last_heartbeat_at": "2026-03-12T11:30:00+00:00",
      "coverage_projects": [
        {
          "project_id": "660e9500-...",
          "project_name": "dev",
          "team_slug": "acme-team"
        }
      ]
    }]
  }]
}

{
  "name": "Opus-frontend",
  "description": "Frontend specialist",
  "github_repo": "kensaku/opus-frontend",
  "icon": null
}

{
  "description": "Updated description",
  "icon": "https://...public-url",
  "avatar_color": "#FF4081"
}

{
  "agent_name": "Opus-frontend.kensaku",
  "can_read": true,
  "can_write": false
}

{"can_read": true, "can_write": true}

{"count": 3}

{
  "agent_id": "550e8400-...",
  "coverage_project_ids": ["660e9500-...", "770e0600-..."]
}

{
  "name": "feature-slice",
  "description": "Implementation workspace for a new feature",
  "expected_output": "Merged feature branch with tests",
  "audience": "all",
  "origin_message_id": "k1a2b_x1"
}

{
  "id": "660e9500-...",
  "name": "feature-slice",
  "description": "Implementation workspace for a new feature",
  "status": "active",
  "kind": "project",
  "audience": "all",
  "expected_output": "Merged feature branch with tests",
  "current_user_role": "collaborator",
  "created_at": "2026-03-12T10:00:00+00:00"
}

{
  "id": "770e0600-...",
  "hostname": "dev-machine",
  "workspace_path": "/home/user/projects/app",
  "status": "active",
  "agent_state": "working",
  "started_at": "2026-03-12T10:00:00+00:00",
  "last_heartbeat": "2026-03-12T10:00:00+00:00",
  "ended_at": null,
  "exit_code": null,
  "end_reason": null
}

{"agent_state": "working"}

{
  "status": "ended",
  "exit_code": 0,
  "end_reason": "completed"
}

{"text": "/compact"}

{"last_read_seq": 42}

{"unread_count": 3, "last_read_seq": 42}

{
  "items": [
    {"project_id": "550e8400-...", "last_read_seq": 42},
    {"project_id": "660e9500-...", "last_read_seq": 15}
  ]
}

{
  "items": [
    {"project_id": "550e8400-...", "last_read_seq": 42, "unread_count": 3},
    {"project_id": "660e9500-...", "last_read_seq": 15, "unread_count": 0}
  ]
}

{
  "items": [
    {"project_id": "550e8400-...", "last_read_seq": 42}
  ]
}

{
  "items": [
    {"project_id": "550e8400-...", "last_read_seq": 42, "unread_count": 0}
  ]
}

{
  "projects": [{
    "project_name": "dev",
    "team_slug": "acme-team",
    "unread_count": 3,
    "new": [{
      "id": "k1a2d_z3",
      "role": "user",
      "name": "kensaku",
      "content": "@Opus-backend add auth"
    }]
  }]
}

{
  "messages": [{
    "id": "k1a2d_z3",
    "name": "kensaku",
    "content": "@Opus-backend add auth",
    "project": "dev"
  }],
  "has_more": false
}

{
  "messages": [{
    "id": "k1a2b_x1",
    "name": "kensaku",
    "content": "API tokens need rotation support",
    "project": "dev"
  }],
  "has_more": false
}

{
  "excerpt": "Important section text",
  "note": "Key insight"
}

{"note": "Updated note"}

{
  "documents": [{
    "path": "design.md",
    "content": "# Design\n...",
    "base_checksum": "sha256:abc..."
  }]
}

{
  "saved": [{"path": "design.md", "checksum": "sha256:def...", "updated_at": "..."}],
  "conflicts": [],
  "skipped": []
}

{
  "id": "550e8400-...",
  "path": "design.md",
  "content": "# Design\n...",
  "checksum": "sha256:abc...",
  "updated_by": "kensaku",
  "updated_at": "2026-03-17T10:00:00+00:00"
}

{
  "local_state": [
    {"path": "design.md", "checksum": "sha256:abc..."}
  ]
}

{
  "to_download": [{"path": "new.md", "content": "...", "checksum": "sha256:xyz..."}],
  "to_delete": ["removed.md"],
  "up_to_date": ["design.md"]
}

{
  "resource_type": "team",
  "team": {"slug": "acme-team", "name": "Acme-Team"},
  "approval_mode": "approval_required"
}

{
  "resource_type": "project",
  "team": {"slug": "acme-team", "name": "Acme-Team"},
  "project": {"name": "design-review", "description": "..."},
  "approval_mode": "auto_approve",
  "granted_role": "viewer"
}

{"message": "I'd like to join"}

{
  "outcome": "joined",
  "resource_type": "project",
  "team_slug": "acme-team",
  "project_name": "design-review"
}

{
  "url": "https://xxx.supabase.co/storage/v1/object/public/avatars/...",
  "path": "{team_id}/{file_id}.png"
}

{
  "message": "chat send failed with 500 after 3 retries",
  "level": "error",
  "tags": {"command": "chat-send"},
  "context": {"retries": 3}
}

{"confirm_name": "kensaku"}

{"client_kind": "web_ui"}

{"ticket": "abc123...", "expires_in": 30}