llmz 0.8.0 → 1.0.1

package/dist/index.d.ts

@@ -1,54 +1,51 @@
 export { version } from '../package.json';
-export { Example, type ExampleDefinition, type ExampleMessage } from './example.js';
-export { Tool } from './tool.js';
+export { ThinkSignal, type ErrorDetails } from './errors.js';
+export { AssignmentError, CodeExecutionError, CodeFormattingError, CognitiveError, CompactionError, ComponentInputError, DeliveryError, ExecutionAbortedError, ExitInputError, HookError, HostOperationError, InternalError, InvalidCodeError, InvalidComponentError, InvalidConfigurationError, InvalidEventError, InvalidExitError, InvalidMessageError, InvalidObjectError, InvalidSessionError, InvalidToolError, isCriticalError, isLLMzError, LLMzError, LoopExceededError, MemoryCapacityError, MemoryValueError, NativeProtocolError, ObjectPropertyError, ReservedIdentifierError, SessionStateError, TokenOverflowError, ToolExecutionError, ToolInputError, UnknownComponentError, UnknownExitError, UnknownToolError, type ErrorCode, type LLMzFailure, type ToolInputIssue, type ValidationIssue, } from './errors/catalog.js';
 export { Exit, type ExitResult } from './exit.js';
+export { inspect, type InspectOptions } from './inspect.js';
+export { createInspector, type InspectEvent, type InspectionIdentity, type InspectionPurpose, type Inspector, type OnInspect, } from './inspection.js';
 export { ObjectInstance } from './objects.js';
-export { SnapshotSignal, ThinkSignal, LoopExceededError } from './errors.js';
-export { parseExit, type ParsedExit } from './exit-parser.js';
-export { Component, type RenderedComponent, type LeafComponentDefinition, type ContainerComponentDefinition, type DefaultComponentDefinition, type ComponentDefinition, assertValidComponent, isComponent, isAnyComponent, } from './component.js';
-export { type Citation, CitationsManager } from './citations.js';
-export { DefaultComponents } from './component.default.js';
-export { Snapshot } from './snapshots.js';
-export { Chat, type MessageHandler, type MessageMetadata, type MessageDelta, type MessageDeltaHandler } from './chat.js';
+export type { CompactionOptions, SummarizeOptions, SummaryRequest } from './session/compactor.js';
+export { Memory, type MemoryProvenance, type MemoryReport, type MemoryValue, type ObjectPropertyMemory, } from './session/memory.js';
+export { Session, type SessionInput, type SessionIteration, type SessionIterationRecord, type SessionMessage, type SessionOptions, } from './session/session.js';
+export { Tool } from './tool.js';
+export { truncate, type Truncated, type TruncatePreserve, type TruncationPolicy } from './truncate.js';
+export { assertValidComponent, Component, isAnyComponent, isComponent, type ComponentDefinition, type ComponentHandler, type ComponentSchema, type RenderedComponent, } from './chat/component.js';
+export { Chat, type AssistantTextMessage, type ChatMessage, type MessageDelta, type MessageDeltaHandler, type MessageMetadata, type ResponseHandler, } from './chat/chat.js';
+export { CitationsManager, type Citation } from './chat/citations.js';
+export { DefaultComponents } from './chat/component.default.js';
+export type { Response, ResponsePreset } from './chat/response.js';
+export { DefaultExit, ListenExit, type Context, type ContextTokens, type Iteration, type IterationStatus, type IterationStatuses, type TokenUsage, } from './context.js';
+export { getValue, type ValueOrGetter } from './getter.js';
+export { ErrorExecutionResult, ExecutionResult, SuccessExecutionResult } from './result.js';
+export type { ExecutionHooks, ExecutionProps } from './runtime/types.js';
+export { type Transcript } from './session/transcript.js';
+export { type Trace, type Traces } from './types.js';
 import { ExecutionResult } from './result.js';
 import { type ExecutionProps } from './runtime/types.js';
-import { stripTruncationTags, truncateWrappedContent, wrapContent } from './truncator.js';
 import { toValidFunctionName, toValidObjectName } from './utils.js';
-export { type Transcript } from './transcript.js';
-export { ErrorExecutionResult, ExecutionResult, PartialExecutionResult, SuccessExecutionResult } from './result.js';
-export { type Trace, type Traces } from './types.js';
-export { type Iteration, ListenExit, ThinkExit, DefaultExit, type IterationStatuses, type IterationStatus, } from './context.js';
-export { type Context, type TokenUsage, type ContextTokens } from './context.js';
-export type { LLMzPrompts, ParsedSend, ParsedNext, ParsedAssistantResponse } from './prompts/prompt.js';
-export type { ExecutionProps, ExecutionHooks } from './runtime/types.js';
-export { type ValueOrGetter, getValue } from './getter.js';
-export * from './message-stream/index.js';
 export * from './custom-client.js';
 export { configureQuickJS } from './quickjs-variant.js';
 export { configureTokenizer } from './utils.js';
 export declare const utils: {
     toValidObjectName: typeof toValidObjectName;
     toValidFunctionName: typeof toValidFunctionName;
-    wrapContent: typeof wrapContent;
-    truncateWrappedContent: typeof truncateWrappedContent;
-    stripTruncationTags: typeof stripTruncationTags;
 };
 /**
  * Executes an LLMz agent in either Chat Mode or Worker Mode.
  *
- * LLMz is a code-first AI agent framework that generates and runs TypeScript code
- * in a sandbox rather than using traditional JSON tool calling. This enables complex
- * logic, multi-tool orchestration, and native LLM thinking via comments and code structure.
+ * LLMz generates and runs JavaScript in a sandbox through the native run_javascript
+ * tool. Assistant text streams normally; JavaScript returns decisions to present
+ * rich messages, inspect results, or complete through a typed exit.
  *
  * @param props - Configuration object for the execution
  * @param props.client - Botpress Client or Cognitive Client instance for LLM generation
  * @param props.instructions - System prompt/instructions for the LLM (static string or dynamic function)
- * @param props.examples - Optional labeled few-shot examples (static array or dynamic function)
  * @param props.chat - Optional Chat instance to enable Chat Mode with user interaction
  * @param props.tools - Array of Tool instances available to the agent (static or dynamic)
  * @param props.objects - Array of ObjectInstance for namespaced tools and variables (static or dynamic)
  * @param props.exits - Array of Exit definitions for structured completion (static or dynamic)
- * @param props.snapshot - Optional Snapshot to resume paused execution
+ * @param props.session - Conversation state; append input before execution and persist it between executions
  * @param props.signal - Optional AbortSignal to cancel execution
  * @param props.model - Optional model name (or array or models to use as fallback) (static or dynamic function)
  * @param props.temperature - Optional temperature value (static or dynamic function)
@@ -92,7 +89,7 @@ export declare const utils: {
  * // With dynamic instructions and hooks
  * const result = await execute({
  *   client: cognitiveClient,
- *   instructions: (ctx) => `Process ${ctx.variables.dataCount} records`,
+ *   instructions: (ctx) => `Process ${ctx.session.memory.variables.dataCount} records`,
  *   tools: async (ctx) => await getContextualTools(ctx),
  *   model: 'best',
  *   temperature: 0.1,