llmz 0.7.1 → 0.9.0

package/dist/{custom-client-Bp1TgTKk.cjs → custom-client-DAsGRnYc.cjs}

@@ -1,14 +1,14 @@
+const require_dual_modes = require("./dual-modes-DPXiuvNe.cjs");
 const require__overArg = require("./_overArg-C5Hy7oCi.cjs");
 const require__baseIteratee = require("./_baseIteratee-CF4qP2a8.cjs");
-const require_dual_modes = require("./dual-modes-CfqTk9M8.cjs");
-const require_utils = require("./utils-ZpJm00ed.cjs");
+const require_utils = require("./utils-3ESwP3yg.cjs");
 const require__getPrototype = require("./_getPrototype-DQDlNVVM.cjs");
 const require_isPlainObject = require("./isPlainObject-CSxXVKCk.cjs");
-const require_tool = require("./tool-ReA9gxMp.cjs");
+const require_tool = require("./tool-Dy6AJpJH.cjs");
 const require_errors = require("./errors-C962uJdS.cjs");
-const require_exit = require("./exit-BGi0Kk0y.cjs");
-const require_component = require("./component-BwixNVH8.cjs");
-const require_truncator = require("./truncator-B6aaJaN1.cjs");
+const require_exit = require("./exit-DUM96DN1.cjs");
+const require_component = require("./component-C6Agl2ns.cjs");
+const require_truncator = require("./truncator-CLkouTCO.cjs");
 let _bpinternal_zui = require("@bpinternal/zui");
 let ulid = require("ulid");
 //#region ../../node_modules/.pnpm/lodash-es@4.17.21/node_modules/lodash-es/_arrayEach.js
@@ -819,7 +819,8 @@ function parseExit(returnValue, exits) {
 	}
 	const schema = returnExit.zSchema;
 	const schemaType = schema._def.typeName;
