SDKs

Private typed clients ship in this monorepo. Use them from your private install path, or call the REST / OpenAI-compatible APIs directly.

Private packages

Node.js / TypeScript

Build and consume @intertrace/runtime for tool-call protection, or point the OpenAI SDK at the edge with itr_rt_*.

import { IntertraceRuntime } from "@intertrace/runtime";

const runtime = new IntertraceRuntime({
  apiKey: process.env.INTERTRACE_API_KEY!,
  projectId: process.env.INTERTRACE_PROJECT_ID!,
  environment: "production",
  mode: "enforce",
  agent: { id: "support-agent", name: "Support", purpose: "customer_support" },
  failurePolicy: {
    ordinaryActions: "fail_open",
    highImpactActions: "fail_closed",
  },
});

const { sessionId } = await runtime.startSession({ taskSummary: "Handle ticket" });
await runtime.endSession(sessionId);

Python

pip install -e packages/python-sdk for runtime helpers, or use the OpenAI SDK against https://intertrace.fly.dev/v1.

from intertrace import IntertraceRuntime

runtime = IntertraceRuntime(
    api_key="itr_rt_…",
    project_id="proj_xxx",
    agent={"id": "support-agent", "purpose": "customer_support"},
    environment="production",
    mode="enforce",
)
session_id = runtime.start_session(task_summary="Handle ticket")
runtime.end_session(session_id)

Environment

  • INTERTRACE_RUNTIME_API_KEY itr_rt_* from Settings
  • INTERTRACE_GATEWAY_URL — default https://gateway.intertrace.ai
  • Edge OpenAI base: https://intertrace.fly.dev/v1

Interactive API: API reference · Machine spec: /openapi.json.