Give agents a governed view of markets and the world.

import { Agent } from "@spfunctions/agent/v1"

const agent = await Agent.create({
  apiKey: process.env.SF_API_KEY,
  openRouterApiKey: process.env.OPENROUTER_API_KEY,
  model: { id: "anthropic/claude-haiku-4.5" },
})

const run = agent.send(
  "Read world state, search macro markets, and explain the largest moves."
)

for await (const event of run.stream()) {
  console.log(event.type)
}

const sameRun = await Agent.getRun(run.id, { agentId: run.agentId })
await sameRun?.wait()

import { SimpleFunctions } from "@spfunctions/sdk"
import { FileTraceStore, ReplayMissError, SimpleFunctionsAgent } from "@spfunctions/agent"

const trace = new FileTraceStore("./sf-agent.trace.jsonl")
const sf = new SimpleFunctions({
  baseUrl: "https://simplefunctions.dev",
  apiKey: process.env.SF_API_KEY,
})
const direct = new SimpleFunctionsAgent({
  client: sf,
  policy: { maxSideEffect: "none", maxCostEffect: "api_cost" },
  trace,
})

await direct.tools.world.read({})

const replay = new SimpleFunctionsAgent({
  client: new SimpleFunctions({ baseUrl: "https://simplefunctions.dev" }),
  mode: "replayOnly",
  trace: new FileTraceStore("./sf-agent.trace.jsonl"),
})

await replay.tools.world.read({})

try {
  await replay.tools.world.delta({ since: "1h" })
} catch (error) {
  if (error instanceof ReplayMissError) {
    console.log("Replay miss. No live request was made.")
  }
}

Use SimpleFunctions for market intelligence.

Install:
  npm install @spfunctions/sdk@1.0.1 @spfunctions/agent@1.0.2

Rules:
  - Use /api/contracts/tools as strict truth.
  - Do not use /api/tools names as canonical Agent SDK names.
  - Start from @spfunctions/agent/v1 Agent.create().send().stream().
  - Use world.read, markets.search, and market.inspect first.
  - Keep maxSideEffect="none" unless a human approves writes.
  - Use replayOnly for offline replay; replay miss must not call live.
  - Never expose SF_API_KEY in browser code.

Goal:
  Build a small TypeScript agent that watches oil-risk markets, inspects moved tickers,
  and writes a short analyst note without trading.