@amigo-ai/sdk 0.43.0 → 0.45.0

package/dist/types/generated/api-types.d.ts

@@ -192,7 +192,7 @@ export interface paths {
          *     * For action and decision states, each exit condition's `next_state` must either be a string that exists in the states and cannot be the same as the current state, or a 2-tuple of strings,
          *       with the first string of the form `{external_service_hierarchical_state_machine_reference.external_state_name}`, and the second string the jumpback state which must be a state
          *       in the states.
-         *     * For recall states, `next_state` must either be a string that exists in the states and cannot be the same as the current state, or a 2-tuple of strings,
+         *     * For `recall`, `reflection`, and `tool_call` states, `next_state` must either be a string that exists in the states and cannot be the same as the current state, or a 2-tuple of strings,
          *       with the first string of the form `{external_service_hierarchical_state_machine_reference.external_state_name}`, and the second string the jumpback state which must be a state
          *       in the states.
          *     * The terminal state cannot have exit conditions and must have exactly one action.
@@ -3774,7 +3774,7 @@ export interface components {
             /** Action */
             action: string;
         };
-        NavigateStateMachineAgentActionEvent: components["schemas"]["NavigateStateMachineDynamicBehaviorOverrideEvent"] | components["schemas"]["NavigateStateMachineActionStateActionSelectedEvent"] | components["schemas"]["NavigateStateMachineDecisionStateDecisionStartedEvent"] | components["schemas"]["NavigateStateMachineExitConditionSelectedEvent"] | components["schemas"]["NavigateStateMachineRecallStateDynamicQueriesGeneratedEvent"] | components["schemas"]["NavigateStateMachineRecallStateStaticQueriesRetrievedEvent"] | components["schemas"]["NavigateStateMachineRecallStateActiveMemoryRetrievedEvent"] | components["schemas"]["NavigateStateMachineReflectionStatePromptRetrievedEvent"] | components["schemas"]["NavigateStateMachineReflectionStateReflectionGeneratedEvent"] | components["schemas"]["NavigateStateMachineAnnotationStateAnnotationRetrievedEvent"] | components["schemas"]["NavigateStateMachineStateTransitionedEvent"] | components["schemas"]["ToolCallStartedEvent"] | components["schemas"]["ToolCallEndedEvent"] | components["schemas"]["ActionTooLongEvent"];
+        NavigateStateMachineAgentActionEvent: components["schemas"]["NavigateStateMachineDynamicBehaviorOverrideEvent"] | components["schemas"]["NavigateStateMachineActionStateActionSelectedEvent"] | components["schemas"]["NavigateStateMachineDecisionStateDecisionStartedEvent"] | components["schemas"]["NavigateStateMachineExitConditionSelectedEvent"] | components["schemas"]["NavigateStateMachineRecallStateDynamicQueriesGeneratedEvent"] | components["schemas"]["NavigateStateMachineRecallStateStaticQueriesRetrievedEvent"] | components["schemas"]["NavigateStateMachineRecallStateActiveMemoryRetrievedEvent"] | components["schemas"]["NavigateStateMachineReflectionStatePromptRetrievedEvent"] | components["schemas"]["NavigateStateMachineReflectionStateReflectionGeneratedEvent"] | components["schemas"]["NavigateStateMachineAnnotationStateAnnotationRetrievedEvent"] | components["schemas"]["NavigateStateMachineStateTransitionedEvent"] | components["schemas"]["NavigateStateMachineToolCallStateDesignatedToolRetrievedEvent"] | components["schemas"]["NavigateStateMachineToolCallStateToolParamsGeneratedEvent"] | components["schemas"]["NavigateStateMachineToolCallStateToolOutputAvailableEvent"] | components["schemas"]["ToolCallStartedEvent"] | components["schemas"]["ToolCallEndedEvent"] | components["schemas"]["ActionTooLongEvent"];
         /**
          * NavigateStateMachineAnnotationStateAnnotationRetrievedEvent
          * @description Indicating that the agent has retrieved the annotation in the current annotation state.
@@ -3966,6 +3966,66 @@ export interface components {
                 number
             ];
         };
+        /**
+         * NavigateStateMachineToolCallStateDesignatedToolRetrievedEvent
+         * @description Indicating that the agent has retrieved the designated tool in the current tool call state.
+         */
+        NavigateStateMachineToolCallStateDesignatedToolRetrievedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            type: "navigate-state-machine-tool-call-state-designated-tool-retrieved";
+            /**
+             * Tool Id
+             * @description The ID of the tool being called.
+             */
+            tool_id: string;
+            /**
+             * Tool Version
+             * @description The version of the tool being called.
+             */
+            tool_version: string;
+        };
+        /**
+         * NavigateStateMachineToolCallStateToolOutputAvailableEvent
+         * @description Indicating that the agent has received the tool output in the current tool call state.
+         */
+        NavigateStateMachineToolCallStateToolOutputAvailableEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            type: "navigate-state-machine-tool-call-state-tool-output-available";
+            /**
+             * Tool Output
+             * @description The tool output.
+             */
+            tool_output: string;
+            /**
+             * Duration
+             * @description The duration taken to receive the tool output in seconds.
+             */
+            duration: number;
+        };
+        /**
+         * NavigateStateMachineToolCallStateToolParamsGeneratedEvent
+         * @description Indicating that the agent has generated the tool parameters in the current tool call state.
+         */
+        NavigateStateMachineToolCallStateToolParamsGeneratedEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            type: "navigate-state-machine-tool-call-state-tool-params-generated";
+            /**
+             * Tool Params
+             * @description The generated tool parameters.
+             */
+            tool_params: {
+                [key: string]: unknown;
+            };
+        };
         /**
          * NewMessageEvent
          * @description Emitted when a new piece of the agent message is available.
@@ -5192,7 +5252,7 @@ export interface components {
             /** @description The user who created the unit test set run. */
             creator: components["schemas"]["amigo_lib__mongo__collections__simulation_unit_test_set_run__SimulationUnitTestSetRun__UserInfo"];
         };
