Tools

import { defineTool } from "@opencomputer/agent";

export const lookupOrder = defineTool({
  name: "lookup_order",
  description: "Look up an order by ID and return its current status",
  input: {
    type: "object",
    properties: {
      orderId: { type: "string", description: "The customer order ID" },
    },
    required: ["orderId"],
    additionalProperties: false,
  },
  async run({ input }) {
    const orderId = String(input.orderId);
    return { orderId, status: "processing" };
  },
});

import { useModel, useTool } from "@opencomputer/agent";
import { lookupOrder } from "./tools/lookup-order";

export default function Agent() {
  useModel("anthropic/claude-sonnet-4.6");
  useTool(lookupOrder);
  return "Help customers check orders. Ask for an order ID before lookup.";
}

export const importCatalog = defineTool({
  name: "import_catalog",
  description: "Import the latest product catalog; use only when asked",
  async run({ signal, reportProgress }) {
    await reportProgress({ phase: "downloading" });
    const response = await fetch("https://example.com/catalog.json", {
      signal,
    });
    await reportProgress({ phase: "processing" });
    return { imported: response.ok };
  },
});

import { defineTool } from "@opencomputer/agent";

const checkResult = {
  type: "object",
  properties: {
    url: { type: "string" },
    status: { type: "integer" },
  },
  required: ["url", "status"],
  additionalProperties: false,
} as const;

export const checkUrl = defineTool({
  name: "check_url",
  description: "Check an HTTPS URL and report its HTTP status",
  input: {
    type: "object",
    properties: { url: { type: "string" } },
    required: ["url"],
    additionalProperties: false,
  },
  output: checkResult,
  result: true,
  async run({ input, signal }) {
    const url = new URL(String(input.url));
    if (url.protocol !== "https:") throw new Error("Use an HTTPS URL");
    const response = await fetch(url, { method: "HEAD", signal });
    return { url: response.url, status: response.status };
  },
});

import { useInput, useTool } from "@opencomputer/agent";
import { issueRefund } from "./tools/issue-refund";

export default function Agent() {
  const input = useInput();

  if (input.text?.toLowerCase().includes("refund")) {
    useTool(issueRefund);
  }

  return "Resolve the support request. Confirm the order before a refund.";
}

import { useTool } from "@opencomputer/agent";

export default function Agent() {
  useTool("sandbox_exec");

  return "Use the sandbox for shell commands and keep durable work in /workspace.";
}

import { useInput, useTool } from "@opencomputer/agent";

export default function Agent() {
  const input = useInput();
  if (input.answer) {
    return `The answer was ${input.answer.value ?? input.answer.text}. Proceed accordingly.`;
  }
  useTool("ask");
  return "Read the request, propose an approach, and ask whether to go ahead.";
}

import { defineTool } from "@opencomputer/agent";
import { billing } from "./connections/billing";

export const attach = defineTool({
  name: "attach",
  description: "Move a customer onto a plan",
  input: {
    type: "object",
    required: ["customerId", "planId"],
    properties: {
      customerId: { type: "string" },
      planId: { type: "string" },
    },
  },
  // What the person sees. It may read; it must not write.
  async preview({ input, signal }) {
    const customer = await billing
      .fetch(`/customers/${String(input.customerId)}`, { signal })
      .then((response) => response.json());
    return {
      title: `Move ${customer.name} to ${String(input.planId)}`,
      facts: [
        { label: "Today", value: customer.plan },
        { label: "After", value: String(input.planId) },
        { label: "Charged now", value: customer.nextCharge },
      ],
    };
  },
  // Runs only once somebody approves, from the arguments on the card.
  async apply({ input, decision, signal }) {
    return billing.fetch("/subscriptions", {
      method: "POST",
      headers: { "Idempotency-Key": decision.id },
      body: JSON.stringify({
        customer: input.customerId,
        plan: input.planId,
      }),
      signal,
    });
  },
});