llmz 0.7.1 → 0.8.0

package/dist/index.cjs

@@ -1,17 +1,18 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_dual_modes = require("./dual-modes-CfqTk9M8.cjs");
-const require_custom_client = require("./custom-client-Bp1TgTKk.cjs");
-const require_utils = require("./utils-ZpJm00ed.cjs");
-const require_tool = require("./tool-ReA9gxMp.cjs");
+const require_common = require("./common-DdArNQhl.cjs");
+const require_dual_modes = require("./dual-modes-Cb7ThvoV.cjs");
+const require_custom_client = require("./custom-client-HkM1Sdzv.cjs");
+const require_utils = require("./utils-3ESwP3yg.cjs");
+const require_component = require("./component-BXS8vAwO.cjs");
+const require_tool = require("./tool-Dy6AJpJH.cjs");
 const require_errors = require("./errors-C962uJdS.cjs");
-const require_typings = require("./typings-BwAz_TM9.cjs");
-const require_exit = require("./exit-BGi0Kk0y.cjs");
-const require_component = require("./component-BwixNVH8.cjs");
-const require_truncator = require("./truncator-B6aaJaN1.cjs");
+const require_typings = require("./typings-3lsqCbkn.cjs");
+const require_exit = require("./exit-DUM96DN1.cjs");
+const require_truncator = require("./truncator-CLkouTCO.cjs");
 const require_quickjs_variant = require("./quickjs-variant-CsIwTVFC.cjs");
 let _bpinternal_zui = require("@bpinternal/zui");
 //#region package.json
