@jaypie/llm 1.3.7 → 1.3.8

package/dist/esm/src/operate/hooks/HookRunner.d.ts

@@ -15,16 +15,19 @@ export interface AfterModelResponseContext {
 }
 export interface BeforeToolContext {
     args: string;
+    message?: string;
     toolName: string;
 }
 export interface AfterToolContext {
     args: string;
+    message?: string;
     result: unknown;
     toolName: string;
 }
 export interface ToolErrorContext {
     args: string;
     error: Error;
+    message?: string;
     toolName: string;
 }
 export interface RetryableErrorContext {

package/dist/esm/src/tools/Toolkit.class.d.ts

@@ -14,9 +14,21 @@ export declare class Toolkit {
     private readonly log;
     constructor(tools: LlmTool[], options?: ToolkitOptions);
     get tools(): Omit<LlmTool, "call">[];
-    call({ name, arguments: args }: {
+    private parseArgs;
+    /**
+     * Resolve a tool's `message` (static string or function of args) without
+     * calling the tool. Returns undefined when the tool is missing or defines
+     * no message. Never throws; resolution errors log at warn.
+     */
+    resolveMessage({ name, arguments: args, }: {
         name: string;
         arguments: string;
+    }): Promise<string | undefined>;
+    call({ name, arguments: args, message: resolvedMessage, }: {
+        name: string;
+        arguments: string;
+        /** Pre-resolved tool message; skips re-resolving `tool.message` for logging */
+        message?: string;
     }): Promise<import("@jaypie/types").AnyValue>;
     extend(tools: LlmTool[], options?: {
         warn?: boolean;

package/dist/esm/src/types/LlmProvider.interface.d.ts

@@ -179,6 +179,8 @@ export declare enum LlmProgressEventType {
 export interface LlmProgressToolCall {
     /** JSON string of arguments (tool_call events only) */
     arguments?: string;
+    /** Resolved `LlmTool.message`, when the tool defines one (tool_call events only) */
+    message?: string;
     /** Tool name */
     name: string;
 }
@@ -225,19 +227,23 @@ export interface LlmOperateOptions {
             content: string | JsonObject;
             usage: LlmUsage;
         }) => unknown | Promise<unknown>;
-        afterEachTool?: ({ result, toolName, args, }: {
+        afterEachTool?: ({ result, toolName, args, message, }: {
             result: unknown;
             toolName: string;
             args: string;
+            /** Resolved `LlmTool.message`, when the tool defines one */
+            message?: string;
         }) => unknown | Promise<unknown>;
         beforeEachModelRequest?: ({ input, options, providerRequest, }: {
             input: string | LlmHistory | LlmInputMessage;
             options?: LlmOperateOptions;
             providerRequest: any;
         }) => unknown | Promise<unknown>;
-        beforeEachTool?: ({ toolName, args, }: {
+        beforeEachTool?: ({ toolName, args, message, }: {
             toolName: string;
             args: string;
+            /** Resolved `LlmTool.message`, when the tool defines one */
+            message?: string;
         }) => unknown | Promise<unknown>;
         onRetryableModelError?: ({ input, options, providerRequest, error, }: {
             input: string | LlmHistory | LlmInputMessage;
@@ -245,10 +251,12 @@ export interface LlmOperateOptions {
             providerRequest: any;
             error: any;
         }) => unknown | Promise<unknown>;
-        onToolError?: ({ error, toolName, args, }: {
+        onToolError?: ({ error, toolName, args, message, }: {
             error: Error;
             toolName: string;
             args: string;
+            /** Resolved `LlmTool.message`, when the tool defines one */
+            message?: string;
         }) => unknown | Promise<unknown>;
         onUnrecoverableModelError?: ({ input, options, providerRequest, error, }: {
             input: string | LlmHistory | LlmInputMessage;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jaypie/llm",
-  "version": "1.3.7",
+  "version": "1.3.8",
   "description": "Large language model utilities",
   "repository": {
     "type": "git",