llmist 0.8.0 → 1.1.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { ZodType, ZodTypeAny } from 'zod';
 export { z } from 'zod';
-import { A as AgentHooks, o as ModelRegistry, L as LLMMessage, P as ParameterFormat, S as StreamEvent, T as TokenUsage, G as GadgetRegistry, p as LLMStreamChunk, q as GadgetExample, B as BaseGadget, r as ParsedGadgetCall, s as GadgetExecutionResult, t as ProviderAdapter, u as ModelDescriptor, v as ModelSpec, w as LLMGenerationOptions, x as LLMStream } from './mock-stream-CjmvWDc3.cjs';
-export { F as AfterGadgetExecutionAction, I as AfterGadgetExecutionControllerContext, J as AfterLLMCallAction, K as AfterLLMCallControllerContext, N as AfterLLMErrorAction, y as AgentBuilder, O as AgentOptions, Q as BeforeGadgetExecutionAction, R as BeforeLLMCallAction, U as ChunkInterceptorContext, V as Controllers, ac as CostEstimate, al as DEFAULT_PROMPTS, E as EventHandlers, as as GadgetClass, W as GadgetExecutionControllerContext, at as GadgetOrClass, X as GadgetParameterInterceptorContext, Y as GadgetResultInterceptorContext, H as HistoryMessage, Z as Interceptors, _ as LLMCallControllerContext, $ as LLMErrorControllerContext, ab as LLMMessageBuilder, aa as LLMRole, a9 as LLMist, a8 as LLMistOptions, a0 as MessageInterceptorContext, a as MockBuilder, d as MockManager, h as MockMatcher, i as MockMatcherContext, j as MockOptions, M as MockProviderAdapter, k as MockRegistration, l as MockResponse, n as MockStats, ad as ModelFeatures, ah as ModelIdentifierParser, ae as ModelLimits, af as ModelPricing, a1 as ObserveChunkContext, a2 as ObserveGadgetCompleteContext, a3 as ObserveGadgetStartContext, a4 as ObserveLLMCallContext, a5 as ObserveLLMCompleteContext, a6 as ObserveLLMErrorContext, a7 as Observers, ai as PromptConfig, aj as PromptContext, ak as PromptTemplate, ag as ProviderIdentifier, ao as QuickOptions, ar as StreamParser, au as TextOnlyAction, av as TextOnlyContext, aw as TextOnlyCustomHandler, ax as TextOnlyGadgetConfig, ay as TextOnlyHandler, az as TextOnlyStrategy, z as collectEvents, C as collectText, ap as complete, c as createMockAdapter, b as createMockClient, e as createMockStream, f as createTextMockStream, g as getMockManager, m as mockLLM, am as resolvePromptTemplate, an as resolveRulesTemplate, D as runWithHandlers, aq as stream } from './mock-stream-CjmvWDc3.cjs';
+import { A as AgentHooks, o as ModelRegistry, L as LLMMessage, S as StreamEvent, T as TokenUsage, G as GadgetRegistry, p as LLMStreamChunk, q as GadgetExample, B as BaseGadget, P as ParsedGadgetCall, r as GadgetExecutionResult, s as ProviderAdapter, t as ModelDescriptor, u as ModelSpec, v as LLMGenerationOptions, w as LLMStream } from './mock-stream-DKF5yatf.cjs';
+export { D as AfterGadgetExecutionAction, F as AfterGadgetExecutionControllerContext, I as AfterLLMCallAction, J as AfterLLMCallControllerContext, K as AfterLLMErrorAction, x as AgentBuilder, N as AgentOptions, O as BeforeGadgetExecutionAction, Q as BeforeLLMCallAction, R as ChunkInterceptorContext, U as Controllers, ab as CostEstimate, ak as DEFAULT_PROMPTS, E as EventHandlers, aq as GadgetClass, V as GadgetExecutionControllerContext, ar as GadgetOrClass, W as GadgetParameterInterceptorContext, X as GadgetResultInterceptorContext, H as HistoryMessage, Y as Interceptors, Z as LLMCallControllerContext, _ as LLMErrorControllerContext, aa as LLMMessageBuilder, a9 as LLMRole, a8 as LLMist, a7 as LLMistOptions, $ as MessageInterceptorContext, a as MockBuilder, d as MockManager, h as MockMatcher, i as MockMatcherContext, j as MockOptions, M as MockProviderAdapter, k as MockRegistration, l as MockResponse, n as MockStats, ac as ModelFeatures, ag as ModelIdentifierParser, ad as ModelLimits, ae as ModelPricing, a0 as ObserveChunkContext, a1 as ObserveGadgetCompleteContext, a2 as ObserveGadgetStartContext, a3 as ObserveLLMCallContext, a4 as ObserveLLMCompleteContext, a5 as ObserveLLMErrorContext, a6 as Observers, ah as PromptConfig, ai as PromptContext, aj as PromptTemplate, af as ProviderIdentifier, an as QuickOptions, as as TextOnlyAction, at as TextOnlyContext, au as TextOnlyCustomHandler, av as TextOnlyGadgetConfig, aw as TextOnlyHandler, ax as TextOnlyStrategy, y as collectEvents, z as collectText, ao as complete, c as createMockAdapter, b as createMockClient, e as createMockStream, f as createTextMockStream, g as getMockManager, m as mockLLM, al as resolvePromptTemplate, am as resolveRulesTemplate, C as runWithHandlers, ap as stream } from './mock-stream-DKF5yatf.cjs';
 import { Logger, ILogObj } from 'tslog';
 import { MessageCreateParamsStreaming, MessageStreamEvent } from '@anthropic-ai/sdk/resources/messages';
 import OpenAI from 'openai';
