llmz 1.0.1 → 1.0.3

package/dist/runtime/tool-wrapper.d.ts

@@ -1,6 +1,7 @@
 import { Iteration } from '../context.js';
 import { type Tool } from '../tool.js';
-import type { TruncationPolicy } from '../truncate.js';
+import { type TruncationPolicy } from '../truncate.js';
+import type { ForcedInspection } from './forced-inspection.js';
 import { ExecutionHooks } from './types.js';
 type ToolWrapperProps = {
     tool: Tool;
@@ -11,6 +12,7 @@ type ToolWrapperProps = {
     onTruncation?: (value: unknown, policy: TruncationPolicy) => void;
     onResult?: (value: unknown) => void;
     controller: AbortController;
+    onThink?: (inspection: ForcedInspection) => void;
 };
-export declare function wrapTool({ tool, object, iteration, beforeHook, afterHook, onTruncation, onResult, controller, }: ToolWrapperProps): (input: any) => Promise<any>;
+export declare function wrapTool({ tool, object, iteration, beforeHook, afterHook, onTruncation, onResult, controller, onThink, }: ToolWrapperProps): (input: any, line?: number) => Promise<any>;
 export {};

package/dist/runtime/types.d.ts

@@ -126,6 +126,14 @@ export type ExecutionHooks = {
     } | void>;
 };
 type Options = Partial<Pick<Context, 'loop' | 'timeout'>> & {
+    /**
+     * Require the assistant to be the last participant who spoke before the built-in
+     * ListenExit can complete. Defaults to true. Successful text and component delivery
+     * count across iterations and executions; events and tool results do not.
+     * Set false for intentionally silent chat handling. Custom exits and workers
+     * are unaffected. Rejection is recoverable within the remaining loop budget.
+     */
+    requireChatResponse?: boolean;
     /**
      * Optional cap on the model's context window, in tokens.
      * The effective limit is `min(maxTokens, smallest configured model input limit)`.

package/dist/{schema-DBkjo0b7.cjs → schema-CXlnbb3n.cjs}

@@ -1,4 +1,4 @@
-const require_errors = require("./errors-IhnTKUp7.cjs");
+const require_errors = require("./errors-C6ppQUZX.cjs");
 let _bpinternal_zui = require("@bpinternal/zui");
 //#region src/schema.ts
 const INPUT_SCHEMA_OPTIONS = {

package/dist/{schema-Aer_W7Al.js → schema-GE4ISPCR.js}

@@ -1,4 +1,4 @@
-import { H as isLLMzError, b as InvalidConfigurationError } from "./errors-H4JJFH3S.js";
+import { U as isLLMzError, b as InvalidConfigurationError } from "./errors-Crk5P8jo.js";
 import { transforms, z } from "@bpinternal/zui";
 //#region src/schema.ts
 const INPUT_SCHEMA_OPTIONS = {

package/dist/session/messages.d.ts

@@ -10,6 +10,8 @@ export type AssistantResponse = {
     continuation?: unknown;
 };
 export declare function normalizeInput(message: SessionInput): SessionMessage;
+/** Only actual participant content counts as speech, including image/audio-only messages. */
+export declare function inputSpeaker(message: SessionMessage): 'user' | 'assistant' | null;
 export declare function createAssistantMessage(response: AssistantResponse): SessionMessage;
 export declare function validateInputMessage(message: CognitiveMessage): void;
 export declare function validateMessageContent(message: CognitiveMessage): void;

package/dist/session/serialization.d.ts

@@ -23,6 +23,8 @@ export type SessionState = {
     memory: SerializedMemory;
     pendingInputs: PendingInput[];
     activeTurn: boolean;
+    /** Acknowledged conversation speaker, independent of retained/compacted history. Absent in older snapshots. */
+    lastSpeaker?: 'user' | 'assistant' | null;
     latestResultId?: string;
     compaction?: false | Omit<CompactionOptions, 'summarize'>;
 };

package/dist/session/session.d.ts

@@ -45,6 +45,10 @@ export declare class Session {
     get messages(): SessionMessage[];
     /** Retained conversation plus queued input, preserving event and summary roles. Returns a detached copy. */
     get transcript(): SessionInput[];
+    /** Last participant who spoke in the active history. Events and queued inputs do not count. */
+    get lastSpeaker(): 'user' | 'assistant' | null;
+    /** Record acknowledged text or component delivery, never generation alone. */
+    recordAssistantDelivery(iterationId: string): void;
     get pendingMessages(): SessionMessage[];
     get hasActiveTurn(): boolean;
     get status(): 'idle' | 'pending' | 'active';

package/dist/session/speaker.test.d.ts

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

package/dist/{tool--gK91eez.js → tool-DstssiAs.js}

@@ -1,9 +1,9 @@
 import { F as isBuffer, I as isArguments, L as isPrototype, M as isTypedArray, R as isArrayLike, U as isArray, Y as __exportAll, c as isValidIdentifier, j as baseKeys, l as isZuiSchema, n as fromJSONSchemaCompat, s as isJsonSchema, x as _getTag_default } from "./utils-BOFzb8Ok.js";
-import { E as InvalidToolError, H as isLLMzError, I as ToolExecutionError, L as ToolInputError, V as isCriticalError, r as VMSignal } from "./errors-H4JJFH3S.js";
+import { E as InvalidToolError, H as isCriticalError, L as ToolExecutionError, R as ToolInputError, U as isLLMzError, r as VMSignal } from "./errors-Crk5P8jo.js";
 import { t as uniq } from "./uniq-DfUeSNaX.js";
-import { i as toModelSchema, r as schemaInput, t as parseSchemaAsync } from "./schema-Aer_W7Al.js";
-import { i as unwrapTruncated, n as isTruncated } from "./truncate-BSoH2-nY.js";
-import { t as getTypings } from "./typings-D9_aC8aq.js";
+import { i as toModelSchema, r as schemaInput, t as parseSchemaAsync } from "./schema-GE4ISPCR.js";
+import { i as unwrapTruncated, n as isTruncated } from "./truncate-BEKbdo3t.js";
+import { t as getTypings } from "./typings-BEVDvtuk.js";
 import { transforms, z } from "@bpinternal/zui";
 //#region ../../node_modules/.pnpm/lodash-es@4.17.21/node_modules/lodash-es/isEmpty.js
 /** `Object#toString` result references. */

package/dist/{tool-Da_F-N-5.cjs → tool-_wK9hQOb.cjs}

@@ -1,9 +1,9 @@
 const require_utils = require("./utils-CTlsXvdj.cjs");
-const require_errors = require("./errors-IhnTKUp7.cjs");
+const require_errors = require("./errors-C6ppQUZX.cjs");
 const require_uniq = require("./uniq-DiXgysNV.cjs");
-const require_schema = require("./schema-DBkjo0b7.cjs");
-const require_truncate = require("./truncate-nV3Mxr6-.cjs");
-const require_typings = require("./typings-C1ihexWE.cjs");
+const require_schema = require("./schema-CXlnbb3n.cjs");
+const require_truncate = require("./truncate-uomAMGPs.cjs");
+const require_typings = require("./typings-BA_XxAcY.cjs");
 let _bpinternal_zui = require("@bpinternal/zui");
 //#region ../../node_modules/.pnpm/lodash-es@4.17.21/node_modules/lodash-es/isEmpty.js
 /** `Object#toString` result references. */

package/dist/{truncate-BSoH2-nY.js → truncate-BEKbdo3t.js}

@@ -1,4 +1,4 @@
-import { b as InvalidConfigurationError } from "./errors-H4JJFH3S.js";
+import { b as InvalidConfigurationError } from "./errors-Crk5P8jo.js";
 //#region src/truncate.ts
 const TRUNCATE_SIGNATURE = "llmz.truncate.v1";
 const DEFAULT_TOOL_RESULT_MAX_TOKENS = 2e3;

package/dist/{truncate-nV3Mxr6-.cjs → truncate-uomAMGPs.cjs}

@@ -1,4 +1,4 @@
-const require_errors = require("./errors-IhnTKUp7.cjs");
+const require_errors = require("./errors-C6ppQUZX.cjs");
 //#region src/truncate.ts
 const TRUNCATE_SIGNATURE = "llmz.truncate.v1";
 const DEFAULT_TOOL_RESULT_MAX_TOKENS = 2e3;

package/dist/types.d.ts

@@ -35,6 +35,12 @@ export declare namespace Traces {
         duration: number;
     }>;
     type ThinkSignal = TraceTemplate<'think_signal', {
+        tool_name?: string;
+        tool_call_id?: string;
+        object?: string;
+        reason?: string;
+        context?: unknown;
+        metadata?: Record<string, unknown>;
         line: number;
     }>;
     type PropertyMutation = TraceTemplate<'property', {

package/dist/{typings-C1ihexWE.cjs → typings-BA_XxAcY.cjs}

@@ -1,5 +1,5 @@
 const require_utils = require("./utils-CTlsXvdj.cjs");
-const require_errors = require("./errors-IhnTKUp7.cjs");
+const require_errors = require("./errors-C6ppQUZX.cjs");
 let _bpinternal_zui = require("@bpinternal/zui");
 //#region src/typings-formatter.ts
 /**

package/dist/{typings-D9_aC8aq.js → typings-BEVDvtuk.js}

@@ -1,5 +1,5 @@
 import { Y as __exportAll, d as toPropertyKey, i as getMultilineComment, n as fromJSONSchemaCompat } from "./utils-BOFzb8Ok.js";
-import { b as InvalidConfigurationError, c as CodeFormattingError } from "./errors-H4JJFH3S.js";
+import { b as InvalidConfigurationError, c as CodeFormattingError } from "./errors-Crk5P8jo.js";
 import { transforms, z } from "@bpinternal/zui";
 //#region src/typings-formatter.ts
 /**

package/dist/vm/types.d.ts

@@ -5,6 +5,7 @@ import type { Trace, VMExecutionResult } from '../types.js';
 /** Host-only lifecycle hook; symbols are not copied into the generated program's globals. */
 export declare const VM_PROGRAM_COMPLETE: unique symbol;
 export declare const VM_TERMINATION: unique symbol;
+export declare const VM_CALL_SITE: unique symbol;
 export declare const VM_ON_ERROR: unique symbol;
 export type VMTermination = {
     isTerminated(): boolean;
@@ -13,6 +14,7 @@ export type VMTermination = {
     getSignal?(): VMSignal | undefined;
 };
 export type VMContext = Record<string, any> & {
+    [VM_CALL_SITE]?: () => number | undefined;
     [VM_ON_ERROR]?: (error: LLMzFailure) => void;
     [VM_PROGRAM_COMPLETE]?: () => void;
     [VM_TERMINATION]?: VMTermination;

package/dist/{vm-8jxt8PTK.js → vm-C7SfutHn.js}

@@ -1,6 +1,6 @@
 import { A as keys, B as baseAssignValue, J as __commonJSMin, V as isFunction, W as isSymbol, h as baseIteratee } from "./utils-BOFzb8Ok.js";
-import { B as UnknownToolError, H as isLLMzError, N as ReservedIdentifierError, o as AssignmentError, r as VMSignal, s as CodeExecutionError, t as Signals, v as InvalidCodeError } from "./errors-H4JJFH3S.js";
-import { a as cloneMemoryValue, d as TERMINATION_BINDING_NAMES, l as RESERVED_RUNTIME_NAMES, n as getQuickJSVariant, o as decodeMemoryValue, u as RUNTIME_BINDING_NAMES } from "./quickjs-variant-DlPi9-Sx.js";
+import { P as ReservedIdentifierError, U as isLLMzError, V as UnknownToolError, o as AssignmentError, r as VMSignal, s as CodeExecutionError, t as Signals, v as InvalidCodeError } from "./errors-Crk5P8jo.js";
+import { a as cloneMemoryValue, d as TERMINATION_BINDING_NAMES, l as RESERVED_RUNTIME_NAMES, n as getQuickJSVariant, o as decodeMemoryValue, u as RUNTIME_BINDING_NAMES } from "./quickjs-variant-CtuGagsb.js";
 import MagicString from "magic-string";
 import { parse } from "acorn";
 import { newQuickJSWASMModuleFromVariant, shouldInterruptAfterDeadline } from "quickjs-emscripten-core";
@@ -2994,6 +2994,7 @@ function formatError(err, lines, matches, traces, variables, lines_executed, cod
 /** Host-only lifecycle hook; symbols are not copied into the generated program's globals. */
 const VM_PROGRAM_COMPLETE = Symbol("llmz.programComplete");
 const VM_TERMINATION = Symbol("llmz.termination");
+const VM_CALL_SITE = Symbol("llmz.callSite");
 const VM_ON_ERROR = Symbol("llmz.onError");
 //#endregion
 //#region src/vm/instrument.ts
@@ -3121,6 +3122,16 @@ var NodeDriver = class {
 	async execute(ctx) {
 		const { transformed, consumer, context, traces, recordTrace, code, lines_executed, variables } = ctx;
 		const state = instrumentContext(context, transformed, recordTrace, variables, lines_executed, consumer, findUserCodeStartLine(transformed), ctx.memoryNames);
+		context[VM_CALL_SITE] = () => {
+			var _Error$stack;
+			const frame = (_Error$stack = (/* @__PURE__ */ new Error()).stack) === null || _Error$stack === void 0 ? void 0 : _Error$stack.match(/<anonymous>:(\d+):(\d+)/);
+			if (!frame) return;
+			const position = consumer.originalPositionFor({
+				line: Number(frame[1]) - 1,
+				column: Number(frame[2])
+			});
+			return position.line ? Math.max(1, position.line - 3) : void 0;
+		};
 		const AsyncFunction = async function() {}.constructor;
 		return finalizeMemoryCapture(await (async () => {
 			const descriptors = Object.getOwnPropertyDescriptors(context);
@@ -3273,6 +3284,20 @@ var QuickJSDriver = class {
 		const disposeIfNeeded = (handle) => {
 			if (handle !== vm.true && handle !== vm.false && handle !== vm.null && handle !== vm.undefined) handle.dispose();
 		};
+		context[VM_CALL_SITE] = () => {
+			const stack = vm.evalCode("new Error().stack");
+			if ("error" in stack) {
+				var _stack$error;
+				(_stack$error = stack.error) === null || _stack$error === void 0 || _stack$error.dispose();
+				return;
+			}
+			try {
+				const frame = vm.getString(stack.value).match(/<quickjs>:(\d+)/);
+				return frame ? Math.max(1, Number(frame[1]) - 9 - userCodeStartLine + 1) : void 0;
+			} finally {
+				stack.value.dispose();
+			}
+		};
 		const bridgeFunction = (fn, _fnName = "anonymous") => {
 			return (...argHandles) => {
 				const args = argHandles.map((h) => vm.dump(h));
@@ -3956,4 +3981,4 @@ async function runAsyncFunction(context, code, traces = [], signal = null, timeo
 	});
 }
 //#endregion
-export { compile as a, VM_TERMINATION as i, VM_ON_ERROR as n, VM_PROGRAM_COMPLETE as r, runAsyncFunction, withMissingMember as t };
+export { VM_TERMINATION as a, VM_PROGRAM_COMPLETE as i, VM_CALL_SITE as n, compile as o, VM_ON_ERROR as r, runAsyncFunction, withMissingMember as t };

package/dist/{vm-XuVPuW3Y.cjs → vm-gmekHc0i.cjs}

@@ -1,6 +1,6 @@
 const require_utils = require("./utils-CTlsXvdj.cjs");
-const require_errors = require("./errors-IhnTKUp7.cjs");
-const require_quickjs_variant = require("./quickjs-variant-DJwYDSsb.cjs");
+const require_errors = require("./errors-C6ppQUZX.cjs");
+const require_quickjs_variant = require("./quickjs-variant-21IO97PF.cjs");
 let magic_string = require("magic-string");
 magic_string = require_utils.__toESM(magic_string, 1);
 let acorn = require("acorn");
@@ -2995,6 +2995,7 @@ function formatError(err, lines, matches, traces, variables, lines_executed, cod
 /** Host-only lifecycle hook; symbols are not copied into the generated program's globals. */
 const VM_PROGRAM_COMPLETE = Symbol("llmz.programComplete");
 const VM_TERMINATION = Symbol("llmz.termination");
+const VM_CALL_SITE = Symbol("llmz.callSite");
 const VM_ON_ERROR = Symbol("llmz.onError");
 //#endregion
 //#region src/vm/instrument.ts
@@ -3122,6 +3123,16 @@ var NodeDriver = class {
 	async execute(ctx) {
 		const { transformed, consumer, context, traces, recordTrace, code, lines_executed, variables } = ctx;
 		const state = instrumentContext(context, transformed, recordTrace, variables, lines_executed, consumer, findUserCodeStartLine(transformed), ctx.memoryNames);
+		context[VM_CALL_SITE] = () => {
+			var _Error$stack;
+			const frame = (_Error$stack = (/* @__PURE__ */ new Error()).stack) === null || _Error$stack === void 0 ? void 0 : _Error$stack.match(/<anonymous>:(\d+):(\d+)/);
+			if (!frame) return;
+			const position = consumer.originalPositionFor({
+				line: Number(frame[1]) - 1,
+				column: Number(frame[2])
+			});
+			return position.line ? Math.max(1, position.line - 3) : void 0;
+		};
 		const AsyncFunction = async function() {}.constructor;
 		return finalizeMemoryCapture(await (async () => {
 			const descriptors = Object.getOwnPropertyDescriptors(context);
@@ -3274,6 +3285,20 @@ var QuickJSDriver = class {
 		const disposeIfNeeded = (handle) => {
 			if (handle !== vm.true && handle !== vm.false && handle !== vm.null && handle !== vm.undefined) handle.dispose();
 		};
+		context[VM_CALL_SITE] = () => {
+			const stack = vm.evalCode("new Error().stack");
+			if ("error" in stack) {
+				var _stack$error;
+				(_stack$error = stack.error) === null || _stack$error === void 0 || _stack$error.dispose();
+				return;
+			}
+			try {
+				const frame = vm.getString(stack.value).match(/<quickjs>:(\d+)/);
+				return frame ? Math.max(1, Number(frame[1]) - 9 - userCodeStartLine + 1) : void 0;
+			} finally {
+				stack.value.dispose();
+			}
+		};
 		const bridgeFunction = (fn, _fnName = "anonymous") => {
 			return (...argHandles) => {
 				const args = argHandles.map((h) => vm.dump(h));
@@ -3957,6 +3982,7 @@ async function runAsyncFunction(context, code, traces = [], signal = null, timeo
 	});
 }
 //#endregion
+exports.VM_CALL_SITE = VM_CALL_SITE;
 exports.VM_ON_ERROR = VM_ON_ERROR;
 exports.VM_PROGRAM_COMPLETE = VM_PROGRAM_COMPLETE;
 exports.VM_TERMINATION = VM_TERMINATION;

package/package.json

@@ -2,7 +2,7 @@
   "name": "llmz",
   "type": "module",
   "description": "LLMz - An LLM-native Typescript VM built on top of Zui",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "files": [
     "dist",
     "DOCS.md",
@@ -30,6 +30,7 @@
     "watch": "tsdown --watch",
     "test": "vitest --run",
     "test:e2e": "pnpm check:e2e:type && vitest run --config vitest.e2e.config.ts",
+    "test:e2e:quarantine": "vitest run --config vitest.quarantine.config.ts production-chat",
     "test:e2e:update": "vitest -u run --config vitest.e2e.config.ts",
     "test:e2e:watch": "vitest --config vitest.e2e.config.ts",
     "check:format": "oxfmt --check .",