llmz 0.4.0 → 0.5.0

package/dist/index.cjs

@@ -10,14 +10,14 @@
 
 
 
-var _chunkQDPE3KRXcjs = require('./chunk-QDPE3KRX.cjs');
+var _chunk5WBNTV42cjs = require('./chunk-5WBNTV42.cjs');
 
 
 
 
 
 
-var _chunk7CH23XHWcjs = require('./chunk-7CH23XHW.cjs');
+var _chunkKTDBAJBBcjs = require('./chunk-KTDBAJBB.cjs');
 
 
 var _chunkRGUG3UMFcjs = require('./chunk-RGUG3UMF.cjs');
@@ -69,7 +69,7 @@ var _chunkGOWPACSKcjs = require('./chunk-GOWPACSK.cjs');
 var _chunkHC2QZTVTcjs = require('./chunk-HC2QZTVT.cjs');
 
 // package.json
-var version = "0.4.0";
+var version = "0.5.0";
 
 // src/objects.ts
 var _zui = require('@bpinternal/zui');
@@ -738,24 +738,10 @@ var Button = new (0, _chunkI56MPOVGcjs.Component)({
   description: "A button component that can perform actions when clicked",
   name: "Button",
   aliases: ["btn"],
-  examples: [
-    {
-      name: "Say action",
-      description: "A button that triggers a say action",
-      code: `yield <Message>
-  <Button action="say" label="Hello" />
-</Message>`
-    },
-    {
-      name: "Postback action",
-      description: "A button that sends a postback value",
-      code: `yield <Message>
-  Choose an option:
-  <Button action="postback" label="Buy" value="buy_product" />
-  <Button action="postback" label="Buy" value="buy_product2" />
-</Message>`
-    }
-  ],
+  generation: {
+    usage: "Attach quick actions to a message, e.g. postback choices or a URL to open.",
+    examples: [{ props: { action: "postback", label: "Buy", value: "buy_product" } }]
+  },
   leaf: {
     props: _zui.z.object({
       action: _zui.z.enum(["say", "url", "postback"]).default("say").describe('The action to perform when the button is clicked. Can be "say", "url", or "postback"'),
@@ -770,16 +756,9 @@ var Image = new (0, _chunkI56MPOVGcjs.Component)({
   name: "Image",
   description: "Displays an image from a URL.",
   aliases: [],
-  examples: [
-    {
-      name: "Basic image",
-      description: "A simple image with alt text",
-      code: `yield <Message>
-  An example image:
-  <Image url="https://example.com/photo.jpg" alt="Example image" />
-</Message>`
-    }
-  ],
+  generation: {
+    examples: [{ props: { url: "https://example.com/photo.jpg", alt: "Example image" } }]
+  },
   leaf: {
     props: _zui.z.object({
       url: _zui.z.string().describe("The URL of the image (must be valid)"),
@@ -792,16 +771,9 @@ var File = new (0, _chunkI56MPOVGcjs.Component)({
   name: "File",
   description: "Sends a downloadable file to the user.",
   aliases: [],
-  examples: [
-    {
-      name: "PDF download",
-      description: "Send a PDF file with a name",
-      code: `yield <Message>
-  Here is your report:
-  <File url="https://example.com/report.pdf" name="Report.pdf" />
-</Message>`
-    }
-  ],
+  generation: {
+    examples: [{ props: { url: "https://example.com/report.pdf", name: "Report.pdf" } }]
+  },
   leaf: {
     props: _zui.z.object({
       url: _zui.z.string().describe("The URL of the file (must be valid)"),
@@ -814,16 +786,9 @@ var Video = new (0, _chunkI56MPOVGcjs.Component)({
   name: "Video",
   description: "Embeds a video from a URL.",
   aliases: [],
-  examples: [
-    {
-      name: "Intro video",
-      description: "A video with a title",
-      code: `yield <Message>
-  Watch this video:
-  <Video url="https://example.com/intro.mp4" title="Welcome" />
-</Message>`
-    }
-  ],
+  generation: {
+    examples: [{ props: { url: "https://example.com/intro.mp4", title: "Welcome" } }]
+  },
   leaf: {
     props: _zui.z.object({
       url: _zui.z.string().describe("The URL of the video (must be valid)"),
@@ -836,16 +801,9 @@ var Audio = new (0, _chunkI56MPOVGcjs.Component)({
   name: "Audio",
   description: "Plays an audio clip from a URL.",
   aliases: [],
-  examples: [
-    {
-      name: "Sample audio",
-      description: "Play a short audio clip with a title",
-      code: `yield <Message>
-  Listen to this audio:
-  <Audio url="https://example.com/audio.mp3" title="Sample" />
-</Message>`
-    }
-  ],
+  generation: {
+    examples: [{ props: { url: "https://example.com/audio.mp3", title: "Sample" } }]
+  },
   leaf: {
     props: _zui.z.object({
       url: _zui.z.string().describe("The URL of the audio clip (must be valid)"),
@@ -858,20 +816,9 @@ var Card = new (0, _chunkI56MPOVGcjs.Component)({
   name: "Card",
   description: "A visual card component that can include an image and buttons.",
   aliases: [],
-  examples: [
-    {
-      name: "Product card",
-      description: "A card with an image and two buttons",
-      code: `yield <Message>
-  Featured product:
-  <Card title="Product Name" subtitle="Limited offer">
-    <Image url="https://example.com/product.jpg" alt="Product image" />
-    <Button action="postback" label="Buy" value="buy_product" />
-    <Button action="postback" label="Wishlist" value="wishlist" />
-  </Card>
-</Message>`
-    }
-  ],
+  generation: {
+    examples: [{ props: { title: "Product Name", subtitle: "Limited offer" }, body: "Featured product of the week." }]
+  },
   container: {
     props: _zui.z.object({
       title: _zui.z.string().min(1).max(250).describe("Title text (1\u2013250 characters)"),
@@ -894,25 +841,6 @@ var Carousel = new (0, _chunkI56MPOVGcjs.Component)({
   name: "Carousel",
   description: "A virtual container for displaying 1 to 10 Card components as a carousel.",
   aliases: [],
-  examples: [
-    {
-      name: "Product carousel",
-      description: "A carousel with multiple cards",
-      code: `yield <Message>
-  Here are some products you might like:
-  <Carousel>
-    <Card title="Item 1" subtitle="First product">
-      <Image url="https://example.com/item1.jpg" alt="Item 1" />
-      <Button action="postback" label="Buy" value="buy_1" />
-    </Card>
-    <Card title="Item 2" subtitle="Second product">
-      <Image url="https://example.com/item2.jpg" alt="Item 2" />
-      <Button action="postback" label="Buy" value="buy_2" />
-    </Card>
-  </Carousel>
-</Message>`
-    }
-  ],
   container: {
     props: _zui.z.object({}),
     children: [
@@ -927,16 +855,46 @@ var Text = new (0, _chunkI56MPOVGcjs.Component)({
   type: "default",
   name: "Message",
   aliases: ["Text", "Markdown"],
-  description: "A Markdown-formatted text message.",
-  examples: [
-    {
-      name: "Basic Markdown",
-      description: "Simple markdown content inside a message",
-      code: `yield <Message>
-  **Hello**, welcome to our service!
-</Message>`
-    }
-  ],
+  description: "A Markdown-formatted text message. Long answers are written the same way: plain Markdown prose.",
+  generation: {
+    examples: [
+      // A long-form example matters: models shown only short bodies have been
+      // observed drifting into JSON-wrapping long replies ({"body": "..."})
+      {
+        body: `Great question! Deploying happens in three steps.
+
+First, connect your repository from the dashboard \u2014 we support GitHub and GitLab. Once connected, every push to your main branch triggers a build automatically.
+
+Then configure your build settings:
+
+- **Build command** \u2014 usually \`npm run build\`
+- **Output directory** \u2014 where the compiled assets end up
+
+Finally, hit **Deploy**. The first build takes a couple of minutes; subsequent ones are incremental and much faster. Want me to walk you through connecting your repository?`
+      },
+      { body: "**Hello**, welcome to our service!" }
+    ]
+  },
+  default: {
+    props: _zui.z.object({}),
+    children: []
+  }
+});
+var Speech = new (0, _chunkI56MPOVGcjs.Component)({
+  type: "default",
+  name: "Speech",
+  aliases: ["speak", "spoken"],
+  description: "A message spoken aloud to the user via text-to-speech.",
+  body: {
+    format: "text",
+    description: 'Plain conversational prose only, written to be read aloud: no Markdown, no links or URLs, no emojis, no code, no bullet points, tables or headings. Write everything the way it should be pronounced \u2014 spell out numbers, dates, units and abbreviations (e.g. "June third at three thirty PM", not "06/03 @ 3:30pm").'
+  },
+  generation: {
+    usage: "Use when the reply will be played back as audio (voice conversations).",
+    examples: [
+      { body: "Sure! Your order shipped this morning and should arrive on Tuesday, June third, around noon." }
+    ]
+  },
   default: {
     props: _zui.z.object({}),
     children: []
@@ -950,7 +908,8 @@ var DefaultComponents = {
   Audio,
   Card,
   Carousel,
-  Text
+  Text,
+  Speech
 };
 
 // src/chat.ts
@@ -1167,7 +1126,7 @@ var SendResponse = class extends BaseResponse {
     return this.item.props;
   }
   static formatToText(component, props, body) {
-    const header = `${_chunk7CH23XHWcjs.MARKER}send=${component}${props && Object.keys(props).length ? ` ${JSON.stringify(props)}` : ""}`;
+    const header = `${_chunkKTDBAJBBcjs.MARKER}send=${component}${props && Object.keys(props).length ? ` ${JSON.stringify(props)}` : ""}`;
     return body ? `${header}
 ${body}` : header;
   }
@@ -1178,7 +1137,7 @@ var RunResponse = class extends BaseResponse {
     this.code = code;
   }
   static formatToText(code) {
-    return `${_chunk7CH23XHWcjs.MARKER}run
+    return `${_chunkKTDBAJBBcjs.MARKER}run
 ${code}`;
   }
 };
@@ -1193,7 +1152,7 @@ var NextResponse = class extends BaseResponse {
     return this.item.props;
   }
   static formatToText(name, props) {
-    return `${_chunk7CH23XHWcjs.MARKER}next=${name}${props && Object.keys(props).length ? ` ${JSON.stringify(props)}` : ""}`;
+    return `${_chunkKTDBAJBBcjs.MARKER}next=${name}${props && Object.keys(props).length ? ` ${JSON.stringify(props)}` : ""}`;
   }
 };
 var EventPump = (_class3 = class {
@@ -1250,7 +1209,7 @@ function parseText(text, options) {
   );
 }
 async function* parseResponses(stream, options) {
-  const parser = new (0, _chunk7CH23XHWcjs.StreamingMessageParser)(options);
+  const parser = new (0, _chunkKTDBAJBBcjs.StreamingMessageParser)(options);
   const pump = new EventPump(stream, parser);
   let activeBody;
   while (true) {
@@ -1307,7 +1266,7 @@ var ComponentRegistry = (_class4 = class {
     }
   }
   register(definition) {
-    if (!_chunk7CH23XHWcjs.NAME_REGEX.test(definition.name)) {
+    if (!_chunkKTDBAJBBcjs.NAME_REGEX.test(definition.name)) {
       throw new Error(
         `Invalid component name "${definition.name}". Component names must be lowercase ([a-z][a-z0-9_-]*).`
       );
@@ -1334,7 +1293,7 @@ var EMPTY_PROPS_SCHEMA = { type: "object", properties: {}, additionalProperties:
 var normalizeComponentName = (name) => name.trim().toLowerCase();
 function normalizeComponentDefinition(definition) {
   const name = normalizeComponentName(_nullishCoalesce(definition.name, () => ( "")));
-  if (!_chunk7CH23XHWcjs.NAME_REGEX.test(name)) {
+  if (!_chunkKTDBAJBBcjs.NAME_REGEX.test(name)) {
     throw new Error(
       `Invalid component name "${definition.name}". Component names must be lowercase ([a-z][a-z0-9_-]*).`
     );
@@ -1516,7 +1475,7 @@ var _checkValue = (value, schema, path, errors) => {
 };
 
 // src/message-stream/sanitize.ts
-var sanitizeMessageText = (value, options = {}) => value.replaceAll(_chunk7CH23XHWcjs.MARKER, _nullishCoalesce(options.markerReplacement, () => ( "\u25AA")));
+var sanitizeMessageText = (value, options = {}) => value.replaceAll(_chunkKTDBAJBBcjs.MARKER, _nullishCoalesce(options.markerReplacement, () => ( "\u25AA")));
 
 // src/index.ts
 var utils = {
@@ -1527,11 +1486,11 @@ var utils = {
   stripTruncationTags: _chunkHEAQAEFZcjs.stripTruncationTags
 };
 var execute = async (props) => {
-  const { executeContext } = await Promise.resolve().then(() => _interopRequireWildcard(require("./execute-KHQ45ANS.cjs")));
+  const { executeContext } = await Promise.resolve().then(() => _interopRequireWildcard(require("./execute-IK6O4SU2.cjs")));
   return executeContext(props);
 };
 var init = async () => {
-  await Promise.resolve().then(() => _interopRequireWildcard(require("./execute-KHQ45ANS.cjs")));
+  await Promise.resolve().then(() => _interopRequireWildcard(require("./execute-IK6O4SU2.cjs")));
   await Promise.resolve().then(() => _interopRequireWildcard(require("./component-2NYFY6CW.cjs")));
   await Promise.resolve().then(() => _interopRequireWildcard(require("./tool-VE2YHIY2.cjs")));
   await Promise.resolve().then(() => _interopRequireWildcard(require("./exit-MX56VN2C.cjs")));
@@ -1540,7 +1499,7 @@ var init = async () => {
   await Promise.resolve().then(() => _interopRequireWildcard(require("./utils-ITB4NEL7.cjs")));
   await Promise.resolve().then(() => _interopRequireWildcard(require("./truncator-FZNLYSDL.cjs")));
   await Promise.resolve().then(() => _interopRequireWildcard(require("./typings-LQOBZXSO.cjs")));
-  await Promise.resolve().then(() => _interopRequireWildcard(require("./dual-modes-FWUVU6C7.cjs")));
+  await Promise.resolve().then(() => _interopRequireWildcard(require("./dual-modes-TCMWBZIH.cjs")));
 };
 
 
@@ -1593,4 +1552,4 @@ var init = async () => {
 
 
 
-exports.BaseResponse = BaseResponse; exports.Chat = Chat; exports.CitationsManager = CitationsManager; exports.Component = _chunkI56MPOVGcjs.Component; exports.ComponentRegistry = ComponentRegistry; exports.DefaultComponents = DefaultComponents; exports.DefaultExit = _chunkQDPE3KRXcjs.DefaultExit; exports.ErrorExecutionResult = _chunkQDPE3KRXcjs.ErrorExecutionResult; exports.ExecutionResult = _chunkQDPE3KRXcjs.ExecutionResult; exports.Exit = _chunkDDSJTR6Qcjs.Exit; exports.ListenExit = _chunkQDPE3KRXcjs.ListenExit; exports.LoopExceededError = _chunkPK72FAKDcjs.LoopExceededError; exports.MARKER = _chunk7CH23XHWcjs.MARKER; exports.NAME_REGEX = _chunk7CH23XHWcjs.NAME_REGEX; exports.NextResponse = NextResponse; exports.ObjectInstance = ObjectInstance; exports.PartialExecutionResult = _chunkQDPE3KRXcjs.PartialExecutionResult; exports.ReplayableAsyncIterable = ReplayableAsyncIterable; exports.RunResponse = RunResponse; exports.SendResponse = SendResponse; exports.Snapshot = _chunkQDPE3KRXcjs.Snapshot; exports.SnapshotSignal = _chunkPK72FAKDcjs.SnapshotSignal; exports.StreamingMessageParser = _chunk7CH23XHWcjs.StreamingMessageParser; exports.SuccessExecutionResult = _chunkQDPE3KRXcjs.SuccessExecutionResult; exports.ThinkExit = _chunkQDPE3KRXcjs.ThinkExit; exports.ThinkSignal = _chunkPK72FAKDcjs.ThinkSignal; exports.Tool = _chunkPZE6PIPGcjs.Tool; exports._CustomModelClient = _chunkQDPE3KRXcjs._CustomModelClient; exports.assertValidComponent = _chunkI56MPOVGcjs.assertValidComponent; exports.collectText = collectText; exports.configureQuickJS = _chunkRGUG3UMFcjs.configureQuickJS; exports.configureTokenizer = _chunkGOWPACSKcjs.configureTokenizer; exports.execute = execute; exports.generateInstructions = _chunk7CH23XHWcjs.generateInstructions; exports.getValue = _chunkQDPE3KRXcjs.getValue; exports.init = init; exports.isAnyComponent = _chunkI56MPOVGcjs.isAnyComponent; exports.isComponent = _chunkI56MPOVGcjs.isComponent; exports.normalizeComponentDefinition = normalizeComponentDefinition; exports.normalizeComponentName = normalizeComponentName; exports.normalizePropsSchema = normalizePropsSchema; exports.parseExit = _chunkQDPE3KRXcjs.parseExit; exports.parseStream = parseStream; exports.parseText = parseText; exports.sanitizeMessageText = sanitizeMessageText; exports.tryParseJson = _chunk7CH23XHWcjs.tryParseJson; exports.utils = utils; exports.validateComponent = validateComponent; exports.validateProps = validateProps; exports.version = version;
+exports.BaseResponse = BaseResponse; exports.Chat = Chat; exports.CitationsManager = CitationsManager; exports.Component = _chunkI56MPOVGcjs.Component; exports.ComponentRegistry = ComponentRegistry; exports.DefaultComponents = DefaultComponents; exports.DefaultExit = _chunk5WBNTV42cjs.DefaultExit; exports.ErrorExecutionResult = _chunk5WBNTV42cjs.ErrorExecutionResult; exports.ExecutionResult = _chunk5WBNTV42cjs.ExecutionResult; exports.Exit = _chunkDDSJTR6Qcjs.Exit; exports.ListenExit = _chunk5WBNTV42cjs.ListenExit; exports.LoopExceededError = _chunkPK72FAKDcjs.LoopExceededError; exports.MARKER = _chunkKTDBAJBBcjs.MARKER; exports.NAME_REGEX = _chunkKTDBAJBBcjs.NAME_REGEX; exports.NextResponse = NextResponse; exports.ObjectInstance = ObjectInstance; exports.PartialExecutionResult = _chunk5WBNTV42cjs.PartialExecutionResult; exports.ReplayableAsyncIterable = ReplayableAsyncIterable; exports.RunResponse = RunResponse; exports.SendResponse = SendResponse; exports.Snapshot = _chunk5WBNTV42cjs.Snapshot; exports.SnapshotSignal = _chunkPK72FAKDcjs.SnapshotSignal; exports.StreamingMessageParser = _chunkKTDBAJBBcjs.StreamingMessageParser; exports.SuccessExecutionResult = _chunk5WBNTV42cjs.SuccessExecutionResult; exports.ThinkExit = _chunk5WBNTV42cjs.ThinkExit; exports.ThinkSignal = _chunkPK72FAKDcjs.ThinkSignal; exports.Tool = _chunkPZE6PIPGcjs.Tool; exports._CustomModelClient = _chunk5WBNTV42cjs._CustomModelClient; exports.assertValidComponent = _chunkI56MPOVGcjs.assertValidComponent; exports.collectText = collectText; exports.configureQuickJS = _chunkRGUG3UMFcjs.configureQuickJS; exports.configureTokenizer = _chunkGOWPACSKcjs.configureTokenizer; exports.execute = execute; exports.generateInstructions = _chunkKTDBAJBBcjs.generateInstructions; exports.getValue = _chunk5WBNTV42cjs.getValue; exports.init = init; exports.isAnyComponent = _chunkI56MPOVGcjs.isAnyComponent; exports.isComponent = _chunkI56MPOVGcjs.isComponent; exports.normalizeComponentDefinition = normalizeComponentDefinition; exports.normalizeComponentName = normalizeComponentName; exports.normalizePropsSchema = normalizePropsSchema; exports.parseExit = _chunk5WBNTV42cjs.parseExit; exports.parseStream = parseStream; exports.parseText = parseText; exports.sanitizeMessageText = sanitizeMessageText; exports.tryParseJson = _chunkKTDBAJBBcjs.tryParseJson; exports.utils = utils; exports.validateComponent = validateComponent; exports.validateProps = validateProps; exports.version = version;

package/dist/index.js

@@ -10,14 +10,14 @@ import {
   _CustomModelClient,
   getValue,
   parseExit
-} from "./chunk-VC5IEFWI.js";
+} from "./chunk-4POZJQXN.js";
 import {
   MARKER,
   NAME_REGEX,
   StreamingMessageParser,
   generateInstructions,
   tryParseJson
-} from "./chunk-Q673NO2A.js";
+} from "./chunk-LOX7GOR6.js";
 import {
   configureQuickJS
 } from "./chunk-UGHFNCPD.js";
@@ -69,7 +69,7 @@ import {
 } from "./chunk-34GJUS6U.js";
 
 // package.json
-var version = "0.4.0";
+var version = "0.5.0";
 
 // src/objects.ts
 import { z } from "@bpinternal/zui";
@@ -738,24 +738,10 @@ var Button = new Component({
   description: "A button component that can perform actions when clicked",
   name: "Button",
   aliases: ["btn"],
-  examples: [
-    {
-      name: "Say action",
-      description: "A button that triggers a say action",
-      code: `yield <Message>
-  <Button action="say" label="Hello" />
-</Message>`
-    },
-    {
-      name: "Postback action",
-      description: "A button that sends a postback value",
-      code: `yield <Message>
-  Choose an option:
-  <Button action="postback" label="Buy" value="buy_product" />
-  <Button action="postback" label="Buy" value="buy_product2" />
-</Message>`
-    }
-  ],
+  generation: {
+    usage: "Attach quick actions to a message, e.g. postback choices or a URL to open.",
+    examples: [{ props: { action: "postback", label: "Buy", value: "buy_product" } }]
+  },
   leaf: {
     props: z2.object({
       action: z2.enum(["say", "url", "postback"]).default("say").describe('The action to perform when the button is clicked. Can be "say", "url", or "postback"'),
@@ -770,16 +756,9 @@ var Image = new Component({
   name: "Image",
   description: "Displays an image from a URL.",
   aliases: [],
-  examples: [
-    {
-      name: "Basic image",
-      description: "A simple image with alt text",
-      code: `yield <Message>
-  An example image:
-  <Image url="https://example.com/photo.jpg" alt="Example image" />
-</Message>`
-    }
-  ],
+  generation: {
+    examples: [{ props: { url: "https://example.com/photo.jpg", alt: "Example image" } }]
+  },
   leaf: {
     props: z2.object({
       url: z2.string().describe("The URL of the image (must be valid)"),
@@ -792,16 +771,9 @@ var File = new Component({
   name: "File",
   description: "Sends a downloadable file to the user.",
   aliases: [],
-  examples: [
-    {
-      name: "PDF download",
-      description: "Send a PDF file with a name",
-      code: `yield <Message>
-  Here is your report:
-  <File url="https://example.com/report.pdf" name="Report.pdf" />
-</Message>`
-    }
-  ],
+  generation: {
+    examples: [{ props: { url: "https://example.com/report.pdf", name: "Report.pdf" } }]
+  },
   leaf: {
     props: z2.object({
       url: z2.string().describe("The URL of the file (must be valid)"),
@@ -814,16 +786,9 @@ var Video = new Component({
   name: "Video",
   description: "Embeds a video from a URL.",
   aliases: [],
-  examples: [
-    {
-      name: "Intro video",
-      description: "A video with a title",
-      code: `yield <Message>
-  Watch this video:
-  <Video url="https://example.com/intro.mp4" title="Welcome" />
-</Message>`
-    }
-  ],
+  generation: {
+    examples: [{ props: { url: "https://example.com/intro.mp4", title: "Welcome" } }]
+  },
   leaf: {
     props: z2.object({
       url: z2.string().describe("The URL of the video (must be valid)"),
@@ -836,16 +801,9 @@ var Audio = new Component({
   name: "Audio",
   description: "Plays an audio clip from a URL.",
   aliases: [],
-  examples: [
-    {
-      name: "Sample audio",
-      description: "Play a short audio clip with a title",
-      code: `yield <Message>
-  Listen to this audio:
-  <Audio url="https://example.com/audio.mp3" title="Sample" />
-</Message>`
-    }
-  ],
+  generation: {
+    examples: [{ props: { url: "https://example.com/audio.mp3", title: "Sample" } }]
+  },
   leaf: {
     props: z2.object({
       url: z2.string().describe("The URL of the audio clip (must be valid)"),
@@ -858,20 +816,9 @@ var Card = new Component({
   name: "Card",
   description: "A visual card component that can include an image and buttons.",
   aliases: [],
-  examples: [
-    {
-      name: "Product card",
-      description: "A card with an image and two buttons",
-      code: `yield <Message>
-  Featured product:
-  <Card title="Product Name" subtitle="Limited offer">
-    <Image url="https://example.com/product.jpg" alt="Product image" />
-    <Button action="postback" label="Buy" value="buy_product" />
-    <Button action="postback" label="Wishlist" value="wishlist" />
-  </Card>
-</Message>`
-    }
-  ],
+  generation: {
+    examples: [{ props: { title: "Product Name", subtitle: "Limited offer" }, body: "Featured product of the week." }]
+  },
   container: {
     props: z2.object({
       title: z2.string().min(1).max(250).describe("Title text (1\u2013250 characters)"),
@@ -894,25 +841,6 @@ var Carousel = new Component({
   name: "Carousel",
   description: "A virtual container for displaying 1 to 10 Card components as a carousel.",
   aliases: [],
-  examples: [
-    {
-      name: "Product carousel",
-      description: "A carousel with multiple cards",
-      code: `yield <Message>
-  Here are some products you might like:
-  <Carousel>
-    <Card title="Item 1" subtitle="First product">
-      <Image url="https://example.com/item1.jpg" alt="Item 1" />
-      <Button action="postback" label="Buy" value="buy_1" />
-    </Card>
-    <Card title="Item 2" subtitle="Second product">
-      <Image url="https://example.com/item2.jpg" alt="Item 2" />
-      <Button action="postback" label="Buy" value="buy_2" />
-    </Card>
-  </Carousel>
-</Message>`
-    }
-  ],
   container: {
     props: z2.object({}),
     children: [
@@ -927,16 +855,46 @@ var Text = new Component({
   type: "default",
   name: "Message",
   aliases: ["Text", "Markdown"],
-  description: "A Markdown-formatted text message.",
-  examples: [
-    {
-      name: "Basic Markdown",
-      description: "Simple markdown content inside a message",
-      code: `yield <Message>
-  **Hello**, welcome to our service!
-</Message>`
-    }
-  ],
+  description: "A Markdown-formatted text message. Long answers are written the same way: plain Markdown prose.",
+  generation: {
+    examples: [
+      // A long-form example matters: models shown only short bodies have been
+      // observed drifting into JSON-wrapping long replies ({"body": "..."})
+      {
+        body: `Great question! Deploying happens in three steps.
+
+First, connect your repository from the dashboard \u2014 we support GitHub and GitLab. Once connected, every push to your main branch triggers a build automatically.
+
+Then configure your build settings:
+
+- **Build command** \u2014 usually \`npm run build\`
+- **Output directory** \u2014 where the compiled assets end up
+
+Finally, hit **Deploy**. The first build takes a couple of minutes; subsequent ones are incremental and much faster. Want me to walk you through connecting your repository?`
+      },
+      { body: "**Hello**, welcome to our service!" }
+    ]
+  },
+  default: {
+    props: z2.object({}),
+    children: []
+  }
+});
+var Speech = new Component({
+  type: "default",
+  name: "Speech",
+  aliases: ["speak", "spoken"],
+  description: "A message spoken aloud to the user via text-to-speech.",
+  body: {
+    format: "text",
+    description: 'Plain conversational prose only, written to be read aloud: no Markdown, no links or URLs, no emojis, no code, no bullet points, tables or headings. Write everything the way it should be pronounced \u2014 spell out numbers, dates, units and abbreviations (e.g. "June third at three thirty PM", not "06/03 @ 3:30pm").'
+  },
+  generation: {
+    usage: "Use when the reply will be played back as audio (voice conversations).",
+    examples: [
+      { body: "Sure! Your order shipped this morning and should arrive on Tuesday, June third, around noon." }
+    ]
+  },
   default: {
     props: z2.object({}),
     children: []
@@ -950,7 +908,8 @@ var DefaultComponents = {
   Audio,
   Card,
   Carousel,
-  Text
+  Text,
+  Speech
 };
 
 // src/chat.ts
@@ -1527,11 +1486,11 @@ var utils = {
   stripTruncationTags
 };
 var execute = async (props) => {
-  const { executeContext } = await import("./execute-4RIQATCY.js");
+  const { executeContext } = await import("./execute-FF7D46TY.js");
   return executeContext(props);
 };
 var init = async () => {
-  await import("./execute-4RIQATCY.js");
+  await import("./execute-FF7D46TY.js");
   await import("./component-ASNZHQUR.js");
   await import("./tool-KD7FL45V.js");
   await import("./exit-UQ3EUX5D.js");
@@ -1540,7 +1499,7 @@ var init = async () => {
   await import("./utils-IATCUNKF.js");
   await import("./truncator-73RCL52Y.js");
   await import("./typings-E2RROCLT.js");
-  await import("./dual-modes-KZYB4L4M.js");
+  await import("./dual-modes-S5TJ5JVJ.js");
 };
 export {
   BaseResponse,