llmz 0.7.1 → 0.8.0

package/dist/index.js

@@ -1,16 +1,17 @@
-import { a as StreamingMessageParser, c as NAME_REGEX, o as tryParseJson, r as generateInstructions, s as MARKER } from "./dual-modes-mNyMThtf.js";
-import { a as ThinkExit, c as ExecutionResult, d as Snapshot, f as parseExit, i as ListenExit, l as PartialExecutionResult, o as getValue, r as DefaultExit, s as ErrorExecutionResult, t as _CustomModelClient, u as SuccessExecutionResult } from "./custom-client-CMuy7fXU.js";
+import { a as StreamingMessageParser, c as NAME_REGEX, o as tryParseJson, s as MARKER } from "./common-pgJjFu2Y.js";
+import { a as Example, h as ComponentRegistry, m as validateProps, o as generateInstructions, p as validateComponent, s as DefaultComponents } from "./dual-modes-Cy0_W4O2.js";
+import { a as ThinkExit, c as ExecutionResult, d as Snapshot, f as parseExit, i as ListenExit, l as PartialExecutionResult, o as getValue, r as DefaultExit, s as ErrorExecutionResult, t as _CustomModelClient, u as SuccessExecutionResult } from "./custom-client-2V9lmzUf.js";
 import { a as getMultilineComment, c as isJsonSchema, l as isValidIdentifier, m as toValidObjectName, n as escapeString, p as toValidFunctionName, t as configureTokenizer, u as isZuiSchema, v as upperFirst } from "./utils-UBeAFeEI.js";
+import { a as isComponent, i as isAnyComponent, n as assertValidComponent, t as Component } from "./component-Dq7ZLdvy.js";
 import { t as Tool } from "./tool-Bv8N4IPj.js";
 import { c as SnapshotSignal, l as ThinkSignal, o as LoopExceededError, r as CodeFormattingError } from "./errors-Cg1G0Awu.js";
 import { a as isPunct, i as isGroup, o as parse, r as formatTypings, s as tokenize, t as getTypings } from "./typings-CrBa7Tyy.js";
 import { t as Exit } from "./exit-CDdxDBRT.js";
-import { a as isComponent, i as isAnyComponent, n as assertValidComponent, t as Component } from "./component-DGG7d_Mz.js";
 import { i as wrapContent, n as truncateWrappedContent, t as stripTruncationTags } from "./truncator-DZqEqnpD.js";
 import { t as configureQuickJS } from "./quickjs-variant-BYhMBpwU.js";
 import { transforms, z } from "@bpinternal/zui";
 //#region package.json
