@wildix/wilma-agents-client 1.0.57 → 1.0.58

package/dist-cjs/models/enums.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AgentStatus = exports.AgentWorkflowLayout = exports.AgentWorkflowFailureKind = exports.AgentWorkflowMessageButtonVariant = exports.AgentWorkflowEntryBehavior = exports.AgentVariableType = exports.AgentGuardrailWindow = exports.AgentGuardrailMode = exports.AgentGuardrailErrorMode = exports.AgentGuardrailSensitivity = exports.AgentGuardrailPreset = exports.WebSearchContextSize = exports.AgentTransferVariant = exports.AgentTransferPipelineType = exports.SandboxSize = exports.SandboxNetworkAccess = exports.KnowledgeBaseSearchThreshold = exports.KnowledgeBaseSearchStrategy = exports.AgentHangupPipelineType = exports.AgentHandoverVariant = exports.AgentHandoverPipelineType = exports.AgentToolPipelineType = exports.ChannelType = exports.ActorType = exports.VoicePronunciationEncoding = exports.AgentVisibility = void 0;
+exports.AgentEngineKind = exports.AgentStatus = exports.AgentWorkflowLayout = exports.AgentWorkflowFailureKind = exports.AgentWorkflowMessageButtonVariant = exports.AgentWorkflowEntryBehavior = exports.AgentVariableType = exports.AgentGuardrailWindow = exports.AgentGuardrailMode = exports.AgentGuardrailErrorMode = exports.AgentGuardrailSensitivity = exports.AgentGuardrailPreset = exports.WebSearchContextSize = exports.AgentTransferVariant = exports.AgentTransferPipelineType = exports.SandboxSize = exports.SandboxNetworkAccess = exports.KnowledgeBaseSearchThreshold = exports.KnowledgeBaseSearchStrategy = exports.AgentHangupPipelineType = exports.AgentHandoverVariant = exports.AgentHandoverPipelineType = exports.AgentToolPipelineType = exports.ChannelType = exports.ActorType = exports.VoicePronunciationEncoding = exports.AgentVisibility = void 0;
 exports.AgentVisibility = {
     EXPLICIT: "explicit",
     ORGANIZATION: "organization",
@@ -138,3 +138,8 @@ exports.AgentStatus = {
     ACTIVE: "active",
     DRAFT: "draft",
 };
+exports.AgentEngineKind = {
+    AI: "ai",
+    SQS: "sqs",
+    WEBHOOK: "webhook",
+};

package/dist-cjs/schemas/schemas_0.js

@@ -598,8 +598,8 @@ exports.AgentHangupPipeline$ = [3, n2, _AHPg,
 ];
 exports.AgentInfo$ = [3, n2, _AI,
     0,
-    [_i, _n, _st, _ch, _p, _ca, _sC, _aVs, _sI, _as, _lV],
-    [0, 0, 0, 64 | 0, 0, 0, 2, () => exports.AssistantVoiceSettings$, 64 | 0, () => exports.AssistantUiSettings$, 1], 4
+    [_i, _n, _st, _ch, _p, _ca, _sC, _en, _aVs, _sI, _as, _lV],
+    [0, 0, 0, 64 | 0, 0, 0, 2, 0, () => exports.AssistantVoiceSettings$, 64 | 0, () => exports.AssistantUiSettings$, 1], 4
 ];
 exports.AgentInlineSandboxOptions$ = [3, n2, _AISO,
     0,
@@ -629,7 +629,7 @@ exports.AgentSpokenPhrase$ = [3, n2, _ASP,
 exports.AgentSqsEngine$ = [3, n2, _ASE,
     0,
     [_u, _ke, _sec],
-    [0, 0, () => exports.SecretRef$], 3
+    [0, 0, () => exports.SecretRef$], 2
 ];
 exports.AgentSuggestionsCapability$ = [3, n2, _ASC,
     0,
@@ -749,7 +749,7 @@ exports.AgentWebFetchCapability$ = [3, n2, _AWFC,
 exports.AgentWebhookEngine$ = [3, n2, _AWE,
     0,
     [_u, _sec, _ti],
-    [0, () => exports.SecretRef$, 1], 2
+    [0, () => exports.SecretRef$, 1], 1
 ];
 exports.AgentWebSearchCapability$ = [3, n2, _AWSC,
     0,

package/dist-es/models/enums.js

@@ -135,3 +135,8 @@ export const AgentStatus = {
     ACTIVE: "active",
     DRAFT: "draft",
 };
+export const AgentEngineKind = {
+    AI: "ai",
+    SQS: "sqs",
+    WEBHOOK: "webhook",
+};

package/dist-es/schemas/schemas_0.js

@@ -592,8 +592,8 @@ export var AgentHangupPipeline$ = [3, n2, _AHPg,
 ];
 export var AgentInfo$ = [3, n2, _AI,
     0,
-    [_i, _n, _st, _ch, _p, _ca, _sC, _aVs, _sI, _as, _lV],
-    [0, 0, 0, 64 | 0, 0, 0, 2, () => AssistantVoiceSettings$, 64 | 0, () => AssistantUiSettings$, 1], 4
+    [_i, _n, _st, _ch, _p, _ca, _sC, _en, _aVs, _sI, _as, _lV],
+    [0, 0, 0, 64 | 0, 0, 0, 2, 0, () => AssistantVoiceSettings$, 64 | 0, () => AssistantUiSettings$, 1], 4
 ];
 export var AgentInlineSandboxOptions$ = [3, n2, _AISO,
     0,
@@ -623,7 +623,7 @@ export var AgentSpokenPhrase$ = [3, n2, _ASP,
 export var AgentSqsEngine$ = [3, n2, _ASE,
     0,
     [_u, _ke, _sec],
-    [0, 0, () => SecretRef$], 3
+    [0, 0, () => SecretRef$], 2
 ];
 export var AgentSuggestionsCapability$ = [3, n2, _ASC,
     0,
@@ -743,7 +743,7 @@ export var AgentWebFetchCapability$ = [3, n2, _AWFC,
 export var AgentWebhookEngine$ = [3, n2, _AWE,
     0,
     [_u, _sec, _ti],
-    [0, () => SecretRef$, 1], 2
+    [0, () => SecretRef$, 1], 1
 ];
 export var AgentWebSearchCapability$ = [3, n2, _AWSC,
     0,

package/dist-types/commands/ListAgentsNamesCommand.d.ts

@@ -54,6 +54,7 @@ declare const ListAgentsNamesCommand_base: {
  * //         "voice" || "chat" || "assistant",
  * //       ],
  * //       speechConfigured: true || false,
+ * //       engine: "ai" || "webhook" || "sqs",
  * //       assistantVoice: { // AssistantVoiceSettings
  * //         enabled: true || false, // required
  * //       },

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

@@ -505,3 +505,25 @@ export declare const AgentStatus: {
  * @public
  */
 export type AgentStatus = (typeof AgentStatus)[keyof typeof AgentStatus];
+/**
+ * @public
+ * @enum
+ */
+export declare const AgentEngineKind: {
+    /**
+     * The managed engine: the platform runs the model, tools and knowledge lookups.
+     */
+    readonly AI: "ai";
+    /**
+     * An external backend over SQS.
+     */
+    readonly SQS: "sqs";
+    /**
+     * An external backend over HTTPS.
+     */
+    readonly WEBHOOK: "webhook";
+};
+/**
+ * @public
+ */
+export type AgentEngineKind = (typeof AgentEngineKind)[keyof typeof AgentEngineKind];

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

@@ -1,5 +1,5 @@
 import type { DocumentType as __DocumentType } from "@smithy/types";
-import type { ActorType, AgentGuardrailErrorMode, AgentGuardrailMode, AgentGuardrailPreset, AgentGuardrailSensitivity, AgentGuardrailWindow, AgentHandoverPipelineType, AgentHandoverVariant, AgentHangupPipelineType, AgentStatus, AgentToolPipelineType, AgentTransferPipelineType, AgentTransferVariant, AgentVariableType, AgentVisibility, AgentWorkflowEntryBehavior, AgentWorkflowFailureKind, AgentWorkflowLayout, AgentWorkflowMessageButtonVariant, ChannelType, KnowledgeBaseSearchStrategy, KnowledgeBaseSearchThreshold, SandboxNetworkAccess, SandboxSize, VoicePronunciationEncoding, WebSearchContextSize } from "./enums";
+import type { ActorType, AgentEngineKind, AgentGuardrailErrorMode, AgentGuardrailMode, AgentGuardrailPreset, AgentGuardrailSensitivity, AgentGuardrailWindow, AgentHandoverPipelineType, AgentHandoverVariant, AgentHangupPipelineType, AgentStatus, AgentToolPipelineType, AgentTransferPipelineType, AgentTransferVariant, AgentVariableType, AgentVisibility, AgentWorkflowEntryBehavior, AgentWorkflowFailureKind, AgentWorkflowLayout, AgentWorkflowMessageButtonVariant, ChannelType, KnowledgeBaseSearchStrategy, KnowledgeBaseSearchThreshold, SandboxNetworkAccess, SandboxSize, VoicePronunciationEncoding, WebSearchContextSize } from "./enums";
 /**
  * A user or group that access is granted to.
  * @public
@@ -3283,33 +3283,53 @@ export interface SecretRef {
     id: string;
 }
 /**
- * Bring-your-own backend over SQS: turns are forwarded to the queue, replies are posted back via the API.
+ * Bring-your-own backend over SQS: the platform sends what happens to the queue and the backend
+ * answers out of band through the channel's command plane. Authentication is the credential that
+ * makes the send; there is no signature and no response.
  * @public
  */
 export interface AgentSqsEngine {
     url: string;
     key: string;
     /**
-     * Reference to the SQS secret access key in wilma-secrets.
+     * Reference to the SQS secret access key in wilma-secrets. Optional for the same reason the
+     * webhook engine's is: an agent is created before it is configured, and a console cannot
+     * supply a reference to a secret nobody has chosen. The call refuses instead, naming what is
+     * missing.
      * @public
      */
-    secret: SecretRef;
+    secret?: SecretRef | undefined;
 }
 /**
- * Bring-your-own backend over HTTPS: each turn is POSTed to the URL, the response is the reply.
+ * Bring-your-own backend over HTTPS: the platform POSTs what happens to the URL and the backend
+ * answers out of band through the channel's command plane, never in the response body — which is
+ * what lets one contract serve both this engine and the queue one, where there is no body to
+ * answer in. The response body is not read.
  * @public
  */
 export interface AgentWebhookEngine {
     url: string;
     /**
-     * Reference to the HMAC signing secret in wilma-secrets. Was the secret itself, which put
-     *         credential material in the agent document — readable back out of a stored row and carried
-     *         into any export of the definition. The sibling AgentSqsEngine has always held a reference;
-     *         this is the same shape, so nothing that reads an engine has to special-case which of the
-     *         two it is looking at.
+     * Reference to the HMAC signing secret in wilma-secrets, resolved server-to-server at
+     * delivery. A reference and never the value: an agent holds no credential, like everything
+     * else on this platform, and the member is named for what it holds — `secret`, as on the
+     * queue engine and on a sandbox's environment — because the reference is the type's job to
+     * say. An agent migrated from the previous stack gets one created for the secret it was
+     * configured with.
+     *
+     * A DRAFT MAY NOT HAVE ONE YET. An agent is created before it is configured — that is what
+     * the draft status is for — and a console cannot supply a reference to a secret nobody has
+     * chosen. The call refuses instead, naming what is missing, which is where the author finds
+     * out at the only moment it matters.
+     * @public
+     */
+    secret?: SecretRef | undefined;
+    /**
+     * How long one delivery may take, in MILLISECONDS. It bounds a single request and not the
+     * call: a backend that spends all of it on every event is told about the call late, never
+     * less often.
      * @public
      */
-    secret: SecretRef;
     timeout?: number | undefined;
 }
 /**
@@ -3332,7 +3352,10 @@ export declare namespace AgentEngine {
         $unknown?: never;
     }
     /**
-     * Bring-your-own backend over HTTPS: each turn is POSTed to the URL, the response is the reply.
+     * Bring-your-own backend over HTTPS: the platform POSTs what happens to the URL and the backend
+     * answers out of band through the channel's command plane, never in the response body — which is
+     * what lets one contract serve both this engine and the queue one, where there is no body to
+     * answer in. The response body is not read.
      * @public
      */
     interface WebhookMember {
@@ -3342,7 +3365,9 @@ export declare namespace AgentEngine {
         $unknown?: never;
     }
     /**
-     * Bring-your-own backend over SQS: turns are forwarded to the queue, replies are posted back via the API.
+     * Bring-your-own backend over SQS: the platform sends what happens to the queue and the backend
+     * answers out of band through the channel's command plane. Authentication is the credential that
+     * makes the send; there is no signature and no response.
      * @public
      */
     interface SqsMember {
@@ -3577,6 +3602,19 @@ export interface AgentInfo {
      * @public
      */
     speechConfigured?: boolean | undefined;
+    /**
+     * Which engine produces this agent's replies: the managed one, or somebody else's backend
+     * over a webhook or a queue. `channels` is what the agent DECLARES, and an engine is
+     * implemented per channel, so the two are not the same question — an agent that declares a
+     * channel its engine cannot serve is configured, listed, and silent there.
+     *
+     * Which channels each engine can serve is a property of the platform rather than of this
+     * agent, so it does not travel per agent: every `ai` agent would carry the same answer. The
+     * service enforces it where it matters — a listing filtered by channel omits an agent whose
+     * engine cannot answer there, and the channel refuses the connection.
+     * @public
+     */
+    engine?: AgentEngineKind | undefined;
     /**
      * Assistant voice as an end-user client needs it. Answered from the definition the agent currently runs — the deployment's routed version, else the latest published version, else the draft only when nothing was ever published. Absent means the agent offers no voice.
      * @public
@@ -3898,7 +3936,14 @@ export interface ListAgentApiKeysOutput {
 export interface ListAgentsInput {
     company?: string | undefined;
     /**
-     * Only agents that have this channel enabled (voice / chat / assistant). An agent serving no channel matches no value of this filter, so a caller listing agents to run as a task — rather than to reach on a surface — must leave it unset.
+     * Only agents that have this channel enabled (voice / chat / assistant). An agent serving no
+     * channel matches no value of this filter, so a caller listing agents to run as a task —
+     * rather than to reach on a surface — must leave it unset.
+     *
+     * TWO CONDITIONS, not one: an agent whose ENGINE has no runtime for the asked channel is
+     * omitted as well, however its `channels` are set. A dialplan picker asking for `voice` would
+     * otherwise be offered agents whose every call drops at attach. `AgentInfo.engine` says which
+     * engine each remaining agent runs on.
      * @public
      */
     channel?: ChannelType | undefined;

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@wildix/wilma-agents-client",
     "description": "@wildix/wilma-agents-client client",
-    "version": "1.0.57",
+    "version": "1.0.58",
     "scripts": {
         "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
         "build:cjs": "tsc -p tsconfig.cjs.json",