Report a continuation a computer carried out
curl --request PUT \
--url https://api.runaether.dev/computers/{computerID}/terminal-chat-continuations/{continuationID} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"base_branch": "<string>",
"head_sha": "<string>",
"outcome": "shipped",
"session_file": {
"generation": 2,
"size": 2
}
}
'import requests
url = "https://api.runaether.dev/computers/{computerID}/terminal-chat-continuations/{continuationID}"
payload = {
"base_branch": "<string>",
"head_sha": "<string>",
"outcome": "shipped",
"session_file": {
"generation": 2,
"size": 2
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
base_branch: '<string>',
head_sha: '<string>',
outcome: 'shipped',
session_file: {generation: 2, size: 2}
})
};
fetch('https://api.runaether.dev/computers/{computerID}/terminal-chat-continuations/{continuationID}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.runaether.dev/computers/{computerID}/terminal-chat-continuations/{continuationID}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'base_branch' => '<string>',
'head_sha' => '<string>',
'outcome' => 'shipped',
'session_file' => [
'generation' => 2,
'size' => 2
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.runaether.dev/computers/{computerID}/terminal-chat-continuations/{continuationID}"
payload := strings.NewReader("{\n \"base_branch\": \"<string>\",\n \"head_sha\": \"<string>\",\n \"outcome\": \"shipped\",\n \"session_file\": {\n \"generation\": 2,\n \"size\": 2\n }\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.runaether.dev/computers/{computerID}/terminal-chat-continuations/{continuationID}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"base_branch\": \"<string>\",\n \"head_sha\": \"<string>\",\n \"outcome\": \"shipped\",\n \"session_file\": {\n \"generation\": 2,\n \"size\": 2\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.runaether.dev/computers/{computerID}/terminal-chat-continuations/{continuationID}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"base_branch\": \"<string>\",\n \"head_sha\": \"<string>\",\n \"outcome\": \"shipped\",\n \"session_file\": {\n \"generation\": 2,\n \"size\": 2\n }\n}"
response = http.request(request)
puts response.read_body{
"branch": "<string>",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"settled": {
"detail": "<string>",
"outcome": "continued",
"refusal": "session_file_missing",
"settled_at": "2023-11-07T05:31:56Z"
},
"task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}Computers
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.
PUT
/
computers
/
{computerID}
/
terminal-chat-continuations
/
{continuationID}
Report a continuation a computer carried out
curl --request PUT \
--url https://api.runaether.dev/computers/{computerID}/terminal-chat-continuations/{continuationID} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"base_branch": "<string>",
"head_sha": "<string>",
"outcome": "shipped",
"session_file": {
"generation": 2,
"size": 2
}
}
'import requests
url = "https://api.runaether.dev/computers/{computerID}/terminal-chat-continuations/{continuationID}"
payload = {
"base_branch": "<string>",
"head_sha": "<string>",
"outcome": "shipped",
"session_file": {
"generation": 2,
"size": 2
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
base_branch: '<string>',
head_sha: '<string>',
outcome: 'shipped',
session_file: {generation: 2, size: 2}
})
};
fetch('https://api.runaether.dev/computers/{computerID}/terminal-chat-continuations/{continuationID}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.runaether.dev/computers/{computerID}/terminal-chat-continuations/{continuationID}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'base_branch' => '<string>',
'head_sha' => '<string>',
'outcome' => 'shipped',
'session_file' => [
'generation' => 2,
'size' => 2
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.runaether.dev/computers/{computerID}/terminal-chat-continuations/{continuationID}"
payload := strings.NewReader("{\n \"base_branch\": \"<string>\",\n \"head_sha\": \"<string>\",\n \"outcome\": \"shipped\",\n \"session_file\": {\n \"generation\": 2,\n \"size\": 2\n }\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.runaether.dev/computers/{computerID}/terminal-chat-continuations/{continuationID}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"base_branch\": \"<string>\",\n \"head_sha\": \"<string>\",\n \"outcome\": \"shipped\",\n \"session_file\": {\n \"generation\": 2,\n \"size\": 2\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.runaether.dev/computers/{computerID}/terminal-chat-continuations/{continuationID}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"base_branch\": \"<string>\",\n \"head_sha\": \"<string>\",\n \"outcome\": \"shipped\",\n \"session_file\": {\n \"generation\": 2,\n \"size\": 2\n }\n}"
response = http.request(request)
puts response.read_body{
"branch": "<string>",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"settled": {
"detail": "<string>",
"outcome": "continued",
"refusal": "session_file_missing",
"settled_at": "2023-11-07T05:31:56Z"
},
"task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}Authorizations
Path Parameters
Body
application/json
- Option 1
- Option 2
Response
OK