-	let parsed = schema.safeParse(valueToValidate);
+	const initialParse = schema.safeParse(valueToValidate);
+	let parsed = initialParse;
 	if (!parsed.success && alternativeValue !== void 0 && alternativeValue !== valueToValidate) {
 		const altParsed = schema.safeParse(alternativeValue);
 		if (altParsed.success) {
@@ -833,6 +834,7 @@ function parseExit(returnValue, exits) {
 		parsed = result.parsed;
 	}
 	if (!parsed.success) {
+		var _initialParse$error;
 		const getValueTypeDescription = (val) => {
 			if (val === null) return "null";
 			if (val === void 0) return "undefined";
@@ -894,6 +896,7 @@ function parseExit(returnValue, exits) {
 				"But expected one of:",
 				...expectedStatements.map((s) => `  ${s}`)
 			].join("\n"),
+			validationErrors: (((_initialParse$error = initialParse.error) === null || _initialParse$error === void 0 ? void 0 : _initialParse$error.issues) ?? []).map((issue) => `${issue.path.join(".") || "value"}: ${issue.message}`),
 			returnValue
 		};
 	}
@@ -1788,6 +1791,49 @@ var HookedArray = class extends Array {
 	}
 };
 //#endregion
+//#region src/prompts/execution-history.ts
+function describeOutcome(status) {
+	switch (status.type) {
+		case "thinking_requested": return status.thinking_requested.interrupted ? "a tool paused execution" : "code completed and returned control";
+		case "execution_error": return "code execution failed";
+		case "invalid_code_error": return "invalid code or protocol";
+		case "exit_error": return "exit validation failed";
+		default: return status.type;
+	}
+}
+/** Summarize observed effects, including failed calls and retracted deliveries. */
+function summarizeIterations(iterations, canTalk) {
+	const history = [];
+	const attempts = /* @__PURE__ */ new Map();
+	const deliveredMessages = [];
+	for (const [index, iteration] of iterations.entries()) {
+		const calls = [];
+		const lastRestart = iteration.traces.reduce((last, trace, traceIndex) => trace.type === "llm_call_restarted" ? traceIndex : last, -1);
+		for (const [traceIndex, trace] of iteration.traces.entries()) {
+			if (trace.type === "tool_call") {
+				const name = trace.object ? `${trace.object}.${trace.tool_name}` : trace.tool_name;
+				let outcome = "failed or paused";
+				if (trace.success) outcome = trace.output instanceof require_errors.ThinkSignal ? "paused for attention" : "succeeded";
+				attempts.set(name, (attempts.get(name) ?? 0) + 1);
+				calls.push(`${name}: ${outcome}`);
+			}
+			if (canTalk && trace.type === "yield") deliveredMessages.push({
+				iteration: index + 1,
+				content: trace.value,
+				...traceIndex < lastRestart ? { retracted: true } : {}
+			});
+		}
+		const outcome = describeOutcome(iteration.status);
+		const toolSummary = calls.length ? ` Tool attempts: ${calls.join("; ")}.` : "";
+		history.push(`Iteration ${index + 1}: ${outcome}.${toolSummary}`);
+	}
+	return {
+		history,
+		toolAttempts: Object.fromEntries(attempts),
+		deliveredMessages: canTalk ? deliveredMessages : void 0
+	};
+}
+//#endregion
 //#region src/transcript.ts
 const MAX_MESSAGE_LENGTH = 5e3;
 function getMessagePreview(message) {
@@ -1991,7 +2037,7 @@ const ThinkExit = new require_exit.Exit({
 */
 const ListenExit = new require_exit.Exit({
 	name: "listen",
-	description: "Listen to the user and provide a response"
+	description: "Stop talking and wait for the user to talk next."
 });
 /**
 * Default exit used when no custom exits are provided.
@@ -2117,6 +2163,9 @@ var Iteration = class {
 		this._mutations.set(`${mutation.object ?? "global"}:${mutation.property}`, mutation);
 	}
 	_parameters;
+	get components() {
+		return this._parameters.components;
+	}
 	get transcript() {
 		return this._parameters.transcript;
 	}
@@ -2234,6 +2283,7 @@ var Context = class {
 	id;
 	chat;
 	instructions;
+	examples;
 	objects;
 	tools;
 	exits;
@@ -2254,14 +2304,10 @@ var Context = class {
 	*/
 	maxTimeToFirstToken;
 	/**
-	* Allow Cognitive to restart a failed stream on another model. With fallback
-	* enabled, there is no buffered delivery and no final delivery queue: delta
-	* text and completed Chat.handler sends stream immediately during generation.
-	* A reset-only delta (restart: true) on Chat.onMessageDelta invalidates ALL
-	* current-iteration messages, including completed sends — consumers must
-	* retract/replace them, which is unsafe for irreversible external transports.
-	* Only TOOL/CODE execution waits for a successful stream. Streaming-only;
-	* defaults to false, which leaves progressive sending unchanged.
+	* Allow Cognitive to restart a failed stream on another model. Previews remain
+	* live and are retracted with a restart delta before replacement output.
+	* Completed sends and code always wait for a valid response and successful
+	* transport. Streaming-only; defaults to false.
 	*/
 	midStreamFallback;
 	/**
@@ -2271,6 +2317,7 @@ var Context = class {
 	transcriptionModel;
 	metadata;
 	snapshot;
+	_lastMessageWithoutExecutionState;
 	iteration = 0;
 	iterations;
 	async nextIteration() {
@@ -2329,18 +2376,20 @@ var Context = class {
 		const tools = countText(parts.tools);
 		const transcript = countText(parts.transcript);
 		const protocol = countText(parts.protocol);
+		const examples = countText(parts.examples);
 		const systemTokens = messages.filter((x) => x.role === "system").reduce((acc, x) => acc + countMessage(x), 0);
 		const otherTokens = messages.filter((x) => x.role !== "system").reduce((acc, x) => acc + countMessage(x), 0);
 		const isFirstIteration = this.iterations.length === 0 && !this.snapshot;
-		const framework = Math.max(0, systemTokens - (instructions + tools + transcript + protocol));
+		const framework = Math.max(0, systemTokens - (instructions + tools + transcript + protocol + examples));
 		const iterations = isFirstIteration ? 0 : otherTokens;
 		return {
-			total: framework + instructions + tools + transcript + protocol + iterations + (isFirstIteration ? otherTokens : 0),
+			total: framework + instructions + tools + transcript + protocol + examples + iterations + (isFirstIteration ? otherTokens : 0),
 			framework: framework + (isFirstIteration ? otherTokens : 0),
 			instructions,
 			tools,
 			transcript,
 			protocol,
+			examples,
 			iterations
 		};
 	}
@@ -2348,24 +2397,50 @@ var Context = class {
 		var _this$snapshot2, _this$snapshot3;
 		const lastIteration = this.iterations.at(-1);
 		const promptProps = {
+			iteration: {
+				current: this.iterations.length + 1,
+				limit: this.loop,
+				resumed: !!this.snapshot,
+				...summarizeIterations(this.iterations, parameters.components.length > 0)
+			},
 			globalTools: parameters.tools,
 			objects: parameters.objects,
 			instructions: parameters.instructions,
+			examples: parameters.examples,
 			transcript: parameters.transcript,
 			exits: parameters.components.length ? [...parameters.exits, ListenExit] : parameters.exits,
 			components: parameters.components
 		};
 		const { message: systemMessage, parts } = await this.version.getSystemMessage(promptProps);
-		const withParts = (messages) => ({
-			messages,
-			parts
-		});
+		const previousLastMessage = this._lastMessageWithoutExecutionState;
+		const withParts = (messages) => {
+			var _this$version$getExec, _this$version;
+			const last = messages.at(-1);
+			this._lastMessageWithoutExecutionState = last;
+			const state = ((_this$version$getExec = (_this$version = this.version).getExecutionState) === null || _this$version$getExec === void 0 ? void 0 : _this$version$getExec.call(_this$version, promptProps)) ?? "";
+			if (state) messages[messages.length - 1] = Array.isArray(last.content) ? {
+				...last,
+				content: [...last.content, {
+					type: "text",
+					text: state.trim()
+				}]
+			} : {
+				...last,
+				content: (last.content ?? "") + state
+			};
+			return {
+				messages,
+				parts
+			};
+		};
 		if (((_this$snapshot2 = this.snapshot) === null || _this$snapshot2 === void 0 ? void 0 : _this$snapshot2.status.type) === "resolved") return withParts([systemMessage, this.version.getSnapshotResolvedMessage({ snapshot: this.snapshot })]);
 		if (((_this$snapshot3 = this.snapshot) === null || _this$snapshot3 === void 0 ? void 0 : _this$snapshot3.status.type) === "rejected") return withParts([systemMessage, this.version.getSnapshotRejectedMessage({ snapshot: this.snapshot })]);
 		if (!lastIteration) return withParts([systemMessage, await this.version.getInitialUserMessage(promptProps)]);
-		const lastIterationMessages = [systemMessage, ...lastIteration.messages.filter((x) => x.role !== "system")];
+		const history = lastIteration.messages.slice();
+		if (previousLastMessage) history[history.length - 1] = previousLastMessage;
+		const lastIterationMessages = [systemMessage, ...history.filter((x) => x.role !== "system")];
 		if ((lastIteration === null || lastIteration === void 0 ? void 0 : lastIteration.status.type) === "thinking_requested") {
-			var _lastIteration$llm;
+			var _lastIteration$llm, _lastIteration$llm2;
 			return withParts([
 				...lastIterationMessages,
 				{
@@ -2377,60 +2452,80 @@ var Context = class {
 					})
 				},
 				await this.version.getThinkingMessage({
+					isChatEnabled: parameters.components.length > 0,
 					reason: lastIteration.status.thinking_requested.reason,
-					variables: lastIteration.status.thinking_requested.variables
+					variables: lastIteration.status.thinking_requested.variables,
+					interrupted: lastIteration.status.thinking_requested.interrupted,
+					discardedMessages: (_lastIteration$llm2 = lastIteration.llm) === null || _lastIteration$llm2 === void 0 || (_lastIteration$llm2 = _lastIteration$llm2.diagnostics) === null || _lastIteration$llm2 === void 0 ? void 0 : _lastIteration$llm2.some((diagnostic) => diagnostic.code === "send-after-run")
 				})
 			]);
 		}
 		if ((lastIteration === null || lastIteration === void 0 ? void 0 : lastIteration.status.type) === "exit_error") {
-			var _lastIteration$llm2;
+			var _lastIteration$llm3;
 			return withParts([
 				...lastIterationMessages,
 				{
 					role: "assistant",
-					content: require_truncator.wrapContent(((_lastIteration$llm2 = lastIteration.llm) === null || _lastIteration$llm2 === void 0 ? void 0 : _lastIteration$llm2.output) ?? "", {
+					content: require_truncator.wrapContent(((_lastIteration$llm3 = lastIteration.llm) === null || _lastIteration$llm3 === void 0 ? void 0 : _lastIteration$llm3.output) ?? "", {
 						preserve: "top",
 						flex: 4,
 						minTokens: 25
 					})
 				},
 				await this.version.getInvalidCodeMessage({
-					code: lastIteration.code ?? "// No code generated",
-					message: `Invalid return statement (action: ${lastIteration.status.exit_error.exit}): ${lastIteration.status.exit_error.message}`
+					isChatEnabled: parameters.components.length > 0,
+					code: lastIteration.next ? `■next=${lastIteration.next.name} ${JSON.stringify(lastIteration.next.props)}` : lastIteration.code ?? "// No code generated",
+					message: `Invalid ■next block (${lastIteration.status.exit_error.exit}): ${lastIteration.status.exit_error.message}`,
+					variables: lastIteration.variables,
+					toolCalls: lastIteration.traces.filter((trace) => trace.type === "tool_call").map((trace) => ({
+						tool: trace.tool_name,
+						input: trace.input,
+						success: trace.success,
+						...trace.success ? { output: trace.output } : { error: require_utils.getErrorMessage(trace.error) }
+					}))
 				})
 			]);
 		}
 		if ((lastIteration === null || lastIteration === void 0 ? void 0 : lastIteration.status.type) === "invalid_code_error") {
-			var _lastIteration$llm3;
+			var _lastIteration$llm4;
 			return withParts([
 				...lastIterationMessages,
 				{
 					role: "assistant",
-					content: require_truncator.wrapContent(((_lastIteration$llm3 = lastIteration.llm) === null || _lastIteration$llm3 === void 0 ? void 0 : _lastIteration$llm3.output) ?? "", {
+					content: require_truncator.wrapContent(((_lastIteration$llm4 = lastIteration.llm) === null || _lastIteration$llm4 === void 0 ? void 0 : _lastIteration$llm4.output) ?? "", {
 						preserve: "top",
 						flex: 4,
 						minTokens: 25
 					})
 				},
 				await this.version.getInvalidCodeMessage({
+					isChatEnabled: parameters.components.length > 0,
 					code: lastIteration.code ?? "// No code generated",
 					message: lastIteration.status.invalid_code_error.message
 				})
 			]);
 		}
 		if ((lastIteration === null || lastIteration === void 0 ? void 0 : lastIteration.status.type) === "execution_error") {
-			var _lastIteration$llm4;
+			var _lastIteration$llm5;
 			return withParts([
 				...lastIterationMessages,
 				{
 					role: "assistant",
-					content: require_truncator.wrapContent(((_lastIteration$llm4 = lastIteration.llm) === null || _lastIteration$llm4 === void 0 ? void 0 : _lastIteration$llm4.output) ?? "", {
+					content: require_truncator.wrapContent(((_lastIteration$llm5 = lastIteration.llm) === null || _lastIteration$llm5 === void 0 ? void 0 : _lastIteration$llm5.output) ?? "", {
 						preserve: "top",
 						flex: 4,
 						minTokens: 25
 					})
 				},
 				await this.version.getCodeExecutionErrorMessage({
+					isChatEnabled: parameters.components.length > 0,
+					variables: lastIteration.variables,
+					toolCalls: lastIteration.traces.filter((trace) => trace.type === "tool_call").map((trace) => ({
+						tool: trace.tool_name,
+						input: trace.input,
+						success: trace.success,
+						...trace.success ? { output: trace.output } : { error: require_utils.getErrorMessage(trace.error) }
+					})),
 					message: lastIteration.status.execution_error.message,
 					stacktrace: lastIteration.status.execution_error.stack
 				})
@@ -2441,6 +2536,7 @@ var Context = class {
 	async _refreshIterationParameters() {
 		var _this$chat, _this$chat2;
 		const instructions = await getValue(this.instructions, this);
+		const examples = await getValue(this.examples, this);
 		const transcript = new TranscriptArray(await getValue(((_this$chat = this.chat) === null || _this$chat === void 0 ? void 0 : _this$chat.transcript) ?? [], this));
 		const tools = require_tool.Tool.withUniqueNames(await getValue(this.tools, this) ?? []);
 		const objects = await getValue(this.objects, this) ?? [];
@@ -2497,6 +2593,7 @@ var Context = class {
 			objects,
 			exits,
 			instructions,
+			examples,
 			components,
 			model,
 			temperature,
@@ -2506,6 +2603,7 @@ var Context = class {
 	constructor(props) {
 		this.id = `llmz_${(0, ulid.ulid)()}`;
 		this.instructions = props.instructions;
+		this.examples = props.examples;
 		this.objects = props.objects;
 		this.tools = props.tools;
 		this.exits = props.exits;