@mate-academy/llm-gateway 8.11.1 → 8.11.7

package/README.md

@@ -330,14 +330,22 @@ if (turn.stopReason === LLMToolLoopStopReasons.TerminalTool) {
 ```
 
 - **Structured progress events.** Every step emits an `LLMAgentEvent`
-  (`agent_started/message/completed/failed`, `tool_call_started/completed/failed`,
+  (`agent_started/step_started/message/completed/failed`,
+  `tool_call_started/completed/failed/rejected`,
   `subagent_started/completed/failed`) through `onEvent`, for live subscription
   updates and durable run persistence. Events carry correlation ids from one
-  sequence per root run — `runId` on every event, `invocationId` on tool and
-  subagent events, `subagentRunId` linking a delegation to the nested run's
-  events — so parallel tool calls and repeated delegations reconstruct into an
-  unambiguous run tree. Listeners may be async; a throw or rejection is logged
-  and never affects the run.
+  sequence per root run — `runId` on every event, `invocationId` on started,
+  completed and failed tool and subagent events, and `subagentRunId` linking a
+  delegation to the nested run's events — so parallel tool calls and repeated
+  delegations reconstruct into an unambiguous run tree. A
+  `tool_call_rejected` event is the explicit exception: it has no
+  `invocationId`, because the provider call never entered the wrapped tool
+  lifecycle and not every provider exposes a stable call identifier. Listeners
+  may be async; a throw or rejection is logged and never affects the run.
+  `agent_step_started` is emitted immediately before every provider model call,
+  including failed calls and nested subagent rounds. `tool_call_rejected`
+  preserves the provider's ordered call when its name is unknown or its JSON
+  arguments cannot be parsed, even though no wrapped tool invocation starts.
 - **Full-fidelity history.** `history` restores the conversation as it happened,
   not a prose retelling of it. An entry is a plain message
   (`{ role, text }`), a past tool round
@@ -1048,14 +1056,17 @@ if (!('error' in result) && result.usage) {
 }
 ```
 
-For the LLMAPI provider, the structured-output result's `usage` (and the `cost`
-derived from it) includes the JSON-fix call's tokens (summed into the primary
-call's usage) when a fix was required.
 
 #### Provider Support
 
 - **OpenAI**: Uses native `response_format` with `json_schema` for optimal performance
 - **Google Generative AI**: Uses native `responseSchema` parameter for structured output
+- **LLMAPI**: Uses native `response_format` for the models that accept it. Anthropic-backed
+  `claude-*` models are not among them — LLMAPI forwards `response_format` verbatim and
+  Anthropic only honours its own `output_config`, so those entries declare
+  `structuredOutputs: false` and `jsonOutput: false`. The gateway then injects the JSON
+  schema into the system message and validates the response, rather than sending a
+  parameter the upstream provider discards.
 - **Backward Compatibility**: All existing code continues to work unchanged
 
 #### Provider Compatibility Notes

package/dist/LLMService.constants.d.ts

