llmz 0.7.0 → 0.8.0

package/dist/example.d.ts

@@ -0,0 +1,45 @@
+import type { Component } from './component.js';
+import type { Exit } from './exit.js';
+export type ExampleMessage = {
+    component: Component | string;
+    props?: Record<string, unknown>;
+    body?: string;
+};
+/** Exactly one model response: messages followed by code or an exit. */
+type ExampleResponse = {
+    messages?: ExampleMessage[];
+} & ({
+    code: string;
+    exit?: never;
+    props?: never;
+} | {
+    exit: Exit | string;
+    props?: Record<string, unknown>;
+    code?: never;
+});
+/** One hypothetical situation and the single response to produce in it. */
+export type ExampleDefinition = {
+    /** Include the request, known facts, or previous tool results needed to understand this response. */
+    situation: string;
+    /** Optional explanation of why this response is appropriate. Context for the model, not generated output. */
+    reason?: string;
+} & ExampleResponse;
+/**
+ * Builds one protocol-correct response to one hypothetical situation.
+ *
+ * @example
+ * new Example({
+ *   situation: 'The user asks a question that needs a knowledge-base search.',
+ *   reason: 'Search first so the answer can use actual evidence.',
+ *   code: 'return await searchKnowledge({ query: "reset password" })',
+ * })
+ */
+export declare class Example {
+    readonly situation: string;
+    readonly reason?: string;
+    readonly output: string;
+    constructor(definition: ExampleDefinition);
+}
+/** Internal prompt renderer. Checks examples against this iteration's component/exit catalog. */
+export declare const renderExamples: (examples: readonly Example[], components: Component[], exits: Exit[]) => Promise<string>;
+export {};

package/dist/example.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/{execute-DP_17lYZ.js → execute-Aw4cbIx-.js}

@@ -1,11 +1,13 @@
-import { a as StreamingMessageParser, d as isEqual, h as toNumber, i as toParsedAssistantResponse } from "./dual-modes-mNyMThtf.js";
-import { d as Snapshot, f as parseExit, l as PartialExecutionResult, n as Context, s as ErrorExecutionResult, t as _CustomModelClient, u as SuccessExecutionResult } from "./custom-client-CMuy7fXU.js";
+import { a as StreamingMessageParser, i as toParsedAssistantResponse } from "./common-pgJjFu2Y.js";
+import { c as isEqual, f as toNumber } from "./dual-modes-Cy0_W4O2.js";
+import { d as Snapshot, f as parseExit, l as PartialExecutionResult, n as Context, s as ErrorExecutionResult, t as _CustomModelClient, u as SuccessExecutionResult } from "./custom-client-2V9lmzUf.js";
 import { d as stripInvalidIdentifiers, i as getErrorMessage, s as init } from "./utils-UBeAFeEI.js";
-import { t as createJsxComponent } from "./jsx-CIgdGGVs.js";
+import { t as createJsxComponent } from "./jsx-B0iYyvfr.js";
 import { t as cleanStackTrace } from "./stack-traces-BIE_5Xwf.js";
 import { a as InvalidCodeError, c as SnapshotSignal, i as CognitiveError, l as ThinkSignal, n as CodeExecutionError, o as LoopExceededError, s as Signals, t as AssignmentError } from "./errors-Cg1G0Awu.js";
 import { n as truncateWrappedContent } from "./truncator-DZqEqnpD.js";
-import { runAsyncFunction, t as hasTopLevelReturn, warmupVM } from "./vm-C5vf1LH3.js";
+import { r as hasTopLevelReturn } from "./compiler-CW1VjQsn.js";
+import { runAsyncFunction, warmupVM } from "./vm-BLsHw1da.js";
 import { z } from "@bpinternal/zui";
 import { ulid } from "ulid";
 import { Client } from "@botpress/client";
