@amigo-ai/platform-sdk 0.91.0 → 0.93.0

package/README.md

@@ -578,23 +578,41 @@ const benchmarks = await client.calls.getBenchmarks({ days: 30 })
 
 ### Text conversations
 
-Use `client.conversations.sendMessage()` for user-first synchronous text turns. Omit
-`conversation_id` to start a new durable conversation; pass the returned ID to resume it.
+Use `client.conversations.create()` to start a new durable conversation, then
+`client.conversations.createTurn()` for user-first synchronous text turns (or
+`streamTurn()` for a typed SSE event stream).
 
 ```typescript
-const firstTurn = await client.conversations.sendMessage({
+const conversation = await client.conversations.create({
   service_id: 'service-id',
-  message: 'Hello, I need help scheduling',
   entity_id: 'entity-id',
 })
 
-const nextTurn = await client.conversations.sendMessage({
-  service_id: 'service-id',
-  conversation_id: firstTurn.conversation_id,
+const firstTurn = await client.conversations.createTurn(conversation.id, {
+  message: 'Hello, I need help scheduling',
+})
+
+const nextTurn = await client.conversations.createTurn(conversation.id, {
   message: 'Tuesday morning works',
 })
 
-console.log(nextTurn.messages.map((message) => message.text))
+console.log(nextTurn.output.map((message) => message.text))
+```
+
+Move an active conversation to a different channel (e.g. hand off web chat to
+iMessage/SMS) with `switchChannel()`; close it with `close()` so the customer
+can start fresh on the next inbound message:
+
+```typescript
+await client.conversations.switchChannel(conversation.id, {
+  channel: 'imessage',
+  reason: 'customer_request',
+  recipient: '+15555550123', // required for sms/imessage
+  use_case_id: 'use-case-id', // required for sms/imessage
+  dispatch_opener: true,
+})
+
+await client.conversations.close(conversation.id)
 ```
 
 For real-time browser clients, build the text-stream URL and use WebSocket

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: `ConversationDetail`, `ConversationListResponse`, `ConversationSummary`, `ConversationTurn`, `ConversationTurnAvailableAction`, `ConversationTurnStateTransition`, `CreateConversationRequest`, `ListConversationsParams`, `SessionConnectUrlParams`, `TextStreamAuthProtocols` (WebSocket constructor subprotocol tuple), `TextStreamUrlParams`, `TurnDoneEvent`, `TurnErrorEvent`, `TurnMessageEvent`, `TurnRequest`, `TurnResponse`, `TurnConversationSnapshot`, `TurnStreamEvent`, `TurnThinkingEvent`, `TurnTokenEvent`, `TurnToolCallCompletedEvent`, `TurnToolCallStartedEvent`
+- 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`
 - 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`
@@ -270,6 +270,7 @@ All workspace-scoped resources also expose `withOptions(options)`.
 - `create`
 - `get`
 - `close`
+- `switchChannel`
 - `createTurn`
 - `pollTurn`
 - `createTurnStream`
@@ -383,29 +384,6 @@ All workspace-scoped resources also expose `withOptions(options)`.
 - `getInvoice`
 - `getInvoicePdf`
 
-### `reviewQueue`
-
-- `list`
-- `listAutoPaging`
-- `get`
-- `getStats`
-- `getDashboard`
-- `getMyQueue`
-- `getMyQueueAutoPaging`
-- `approve`
-- `reject`
-- `claim`
-- `unclaim`
-- `correct`
-- `batchApprove`
-- `batchReject`
-- `getHistory`
-- `getHistoryAutoPaging`
-- `getTrends`
-- `getPerformance`
-- `getCorrectionSchema`
-- `getDiff`
-
 ### `recordings`
 
 - `getUrls`

package/dist/index.cjs

@@ -2412,6 +2412,23 @@ var ConversationsResource = class extends WorkspaceScopedResource {
       }
     });
   }
