@amigo-ai/platform-sdk 0.100.0 → 0.102.0

package/README.md

@@ -853,20 +853,6 @@ await client.triggers.resume(trigger.id)
 const runs = await client.triggers.listRuns(trigger.id)
 ```
 
-### Review Queue
-
-```typescript
-const stats = await client.reviewQueue.getStats()
-const dashboard = await client.reviewQueue.getDashboard()
-const { items } = await client.reviewQueue.list({ status: 'pending' })
-
-// Claim, approve, reject, correct
-await client.reviewQueue.claim('item-id')
-await client.reviewQueue.approve('item-id', { notes: 'Verified correct' })
-await client.reviewQueue.reject('item-id', { reason: 'Data mismatch' })
-await client.reviewQueue.batchApprove({ item_ids: ['id1', 'id2'] })
-```
-
 ### Compliance
 
 ```typescript

package/api.md

@@ -52,7 +52,7 @@ Notes:
 - Webhooks: `verifyWebhookSignature`, `parseWebhookEvent`, `WebhookVerificationError`
 - Pagination and response helpers: `paginate`, `buildLastResponse`, `extractRequestId`
 - Conversation helpers: `sessionConnectAuthProtocols`, `textStreamAuthProtocols`
-- Conversation types: `ChannelKind`, `ConversationDetail`, `ConversationListResponse`, `ConversationSummary`, `ConversationTurn`, `ConversationTurnAvailableAction`, `ConversationTurnStateTransition`, `CreateConversationRequest`, `ListConversationsParams`, `SessionConnectUrlParams`, `SwitchChannelRequest`, `TextStreamAuthProtocols` (WebSocket constructor subprotocol tuple), `TextStreamUrlParams`, `TurnDoneEvent`, `TurnErrorEvent`, `TurnMessageEvent`, `TurnRequest`, `TurnResponse`, `TurnConversationSnapshot`, `TurnStreamEvent`, `TurnThinkingEvent`, `TurnTokenEvent`, `TurnToolCallCompletedEvent`, `TurnToolCallStartedEvent`
+- Conversation types: `ChannelKind`, `ConversationDetail`, `ConversationTurn`, `ConversationTurnAvailableAction`, `ConversationTurnStateTransition`, `CreateConversationRequest`, `SessionConnectUrlParams`, `SwitchChannelRequest`, `TextStreamAuthProtocols` (WebSocket constructor subprotocol tuple), `TextStreamUrlParams`, `TurnDoneEvent`, `TurnErrorEvent`, `TurnMessageEvent`, `TurnRequest`, `TurnResponse`, `TurnConversationSnapshot`, `TurnStreamEvent`, `TurnThinkingEvent`, `TurnTokenEvent`, `TurnToolCallCompletedEvent`, `TurnToolCallStartedEvent`
 - Voice provider constants: `STT_PROVIDERS`, `TTS_PROVIDERS`, `VOICE_SESSION_PROVIDERS`
 - Voice provider types: `AgentVoiceConfig`, `ServiceVoiceConfigInput`, `ServiceVoiceConfigOutput`, `SttProvider`, `TtsProvider`, `VoiceSessionProvider`, `VoiceSettingsRequest`, `VoiceSettingsResponse`
 - Response and hook types: `PaginatedList`, `ListParams`, `LastResponseInfo`, `ResponseMetadata`, `WithResponseMetadata`, `AmigoResponse`, `RetryOptions`, `RateLimitInfo`, `ClientHooks`, `RequestHookContext`, `ResponseHookContext`, `ErrorHookContext`
@@ -118,6 +118,18 @@ All workspace-scoped resources also expose `withOptions(options)`.
 - `get`
 - `harnessContext`
 
+### `runs`
+
+- `list`
+- `summary`
+- `get`
+- `trajectory`
+- `sendGuidance`
+- `takeOver`
+- `handBack`
+- `switchMode`
+- `accessToken`
+
 ### `agentDefinitions`
 
 - `list`
@@ -256,7 +268,6 @@ All workspace-scoped resources also expose `withOptions(options)`.
 - `get`
 - `getTimeline`
 - `getIntelligence`
-- `getActiveIntelligence`
 - `getBenchmarks`
 - `getPhoneVolume`
 - `getTraceAnalysis`
@@ -266,7 +277,6 @@ All workspace-scoped resources also expose `withOptions(options)`.
 
 ### `conversations`
 
-- `list`
 - `create`
 - `get`
 - `close`

package/dist/index.cjs

@@ -1395,6 +1395,109 @@ var AgentRunsResource = class extends WorkspaceScopedResource {
   }
 };
 
