Platform SDK

Use the official TypeScript SDK for typed workspace resources, unified runs, streaming conversations, retries, errors, analytics, and configuration.

The Concurrence Platform SDK (@amigo-ai/platform-sdk) provides a typed TypeScript client for the Platform API. From 0.113.1 the SDK defaults to https://platform.api-us.concurrence.com for US production; set baseUrl and identityBaseUrl to the hosts assigned to your deployment for any other region. Earlier packages default to a retired host that no longer resolves. It covers customer-facing resources including agents, services, conversations, calls, analytics, and simulations.

Platform API only. Configure the Platform resource base and identity token helpers separately using SDK Configuration. For the Classic API (api.amigo.ai), see the Classic API SDKs.

Available SDK

Property	Value
Package	@amigo-ai/platform-sdk
Repository	github.com/concurrence-hq/concurrence-platform-typescript-sdk
Registry	npm
Node.js Version	20+
Language	TypeScript (ships ESM + CJS, full .d.ts types)

Key Features

• Typed client surface. Supported operations expose generated request and response types. Branded ID types (AgentId, ServiceId, and so on) help prevent cross-resource ID mixups at compile time.

• Workspace-aware resources. Resource methods inject the configured workspace ID when the API route requires it; account-level and authentication helpers use their corresponding unscoped routes.

• Streaming support. Server-sent event streaming for conversation turns, plus WebSocket URL helpers for real-time text sessions.

• Built-in request error handling. Typed request errors with HTTP status codes when a response is available; streaming and webhook helpers expose their own structured errors.

• Zero-config retries. Automatic exponential backoff for eligible transient reads and POST 429 responses that include Retry-After.

• Dual module output. ESM and CJS, validated on Node.js 20, 22, and 24.

Covered Resources

Resource	Client Property	Description
Workspaces	client.workspaces	Workspace info and settings
API Keys	client.apiKeys	Create and manage API keys
Agents	client.agents	Agents and agent versions
Agent Runs	client.agentRuns	Read-only harness context; hosted framework-run creation is retired
Runs	client.runs	Unified conversation and framework run listing, detail, trajectories, and operator controls
Actions	client.actions	Reusable AI capabilities agents can call
Services	client.services	Published deployable services
Context Graphs	client.contextGraphs	Conversation flow graphs
Data Sources	client.dataSources	Stored data-source records; nothing polls them
World	client.world	Entities, events, relationships, timelines
Calls	client.calls	Call records, outbound call creation, and intelligence
Conversations	client.conversations	Text conversations, turns, and streaming
Sessions	client.sessions	Live session monitoring and fleet status
Integrations	client.integrations	External system integration configs
Analytics	client.analytics	Call volume, quality, trends
Simulations	client.simulations	Voice simulation sessions
Settings	client.settings	Voice, branding, outreach, retention

The current SDK no longer exposes client.billing, client.useCases, or client.agentDefinitions. Remove calls to these retired resources when upgrading; earlier changelog entries describe their historical availability.

client.skills is a deprecated alias for client.actions; the underlying REST path stays /skills for backward compatibility. The full client surface, including additional resources such as metrics, recordings, audit, compliance, and surfaces, is listed in the repository's api.md.

Version 0.112.0 is the latest on npm, checked October 13, 2026 (UTC). It removes client.workspaceDatabase, client.desktopSessions, client.tasks, and client.settings.gapScanner, and adds client.intake, client.dashboards, client.productionEvals, and filters on client.metrics.listLatest(). Version 0.111.0 removes dataSources.triggerSync() and the gap-scanner preview and scan methods; 0.110.0 adds the serviceId runs filter; 0.109.1 adds service accepted_context and the context map on conversation create and outbound call requests, removes service_id from outbound call requests (use_case_id was already required), and removes the retired cost-to-serve operations. client.sessions.getFleetStatus() still takes no arguments and reports voice capacity only, not tool-runner capacity. See the October package releases and the September compatibility changes.

Since 0.111.0, the generated types include context_binding_aliases, skill_input_bindings, and the memory-dimension operation. The memory-dimension operation has no resource method; call it with client.POST() and follow Service-Scoped Memory. See Conversation Context and Skills for the binding fields. A source update or open SDK PR is not a published package upgrade.

Getting Started

1. Installation. Add the SDK to your project.

2. Configuration. Set up authentication.

3. Quickstart. Make your first API call.

4. Error Handling. Handle errors gracefully.

Quick Example

import { AmigoClient } from '@amigo-ai/platform-sdk'

const client = new AmigoClient({
  apiKey: process.env.AMIGO_API_KEY!,
  workspaceId: process.env.AMIGO_WORKSPACE_ID!,
})

const { items: agents } = await client.agents.list()
console.log(`You have ${agents.length} agents`)

License

MIT License.