+  /**
+   * Move a conversation to a different channel (e.g. web → sms/imessage).
+   *
+   * `recipient` (E.164) is required when switching to sms/imessage. Pass
+   * `dispatch_opener: true` to have the agent immediately send one turn on
+   * the new channel, optionally steered by `instruction`.
+   */
+  async switchChannel(conversationId, request) {
+    return extractData(
+      await this.client.POST("/v1/{workspace_id}/conversations/{conversation_id}/channel", {
+        params: {
+          path: { workspace_id: this.workspaceId, conversation_id: conversationId }
+        },
+        body: request
+      })
+    );
+  }
   /**
    * Send a user message and receive the agent's synchronous JSON response.
    *
@@ -3554,143 +3571,6 @@ var BillingResource = class extends WorkspaceScopedResource {
   }
 };
 
-// src/resources/review-queue.ts
-var ReviewQueueResource = class extends WorkspaceScopedResource {
-  async list(params) {
-    return extractData(
-      await this.client.GET("/v1/{workspace_id}/review-queue", {
-        params: { path: { workspace_id: this.workspaceId }, query: params }
-      })
-    );
-  }
-  listAutoPaging(params) {
-    return this.iteratePaginatedList((pageParams) => this.list(pageParams), params);
-  }
-  async get(itemId) {
-    return extractData(
-      await this.client.GET("/v1/{workspace_id}/review-queue/{item_id}", {
-        params: { path: { workspace_id: this.workspaceId, item_id: itemId } }
-      })
-    );
-  }
-  async getStats() {
-    return extractData(
-      await this.client.GET("/v1/{workspace_id}/review-queue/stats", {
-        params: { path: { workspace_id: this.workspaceId } }
-      })
-    );
-  }
-  async getDashboard() {
-    return extractData(
-      await this.client.GET("/v1/{workspace_id}/review-queue/dashboard", {
-        params: { path: { workspace_id: this.workspaceId } }
-      })
-    );
-  }
-  async getMyQueue(params) {
-    return extractData(
-      await this.client.GET("/v1/{workspace_id}/review-queue/my-queue", {
-        params: { path: { workspace_id: this.workspaceId }, query: params }
-      })
-    );
-  }
-  getMyQueueAutoPaging(params) {
-    return this.iteratePaginatedList((pageParams) => this.getMyQueue(pageParams), params);
-  }
-  async approve(itemId, body) {
-    return extractData(
-      await this.client.POST("/v1/{workspace_id}/review-queue/{item_id}/approve", {
-        params: { path: { workspace_id: this.workspaceId, item_id: itemId } },
-        body
-      })
-    );
-  }
-  async reject(itemId, body) {
-    return extractData(
-      await this.client.POST("/v1/{workspace_id}/review-queue/{item_id}/reject", {
-        params: { path: { workspace_id: this.workspaceId, item_id: itemId } },
-        body
-      })
-    );
-  }
-  async claim(itemId) {
-    return extractData(
-      await this.client.POST("/v1/{workspace_id}/review-queue/{item_id}/claim", {
-        params: { path: { workspace_id: this.workspaceId, item_id: itemId } }
-      })
-    );
-  }
-  async unclaim(itemId) {
-    return extractData(
-      await this.client.POST("/v1/{workspace_id}/review-queue/{item_id}/unclaim", {
-        params: { path: { workspace_id: this.workspaceId, item_id: itemId } }
-      })
-    );
-  }
-  async correct(itemId, body) {
-    return extractData(
-      await this.client.POST("/v1/{workspace_id}/review-queue/{item_id}/correct", {
-        params: { path: { workspace_id: this.workspaceId, item_id: itemId } },
-        body
-      })
-    );
-  }
-  async batchApprove(body) {
-    return extractData(
-      await this.client.POST("/v1/{workspace_id}/review-queue/batch-approve", {
-        params: { path: { workspace_id: this.workspaceId } },
-        body
-      })
-    );
-  }
-  async batchReject(body) {
-    return extractData(
-      await this.client.POST("/v1/{workspace_id}/review-queue/batch-reject", {
-        params: { path: { workspace_id: this.workspaceId } },
-        body
-      })
-    );
-  }
-  async getHistory(params) {
-    return extractData(
-      await this.client.GET("/v1/{workspace_id}/review-queue/history", {
-        params: { path: { workspace_id: this.workspaceId }, query: params }
-      })
-    );
-  }
-  getHistoryAutoPaging(params) {
-    return this.iteratePaginatedList((pageParams) => this.getHistory(pageParams), params);
-  }
-  async getTrends(params) {
-    return extractData(
-      await this.client.GET("/v1/{workspace_id}/review-queue/trends", {
-        params: { path: { workspace_id: this.workspaceId }, query: params }
-      })
-    );
-  }
-  async getPerformance(params) {
-    return extractData(
-      await this.client.GET("/v1/{workspace_id}/review-queue/performance", {
-        params: { path: { workspace_id: this.workspaceId }, query: params }
-      })
-    );
-  }
-  async getCorrectionSchema(itemId) {
-    return extractData(
-      await this.client.GET("/v1/{workspace_id}/review-queue/{item_id}/correction-schema", {
-        params: { path: { workspace_id: this.workspaceId, item_id: itemId } }
-      })
-    );
-  }
-  async getDiff(itemId) {
-    return extractData(
-      await this.client.GET("/v1/{workspace_id}/review-queue/{item_id}/diff", {
-        params: { path: { workspace_id: this.workspaceId, item_id: itemId } }
-      })
-    );
-  }
-};
-
 // src/resources/recordings.ts
 var RecordingsResource = class extends WorkspaceScopedResource {
   async getUrls(callSid) {
@@ -6307,7 +6187,6 @@ var AmigoClient = class _AmigoClient {
   metrics;
   settings;
   billing;
-  reviewQueue;
   recordings;
   audit;
   compliance;
@@ -6448,7 +6327,6 @@ var AmigoClient = class _AmigoClient {
     mutable.metrics = new MetricsResource(client, workspaceId2);
     mutable.settings = new SettingsResource(client, workspaceId2);
     mutable.billing = new BillingResource(client, workspaceId2);
-    mutable.reviewQueue = new ReviewQueueResource(client, workspaceId2);
     mutable.recordings = new RecordingsResource(client, workspaceId2);
     mutable.audit = new AuditResource(client, workspaceId2);
     mutable.compliance = new ComplianceResource(client, workspaceId2);