@wildix/wilma-agents-client 1.0.1

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

@@ -0,0 +1,2186 @@
+import type { DocumentType as __DocumentType } from "@smithy/types";
+import type { ActorType, AgentFileScope, AgentGrantPermission, AgentStatus, AgentVariableType, AgentVisibility, AuditAction, AuditResourceType, ChannelType, GuardrailAction, GuardrailContentCategory, GuardrailFilterStrength, GuardrailPiiAction, GuardrailPiiEntityType, SandboxNetworkAccess, SpeechProvider, WebhookMethod, WebSearchContextSize } from "./enums";
+/**
+ * Who performed an action: an interactive user, an API key or an internal service.
+ * @public
+ */
+export interface Actor {
+    type: ActorType;
+    /**
+     * User id, API key id or service name, depending on the actor type.
+     * @public
+     */
+    id: string;
+    /**
+     * Human readable name of the actor at the time of the action.
+     * @public
+     */
+    name?: string | undefined;
+}
+/**
+ * @public
+ */
+export type AgentGrantPrincipal = AgentGrantPrincipal.GroupIdMember | AgentGrantPrincipal.UserIdMember | AgentGrantPrincipal.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace AgentGrantPrincipal {
+    interface UserIdMember {
+        userId: string;
+        groupId?: never;
+        $unknown?: never;
+    }
+    interface GroupIdMember {
+        userId?: never;
+        groupId: string;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        userId?: never;
+        groupId?: never;
+        $unknown: [string, any];
+    }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
+    interface Visitor<T> {
+        userId: (value: string) => T;
+        groupId: (value: string) => T;
+        _: (name: string, value: any) => T;
+    }
+}
+/**
+ * @public
+ */
+export interface AgentGrant {
+    permission: AgentGrantPermission;
+    principal: AgentGrantPrincipal;
+}
+/**
+ * @public
+ */
+export interface AgentAccess {
+    visibility?: AgentVisibility | undefined;
+    grants?: AgentGrant[] | undefined;
+}
+/**
+ * @public
+ */
+export interface AgentAliasRoute {
+    version: number;
+    /**
+     * Percentage of new sessions routed to this version. Weights of an alias must sum to 100.
+     * @public
+     */
+    weight: number;
+}
+/**
+ * @public
+ */
+export interface AgentAlias {
+    /**
+     * Alias name, e.g. 'production', 'staging'.
+     * @public
+     */
+    name: string;
+    agentId: string;
+    description?: string | undefined;
+    /**
+     * Weighted routing to published versions. A single route with weight 100 is the common case; two routes make a canary.
+     * @public
+     */
+    routing: AgentAliasRoute[];
+    /**
+     * ISO-8601 timestamp, e.g. '2026-07-03T10:15:30.000Z'.
+     * @public
+     */
+    updatedAt: string;
+    /**
+     * Who performed an action: an interactive user, an API key or an internal service.
+     * @public
+     */
+    updatedBy: Actor;
+}
+/**
+ * @public
+ */
+export interface ApiChannelSettings {
+    enabled: boolean;
+}
+/**
+ * @public
+ */
+export interface AssistantChannelSettings {
+    enabled: boolean;
+    /**
+     * Offer this agent as the default assistant for users covered by the agent access settings.
+     * @public
+     */
+    default?: boolean | undefined;
+}
+/**
+ * @public
+ */
+export interface ChatChannelSettings {
+    enabled: boolean;
+    /**
+     * Whether users can find and add this agent to conversations.
+     * @public
+     */
+    discoverable?: boolean | undefined;
+    /**
+     * PBX group used for data ACL (e.g. Sales Intelligence lookups).
+     * @public
+     */
+    pbxGroupId?: string | undefined;
+    /**
+     * Message posted when the agent joins a conversation.
+     * @public
+     */
+    welcomeMessage?: string | undefined;
+}
+/**
+ * Caller context injected into the model prompt.
+ * @public
+ */
+export interface VoiceCallerMetadataSettings {
+    /**
+     * Include the caller name. Defaults to true.
+     * @public
+     */
+    callerName?: boolean | undefined;
+    /**
+     * Include the caller phone number. Defaults to true.
+     * @public
+     */
+    callerNumber?: boolean | undefined;
+    /**
+     * Include the caller email when known. Defaults to false.
+     * @public
+     */
+    callerEmail?: boolean | undefined;
+    /**
+     * Include the caller company when known. Defaults to false.
+     * @public
+     */
+    callerCompany?: boolean | undefined;
+    /**
+     * Include the current time. Defaults to false.
+     * @public
+     */
+    time?: boolean | undefined;
+    /**
+     * IANA timezone used when time is enabled. Defaults to 'UTC'.
+     * @public
+     */
+    timeZone?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface VoiceEndCallSettings {
+    enabled: boolean;
+    /**
+     * Comma-separated phrases that end the call, e.g. 'goodbye,bye'.
+     * @public
+     */
+    phrases?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface VoiceInterruptionSettings {
+    /**
+     * Whether the caller can interrupt the agent while it is speaking.
+     * @public
+     */
+    enabled: boolean;
+    /**
+     * Minimum number of caller words that count as an interruption.
+     * @public
+     */
+    minWords?: number | undefined;
+}
+/**
+ * @public
+ */
+export interface VoiceTerminateHangupAction {
+    /**
+     * Message played before hanging up.
+     * @public
+     */
+    message?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface VoiceTransferTarget {
+    /**
+     * Human readable name the model can refer to, e.g. 'Billing department'.
+     * @public
+     */
+    name: string;
+    /**
+     * When this target should be chosen.
+     * @public
+     */
+    description?: string | undefined;
+    context: string;
+    extension: string;
+}
+/**
+ * @public
+ */
+export type VoiceTerminateAction = VoiceTerminateAction.HangupMember | VoiceTerminateAction.TransferMember | VoiceTerminateAction.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace VoiceTerminateAction {
+    interface HangupMember {
+        hangup: VoiceTerminateHangupAction;
+        transfer?: never;
+        $unknown?: never;
+    }
+    interface TransferMember {
+        hangup?: never;
+        transfer: VoiceTransferTarget;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        hangup?: never;
+        transfer?: never;
+        $unknown: [string, any];
+    }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
+    interface Visitor<T> {
+        hangup: (value: VoiceTerminateHangupAction) => T;
+        transfer: (value: VoiceTransferTarget) => T;
+        _: (name: string, value: any) => T;
+    }
+}
+/**
+ * @public
+ */
+export interface VoiceMaxDurationSettings {
+    /**
+     * Maximum call duration in seconds before the action is taken.
+     * @public
+     */
+    seconds: number;
+    action: VoiceTerminateAction;
+}
+/**
+ * @public
+ */
+export interface VoiceSilenceTimeoutSettings {
+    /**
+     * Seconds of caller silence before the action is taken.
+     * @public
+     */
+    seconds: number;
+    action: VoiceTerminateAction;
+}
+/**
+ * @public
+ */
+export interface VoiceSynthesisSettings {
+    provider: SpeechProvider;
+    /**
+     * Provider-specific voice identifier.
+     * @public
+     */
+    voiceId: string;
+    /**
+     * Playback speed multiplier.
+     * @public
+     */
+    speed?: number | undefined;
+}
+/**
+ * @public
+ */
+export interface VoiceChannelSettings {
+    enabled: boolean;
+    /**
+     * BCP-47 language tag used for transcription and synthesis, e.g. 'en-US'.
+     * @public
+     */
+    language: string;
+    synthesis: VoiceSynthesisSettings;
+    /**
+     * Message spoken when the call starts.
+     * @public
+     */
+    greeting?: string | undefined;
+    interruptions?: VoiceInterruptionSettings | undefined;
+    silenceTimeout?: VoiceSilenceTimeoutSettings | undefined;
+    maxDuration?: VoiceMaxDurationSettings | undefined;
+    endCall?: VoiceEndCallSettings | undefined;
+    /**
+     * Caller context injected into the model prompt.
+     * @public
+     */
+    callerMetadata?: VoiceCallerMetadataSettings | undefined;
+}
+/**
+ * @public
+ */
+export interface AgentChannels {
+    assistant?: AssistantChannelSettings | undefined;
+    chat?: ChatChannelSettings | undefined;
+    voice?: VoiceChannelSettings | undefined;
+    api?: ApiChannelSettings | undefined;
+}
+/**
+ * @public
+ */
+export interface AgentToolVariableAutoHandler {
+}
+/**
+ * @public
+ */
+export interface AgentToolVariableGuidedHandler {
+    description: string;
+}
+/**
+ * @public
+ */
+export interface AgentToolVariablePredefinedHandler {
+    description: string;
+}
+/**
+ * @public
+ */
+export type AgentToolVariableHandler = AgentToolVariableHandler.AutoMember | AgentToolVariableHandler.GuidedMember | AgentToolVariableHandler.PredefinedMember | AgentToolVariableHandler.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace AgentToolVariableHandler {
+    interface AutoMember {
+        auto: AgentToolVariableAutoHandler;
+        guided?: never;
+        predefined?: never;
+        $unknown?: never;
+    }
+    interface GuidedMember {
+        auto?: never;
+        guided: AgentToolVariableGuidedHandler;
+        predefined?: never;
+        $unknown?: never;
+    }
+    interface PredefinedMember {
+        auto?: never;
+        guided?: never;
+        predefined: AgentToolVariablePredefinedHandler;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        auto?: never;
+        guided?: never;
+        predefined?: never;
+        $unknown: [string, any];
+    }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
+    interface Visitor<T> {
+        auto: (value: AgentToolVariableAutoHandler) => T;
+        guided: (value: AgentToolVariableGuidedHandler) => T;
+        predefined: (value: AgentToolVariablePredefinedHandler) => T;
+        _: (name: string, value: any) => T;
+    }
+}
+/**
+ * @public
+ */
+export interface AgentToolVariable {
+    /**
+     * Name of the tool variable, e.g.: 'myvar'
+     * @public
+     */
+    name: string;
+    handler?: AgentToolVariableHandler | undefined;
+}
+/**
+ * Invoke another agent as a dedicated execution with its own state. The called agent runs independently and returns its result.
+ * @public
+ */
+export interface AgentCallCapability {
+    agentId: string;
+    variables?: AgentToolVariable[] | undefined;
+}
+/**
+ * Delegate the conversation to another agent (max 3 transitions per turn).
+ * @public
+ */
+export interface AgentDelegationCapability {
+    /**
+     * Agents this agent may delegate to. Empty list means any agent of the company.
+     * @public
+     */
+    agents?: string[] | undefined;
+    /**
+     * Extra instructions for when the agent should delegate.
+     * @public
+     */
+    instructions?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface WebhookAuthorizationBasic {
+    username: string;
+    password: string;
+}
+/**
+ * @public
+ */
+export interface WebhookAuthorizationBearer {
+    token: string;
+}
+/**
+ * @public
+ */
+export interface WebhookAuthorizationOAuth {
+    clientId: string;
+    clientSecret: string;
+    endpointUrl: string;
+    scope?: string | undefined;
+}
+/**
+ * @public
+ */
+export type WebhookAuthorization = WebhookAuthorization.BasicMember | WebhookAuthorization.BearerMember | WebhookAuthorization.OauthMember | WebhookAuthorization.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace WebhookAuthorization {
+    interface BearerMember {
+        bearer: WebhookAuthorizationBearer;
+        basic?: never;
+        oauth?: never;
+        $unknown?: never;
+    }
+    interface BasicMember {
+        bearer?: never;
+        basic: WebhookAuthorizationBasic;
+        oauth?: never;
+        $unknown?: never;
+    }
+    interface OauthMember {
+        bearer?: never;
+        basic?: never;
+        oauth: WebhookAuthorizationOAuth;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        bearer?: never;
+        basic?: never;
+        oauth?: never;
+        $unknown: [string, any];
+    }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
+    interface Visitor<T> {
+        bearer: (value: WebhookAuthorizationBearer) => T;
+        basic: (value: WebhookAuthorizationBasic) => T;
+        oauth: (value: WebhookAuthorizationOAuth) => T;
+        _: (name: string, value: any) => T;
+    }
+}
+/**
+ * @public
+ */
+export interface WebhookHeader {
+    name: string;
+    value: string;
+}
+/**
+ * @public
+ */
+export interface FunctionWebhookIntegration {
+    url: string;
+    method?: WebhookMethod | undefined;
+    /**
+     * Fire-and-forget: do not wait for the webhook response.
+     * @public
+     */
+    async?: boolean | undefined;
+    authorization?: WebhookAuthorization | undefined;
+    headers?: WebhookHeader[] | undefined;
+    /**
+     * Timeout in milliseconds for the webhook request.
+     * @public
+     */
+    timeout?: number | undefined;
+    /**
+     * Request payload template (JSON).
+     * @public
+     */
+    parameters?: __DocumentType | undefined;
+}
+/**
+ * @public
+ */
+export type FunctionIntegration = FunctionIntegration.WebhookMember | FunctionIntegration.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace FunctionIntegration {
+    interface WebhookMember {
+        webhook: FunctionWebhookIntegration;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        webhook?: never;
+        $unknown: [string, any];
+    }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
+    interface Visitor<T> {
+        webhook: (value: FunctionWebhookIntegration) => T;
+        _: (name: string, value: any) => T;
+    }
+}
+/**
+ * @public
+ */
+export interface AgentFunctionTool {
+    name: string;
+    /**
+     * Used by the model to decide when to invoke the function.
+     * @public
+     */
+    description?: string | undefined;
+    /**
+     * JSON Schema of the function parameters.
+     * @public
+     */
+    parameters?: __DocumentType | undefined;
+    integration?: FunctionIntegration | undefined;
+}
+/**
+ * Hand the conversation over to a human and leave it. Honoured on conversation channels (chat, assistant).
+ * @public
+ */
+export interface AgentHandoverCapability {
+    /**
+     * Extra instructions for when the agent should hand over.
+     * @public
+     */
+    instructions?: string | undefined;
+    /**
+     * Message sent to the end user when the handover happens.
+     * @public
+     */
+    message?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface AgentKnowledgeBase {
+    knowledgeBaseId?: string | undefined;
+    /**
+     * Additional instructions for when the agent should use this knowledge base.
+     * @public
+     */
+    instructions?: string | undefined;
+}
+/**
+ * Remote MCP (Model Context Protocol) server whose tools are exposed to the agent.
+ * @public
+ */
+export interface AgentMcpServerCapability {
+    url: string;
+    authorization?: WebhookAuthorization | undefined;
+    /**
+     * Restrict the tools exposed from this server. Empty list means all tools.
+     * @public
+     */
+    allowedTools?: string[] | undefined;
+}
+/**
+ * Sandbox launched from a pre-built snapshot managed by the wilma-sandbox service.
+ * @public
+ */
+export interface AgentSnapshotSandboxOptions {
+    /**
+     * Snapshot to launch sandboxes from. Managed in the wilma-sandbox service; must be READY.
+     * @public
+     */
+    snapshotId: string;
+    /**
+     * Override the snapshot's network policy for this agent. Defaults to the snapshot's policy.
+     * @public
+     */
+    network?: SandboxNetworkAccess | undefined;
+    /**
+     * Domains allowed when network = ALLOWLIST.
+     * @public
+     */
+    allowedDomains?: string[] | undefined;
+    /**
+     * Override the number of vCPUs allocated. Defaults to the snapshot's resources.
+     * @public
+     */
+    vcpus?: number | undefined;
+}
+/**
+ * Vercel Sandbox configuration.
+ * @public
+ */
+export interface AgentVercelSandboxOptions {
+    /**
+     * Number of vCPUs to allocate (2048 MB memory each).
+     * @public
+     */
+    vcpus?: number | undefined;
+    /**
+     * Network access. Defaults to deny-all.
+     * @public
+     */
+    network?: SandboxNetworkAccess | undefined;
+    /**
+     * Domains allowed when network = ALLOWLIST.
+     * @public
+     */
+    allowedDomains?: string[] | undefined;
+}
+/**
+ * Embedded sandbox: shell + file tools backed by an execution environment.
+ * @public
+ */
+export type AgentSandboxCapability = AgentSandboxCapability.SnapshotMember | AgentSandboxCapability.VercelMember | AgentSandboxCapability.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace AgentSandboxCapability {
+    /**
+     * Ad-hoc Vercel Sandbox configured inline on the agent.
+     * @public
+     */
+    interface VercelMember {
+        vercel: AgentVercelSandboxOptions;
+        snapshot?: never;
+        $unknown?: never;
+    }
+    /**
+     * Sandbox launched from a reusable snapshot built via the wilma-sandbox service.
+     * @public
+     */
+    interface SnapshotMember {
+        vercel?: never;
+        snapshot: AgentSnapshotSandboxOptions;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        vercel?: never;
+        snapshot?: never;
+        $unknown: [string, any];
+    }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
+    interface Visitor<T> {
+        vercel: (value: AgentVercelSandboxOptions) => T;
+        snapshot: (value: AgentSnapshotSandboxOptions) => T;
+        _: (name: string, value: any) => T;
+    }
+}
+/**
+ * Emit suggested replies for human operators instead of, or in addition to, answering directly. Honoured on the chat channel.
+ * @public
+ */
+export interface AgentSuggestionsCapability {
+}
+/**
+ * @public
+ */
+export interface AgentTool {
+    /**
+     * Unique identifier of the tool using nanoid format
+     * @public
+     */
+    id: string;
+    variables?: AgentToolVariable[] | undefined;
+}
+/**
+ * Transfer the interaction to a PBX destination. Honoured on the voice channel.
+ * @public
+ */
+export interface AgentTransferCapability {
+    targets: VoiceTransferTarget[];
+    /**
+     * Extra instructions for when the agent should transfer.
+     * @public
+     */
+    instructions?: string | undefined;
+}
+/**
+ * Server-side fetch of a URL, returning its readable text/markdown to the model.
+ * @public
+ */
+export interface AgentWebFetchCapability {
+    /**
+     * Restrict fetches to these domains. Empty list means any domain is allowed.
+     * @public
+     */
+    allowedDomains?: string[] | undefined;
+}
+/**
+ * @public
+ */
+export interface WebSearchUserLocation {
+    /**
+     * ISO 3166-1 alpha-2 country code, e.g. 'US'.
+     * @public
+     */
+    country?: string | undefined;
+    region?: string | undefined;
+    city?: string | undefined;
+    /**
+     * IANA timezone, e.g. 'Europe/Rome'.
+     * @public
+     */
+    timezone?: string | undefined;
+}
+/**
+ * Model-native web search. The provider tool is selected from the agent model.
+ * @public
+ */
+export interface AgentWebSearchCapability {
+    /**
+     * Context size hint. Defaults to medium.
+     * @public
+     */
+    contextSize?: WebSearchContextSize | undefined;
+    /**
+     * Restrict results to these domains where the provider supports it.
+     * @public
+     */
+    allowedDomains?: string[] | undefined;
+    userLocation?: WebSearchUserLocation | undefined;
+}
+/**
+ * @public
+ */
+export type AgentCapability = AgentCapability.AgentMember | AgentCapability.DelegationMember | AgentCapability.FunctionMember | AgentCapability.HandoverMember | AgentCapability.KbMember | AgentCapability.McpMember | AgentCapability.SandboxMember | AgentCapability.SuggestionsMember | AgentCapability.ToolMember | AgentCapability.TransferMember | AgentCapability.WebFetchMember | AgentCapability.WebSearchMember | AgentCapability.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace AgentCapability {
+    interface ToolMember {
+        tool: AgentTool;
+        function?: never;
+        kb?: never;
+        sandbox?: never;
+        webSearch?: never;
+        webFetch?: never;
+        agent?: never;
+        mcp?: never;
+        handover?: never;
+        delegation?: never;
+        transfer?: never;
+        suggestions?: never;
+        $unknown?: never;
+    }
+    interface FunctionMember {
+        tool?: never;
+        function: AgentFunctionTool;
+        kb?: never;
+        sandbox?: never;
+        webSearch?: never;
+        webFetch?: never;
+        agent?: never;
+        mcp?: never;
+        handover?: never;
+        delegation?: never;
+        transfer?: never;
+        suggestions?: never;
+        $unknown?: never;
+    }
+    interface KbMember {
+        tool?: never;
+        function?: never;
+        kb: AgentKnowledgeBase;
+        sandbox?: never;
+        webSearch?: never;
+        webFetch?: never;
+        agent?: never;
+        mcp?: never;
+        handover?: never;
+        delegation?: never;
+        transfer?: never;
+        suggestions?: never;
+        $unknown?: never;
+    }
+    /**
+     * Embedded sandbox: shell + file tools backed by an execution environment.
+     * @public
+     */
+    interface SandboxMember {
+        tool?: never;
+        function?: never;
+        kb?: never;
+        sandbox: AgentSandboxCapability;
+        webSearch?: never;
+        webFetch?: never;
+        agent?: never;
+        mcp?: never;
+        handover?: never;
+        delegation?: never;
+        transfer?: never;
+        suggestions?: never;
+        $unknown?: never;
+    }
+    /**
+     * Model-native web search. The provider tool is selected from the agent model.
+     * @public
+     */
+    interface WebSearchMember {
+        tool?: never;
+        function?: never;
+        kb?: never;
+        sandbox?: never;
+        webSearch: AgentWebSearchCapability;
+        webFetch?: never;
+        agent?: never;
+        mcp?: never;
+        handover?: never;
+        delegation?: never;
+        transfer?: never;
+        suggestions?: never;
+        $unknown?: never;
+    }
+    /**
+     * Server-side fetch of a URL, returning its readable text/markdown to the model.
+     * @public
+     */
+    interface WebFetchMember {
+        tool?: never;
+        function?: never;
+        kb?: never;
+        sandbox?: never;
+        webSearch?: never;
+        webFetch: AgentWebFetchCapability;
+        agent?: never;
+        mcp?: never;
+        handover?: never;
+        delegation?: never;
+        transfer?: never;
+        suggestions?: never;
+        $unknown?: never;
+    }
+    /**
+     * Invoke another agent as a dedicated execution with its own state. The called agent runs independently and returns its result.
+     * @public
+     */
+    interface AgentMember {
+        tool?: never;
+        function?: never;
+        kb?: never;
+        sandbox?: never;
+        webSearch?: never;
+        webFetch?: never;
+        agent: AgentCallCapability;
+        mcp?: never;
+        handover?: never;
+        delegation?: never;
+        transfer?: never;
+        suggestions?: never;
+        $unknown?: never;
+    }
+    /**
+     * Remote MCP (Model Context Protocol) server whose tools are exposed to the agent.
+     * @public
+     */
+    interface McpMember {
+        tool?: never;
+        function?: never;
+        kb?: never;
+        sandbox?: never;
+        webSearch?: never;
+        webFetch?: never;
+        agent?: never;
+        mcp: AgentMcpServerCapability;
+        handover?: never;
+        delegation?: never;
+        transfer?: never;
+        suggestions?: never;
+        $unknown?: never;
+    }
+    /**
+     * Hand the conversation over to a human and leave it. Honoured on conversation channels (chat, assistant).
+     * @public
+     */
+    interface HandoverMember {
+        tool?: never;
+        function?: never;
+        kb?: never;
+        sandbox?: never;
+        webSearch?: never;
+        webFetch?: never;
+        agent?: never;
+        mcp?: never;
+        handover: AgentHandoverCapability;
+        delegation?: never;
+        transfer?: never;
+        suggestions?: never;
+        $unknown?: never;
+    }
+    /**
+     * Delegate the conversation to another agent (max 3 transitions per turn).
+     * @public
+     */
+    interface DelegationMember {
+        tool?: never;
+        function?: never;
+        kb?: never;
+        sandbox?: never;
+        webSearch?: never;
+        webFetch?: never;
+        agent?: never;
+        mcp?: never;
+        handover?: never;
+        delegation: AgentDelegationCapability;
+        transfer?: never;
+        suggestions?: never;
+        $unknown?: never;
+    }
+    /**
+     * Transfer the interaction to a PBX destination. Honoured on the voice channel.
+     * @public
+     */
+    interface TransferMember {
+        tool?: never;
+        function?: never;
+        kb?: never;
+        sandbox?: never;
+        webSearch?: never;
+        webFetch?: never;
+        agent?: never;
+        mcp?: never;
+        handover?: never;
+        delegation?: never;
+        transfer: AgentTransferCapability;
+        suggestions?: never;
+        $unknown?: never;
+    }
+    /**
+     * Emit suggested replies for human operators instead of, or in addition to, answering directly. Honoured on the chat channel.
+     * @public
+     */
+    interface SuggestionsMember {
+        tool?: never;
+        function?: never;
+        kb?: never;
+        sandbox?: never;
+        webSearch?: never;
+        webFetch?: never;
+        agent?: never;
+        mcp?: never;
+        handover?: never;
+        delegation?: never;
+        transfer?: never;
+        suggestions: AgentSuggestionsCapability;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        tool?: never;
+        function?: never;
+        kb?: never;
+        sandbox?: never;
+        webSearch?: never;
+        webFetch?: never;
+        agent?: never;
+        mcp?: never;
+        handover?: never;
+        delegation?: never;
+        transfer?: never;
+        suggestions?: never;
+        $unknown: [string, any];
+    }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
+    interface Visitor<T> {
+        tool: (value: AgentTool) => T;
+        function: (value: AgentFunctionTool) => T;
+        kb: (value: AgentKnowledgeBase) => T;
+        sandbox: (value: AgentSandboxCapability) => T;
+        webSearch: (value: AgentWebSearchCapability) => T;
+        webFetch: (value: AgentWebFetchCapability) => T;
+        agent: (value: AgentCallCapability) => T;
+        mcp: (value: AgentMcpServerCapability) => T;
+        handover: (value: AgentHandoverCapability) => T;
+        delegation: (value: AgentDelegationCapability) => T;
+        transfer: (value: AgentTransferCapability) => T;
+        suggestions: (value: AgentSuggestionsCapability) => T;
+        _: (name: string, value: any) => T;
+    }
+}
+/**
+ * @public
+ */
+export interface AgentVariable {
+    name: string;
+    type: AgentVariableType;
+    optional: boolean;
+    /**
+     * What the variable means and how it should be filled.
+     * @public
+     */
+    description?: string | undefined;
+}
+/**
+ * Managed LLM engine: the platform runs the model, tools and knowledge lookups.
+ * @public
+ */
+export interface AgentLlmEngine {
+    instructions: string;
+    /**
+     * Defaults to the platform default model when omitted.
+     * @public
+     */
+    model?: string | undefined;
+    /**
+     * Skills attached to this agent (progressive disclosure).
+     * @public
+     */
+    skills?: string[] | undefined;
+    capabilities?: AgentCapability[] | undefined;
+    variables?: AgentVariable[] | undefined;
+}
+/**
+ * Bring-your-own backend over SQS: turns are forwarded to the queue, replies are posted back via the API.
+ * @public
+ */
+export interface AgentSqsEngine {
+    url: string;
+    key: string;
+    secret: string;
+}
+/**
+ * Bring-your-own backend over HTTPS: each turn is POSTed to the URL, the response is the reply.
+ * @public
+ */
+export interface AgentWebhookEngine {
+    url: string;
+    /**
+     * Shared secret used to sign requests (HMAC).
+     * @public
+     */
+    secret: string;
+    timeout?: number | undefined;
+}
+/**
+ * @public
+ */
+export type AgentEngine = AgentEngine.LlmMember | AgentEngine.SqsMember | AgentEngine.WebhookMember | AgentEngine.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace AgentEngine {
+    /**
+     * Managed LLM engine: the platform runs the model, tools and knowledge lookups.
+     * @public
+     */
+    interface LlmMember {
+        llm: AgentLlmEngine;
+        webhook?: never;
+        sqs?: never;
+        $unknown?: never;
+    }
+    /**
+     * Bring-your-own backend over HTTPS: each turn is POSTed to the URL, the response is the reply.
+     * @public
+     */
+    interface WebhookMember {
+        llm?: never;
+        webhook: AgentWebhookEngine;
+        sqs?: never;
+        $unknown?: never;
+    }
+    /**
+     * Bring-your-own backend over SQS: turns are forwarded to the queue, replies are posted back via the API.
+     * @public
+     */
+    interface SqsMember {
+        llm?: never;
+        webhook?: never;
+        sqs: AgentSqsEngine;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        llm?: never;
+        webhook?: never;
+        sqs?: never;
+        $unknown: [string, any];
+    }
+    /**
+     * @deprecated unused in schema-serde mode.
+     *
+     */
+    interface Visitor<T> {
+        llm: (value: AgentLlmEngine) => T;
+        webhook: (value: AgentWebhookEngine) => T;
+        sqs: (value: AgentSqsEngine) => T;
+        _: (name: string, value: any) => T;
+    }
+}
+/**
+ * The complete, versionable configuration of an agent. This is what gets snapshotted when a version is published.
+ * @public
+ */
+export interface Agent {
+    name: string;
+    description?: string | undefined;
+    /**
+     * Category of the agent, e.g.: 'Support'.
+     * @public
+     */
+    category?: string | undefined;
+    /**
+     * Avatar URL.
+     * @public
+     */
+    picture?: string | undefined;
+    engine: AgentEngine;
+    /**
+     * Per-channel deployment settings. An agent is reachable only on channels configured here.
+     * @public
+     */
+    channels?: AgentChannels | undefined;
+    /**
+     * Guardrail policies applied to this agent's inputs and outputs.
+     * @public
+     */
+    guardrails?: string[] | undefined;
+    access?: AgentAccess | undefined;
+    /**
+     * ISO-8601 timestamp, e.g. '2026-07-03T10:15:30.000Z'.
+     * @public
+     */
+    createdAt: string;
+    /**
+     * Who performed an action: an interactive user, an API key or an internal service.
+     * @public
+     */
+    createdBy: Actor;
+    /**
+     * ISO-8601 timestamp, e.g. '2026-07-03T10:15:30.000Z'.
+     * @public
+     */
+    updatedAt?: string | undefined;
+    /**
+     * Who performed an action: an interactive user, an API key or an internal service.
+     * @public
+     */
+    updatedBy?: Actor | undefined;
+    id: string;
+    status: AgentStatus;
+    /**
+     * Monotonic revision of the draft, incremented on every update. Pass it back on update for optimistic locking.
+     * @public
+     */
+    revision: number;
+    /**
+     * Latest published version number; absent while the agent is still a draft.
+     * @public
+     */
+    latestVersion?: number | undefined;
+    /**
+     * Aliases of this agent with their version routing (e.g. 'production', 'staging').
+     * @public
+     */
+    aliases?: AgentAlias[] | undefined;
+}
+/**
+ * @public
+ */
+export interface AgentApiKey {
+    id: string;
+    name?: string | undefined;
+    /**
+     * Non-secret prefix of the key, e.g. 'sk-a1b2', for display purposes.
+     * @public
+     */
+    prefix: string;
+    /**
+     * ISO-8601 timestamp, e.g. '2026-07-03T10:15:30.000Z'.
+     * @public
+     */
+    createdAt: string;
+    /**
+     * Who performed an action: an interactive user, an API key or an internal service.
+     * @public
+     */
+    createdBy: Actor;
+    /**
+     * ISO-8601 timestamp, e.g. '2026-07-03T10:15:30.000Z'.
+     * @public
+     */
+    expiresAt?: string | undefined;
+    /**
+     * ISO-8601 timestamp, e.g. '2026-07-03T10:15:30.000Z'.
+     * @public
+     */
+    lastUsedAt?: string | undefined;
+}
+/**
+ * The complete, versionable configuration of an agent. This is what gets snapshotted when a version is published.
+ * @public
+ */
+export interface AgentDefinitionSnapshot {
+    name: string;
+    description?: string | undefined;
+    /**
+     * Category of the agent, e.g.: 'Support'.
+     * @public
+     */
+    category?: string | undefined;
+    /**
+     * Avatar URL.
+     * @public
+     */
+    picture?: string | undefined;
+    engine: AgentEngine;
+    /**
+     * Per-channel deployment settings. An agent is reachable only on channels configured here.
+     * @public
+     */
+    channels?: AgentChannels | undefined;
+    /**
+     * Guardrail policies applied to this agent's inputs and outputs.
+     * @public
+     */
+    guardrails?: string[] | undefined;
+    access?: AgentAccess | undefined;
+}
+/**
+ * @public
+ */
+export interface AgentExecutionError {
+    message: string;
+    /**
+     * Machine-readable error code, e.g. 'guardrail_blocked', 'engine_error'.
+     * @public
+     */
+    code?: string | undefined;
+}
+/**
+ * A file produced (or shared) by an agent during a session or execution. Content lives in object storage; download via the Files API.
+ * @public
+ */
+export interface AgentFile {
+    /**
+     * Nano-id file identifier (12 characters).
+     * @public
+     */
+    id: string;
+    name: string;
+    /**
+     * MIME type, e.g. 'text/csv'.
+     * @public
+     */
+    contentType?: string | undefined;
+    /**
+     * Size in bytes.
+     * @public
+     */
+    size?: number | undefined;
+    /**
+     * Intended audience. Defaults to USER.
+     * @public
+     */
+    scope?: AgentFileScope | undefined;
+    /**
+     * Agent that created the file.
+     * @public
+     */
+    agentId?: string | undefined;
+    /**
+     * Session that created the file.
+     * @public
+     */
+    sessionId?: string | undefined;
+    /**
+     * ISO-8601 timestamp, e.g. '2026-07-03T10:15:30.000Z'.
+     * @public
+     */
+    createdAt: string;
+}
+/**
+ * @public
+ */
+export interface AgentExecutionResult {
+    /**
+     * Output of the execution.
+     * @public
+     */
+    output?: __DocumentType | undefined;
+    error?: AgentExecutionError | undefined;
+    /**
+     * Files created by the agent during execution (downloadable via the Files API).
+     * @public
+     */
+    files?: AgentFile[] | undefined;
+    /**
+     * Trace produced by this execution, inspectable via the wilma-traces API.
+     * @public
+     */
+    traceId?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface AgentInfo {
+    id: string;
+    name: string;
+    category?: string | undefined;
+    status: AgentStatus;
+    /**
+     * Channels this agent is deployed to.
+     * @public
+     */
+    channels?: ChannelType[] | undefined;
+    latestVersion?: number | undefined;
+}
+/**
+ * @public
+ */
+export interface AgentVersion {
+    agentId: string;
+    /**
+     * Monotonic version number, starting at 1.
+     * @public
+     */
+    version: number;
+    /**
+     * What changed in this version, provided at publish time.
+     * @public
+     */
+    changelog?: string | undefined;
+    /**
+     * Immutable snapshot of the agent definition at publish time.
+     * @public
+     */
+    definition: AgentDefinitionSnapshot;
+    /**
+     * ISO-8601 timestamp, e.g. '2026-07-03T10:15:30.000Z'.
+     * @public
+     */
+    publishedAt: string;
+    /**
+     * Who performed an action: an interactive user, an API key or an internal service.
+     * @public
+     */
+    publishedBy: Actor;
+}
+/**
+ * @public
+ */
+export interface AgentVersionChange {
+    /**
+     * JSON pointer of the changed field within the agent definition, e.g. '/engine/llm/instructions'.
+     * @public
+     */
+    path: string;
+    /**
+     * Value before the change (absent when the field was added).
+     * @public
+     */
+    before?: __DocumentType | undefined;
+    /**
+     * Value after the change (absent when the field was removed).
+     * @public
+     */
+    after?: __DocumentType | undefined;
+}
+/**
+ * Version list entry without the full definition snapshot.
+ * @public
+ */
+export interface AgentVersionInfo {
+    agentId: string;
+    version: number;
+    changelog?: string | undefined;
+    /**
+     * ISO-8601 timestamp, e.g. '2026-07-03T10:15:30.000Z'.
+     * @public
+     */
+    publishedAt: string;
+    /**
+     * Who performed an action: an interactive user, an API key or an internal service.
+     * @public
+     */
+    publishedBy: Actor;
+    /**
+     * Names of the aliases currently routing to this version.
+     * @public
+     */
+    aliases?: string[] | undefined;
+}
+/**
+ * @public
+ */
+export interface AuditRecord {
+    id: string;
+    /**
+     * ISO-8601 timestamp, e.g. '2026-07-03T10:15:30.000Z'.
+     * @public
+     */
+    timestamp: string;
+    /**
+     * Who performed an action: an interactive user, an API key or an internal service.
+     * @public
+     */
+    actor: Actor;
+    action: AuditAction;
+    resourceType: AuditResourceType;
+    resourceId: string;
+    /**
+     * The agent this record relates to, when the resource belongs to an agent.
+     * @public
+     */
+    agentId?: string | undefined;
+    /**
+     * Field-level before/after values for update actions.
+     * @public
+     */
+    changes?: AgentVersionChange[] | undefined;
+    /**
+     * Correlation id of the API request that caused the change.
+     * @public
+     */
+    requestId?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface CompareAgentVersionsInput {
+    company?: string | undefined;
+    agentId: string;
+    /**
+     * Base version. 0 means the current draft.
+     * @public
+     */
+    from: number;
+    /**
+     * Target version. 0 means the current draft.
+     * @public
+     */
+    to: number;
+}
+/**
+ * @public
+ */
+export interface CompareAgentVersionsOutput {
+    changes: AgentVersionChange[];
+}
+/**
+ * The complete, versionable configuration of an agent. This is what gets snapshotted when a version is published.
+ * @public
+ */
+export interface CreateAgentInput {
+    name: string;
+    description?: string | undefined;
+    /**
+     * Category of the agent, e.g.: 'Support'.
+     * @public
+     */
+    category?: string | undefined;
+    /**
+     * Avatar URL.
+     * @public
+     */
+    picture?: string | undefined;
+    engine: AgentEngine;
+    /**
+     * Per-channel deployment settings. An agent is reachable only on channels configured here.
+     * @public
+     */
+    channels?: AgentChannels | undefined;
+    /**
+     * Guardrail policies applied to this agent's inputs and outputs.
+     * @public
+     */
+    guardrails?: string[] | undefined;
+    access?: AgentAccess | undefined;
+    company?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface CreateAgentOutput {
+    /**
+     * The complete, versionable configuration of an agent. This is what gets snapshotted when a version is published.
+     * @public
+     */
+    agent: Agent;
+}
+/**
+ * @public
+ */
+export interface CreateAgentApiKeyInput {
+    company?: string | undefined;
+    agentId: string;
+    name?: string | undefined;
+    /**
+     * Optional expiry; the key stops working after this time.
+     * @public
+     */
+    expiresAt?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface CreateAgentApiKeyOutput {
+    key: AgentApiKey;
+    /**
+     * The full secret. Shown only once.
+     * @public
+     */
+    secret: string;
+}
+/**
+ * @public
+ */
+export interface GuardrailContentFilter {
+    category: GuardrailContentCategory;
+    /**
+     * Strength applied to user input. Defaults to NONE.
+     * @public
+     */
+    inputStrength?: GuardrailFilterStrength | undefined;
+    /**
+     * Strength applied to agent output. Defaults to NONE.
+     * @public
+     */
+    outputStrength?: GuardrailFilterStrength | undefined;
+}
+/**
+ * @public
+ */
+export interface GuardrailContentPolicy {
+    filters: GuardrailContentFilter[];
+}
+/**
+ * @public
+ */
+export interface GuardrailPiiEntity {
+    entityType: GuardrailPiiEntityType;
+    /**
+     * Regex for CUSTOM entities.
+     * @public
+     */
+    pattern?: string | undefined;
+    action: GuardrailPiiAction;
+}
+/**
+ * @public
+ */
+export interface GuardrailPiiPolicy {
+    entities: GuardrailPiiEntity[];
+}
+/**
+ * @public
+ */
+export interface GuardrailTopic {
+    /**
+     * Short topic name, e.g. 'investment-advice'.
+     * @public
+     */
+    name: string;
+    /**
+     * Natural-language definition of the topic used by the classifier.
+     * @public
+     */
+    definition: string;
+    /**
+     * Example phrases that belong to the topic, to sharpen classification.
+     * @public
+     */
+    examples?: string[] | undefined;
+    /**
+     * What to do when a policy matches.
+     * @public
+     */
+    action: GuardrailAction;
+}
+/**
+ * @public
+ */
+export interface GuardrailTopicPolicy {
+    topics: GuardrailTopic[];
+}
+/**
+ * @public
+ */
+export interface GuardrailWordPolicy {
+    /**
+     * Exact words or phrases to block.
+     * @public
+     */
+    blockedWords?: string[] | undefined;
+    /**
+     * Also block common profanity.
+     * @public
+     */
+    profanity?: boolean | undefined;
+}
+/**
+ * Editable guardrail configuration.
+ * @public
+ */
+export interface CreateGuardrailInput {
+    name: string;
+    description?: string | undefined;
+    topicPolicy?: GuardrailTopicPolicy | undefined;
+    contentPolicy?: GuardrailContentPolicy | undefined;
+    wordPolicy?: GuardrailWordPolicy | undefined;
+    piiPolicy?: GuardrailPiiPolicy | undefined;
+    /**
+     * Answer returned to the end user when input is blocked.
+     * @public
+     */
+    blockedInputMessage?: string | undefined;
+    /**
+     * Answer returned to the end user when the agent output is blocked.
+     * @public
+     */
+    blockedOutputMessage?: string | undefined;
+    company?: string | undefined;
+}
+/**
+ * Editable guardrail configuration.
+ * @public
+ */
+export interface Guardrail {
+    name: string;
+    description?: string | undefined;
+    topicPolicy?: GuardrailTopicPolicy | undefined;
+    contentPolicy?: GuardrailContentPolicy | undefined;
+    wordPolicy?: GuardrailWordPolicy | undefined;
+    piiPolicy?: GuardrailPiiPolicy | undefined;
+    /**
+     * Answer returned to the end user when input is blocked.
+     * @public
+     */
+    blockedInputMessage?: string | undefined;
+    /**
+     * Answer returned to the end user when the agent output is blocked.
+     * @public
+     */
+    blockedOutputMessage?: string | undefined;
+    /**
+     * ISO-8601 timestamp, e.g. '2026-07-03T10:15:30.000Z'.
+     * @public
+     */
+    createdAt: string;
+    /**
+     * Who performed an action: an interactive user, an API key or an internal service.
+     * @public
+     */
+    createdBy: Actor;
+    /**
+     * ISO-8601 timestamp, e.g. '2026-07-03T10:15:30.000Z'.
+     * @public
+     */
+    updatedAt?: string | undefined;
+    /**
+     * Who performed an action: an interactive user, an API key or an internal service.
+     * @public
+     */
+    updatedBy?: Actor | undefined;
+    id: string;
+}
+/**
+ * @public
+ */
+export interface CreateGuardrailOutput {
+    /**
+     * Editable guardrail configuration.
+     * @public
+     */
+    guardrail: Guardrail;
+}
+/**
+ * @public
+ */
+export interface DeleteAgentInput {
+    company?: string | undefined;
+    agentId: string;
+}
+/**
+ * @public
+ */
+export interface DeleteAgentOutput {
+}
+/**
+ * @public
+ */
+export interface DeleteAgentAliasInput {
+    company?: string | undefined;
+    agentId: string;
+    /**
+     * Alias name, e.g. 'production', 'staging'.
+     * @public
+     */
+    aliasName: string;
+}
+/**
+ * @public
+ */
+export interface DeleteAgentAliasOutput {
+}
+/**
+ * @public
+ */
+export interface DeleteAgentApiKeyInput {
+    company?: string | undefined;
+    agentId: string;
+    keyId: string;
+}
+/**
+ * @public
+ */
+export interface DeleteAgentApiKeyOutput {
+}
+/**
+ * @public
+ */
+export interface DeleteGuardrailInput {
+    company?: string | undefined;
+    guardrailId: string;
+}
+/**
+ * @public
+ */
+export interface DeleteGuardrailOutput {
+}
+/**
+ * @public
+ */
+export interface ExecuteAgentInput {
+    company?: string | undefined;
+    agentId: string;
+    /**
+     * Message or task for the agent.
+     * @public
+     */
+    input: string;
+    /**
+     * Values for the variables declared by the agent.
+     * @public
+     */
+    variables?: __DocumentType | undefined;
+    /**
+     * Alias to resolve. Defaults to 'production'. Mutually exclusive with version.
+     * @public
+     */
+    alias?: string | undefined;
+    /**
+     * Version to execute. 0 executes the current draft (for testing). Mutually exclusive with alias.
+     * @public
+     */
+    version?: number | undefined;
+    /**
+     * User on whose behalf the agent is executed, e.g. john.doe@example.com.
+     * @public
+     */
+    user?: string | undefined;
+    /**
+     * Parent agent id that invoked this execution (agent-to-agent calls).
+     * @public
+     */
+    parentAgentId?: string | undefined;
+    /**
+     * Parent trace id, to correlate nested executions.
+     * @public
+     */
+    parentTraceId?: string | undefined;
+    /**
+     * Files (by id) created by another agent to make available to this execution.
+     * @public
+     */
+    files?: string[] | undefined;
+}
+/**
+ * @public
+ */
+export interface ExecuteAgentOutput {
+    result: AgentExecutionResult;
+}
+/**
+ * @public
+ */
+export interface GetAgentInput {
+    company?: string | undefined;
+    agentId: string;
+}
+/**
+ * @public
+ */
+export interface GetAgentOutput {
+    /**
+     * The complete, versionable configuration of an agent. This is what gets snapshotted when a version is published.
+     * @public
+     */
+    agent: Agent;
+}
+/**
+ * @public
+ */
+export interface GetAgentVersionInput {
+    company?: string | undefined;
+    agentId: string;
+    version: number;
+}
+/**
+ * @public
+ */
+export interface GetAgentVersionOutput {
+    version: AgentVersion;
+}
+/**
+ * @public
+ */
+export interface GetGuardrailInput {
+    company?: string | undefined;
+    guardrailId: string;
+}
+/**
+ * @public
+ */
+export interface GetGuardrailOutput {
+    /**
+     * Editable guardrail configuration.
+     * @public
+     */
+    guardrail: Guardrail;
+}
+/**
+ * @public
+ */
+export interface ListAgentAliasesInput {
+    company?: string | undefined;
+    agentId: string;
+}
+/**
+ * @public
+ */
+export interface ListAgentAliasesOutput {
+    aliases: AgentAlias[];
+}
+/**
+ * @public
+ */
+export interface ListAgentApiKeysInput {
+    company?: string | undefined;
+    agentId: string;
+}
+/**
+ * @public
+ */
+export interface ListAgentApiKeysOutput {
+    keys: AgentApiKey[];
+}
+/**
+ * @public
+ */
+export interface ListAgentsInput {
+    company?: string | undefined;
+    /**
+     * Only agents deployed to this channel.
+     * @public
+     */
+    channel?: ChannelType | undefined;
+    status?: AgentStatus | undefined;
+    /**
+     * Filter by name or category.
+     * @public
+     */
+    search?: string | undefined;
+    limit?: number | undefined;
+    /**
+     * Opaque cursor returned by a previous page; pass it back to fetch the next page.
+     * @public
+     */
+    nextToken?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface ListAgentsOutput {
+    agents: Agent[];
+    /**
+     * Opaque cursor returned by a previous page; pass it back to fetch the next page.
+     * @public
+     */
+    nextToken?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface ListAgentsNamesInput {
+    company?: string | undefined;
+    /**
+     * Delivery channel an agent can be deployed to.
+     * @public
+     */
+    channel?: ChannelType | undefined;
+}
+/**
+ * @public
+ */
+export interface ListAgentsNamesOutput {
+    agents: AgentInfo[];
+}
+/**
+ * @public
+ */
+export interface ListAgentVersionsInput {
+    company?: string | undefined;
+    agentId: string;
+    limit?: number | undefined;
+    /**
+     * Opaque cursor returned by a previous page; pass it back to fetch the next page.
+     * @public
+     */
+    nextToken?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface ListAgentVersionsOutput {
+    versions: AgentVersionInfo[];
+    /**
+     * Opaque cursor returned by a previous page; pass it back to fetch the next page.
+     * @public
+     */
+    nextToken?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface ListAuditRecordsInput {
+    company?: string | undefined;
+    agentId?: string | undefined;
+    resourceType?: AuditResourceType | undefined;
+    action?: AuditAction | undefined;
+    /**
+     * Filter by the user, API key or service that performed the action.
+     * @public
+     */
+    actorId?: string | undefined;
+    /**
+     * ISO-8601 timestamp, e.g. '2026-07-03T10:15:30.000Z'.
+     * @public
+     */
+    from?: string | undefined;
+    /**
+     * ISO-8601 timestamp, e.g. '2026-07-03T10:15:30.000Z'.
+     * @public
+     */
+    to?: string | undefined;
+    limit?: number | undefined;
+    /**
+     * Opaque cursor returned by a previous page; pass it back to fetch the next page.
+     * @public
+     */
+    nextToken?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface ListAuditRecordsOutput {
+    records: AuditRecord[];
+    /**
+     * Opaque cursor returned by a previous page; pass it back to fetch the next page.
+     * @public
+     */
+    nextToken?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface ListGuardrailsInput {
+    company?: string | undefined;
+    limit?: number | undefined;
+    /**
+     * Opaque cursor returned by a previous page; pass it back to fetch the next page.
+     * @public
+     */
+    nextToken?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface ListGuardrailsOutput {
+    guardrails: Guardrail[];
+    /**
+     * Opaque cursor returned by a previous page; pass it back to fetch the next page.
+     * @public
+     */
+    nextToken?: string | undefined;
+}
+/**
+ * @public
+ */
+export interface PublishAgentVersionInput {
+    company?: string | undefined;
+    agentId: string;
+    /**
+     * What changed in this version.
+     * @public
+     */
+    changelog?: string | undefined;
+    /**
+     * Draft revision this publish is based on (optimistic locking).
+     * @public
+     */
+    revision?: number | undefined;
+}
+/**
+ * @public
+ */
+export interface PublishAgentVersionOutput {
+    version: AgentVersion;
+}
+/**
+ * @public
+ */
+export interface PutAgentAliasInput {
+    company?: string | undefined;
+    agentId: string;
+    /**
+     * Alias name, e.g. 'production', 'staging'.
+     * @public
+     */
+    aliasName: string;
+    description?: string | undefined;
+    routing: AgentAliasRoute[];
+}
+/**
+ * @public
+ */
+export interface PutAgentAliasOutput {
+    alias: AgentAlias;
+}
+/**
+ * The complete, versionable configuration of an agent. This is what gets snapshotted when a version is published.
+ * @public
+ */
+export interface UpdateAgentInput {
+    name: string;
+    description?: string | undefined;
+    /**
+     * Category of the agent, e.g.: 'Support'.
+     * @public
+     */
+    category?: string | undefined;
+    /**
+     * Avatar URL.
+     * @public
+     */
+    picture?: string | undefined;
+    engine: AgentEngine;
+    /**
+     * Per-channel deployment settings. An agent is reachable only on channels configured here.
+     * @public
+     */
+    channels?: AgentChannels | undefined;
+    /**
+     * Guardrail policies applied to this agent's inputs and outputs.
+     * @public
+     */
+    guardrails?: string[] | undefined;
+    access?: AgentAccess | undefined;
+    company?: string | undefined;
+    agentId: string;
+    /**
+     * Draft revision this update is based on (optimistic locking). When it does not match the current revision, RevisionConflictException is returned.
+     * @public
+     */
+    revision?: number | undefined;
+}
+/**
+ * @public
+ */
+export interface UpdateAgentOutput {
+    /**
+     * The complete, versionable configuration of an agent. This is what gets snapshotted when a version is published.
+     * @public
+     */
+    agent: Agent;
+}
+/**
+ * Editable guardrail configuration.
+ * @public
+ */
+export interface UpdateGuardrailInput {
+    name: string;
+    description?: string | undefined;
+    topicPolicy?: GuardrailTopicPolicy | undefined;
+    contentPolicy?: GuardrailContentPolicy | undefined;
+    wordPolicy?: GuardrailWordPolicy | undefined;
+    piiPolicy?: GuardrailPiiPolicy | undefined;
+    /**
+     * Answer returned to the end user when input is blocked.
+     * @public
+     */
+    blockedInputMessage?: string | undefined;
+    /**
+     * Answer returned to the end user when the agent output is blocked.
+     * @public
+     */
+    blockedOutputMessage?: string | undefined;
+    company?: string | undefined;
+    guardrailId: string;
+}
+/**
+ * @public
+ */
+export interface UpdateGuardrailOutput {
+    /**
+     * Editable guardrail configuration.
+     * @public
+     */
+    guardrail: Guardrail;
+}