Build your own Muse

curl https://api.agent37.com/v1/instances \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "user": "u_882",
    "name": "muse Pip",
    "budget": { "monthly_cap_micros": 2000000 },
    "auto_sleep": true,
    "idle_timeout_seconds": 1800,
    "env": { "MUSE_NOTIFY_TOKEN": "f3a9..." }
  }'

const token = crypto.randomBytes(24).toString("hex");

const inst = await (await fetch("https://api.agent37.com/v1/instances", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.AGENT37_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    user: "u_882",
    name: "muse Pip",
    budget: { monthly_cap_micros: 2000000 },
    auto_sleep: true,
    idle_timeout_seconds: 1800,
    env: { MUSE_NOTIFY_TOKEN: token },
  }),
})).json();

await db.users.update("u_882", {
  instanceId: inst.id,
  notifyTokenHash: crypto.createHash("sha256").update(token).digest("hex"),
});

curl -G https://ab12cd34ef.agent37.app/v1/files/content \
  -H "X-Agent37-Key: sk_live_..." \
  --data-urlencode "path=~/.hermes/SOUL.md" -o SOUL.md
# replace the block between the markers in SOUL.md, then write the whole file back
curl -X PUT "https://ab12cd34ef.agent37.app/v1/files/content?path=~/.hermes/SOUL.md" \
  -H "X-Agent37-Key: sk_live_..." \
  --data-binary @SOUL.md

const BEGIN = "<!-- muse:begin -->";
const END = "<!-- muse:end -->";
const url = `https://${user.instanceId}.agent37.app/v1/files/content?` +
  new URLSearchParams({ path: "~/.hermes/SOUL.md" });
const headers = { "X-Agent37-Key": process.env.AGENT37_API_KEY };

const read = await fetch(url, { headers });
if (!read.ok && read.status !== 404) throw new Error(`Reading SOUL.md failed (HTTP ${read.status})`);
const current = read.status === 404 ? "" : await read.text();
const start = current.indexOf(BEGIN);
const end = current.indexOf(END);
const next = start !== -1 && end > start
  ? current.slice(0, start) + block + current.slice(end + END.length)
  : `${block}\n\n${current}`;
await fetch(url, { method: "PUT", headers, body: next });

curl -N https://ab12cd34ef.agent37.app/v1/responses \
  -H "X-Agent37-Key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "input": "What could you take off my plate this week?",
    "session_id": "5b0217b44979d0213e9e995ee6120b42",
    "stream": true
  }'

const sideChat = { id: crypto.randomBytes(16).toString("hex"), created: Date.now() };
await db.threads.create({ userId: "u_882", ...sideChat });

const res = await fetch(`https://${user.instanceId}.agent37.app/v1/responses`, {
  method: "POST",
  headers: {
    "X-Agent37-Key": process.env.AGENT37_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ input, session_id: sideChat.id, stream: true }),
});

curl https://api.agent37.com/v1/instances/ab12cd34ef/crons \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Daily ideas",
    "schedule": "0 8 * * *",
    "timezone": "America/Los_Angeles",
    "prompt": "Daily ideas run. Think about what you know about the user: your memory, recent conversations, their goals in ~/muse/goals.json, and any connected apps. Then replace ~/muse/ideas.json with 4 fresh, specific ideas in this format: {\"updated\":\"<ISO time>\",\"ideas\":[{\"emoji\":\"<one emoji>\",\"title\":\"I can ...\",\"detail\":\"<why, citing what you know>\",\"prompt\":\"<the message that starts it, written as the user>\"}]}. Do not notify the user about this run."
  }'

# run it now; answers 202 as soon as the turn is sent
curl -X POST https://api.agent37.com/v1/instances/ab12cd34ef/crons/430cb8eaac74/run \
  -H "Authorization: Bearer sk_live_..."

const H = {
  Authorization: `Bearer ${process.env.AGENT37_API_KEY}`,
  "Content-Type": "application/json",
};
const cron = await (await fetch(
  `https://api.agent37.com/v1/instances/${user.instanceId}/crons`,
  {
    method: "POST",
    headers: H,
    body: JSON.stringify({
      name: "Daily ideas",
      schedule: "0 8 * * *",
      timezone: user.timezone,
      prompt: IDEAS_PROMPT,
    }),
  },
)).json();
await fetch(
  `https://api.agent37.com/v1/instances/${user.instanceId}/crons/${cron.id}/run`,
  { method: "POST", headers: H },
);

curl https://api.agent37.com/v1/instances/ab12cd34ef/crons \
  -H "Authorization: Bearer sk_live_..."
# -> { "data": [ { "id": "0e422a8c228b", "name": "Weekly 10K training check-in",
#      "schedule": "0 9 * * 1", "timezone": "America/Los_Angeles", "next_run": 1791216000, ... } ] }

const base = `https://${user.instanceId}.agent37.app/v1/files/content?`;
const [goalsDoc, crons] = await Promise.all([
  fetch(base + new URLSearchParams({ path: "~/muse/goals.json" }), {
    headers: { "X-Agent37-Key": process.env.AGENT37_API_KEY },
  }).then((r) => r.json()),
  fetch(`https://api.agent37.com/v1/instances/${user.instanceId}/crons`, {
    headers: { Authorization: `Bearer ${process.env.AGENT37_API_KEY}` },
  }).then((r) => r.json()),
]);
const nextRun = new Map(crons.data.map((cron) => [cron.id, cron.next_run]));
const goals = goalsDoc.goals.map((goal) => ({ ...goal, next_run: nextRun.get(goal.cron_id) ?? null }));

curl -X PUT "https://ab12cd34ef.agent37.app/v1/files/content?path=~/.hermes/memories/USER.md" \
  -H "X-Agent37-Key: sk_live_..." \
  -H "X-Expected-Mtime: 1790736409114.3372" \
  --data-binary $'Name: Alex.\n§\nAlex is vegetarian and prefers morning workouts.\n§\nFavorite cuisine: Thai'
# 412 { "error": { "code": "modified", ... } } means the agent wrote in between: re-read and re-apply

for (let attempt = 0; attempt < 3; attempt++) {
  const { entries, modified } = await readMemory(user.instanceId, "USER.md");
  const next = applyEdit(entries, edit);
  const res = await fetch(
    `https://${user.instanceId}.agent37.app/v1/files/content?` +
      new URLSearchParams({ path: "~/.hermes/memories/USER.md", ...(modified ? {} : { overwrite: "false" }) }),
    {
      method: "PUT",
      headers: {
        "X-Agent37-Key": process.env.AGENT37_API_KEY,
        ...(modified ? { "X-Expected-Mtime": String(modified) } : {}),
      },
      body: next.join("\n§\n"),
    },
  );
  if (res.status !== 412 && res.status !== 409) break;
}