@wildix/wilma-agents-client 1.0.54 → 1.0.56

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

@@ -590,8 +590,8 @@ exports.AgentHangupPipeline$ = [3, n2, _AHPg,
 ];
 exports.AgentInfo$ = [3, n2, _AI,
     0,
-    [_i, _n, _st, _ch, _p, _ca, _sC, _sI, _as, _lV],
-    [0, 0, 0, 64 | 0, 0, 0, 2, 64 | 0, () => exports.AssistantUiSettings$, 1], 4
+    [_i, _n, _st, _ch, _p, _ca, _sC, _en, _sI, _as, _lV],
+    [0, 0, 0, 64 | 0, 0, 0, 2, 0, 64 | 0, () => exports.AssistantUiSettings$, 1], 4
 ];
 exports.AgentInlineSandboxOptions$ = [3, n2, _AISO,
     0,
@@ -621,7 +621,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,
@@ -741,7 +741,7 @@ exports.AgentWebFetchCapability$ = [3, n2, _AWFC,
 exports.AgentWebhookEngine$ = [3, n2, _AWE,
     0,
     [_u, _sec, _ti],
-    [0, 0, 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

@@ -584,8 +584,8 @@ export var AgentHangupPipeline$ = [3, n2, _AHPg,
 ];
 export var AgentInfo$ = [3, n2, _AI,
     0,
-    [_i, _n, _st, _ch, _p, _ca, _sC, _sI, _as, _lV],
-    [0, 0, 0, 64 | 0, 0, 0, 2, 64 | 0, () => AssistantUiSettings$, 1], 4
+    [_i, _n, _st, _ch, _p, _ca, _sC, _en, _sI, _as, _lV],
+    [0, 0, 0, 64 | 0, 0, 0, 2, 0, 64 | 0, () => AssistantUiSettings$, 1], 4
 ];
 export var AgentInlineSandboxOptions$ = [3, n2, _AISO,
     0,
@@ -615,7 +615,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,
@@ -735,7 +735,7 @@ export var AgentWebFetchCapability$ = [3, n2, _AWFC,
 export var AgentWebhookEngine$ = [3, n2, _AWE,
     0,
     [_u, _sec, _ti],
-    [0, 0, 1], 2
+    [0, () => SecretRef$, 1], 1
 ];
 export var AgentWebSearchCapability$ = [3, n2, _AWSC,
     0,

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

@@ -903,13 +903,15 @@ declare const CreateAgentCommand_base: {
  *     },
  *     webhook: { // AgentWebhookEngine
  *       url: "STRING_VALUE", // required
- *       secret: "STRING_VALUE", // required
+ *       secret: { // SecretRef
+ *         id: "STRING_VALUE", // required
+ *       },
  *       timeout: Number("int"),
  *     },
  *     sqs: { // AgentSqsEngine
  *       url: "STRING_VALUE", // required
  *       key: "STRING_VALUE", // required
- *       secret: { // SecretRef
+ *       secret: {
  *         id: "STRING_VALUE", // required
  *       },
  *     },
@@ -1790,13 +1792,15 @@ declare const CreateAgentCommand_base: {
  * //       },
  * //       webhook: { // AgentWebhookEngine
  * //         url: "STRING_VALUE", // required
- * //         secret: "STRING_VALUE", // required
+ * //         secret: { // SecretRef
+ * //           id: "STRING_VALUE", // required
+ * //         },
  * //         timeout: Number("int"),
  * //       },
  * //       sqs: { // AgentSqsEngine
  * //         url: "STRING_VALUE", // required
  * //         key: "STRING_VALUE", // required
- * //         secret: { // SecretRef
+ * //         secret: {
  * //           id: "STRING_VALUE", // required
  * //         },
  * //       },

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

@@ -910,13 +910,15 @@ declare const GetAgentCommand_base: {
  * //       },
  * //       webhook: { // AgentWebhookEngine
  * //         url: "STRING_VALUE", // required
- * //         secret: "STRING_VALUE", // required
+ * //         secret: { // SecretRef
+ * //           id: "STRING_VALUE", // required
+ * //         },
  * //         timeout: Number("int"),
  * //       },
  * //       sqs: { // AgentSqsEngine
  * //         url: "STRING_VALUE", // required
  * //         key: "STRING_VALUE", // required
- * //         secret: { // SecretRef
+ * //         secret: {
  * //           id: "STRING_VALUE", // required
  * //         },
  * //       },

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

@@ -917,13 +917,15 @@ declare const GetAgentVersionCommand_base: {
  * //         },
  * //         webhook: { // AgentWebhookEngine
  * //           url: "STRING_VALUE", // required
- * //           secret: "STRING_VALUE", // required
+ * //           secret: { // SecretRef
+ * //             id: "STRING_VALUE", // required
+ * //           },
  * //           timeout: Number("int"),
  * //         },
  * //         sqs: { // AgentSqsEngine
  * //           url: "STRING_VALUE", // required
  * //           key: "STRING_VALUE", // required
- * //           secret: { // SecretRef
+ * //           secret: {
  * //             id: "STRING_VALUE", // required
  * //           },
  * //         },

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

@@ -915,13 +915,15 @@ declare const ListAgentsCommand_base: {
  * //         },
  * //         webhook: { // AgentWebhookEngine
  * //           url: "STRING_VALUE", // required
- * //           secret: "STRING_VALUE", // required
+ * //           secret: { // SecretRef
+ * //             id: "STRING_VALUE", // required
+ * //           },
  * //           timeout: Number("int"),
  * //         },
  * //         sqs: { // AgentSqsEngine
  * //           url: "STRING_VALUE", // required
  * //           key: "STRING_VALUE", // required
- * //           secret: { // SecretRef
+ * //           secret: {
  * //             id: "STRING_VALUE", // required
  * //           },
  * //         },

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",
  * //       skillIds: [ // AgentSkillIdsList
  * //         "STRING_VALUE",
  * //       ],

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

@@ -919,13 +919,15 @@ declare const PublishAgentVersionCommand_base: {
  * //         },
  * //         webhook: { // AgentWebhookEngine
  * //           url: "STRING_VALUE", // required
- * //           secret: "STRING_VALUE", // required
+ * //           secret: { // SecretRef
+ * //             id: "STRING_VALUE", // required
+ * //           },
  * //           timeout: Number("int"),
  * //         },
  * //         sqs: { // AgentSqsEngine
  * //           url: "STRING_VALUE", // required
  * //           key: "STRING_VALUE", // required
- * //           secret: { // SecretRef
+ * //           secret: {
  * //             id: "STRING_VALUE", // required
  * //           },
  * //         },

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

@@ -912,13 +912,15 @@ declare const RestoreAgentVersionToDraftCommand_base: {
  * //       },
  * //       webhook: { // AgentWebhookEngine
  * //         url: "STRING_VALUE", // required
- * //         secret: "STRING_VALUE", // required
+ * //         secret: { // SecretRef
+ * //           id: "STRING_VALUE", // required
+ * //         },
  * //         timeout: Number("int"),
  * //       },
  * //       sqs: { // AgentSqsEngine
  * //         url: "STRING_VALUE", // required
  * //         key: "STRING_VALUE", // required
- * //         secret: { // SecretRef
+ * //         secret: {
  * //           id: "STRING_VALUE", // required
  * //         },
  * //       },

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

@@ -903,13 +903,15 @@ declare const UpdateAgentCommand_base: {
  *     },
  *     webhook: { // AgentWebhookEngine
  *       url: "STRING_VALUE", // required
- *       secret: "STRING_VALUE", // required
+ *       secret: { // SecretRef
+ *         id: "STRING_VALUE", // required
+ *       },
  *       timeout: Number("int"),
  *     },
  *     sqs: { // AgentSqsEngine
  *       url: "STRING_VALUE", // required
  *       key: "STRING_VALUE", // required
- *       secret: { // SecretRef
+ *       secret: {
  *         id: "STRING_VALUE", // required
  *       },
  *     },
@@ -1792,13 +1794,15 @@ declare const UpdateAgentCommand_base: {
  * //       },
  * //       webhook: { // AgentWebhookEngine
  * //         url: "STRING_VALUE", // required
- * //         secret: "STRING_VALUE", // required
+ * //         secret: { // SecretRef
+ * //           id: "STRING_VALUE", // required
+ * //         },
  * //         timeout: Number("int"),
  * //       },
  * //       sqs: { // AgentSqsEngine
  * //         url: "STRING_VALUE", // required
  * //         key: "STRING_VALUE", // required
- * //         secret: { // SecretRef
+ * //         secret: {
  * //           id: "STRING_VALUE", // 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
@@ -3161,29 +3161,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;
     /**
-     * Shared secret used to sign requests (HMAC).
+     * 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: string;
     timeout?: number | undefined;
 }
 /**
@@ -3206,7 +3230,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 {
@@ -3216,7 +3243,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 {
@@ -3440,6 +3469,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;
     /**
      * Ids of the skills attached to this agent. Always active in this agent's sessions; user skill preferences cannot disable them.
      * @public

package/package.json

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