llmz 1.0.1 → 1.0.2

package/dist/inspection.d.ts

@@ -36,3 +36,5 @@ export type InspectionOptions = {
 export type Inspector = (value: unknown, options: InspectionOptions) => string;
 /** The shared boundary for values displayed in prompts, reports, and memory inventories. */
 export declare function createInspector(onInspect?: OnInspect): Inspector;
+/** Isolate evidence from subsequent guest mutations without invoking getters. */
+export declare function snapshotInspectionValue(value: unknown, copies?: WeakMap<object, unknown>): unknown;

package/dist/{native-Bm6L9zOb.cjs → native-0bq5ATZM.cjs}

@@ -1,6 +1,6 @@
 const require_utils = require("./utils-CTlsXvdj.cjs");
-const require_errors = require("./errors-IhnTKUp7.cjs");
-const require_typings = require("./typings-C1ihexWE.cjs");
+const require_errors = require("./errors-C6ppQUZX.cjs");
+const require_typings = require("./typings-BA_XxAcY.cjs");
 //#region src/chat/response.ts
 const presets = {
 	markdown: { instructions: "Write natural Markdown directly in the assistant response. Use paragraphs, lists, links, and code blocks where useful. Do not wrap the entire response in JSON or a Markdown fence." },
@@ -122,7 +122,7 @@ function runtimeRules(props, chat) {
 	}
 	rules.push("Execution may overlap the remaining response stream. The runtime waits for the stream, code, and queued message deliveries before the next response.", "# Memory", "Declare retained variables at top level with const or let. Bare assignment only updates a variable already declared in this program or listed in Memory. Named variables survive transcript compaction; assignment age records when they were set, not when the underlying data was fetched.", "Object properties are immutable snapshots. Replace a writable property completely, such as account.profile = { ...account.profile, age: 42 }; nested edits are forbidden and replacements are schema-validated.", "$return is the latest successful inspection result. $iterations is read-only retained history, newest first: [0] is the last settled iteration and [1] the preceding one. The current execution is not included. Entries without results still occupy indexes; check hasResult. Compaction prunes automatic results. Assign useful data to named variables to retain it independently.", "# Recovery", "Execution reports identify completed actions, inspected values, memory changes, and errors. Reuse preserved variables and completed actions; retry only failed work. Build completion payloads from those values, not by calling successful tools again. An inspection has already run the recorded calls; it is not a dry run.", "An operational error does not by itself finish the task. Inspect the actual error, repair its cause when safe and authorized, then retry. Unchanged retries do not establish that recovery is exhausted. If another response must diagnose the error, return inspect({ errors, completed }) or let the error reach the runtime. Honor task instructions defining terminal failure outcomes.");
 	if (hasExits) rules.push("Use a failure exit only when recovery is unavailable, unsafe, forbidden, its budget is exhausted, or task instructions make the failure terminal. Do not select failure in advance for an unseen error. Do not turn an unexpected exception or rejected Promise.allSettled entry directly into failure completion: first expose it with inspect or let it reach the runtime, then diagnose the actual cause and available recovery tools. Explicit task instructions may define an error as terminal.");
-	rules.push("A thinking interruption stops the current program and requests another model response. Statements after the interruption have not run; continue with a new program without repeating completed actions.", "Respect tool-attempt limits separately from the model-response budget. An empty successful inspection result is not a failure.");
+	rules.push("A tool may request forced inspection through ThinkSignal. The tool succeeded and its context is returned to JavaScript. Other calls and assignments continue normally. At the end of the program, forced inspection takes precedence over completion: review the reported results as an inspect() call, then continue from retained values without repeating successful calls.", "Respect tool-attempt limits separately from the model-response budget. An empty successful inspection result is not a failure.");
 	return rules.join("\n\n");
 }
 async function describeRuntimeAPI(props, chat) {

package/dist/{native-DvTH9vFe.js → native-n_718Z-T.js}

@@ -1,6 +1,6 @@
 import { Y as __exportAll, i as getMultilineComment } from "./utils-BOFzb8Ok.js";
-import { b as InvalidConfigurationError } from "./errors-H4JJFH3S.js";
-import { i as formatTypings, t as getTypings } from "./typings-D9_aC8aq.js";
+import { b as InvalidConfigurationError } from "./errors-Crk5P8jo.js";
+import { i as formatTypings, t as getTypings } from "./typings-BEVDvtuk.js";
 //#region src/chat/response.ts
 const presets = {
 	markdown: { instructions: "Write natural Markdown directly in the assistant response. Use paragraphs, lists, links, and code blocks where useful. Do not wrap the entire response in JSON or a Markdown fence." },
@@ -122,7 +122,7 @@ function runtimeRules(props, chat) {
 	}
 	rules.push("Execution may overlap the remaining response stream. The runtime waits for the stream, code, and queued message deliveries before the next response.", "# Memory", "Declare retained variables at top level with const or let. Bare assignment only updates a variable already declared in this program or listed in Memory. Named variables survive transcript compaction; assignment age records when they were set, not when the underlying data was fetched.", "Object properties are immutable snapshots. Replace a writable property completely, such as account.profile = { ...account.profile, age: 42 }; nested edits are forbidden and replacements are schema-validated.", "$return is the latest successful inspection result. $iterations is read-only retained history, newest first: [0] is the last settled iteration and [1] the preceding one. The current execution is not included. Entries without results still occupy indexes; check hasResult. Compaction prunes automatic results. Assign useful data to named variables to retain it independently.", "# Recovery", "Execution reports identify completed actions, inspected values, memory changes, and errors. Reuse preserved variables and completed actions; retry only failed work. Build completion payloads from those values, not by calling successful tools again. An inspection has already run the recorded calls; it is not a dry run.", "An operational error does not by itself finish the task. Inspect the actual error, repair its cause when safe and authorized, then retry. Unchanged retries do not establish that recovery is exhausted. If another response must diagnose the error, return inspect({ errors, completed }) or let the error reach the runtime. Honor task instructions defining terminal failure outcomes.");
 	if (hasExits) rules.push("Use a failure exit only when recovery is unavailable, unsafe, forbidden, its budget is exhausted, or task instructions make the failure terminal. Do not select failure in advance for an unseen error. Do not turn an unexpected exception or rejected Promise.allSettled entry directly into failure completion: first expose it with inspect or let it reach the runtime, then diagnose the actual cause and available recovery tools. Explicit task instructions may define an error as terminal.");
-	rules.push("A thinking interruption stops the current program and requests another model response. Statements after the interruption have not run; continue with a new program without repeating completed actions.", "Respect tool-attempt limits separately from the model-response budget. An empty successful inspection result is not a failure.");
+	rules.push("A tool may request forced inspection through ThinkSignal. The tool succeeded and its context is returned to JavaScript. Other calls and assignments continue normally. At the end of the program, forced inspection takes precedence over completion: review the reported results as an inspect() call, then continue from retained values without repeating successful calls.", "Respect tool-attempt limits separately from the model-response budget. An empty successful inspection result is not a failure.");
 	return rules.join("\n\n");
 }
 async function describeRuntimeAPI(props, chat) {

package/dist/{quickjs-variant-DJwYDSsb.cjs → quickjs-variant-21IO97PF.cjs}

@@ -1,8 +1,8 @@
 const require_utils = require("./utils-CTlsXvdj.cjs");
-const require_errors = require("./errors-IhnTKUp7.cjs");
-const require_schema = require("./schema-DBkjo0b7.cjs");
-const require_truncate = require("./truncate-nV3Mxr6-.cjs");
-const require_typings = require("./typings-C1ihexWE.cjs");
+const require_errors = require("./errors-C6ppQUZX.cjs");
+const require_schema = require("./schema-CXlnbb3n.cjs");
+const require_truncate = require("./truncate-uomAMGPs.cjs");
+const require_typings = require("./typings-BA_XxAcY.cjs");
 //#region src/inspect.ts
 const SUBTITLE_LN = "--------------";
 const TRUNCATION_MARKER = "[truncated]";
@@ -401,7 +401,7 @@ function createInspector(onInspect) {
 		if (onInspect) try {
 			const budget = resolveInspectionBudget(value, formatting);
 			const output = onInspect(Object.freeze({
-				value: snapshot(value),
+				value: snapshotInspectionValue(value),
 				purpose: options.purpose,
 				maxTokens: budget.tokens,
 				preserve: budget.preserve,
@@ -413,12 +413,13 @@ function createInspector(onInspect) {
 		return inspect(value, void 0, formatting);
 	};
 }
-function snapshot(value, copies = /* @__PURE__ */ new WeakMap()) {
+/** Isolate evidence from subsequent guest mutations without invoking getters. */
+function snapshotInspectionValue(value, copies = /* @__PURE__ */ new WeakMap()) {
 	if (!value || typeof value !== "object") return typeof value === "function" ? "[Function]" : value;
 	if (copies.has(value)) return copies.get(value);
 	if (require_truncate.isTruncated(value)) {
 		copies.set(value, "[Circular]");
-		const copy = snapshot(value.value, copies);
+		const copy = snapshotInspectionValue(value.value, copies);
 		copies.set(value, copy);
 		return copy;
 	}
@@ -429,7 +430,7 @@ function snapshot(value, copies = /* @__PURE__ */ new WeakMap()) {
 		if (Array.isArray(value) && key === "length") continue;
 		const descriptor = Object.getOwnPropertyDescriptor(value, key);
 		if (descriptor) Object.defineProperty(copy, key, {
-			value: "value" in descriptor ? snapshot(descriptor.value, copies) : "[Getter]",
+			value: "value" in descriptor ? snapshotInspectionValue(descriptor.value, copies) : "[Getter]",
 			enumerable: descriptor.enumerable
 		});
 	}
@@ -1071,3 +1072,9 @@ Object.defineProperty(exports, "resolveInspectionBudget", {
 		return resolveInspectionBudget;
 	}
 });
+Object.defineProperty(exports, "snapshotInspectionValue", {
+	enumerable: true,
+	get: function() {
+		return snapshotInspectionValue;
+	}
+});

package/dist/{quickjs-variant-DlPi9-Sx.js → quickjs-variant-CtuGagsb.js}

@@ -1,8 +1,8 @@
 import { a as getTokenizer } from "./utils-BOFzb8Ok.js";
-import { A as MemoryValueError, N as ReservedIdentifierError, b as InvalidConfigurationError, k as MemoryCapacityError, o as AssignmentError } from "./errors-H4JJFH3S.js";
-import { i as toModelSchema } from "./schema-Aer_W7Al.js";
-import { n as isTruncated } from "./truncate-BSoH2-nY.js";
-import { t as getTypings } from "./typings-D9_aC8aq.js";
+import { A as MemoryValueError, P as ReservedIdentifierError, b as InvalidConfigurationError, k as MemoryCapacityError, o as AssignmentError } from "./errors-Crk5P8jo.js";
+import { i as toModelSchema } from "./schema-GE4ISPCR.js";
+import { n as isTruncated } from "./truncate-BEKbdo3t.js";
+import { t as getTypings } from "./typings-BEVDvtuk.js";
 //#region src/inspect.ts
 const SUBTITLE_LN = "--------------";
 const TRUNCATION_MARKER = "[truncated]";
@@ -401,7 +401,7 @@ function createInspector(onInspect) {
 		if (onInspect) try {
 			const budget = resolveInspectionBudget(value, formatting);
 			const output = onInspect(Object.freeze({
-				value: snapshot(value),
+				value: snapshotInspectionValue(value),
 				purpose: options.purpose,
 				maxTokens: budget.tokens,
 				preserve: budget.preserve,
@@ -413,12 +413,13 @@ function createInspector(onInspect) {
 		return inspect(value, void 0, formatting);
 	};
 }
-function snapshot(value, copies = /* @__PURE__ */ new WeakMap()) {
+/** Isolate evidence from subsequent guest mutations without invoking getters. */
+function snapshotInspectionValue(value, copies = /* @__PURE__ */ new WeakMap()) {
 	if (!value || typeof value !== "object") return typeof value === "function" ? "[Function]" : value;
 	if (copies.has(value)) return copies.get(value);
 	if (isTruncated(value)) {
 		copies.set(value, "[Circular]");
-		const copy = snapshot(value.value, copies);
+		const copy = snapshotInspectionValue(value.value, copies);
 		copies.set(value, copy);
 		return copy;
 	}
@@ -429,7 +430,7 @@ function snapshot(value, copies = /* @__PURE__ */ new WeakMap()) {
 		if (Array.isArray(value) && key === "length") continue;
 		const descriptor = Object.getOwnPropertyDescriptor(value, key);
 		if (descriptor) Object.defineProperty(copy, key, {
-			value: "value" in descriptor ? snapshot(descriptor.value, copies) : "[Getter]",
+			value: "value" in descriptor ? snapshotInspectionValue(descriptor.value, copies) : "[Getter]",
 			enumerable: descriptor.enumerable
 		});
 	}
@@ -981,4 +982,4 @@ const configureQuickJS = (variant) => {
 };
 const getQuickJSVariant = () => _activeVariant;
 //#endregion
-export { cloneMemoryValue as a, freezeMemoryValue as c, TERMINATION_BINDING_NAMES as d, createInspector as f, resolveInspectionBudget as h, renderMemory as i, RESERVED_RUNTIME_NAMES as l, limitInspectionOutput as m, getQuickJSVariant as n, decodeMemoryValue as o, inspect as p, Memory as r, encodeMemoryValue as s, configureQuickJS as t, RUNTIME_BINDING_NAMES as u };
+export { cloneMemoryValue as a, freezeMemoryValue as c, TERMINATION_BINDING_NAMES as d, createInspector as f, resolveInspectionBudget as g, limitInspectionOutput as h, renderMemory as i, RESERVED_RUNTIME_NAMES as l, inspect as m, getQuickJSVariant as n, decodeMemoryValue as o, snapshotInspectionValue as p, Memory as r, encodeMemoryValue as s, configureQuickJS as t, RUNTIME_BINDING_NAMES as u };

package/dist/runtime/chat-completion.test.d.ts

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

package/dist/runtime/chat-last-speaker.test.d.ts

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

package/dist/runtime/empty-completion.test.d.ts

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

package/dist/runtime/execution-report.d.ts

@@ -2,12 +2,15 @@ import { type InspectionPolicyLookup } from '../inspect.js';
 import { type InspectionIdentity, type Inspector } from '../inspection.js';
 import type { MemoryReport } from '../session/memory.js';
 import { type ExecutionActivity } from './execution-activity.js';
+import { type ForcedInspection } from './forced-inspection.js';
 export { renderMessageDeliveries } from './execution-activity.js';
 export type ExecutionOutcome = {
     type: 'inspect';
     value: unknown;
     available: boolean;
     explicit: boolean;
+    forcedInspections?: readonly ForcedInspection[];
+    downstreamError?: unknown;
 } | {
     type: 'exit';
     name: string;

package/dist/runtime/forced-inspection.d.ts

@@ -0,0 +1,13 @@
+import { type InspectionPolicyLookup } from '../inspect.js';
+import type { InspectionIdentity, Inspector } from '../inspection.js';
+/** A successful business result that must be shown before this turn may complete. */
+export type ForcedInspection = {
+    tool: string;
+    toolCallId: string;
+    line?: number;
+    reason: string;
+    value: unknown;
+    metadata?: Record<string, unknown>;
+};
+/** Keep attribution and content together, using the same display budgets as inspect(). */
+export declare function renderForcedInspection(inspections: readonly ForcedInspection[], inspector: Inspector, identity: InspectionIdentity, maxTokens: number, policies?: InspectionPolicyLookup): string;

package/dist/runtime/forced-inspection.test.d.ts

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

package/dist/runtime/javascript-api.d.ts

@@ -2,6 +2,7 @@ import type { ComponentRegistry, RenderedComponent } from '../chat/component.js'
 import type { Iteration } from '../context.js';
 import { ThinkSignal } from '../errors.js';
 import type { Exit } from '../exit.js';
+import type { ForcedInspection } from './forced-inspection.js';
 /** A child message keeps its identity from preparation through acknowledged delivery. */
 export type PreparedMessage = {
     id: string;
@@ -33,6 +34,8 @@ export type JavaScriptApi = {
     getTerminalOutcome(): TerminalOutcome | undefined;
     /** The first host interruption closes execution before guest handlers can consume it. */
     getInterruption(): ThinkSignal | undefined;
+    requestInspection(inspection: ForcedInspection): void;
+    getForcedInspections(): readonly ForcedInspection[];
     throwIfTerminated(): void;
     track<T>(operation: () => Promise<T>): Promise<T>;
     assertOpen(): void;

package/dist/runtime/think-signal.test.d.ts

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

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.2",
   "files": [
     "dist",
     "DOCS.md",