@@ -2991,7 +2991,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: true;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "claude-sonnet-4-5-20250929": {
@@ -3017,7 +3017,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: true;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "claude-sonnet-4-6": {
@@ -3043,7 +3043,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: true;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "claude-haiku-4-5": {
@@ -3069,7 +3069,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: false;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "claude-haiku-4-5-20251001": {
@@ -3095,7 +3095,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: false;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "claude-opus-4-20250514": {
@@ -3147,7 +3147,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: true;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "claude-opus-4-5-20251101": {
@@ -3173,7 +3173,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: true;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "claude-opus-4-6": {
@@ -3198,8 +3198,8 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly tools: true;
                     readonly reasoning: true;
                     readonly webSearch: true;
-                    readonly jsonOutput: true;
-                    readonly structuredOutputs: true;
+                    readonly jsonOutput: false;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "gemini-2.5-pro": {
@@ -6702,7 +6702,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: true;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "anthropic/claude-opus-4-20250514": {
@@ -6754,7 +6754,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: true;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "anthropic/claude-opus-4-6": {
@@ -6779,8 +6779,8 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly tools: true;
                     readonly reasoning: true;
                     readonly webSearch: true;
-                    readonly jsonOutput: true;
-                    readonly structuredOutputs: true;
+                    readonly jsonOutput: false;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "anthropic/claude-sonnet-4-5": {
@@ -6806,7 +6806,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: true;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "anthropic/claude-sonnet-4-5-20250929": {
@@ -6832,7 +6832,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: true;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "anthropic/claude-sonnet-4-6": {
@@ -6858,7 +6858,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: true;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly auto: {
@@ -6909,7 +6909,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: true;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "aws-bedrock/anthropic.claude-opus-4-20250514-v1:0": {
@@ -6961,7 +6961,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: true;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "aws-bedrock/anthropic.claude-opus-4-6-v1": {
@@ -6986,8 +6986,8 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly tools: true;
                     readonly reasoning: true;
                     readonly webSearch: true;
-                    readonly jsonOutput: true;
-                    readonly structuredOutputs: true;
+                    readonly jsonOutput: false;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "aws-bedrock/anthropic.claude-sonnet-4-5-20250929-v1:0": {
@@ -7013,7 +7013,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: true;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "aws-bedrock/anthropic.claude-sonnet-4-6": {
@@ -7039,7 +7039,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: true;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "aws-bedrock/meta.llama3-1-8b-instruct-v1:0": {
@@ -11188,7 +11188,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: false;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "anthropic/claude-haiku-4-5-20251001": {
@@ -11214,7 +11214,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: false;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "anthropic/claude-opus-4-8": {
@@ -11318,7 +11318,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: false;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "aws-bedrock/anthropic.claude-opus-4-8": {
@@ -12181,7 +12181,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: false;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "llmapi-anthropic/claude-opus-4-8": {
@@ -12233,7 +12233,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: true;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "llmapi-openai/gpt-5-mini": {
@@ -18265,7 +18265,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: true;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "claude-sonnet-4-5-20250929": {
@@ -18291,7 +18291,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: true;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "claude-sonnet-4-6": {
@@ -18317,7 +18317,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: true;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "claude-haiku-4-5": {
@@ -18343,7 +18343,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: false;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "claude-haiku-4-5-20251001": {
@@ -18369,7 +18369,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: false;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "claude-opus-4-20250514": {
@@ -18421,7 +18421,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: true;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "claude-opus-4-5-20251101": {
@@ -18447,7 +18447,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: true;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "claude-opus-4-6": {
@@ -18472,8 +18472,8 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly tools: true;
                     readonly reasoning: true;
                     readonly webSearch: true;
-                    readonly jsonOutput: true;
-                    readonly structuredOutputs: true;
+                    readonly jsonOutput: false;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "gemini-2.5-pro": {
@@ -21976,7 +21976,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: true;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "anthropic/claude-opus-4-20250514": {
@@ -22028,7 +22028,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: true;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "anthropic/claude-opus-4-6": {
@@ -22053,8 +22053,8 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly tools: true;
                     readonly reasoning: true;
                     readonly webSearch: true;
-                    readonly jsonOutput: true;
-                    readonly structuredOutputs: true;
+                    readonly jsonOutput: false;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "anthropic/claude-sonnet-4-5": {
@@ -22080,7 +22080,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: true;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "anthropic/claude-sonnet-4-5-20250929": {
@@ -22106,7 +22106,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: true;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "anthropic/claude-sonnet-4-6": {
@@ -22132,7 +22132,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: true;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly auto: {
@@ -22183,7 +22183,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: true;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "aws-bedrock/anthropic.claude-opus-4-20250514-v1:0": {
@@ -22235,7 +22235,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: true;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "aws-bedrock/anthropic.claude-opus-4-6-v1": {
@@ -22260,8 +22260,8 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly tools: true;
                     readonly reasoning: true;
                     readonly webSearch: true;
-                    readonly jsonOutput: true;
-                    readonly structuredOutputs: true;
+                    readonly jsonOutput: false;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "aws-bedrock/anthropic.claude-sonnet-4-5-20250929-v1:0": {
@@ -22287,7 +22287,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: true;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "aws-bedrock/anthropic.claude-sonnet-4-6": {
@@ -22313,7 +22313,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: true;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "aws-bedrock/meta.llama3-1-8b-instruct-v1:0": {
@@ -26462,7 +26462,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: false;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "anthropic/claude-haiku-4-5-20251001": {
@@ -26488,7 +26488,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: false;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "anthropic/claude-opus-4-8": {
@@ -26592,7 +26592,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: false;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "aws-bedrock/anthropic.claude-opus-4-8": {
@@ -27455,7 +27455,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: false;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "llmapi-anthropic/claude-opus-4-8": {
@@ -27507,7 +27507,7 @@ export declare const LLM_SERVICE_MODELS: {
                     readonly reasoning: true;
                     readonly webSearch: true;
                     readonly jsonOutput: false;
-                    readonly structuredOutputs: true;
+                    readonly structuredOutputs: false;
                 };
             };
             readonly "llmapi-openai/gpt-5-mini": {

package/dist/LLMService.typedefs.d.ts

@@ -528,7 +528,14 @@ export type LLMAssistanceOptions<Provider extends LLMProviders, Reporter extends
      * guard the call.
      */
     onAssistantNarration?: (text: string) => void;
+    onModelStepStarted?: () => void;
+    onToolCallRejected?: (call: LLMRejectedToolCall) => void;
 };
+export interface LLMRejectedToolCall {
+    name: string;
+    input: Record<string, unknown>;
+    error: string;
+}
 /**
  * Result type for assistance requests.
  */

package/dist/LLMService.typedefs.js.map

@@ -1 +1 @@
-{"version":3,"file":"LLMService.typedefs.js","sourceRoot":"","sources":["../src/LLMService.typedefs.ts"],"names":[],"mappings":";;;AAmCA;;GAEG;AACH,IAAY,YAIX;AAJD,WAAY,YAAY;IACtB,iCAAiB,CAAA;IACjB,yDAAyC,CAAA;IACzC,iCAAiB,CAAA;AACnB,CAAC,EAJW,YAAY,4BAAZ,YAAY,QAIvB;AAoBD;;GAEG;AACH,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,wCAAyB,CAAA;IACzB,wCAAyB,CAAA;IACzB,8CAA+B,CAAA;IAC/B,8CAA+B,CAAA;AACjC,CAAC,EALW,WAAW,2BAAX,WAAW,QAKtB;AAkLD;;GAEG;AACH,IAAY,QAGX;AAHD,WAAY,QAAQ;IAClB,yBAAa,CAAA;IACb,mCAAuB,CAAA;AACzB,CAAC,EAHW,QAAQ,wBAAR,QAAQ,QAGnB;AAED;;GAEG;AACH,IAAY,qBAIX;AAJD,WAAY,qBAAqB;IAC/B,sCAAa,CAAA;IACb,gDAAuB,CAAA;IACvB,kDAAyB,CAAA;AAC3B,CAAC,EAJW,qBAAqB,qCAArB,qBAAqB,QAIhC;AA4DD;;;;;GAKG;AACH,IAAY,oBAKX;AALD,WAAY,oBAAoB;IAC9B,2CAAmB,CAAA;IACnB,8CAAsB,CAAA;IACtB,kDAA0B,CAAA;IAC1B,2CAAmB,CAAA;AACrB,CAAC,EALW,oBAAoB,oCAApB,oBAAoB,QAK/B;AAwMD;;GAEG;AACH,IAAY,sBAeX;AAfD,WAAY,sBAAsB;IAChC,iDAAuB,CAAA;IACvB,mDAAyB,CAAA;IACzB,iDAAuB,CAAA;IACvB,iDAAuB,CAAA;IACvB,mDAAyB,CAAA;IACzB,yDAA+B,CAAA;IAC/B,iDAAuB,CAAA;IACvB,mDAAyB,CAAA;IACzB,oDAA0B,CAAA;IAC1B,iDAAuB,CAAA;IACvB,mDAAyB,CAAA;IACzB,iDAAuB,CAAA;IACvB,mDAAyB,CAAA;IACzB,iDAAuB,CAAA;AACzB,CAAC,EAfW,sBAAsB,sCAAtB,sBAAsB,QAejC;AAmPD;;;;;GAKG;AACH,IAAY,sBAIX;AAJD,WAAY,sBAAsB;IAChC,iDAAuB,CAAA;IACvB,0DAAgC,CAAA;IAChC,wDAA8B,CAAA;AAChC,CAAC,EAJW,sBAAsB,sCAAtB,sBAAsB,QAIjC"}
+{"version":3,"file":"LLMService.typedefs.js","sourceRoot":"","sources":["../src/LLMService.typedefs.ts"],"names":[],"mappings":";;;AAmCA;;GAEG;AACH,IAAY,YAIX;AAJD,WAAY,YAAY;IACtB,iCAAiB,CAAA;IACjB,yDAAyC,CAAA;IACzC,iCAAiB,CAAA;AACnB,CAAC,EAJW,YAAY,4BAAZ,YAAY,QAIvB;AAoBD;;GAEG;AACH,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,wCAAyB,CAAA;IACzB,wCAAyB,CAAA;IACzB,8CAA+B,CAAA;IAC/B,8CAA+B,CAAA;AACjC,CAAC,EALW,WAAW,2BAAX,WAAW,QAKtB;AAkLD;;GAEG;AACH,IAAY,QAGX;AAHD,WAAY,QAAQ;IAClB,yBAAa,CAAA;IACb,mCAAuB,CAAA;AACzB,CAAC,EAHW,QAAQ,wBAAR,QAAQ,QAGnB;AAED;;GAEG;AACH,IAAY,qBAIX;AAJD,WAAY,qBAAqB;IAC/B,sCAAa,CAAA;IACb,gDAAuB,CAAA;IACvB,kDAAyB,CAAA;AAC3B,CAAC,EAJW,qBAAqB,qCAArB,qBAAqB,QAIhC;AA4DD;;;;;GAKG;AACH,IAAY,oBAKX;AALD,WAAY,oBAAoB;IAC9B,2CAAmB,CAAA;IACnB,8CAAsB,CAAA;IACtB,kDAA0B,CAAA;IAC1B,2CAAmB,CAAA;AACrB,CAAC,EALW,oBAAoB,oCAApB,oBAAoB,QAK/B;AAwMD;;GAEG;AACH,IAAY,sBAeX;AAfD,WAAY,sBAAsB;IAChC,iDAAuB,CAAA;IACvB,mDAAyB,CAAA;IACzB,iDAAuB,CAAA;IACvB,iDAAuB,CAAA;IACvB,mDAAyB,CAAA;IACzB,yDAA+B,CAAA;IAC/B,iDAAuB,CAAA;IACvB,mDAAyB,CAAA;IACzB,oDAA0B,CAAA;IAC1B,iDAAuB,CAAA;IACvB,mDAAyB,CAAA;IACzB,iDAAuB,CAAA;IACvB,mDAAyB,CAAA;IACzB,iDAAuB,CAAA;AACzB,CAAC,EAfW,sBAAsB,sCAAtB,sBAAsB,QAejC;AA2PD;;;;;GAKG;AACH,IAAY,sBAIX;AAJD,WAAY,sBAAsB;IAChC,iDAAuB,CAAA;IACvB,0DAAgC,CAAA;IAChC,wDAA8B,CAAA;AAChC,CAAC,EAJW,sBAAsB,sCAAtB,sBAAsB,QAIjC"}

package/dist/client/agentRun.typedefs.d.ts

@@ -12,6 +12,7 @@ import { type LLMAgentSubagent } from '../client/LLMAgent';
  */
 export declare enum LLMAgentEventTypes {
     AgentStarted = "agent_started",
+    AgentStepStarted = "agent_step_started",
     AgentMessage = "agent_message",
     AgentCompleted = "agent_completed",
     AgentFailed = "agent_failed",
@@ -19,6 +20,7 @@ export declare enum LLMAgentEventTypes {
     ToolCallCompleted = "tool_call_completed",
     ToolCallFailed = "tool_call_failed",
     ToolCallDenied = "tool_call_denied",
+    ToolCallRejected = "tool_call_rejected",
     SubagentStarted = "subagent_started",
     SubagentCompleted = "subagent_completed",
     SubagentFailed = "subagent_failed"
@@ -50,6 +52,9 @@ export interface LLMAgentStartedEvent extends LLMAgentEventBase {
     type: LLMAgentEventTypes.AgentStarted;
     input: string;
 }
+export interface LLMAgentStepStartedEvent extends LLMAgentEventBase {
+    type: LLMAgentEventTypes.AgentStepStarted;
+}
 /**
  * Visible assistant text the model produced in a tool-calling round that will
  * continue the loop — narration emitted alongside tool calls, before those
@@ -103,6 +108,12 @@ export interface LLMAgentToolCallDeniedEvent extends LLMAgentInvocationEventBase
     tool: string;
     reason: string;
 }
+export interface LLMAgentToolCallRejectedEvent extends LLMAgentEventBase {
+    type: LLMAgentEventTypes.ToolCallRejected;
+    tool: string;
+    input: unknown;
+    error: string;
+}
 export interface LLMAgentSubagentStartedEvent extends LLMAgentSubagentEventBase {
     type: LLMAgentEventTypes.SubagentStarted;
     input: string;
@@ -117,7 +128,7 @@ export interface LLMAgentSubagentFailedEvent extends LLMAgentSubagentEventBase {
     error: string;
     durationMs: number;
 }
-export type LLMAgentEvent = LLMAgentStartedEvent | LLMAgentMessageEvent | LLMAgentCompletedEvent | LLMAgentFailedEvent | LLMAgentToolCallStartedEvent | LLMAgentToolCallCompletedEvent | LLMAgentToolCallFailedEvent | LLMAgentToolCallDeniedEvent | LLMAgentSubagentStartedEvent | LLMAgentSubagentCompletedEvent | LLMAgentSubagentFailedEvent;
+export type LLMAgentEvent = LLMAgentStartedEvent | LLMAgentStepStartedEvent | LLMAgentMessageEvent | LLMAgentCompletedEvent | LLMAgentFailedEvent | LLMAgentToolCallStartedEvent | LLMAgentToolCallCompletedEvent | LLMAgentToolCallFailedEvent | LLMAgentToolCallDeniedEvent | LLMAgentToolCallRejectedEvent | LLMAgentSubagentStartedEvent | LLMAgentSubagentCompletedEvent | LLMAgentSubagentFailedEvent;
 /**
  * May be async: a returned promise's rejection is caught and logged, so a
  * failing listener (WS publish, DB persist) never affects the agent run.

package/dist/client/agentRun.typedefs.js

@@ -11,6 +11,7 @@ exports.LLMAgentEventTypes = void 0;
 var LLMAgentEventTypes;
 (function (LLMAgentEventTypes) {
     LLMAgentEventTypes["AgentStarted"] = "agent_started";
+    LLMAgentEventTypes["AgentStepStarted"] = "agent_step_started";
     LLMAgentEventTypes["AgentMessage"] = "agent_message";
     LLMAgentEventTypes["AgentCompleted"] = "agent_completed";
     LLMAgentEventTypes["AgentFailed"] = "agent_failed";
@@ -18,6 +19,7 @@ var LLMAgentEventTypes;
     LLMAgentEventTypes["ToolCallCompleted"] = "tool_call_completed";
     LLMAgentEventTypes["ToolCallFailed"] = "tool_call_failed";
     LLMAgentEventTypes["ToolCallDenied"] = "tool_call_denied";
+    LLMAgentEventTypes["ToolCallRejected"] = "tool_call_rejected";
     LLMAgentEventTypes["SubagentStarted"] = "subagent_started";
     LLMAgentEventTypes["SubagentCompleted"] = "subagent_completed";
     LLMAgentEventTypes["SubagentFailed"] = "subagent_failed";

package/dist/client/agentRun.typedefs.js.map

@@ -1 +1 @@
-{"version":3,"file":"agentRun.typedefs.js","sourceRoot":"","sources":["../../src/client/agentRun.typedefs.ts"],"names":[],"mappings":";;;AAeA;;;;;;GAMG;AACH,IAAY,kBAYX;AAZD,WAAY,kBAAkB;IAC5B,oDAA8B,CAAA;IAC9B,oDAA8B,CAAA;IAC9B,wDAAkC,CAAA;IAClC,kDAA4B,CAAA;IAC5B,2DAAqC,CAAA;IACrC,+DAAyC,CAAA;IACzC,yDAAmC,CAAA;IACnC,yDAAmC,CAAA;IACnC,0DAAoC,CAAA;IACpC,8DAAwC,CAAA;IACxC,wDAAkC,CAAA;AACpC,CAAC,EAZW,kBAAkB,kCAAlB,kBAAkB,QAY7B"}
+{"version":3,"file":"agentRun.typedefs.js","sourceRoot":"","sources":["../../src/client/agentRun.typedefs.ts"],"names":[],"mappings":";;;AAeA;;;;;;GAMG;AACH,IAAY,kBAcX;AAdD,WAAY,kBAAkB;IAC5B,oDAA8B,CAAA;IAC9B,6DAAuC,CAAA;IACvC,oDAA8B,CAAA;IAC9B,wDAAkC,CAAA;IAClC,kDAA4B,CAAA;IAC5B,2DAAqC,CAAA;IACrC,+DAAyC,CAAA;IACzC,yDAAmC,CAAA;IACnC,yDAAmC,CAAA;IACnC,6DAAuC,CAAA;IACvC,0DAAoC,CAAA;IACpC,8DAAwC,CAAA;IACxC,wDAAkC,CAAA;AACpC,CAAC,EAdW,kBAAkB,kCAAlB,kBAAkB,QAc7B"}

package/dist/client/agentRunner.js

@@ -187,6 +187,23 @@ class LLMAgentRunner {
                     this.emitAgentMessage(run, session.runId, text);
                 }
                 : undefined,
+            onModelStepStarted: run.onEvent
+                ? () => this.emit(run.onEvent, {
+                    type: agentRun_typedefs_1.LLMAgentEventTypes.AgentStepStarted,
+                    agent: run.agentName,
+                    runId: session.runId,
+                })
+                : undefined,
+            onToolCallRejected: run.onEvent
+                ? (call) => this.emit(run.onEvent, {
+                    type: agentRun_typedefs_1.LLMAgentEventTypes.ToolCallRejected,
+                    agent: run.agentName,
+                    runId: session.runId,
+                    tool: call.name,
+                    input: call.input,
+                    error: call.error,
+                })
+                : undefined,
         };
         try {
             const sendResult = await service.assistInChat(assistOptions);