Headless agent

npm install -g @spfunctions/cli
sf login
sf status --json
sf doctor --agent --deep --json
sf describe agent --json

sf agent --plain \
  --new \
  --allow read,user_data,research \
  --deny trade,runtime,fs \
  --budget-usd 0.25 \
  --once "Summarize active thesis risk, new signals, and the next read-only checks."

0 * * * * /usr/bin/env bash -lc 'sf agent --plain --new --allow read,user_data,research --deny trade,runtime,fs --budget-usd 0.25 --record-trace "$HOME/.sf/traces/thesis-hourly-$(date +\%Y-\%m-\%d-\%H).ndjson" --once "Review my active theses. Use current market state, list material changes, and propose read-only follow-ups. Do not trade or start daemons." >> "$HOME/.sf/logs/thesis-hourly.log" 2>&1'

sf agent --plain \
  --record-trace traces/fed-cut.ndjson \
  --once "Inspect Fed cut markets and produce a risk brief."

sf agent --plain \
  --replay-trace traces/fed-cut.ndjson \
  --once "Inspect Fed cut markets and produce a risk brief."

sf agent --headless --deny trade,runtime,fs

{
  "type": "ready",
  "policy": {
    "deny": ["trade", "runtime", "fs"],
    "categories": ["read", "user_data", "market_data", "research", "write", "trade", "runtime", "fs"]
  },
  "tools": [
    {
      "name": "inspect_ticker",
      "description": "Complete ticker dossier with actionable suggestion.",
      "parameters": {}
    }
  ]
}

{"type":"call","id":"calc-1","tool":"calculate","params":{"expression":"(0.57 - 0.52) * 100"}}
{"type":"done"}

{"type":"result","id":"calc-1","tool":"calculate","output":"(0.57 - 0.52) * 100 = 4.999999999999993","ms":0}

import { spawn } from "node:child_process";
import readline from "node:readline";

const sf = spawn("sf", ["agent", "--headless", "--deny", "trade,runtime,fs"], {
  stdio: ["pipe", "pipe", "inherit"],
});

const rl = readline.createInterface({ input: sf.stdout });

rl.on("line", (line) => {
  const msg = JSON.parse(line);

  if (msg.type === "ready") {
    sf.stdin.write(JSON.stringify({
      type: "call",
      id: "world-1",
      tool: "get_world_delta",
      params: { since: "1h" },
    }) + "\n");
    sf.stdin.write(JSON.stringify({ type: "done" }) + "\n");
  }

  if (msg.type === "result") {
    console.log(msg.output);
  }
});

claude -p '
You are operating SimpleFunctions through shell commands.

Rules:
- Run only commands that begin with: sf status, sf doctor, sf describe, sf tools, sf me, sf brief, sf investigate, sf query, sf inspect, sf world, sf agent.
- Do not run sf buy, sf sell, sf cancel, sf intent, sf runtime, sf quoteengine, or any command that starts a daemon.
- Prefer --json for direct commands.
- For a reasoning pass, use:
  sf agent --plain --new --allow read,user_data,research --deny trade,runtime,fs --budget-usd 0.25 --once "<your prompt>"

Task:
Research whether the Fed cut thesis has materially changed. Return the commands you ran, the evidence, and the next read-only checks.
' \
  --tools "Bash" \
  --allowedTools "Bash(sf status:*),Bash(sf doctor:*),Bash(sf describe:*),Bash(sf tools:*),Bash(sf me:*),Bash(sf brief:*),Bash(sf investigate:*),Bash(sf query:*),Bash(sf inspect:*),Bash(sf world:*),Bash(sf agent:*)" \
  --output-format json

claude -p '
Build a small Node script that starts:
  sf agent --headless --deny trade,runtime,fs

The script must:
1. Parse the ready frame.
2. Call get_world_delta with since=1h.
3. Call inspect_ticker only if the user provided a ticker.
4. Print a compact JSON report.
5. Send {"type":"done"} before exit.

Do not call trade, runtime, fs, wake, alert, or voice tools.
' \
  --tools "Read,Write,Bash" \
  --allowedTools "Bash(sf agent:*),Bash(node:*),Read,Write" \
  --output-format json

--allow read,user_data,research --deny trade,runtime,fs