> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runaether.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Report a continuation a computer carried out

> Records what the machine bridge on the caller's computer did with a continuation of a terminal chat in the cloud, and answers the continuation as it then stands. A shipped report creates the cloud task: a fork of the chat, its main chat a copy of the chat's conversation, resuming the session file Aether holds under a new session id, on the branch the bridge pushed. A refused report settles the continuation refused.

Use this tool when you need to:
- Report that the session was shipped to its end and the checkout's changes pushed (shipped)
- Report why the computer could not carry the continuation out (refused): the session file is missing, the folder is no longer a mirrored checkout, the turn did not end, the session could not be shipped, the push would publish files named like secrets, or git refused the push

Examples:
- PUT /computers/{computerID}/terminal-chat-continuations/{continuationID} {"outcome": "shipped", "head_sha": "9f2c1e0b7a6d5c4b3a291807f6e5d4c3b2a19081", "base_branch": "main", "session_file": {"generation": 1, "size": 48213}}
- PUT /computers/{computerID}/terminal-chat-continuations/{continuationID} {"outcome": "refused", "refusal": "push_failed", "detail": "remote: Permission to acme/app.git denied"}

Hints:
- session_file is how far the bridge shipped the session file, as Aether answered its last range: Aether must hold that much of the same generation. Aether refuses the continuation when the chat moved on since (a new turn ran), when its last turn has not ended, when the file is larger than a cloud task resumes, and when the cloud task cannot be created, naming why in settled.
- A continuation settles once: reporting a settled one again answers it as it is, so a retried report is harmless. A failure of Aether's own answers 500 and leaves it unsettled, to report again.
- Delete the pushed branch when the answer is refused: no task starts on it.
- A continuation not sent to the caller's computer is refused with 404 not_found.
- Only the grant of the caller's coding agent's bridge calls it, the machine bridge on the computer: a session or an API key is refused with 403 credential_kind_not_admitted.
- The call presents the computer's own secret, which aether setup keeps on it, in the Aether-Computer-Secret header. A computer that has none is refused with 403 computer_needs_setup: update the aether CLI there and run aether setup. A call that presents no secret, or another, is refused with 403 computer_set_up_elsewhere.



## OpenAPI

````yaml api-reference/openapi.json PUT /computers/{computerID}/terminal-chat-continuations/{continuationID}
openapi: 3.1.0
info:
  title: Aether API
  version: 0.1.0
servers:
  - url: https://api.runaether.dev
security:
  - bearerAuth: []
