@gravity-rail/sdk 0.21.0 → 0.32.0

package/README.md

@@ -197,14 +197,6 @@ await client.upsertDataRecord(workspaceId, dataType.id, {
 ### Communication Channels
 
 ```typescript
-// Phone — initiate an outbound AI voice call
-const numbers = await client.getPhoneNumbers(workspaceId);
-await client.initiateCall(workspaceId, {
-  phone_number_id: numbers[0].id,
-  to_number: '+15551234567',
-  workflow_id: workflowId,
-});
-
 // Email — manage inboxes and threads
 const inboxes = await client.getInboxes(workspaceId);
 const threads = await client.getInboxThreads(workspaceId, inboxes[0].id);
@@ -353,6 +345,13 @@ await client.crawlSite(workspaceId, site.id, { url: 'https://docs.example.com' }
 ### Workspace Management
 
 ```typescript
+// Workspaces this credential can reach
+const workspaces = await client.getWorkspaces();
+
+// Companion-device picker (Lantern): compact rows for only the
+// workspaces a paired device could enter — no device credential needed
+const deviceWorkspaces = await client.getDeviceAdmissibleWorkspaces();
+
 // Export/import full workspace configuration
 const config = await client.exportWorkspace(workspaceId);
 const preview = await client.previewWorkspaceImport(targetId, config);
@@ -480,3 +479,53 @@ configured for that use.
 ## License
 
 MIT
+
+### Changing interaction mode within a Chat
+
+A Chat retains its transport while an interaction session selects text,
+push-to-talk, or realtime bidirectional voice. Keep one controller per client
+session and Chat; independent devices should use separate controllers.
+
+```ts
+import { ChatInteractionController } from '@gravity-rail/sdk';
+
+const interaction = new ChatInteractionController(client, workspaceId, chatId);
+const textSession = await interaction.ensure('text');
+const recordedVoiceSession = await interaction.ensure('push_to_talk');
+```
+
+Pass the selected session's `id` as `interactionSessionId` and a new UUID as
+`interactionTurnId` on an AG-UI user turn. Send both fields together. The server
+checks the Chat and authenticated actor and derives the mode from the stored
+session. The controller serializes transitions and reuses request IDs after
+uncertain network failures. Session metadata does not itself open a microphone
+or establish a realtime connection.
+
+New browser Chat creation accepts `interactionMode: 'realtime'` for an initial
+voice greeting while retaining `channel: 'web-chat'`. `browserChannel` remains a
+deprecated create-only alias. Omit both provenance fields for legacy AG-UI
+clients; historical Messages are not assigned a mode by guessing from channel
+or content. Message responses expose nullable `interactionSessionId`,
+`interactionMode`, and `interactionTurnId` so audio and transcript components
+can follow the same logical turn.
+
+### Converting a Start Task opening message
+
+The workflow client exposes the conservative, draft-only opening conversion.
+Inspect eligibility first, then pass the reported rule id back as an optimistic
+concurrency guard:
+
+```ts
+const report = await client.getWorkflowOpeningTurnConversionReport(workspaceId, workflowId);
+if (report.canConvert && report.convertibleRuleId !== null) {
+  await client.convertWorkflowStartTaskOpeningMessage(
+    workspaceId,
+    workflowId,
+    report.convertibleRuleId
+  );
+}
+```
+
+Conversion refuses multiple emitters, conditional or templated messages,
+direction variants, conflicting Greeting defaults, and other shapes that
+cannot be moved without changing behavior.

package/dist/agui.d.cts

@@ -1,4 +1,4 @@
-import { C as ChannelEvent } from './types-DkYyrvoC.cjs';
+import { C as ChannelEvent } from './types-0c6_NGU4.cjs';
 
 interface TranscriptMessage {
     id: string;

package/dist/agui.d.ts

@@ -1,4 +1,4 @@
-import { C as ChannelEvent } from './types-DkYyrvoC.js';
+import { C as ChannelEvent } from './types-0c6_NGU4.js';
 
 interface TranscriptMessage {
     id: string;

package/dist/audio.d.cts

@@ -1,4 +1,4 @@
-import { C as ChannelEvent } from './types-DkYyrvoC.cjs';
+import { C as ChannelEvent } from './types-0c6_NGU4.cjs';
 
 /** PCM16 helpers aligned with main-app web voice (24 kHz). */
 declare const SERVER_SAMPLE_RATE = 24000;

package/dist/audio.d.ts

@@ -1,4 +1,4 @@
-import { C as ChannelEvent } from './types-DkYyrvoC.js';
+import { C as ChannelEvent } from './types-0c6_NGU4.js';
 
 /** PCM16 helpers aligned with main-app web voice (24 kHz). */
 declare const SERVER_SAMPLE_RATE = 24000;