@@ -217,6 +219,7 @@ const generateCode = async ({ iteration, ctx, cognitive, controller, metadata, o
 	const liveContent = /* @__PURE__ */ new Map();
 	let codeGenerationTraced = false;
 	let runCompleted = false;
+	let awaitsRunResult = false;
 	const dispatchSends = async (events) => {
 		for (const event of events) if (event.type === "item-start") {
 			liveItems.set(event.item.id, event.item);
@@ -230,7 +233,7 @@ const generateCode = async ({ iteration, ctx, cognitive, controller, metadata, o
 			}
 		} else if (event.type === "body-delta" && onSendDelta) {
 			const item = liveItems.get(event.itemId);
-			if ((item === null || item === void 0 ? void 0 : item.kind) !== "send") continue;
+			if ((item === null || item === void 0 ? void 0 : item.kind) !== "send" || awaitsRunResult) continue;
 			const content = (liveContent.get(item.id) ?? "") + event.delta;
 			liveContent.set(item.id, content);
 			const delta = {
@@ -243,7 +246,7 @@ const generateCode = async ({ iteration, ctx, cognitive, controller, metadata, o
 			};
 			await preview(delta);
 		} else if (event.type === "item-complete") {
-			if (event.item.kind === "send" && onSend) await onSend({
+			if (event.item.kind === "send" && onSend && !awaitsRunResult) await onSend({
 				name: event.item.name,
 				props: event.item.props,
 				body: event.item.body
@@ -251,6 +254,7 @@ const generateCode = async ({ iteration, ctx, cognitive, controller, metadata, o
 			else if (event.item.kind === "run" && event.item.status === "complete" && !runCompleted) {
 				runCompleted = true;
 				const code = (event.item.body ?? "").trim();
+				awaitsRunResult = hasTopLevelReturn(code);
 				onRunComplete === null || onRunComplete === void 0 || onRunComplete(code);
 			}
 		}
@@ -315,6 +319,7 @@ const generateCode = async ({ iteration, ctx, cognitive, controller, metadata, o
 					liveContent.clear();
 					codeGenerationTraced = false;
 					runCompleted = false;
+					awaitsRunResult = false;
 					responseMetadata = void 0;
 					attempt = chunk.value.restart.attempt;
 					await preview({
@@ -396,6 +401,7 @@ const generateCode = async ({ iteration, ctx, cognitive, controller, metadata, o
 //#endregion
 //#region src/runtime/interpret-result.ts
 const interpretVMResult = async ({ iteration, result, controller, startedAt, onExit }) => {
+	Object.assign(iteration.variables, Object.fromEntries(Object.entries(result.variables ?? {}).filter(([, value]) => value !== "[[non-primitive]]")));
 	if (result.error && result.error instanceof InvalidCodeError) {
 		iteration.end({
 			type: "invalid_code_error",
@@ -443,7 +449,8 @@ const interpretVMResult = async ({ iteration, result, controller, startedAt, onE
 			thinking_requested: {
 				variables: result.signal.context,
 				reason: result.signal.reason,
-				metadata: result.signal.metadata
+				metadata: result.signal.metadata,
+				interrupted: true
 			}
 		});
 		return;
@@ -504,11 +511,14 @@ const applyNextExit = async ({ iteration, controller, onExit }) => {
 		value: parsedExit.success ? parsedExit.value : next.props
 	};
 	if (!parsedExit.success) {
+		var _parsedExit$validatio;
+		const details = (_parsedExit$validatio = parsedExit.validationErrors) === null || _parsedExit$validatio === void 0 ? void 0 : _parsedExit$validatio.join("; ");
+		const error = [parsedExit.error.split("\n")[0], details].filter(Boolean).join(". ");
 		iteration.end({
 			type: "exit_error",
 			exit_error: {
 				exit: next.name,
-				message: parsedExit.error,
+				message: `${error}. Received props: ${JSON.stringify(next.props)}. Choose an exit from <exits> and supply its required props as ONE JSON object on the SAME LINE as ■next=${next.name}. Do not use a JavaScript return statement or wrap the fields in "value" or "props".`,
 				return_value: returnValue
 			}
 		});
@@ -748,6 +758,7 @@ const executeContextInternal = async (props) => {
 	const ctx = new Context({
 		chat: props.chat,
 		instructions: props.instructions,
+		examples: props.examples,
 		objects: props.objects,
 		tools: props.tools,
 		loop: (_props$options = props.options) === null || _props$options === void 0 ? void 0 : _props$options.loop,
@@ -969,10 +980,12 @@ const executeIteration = async ({ iteration, ctx, cognitive, controller, onExit,
 		onSend: async (send, messageMetadata) => {
 			if (!ctx.chat) return;
 			const sendStartedAt = Date.now();
-			const component = createJsxComponent({
+			const registered = iteration.components.find((component) => component.definition.name.toLowerCase() === send.name);
+			const children = send.body ? [send.body] : [];
+			const component = registered ? registered.render(send.props, children) : createJsxComponent({
 				type: send.name,
 				props: send.props,
-				children: send.body ? [send.body] : []
+				children
 			});
 			try {
 				await ctx.chat.handler(component, messageMetadata);

package/dist/{execute-msui51b2.cjs → execute-COIHOIKR.cjs}

@@ -1,18 +1,19 @@
-const require__baseForOwn = require("./_baseForOwn-buOZDFbK.cjs");
-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_jsx = require("./jsx-BWvT6ukg.cjs");
+const require_compiler = require("./compiler-C-OI9sim.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_jsx = require("./jsx-D5Y2cPo-.cjs");
 const require_stack_traces = require("./stack-traces-ntw_qhoy.cjs");
 const require_errors = require("./errors-C962uJdS.cjs");
-const require_truncator = require("./truncator-B6aaJaN1.cjs");
-const require_vm = require("./vm-BjkJqSQH.cjs");
+const require_truncator = require("./truncator-CLkouTCO.cjs");
+const require_vm = require("./vm-D6s1zF6M.cjs");
 let _bpinternal_zui = require("@bpinternal/zui");
 let ulid = require("ulid");
 let _botpress_client = require("@botpress/client");
 let _botpress_cognitive = require("@botpress/cognitive");
 let ms = require("ms");
-ms = require__baseForOwn.__toESM(ms, 1);
+ms = require_compiler.__toESM(ms, 1);
 //#region ../../node_modules/.pnpm/lodash-es@4.17.21/node_modules/lodash-es/_baseClamp.js
 /**
 * The base implementation of `_.clamp` which doesn't coerce arguments.
@@ -219,6 +220,7 @@ const generateCode = async ({ iteration, ctx, cognitive, controller, metadata, o
 	const liveContent = /* @__PURE__ */ new Map();
 	let codeGenerationTraced = false;
 	let runCompleted = false;
+	let awaitsRunResult = false;
 	const dispatchSends = async (events) => {
 		for (const event of events) if (event.type === "item-start") {
 			liveItems.set(event.item.id, event.item);
@@ -232,7 +234,7 @@ const generateCode = async ({ iteration, ctx, cognitive, controller, metadata, o
 			}
 		} else if (event.type === "body-delta" && onSendDelta) {
 			const item = liveItems.get(event.itemId);
-			if ((item === null || item === void 0 ? void 0 : item.kind) !== "send") continue;
+			if ((item === null || item === void 0 ? void 0 : item.kind) !== "send" || awaitsRunResult) continue;
 			const content = (liveContent.get(item.id) ?? "") + event.delta;
 			liveContent.set(item.id, content);
 			const delta = {
@@ -245,7 +247,7 @@ const generateCode = async ({ iteration, ctx, cognitive, controller, metadata, o
 			};
 			await preview(delta);
 		} else if (event.type === "item-complete") {
-			if (event.item.kind === "send" && onSend) await onSend({
+			if (event.item.kind === "send" && onSend && !awaitsRunResult) await onSend({
 				name: event.item.name,
 				props: event.item.props,
 				body: event.item.body
@@ -253,12 +255,13 @@ const generateCode = async ({ iteration, ctx, cognitive, controller, metadata, o
 			else if (event.item.kind === "run" && event.item.status === "complete" && !runCompleted) {
 				runCompleted = true;
 				const code = (event.item.body ?? "").trim();
+				awaitsRunResult = require_compiler.hasTopLevelReturn(code);
 				onRunComplete === null || onRunComplete === void 0 || onRunComplete(code);
 			}
 		}
 	};
 	if (typeof cognitive.generateTextStream === "function") {
-		let parser = new require_dual_modes.StreamingMessageParser();
+		let parser = new require_common.StreamingMessageParser();
 		let fence = new LeadingFenceFilter();
 		const streamController = createJoinedAbortController([controller.signal]);
 		const requestedAt = Date.now();
@@ -311,12 +314,13 @@ const generateCode = async ({ iteration, ctx, cognitive, controller, metadata, o
 						...chunk.value.restart
 					});
 					raw = "";
-					parser = new require_dual_modes.StreamingMessageParser();
+					parser = new require_common.StreamingMessageParser();
 					fence = new LeadingFenceFilter();
 					liveItems.clear();
 					liveContent.clear();
 					codeGenerationTraced = false;
 					runCompleted = false;
+					awaitsRunResult = false;
 					responseMetadata = void 0;
 					attempt = chunk.value.restart.attempt;
 					await preview({
@@ -341,7 +345,7 @@ const generateCode = async ({ iteration, ctx, cognitive, controller, metadata, o
 			const remaining = fence.flush();
 			if (remaining) await dispatchSends(parser.push(remaining));
 			await dispatchSends(parser.finish());
-			assistantResponse = require_dual_modes.toParsedAssistantResponse(parser.items, raw, parser.diagnostics);
+			assistantResponse = require_common.toParsedAssistantResponse(parser.items, raw, parser.diagnostics);
 		} finally {
 			streamController.abort("LLM stream closed");
 			if (!streamCompleted) stream.return(void 0).catch((err) => {});
@@ -398,6 +402,7 @@ const generateCode = async ({ iteration, ctx, cognitive, controller, metadata, o
 //#endregion
 //#region src/runtime/interpret-result.ts
 const interpretVMResult = async ({ iteration, result, controller, startedAt, onExit }) => {
+	Object.assign(iteration.variables, Object.fromEntries(Object.entries(result.variables ?? {}).filter(([, value]) => value !== "[[non-primitive]]")));
 	if (result.error && result.error instanceof require_errors.InvalidCodeError) {
 		iteration.end({
 			type: "invalid_code_error",
@@ -445,7 +450,8 @@ const interpretVMResult = async ({ iteration, result, controller, startedAt, onE
 			thinking_requested: {
 				variables: result.signal.context,
 				reason: result.signal.reason,
-				metadata: result.signal.metadata
+				metadata: result.signal.metadata,
+				interrupted: true
 			}
 		});
 		return;
@@ -458,7 +464,7 @@ const interpretVMResult = async ({ iteration, result, controller, startedAt, onE
 		return;
 	}
 	const returnValue = result.return_value;
-	const codeRequestsInspection = require_vm.hasTopLevelReturn(iteration.code ?? "");
+	const codeRequestsInspection = require_compiler.hasTopLevelReturn(iteration.code ?? "");
 	if (iteration.next && !codeRequestsInspection) {
 		await applyNextExit({
 			iteration,
@@ -506,11 +512,14 @@ const applyNextExit = async ({ iteration, controller, onExit }) => {
 		value: parsedExit.success ? parsedExit.value : next.props
 	};
 	if (!parsedExit.success) {
+		var _parsedExit$validatio;
+		const details = (_parsedExit$validatio = parsedExit.validationErrors) === null || _parsedExit$validatio === void 0 ? void 0 : _parsedExit$validatio.join("; ");
+		const error = [parsedExit.error.split("\n")[0], details].filter(Boolean).join(". ");
 		iteration.end({
 			type: "exit_error",
 			exit_error: {
 				exit: next.name,
-				message: parsedExit.error,
+				message: `${error}. Received props: ${JSON.stringify(next.props)}. Choose an exit from <exits> and supply its required props as ONE JSON object on the SAME LINE as ■next=${next.name}. Do not use a JavaScript return statement or wrap the fields in "value" or "props".`,
 				return_value: returnValue
 			}
 		});
@@ -750,6 +759,7 @@ const executeContextInternal = async (props) => {
 	const ctx = new require_custom_client.Context({
 		chat: props.chat,
 		instructions: props.instructions,
+		examples: props.examples,
 		objects: props.objects,
 		tools: props.tools,
 		loop: (_props$options = props.options) === null || _props$options === void 0 ? void 0 : _props$options.loop,
@@ -971,10 +981,12 @@ const executeIteration = async ({ iteration, ctx, cognitive, controller, onExit,
 		onSend: async (send, messageMetadata) => {
 			if (!ctx.chat) return;
 			const sendStartedAt = Date.now();
-			const component = require_jsx.createJsxComponent({
+			const registered = iteration.components.find((component) => component.definition.name.toLowerCase() === send.name);
+			const children = send.body ? [send.body] : [];
+			const component = registered ? registered.render(send.props, children) : require_jsx.createJsxComponent({
 				type: send.name,
 				props: send.props,
-				children: send.body ? [send.body] : []
+				children
 			});
 			try {
 				await ctx.chat.handler(component, messageMetadata);

package/dist/{exit-BGi0Kk0y.cjs → exit-DUM96DN1.cjs}

@@ -1,9 +1,9 @@
-const require__baseForOwn = require("./_baseForOwn-buOZDFbK.cjs");
+const require_compiler = require("./compiler-C-OI9sim.cjs");
 const require_uniq = require("./uniq-G872RWmE.cjs");
-const require_utils = require("./utils-ZpJm00ed.cjs");
+const require_utils = require("./utils-3ESwP3yg.cjs");
 let _bpinternal_zui = require("@bpinternal/zui");
 //#region src/exit.ts
-var exit_exports = /* @__PURE__ */ require__baseForOwn.__exportAll({ Exit: () => Exit });
+var exit_exports = /* @__PURE__ */ require_compiler.__exportAll({ Exit: () => Exit });
 /**
 * Defines how LLMz agent execution can terminate.
 *

package/dist/exit-parser.d.ts

@@ -9,6 +9,8 @@ export type ParsedExit = {
 } | {
     success: false;
     error: string;
+    /** Field-level schema errors, separate from the legacy return-statement guidance. */
+    validationErrors?: string[];
     returnValue: unknown;
 };
 /**