+// src/resources/runs.ts
+var RunsResource = class extends WorkspaceScopedResource {
+  /**
+   * Paginated, newest-first list of runs. `kind` / `channel` / `status` are
+   * multi-value OR-filters (repeat within an axis, AND across axes); `status`
+   * accepts the virtual `live` (running + paused). `continuationToken` is the
+   * opaque cursor from a prior page — round-trip it verbatim.
+   */
+  async list(params) {
+    return extractData(
+      await this.client.GET("/v1/{workspace_id}/runs", {
+        params: {
+          path: { workspace_id: this.workspaceId },
+          query: {
+            limit: params?.limit,
+            continuation_token: params?.continuationToken,
+            kind: params?.kind,
+            channel: params?.channel,
+            status: params?.status,
+            sort_by: params?.sortBy
+          }
+        }
+      })
+    );
+  }
+  /** Aggregate run counts (total / live / by-status / by-kind). */
+  async summary(params) {
+    return extractData(
+      await this.client.GET("/v1/{workspace_id}/runs/summary", {
+        params: {
+          path: { workspace_id: this.workspaceId },
+          query: { kind: params?.kind, channel: params?.channel }
+        }
+      })
+    );
+  }
+  /** Resolve one run by its channel-neutral `run_id`, at any status. */
+  async get(runId) {
+    return extractData(
+      await this.client.GET("/v1/{workspace_id}/runs/{run_id}", {
+        params: { path: { workspace_id: this.workspaceId, run_id: runId } }
+      })
+    );
+  }
+  /**
+   * The ordered structural steps of a FRAMEWORK run's trajectory (perception /
+   * decision / tool / completion). 409 for conversation runs (they have per-turn
+   * detail via the conversation surface).
+   */
+  async trajectory(runId) {
+    return extractData(
+      await this.client.GET("/v1/{workspace_id}/runs/{run_id}/trajectory", {
+        params: { path: { workspace_id: this.workspaceId, run_id: runId } }
+      })
+    );
+  }
+  /** Send operator guidance to a LIVE run (the agent folds it into its next turn). */
+  async sendGuidance(runId, body) {
+    return extractData(
+      await this.client.POST("/v1/{workspace_id}/runs/{run_id}/guidance", {
+        params: { path: { workspace_id: this.workspaceId, run_id: runId } },
+        body
+      })
+    );
+  }
+  /** Take a live run over (operator drives). Returns the audio-leg coordinates for voice. */
+  async takeOver(runId, body) {
+    return extractData(
+      await this.client.POST("/v1/{workspace_id}/runs/{run_id}/takeover", {
+        params: { path: { workspace_id: this.workspaceId, run_id: runId } },
+        body
+      })
+    );
+  }
+  /** Hand a taken-over run back to the agent. */
+  async handBack(runId, body) {
+    return extractData(
+      await this.client.POST("/v1/{workspace_id}/runs/{run_id}/handback", {
+        params: { path: { workspace_id: this.workspaceId, run_id: runId } },
+        body
+      })
+    );
+  }
+  /** Switch the operator's mode on a live run (listen ↔ takeover). */
+  async switchMode(runId, body) {
+    return extractData(
+      await this.client.POST("/v1/{workspace_id}/runs/{run_id}/switch-mode", {
+        params: { path: { workspace_id: this.workspaceId, run_id: runId } },
+        body
+      })
+    );
+  }
+  /** Mint a run-scoped browser access token (voice takeover audio leg). */
+  async accessToken(runId, body) {
+    return extractData(
+      await this.client.POST("/v1/{workspace_id}/runs/{run_id}/access-token", {
+        params: { path: { workspace_id: this.workspaceId, run_id: runId } },
+        body
+      })
+    );
+  }
+};
+
 // src/resources/agent-definitions.ts
 var AgentDefinitionsResource = class extends WorkspaceScopedResource {
   async list(params) {
@@ -2308,14 +2411,6 @@ var CallsResource = class extends WorkspaceScopedResource {
       })
     );
   }
-  /** Get active intelligence across all in-progress calls */
-  async getActiveIntelligence() {
-    return extractData(
-      await this.client.GET("/v1/{workspace_id}/calls/active/intelligence", {
-        params: { path: { workspace_id: this.workspaceId } }
-      })
-    );
-  }
   /** Get performance benchmarks for a time period */
   async getBenchmarks(params) {
     return extractData(
@@ -2380,13 +2475,6 @@ var ConversationsResource = class extends WorkspaceScopedResource {
     super(client, workspaceId2);
     this.agentBaseUrl = agentBaseUrl;
   }
-  async list(params) {
-    return extractData(
-      await this.client.GET("/v1/{workspace_id}/conversations", {
-        params: { path: { workspace_id: this.workspaceId }, query: params }
-      })
-    );
-  }
   async create(request) {
     return extractData(
       await this.client.POST("/v1/{workspace_id}/conversations", {
@@ -6219,6 +6307,7 @@ var AmigoClient = class _AmigoClient {
   tokens;
   agents;
   agentRuns;
+  runs;
   agentDefinitions;
   /** @deprecated Use `actions` instead */
   skills;
@@ -6360,6 +6449,7 @@ var AmigoClient = class _AmigoClient {
     mutable.tokens = new TokensResource(client, workspaceId2);
     mutable.agents = new AgentsResource(client, workspaceId2);
     mutable.agentRuns = new AgentRunsResource(client, workspaceId2);
+    mutable.runs = new RunsResource(client, workspaceId2);
     mutable.agentDefinitions = new AgentDefinitionsResource(client, workspaceId2);
     mutable.skills = new SkillsResource(client, workspaceId2);
     mutable.actions = new ActionsResource(client, workspaceId2);