-var version = "0.7.1";
+var version = "0.8.0";
 //#endregion
 //#region src/hoist.ts
 /**
@@ -790,173 +791,6 @@ var CitationsManager = class {
 	}
 };
 //#endregion
-//#region src/component.default.ts
-const Button = new Component({
-	type: "leaf",
-	description: "A button component that can perform actions when clicked",
-	name: "Button",
-	aliases: ["btn"],
-	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: z.object({
-		action: z.enum([
-			"say",
-			"url",
-			"postback"
-		]).default("say").describe("The action to perform when the button is clicked. Can be \"say\", \"url\", or \"postback\""),
-		label: z.string().describe("The text displayed on the button (min 1 character, max 250 characters)"),
-		value: z.string().optional().describe("The postback value to send when the button is clicked. Required if action is \"postback\""),
-		url: z.string().optional().describe("The URL to open when the button is clicked. Required if action is \"url\"")
-	}) }
-});
-const Image = new Component({
-	type: "leaf",
-	name: "Image",
-	description: "Displays an image from a URL.",
-	aliases: [],
-	generation: { examples: [{ props: {
-		url: "https://example.com/photo.jpg",
-		alt: "Example image"
-	} }] },
-	leaf: { props: z.object({
-		url: z.string().describe("The URL of the image (must be valid)"),
-		alt: z.string().optional().describe("Alternative text describing the image")
-	}) }
-});
-const File = new Component({
-	type: "leaf",
-	name: "File",
-	description: "Sends a downloadable file to the user.",
-	aliases: [],
-	generation: { examples: [{ props: {
-		url: "https://example.com/report.pdf",
-		name: "Report.pdf"
-	} }] },
-	leaf: { props: z.object({
-		url: z.string().describe("The URL of the file (must be valid)"),
-		name: z.string().optional().describe("The display name of the file")
-	}) }
-});
-const Video = new Component({
-	type: "leaf",
-	name: "Video",
-	description: "Embeds a video from a URL.",
-	aliases: [],
-	generation: { examples: [{ props: {
-		url: "https://example.com/intro.mp4",
-		title: "Welcome"
-	} }] },
-	leaf: { props: z.object({
-		url: z.string().describe("The URL of the video (must be valid)"),
-		title: z.string().optional().describe("Title for the video")
-	}) }
-});
-const Audio = new Component({
-	type: "leaf",
-	name: "Audio",
-	description: "Plays an audio clip from a URL.",
-	aliases: [],
-	generation: { examples: [{ props: {
-		url: "https://example.com/audio.mp3",
-		title: "Sample"
-	} }] },
-	leaf: { props: z.object({
-		url: z.string().describe("The URL of the audio clip (must be valid)"),
-		title: z.string().optional().describe("Title for the audio clip")
-	}) }
-});
-const Card = new Component({
-	type: "container",
-	name: "Card",
-	description: "A visual card component that can include an image and buttons.",
-	aliases: [],
-	generation: { examples: [{
-		props: {
-			title: "Product Name",
-			subtitle: "Limited offer"
-		},
-		body: "Featured product of the week."
-	}] },
-	container: {
-		props: z.object({
-			title: z.string().min(1).max(250).describe("Title text (1–250 characters)"),
-			subtitle: z.string().optional().describe("Optional subtitle for the card")
-		}),
-		children: [{
-			description: "Image (optional, max 1)",
-			component: Image.definition
-		}, {
-			description: "Button (optional, up to 5)",
-			component: Button.definition
-		}]
-	}
-});
-const DefaultComponents = {
-	Button,
-	Image,
-	File,
-	Video,
-	Audio,
-	Card,
-	Carousel: new Component({
-		type: "container",
-		name: "Carousel",
-		description: "A virtual container for displaying 1 to 10 Card components as a carousel.",
-		aliases: [],
-		container: {
-			props: z.object({}),
-			children: [{
-				description: "Card component (required, 1–10 allowed)",
-				component: Card.definition
-			}]
-		}
-	}),
-	Text: new Component({
-		type: "default",
-		name: "Message",
-		aliases: ["Text", "Markdown"],
-		description: "A Markdown-formatted text message. Long answers are written the same way: plain Markdown prose.",
-		generation: { examples: [{ body: `Great question! Deploying happens in three steps.
-
-First, connect your repository from the dashboard — we support GitHub and GitLab. Once connected, every push to your main branch triggers a build automatically.
-
-Then configure your build settings:
-
-- **Build command** — usually \`npm run build\`
-- **Output directory** — 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: z.object({}),
-			children: []
-		}
-	}),
-	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 — 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: z.object({}),
-			children: []
-		}
-	})
-};
-//#endregion
 //#region src/chat.ts
 /**
 * Base class for implementing chat interfaces in LLMz agents.
@@ -1497,34 +1331,6 @@ async function* bodyStream(pump, itemId) {
 	}
 }
 //#endregion
-//#region src/message-stream/registry.ts
-/**
-* Stores normalized component definitions. The registry (not the parser) is the
-* single source of truth for which components exist and how they are validated.
-*/
-var ComponentRegistry = class {
-	_definitions = /* @__PURE__ */ new Map();
-	constructor(definitions = []) {
-		for (const definition of definitions) this.register(definition);
-	}
-	register(definition) {
-		if (!NAME_REGEX.test(definition.name)) throw new Error(`Invalid component name "${definition.name}". Component names must be lowercase ([a-z][a-z0-9_-]*).`);
-		this._definitions.set(definition.name, definition);
-	}
-	unregister(name) {
-		this._definitions.delete(name);
-	}
-	has(name) {
-		return this._definitions.has(name);
-	}
-	get(name) {
-		return this._definitions.get(name);
-	}
-	list() {
-		return [...this._definitions.values()];
-	}
-};
-//#endregion
 //#region src/message-stream/normalizer.ts
 const EMPTY_PROPS_SCHEMA = {
 	type: "object",
@@ -1558,137 +1364,6 @@ function normalizePropsSchema(props, name) {
 	throw new Error(`Invalid props schema for "${name}". Expected a ZUI/Zod object schema or a JSON schema, but got type "${typeof props}".`);
 }
 //#endregion
-//#region src/message-stream/validator.ts
-/**
-* Validates a syntactically parsed `■send` item against the registered
-* component definitions. Validation is intentionally separate from parsing: a
-* validation failure never stops the stream, it only produces errors the caller
-* can turn into diagnostics or fallback rendering.
-*/
-function validateComponent(item, registry) {
-	const definition = registry.get(item.name);
-	if (!definition) {
-		const registered = registry.list().map((d) => d.name).join(", ") || "(none)";
-		return {
-			valid: false,
-			props: item.props,
-			errors: [{
-				code: "unknown-component",
-				message: `Unknown component "${item.name}". Registered components: ${registered}`
-			}]
-		};
-	}
-	const errors = [..._validateProps(item.props, definition), ..._validateBody(item, definition)];
-	return {
-		valid: errors.length === 0,
-		props: item.props,
-		errors
-	};
-}
-/** Validates a props object against a JSON schema (also used for `■next` exit props). */
-function validateProps(props, schema) {
-	const errors = [];
-	_checkValue(props, schema, "", errors);
-	return errors;
-}
-const _validateProps = (props, definition) => validateProps(props, definition.propsJsonSchema);
-const _validateBody = (item, definition) => {
-	var _definition$body;
-	const hasBody = typeof item.body === "string" && item.body.length > 0;
-	if (hasBody && !definition.body) return [{
-		code: "body-not-allowed",
-		message: `Component "${definition.name}" does not support a body`
-	}];
-	if (!hasBody && ((_definition$body = definition.body) === null || _definition$body === void 0 ? void 0 : _definition$body.required)) return [{
-		code: "missing-required-body",
-		message: `Component "${definition.name}" requires a body`
-	}];
-	return [];
-};
-const _typeOf = (value) => {
-	if (value === null) return "null";
-	if (Array.isArray(value)) return "array";
-	return typeof value;
-};
-const _matchesType = (value, type) => {
-	switch (type) {
-		case "string": return typeof value === "string";
-		case "number": return typeof value === "number";
-		case "integer": return typeof value === "number" && Number.isInteger(value);
-		case "boolean": return typeof value === "boolean";
-		case "null": return value === null;
-		case "array": return Array.isArray(value);
-		case "object": return !!value && typeof value === "object" && !Array.isArray(value);
-		default: return true;
-	}
-};
-const _isEqual = (a, b) => JSON.stringify(a) === JSON.stringify(b);
-/**
-* Minimal JSON-schema subset checker covering what component schemas need:
-* type, enum, const, required, properties, additionalProperties, items, anyOf/oneOf.
-* Unknown keywords are ignored (lenient by design).
-*/
-const _checkValue = (value, schema, path, errors) => {
-	if (schema === void 0 || typeof schema === "boolean" || typeof schema !== "object") return;
-	const label = path || "props";
-	const propError = (message) => {
-		errors.push({
-			code: "invalid-prop-value",
-			message,
-			path: path || void 0
-		});
-	};
-	if (schema.const !== void 0 && !_isEqual(value, schema.const)) {
-		propError(`Expected "${label}" to equal ${JSON.stringify(schema.const)}`);
-		return;
-	}
-	if (schema.enum && !schema.enum.some((allowed) => _isEqual(value, allowed))) {
-		propError(`Expected "${label}" to be one of: ${schema.enum.map((v) => JSON.stringify(v)).join(", ")}`);
-		return;
-	}
-	const variants = schema.anyOf ?? schema.oneOf;
-	if (variants === null || variants === void 0 ? void 0 : variants.length) {
-		if (!variants.some((variant) => {
-			const variantErrors = [];
-			_checkValue(value, variant, path, variantErrors);
-			return variantErrors.length === 0;
-		})) {
-			propError(`Value of "${label}" does not match any of the allowed types`);
-			return;
-		}
-	}
-	if (schema.type) {
-		const types = Array.isArray(schema.type) ? schema.type : [schema.type];
-		if (!types.some((type) => _matchesType(value, type))) {
-			propError(`Expected "${label}" to be of type ${types.join(" | ")}, but got ${_typeOf(value)}`);
-			return;
-		}
-	}
-	if (Array.isArray(value) && schema.items && !Array.isArray(schema.items)) value.forEach((item, index) => _checkValue(item, schema.items, `${label}[${index}]`, errors));
-	if (value && typeof value === "object" && !Array.isArray(value)) {
-		const record = value;
-		const properties = schema.properties ?? {};
-		for (const requiredKey of schema.required ?? []) if (record[requiredKey] === void 0) errors.push({
-			code: "missing-required-prop",
-			message: `Missing required prop "${path ? `${path}.` : ""}${requiredKey}"`,
-			path: path ? `${path}.${requiredKey}` : requiredKey
-		});
-		for (const [key, propValue] of Object.entries(record)) {
-			const propSchema = properties[key];
-			const propPath = path ? `${path}.${key}` : key;
-			if (propSchema === void 0) {
-				if (schema.additionalProperties === false) errors.push({
-					code: "unexpected-prop",
-					message: `Unexpected prop "${propPath}"`,
-					path: propPath
-				});
-				continue;
-			}
-			_checkValue(propValue, propSchema, propPath, errors);
-		}
-	}
-};
-//#endregion
 //#region src/message-stream/sanitize.ts
 /**
 * The protocol has no escaping mechanism by design. Any untrusted text that is
@@ -1715,6 +1390,7 @@ const utils = {
 * @param props - Configuration object for the execution
 * @param props.client - Botpress Client or Cognitive Client instance for LLM generation
 * @param props.instructions - System prompt/instructions for the LLM (static string or dynamic function)
+* @param props.examples - Optional labeled few-shot examples (static array or dynamic function)
 * @param props.chat - Optional Chat instance to enable Chat Mode with user interaction
 * @param props.tools - Array of Tool instances available to the agent (static or dynamic)
 * @param props.objects - Array of ObjectInstance for namespaced tools and variables (static or dynamic)
@@ -1773,7 +1449,7 @@ const utils = {
 * })
 */
 const execute = async (props) => {
-	const { executeContext } = await import("./execute-DP_17lYZ.js");
+	const { executeContext } = await import("./execute-Aw4cbIx-.js");
 	return executeContext(props);
 };
 /**
@@ -1782,16 +1458,16 @@ const execute = async (props) => {
 * It's recommended to call this function at the beginning of your application without awaiting it (void init())
 */
 const init = async () => {
-	await import("./execute-DP_17lYZ.js");
-	await import("./component-DGG7d_Mz.js").then((n) => n.r);
+	await import("./execute-Aw4cbIx-.js");
+	await import("./component-Dq7ZLdvy.js").then((n) => n.r);
 	await import("./tool-Bv8N4IPj.js").then((n) => n.n);
 	await import("./exit-CDdxDBRT.js").then((n) => n.n);
-	await import("./jsx-CIgdGGVs.js").then((n) => n.i);
-	await import("./vm-C5vf1LH3.js");
+	await import("./jsx-B0iYyvfr.js").then((n) => n.i);
+	await import("./vm-BLsHw1da.js");
 	await import("./utils-UBeAFeEI.js").then((n) => n.h);
 	await import("./truncator-DZqEqnpD.js").then((n) => n.r);
 	await import("./typings-CrBa7Tyy.js").then((n) => n.n);
-	await import("./dual-modes-mNyMThtf.js").then((n) => n.n);
+	await import("./dual-modes-Cy0_W4O2.js").then((n) => n.n);
 };
 //#endregion
-export { BaseResponse, Chat, CitationsManager, Component, ComponentRegistry, DefaultComponents, DefaultExit, ErrorExecutionResult, ExecutionResult, Exit, ListenExit, LoopExceededError, MARKER, NAME_REGEX, NextResponse, ObjectInstance, PartialExecutionResult, ReplayableAsyncIterable, RunResponse, SendResponse, Snapshot, SnapshotSignal, StreamingMessageParser, SuccessExecutionResult, ThinkExit, ThinkSignal, Tool, _CustomModelClient, assertValidComponent, collectText, configureQuickJS, configureTokenizer, execute, generateInstructions, getValue, init, isAnyComponent, isComponent, normalizeComponentDefinition, normalizeComponentName, normalizePropsSchema, parseExit, parseStream, parseText, sanitizeMessageText, tryParseJson, utils, validateComponent, validateProps, version };
+export { BaseResponse, Chat, CitationsManager, Component, ComponentRegistry, DefaultComponents, DefaultExit, ErrorExecutionResult, Example, ExecutionResult, Exit, ListenExit, LoopExceededError, MARKER, NAME_REGEX, NextResponse, ObjectInstance, PartialExecutionResult, ReplayableAsyncIterable, RunResponse, SendResponse, Snapshot, SnapshotSignal, StreamingMessageParser, SuccessExecutionResult, ThinkExit, ThinkSignal, Tool, _CustomModelClient, assertValidComponent, collectText, configureQuickJS, configureTokenizer, execute, generateInstructions, getValue, init, isAnyComponent, isComponent, normalizeComponentDefinition, normalizeComponentName, normalizePropsSchema, parseExit, parseStream, parseText, sanitizeMessageText, tryParseJson, utils, validateComponent, validateProps, version };