paths:
  /computers/{computerID}/terminal-chat-continuations/{continuationID}:
    put:
      tags:
        - computers
      summary: Report a continuation a computer carried out
      description: >-
        Records what the machine bridge on the caller's computer did with a
        continuation of a terminal chat in the cloud, and answers the
        continuation as it then stands. A shipped report creates the cloud task:
        a fork of the chat, its main chat a copy of the chat's conversation,
        resuming the session file Aether holds under a new session id, on the
        branch the bridge pushed. A refused report settles the continuation
        refused.


        Use this tool when you need to:

        - Report that the session was shipped to its end and the checkout's
        changes pushed (shipped)

        - Report why the computer could not carry the continuation out
        (refused): the session file is missing, the folder is no longer a
        mirrored checkout, the turn did not end, the session could not be
        shipped, the push would publish files named like secrets, or git refused
        the push


        Examples:

        - PUT
        /computers/{computerID}/terminal-chat-continuations/{continuationID}
        {"outcome": "shipped", "head_sha":
        "9f2c1e0b7a6d5c4b3a291807f6e5d4c3b2a19081", "base_branch": "main",
        "session_file": {"generation": 1, "size": 48213}}

        - PUT
        /computers/{computerID}/terminal-chat-continuations/{continuationID}
        {"outcome": "refused", "refusal": "push_failed", "detail": "remote:
        Permission to acme/app.git denied"}


        Hints:

        - session_file is how far the bridge shipped the session file, as Aether
        answered its last range: Aether must hold that much of the same
        generation. Aether refuses the continuation when the chat moved on since
        (a new turn ran), when its last turn has not ended, when the file is
        larger than a cloud task resumes, and when the cloud task cannot be
        created, naming why in settled.

        - A continuation settles once: reporting a settled one again answers it
        as it is, so a retried report is harmless. A failure of Aether's own
        answers 500 and leaves it unsettled, to report again.

        - Delete the pushed branch when the answer is refused: no task starts on
        it.

        - A continuation not sent to the caller's computer is refused with 404
        not_found.

        - Only the grant of the caller's coding agent's bridge calls it, the
        machine bridge on the computer: a session or an API key is refused with
        403 credential_kind_not_admitted.

        - The call presents the computer's own secret, which aether setup keeps
        on it, in the Aether-Computer-Secret header. A computer that has none is
        refused with 403 computer_needs_setup: update the aether CLI there and
        run aether setup. A call that presents no secret, or another, is refused
        with 403 computer_set_up_elsewhere.
      operationId: reportTerminalChatContinuation
      parameters:
        - in: path
          name: computerID
          required: true
          schema:
            format: uuid
            pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
            type: string
        - in: path
          name: continuationID
          required: true
          schema:
            format: uuid
            pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ReportTerminalChatContinuation'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ComputerTerminalChatContinuation'
          description: OK
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ComputersErrorResponse'
          description: Unauthorized
        '403':
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/ComputersErrorResponse'
                  - $ref: '#/components/schemas/OrgAuthorizationErrorResponse'
          description: Forbidden
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ComputersErrorResponse'
          description: Not Found
        '410':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ComputersErrorResponse'
          description: Gone
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ComputersErrorResponse'
          description: Unprocessable Entity
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ComputersErrorResponse'
          description: Internal Server Error
components:
  schemas:
    ReportTerminalChatContinuation:
      discriminator:
        mapping:
          refused: '#/components/schemas/TerminalChatContinuationRefusedOnComputer'
          shipped: '#/components/schemas/TerminalChatContinuationShipped'
        propertyName: outcome
      oneOf:
        - $ref: '#/components/schemas/TerminalChatContinuationShipped'
        - $ref: '#/components/schemas/TerminalChatContinuationRefusedOnComputer'
    ComputerTerminalChatContinuation:
      additionalProperties: false
      properties:
        branch:
          description: >-
            The branch to push the checkout's tracked and staged changes to, as
            a new branch of origin.
          pattern: ^aether/continue-[0-9a-f]{12}$
          type: string
        id:
          format: uuid
          type: string
        session_id:
          description: Claude Code's id of the session to ship to its end.
          format: uuid
          type: string
        settled:
          anyOf:
            - $ref: '#/components/schemas/ComputerTerminalChatContinuationSettlement'
            - type: 'null'
          description: >-
            How the continuation settled; null until it did, and while it has
            not, the bridge carries it out.
        task_id:
          description: The cloud task the continuation creates.
          format: uuid
          type: string
      required:
        - id
        - session_id
        - branch
        - task_id
        - settled
      type: object
    ComputersErrorResponse:
      additionalProperties: false
      properties:
        code:
          enum:
            - account_deleting
            - aether_inference_unserved
            - agent_pr_blocked
            - agent_pr_pending
            - agent_profile_changed
            - agent_starts_off
            - agent_starts_on_from_computer_only
            - agent_uses_own_sign_in
            - answer_on_its_way
            - app_identity_missing
            - attachments_unsupported
            - attribution_unavailable
            - bad_gateway
            - bad_request
            - base_branch_unusable
            - branch_exists
            - caller_inactive
            - chat_archived
            - chat_being_forked
            - chat_moved
            - chat_not_removable
            - chat_settings_fixed
            - chats_not_addable
            - checkout_not_archivable
            - cli_upgrade_required
            - client_outdated
            - computer_cli_outdated
            - computer_needs_fresh_sign_in
            - computer_needs_setup
            - computer_registered_to_another_person
            - computer_set_up_elsewhere
            - computer_starts_no_agents
            - computer_starts_no_forks
            - computer_task_start_moved
            - computer_unreachable
            - conflict
            - connection_creator_only
            - connection_harness_mismatch
            - connection_not_held
            - contents_write_required
            - continuation_failed
            - continuation_unavailable
            - control_forbidden
            - credential_kind_not_admitted
            - credential_named_file
            - detached_head
            - download_unsupported
            - embeddings_unavailable
            - feature_unsupported
            - file_references_unsupported
            - fix_not_requested
            - fix_requests_unrecorded
            - forbidden
            - fork_branch_delete_unsupported
            - fork_forbidden
            - fork_in_progress
            - fork_unsupported
            - gateway_timeout
            - github_failed
            - github_identity_required
            - github_push_access_required
            - gone
            - handed_branch_protected
            - head_moved
            - html_render_nul_byte
            - html_render_too_large
            - idempotency_key_conflict
            - idempotency_key_reused
            - idle_compaction_not_pending
            - idle_compaction_skipped
            - inference_proxy_unavailable
            - insufficient_credits
            - insufficient_inference_balance
            - interaction_mode_unsupported
            - internal_error
            - invalid_request
            - last_queued_message
            - live_protocol_unsupported
            - main_chat_permanent
            - mcp_server_not_connected
            - merge_when_ready_requires_pr_review
            - message_not_queued
            - message_not_waiting
            - method_not_allowed
            - mode_forbidden
            - name_follows_session
            - no_checkout_on_computer
            - no_checkpoint_yet
            - no_commit
            - no_dispatch_target
            - no_main_chat
            - no_origin
            - no_work_tree_folder
            - not_acceptable
            - not_found
            - not_implemented
            - onboarding_already_completed
            - onboarding_requirements_missing
            - open_in_terminal
            - org_id_required
            - org_role_insufficient
            - org_suspended
            - payment_required
            - pending_input_answered
            - permission_prompt_open
            - pr_automation_unsupported
            - pr_review_actor_required
            - pr_review_connection_spent
            - pr_review_publish_forbidden
            - precondition_failed
            - project_has_no_repository
            - project_not_a_choice
            - project_required
            - prompt_decisions_refused
            - pull_request_closed
            - pull_request_mirror_failed
            - pull_request_not_mirrored
            - push_failed
            - question_answers
            - question_shortened
            - queue_for_later_unsupported
            - queued_stop_requires_discard
            - rate_limited
            - reasoning_effort_fixed
            - remote_changes_on_from_computer_only
            - repository_not_connected
            - request_canceled
            - request_expired
            - request_timeout
            - request_too_large
            - review_name_follows_pull_request
            - sandbox_deleted
            - sandbox_failed
            - sandbox_needs_message
            - service_unavailable
            - session_file_generation
            - session_file_hole
            - session_file_missing
            - session_file_range_differs
            - session_gone
            - session_not_started_by_aether
            - slash_commands_unsupported
            - stack_cycle
            - stack_too_large
            - stack_two_parents
            - stale_execution
            - stale_or_indeterminate
            - stale_pending_input
            - start_cancelled
            - stream_delivery_gap
            - stream_event_conflict
            - task_archived
            - task_awaiting_message
            - task_awaiting_tool_response
            - task_backed_by_work_tree
            - task_connection_disconnected
            - task_creator_deleted
            - task_has_no_branch
            - task_has_no_repository
            - task_ineligible
            - task_not_accepting_messages
            - task_not_pinnable
            - task_not_started
            - task_settings_changed
            - task_start_failed
            - task_start_pending
            - teleport_unavailable
            - terminal_chat
            - terminal_chat_continuation_refused
            - terminal_chat_prompt_closed_otherwise
            - terminal_chat_prompt_differs
            - terminal_chat_prompt_not_answered
            - terminal_chat_removed
            - terminal_chat_run_moved
            - terminal_question
            - too_large
            - too_many_live_connections
            - too_many_waiting_messages
            - turn_running
            - unauthenticated
            - unsigned_aether_head
            - unsigned_commit
            - unsupported_changes
            - unsupported_media_type
            - untyped_error
            - user_suspended
            - validation_failed
            - work_tree_repository_differs
            - workspace_git_unavailable
            - workspace_gone
            - workspace_outdated
            - workspace_rejected
            - workspace_start_failed
          minLength: 1
          type: string
        error:
          minLength: 1
          type: string
        errors:
          items:
            $ref: '#/components/schemas/ErrorDetail'
          type: array
      required:
        - error
        - code
      type: object
    OrgAuthorizationErrorResponse:
      additionalProperties: false
      properties:
        code:
          enum:
            - org_membership_required
            - org_role_insufficient
            - org_suspended
            - account_deleting
            - agent_host_route_not_allowed
            - credential_kind_not_admitted
            - grant_scope_insufficient
          type: string
        error:
          minLength: 1
          type: string
      required:
        - error
        - code
      type: object
    TerminalChatContinuationRefusedOnComputer:
      additionalProperties: false
      properties:
        detail:
          description: >-
            What the refusal adds in words: git's message, the files named like
            secrets.
          maxLength: 2000
          minLength: 1
          type: string
          x-aether-string-length-unit: unicode-code-point
        outcome:
          enum:
            - refused
          type: string
        refusal:
          enum:
            - session_file_missing
            - checkout_unavailable
            - turn_running
            - ship_failed
            - secrets
            - push_failed
          type: string
      required:
        - outcome
        - refusal
      type: object
    TerminalChatContinuationShipped:
      additionalProperties: false
      properties:
        base_branch:
          description: >-
            The branch of origin the pushed work builds on: the checkout's
            branch's upstream on origin, else origin's default branch.
          minLength: 1
          type: string
        head_sha:
          description: >-
            The commit pushed to the continuation's branch: the checkout's HEAD
            with its tracked and staged changes.
          pattern: ^[0-9a-f]{40}$
          type: string
        outcome:
          enum:
            - shipped
          type: string
        session_file:
          additionalProperties: false
          description: >-
            How far the session file was shipped, as Aether answered its last
            range.
          properties:
            generation:
              minimum: 1
              type: integer
            size:
              minimum: 1
              type: integer
          required:
            - generation
            - size
          type: object
      required:
        - outcome
        - head_sha
        - base_branch
        - session_file
      type: object
    ComputerTerminalChatContinuationSettlement:
      additionalProperties: false
      properties:
        detail:
          description: What the refusal adds in words; null when there are none.
          maxLength: 2000
          minLength: 1
          type:
            - string
            - 'null'
          x-aether-string-length-unit: unicode-code-point
        outcome:
          description: continued once the cloud task was created; refused otherwise.
          enum:
            - continued
            - refused
          type: string
        refusal:
          description: Why it was refused; null when it continued.
          enum:
            - session_file_missing
            - checkout_unavailable
            - turn_running
            - ship_failed
            - secrets
            - push_failed
            - chat_moved
            - too_large
            - create_refused
          type:
            - string
            - 'null'
        settled_at:
          description: When it settled.
          format: date-time
          type: string
      required:
        - outcome
        - refusal
        - detail
        - settled_at
      type: object
    ErrorDetail:
      additionalProperties: false
      properties:
        location:
          description: >-
            Where the error occurred, e.g. 'body.items[3].tags' or
            'path.thing-id'
          type: string
        message:
          description: Error message text
          type: string
        value:
          description: The value at the given location
      type: object
  securitySchemes:
    bearerAuth:
      bearerFormat: JWT
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.