llmz 0.9.0 → 1.0.2

package/dist/errors.d.ts

@@ -1,25 +1,29 @@
-import { JSONSchema7 } from 'json-schema';
-import { type Assignment } from './compiler/plugins/track-tool-calls.js';
-export type ToolCall = {
+export * from './errors/catalog.js';
+/** JSON-safe diagnostic form of an exception; custom fields remain available. */
+export type ErrorDetails = {
     name: string;
-    inputSchema?: JSONSchema7;
-    outputSchema?: JSONSchema7;
-    input?: unknown;
-    assignment?: Assignment;
+    message: string;
+    stack?: string;
+    cause?: ErrorDetails;
+    [key: string]: unknown;
 };
+/** @internal Serialize diagnostics without losing non-enumerable Error fields. */
+export declare function describeError(error: Error, seen?: Set<Error>): ErrorDetails;
 export declare namespace Signals {
     function isWrappedError(error: Error): boolean;
-    function serializeError(error: Error): string;
+    function serializeError(error: Error, seen?: Set<Error>): string;
     function maybeDeserializeError(error: unknown): any;
 }
+declare const SIGNAL_BRAND: unique symbol;
 export declare class VMSignal extends Error {
     message: string;
+    get [SIGNAL_BRAND](): true;
+    readonly signalKind: 'vm' | 'loop' | 'think';
+    static readonly is: (value: unknown) => value is VMSignal;
     /**
      * The code that was executed by the VM up to the point of the signal
      */
     truncatedCode: string;
-    /** The current tool call, if any */
-    toolCall?: ToolCall;
     /**
      * Contains all the declared and executed variables during the VM execution
      * See file plugins/variable-extraction.ts for more details
@@ -29,40 +33,24 @@ export declare class VMSignal extends Error {
     };
     constructor(message: string);
 }
-/** Request a snapshot from inside a tool call */
-export declare class SnapshotSignal extends VMSignal {
-    constructor(message: string);
-}
 /** Loop means LLMz will continue the execution (unless it exhausted its iterations) */
 export declare class VMLoopSignal extends VMSignal {
+    readonly signalKind: 'loop' | 'think';
+    static readonly is: (value: unknown) => value is VMLoopSignal;
     constructor(message: string);
 }
+/**
+ * A successful tool result that requires model inspection before completion.
+ * Tools may throw or return this signal. Its context becomes the JavaScript
+ * return value; calls and assignments continue, and inspection overrides any
+ * attempted exit at iteration settlement. Cancellation and critical errors still stop execution.
+ */
 export declare class ThinkSignal extends VMLoopSignal {
     reason: string;
     context?: any;
     metadata?: Record<string, unknown> | undefined;
+    readonly signalKind = "think";
+    static readonly is: (value: unknown) => value is ThinkSignal;
     constructor(reason: string, context?: any, metadata?: Record<string, unknown> | undefined);
     toString(): string;
 }
-export declare class CodeExecutionError extends Error {
-    code: string;
-    stacktrace: string;
-    constructor(message: string, code: string, stacktrace: string);
-}
-export declare class InvalidCodeError extends Error {
-    code: string;
-    constructor(message: string, code: string);
-}
-export declare class LoopExceededError extends Error {
-    constructor();
-}
-export declare class CodeFormattingError extends Error {
-    code: string;
-    constructor(message: string, code: string);
-}
-export declare class AssignmentError extends Error {
-    constructor(message: string);
-}
-export declare class CognitiveError extends Error {
-    constructor(message: string);
-}