@@ -724,11 +724,12 @@ interface IConversationManager {
  * Options for ConversationManager constructor.
  */
 interface ConversationManagerOptions {
-    parameterFormat?: ParameterFormat;
     /** Custom gadget start marker prefix */
     startPrefix?: string;
     /** Custom gadget end marker prefix */
     endPrefix?: string;
+    /** Custom argument prefix for block format */
+    argPrefix?: string;
 }
 /**
  * Default implementation of IConversationManager.
@@ -738,7 +739,6 @@ declare class ConversationManager implements IConversationManager {
     private readonly baseMessages;
     private readonly initialMessages;
     private readonly historyBuilder;
-    private readonly parameterFormat;
     constructor(baseMessages: LLMMessage[], initialMessages: LLMMessage[], options?: ConversationManagerOptions);
     addUserMessage(content: string): void;
     addAssistantMessage(content: string): void;
@@ -761,12 +761,12 @@ interface StreamProcessorOptions {
     iteration: number;
     /** Gadget registry for execution */
     registry: GadgetRegistry;
-    /** Parameter format for parsing */
-    parameterFormat: ParameterFormat;
     /** Custom gadget start prefix */
     gadgetStartPrefix?: string;
     /** Custom gadget end prefix */
     gadgetEndPrefix?: string;
+    /** Custom argument prefix for block format */
+    gadgetArgPrefix?: string;
     /** Hooks for lifecycle events */
     hooks?: AgentHooks;
     /** Logger instance */
@@ -1269,12 +1269,22 @@ declare class HumanInputException extends Error {
     constructor(question: string);
 }
 
+interface ErrorFormatterOptions {
+    /** Custom argument prefix for block format examples. Default: "!!!ARG:" */
+    argPrefix?: string;
+    /** Custom start prefix for block format examples. Default: "!!!GADGET_START:" */
+    startPrefix?: string;
+    /** Custom end prefix for block format examples. Default: "!!!GADGET_END" */
+    endPrefix?: string;
+}
+
 declare class GadgetExecutor {
     private readonly registry;
     private readonly onHumanInputRequired?;
     private readonly defaultGadgetTimeoutMs?;
     private readonly logger;
-    constructor(registry: GadgetRegistry, onHumanInputRequired?: ((question: string) => Promise<string>) | undefined, logger?: Logger<ILogObj>, defaultGadgetTimeoutMs?: number | undefined);
+    private readonly errorFormatter;
+    constructor(registry: GadgetRegistry, onHumanInputRequired?: ((question: string) => Promise<string>) | undefined, logger?: Logger<ILogObj>, defaultGadgetTimeoutMs?: number | undefined, errorFormatterOptions?: ErrorFormatterOptions);
     /**
      * Creates a promise that rejects with a TimeoutException after the specified timeout.
      */
@@ -1283,6 +1293,65 @@ declare class GadgetExecutor {
     executeAll(calls: ParsedGadgetCall[]): Promise<GadgetExecutionResult[]>;
 }
 
+interface StreamParserOptions {
+    startPrefix?: string;
+    endPrefix?: string;
+    /** Prefix for block format arguments. Default: "!!!ARG:" */
+    argPrefix?: string;
+}
+declare class StreamParser {
+    private buffer;
+    private lastReportedTextLength;
+    private readonly startPrefix;
+    private readonly endPrefix;
+    private readonly argPrefix;
+    constructor(options?: StreamParserOptions);
+    private takeTextUntil;
+    /**
+     * Parse gadget name, handling both old format (name:invocationId) and new format (just name).
+     * For new format, generates a unique invocation ID.
+     */
+    private parseGadgetName;
+    /**
+     * Extract the error message from a parse error.
+     * Preserves full message since the error formatter adds contextual help
+     * that benefits from precise, detailed error information.
+     */
+    private extractParseError;
+    /**
+     * Parse parameter string using block format
+     */
+    private parseParameters;
+    feed(chunk: string): Generator<StreamEvent>;
+    finalize(): Generator<StreamEvent>;
+    reset(): void;
+}
+
+/**
+ * Type-safe gadget factory with automatic parameter inference.
+ *
+ * Gadget eliminates the need for manual type assertions
+ * by automatically inferring parameter types from the Zod schema.
+ *
+ * @example
+ * ```typescript
+ * class Calculator extends Gadget({
+ *   description: "Performs arithmetic operations",
+ *   schema: z.object({
+ *     operation: z.enum(["add", "subtract"]),
+ *     a: z.number(),
+ *     b: z.number(),
+ *   }),
+ * }) {
+ *   // ✨ params is automatically typed!
+ *   execute(params: this['params']): string {
+ *     const { operation, a, b } = params; // All typed!
+ *     return operation === "add" ? String(a + b) : String(a - b);
+ *   }
+ * }
+ * ```
+ */
+
 /**
  * Infer the TypeScript type from a Zod schema.
  */
@@ -1389,7 +1458,7 @@ declare function Gadget<TSchema extends ZodType>(config: GadgetConfig<TSchema>):
          */
         execute(params: Record<string, unknown>): string | Promise<string>;
         get instruction(): string;
-        getInstruction(format?: ParameterFormat): string;
+        getInstruction(argPrefix?: string): string;
     } & {
         params: InferSchema<TSchema>;
     };
@@ -1766,4 +1835,4 @@ declare class OpenAIChatProvider extends BaseProviderAdapter {
 }
 declare function createOpenAIProviderFromEnv(): OpenAIChatProvider | null;
 
-export { AgentHooks, AnthropicMessagesProvider, BaseGadget, BreakLoopException, ConversationManager, type CreateGadgetConfig, Gadget, type GadgetConfig, GadgetExample, GadgetExecutionResult, GadgetExecutor, GadgetOutputStore, GadgetRegistry, GeminiGenerativeProvider, HookPresets, HumanInputException, type IConversationManager, LLMGenerationOptions, LLMMessage, LLMStream, LLMStreamChunk, type LoggerOptions, type LoggingOptions, MODEL_ALIASES, ModelDescriptor, ModelRegistry, ModelSpec, OpenAIChatProvider, ParsedGadgetCall, ProviderAdapter, type StoredOutput, StreamEvent, type StreamProcessingResult, StreamProcessor, type StreamProcessorOptions, TokenUsage, type ValidationIssue, type ValidationResult, createAnthropicProviderFromEnv, createGadget, createGadgetOutputViewer, createGeminiProviderFromEnv, createLogger, createOpenAIProviderFromEnv, defaultLogger, discoverProviderAdapters, getModelId, getProvider, hasProviderPrefix, resolveModel, validateAndApplyDefaults, validateGadgetParams };
+export { AgentHooks, AnthropicMessagesProvider, BaseGadget, BreakLoopException, ConversationManager, type CreateGadgetConfig, Gadget, type GadgetConfig, GadgetExample, GadgetExecutionResult, GadgetExecutor, GadgetOutputStore, GadgetRegistry, GeminiGenerativeProvider, HookPresets, HumanInputException, type IConversationManager, LLMGenerationOptions, LLMMessage, LLMStream, LLMStreamChunk, type LoggerOptions, type LoggingOptions, MODEL_ALIASES, ModelDescriptor, ModelRegistry, ModelSpec, OpenAIChatProvider, ParsedGadgetCall, ProviderAdapter, type StoredOutput, StreamEvent, StreamParser, type StreamProcessingResult, StreamProcessor, type StreamProcessorOptions, TokenUsage, type ValidationIssue, type ValidationResult, createAnthropicProviderFromEnv, createGadget, createGadgetOutputViewer, createGeminiProviderFromEnv, createLogger, createOpenAIProviderFromEnv, defaultLogger, discoverProviderAdapters, getModelId, getProvider, hasProviderPrefix, resolveModel, validateAndApplyDefaults, validateGadgetParams };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { ZodType, ZodTypeAny } from 'zod';
 export { z } from 'zod';
-import { A as AgentHooks, o as ModelRegistry, L as LLMMessage, P as ParameterFormat, S as StreamEvent, T as TokenUsage, G as GadgetRegistry, p as LLMStreamChunk, q as GadgetExample, B as BaseGadget, r as ParsedGadgetCall, s as GadgetExecutionResult, t as ProviderAdapter, u as ModelDescriptor, v as ModelSpec, w as LLMGenerationOptions, x as LLMStream } from './mock-stream-CjmvWDc3.js';
-export { F as AfterGadgetExecutionAction, I as AfterGadgetExecutionControllerContext, J as AfterLLMCallAction, K as AfterLLMCallControllerContext, N as AfterLLMErrorAction, y as AgentBuilder, O as AgentOptions, Q as BeforeGadgetExecutionAction, R as BeforeLLMCallAction, U as ChunkInterceptorContext, V as Controllers, ac as CostEstimate, al as DEFAULT_PROMPTS, E as EventHandlers, as as GadgetClass, W as GadgetExecutionControllerContext, at as GadgetOrClass, X as GadgetParameterInterceptorContext, Y as GadgetResultInterceptorContext, H as HistoryMessage, Z as Interceptors, _ as LLMCallControllerContext, $ as LLMErrorControllerContext, ab as LLMMessageBuilder, aa as LLMRole, a9 as LLMist, a8 as LLMistOptions, a0 as MessageInterceptorContext, a as MockBuilder, d as MockManager, h as MockMatcher, i as MockMatcherContext, j as MockOptions, M as MockProviderAdapter, k as MockRegistration, l as MockResponse, n as MockStats, ad as ModelFeatures, ah as ModelIdentifierParser, ae as ModelLimits, af as ModelPricing, a1 as ObserveChunkContext, a2 as ObserveGadgetCompleteContext, a3 as ObserveGadgetStartContext, a4 as ObserveLLMCallContext, a5 as ObserveLLMCompleteContext, a6 as ObserveLLMErrorContext, a7 as Observers, ai as PromptConfig, aj as PromptContext, ak as PromptTemplate, ag as ProviderIdentifier, ao as QuickOptions, ar as StreamParser, au as TextOnlyAction, av as TextOnlyContext, aw as TextOnlyCustomHandler, ax as TextOnlyGadgetConfig, ay as TextOnlyHandler, az as TextOnlyStrategy, z as collectEvents, C as collectText, ap as complete, c as createMockAdapter, b as createMockClient, e as createMockStream, f as createTextMockStream, g as getMockManager, m as mockLLM, am as resolvePromptTemplate, an as resolveRulesTemplate, D as runWithHandlers, aq as stream } from './mock-stream-CjmvWDc3.js';
+import { A as AgentHooks, o as ModelRegistry, L as LLMMessage, S as StreamEvent, T as TokenUsage, G as GadgetRegistry, p as LLMStreamChunk, q as GadgetExample, B as BaseGadget, P as ParsedGadgetCall, r as GadgetExecutionResult, s as ProviderAdapter, t as ModelDescriptor, u as ModelSpec, v as LLMGenerationOptions, w as LLMStream } from './mock-stream-DKF5yatf.js';
+export { D as AfterGadgetExecutionAction, F as AfterGadgetExecutionControllerContext, I as AfterLLMCallAction, J as AfterLLMCallControllerContext, K as AfterLLMErrorAction, x as AgentBuilder, N as AgentOptions, O as BeforeGadgetExecutionAction, Q as BeforeLLMCallAction, R as ChunkInterceptorContext, U as Controllers, ab as CostEstimate, ak as DEFAULT_PROMPTS, E as EventHandlers, aq as GadgetClass, V as GadgetExecutionControllerContext, ar as GadgetOrClass, W as GadgetParameterInterceptorContext, X as GadgetResultInterceptorContext, H as HistoryMessage, Y as Interceptors, Z as LLMCallControllerContext, _ as LLMErrorControllerContext, aa as LLMMessageBuilder, a9 as LLMRole, a8 as LLMist, a7 as LLMistOptions, $ as MessageInterceptorContext, a as MockBuilder, d as MockManager, h as MockMatcher, i as MockMatcherContext, j as MockOptions, M as MockProviderAdapter, k as MockRegistration, l as MockResponse, n as MockStats, ac as ModelFeatures, ag as ModelIdentifierParser, ad as ModelLimits, ae as ModelPricing, a0 as ObserveChunkContext, a1 as ObserveGadgetCompleteContext, a2 as ObserveGadgetStartContext, a3 as ObserveLLMCallContext, a4 as ObserveLLMCompleteContext, a5 as ObserveLLMErrorContext, a6 as Observers, ah as PromptConfig, ai as PromptContext, aj as PromptTemplate, af as ProviderIdentifier, an as QuickOptions, as as TextOnlyAction, at as TextOnlyContext, au as TextOnlyCustomHandler, av as TextOnlyGadgetConfig, aw as TextOnlyHandler, ax as TextOnlyStrategy, y as collectEvents, z as collectText, ao as complete, c as createMockAdapter, b as createMockClient, e as createMockStream, f as createTextMockStream, g as getMockManager, m as mockLLM, al as resolvePromptTemplate, am as resolveRulesTemplate, C as runWithHandlers, ap as stream } from './mock-stream-DKF5yatf.js';
 import { Logger, ILogObj } from 'tslog';
 import { MessageCreateParamsStreaming, MessageStreamEvent } from '@anthropic-ai/sdk/resources/messages';
 import OpenAI from 'openai';
@@ -724,11 +724,12 @@ interface IConversationManager {
  * Options for ConversationManager constructor.
  */
 interface ConversationManagerOptions {
-    parameterFormat?: ParameterFormat;
     /** Custom gadget start marker prefix */
     startPrefix?: string;
     /** Custom gadget end marker prefix */
     endPrefix?: string;
+    /** Custom argument prefix for block format */
+    argPrefix?: string;
 }
 /**
  * Default implementation of IConversationManager.
@@ -738,7 +739,6 @@ declare class ConversationManager implements IConversationManager {
     private readonly baseMessages;
     private readonly initialMessages;
     private readonly historyBuilder;
-    private readonly parameterFormat;
     constructor(baseMessages: LLMMessage[], initialMessages: LLMMessage[], options?: ConversationManagerOptions);
     addUserMessage(content: string): void;
     addAssistantMessage(content: string): void;
@@ -761,12 +761,12 @@ interface StreamProcessorOptions {
     iteration: number;
     /** Gadget registry for execution */
     registry: GadgetRegistry;
-    /** Parameter format for parsing */
-    parameterFormat: ParameterFormat;
     /** Custom gadget start prefix */
     gadgetStartPrefix?: string;
     /** Custom gadget end prefix */
     gadgetEndPrefix?: string;
+    /** Custom argument prefix for block format */
+    gadgetArgPrefix?: string;
     /** Hooks for lifecycle events */
     hooks?: AgentHooks;
     /** Logger instance */
@@ -1269,12 +1269,22 @@ declare class HumanInputException extends Error {
     constructor(question: string);
 }
 
+interface ErrorFormatterOptions {
+    /** Custom argument prefix for block format examples. Default: "!!!ARG:" */
+    argPrefix?: string;
+    /** Custom start prefix for block format examples. Default: "!!!GADGET_START:" */
+    startPrefix?: string;
+    /** Custom end prefix for block format examples. Default: "!!!GADGET_END" */
+    endPrefix?: string;
+}
+
 declare class GadgetExecutor {
     private readonly registry;
     private readonly onHumanInputRequired?;
     private readonly defaultGadgetTimeoutMs?;
     private readonly logger;
-    constructor(registry: GadgetRegistry, onHumanInputRequired?: ((question: string) => Promise<string>) | undefined, logger?: Logger<ILogObj>, defaultGadgetTimeoutMs?: number | undefined);
+    private readonly errorFormatter;
+    constructor(registry: GadgetRegistry, onHumanInputRequired?: ((question: string) => Promise<string>) | undefined, logger?: Logger<ILogObj>, defaultGadgetTimeoutMs?: number | undefined, errorFormatterOptions?: ErrorFormatterOptions);
     /**
      * Creates a promise that rejects with a TimeoutException after the specified timeout.
      */
@@ -1283,6 +1293,65 @@ declare class GadgetExecutor {
     executeAll(calls: ParsedGadgetCall[]): Promise<GadgetExecutionResult[]>;
 }
 
+interface StreamParserOptions {
+    startPrefix?: string;
+    endPrefix?: string;
+    /** Prefix for block format arguments. Default: "!!!ARG:" */
+    argPrefix?: string;
+}
+declare class StreamParser {
+    private buffer;
+    private lastReportedTextLength;
+    private readonly startPrefix;
+    private readonly endPrefix;
+    private readonly argPrefix;
+    constructor(options?: StreamParserOptions);
+    private takeTextUntil;
+    /**
+     * Parse gadget name, handling both old format (name:invocationId) and new format (just name).
+     * For new format, generates a unique invocation ID.
+     */
+    private parseGadgetName;
+    /**
+     * Extract the error message from a parse error.
+     * Preserves full message since the error formatter adds contextual help
+     * that benefits from precise, detailed error information.
+     */
+    private extractParseError;
+    /**
+     * Parse parameter string using block format
+     */
+    private parseParameters;
+    feed(chunk: string): Generator<StreamEvent>;
+    finalize(): Generator<StreamEvent>;
+    reset(): void;
+}
+
+/**
+ * Type-safe gadget factory with automatic parameter inference.
+ *
+ * Gadget eliminates the need for manual type assertions
+ * by automatically inferring parameter types from the Zod schema.
+ *
+ * @example
+ * ```typescript
+ * class Calculator extends Gadget({
+ *   description: "Performs arithmetic operations",
+ *   schema: z.object({
+ *     operation: z.enum(["add", "subtract"]),
+ *     a: z.number(),
+ *     b: z.number(),
+ *   }),
+ * }) {
+ *   // ✨ params is automatically typed!
+ *   execute(params: this['params']): string {
+ *     const { operation, a, b } = params; // All typed!
+ *     return operation === "add" ? String(a + b) : String(a - b);
+ *   }
+ * }
+ * ```
+ */
+
 /**
  * Infer the TypeScript type from a Zod schema.
  */
@@ -1389,7 +1458,7 @@ declare function Gadget<TSchema extends ZodType>(config: GadgetConfig<TSchema>):
          */
         execute(params: Record<string, unknown>): string | Promise<string>;
         get instruction(): string;
-        getInstruction(format?: ParameterFormat): string;
+        getInstruction(argPrefix?: string): string;
     } & {
         params: InferSchema<TSchema>;
     };
@@ -1766,4 +1835,4 @@ declare class OpenAIChatProvider extends BaseProviderAdapter {
 }
 declare function createOpenAIProviderFromEnv(): OpenAIChatProvider | null;
 
-export { AgentHooks, AnthropicMessagesProvider, BaseGadget, BreakLoopException, ConversationManager, type CreateGadgetConfig, Gadget, type GadgetConfig, GadgetExample, GadgetExecutionResult, GadgetExecutor, GadgetOutputStore, GadgetRegistry, GeminiGenerativeProvider, HookPresets, HumanInputException, type IConversationManager, LLMGenerationOptions, LLMMessage, LLMStream, LLMStreamChunk, type LoggerOptions, type LoggingOptions, MODEL_ALIASES, ModelDescriptor, ModelRegistry, ModelSpec, OpenAIChatProvider, ParsedGadgetCall, ProviderAdapter, type StoredOutput, StreamEvent, type StreamProcessingResult, StreamProcessor, type StreamProcessorOptions, TokenUsage, type ValidationIssue, type ValidationResult, createAnthropicProviderFromEnv, createGadget, createGadgetOutputViewer, createGeminiProviderFromEnv, createLogger, createOpenAIProviderFromEnv, defaultLogger, discoverProviderAdapters, getModelId, getProvider, hasProviderPrefix, resolveModel, validateAndApplyDefaults, validateGadgetParams };
+export { AgentHooks, AnthropicMessagesProvider, BaseGadget, BreakLoopException, ConversationManager, type CreateGadgetConfig, Gadget, type GadgetConfig, GadgetExample, GadgetExecutionResult, GadgetExecutor, GadgetOutputStore, GadgetRegistry, GeminiGenerativeProvider, HookPresets, HumanInputException, type IConversationManager, LLMGenerationOptions, LLMMessage, LLMStream, LLMStreamChunk, type LoggerOptions, type LoggingOptions, MODEL_ALIASES, ModelDescriptor, ModelRegistry, ModelSpec, OpenAIChatProvider, ParsedGadgetCall, ProviderAdapter, type StoredOutput, StreamEvent, StreamParser, type StreamProcessingResult, StreamProcessor, type StreamProcessorOptions, TokenUsage, type ValidationIssue, type ValidationResult, createAnthropicProviderFromEnv, createGadget, createGadgetOutputViewer, createGeminiProviderFromEnv, createLogger, createOpenAIProviderFromEnv, defaultLogger, discoverProviderAdapters, getModelId, getProvider, hasProviderPrefix, resolveModel, validateAndApplyDefaults, validateGadgetParams };

package/dist/index.js

@@ -10,7 +10,7 @@ import {
   mockLLM,
   validateAndApplyDefaults,
   validateGadgetParams
-} from "./chunk-4IMGADVY.js";
+} from "./chunk-OIPLYP7M.js";
 import {
   AgentBuilder,
   AnthropicMessagesProvider,
@@ -74,7 +74,7 @@ import {
   resolveRulesTemplate,
   runWithHandlers,
   stream
-} from "./chunk-62M4TDAK.js";
+} from "./chunk-VXPZQZF5.js";
 
 // src/index.ts
 init_builder();

package/dist/{mock-stream-CjmvWDc3.d.cts → mock-stream-DKF5yatf.d.cts}

@@ -40,7 +40,7 @@ interface GadgetExecutionResult {
 interface ParsedGadgetCall {
     gadgetName: string;
     invocationId: string;
-    parametersYaml: string;
+    parametersRaw: string;
     parameters?: Record<string, unknown>;
     parseError?: string;
 }
@@ -116,46 +116,6 @@ type TextOnlyAction = {
     parameters: Record<string, unknown>;
 };
 
-type ParameterFormat = "json" | "yaml" | "toml" | "auto";
-interface StreamParserOptions {
-    startPrefix?: string;
-    endPrefix?: string;
-    /**
-     * Format for parsing gadget parameters.
-     * - 'json': Parse as JSON (more robust, recommended for complex nested data)
-     * - 'yaml': Parse as YAML (backward compatible)
-     * - 'auto': Try JSON first, fall back to YAML
-     * @default 'json'
-     */
-    parameterFormat?: ParameterFormat;
-}
-declare class StreamParser {
-    private buffer;
-    private lastReportedTextLength;
-    private readonly startPrefix;
-    private readonly endPrefix;
-    private readonly parameterFormat;
-    constructor(options?: StreamParserOptions);
-    private takeTextUntil;
-    /**
-     * Parse gadget name, handling both old format (name:invocationId) and new format (just name).
-     * For new format, generates a unique invocation ID.
-     */
-    private parseGadgetName;
-    /**
-     * Truncate verbose parse errors to avoid context overflow.
-     * Keeps first meaningful line and limits total length.
-     */
-    private truncateParseError;
-    /**
-     * Parse parameter string according to configured format
-     */
-    private parseParameters;
-    feed(chunk: string): Generator<StreamEvent>;
-    finalize(): Generator<StreamEvent>;
-    reset(): void;
-}
-
 /**
  * Internal base class for gadgets. Most users should use the `Gadget` class
  * (formerly TypedGadget) or `createGadget()` function instead, as they provide
@@ -205,29 +165,29 @@ declare abstract class BaseGadget {
     /**
      * Auto-generated instruction text for the LLM.
      * Combines name, description, and parameter schema into a formatted instruction.
-     * @deprecated Use getInstruction(format) instead for format-specific schemas
+     * @deprecated Use getInstruction() instead
      */
     get instruction(): string;
     /**
-     * Generate instruction text for the LLM with format-specific schema.
+     * Generate instruction text for the LLM.
      * Combines name, description, and parameter schema into a formatted instruction.
      *
-     * @param format - Format for the schema representation ('json' | 'yaml' | 'toml' | 'auto')
+     * @param argPrefix - Optional custom argument prefix for block format examples
      * @returns Formatted instruction string
      */
-    getInstruction(format?: ParameterFormat): string;
+    getInstruction(argPrefix?: string): string;
 }
 
 /**
  * Context provided to prompt template functions for rendering dynamic content.
  */
 interface PromptContext {
-    /** The parameter format being used (json or yaml) */
-    parameterFormat: ParameterFormat;
     /** Custom gadget start prefix */
     startPrefix: string;
     /** Custom gadget end prefix */
     endPrefix: string;
+    /** Custom argument prefix for block format */
+    argPrefix: string;
     /** Number of gadgets being registered */
     gadgetCount: number;
     /** Names of all gadgets */
@@ -268,41 +228,16 @@ interface PromptConfig {
      */
     criticalUsage?: PromptTemplate;
     /**
-     * Format description for YAML parameter format.
-     * Default: "Parameters in YAML format (one per line)"
+     * Format description for the block parameter format.
+     * Default uses the configured argPrefix dynamically.
      */
-    formatDescriptionYaml?: PromptTemplate;
-    /**
-     * Format description for JSON parameter format.
-     * Default: "Parameters in JSON format (valid JSON object)"
-     */
-    formatDescriptionJson?: PromptTemplate;
-    /**
-     * Format description for TOML parameter format.
-     * Default: "Parameters in TOML format (key = value pairs, use heredoc for multiline: key = <<<EOF ... EOF)"
-     */
-    formatDescriptionToml?: PromptTemplate;
+    formatDescription?: PromptTemplate;
     /**
      * Rules that appear in the rules section.
      * Can be an array of strings or a function that returns an array.
-     * Default includes 6 rules about not using function calling.
+     * Default includes rules about not using function calling.
      */
     rules?: PromptTemplate | string[] | ((context: PromptContext) => string[]);
-    /**
-     * Schema label for JSON format.
-     * Default: "\n\nInput Schema (JSON):"
-     */
-    schemaLabelJson?: PromptTemplate;
-    /**
-     * Schema label for YAML format.
-     * Default: "\n\nInput Schema (YAML):"
-     */
-    schemaLabelYaml?: PromptTemplate;
-    /**
-     * Schema label for TOML format.
-     * Default: "\n\nInput Schema (TOML):"
-     */
-    schemaLabelToml?: PromptTemplate;
     /**
      * Custom examples to show in the examples section.
      * If provided, replaces the default examples entirely.
@@ -312,7 +247,6 @@ interface PromptConfig {
 }
 /**
  * Default prompt templates used by llmist.
- * These match the original hardcoded strings.
  */
 declare const DEFAULT_PROMPTS: Required<Omit<PromptConfig, "rules" | "customExamples"> & {
     rules: (context: PromptContext) => string[];
@@ -338,17 +272,19 @@ declare class LLMMessageBuilder {
     private readonly messages;
     private startPrefix;
     private endPrefix;
+    private argPrefix;
     private promptConfig;
     constructor(promptConfig?: PromptConfig);
     /**
      * Set custom prefixes for gadget markers.
      * Used to configure history builder to match system prompt markers.
      */
-    withPrefixes(startPrefix: string, endPrefix: string): this;
+    withPrefixes(startPrefix: string, endPrefix: string, argPrefix?: string): this;
     addSystem(content: string, metadata?: Record<string, unknown>): this;
-    addGadgets(gadgets: BaseGadget[], parameterFormat?: ParameterFormat, options?: {
+    addGadgets(gadgets: BaseGadget[], options?: {
         startPrefix?: string;
         endPrefix?: string;
+        argPrefix?: string;
     }): this;
     private buildGadgetsSection;
     private buildUsageSection;
@@ -356,8 +292,12 @@ declare class LLMMessageBuilder {
     private buildRulesSection;
     addUser(content: string, metadata?: Record<string, unknown>): this;
     addAssistant(content: string, metadata?: Record<string, unknown>): this;
-    addGadgetCall(gadget: string, parameters: Record<string, unknown>, result: string, parameterFormat?: ParameterFormat): this;
-    private formatParameters;
+    addGadgetCall(gadget: string, parameters: Record<string, unknown>, result: string): this;
+    /**
+     * Format parameters as Block format with JSON Pointer paths.
+     * Uses the configured argPrefix for consistency with system prompt.
+     */
+    private formatBlockParameters;
     build(): LLMMessage[];
 }
 
@@ -972,7 +912,7 @@ interface EventHandlers {
     onGadgetCall?: (call: {
         gadgetName: string;
         parameters?: Record<string, unknown>;
-        parametersYaml: string;
+        parametersRaw: string;
     }) => void | Promise<void>;
     /** Called when a gadget execution completes */
     onGadgetResult?: (result: {
@@ -1553,12 +1493,12 @@ interface AgentOptions {
     hooks?: AgentHooks;
     /** Callback for human input */
     onHumanInputRequired?: (question: string) => Promise<string>;
-    /** Parameter format */
-    parameterFormat?: ParameterFormat;
     /** Custom gadget start prefix */
     gadgetStartPrefix?: string;
     /** Custom gadget end prefix */
     gadgetEndPrefix?: string;
+    /** Custom gadget argument prefix for block format parameters */
+    gadgetArgPrefix?: string;
     /** Initial messages */
     initialMessages?: Array<{
         role: "system" | "user" | "assistant";
@@ -1620,9 +1560,9 @@ declare class Agent {
     private readonly hooks;
     private readonly conversation;
     private readonly registry;
-    private readonly parameterFormat;
     private readonly gadgetStartPrefix?;
     private readonly gadgetEndPrefix?;
+    private readonly gadgetArgPrefix?;
     private readonly onHumanInputRequired?;
     private readonly textOnlyHandler;
     private readonly textWithGadgetsHandler?;
@@ -1751,9 +1691,9 @@ declare class AgentBuilder {
     private gadgets;
     private initialMessages;
     private onHumanInputRequired?;
-    private parameterFormat?;
     private gadgetStartPrefix?;
     private gadgetEndPrefix?;
+    private gadgetArgPrefix?;
     private textOnlyHandler?;
     private textWithGadgetsHandler?;
     private stopOnGadgetError?;
@@ -1898,18 +1838,6 @@ declare class AgentBuilder {
      * ```
      */
     onHumanInput(handler: (question: string) => Promise<string>): this;
-    /**
-     * Set the parameter format for gadget calls.
-     *
-     * @param format - Parameter format ("json" or "xml")
-     * @returns This builder for chaining
-     *
-     * @example
-     * ```typescript
-     * .withParameterFormat("xml")
-     * ```
-     */
-    withParameterFormat(format: ParameterFormat): this;
     /**
      * Set custom gadget marker prefix.
      *
@@ -1934,6 +1862,18 @@ declare class AgentBuilder {
      * ```
      */
     withGadgetEndPrefix(suffix: string): this;
+    /**
+     * Set custom argument prefix for block format parameters.
+     *
+     * @param prefix - Custom prefix for argument markers (default: "!!!ARG:")
+     * @returns This builder for chaining
+     *
+     * @example
+     * ```typescript
+     * .withGadgetArgPrefix("<<ARG>>")
+     * ```
+     */
+    withGadgetArgPrefix(prefix: string): this;
     /**
      * Set the text-only handler strategy.
      *
@@ -2114,10 +2054,9 @@ declare class AgentBuilder {
      */
     withSyntheticGadgetCall(gadgetName: string, parameters: Record<string, unknown>, result: string): this;
     /**
-     * Format parameters for synthetic gadget calls.
-     * Uses heredoc for multiline string values.
+     * Format parameters as block format with JSON Pointer paths.
      */
-    private formatSyntheticParameters;
+    private formatBlockParameters;
     /**
      * Build and create the agent with the given user prompt.
      * Returns the Agent instance ready to run.
@@ -2773,4 +2712,4 @@ declare function createTextMockStream(text: string, options?: {
     usage?: MockResponse["usage"];
 }): LLMStream;
 
-export { type LLMErrorControllerContext as $, type AgentHooks as A, BaseGadget as B, collectText as C, runWithHandlers as D, type EventHandlers as E, type AfterGadgetExecutionAction as F, GadgetRegistry as G, type HistoryMessage as H, type AfterGadgetExecutionControllerContext as I, type AfterLLMCallAction as J, type AfterLLMCallControllerContext as K, type LLMMessage as L, MockProviderAdapter as M, type AfterLLMErrorAction as N, type AgentOptions as O, type ParameterFormat as P, type BeforeGadgetExecutionAction as Q, type BeforeLLMCallAction as R, type StreamEvent as S, type TokenUsage as T, type ChunkInterceptorContext as U, type Controllers as V, type GadgetExecutionControllerContext as W, type GadgetParameterInterceptorContext as X, type GadgetResultInterceptorContext as Y, type Interceptors as Z, type LLMCallControllerContext as _, MockBuilder as a, type MessageInterceptorContext as a0, type ObserveChunkContext as a1, type ObserveGadgetCompleteContext as a2, type ObserveGadgetStartContext as a3, type ObserveLLMCallContext as a4, type ObserveLLMCompleteContext as a5, type ObserveLLMErrorContext as a6, type Observers as a7, type LLMistOptions as a8, LLMist as a9, type LLMRole as aa, LLMMessageBuilder as ab, type CostEstimate as ac, type ModelFeatures as ad, type ModelLimits as ae, type ModelPricing as af, type ProviderIdentifier as ag, ModelIdentifierParser as ah, type PromptConfig as ai, type PromptContext as aj, type PromptTemplate as ak, DEFAULT_PROMPTS as al, resolvePromptTemplate as am, resolveRulesTemplate as an, type QuickOptions as ao, complete as ap, stream as aq, StreamParser as ar, type GadgetClass as as, type GadgetOrClass as at, type TextOnlyAction as au, type TextOnlyContext as av, type TextOnlyCustomHandler as aw, type TextOnlyGadgetConfig as ax, type TextOnlyHandler as ay, type TextOnlyStrategy as az, createMockClient as b, createMockAdapter as c, MockManager as d, createMockStream as e, createTextMockStream as f, getMockManager as g, type MockMatcher as h, type MockMatcherContext as i, type MockOptions as j, type MockRegistration as k, type MockResponse as l, mockLLM as m, type MockStats as n, ModelRegistry as o, type LLMStreamChunk as p, type GadgetExample as q, type ParsedGadgetCall as r, type GadgetExecutionResult as s, type ProviderAdapter as t, type ModelDescriptor as u, type ModelSpec as v, type LLMGenerationOptions as w, type LLMStream as x, AgentBuilder as y, collectEvents as z };
+export { type MessageInterceptorContext as $, type AgentHooks as A, BaseGadget as B, runWithHandlers as C, type AfterGadgetExecutionAction as D, type EventHandlers as E, type AfterGadgetExecutionControllerContext as F, GadgetRegistry as G, type HistoryMessage as H, type AfterLLMCallAction as I, type AfterLLMCallControllerContext as J, type AfterLLMErrorAction as K, type LLMMessage as L, MockProviderAdapter as M, type AgentOptions as N, type BeforeGadgetExecutionAction as O, type ParsedGadgetCall as P, type BeforeLLMCallAction as Q, type ChunkInterceptorContext as R, type StreamEvent as S, type TokenUsage as T, type Controllers as U, type GadgetExecutionControllerContext as V, type GadgetParameterInterceptorContext as W, type GadgetResultInterceptorContext as X, type Interceptors as Y, type LLMCallControllerContext as Z, type LLMErrorControllerContext as _, MockBuilder as a, type ObserveChunkContext as a0, type ObserveGadgetCompleteContext as a1, type ObserveGadgetStartContext as a2, type ObserveLLMCallContext as a3, type ObserveLLMCompleteContext as a4, type ObserveLLMErrorContext as a5, type Observers as a6, type LLMistOptions as a7, LLMist as a8, type LLMRole as a9, LLMMessageBuilder as aa, type CostEstimate as ab, type ModelFeatures as ac, type ModelLimits as ad, type ModelPricing as ae, type ProviderIdentifier as af, ModelIdentifierParser as ag, type PromptConfig as ah, type PromptContext as ai, type PromptTemplate as aj, DEFAULT_PROMPTS as ak, resolvePromptTemplate as al, resolveRulesTemplate as am, type QuickOptions as an, complete as ao, stream as ap, type GadgetClass as aq, type GadgetOrClass as ar, type TextOnlyAction as as, type TextOnlyContext as at, type TextOnlyCustomHandler as au, type TextOnlyGadgetConfig as av, type TextOnlyHandler as aw, type TextOnlyStrategy as ax, createMockClient as b, createMockAdapter as c, MockManager as d, createMockStream as e, createTextMockStream as f, getMockManager as g, type MockMatcher as h, type MockMatcherContext as i, type MockOptions as j, type MockRegistration as k, type MockResponse as l, mockLLM as m, type MockStats as n, ModelRegistry as o, type LLMStreamChunk as p, type GadgetExample as q, type GadgetExecutionResult as r, type ProviderAdapter as s, type ModelDescriptor as t, type ModelSpec as u, type LLMGenerationOptions as v, type LLMStream as w, AgentBuilder as x, collectEvents as y, collectText as z };