@voicelayer/sdk 0.2.0 → 0.3.1

package/dist/runtime/text-session.d.ts

@@ -1,4 +1,4 @@
-export { ab as GraphTraceEvent, ac as LiveTextConversation, ad as LiveTurnResult, ae as RunLiveTextOptions, u as RunTextSessionOptions, v as RunTextTranscriptOptions, V as TextSession, W as TextTranscriptResult, af as runLiveTextConversation, a8 as runTextSession, a9 as runTextTranscript, ag as runWithOpenAIScope } from '../text-session-BqMWaNsN.js';
+export { ab as GraphTraceEvent, ac as LiveTextConversation, ad as LiveTurnResult, ae as RunLiveTextOptions, u as RunTextSessionOptions, v as RunTextTranscriptOptions, V as TextSession, W as TextTranscriptResult, af as runLiveTextConversation, a8 as runTextSession, a9 as runTextTranscript, ag as runWithOpenAIScope } from '../text-session-oMqJh6SF.js';
 import '@livekit/agents';
 import 'zod';
 import 'openai';

package/dist/runtime/text-session.js

@@ -493,6 +493,10 @@ var init_agents = __esm({
       // fail registration outright (which agent.ts swallows → agent runs but never
       // registers/heartbeats).
       prompt: z.string().max(64e3).nullable().optional(),
+      // The text-turn protocol this worker speaks (burn-down G-4): it registers `<name>::text` and runs text turns as the
+      // agent. Absent = it can't (an older SDK, a puppet, a flow pool) — stored as null, so a downgrade stops text turns.
+      // Any version is accepted (a newer SDK never fails registration); the API decides which versions it dispatches to.
+      textTurns: z.number().int().min(1).max(1e3).optional(),
       // Opt into MCP exposure. When true the API upserts a matching agent_config
       // row keyed by (project_id, name, environment) so MCP / dashboard / REST
       // can list and inspect this agent's identity. When false / omitted, the
@@ -513,8 +517,8 @@ var init_agents = __esm({
       metadata: AgentMetadata,
       processSchema: ProcessSchemaDTO.nullable().optional(),
       // Whether this agent can run through the engine over text: a flow agent (its
-      // compiled graph rides in processSchema.program) OR a code-first agent whose
-      // base prompt was synced on register. Drives the dashboard's chat gate so it
+      // compiled graph rides in processSchema.program), a brain-connector agent, OR a
+      // code-first agent whose worker takes text turns (G-4). Drives the dashboard's chat gate so it
       // no longer hard-codes "flow only". Computed server-side; not stored. OPTIONAL
       // on the wire so a new worker validating a response from an OLD api pod during
       // a rolling deploy doesn't fail register/heartbeat on a missing field.
@@ -539,7 +543,12 @@ var init_agents = __esm({
     z.object({
       status: z.enum(["online", "degraded"]).optional(),
       statusDetail: z.string().max(512).optional(),
-      metadata: AgentMetadata.optional()
+      metadata: AgentMetadata.optional(),
+      // The text-turn protocol the worker speaks (G-4), repeated on every heartbeat: a registration answered by an older API
+      // during a rollout drops the field, and the next heartbeat restores it. SDK ≥ 0.3.1 always sends it — `null` when the
+      // worker takes no text turns, so a leftover beat can't keep a stale "text-capable" alive either. Absent (an older SDK)
+      // leaves the stored value as is.
+      textTurns: z.number().int().min(1).max(1e3).nullable().optional()
     });
     z.object({
       agent: AgentDTO,
@@ -756,6 +765,55 @@ var init_call_events = __esm({
     });
   }
 });
+var TextTurnHistoryEntry, TextTurnUsage, TextTurnErrorCode;
+var init_text_turns = __esm({
+  "../contracts/src/text-turns.ts"() {
+    z.object({
+      mode: z.literal("text"),
+      turnId: z.string().uuid(),
+      projectId: z.string().min(1),
+      agentId: z.string().uuid()
+    });
+    TextTurnHistoryEntry = z.object({
+      role: z.enum(["user", "assistant"]),
+      content: z.string().max(16e3)
+    });
+    z.object({
+      turnId: z.string().uuid(),
+      agentId: z.string().uuid(),
+      /** The Line the message came in on (`sms`, `discord`, `web`, `playground`, …). */
+      channel: z.string().min(1).max(40),
+      /** The sender on that Line (phone number, Discord user, widget visitor) — the agent's caller-scoped memory key. */
+      from: z.string().min(1).max(200),
+      /** The conversation this turn belongs to (stable across turns) — the tool context's call id. */
+      conversationKey: z.string().min(1).max(300),
+      history: z.array(TextTurnHistoryEntry).max(80),
+      text: z.string().min(1).max(8e3),
+      /** When the API stops waiting; the worker stops the run before it. */
+      deadlineAt: z.string().datetime()
+    });
+    TextTurnUsage = z.object({
+      provider: z.string().min(1).max(60),
+      model: z.string().min(1).max(200),
+      inputTokens: z.number().int().nonnegative(),
+      outputTokens: z.number().int().nonnegative(),
+      /** Only a first-party worker's label is used; a customer's worker runs on its own key (the API decides). */
+      byok: z.boolean()
+    });
+    TextTurnErrorCode = z.enum(["agent_unavailable", "agent_timeout"]);
+    z.union([
+      z.object({
+        agentId: z.string().uuid(),
+        replies: z.array(z.string().max(16e3)).max(20),
+        usage: z.array(TextTurnUsage).max(50).default([])
+      }),
+      z.object({
+        agentId: z.string().uuid(),
+        error: z.object({ code: TextTurnErrorCode, detail: z.string().max(500).optional() })
+      })
+    ]);
+  }
+});
 var VoiceConfig, ModelConfig, SttConfig, RealtimeConfig, PipelineMode, ToolBinding, ProcessFieldType, ProcessFieldSpec, ProcessCompleteWhen, ProcessBackendAckSpec, ProcessSpec, TriggerConditionSpec, TriggerActionSpec, TriggerSpec, RequiredInfoField, AgentConfig;
 var init_agent_config = __esm({
   "../contracts/src/agent-config.ts"() {
@@ -3441,6 +3499,7 @@ var init_src = __esm({
     init_agents();
     init_process_state();
     init_call_events();
+    init_text_turns();
     init_call_plan();
     init_memory();
     init_participants();

package/dist/{text-session-BqMWaNsN.d.ts → text-session-oMqJh6SF.d.ts}

@@ -191,6 +191,12 @@ interface SessionFactoryInput {
     /** Connector-brain agent: disable preemptive generation (a multi-second remote
      *  turn otherwise regenerates on the final transcript and drops the reply). */
     readonly connectorAgentMode?: boolean;
+    /**
+     * The SecurityPrimitive wraps this session (SecureAgent): preemptive generation is off. It would send the raw,
+     * unsealed transcript (PII included) to the model before the input guard runs — and its reply is always discarded,
+     * since the guard rewrites the message it was generated from.
+     */
+    readonly secured?: boolean;
     readonly captureDtmf: boolean;
     readonly pipeline?: {
         readonly stt?: unknown;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voicelayer/sdk",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Official SDK for VoiceLayer — define, run, and orchestrate voice AI agents on the VoiceLayer control plane.",
   "license": "Apache-2.0",
   "author": "VoiceLayer",
@@ -80,15 +80,15 @@
     "vitest": "^4.1.5",
     "@voicelayer/contracts": "0.1.0",
     "@voicelayer/llm-client": "0.1.0",
-    "@voicelayer/primitive-audio-experience": "0.1.0",
     "@voicelayer/observability": "0.1.0",
+    "@voicelayer/primitive-audio-experience": "0.1.0",
     "@voicelayer/primitive-audio-routing": "0.1.0",
+    "@voicelayer/primitive-process-schema": "0.1.0",
     "@voicelayer/primitive-security": "0.1.0",
+    "@voicelayer/agents-plugin-deepgram": "1.0.1",
     "@voicelayer/agents-plugin-livekit": "1.0.1",
-    "@voicelayer/agents-plugin-openai": "1.0.1",
     "@voicelayer/agents-plugin-silero": "1.0.1",
-    "@voicelayer/primitive-process-schema": "0.1.0",
-    "@voicelayer/agents-plugin-deepgram": "1.0.1"
+    "@voicelayer/agents-plugin-openai": "1.0.1"
   },
   "scripts": {
     "typecheck": "tsc -b --pretty false",