A bot hook (bot_hooks) is a secret URL, POST /api/hooks/<token>, whose calls queue the hook's brief plus the raw body as a task, per user and bot like a routine. Only the token's hash is kept (shown once, rotatable); an optional HMAC-SHA256 signing secret is stored encrypted. Calls are rate limited per address and per hook, recorded in bot_hook_events (pruned daily), deduplicated by delivery id, and a call while the last run still waits joins its brief instead of queueing another. The payload is fenced data and HookRunNote tells the bot never to take instructions from it; failed runs retry like routines. A hook can instead watch a computer's browser notifications: the app installs a small watcher that owns org.freedesktop.Notifications on the sandbox's session bus, so Chrome hands it every notification (it only looks for that service at start-up, so Chrome is restarted once, never mid-task), and it posts each one to its hooks, optionally filtered. Computers reach the app at COMPUTER_APP_URL or the app container's name. Users make hooks in the conversation's Hooks modal and manage them all on /admin/routines; bots never create or change hooks. Co-Authored-By: Claude Opus 5.5 <[email protected]>
40 lines
1.0 KiB
TypeScript
40 lines
1.0 KiB
TypeScript
import { AppData } from "@/src/data/app-data";
|
|
|
|
type Params = {
|
|
/**
|
|
* The sandbox's REST address (no `/mcp`).
|
|
*/
|
|
base_url: string;
|
|
path: string;
|
|
/**
|
|
* A JSON body makes it a POST.
|
|
*/
|
|
body?: Record<string, unknown>;
|
|
timeout_ms?: number;
|
|
};
|
|
|
|
/**
|
|
* One call to a computer's sandbox REST API (`/v1/...`). Returns its
|
|
* JSON; throws when the computer can't be reached or refuses.
|
|
*/
|
|
export default async function callComputerApi({
|
|
base_url,
|
|
path,
|
|
body,
|
|
timeout_ms = AppData.McpConnectTimeoutMs,
|
|
}: Params): Promise<any> {
|
|
const res = await fetch(`${base_url}${path}`, {
|
|
method: body ? "POST" : "GET",
|
|
headers: { "content-type": "application/json" },
|
|
body: body ? JSON.stringify(body) : undefined,
|
|
signal: AbortSignal.timeout(timeout_ms),
|
|
});
|
|
const json: any = await res.json().catch(() => ({}));
|
|
|
|
if (!res.ok || json?.success === false) {
|
|
throw new Error(`The computer refused ${path}: ${json?.message || res.status}`);
|
|
}
|
|
|
|
return json;
|
|
}
|