-var version = "0.7.1";
+var version = "0.8.0";
 //#endregion
 //#region src/hoist.ts
 /**
@@ -791,173 +792,6 @@ var CitationsManager = class {
 	}
 };
 //#endregion
-//#region src/component.default.ts
-const Button = new require_component.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: _bpinternal_zui.z.object({
-		action: _bpinternal_zui.z.enum([
-			"say",
-			"url",
-			"postback"
-		]).default("say").describe("The action to perform when the button is clicked. Can be \"say\", \"url\", or \"postback\""),
-		label: _bpinternal_zui.z.string().describe("The text displayed on the button (min 1 character, max 250 characters)"),
-		value: _bpinternal_zui.z.string().optional().describe("The postback value to send when the button is clicked. Required if action is \"postback\""),
-		url: _bpinternal_zui.z.string().optional().describe("The URL to open when the button is clicked. Required if action is \"url\"")
-	}) }
-});
-const Image = new require_component.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: _bpinternal_zui.z.object({
-		url: _bpinternal_zui.z.string().describe("The URL of the image (must be valid)"),
-		alt: _bpinternal_zui.z.string().optional().describe("Alternative text describing the image")
-	}) }
-});
-const File = new require_component.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: _bpinternal_zui.z.object({
-		url: _bpinternal_zui.z.string().describe("The URL of the file (must be valid)"),
-		name: _bpinternal_zui.z.string().optional().describe("The display name of the file")
-	}) }
-});
-const Video = new require_component.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: _bpinternal_zui.z.object({
-		url: _bpinternal_zui.z.string().describe("The URL of the video (must be valid)"),
-		title: _bpinternal_zui.z.string().optional().describe("Title for the video")
-	}) }
-});
-const Audio = new require_component.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: _bpinternal_zui.z.object({
-		url: _bpinternal_zui.z.string().describe("The URL of the audio clip (must be valid)"),
-		title: _bpinternal_zui.z.string().optional().describe("Title for the audio clip")
-	}) }
-});
-const Card = new require_component.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: _bpinternal_zui.z.object({
-			title: _bpinternal_zui.z.string().min(1).max(250).describe("Title text (1–250 characters)"),
-			subtitle: _bpinternal_zui.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 require_component.Component({
-		type: "container",
-		name: "Carousel",
-		description: "A virtual container for displaying 1 to 10 Card components as a carousel.",
-		aliases: [],
-		container: {
-			props: _bpinternal_zui.z.object({}),
-			children: [{
-				description: "Card component (required, 1–10 allowed)",
-				component: Card.definition
-			}]
-		}
-	}),
-	Text: new require_component.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: _bpinternal_zui.z.object({}),
-			children: []
-		}
-	}),
-	Speech: new require_component.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: _bpinternal_zui.z.object({}),
-			children: []
-		}
-	})
-};
-//#endregion
 //#region src/chat.ts
 /**
 * Base class for implementing chat interfaces in LLMz agents.
@@ -1461,7 +1295,7 @@ function parseText(text, options) {
 	})(), options);
 }
 async function* parseResponses(stream, options) {
-	const pump = new EventPump(stream, new require_dual_modes.StreamingMessageParser(options));
+	const pump = new EventPump(stream, new require_common.StreamingMessageParser(options));
 	let activeBody;
 	while (true) {
 		if (activeBody) {
@@ -1498,34 +1332,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 (!require_dual_modes.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",
@@ -1535,7 +1341,7 @@ const EMPTY_PROPS_SCHEMA = {
 const normalizeComponentName = (name) => name.trim().toLowerCase();
 function normalizeComponentDefinition(definition) {
 	const name = normalizeComponentName(definition.name ?? "");
-	if (!require_dual_modes.NAME_REGEX.test(name)) throw new Error(`Invalid component name "${definition.name}". Component names must be lowercase ([a-z][a-z0-9_-]*).`);
+	if (!require_common.NAME_REGEX.test(name)) throw new Error(`Invalid component name "${definition.name}". Component names must be lowercase ([a-z][a-z0-9_-]*).`);
 	return {
 		name,
 		description: definition.description,
@@ -1559,137 +1365,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
@@ -1716,6 +1391,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)
@@ -1774,7 +1450,7 @@ const utils = {
 * })
 */
 const execute = async (props) => {
-	const { executeContext } = await Promise.resolve().then(() => require("./execute-msui51b2.cjs"));
+	const { executeContext } = await Promise.resolve().then(() => require("./execute-COIHOIKR.cjs"));
 	return executeContext(props);
 };
 /**
@@ -1783,32 +1459,33 @@ 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 Promise.resolve().then(() => require("./execute-msui51b2.cjs"));
-	await Promise.resolve().then(() => require("./component-BwixNVH8.cjs")).then((n) => n.component_exports);
-	await Promise.resolve().then(() => require("./tool-ReA9gxMp.cjs")).then((n) => n.tool_exports);
-	await Promise.resolve().then(() => require("./exit-BGi0Kk0y.cjs")).then((n) => n.exit_exports);
-	await Promise.resolve().then(() => require("./jsx-BWvT6ukg.cjs")).then((n) => n.jsx_exports);
-	await Promise.resolve().then(() => require("./vm-BjkJqSQH.cjs"));
-	await Promise.resolve().then(() => require("./utils-ZpJm00ed.cjs")).then((n) => n.utils_exports);
-	await Promise.resolve().then(() => require("./truncator-B6aaJaN1.cjs")).then((n) => n.truncator_exports);
-	await Promise.resolve().then(() => require("./typings-BwAz_TM9.cjs")).then((n) => n.typings_exports);
-	await Promise.resolve().then(() => require("./dual-modes-CfqTk9M8.cjs")).then((n) => n.dual_modes_exports);
+	await Promise.resolve().then(() => require("./execute-COIHOIKR.cjs"));
+	await Promise.resolve().then(() => require("./component-BXS8vAwO.cjs")).then((n) => n.component_exports);
+	await Promise.resolve().then(() => require("./tool-Dy6AJpJH.cjs")).then((n) => n.tool_exports);
+	await Promise.resolve().then(() => require("./exit-DUM96DN1.cjs")).then((n) => n.exit_exports);
+	await Promise.resolve().then(() => require("./jsx-D5Y2cPo-.cjs")).then((n) => n.jsx_exports);
+	await Promise.resolve().then(() => require("./vm-D6s1zF6M.cjs"));
+	await Promise.resolve().then(() => require("./utils-3ESwP3yg.cjs")).then((n) => n.utils_exports);
+	await Promise.resolve().then(() => require("./truncator-CLkouTCO.cjs")).then((n) => n.truncator_exports);
+	await Promise.resolve().then(() => require("./typings-3lsqCbkn.cjs")).then((n) => n.typings_exports);
+	await Promise.resolve().then(() => require("./dual-modes-Cb7ThvoV.cjs")).then((n) => n.dual_modes_exports);
 };
 //#endregion
 exports.BaseResponse = BaseResponse;
 exports.Chat = Chat;
 exports.CitationsManager = CitationsManager;
 exports.Component = require_component.Component;
-exports.ComponentRegistry = ComponentRegistry;
-exports.DefaultComponents = DefaultComponents;
+exports.ComponentRegistry = require_dual_modes.ComponentRegistry;
+exports.DefaultComponents = require_dual_modes.DefaultComponents;
 exports.DefaultExit = require_custom_client.DefaultExit;
 exports.ErrorExecutionResult = require_custom_client.ErrorExecutionResult;
+exports.Example = require_dual_modes.Example;
 exports.ExecutionResult = require_custom_client.ExecutionResult;
 exports.Exit = require_exit.Exit;
 exports.ListenExit = require_custom_client.ListenExit;
 exports.LoopExceededError = require_errors.LoopExceededError;
-exports.MARKER = require_dual_modes.MARKER;
-exports.NAME_REGEX = require_dual_modes.NAME_REGEX;
+exports.MARKER = require_common.MARKER;
+exports.NAME_REGEX = require_common.NAME_REGEX;
 exports.NextResponse = NextResponse;
 exports.ObjectInstance = ObjectInstance;
 exports.PartialExecutionResult = require_custom_client.PartialExecutionResult;
@@ -1817,7 +1494,7 @@ exports.RunResponse = RunResponse;
 exports.SendResponse = SendResponse;
 exports.Snapshot = require_custom_client.Snapshot;
 exports.SnapshotSignal = require_errors.SnapshotSignal;
-exports.StreamingMessageParser = require_dual_modes.StreamingMessageParser;
+exports.StreamingMessageParser = require_common.StreamingMessageParser;
 exports.SuccessExecutionResult = require_custom_client.SuccessExecutionResult;
 exports.ThinkExit = require_custom_client.ThinkExit;
 exports.ThinkSignal = require_errors.ThinkSignal;
@@ -1840,10 +1517,10 @@ exports.parseExit = require_custom_client.parseExit;
 exports.parseStream = parseStream;
 exports.parseText = parseText;
 exports.sanitizeMessageText = sanitizeMessageText;
-exports.tryParseJson = require_dual_modes.tryParseJson;
+exports.tryParseJson = require_common.tryParseJson;
 exports.utils = utils;
-exports.validateComponent = validateComponent;
-exports.validateProps = validateProps;
+exports.validateComponent = require_dual_modes.validateComponent;
+exports.validateProps = require_dual_modes.validateProps;
 Object.defineProperty(exports, "version", {
 	enumerable: true,
 	get: function() {

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { version } from '../package.json';
+export { Example, type ExampleDefinition, type ExampleMessage } from './example.js';
 export { Tool } from './tool.js';
 export { Exit, type ExitResult } from './exit.js';
 export { ObjectInstance } from './objects.js';
@@ -42,6 +43,7 @@ export declare 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)