routine.mjs

Functions

Imports

It imports no other module of this repo. No module of this repo imports it.

Source

1/**
2 * Starting a Claude Code routine from a site: one POST to the routine's API trigger, which opens a session on Dustin's
3 * Claude subscription. A site never holds a subscription credential (Anthropic allows subscription sign-in only in
4 * Claude Code and its own apps, code.claude.com/docs/en/legal-and-compliance); the trigger token can start this one
5 * routine and read nothing.
6 *
7 * Contract (platform.claude.com/docs/en/api/claude-code/routines-fire, read 2026-09-27 and 2026-10-11): POST the fire
8 * URL with `Authorization: Bearer <token>` and `anthropic-version: 2023-06-01`, body `{ "text": ... }` of at most
9 * 65,536 characters; a 2xx names the session; 429 is the hourly limit (30 per routine, 100 per account).
10 */
11
12const FIRE_URL = /^https:\/\/api\.anthropic\.com\/v1\/claude_code\/routines\/trig_[A-Za-z0-9_-]{8,64}\/fire$/;
13const MAX_TEXT = 65_536;
14const TIMEOUT_MS = 15_000;
15
16export function routineConfig(url, token) {
17  const u = typeof url === "string" ? url.trim() : "";
18  const t = typeof token === "string" ? token.trim() : "";
19  if (!u || !t) return { missing: "The routine's fire URL and token are not both set." };
20  if (!FIRE_URL.test(u)) return { missing: "The routine URL is not a /fire URL (https://api.anthropic.com/v1/claude_code/routines/trig_.../fire)." };
21  return { url: u, token: t };
22}
23
24export async function fireRoutine(config, text, fetcher = fetch) {
25  let res;
26  try {
27    res = await fetcher(config.url, {
28      method: "POST",
29      headers: {
30        Authorization: `Bearer ${config.token}`,
31        "anthropic-version": "2023-06-01",
32        "anthropic-beta": "experimental-cc-routine-2026-04-01",
33        "Content-Type": "application/json",
34      },
35      body: JSON.stringify({ text: String(text).slice(0, MAX_TEXT) }),
36      signal: AbortSignal.timeout(TIMEOUT_MS),
37    });
38  } catch (error) {
39    return { ok: false, retry: true, error: `The routine could not be reached: ${error instanceof Error ? error.message : String(error)}` };
40  }
41  if (res.ok) {
42    const body = await res.json().catch(() => ({}));
43    const url = typeof body?.claude_code_session_url === "string" ? body.claude_code_session_url : "";
44    return { ok: true, sessionUrl: /^https:\/\/([a-z0-9-]+\.)*claude\.ai\//.test(url) ? url : "" };
45  }
46  const body = await res.json().catch(() => ({}));
47  const type = typeof body?.error?.type === "string" ? body.error.type.slice(0, 64) : "";
48  const error = `${res.status}${type ? ` ${type}` : ""}`;
49  return { ok: false, retry: res.status === 429 || res.status >= 500, error };
50}