@voicelayer/sdk 0.2.0 → 0.3.0

package/README.md

@@ -328,6 +328,14 @@ export DEEPGRAM_API_KEY=...
 node agent.ts start
 ```
 
+### Texts
+
+The same worker answers texts — SMS replies, Discord, your website's chat widget, the dashboard playground. `.start()`
+registers a second LiveKit name, `<name>::text`, beside the voice one; each message is dispatched to it and runs as
+your agent: its tools, security, connectors and model, with the conversation so far. Over text `ctx.call.callerId` is
+the sender, `ctx.call.metadata.mode` is `'text'`, and call-only methods (`handoff`, `endCall`, `ask`, DTMF) throw. In
+production the text registration's health server listens on `VL_TEXT_TURN_PORT` (default 8082).
+
 ---
 
 ## What's *not* in this SDK

package/dist/brain/index.d.ts

@@ -79,14 +79,14 @@ declare const ConnectorUpFrame: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     code: z.ZodEnum<["upstream_timeout", "upstream_error", "bad_response", "normalize_failed", "unreachable"]>;
     message: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    kind: "brain.error";
     code: "upstream_timeout" | "upstream_error" | "bad_response" | "normalize_failed" | "unreachable";
     message: string;
+    kind: "brain.error";
     streamId: string;
 }, {
-    kind: "brain.error";
     code: "upstream_timeout" | "upstream_error" | "bad_response" | "normalize_failed" | "unreachable";
     message: string;
+    kind: "brain.error";
     streamId: string;
 }>]>;
 type ConnectorUpFrame = z.infer<typeof ConnectorUpFrame>;

package/dist/brain/index.js

@@ -685,6 +685,10 @@ z.object({
   // 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
@@ -705,8 +709,8 @@ var AgentDTO = z.object({
   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.
@@ -932,6 +936,50 @@ z.object({
   code: z.string().max(64).optional(),
   detail: z.string().max(500).optional()
 });
+z.object({
+  mode: z.literal("text"),
+  turnId: z.string().uuid(),
+  projectId: z.string().min(1),
+  agentId: z.string().uuid()
+});
+var 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()
+});
+var 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()
+});
+var 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 = z.object({
   // Finite, vetted list — platform-level enum.
   provider: z.enum(["deepgram", "elevenlabs", "openai", "cartesia"]),