-        State: components["schemas"]["ActionState-Output"] | components["schemas"]["DecisionState-Output"] | components["schemas"]["RecallState-Output"] | components["schemas"]["AnnotationState-Output"] | components["schemas"]["ReflectionState-Output"];
+        State: components["schemas"]["ActionState-Output"] | components["schemas"]["DecisionState-Output"] | components["schemas"]["RecallState-Output"] | components["schemas"]["AnnotationState-Output"] | components["schemas"]["ReflectionState-Output"] | components["schemas"]["ToolCallState-Output"];
         /** StateMachineInstance */
         StateMachineInstance: {
             /**
@@ -5248,7 +5308,7 @@ export interface components {
              */
             tool_call_round_index: number;
         };
-        StateTransitionLog: components["schemas"]["ActionStateTransitionLog"] | components["schemas"]["DecisionStateTransitionLog"] | components["schemas"]["RecallStateTransitionLog"] | components["schemas"]["JumpbackStateTransitionLog"] | components["schemas"]["AnnotationStateTransitionLog"] | components["schemas"]["ReflectionStateTransitionLog"];
+        StateTransitionLog: components["schemas"]["ActionStateTransitionLog"] | components["schemas"]["DecisionStateTransitionLog"] | components["schemas"]["RecallStateTransitionLog"] | components["schemas"]["JumpbackStateTransitionLog"] | components["schemas"]["AnnotationStateTransitionLog"] | components["schemas"]["ReflectionStateTransitionLog"] | components["schemas"]["ToolCallStateTransitionLog"];
         "StrippedNonemptyString_A-Z______": string;
         StrippedNonemptyString_________: string;
         StrippedNonemptyString___w__s_____: string;
@@ -5462,6 +5522,141 @@ export interface components {
                 [key: string]: unknown;
             };
         };
