typescript

npm install @invoke/sdk

import { Invoke } from "@invoke/sdk"

const invoke = new Invoke({
  apiKey: process.env.INVOKE_API_KEY!,
})

const result = await invoke.call({
  tool: "stripe.charge_customer",        // registered tool name
  params: { customer_id: "cust_123", amount: 2400 },
  agentId: "billing-agent",              // registered agent identity
  idempotencyKey: "charge:cust_123:2400" // deduplication handle
})

{
  status: "executed" | "blocked" | "pending_approval" | "reconciled" | "replan_required",
  final_outcome?: "already_succeeded" | "not_executed",
  idempotency_key?: string,
  retry?: "blocked" | "allowed",
  trace: TraceStep[]
}

try {
  const result = await invoke.call({ ... })
} catch (err) {
  if (err.code === "SCOPE_VIOLATION") {
    // tool not allowed for this agent
  }
  if (err.code === "AUTH_FAILED") {
    // invalid or missing API key
  }
}