# 1. Put the prompt template on the agent
curl -X PUT https://api.orbit.devotel.io/api/v1/agents/agt_7e3b9c1f \
  -H "X-API-Key: dv_live_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"system_prompt":"When the caller asks for an invoice, use the billing_portal tool to look it up and export it."}'

# 2. Dry-run one proposed action — the verdict the live loop will see
curl -X POST https://api.orbit.devotel.io/api/v1/agents/agt_7e3b9c1f/computer-use-tools/tool_abc123/dry-run \
  -H "X-API-Key: dv_live_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "action": { "kind": "navigate", "url": "https://billing.example.com/invoices" },
    "confirmed": true,
    "dispatch": true
  }'

# 3. After the agent runs the task, read the run back
curl https://api.orbit.devotel.io/api/v1/agents/agt_7e3b9c1f/computer-use/sessions/ses_9c41e07b \
  -H "X-API-Key: dv_live_sk_..."

const base = "https://api.orbit.devotel.io/api/v1";
const headers = {
  "X-API-Key": process.env.ORBIT_API_KEY!,
  "Content-Type": "application/json",
};

// 1. Put the prompt template on the agent
await fetch(`${base}/agents/agt_7e3b9c1f`, {
  method: "PUT",
  headers,
  body: JSON.stringify({
    system_prompt:
      "When the caller asks for an invoice, use the billing_portal tool to look it up and export it.",
  }),
});

// 2. Dry-run one proposed action
const verdict = await (
  await fetch(
    `${base}/agents/agt_7e3b9c1f/computer-use-tools/tool_abc123/dry-run`,
    {
      method: "POST",
      headers,
      body: JSON.stringify({
        action: { kind: "navigate", url: "https://billing.example.com/invoices" },
        confirmed: true,
        dispatch: true,
      }),
    },
  )
).json();
console.log(verdict.data.decision); // allow | deny | require_confirmation

// 3. After the agent runs the task, read the run back
const run = await (
  await fetch(`${base}/agents/agt_7e3b9c1f/computer-use/sessions/ses_9c41e07b`, {
    headers,
  })
).json();
console.log(run.data.status, run.data.step_count);

from orbit_sdk import OrbitClient

client = OrbitClient.from_env()  # reads ORBIT_API_KEY

# 1. Put the prompt template on the agent
client.request(
    "PUT",
    "/agents/agt_7e3b9c1f",
    json={
        "system_prompt": "When the caller asks for an invoice, use the "
        "billing_portal tool to look it up and export it."
    },
)

# 2. Dry-run one proposed action
verdict = client.request(
    "POST",
    "/agents/agt_7e3b9c1f/computer-use-tools/tool_abc123/dry-run",
    json={
        "action": {"kind": "navigate", "url": "https://billing.example.com/invoices"},
        "confirmed": True,
        "dispatch": True,
    },
)
print(verdict["data"]["decision"])  # allow | deny | require_confirmation

# 3. After the agent runs the task, read the run back
run = client.request(
    "GET", "/agents/agt_7e3b9c1f/computer-use/sessions/ses_9c41e07b"
)
print(run["data"]["status"], run["data"]["step_count"])

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"net/http"
	"os"
)

func main() {
	base := "https://api.orbit.devotel.io/api/v1"
	client := &http.Client{}
	call := func(method, path, body string) map[string]any {
		var req *http.Request
		if body != "" {
			req, _ = http.NewRequest(method, base+path, bytes.NewBufferString(body))
		} else {
			req, _ = http.NewRequest(method, base+path, nil)
		}
		req.Header.Set("X-API-Key", os.Getenv("ORBIT_API_KEY"))
		req.Header.Set("Content-Type", "application/json")
		res, err := client.Do(req)
		if err != nil {
			panic(err)
		}
		defer res.Body.Close()
		var envelope map[string]any
		_ = json.NewDecoder(res.Body).Decode(&envelope)
		return envelope
	}

	// 1. Put the prompt template on the agent
	call("PUT", "/agents/agt_7e3b9c1f", `{"system_prompt":"When the caller asks for an invoice, use the billing_portal tool to look it up and export it."}`)

	// 2. Dry-run one proposed action
	verdict := call("POST", "/agents/agt_7e3b9c1f/computer-use-tools/tool_abc123/dry-run", `{"action":{"kind":"navigate","url":"https://billing.example.com/invoices"},"confirmed":true,"dispatch":true}`)
	fmt.Println(verdict["data"].(map[string]any)["decision"]) // allow | deny | require_confirmation

	// 3. After the agent runs the task, read the run back
	run := call("GET", "/agents/agt_7e3b9c1f/computer-use/sessions/ses_9c41e07b", "")
	fmt.Println(run["data"].(map[string]any)["status"], run["data"].(map[string]any)["step_count"])
}

require "json"
require "net/http"

base = URI("https://api.orbit.devotel.io/api/v1")
http = Net::HTTP.new(base.host, base.port)
http.use_ssl = true

call = lambda do |method, path, body = nil|
  klass = { "GET" => Net::HTTP::Get, "PUT" => Net::HTTP::Put, "POST" => Net::HTTP::Post }[method]
  request = klass.new(base + path)
  request["X-API-Key"] = ENV["ORBIT_API_KEY"]
  request["Content-Type"] = "application/json"
  request.body = body if body
  JSON.parse(http.request(request).body)
end

# 1. Put the prompt template on the agent
call.call("PUT", "/agents/agt_7e3b9c1f", JSON.dump(system_prompt: "When the caller asks for an invoice, use the billing_portal tool to look it up and export it."))

# 2. Dry-run one proposed action
verdict = call.call("POST", "/agents/agt_7e3b9c1f/computer-use-tools/tool_abc123/dry-run", JSON.dump(action: { kind: "navigate", url: "https://billing.example.com/invoices" }, confirmed: true, dispatch: true))
puts verdict.dig("data", "decision") # allow | deny | require_confirmation

# 3. After the agent runs the task, read the run back
run = call.call("GET", "/agents/agt_7e3b9c1f/computer-use/sessions/ses_9c41e07b")
puts [run.dig("data", "status"), run.dig("data", "step_count")].join(" ")

<?php
function call(string $method, string $path, ?string $body = null): array {
    $ch = curl_init("https://api.orbit.devotel.io/api/v1" . $path);
    curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $method);
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        "X-API-Key: " . getenv("ORBIT_API_KEY"),
        "Content-Type: application/json",
    ]);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    if ($body !== null) {
        curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
    }
    $envelope = json_decode(curl_exec($ch), true);
    curl_close($ch);
    return $envelope;
}

// 1. Put the prompt template on the agent
call("PUT", "/agents/agt_7e3b9c1f", json_encode([
    "system_prompt" => "When the caller asks for an invoice, use the billing_portal tool to look it up and export it.",
]));

// 2. Dry-run one proposed action
$verdict = call("POST", "/agents/agt_7e3b9c1f/computer-use-tools/tool_abc123/dry-run", json_encode([
    "action" => ["kind" => "navigate", "url" => "https://billing.example.com/invoices"],
    "confirmed" => true,
    "dispatch" => true,
]));
echo $verdict["data"]["decision"], PHP_EOL; // allow | deny | require_confirmation

// 3. After the agent runs the task, read the run back
$run = call("GET", "/agents/agt_7e3b9c1f/computer-use/sessions/ses_9c41e07b");
echo $run["data"]["status"], " ", $run["data"]["step_count"], PHP_EOL;