+        /** ToolCallState */
+        "ToolCallState-Input": {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            type: "tool-call";
+            name: components["schemas"]["StateOrRefName"];
+            /** Next State */
+            next_state: components["schemas"]["StateOrRefName"] | [
+                components["schemas"]["ExternalStateName"],
+                components["schemas"]["StateOrRefName"]
+            ];
+            designated_tool: components["schemas"]["ToolCallSpec-Input"];
+            /** Designated Tool Call Params Generation Audio Fillers */
+            designated_tool_call_params_generation_audio_fillers: components["schemas"]["StrippedNonemptyString_________"][];
+            /** Designated Tool Call Params Generation Audio Filler Triggered After */
+            designated_tool_call_params_generation_audio_filler_triggered_after: number;
+            designated_tool_call_objective: components["schemas"]["amigo_lib__pydantic__base_model__StrippedNonemptyString__1"];
+            designated_tool_call_context: components["schemas"]["amigo_lib__pydantic__base_model__StrippedNonemptyString__1"];
+            /** Designated Tool Call Guidances */
+            designated_tool_call_guidances: components["schemas"]["amigo_lib__pydantic__base_model__StrippedNonemptyString__1"][];
+            /** Designated Tool Call Validations */
+            designated_tool_call_validations: components["schemas"]["amigo_lib__pydantic__base_model__StrippedNonemptyString__1"][];
+            /** Tool Call Specs */
+            tool_call_specs: components["schemas"]["ToolCallSpec-Input"][];
+        };
+        /**
+         * ToolCallState
+         * @description A state that executes a tool call.
+         */
+        "ToolCallState-Output": {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            type: "tool-call";
+            /**
+             * Name
+             * @description The name of this state.
+             */
+            name: string;
+            /**
+             * Next State
+             * @description The state to transition to after the inner thought message is generated. If it's a string, the session will transition to a state within this contextual graph. If it's a tuple, the first element
+             *     must be of the form `{external_contextual_graph_reference_name}.{state_name}` and represents a state in another contextual graph that the session will transition to, and the second element must be a state
+             *     in this contextual graph that the session will transition to after reaching the terminal state of the external graph.
+             */
+            next_state: string | [
+                string,
+                string
+            ];
+            /** @description The tool that the agent is to call in this state. */
+            designated_tool: components["schemas"]["ToolCallSpec-Output"];
+            /**
+             * Designated Tool Call Params Generation Audio Fillers
+             * @description A list of audio fillers to play in audio mode if the designated tool call's input generation is taking a long time.
+             */
+            designated_tool_call_params_generation_audio_fillers: string[];
+            /**
+             * Designated Tool Call Params Generation Audio Filler Triggered After
+             * @description The number of seconds to wait after the designated tool call params generation starts before playing an audio filler.
+             */
+            designated_tool_call_params_generation_audio_filler_triggered_after: number;
+            /**
+             * Designated Tool Call Objective
+             * @description The objective that the agent is to achieve when generating the input to the designated tool. High-level optimization goal defining what "ideal" means for this state. Frames the strategic
+             *     intent and success criteria, not the technical tool description. Focuses on user value and conversation progress.
+             */
+            designated_tool_call_objective: string;
+            /**
+             * Designated Tool Call Context
+             * @description The context that the agent can use when generating the input to the designated tool. The minimal information gap this tool state closes within the conversation flow. Explains what's missing
+             *     upstream and how this tool execution bridges to downstream states. Should be brief and only included when the tool's purpose isn't self-evident from the topology.
+             */
+            designated_tool_call_context: string;
+            /**
+             * Designated Tool Call Guidances
+             * @description The guidance that the agent must follow when generating the input to the designated tool. Best practices and proven patterns for constructing quality payloads. Practical tips and heuristics
+             *     to guide decisions. Suggestions, not strict requirements. Leave empty if tool schema and objective are self-explanatory.
+             */
+            designated_tool_call_guidances: string[];
+            /**
+             * Designated Tool Call Validations
+             * @description A list of validations that the agent must ensure are satisfied when generating the input to the designated tool. Strict constraints that MUST be satisfied before payload handoff. Hard requirements
+             *     and invariants verified before execution. Pass/fail checks, not suggestions. Leave empty if only schema compliance is required.
+             */
+            designated_tool_call_validations: string[];
+            /**
+             * Tool Call Specs
+             * @description A list of tool calls that the agent can make to help generating the input to the designated tool.
+             */
+            tool_call_specs: components["schemas"]["ToolCallSpec-Output"][];
+        };
+        /** ToolCallStateTransitionLog */
+        ToolCallStateTransitionLog: {
+            /**
+             * Previous State
+             * @description Name of the previous state to transition from.
+             */
+            previous_state: string;
+            /**
+             * Previous Service Hierarchical State Machine Version Info
+             * @description The identifier of the service hierarchical state machine that the previous state is in.
+             */
+            previous_service_hierarchical_state_machine_version_info: [
+                string,
+                number
+            ];
+            /**
+             * Next State
+             * @description Name of the next state to transition to.
+             */
+            next_state: string;
+            /**
+             * Next Service Hierarchical State Machine Version Info
+             * @description The identifier of the service hierarchical state machine that the next state is in.
+             */
+            next_service_hierarchical_state_machine_version_info: [
+                string,
+                number
+            ];
+            /**
+             * @description The type of the state transition log, which is the type of the state we're transitioning from. (enum property replaced by openapi-typescript)
+             * @enum {string}
+             */
+            type: "tool-call";
+            /**
+             * Tool Call Logs
+             * @description A list of tool call logs that were performed during this state, except for the tool call for the designated tool call.
+             */
+            tool_call_logs: components["schemas"]["ToolCallLog"][][];
+            /** @description The tool call log for the designated tool call in this state. */
+            designated_tool_call_log: components["schemas"]["ToolCallLog"];
+        };
         /** ToolInstance */
         ToolInstance: {
             /**
@@ -7063,7 +7258,7 @@ export interface components {
              * States
              * @description The internal states in this service hierarchical state machine.
              */
-            states: (components["schemas"]["ActionState-Input"] | components["schemas"]["DecisionState-Input"] | components["schemas"]["RecallState-Input"] | components["schemas"]["AnnotationState-Input"] | components["schemas"]["ReflectionState-Input"])[];
+            states: (components["schemas"]["ActionState-Input"] | components["schemas"]["DecisionState-Input"] | components["schemas"]["RecallState-Input"] | components["schemas"]["AnnotationState-Input"] | components["schemas"]["ReflectionState-Input"] | components["schemas"]["ToolCallState-Input"])[];
             /** @description The state a new user will be in when a session starts. This must be an action state, and must be an internal state. */
             new_user_initial_state: components["schemas"]["StateOrRefName"];
             /** @description The state a returning user will be in when a session starts. This must be an action state, and must be an internal state. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amigo-ai/sdk",
-  "version": "0.43.0",
+  "version": "0.45.0",
   "description": "Amigo TypeScript SDK",
   "publishConfig": {
     "access": "public"