@wildix/wim-tools-client 4.0.1 → 4.0.4

package/dist-types/models/models_0.d.ts

@@ -1,5 +1,442 @@
 import type { DocumentType as __DocumentType } from "@smithy/types";
-import type { ToolVariableType, ToolWebhookMethod } from "./enums";
+import type { ConnectorAuthorizationMode, ToolCalendarOperation, ToolVariableType, ToolWebhookMethod } from "./enums";
+/**
+ * Company-managed Nango connection.
+ * @public
+ */
+export interface ConnectorSharedAuthorization {
+    /**
+     * Nango connection identifier.
+     * @public
+     */
+    connectionId: string;
+}
+/**
+ * Marker selecting authorization resolved from the executing user.
+ * @public
+ */
+export interface ConnectorUserAuthorization {
+}
+/**
+ * Credential selection for a configured connector. Credentials remain in Nango.
+ * @public
+ */
+export type ConnectorAuthorization = ConnectorAuthorization.SharedMember | ConnectorAuthorization.UserMember | ConnectorAuthorization.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace ConnectorAuthorization {
+    /**
+     * Use one company-managed connection.
+     * @public
+     */
+    interface SharedMember {
+        shared: ConnectorSharedAuthorization;
+        user?: never;
+        $unknown?: never;
+    }
+    /**
+     * Resolve a connection from the executing user.
+     * @public
+     */
+    interface UserMember {
+        shared?: never;
+        user: ConnectorUserAuthorization;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        shared?: never;
+        user?: never;
+        $unknown: [string, any];
+    }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
+    interface Visitor<T> {
+        shared: (value: ConnectorSharedAuthorization) => T;
+        user: (value: ConnectorUserAuthorization) => T;
+        _: (name: string, value: any) => T;
+    }
+}
+/**
+ * Reference to one immutable connector definition.
+ * @public
+ */
+export interface ConnectorDefinitionRef {
+    /**
+     * Stable definition identifier.
+     * @public
+     */
+    key: string;
+    /**
+     * Exact definition version.
+     * @public
+     */
+    version: string;
+}
+/**
+ * Company-owned configured connector.
+ * @public
+ */
+export interface Connector {
+    /**
+     * Immutable definition used to validate configuration and execute tools.
+     * @public
+     */
+    definition: ConnectorDefinitionRef;
+    /**
+     * Values validated against the definition configuration schema.
+     * @public
+     */
+    configuration: __DocumentType;
+    /**
+     * Credential selection, omitted when no authorization is required. The same Nango
+     * connection reference may be reused across multiple Tools and Connectors.
+     * @public
+     */
+    authorization?: ConnectorAuthorization | undefined;
+    /**
+     * Name exposed to administrators and AI agents.
+     * @public
+     */
+    name: string;
+    /**
+     * Description exposed to administrators and AI agents.
+     * @public
+     */
+    description: string;
+    /**
+     * Explicit allowlist of tools available to callers and agents.
+     * @public
+     */
+    enabledTools: string[];
+    /**
+     * Unique connector instance identifier.
+     * @public
+     */
+    id: string;
+    /**
+     * Company that owns this connector.
+     * @public
+     */
+    companyId: string;
+}
+/**
+ * Authorization requirements declared by a connector definition.
+ * @public
+ */
+export interface ConnectorAuthorizationDefinition {
+    /**
+     * Nango provider configuration key.
+     * @public
+     */
+    provider: string;
+    /**
+     * Credential resolution modes supported by this connector.
+     * @public
+     */
+    modes: ConnectorAuthorizationMode[];
+    /**
+     * Base OAuth scopes required by every tool.
+     * @public
+     */
+    scopes?: string[] | undefined;
+}
+/**
+ * Configuration contract rendered by management clients and validated by the service.
+ * @public
+ */
+export interface ConnectorConfigurationDefinition {
+    /**
+     * JSON Schema 2020-12 document describing persisted configuration.
+     * @public
+     */
+    schema: __DocumentType;
+    /**
+     * Presentation hints for a compatible JSON Schema form renderer.
+     * @public
+     */
+    uiSchema?: __DocumentType | undefined;
+    /**
+     * Initial values to use when creating a connector.
+     * @public
+     */
+    initialValues?: __DocumentType | undefined;
+}
+/**
+ * Display metadata for a connector catalog entry.
+ * @public
+ */
+export interface ConnectorMetadata {
+    /**
+     * Human-readable connector name.
+     * @public
+     */
+    title: string;
+    /**
+     * Summary of the external system and supported use cases.
+     * @public
+     */
+    description: string;
+    /**
+     * Icon URL or renderer-known icon key.
+     * @public
+     */
+    icon?: string | undefined;
+    /**
+     * Catalog category used for discovery and filtering.
+     * @public
+     */
+    category?: string | undefined;
+    /**
+     * Link to external connector documentation.
+     * @public
+     */
+    documentationUrl?: string | undefined;
+}
+/**
+ * Behavioral hints aligned with the Model Context Protocol tool annotations.
+ *
+ * These fields help agents decide whether confirmation is appropriate. They are
+ * not authorization controls and must not replace server-side policy checks.
+ * @public
+ */
+export interface ConnectorToolAnnotations {
+    /**
+     * Indicates that the tool does not modify external state.
+     * @public
+     */
+    readOnlyHint?: boolean | undefined;
+    /**
+     * Indicates that the tool can perform destructive updates.
+     * @public
+     */
+    destructiveHint?: boolean | undefined;
+    /**
+     * Indicates that repeated calls with identical arguments have no additional effect.
+     * @public
+     */
+    idempotentHint?: boolean | undefined;
+    /**
+     * Indicates that the tool can interact with entities outside a closed domain.
+     * @public
+     */
+    openWorldHint?: boolean | undefined;
+}
+/**
+ * @public
+ */
+export interface ToolVariable {
+    /**
+     * Name of the tool variable, e.g.: 'myvar'
+     * @public
+     */
+    name: string;
+    /**
+     * Type of the tool variable, e.g.: 'string', 'number', 'boolean', 'string_array', 'number_array'
+     * @public
+     */
+    type: ToolVariableType;
+    /**
+     * Whether the variable is optional
+     * @public
+     */
+    optional: boolean;
+    /**
+     * Description used by people and AI agents.
+     * @public
+     */
+    description?: string | undefined;
+    /**
+     * Allowed values when type is string.
+     * @public
+     */
+    enum?: string[] | undefined;
+    /**
+     * Value format hint when type is string, such as email or uri.
+     * @public
+     */
+    format?: string | undefined;
+    /**
+     * Nested JSON Schema when type is schema.
+     * @public
+     */
+    schema?: __DocumentType | undefined;
+}
+/**
+ * @public
+ */
+export interface ToolInput {
+    /**
+     * Agent arguments for the tool.
+     * @public
+     */
+    variables: ToolVariable[];
+}
+/**
+ * Tool exposed by a connector definition.
+ * @public
+ */
+export interface ConnectorTool {
+    /**
+     * Stable dispatch identifier used in `ExecuteConnector` input keys.
+     * @public
+     */
+    id: string;
+    /**
+     * Agent-facing tool name.
+     * @public
+     */
+    name: string;
+    /**
+     * Description used by people and AI agents to select the tool.
+     * @public
+     */
+    description: string;
+    /**
+     * Tool arguments exposed to agents, using the same contract as `Tool.input`.
+     * @public
+     */
+    input: ToolInput;
+    /**
+     * Additional OAuth scopes required by this tool.
+     * @public
+     */
+    authorizationScopes?: string[] | undefined;
+    /**
+     * Behavioral hints for agents and approval systems.
+     * @public
+     */
+    annotations?: ConnectorToolAnnotations | undefined;
+}
+/**
+ * Immutable server-owned connector definition.
+ * @public
+ */
+export interface ConnectorDefinition {
+    /**
+     * Stable key and exact immutable version.
+     * @public
+     */
+    ref: ConnectorDefinitionRef;
+    /**
+     * Catalog display metadata.
+     * @public
+     */
+    metadata: ConnectorMetadata;
+    /**
+     * Connector instance configuration contract.
+     * @public
+     */
+    configuration: ConnectorConfigurationDefinition;
+    /**
+     * Authorization requirements, omitted when the connector needs no credentials.
+     * @public
+     */
+    authorization?: ConnectorAuthorizationDefinition | undefined;
+    /**
+     * Tools available in this definition version.
+     * @public
+     */
+    tools: ConnectorTool[];
+    /**
+     * Whether new instances should avoid this definition.
+     * @public
+     */
+    deprecated?: boolean | undefined;
+    /**
+     * Suggested replacement when this definition is deprecated.
+     * @public
+     */
+    replacedBy?: ConnectorDefinitionRef | undefined;
+}
+/**
+ * Result of executing a connector.
+ * @public
+ */
+export interface ConnectorExecutionResult {
+    /**
+     * Structured tool output.
+     * @public
+     */
+    output: __DocumentType;
+    /**
+     * Identifier used to correlate logs and traces.
+     * @public
+     */
+    executionId: string;
+    /**
+     * Definition version used for validation and execution.
+     * @public
+     */
+    definitionVersion: string;
+}
+/**
+ * Fields supplied when a connector is created or replaced.
+ * @public
+ */
+export interface CreateConnectorInput {
+    /**
+     * Immutable definition used to validate configuration and execute tools.
+     * @public
+     */
+    definition: ConnectorDefinitionRef;
+    /**
+     * Values validated against the definition configuration schema.
+     * @public
+     */
+    configuration: __DocumentType;
+    /**
+     * Credential selection, omitted when no authorization is required. The same Nango
+     * connection reference may be reused across multiple Tools and Connectors.
+     * @public
+     */
+    authorization?: ConnectorAuthorization | undefined;
+    /**
+     * Name exposed to administrators and AI agents.
+     * @public
+     */
+    name: string;
+    /**
+     * Description exposed to administrators and AI agents.
+     * @public
+     */
+    description: string;
+    /**
+     * Explicit allowlist of tools available to callers and agents.
+     * @public
+     */
+    enabledTools: string[];
+    /**
+     * The unique identifier of the tenant when a service token is used.
+     * @public
+     */
+    companyId?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface CreateConnectorOutput {
+    /**
+     * Created connector.
+     * @public
+     */
+    connector: Connector;
+}
+/**
+ * @public
+ */
+export interface ToolCalendarConfig {
+    /**
+     * Calendar operation executed by the tool. Use separate tools per operation and keep the operation fixed in the handler instead of passing it in runtime input.
+     * @public
+     */
+    operation: ToolCalendarOperation;
+}
 /**
  * @public
  */
@@ -74,6 +511,36 @@ export interface ToolChatHandler {
      */
     config: ToolChatConfig;
 }
+/**
+ * Handler for a connector-backed Tool created through `CreateTool`.
+ *
+ * The service resolves agent arguments from the pinned connector tool definition.
+ * Create and update requests omit `input` when this handler is used.
+ * @public
+ */
+export interface ToolConnectorHandler {
+    /**
+     * Immutable definition used to validate configuration and execute tools.
+     * @public
+     */
+    definition: ConnectorDefinitionRef;
+    /**
+     * Values validated against the definition configuration schema.
+     * @public
+     */
+    configuration: __DocumentType;
+    /**
+     * Credential selection, omitted when no authorization is required. The same Nango
+     * connection reference may be reused across multiple Tools and Connectors.
+     * @public
+     */
+    authorization?: ConnectorAuthorization | undefined;
+    /**
+     * Connector tool from the pinned definition executed by this Tool.
+     * @public
+     */
+    toolId: string;
+}
 /**
  * @public
  */
@@ -504,7 +971,7 @@ export interface ToolWebhookConfig {
 /**
  * @public
  */
-export type ToolHandler = ToolHandler.ChatMember | ToolHandler.EmailMember | ToolHandler.McpMember | ToolHandler.McpToolMember | ToolHandler.SearchMember | ToolHandler.SmsMember | ToolHandler.WebhookMember | ToolHandler.$UnknownMember;
+export type ToolHandler = ToolHandler.CalendarMember | ToolHandler.ChatMember | ToolHandler.ConnectorMember | ToolHandler.EmailMember | ToolHandler.McpMember | ToolHandler.McpToolMember | ToolHandler.SearchMember | ToolHandler.SmsMember | ToolHandler.WebhookMember | ToolHandler.$UnknownMember;
 /**
  * @public
  */
@@ -515,6 +982,8 @@ export declare namespace ToolHandler {
         search?: never;
         chat?: never;
         sms?: never;
+        calendar?: never;
+        connector?: never;
         mcp?: never;
         mcpTool?: never;
         $unknown?: never;
@@ -525,6 +994,8 @@ export declare namespace ToolHandler {
         search?: never;
         chat?: never;
         sms?: never;
+        calendar?: never;
+        connector?: never;
         mcp?: never;
         mcpTool?: never;
         $unknown?: never;
@@ -539,6 +1010,8 @@ export declare namespace ToolHandler {
         search: ToolSearchConfig;
         chat?: never;
         sms?: never;
+        calendar?: never;
+        connector?: never;
         mcp?: never;
         mcpTool?: never;
         $unknown?: never;
@@ -549,6 +1022,8 @@ export declare namespace ToolHandler {
         search?: never;
         chat: ToolChatHandler;
         sms?: never;
+        calendar?: never;
+        connector?: never;
         mcp?: never;
         mcpTool?: never;
         $unknown?: never;
@@ -558,7 +1033,37 @@ export declare namespace ToolHandler {
         webhook?: never;
         search?: never;
         chat?: never;
-        sms: ToolSmsHandler;
+        sms: ToolSmsHandler;
+        calendar?: never;
+        connector?: never;
+        mcp?: never;
+        mcpTool?: never;
+        $unknown?: never;
+    }
+    interface CalendarMember {
+        email?: never;
+        webhook?: never;
+        search?: never;
+        chat?: never;
+        sms?: never;
+        calendar: ToolCalendarConfig;
+        connector?: never;
+        mcp?: never;
+        mcpTool?: never;
+        $unknown?: never;
+    }
+    /**
+     * Connector-backed Tool. Create with `CreateTool` using `handler.connector`. Authorization may reuse the same Nango connection as a Connector.
+     * @public
+     */
+    interface ConnectorMember {
+        email?: never;
+        webhook?: never;
+        search?: never;
+        chat?: never;
+        sms?: never;
+        calendar?: never;
+        connector: ToolConnectorHandler;
         mcp?: never;
         mcpTool?: never;
         $unknown?: never;
@@ -569,6 +1074,8 @@ export declare namespace ToolHandler {
         search?: never;
         chat?: never;
         sms?: never;
+        calendar?: never;
+        connector?: never;
         mcp: ToolMcpHandler;
         mcpTool?: never;
         $unknown?: never;
@@ -579,6 +1086,8 @@ export declare namespace ToolHandler {
         search?: never;
         chat?: never;
         sms?: never;
+        calendar?: never;
+        connector?: never;
         mcp?: never;
         mcpTool: ToolMcpToolHandler;
         $unknown?: never;
@@ -592,6 +1101,8 @@ export declare namespace ToolHandler {
         search?: never;
         chat?: never;
         sms?: never;
+        calendar?: never;
+        connector?: never;
         mcp?: never;
         mcpTool?: never;
         $unknown: [string, any];
@@ -606,51 +1117,13 @@ export declare namespace ToolHandler {
         search: (value: ToolSearchConfig) => T;
         chat: (value: ToolChatHandler) => T;
         sms: (value: ToolSmsHandler) => T;
+        calendar: (value: ToolCalendarConfig) => T;
+        connector: (value: ToolConnectorHandler) => T;
         mcp: (value: ToolMcpHandler) => T;
         mcpTool: (value: ToolMcpToolHandler) => T;
         _: (name: string, value: any) => T;
     }
 }
-/**
- * @public
- */
-export interface ToolVariable {
-    /**
-     * Name of the tool variable, e.g.: 'myvar'
-     * @public
-     */
-    name: string;
-    /**
-     * Type of the tool variable, e.g.: 'string', 'number', 'boolean', 'string_array', 'number_array'
-     * @public
-     */
-    type: ToolVariableType;
-    /**
-     * Whether the variable is optional
-     * @public
-     */
-    optional: boolean;
-    /**
-     * Original description from MCP tool schema (preserved)
-     * @public
-     */
-    description?: string | undefined;
-    /**
-     * JSON Schema in case if type is schema
-     * @public
-     */
-    schema?: __DocumentType | undefined;
-}
-/**
- * @public
- */
-export interface ToolInput {
-    /**
-     * List of tool variables, used to pass data to the tool
-     * @public
-     */
-    variables: ToolVariable[];
-}
 /**
  * @public
  */
@@ -676,10 +1149,10 @@ export interface CreateToolInput {
      */
     description: string;
     /**
-     * Input of the tool, used to pass data to the tool.
+     * Agent arguments. Omit when handler.connector is set; the service resolves input from the pinned connector tool definition.
      * @public
      */
-    input: ToolInput;
+    input?: ToolInput | undefined;
     /**
      * Handler of the tool, used to execute the tool.
      * @public
@@ -716,10 +1189,10 @@ export interface Tool {
      */
     description: string;
     /**
-     * Input of the tool, used to pass data to the tool
+     * Agent arguments. Required for built-in handlers. Omit when handler.connector is set; the service resolves input from the pinned connector tool definition.
      * @public
      */
-    input: ToolInput;
+    input?: ToolInput | undefined;
     /**
      * Handler of the tool, used to execute the tool
      * @public
@@ -732,6 +1205,26 @@ export interface Tool {
 export interface CreateToolOutput {
     tool: Tool;
 }
+/**
+ * @public
+ */
+export interface DeleteConnectorInput {
+    /**
+     * The unique identifier of the tenant when a service token is used.
+     * @public
+     */
+    companyId?: string | undefined;
+    /**
+     * Connector instance identifier.
+     * @public
+     */
+    connectorId: string;
+}
+/**
+ * @public
+ */
+export interface DeleteConnectorOutput {
+}
 /**
  * @public
  */
@@ -787,7 +1280,7 @@ export interface ToolDescription {
      */
     description: string;
     /**
-     * List of tool variables, used to pass data to the tool
+     * List of tool variables.
      * @public
      */
     variables: ToolVariable[];
@@ -852,6 +1345,47 @@ export interface DiscoverToolsOutput {
      */
     tools: DiscoveredTool[];
 }
+/**
+ * @public
+ */
+export interface ExecuteConnectorInput {
+    /**
+     * The unique identifier of the tenant when a service token is used.
+     * @public
+     */
+    companyId?: string | undefined;
+    /**
+     * Connector instance identifier.
+     * @public
+     */
+    connectorId: string;
+    /**
+     * Invocation payload from the model or agent. For multi-tool connectors this
+     * is typically an object with exactly one connector tool id key and argument object.
+     * @public
+     */
+    input: __DocumentType;
+    /**
+     * Service executing the connector, such as `chatbots` or `voicebots`.
+     * @public
+     */
+    service?: string | undefined;
+    /**
+     * User identity required by user-authorized connectors.
+     * @public
+     */
+    user?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface ExecuteConnectorOutput {
+    /**
+     * Structured tool result and execution metadata.
+     * @public
+     */
+    result: ConnectorExecutionResult;
+}
 /**
  * @public
  */
@@ -902,6 +1436,61 @@ export interface ExecuteToolOutput {
      */
     result: ToolExecutionResult;
 }
+/**
+ * @public
+ */
+export interface GetConnectorInput {
+    /**
+     * The unique identifier of the tenant when a service token is used.
+     * @public
+     */
+    companyId?: string | undefined;
+    /**
+     * Connector instance identifier.
+     * @public
+     */
+    connectorId: string;
+}
+/**
+ * @public
+ */
+export interface GetConnectorOutput {
+    /**
+     * Requested connector.
+     * @public
+     */
+    connector: Connector;
+}
+/**
+ * @public
+ */
+export interface GetConnectorDefinitionInput {
+    /**
+     * The unique identifier of the tenant when a service token is used.
+     * @public
+     */
+    companyId?: string | undefined;
+    /**
+     * Stable connector definition key.
+     * @public
+     */
+    key: string;
+    /**
+     * Exact immutable definition version.
+     * @public
+     */
+    version: string;
+}
+/**
+ * @public
+ */
+export interface GetConnectorDefinitionOutput {
+    /**
+     * Requested connector definition.
+     * @public
+     */
+    definition: ConnectorDefinition;
+}
 /**
  * @public
  */
@@ -927,6 +1516,81 @@ export interface GetToolOutput {
      */
     tool: Tool;
 }
+/**
+ * @public
+ */
+export interface ListConnectorDefinitionsInput {
+    /**
+     * The unique identifier of the tenant when a service token is used.
+     * @public
+     */
+    companyId?: string | undefined;
+    /**
+     * Case-insensitive filter applied to connector titles, keys, and descriptions.
+     * @public
+     */
+    query?: string | undefined;
+    /**
+     * Maximum number of definitions to return.
+     * @public
+     */
+    pageSize?: number | undefined;
+    /**
+     * Token returned by the previous request.
+     * @public
+     */
+    nextToken?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface ListConnectorDefinitionsOutput {
+    /**
+     * Connector definitions in the current page.
+     * @public
+     */
+    definitions: ConnectorDefinition[];
+    /**
+     * Token for the next page, omitted when no more results exist.
+     * @public
+     */
+    nextToken?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface ListConnectorsInput {
+    /**
+     * The unique identifier of the tenant when a service token is used.
+     * @public
+     */
+    companyId?: string | undefined;
+    /**
+     * Maximum number of connectors to return.
+     * @public
+     */
+    pageSize?: number | undefined;
+    /**
+     * Token returned by the previous request.
+     * @public
+     */
+    nextToken?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface ListConnectorsOutput {
+    /**
+     * Connectors in the current page.
+     * @public
+     */
+    connectors: Connector[];
+    /**
+     * Token for the next page, omitted when no more results exist.
+     * @public
+     */
+    nextToken?: string | undefined;
+}
 /**
  * @public
  */
@@ -947,6 +1611,108 @@ export interface ListToolsOutput {
      */
     tools: Tool[];
 }
+/**
+ * @public
+ */
+export interface ResolveConnectorConfigurationInput {
+    /**
+     * The unique identifier of the tenant when a service token is used.
+     * @public
+     */
+    companyId?: string | undefined;
+    /**
+     * Stable connector definition key.
+     * @public
+     */
+    key: string;
+    /**
+     * Exact immutable definition version.
+     * @public
+     */
+    version: string;
+    /**
+     * Current partial form values.
+     * @public
+     */
+    values: __DocumentType;
+    /**
+     * Credentials used to resolve account-dependent options.
+     * @public
+     */
+    authorization?: ConnectorAuthorization | undefined;
+    /**
+     * Executing user when user authorization is selected.
+     * @public
+     */
+    user?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface ResolveConnectorConfigurationOutput {
+    /**
+     * Configuration contract resolved for the current values and account.
+     * @public
+     */
+    configuration: ConnectorConfigurationDefinition;
+}
+/**
+ * Fields supplied when a connector is created or replaced.
+ * @public
+ */
+export interface UpdateConnectorInput {
+    /**
+     * Immutable definition used to validate configuration and execute tools.
+     * @public
+     */
+    definition: ConnectorDefinitionRef;
+    /**
+     * Values validated against the definition configuration schema.
+     * @public
+     */
+    configuration: __DocumentType;
+    /**
+     * Credential selection, omitted when no authorization is required. The same Nango
+     * connection reference may be reused across multiple Tools and Connectors.
+     * @public
+     */
+    authorization?: ConnectorAuthorization | undefined;
+    /**
+     * Name exposed to administrators and AI agents.
+     * @public
+     */
+    name: string;
+    /**
+     * Description exposed to administrators and AI agents.
+     * @public
+     */
+    description: string;
+    /**
+     * Explicit allowlist of tools available to callers and agents.
+     * @public
+     */
+    enabledTools: string[];
+    /**
+     * The unique identifier of the tenant when a service token is used.
+     * @public
+     */
+    companyId?: string | undefined;
+    /**
+     * Connector instance identifier.
+     * @public
+     */
+    connectorId: string;
+}
+/**
+ * @public
+ */
+export interface UpdateConnectorOutput {
+    /**
+     * Updated connector.
+     * @public
+     */
+    connector: Connector;
+}
 /**
  * @public
  */
@@ -977,10 +1743,10 @@ export interface UpdateToolInput {
      */
     description: string;
     /**
-     * Input of the tool, used to pass data to the tool.
+     * Agent arguments. Omit when handler.connector is set; the service resolves input from the pinned connector tool definition.
      * @public
      */
-    input: ToolInput;
+    input?: ToolInput | undefined;
     /**
      * Handler of the tool, used to execute the tool.
      * @public