@wildix/wilma-copilot-sessions-client 1.0.13 → 1.0.15

package/dist-cjs/schemas/schemas_0.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TrackInput$ = exports.StreamSessionEventsOutput$ = exports.StreamSessionEventsInput$ = exports.SmartActionClientAction$ = exports.ResolveOutput$ = exports.ResolveInput$ = exports.OpenOutput$ = exports.OpenInput$ = exports.ListSessionsOutput$ = exports.ListSessionsInput$ = exports.ListRelationshipSessionsOutput$ = exports.ListRelationshipSessionsInput$ = exports.KnowledgeSearchClientAction$ = exports.GetSessionEventsOutput$ = exports.GetSessionEventsInput$ = exports.EnrichOutput$ = exports.EnrichInput$ = exports.CopilotTranscriptionEvent$ = exports.CopilotSessionSummary$ = exports.CopilotRelationshipEvent$ = exports.CopilotLifecycleEvent$ = exports.CopilotIntentEvent$ = exports.CopilotIngestedSession$ = exports.CopilotEvaluationEvent$ = exports.CopilotContextLookup$ = exports.CopilotContextEntity$ = exports.CopilotContextConversation$ = exports.CopilotAssistantEvent$ = exports.CopilotAssetView$ = exports.CopilotAssetEvent$ = exports.CopilotAskEvent$ = exports.CopilotActionEvent$ = exports.AskOutput$ = exports.AskInput$ = exports.ActOutput$ = exports.ActInput$ = exports.ConferenceTranscriptionChunk$ = exports.ConferenceParticipant$ = exports.ConferenceAnalyticsLiveTranscriptionEvent$ = exports.ChatAnalyticsLiveTranscriptionEvent$ = exports.CallTranscriptionChunk$ = exports.CallParticipant$ = exports.CallAnalyticsLiveTranscriptionEvent$ = exports.TemplateWithParameters$ = exports.TemplateParameter$ = exports.errorTypeRegistries = exports.ValidationException$ = exports.NotFoundException$ = exports.ForbiddenException$ = exports.WilmaCopilotSessionsServiceException$ = void 0;
-exports.Track$ = exports.StreamSessionEvents$ = exports.Resolve$ = exports.Open$ = exports.ListSessions$ = exports.ListRelationshipSessions$ = exports.GetSessionEvents$ = exports.Enrich$ = exports.Ask$ = exports.Act$ = exports.Element$ = exports.ButtonHandler$ = exports.ActionElement$ = exports.CopilotTranscriptionData$ = exports.CopilotSessionEvent$ = exports.CopilotClientAction$ = exports.User$ = exports.Reaction$ = exports.MessageTemplateConfig$ = exports.MessageQuote$ = exports.MessageGiphy$ = exports.MessageForward$ = exports.MessageAttachment$ = exports.Message$ = exports.ButtonReplyHandler$ = exports.ButtonLinkHandler$ = exports.ButtonElement$ = exports.ButtonActionHandler$ = exports.TrackOutput$ = void 0;
+exports.StreamSessionEventsOutput$ = exports.StreamSessionEventsInput$ = exports.SmartActionClientAction$ = exports.ResolveOutput$ = exports.ResolveInput$ = exports.PlaybookClientAction$ = exports.OpenOutput$ = exports.OpenInput$ = exports.ListSessionsOutput$ = exports.ListSessionsInput$ = exports.ListRelationshipSessionsOutput$ = exports.ListRelationshipSessionsInput$ = exports.KnowledgeSearchClientAction$ = exports.GetSessionEventsOutput$ = exports.GetSessionEventsInput$ = exports.EnrichOutput$ = exports.EnrichInput$ = exports.CopilotTranscriptionEvent$ = exports.CopilotSessionSummary$ = exports.CopilotRelationshipEvent$ = exports.CopilotLifecycleEvent$ = exports.CopilotIntentEvent$ = exports.CopilotIngestedSession$ = exports.CopilotEvaluationEvent$ = exports.CopilotContextLookup$ = exports.CopilotContextEntity$ = exports.CopilotContextConversation$ = exports.CopilotAssistantEvent$ = exports.CopilotAssetView$ = exports.CopilotAssetEvent$ = exports.CopilotAskEvent$ = exports.CopilotActionEvent$ = exports.AskOutput$ = exports.AskInput$ = exports.ActOutput$ = exports.ActInput$ = exports.ConferenceTranscriptionChunk$ = exports.ConferenceParticipant$ = exports.ConferenceAnalyticsLiveTranscriptionEvent$ = exports.ChatAnalyticsLiveTranscriptionEvent$ = exports.CallTranscriptionChunk$ = exports.CallParticipant$ = exports.CallAnalyticsLiveTranscriptionEvent$ = exports.TemplateWithParameters$ = exports.TemplateParameter$ = exports.errorTypeRegistries = exports.ValidationException$ = exports.NotFoundException$ = exports.ForbiddenException$ = exports.WilmaCopilotSessionsServiceException$ = void 0;
+exports.Track$ = exports.StreamSessionEvents$ = exports.Resolve$ = exports.Open$ = exports.ListSessions$ = exports.ListRelationshipSessions$ = exports.GetSessionEvents$ = exports.Enrich$ = exports.Ask$ = exports.Act$ = exports.Element$ = exports.ButtonHandler$ = exports.ActionElement$ = exports.CopilotTranscriptionData$ = exports.CopilotSessionEvent$ = exports.CopilotClientAction$ = exports.User$ = exports.Reaction$ = exports.MessageTemplateConfig$ = exports.MessageQuote$ = exports.MessageGiphy$ = exports.MessageForward$ = exports.MessageAttachment$ = exports.Message$ = exports.ButtonReplyHandler$ = exports.ButtonLinkHandler$ = exports.ButtonElement$ = exports.ButtonActionHandler$ = exports.TrackOutput$ = exports.TrackInput$ = void 0;
 const _A = "Act";
 const _AE = "ActionElement";
 const _AEL = "ActionsElementsList";
@@ -74,6 +74,7 @@ const _NFE = "NotFoundException";
 const _O = "Open";
 const _OI = "OpenInput";
 const _OO = "OpenOutput";
+const _PCA = "PlaybookClientAction";
 const _R = "Reaction";
 const _RI = "ResolveInput";
 const _RL = "ReactionList";
@@ -116,6 +117,7 @@ const _ca = "call";
 const _ch = "chunk";
 const _cha = "chat";
 const _co = "company";
+const _com = "complete";
 const _con = "confidence";
 const _conf = "conference";
 const _cont = "content";
@@ -192,6 +194,7 @@ const _pb = "pbx";
 const _ph = "phone";
 const _pho = "phones";
 const _pi = "picture";
+const _pl = "playbook";
 const _q = "question";
 const _qI = "questionId";
 const _qu = "quote";
@@ -209,6 +212,7 @@ const _sAm = "smartAction";
 const _sCI = "sipCallId";
 const _sI = "sessionId";
 const _sIt = "startIndex";
+const _sIte = "stepIds";
 const _sS = "smsStatus";
 const _se = "sentiment";
 const _ses = "sessions";
@@ -224,6 +228,7 @@ const _state = "state";
 const _sti = "sticky";
 const _sty = "styling";
 const _t = "time";
+const _tI = "traceId";
 const _tST = "transcriptionStartTime";
 const _tZ = "timeZone";
 const _te = "text";
@@ -406,8 +411,8 @@ exports.CopilotIntentEvent$ = [3, n1, _CIE,
 ];
 exports.CopilotLifecycleEvent$ = [3, n1, _CLE,
     0,
-    [_in, _ti, _sI, _stat, _rea],
-    [1, 0, 0, 0, 0], 4
+    [_in, _ti, _sI, _stat, _tI, _rea],
+    [1, 0, 0, 0, 0, 0], 4
 ];
 exports.CopilotRelationshipEvent$ = [3, n1, _CRE,
     0,
@@ -479,6 +484,11 @@ exports.OpenOutput$ = [3, n1, _OO,
     [_rI, _sess, _rel],
     [0, () => exports.CopilotIngestedSession$, () => CopilotSessionSummaryList], 3
 ];
+exports.PlaybookClientAction$ = [3, n1, _PCA,
+    0,
+    [_aI, _sIte, _com],
+    [0, 64 | 0, 2], 1
+];
 exports.ResolveInput$ = [3, n1, _RI,
     0,
     [_loo, _co],
@@ -592,6 +602,7 @@ var CopilotSessionEvents = [1, n1, _CSE,
 var CopilotSessionSummaryList = [1, n1, _CSSL,
     0, () => exports.CopilotSessionSummary$
 ];
+var PlaybookStepIdList = 64 | 0;
 var ActionsElementsList = [1, n4, _AEL,
     0, () => exports.ActionElement$
 ];
@@ -611,8 +622,8 @@ var CopilotContextAttributes = 128 | 0;
 var ReactionCounts = 128 | 1;
 exports.CopilotClientAction$ = [4, n1, _CCA,
     0,
-    [_kS, _sAm],
-    [() => exports.KnowledgeSearchClientAction$, () => exports.SmartActionClientAction$]
+    [_kS, _sAm, _pl],
+    [() => exports.KnowledgeSearchClientAction$, () => exports.SmartActionClientAction$, () => exports.PlaybookClientAction$]
 ];
 exports.CopilotSessionEvent$ = [4, n1, _CSEo,
     0,

package/dist-es/schemas/schemas_0.js

@@ -70,6 +70,7 @@ const _NFE = "NotFoundException";
 const _O = "Open";
 const _OI = "OpenInput";
 const _OO = "OpenOutput";
+const _PCA = "PlaybookClientAction";
 const _R = "Reaction";
 const _RI = "ResolveInput";
 const _RL = "ReactionList";
@@ -112,6 +113,7 @@ const _ca = "call";
 const _ch = "chunk";
 const _cha = "chat";
 const _co = "company";
+const _com = "complete";
 const _con = "confidence";
 const _conf = "conference";
 const _cont = "content";
@@ -188,6 +190,7 @@ const _pb = "pbx";
 const _ph = "phone";
 const _pho = "phones";
 const _pi = "picture";
+const _pl = "playbook";
 const _q = "question";
 const _qI = "questionId";
 const _qu = "quote";
@@ -205,6 +208,7 @@ const _sAm = "smartAction";
 const _sCI = "sipCallId";
 const _sI = "sessionId";
 const _sIt = "startIndex";
+const _sIte = "stepIds";
 const _sS = "smsStatus";
 const _se = "sentiment";
 const _ses = "sessions";
@@ -220,6 +224,7 @@ const _state = "state";
 const _sti = "sticky";
 const _sty = "styling";
 const _t = "time";
+const _tI = "traceId";
 const _tST = "transcriptionStartTime";
 const _tZ = "timeZone";
 const _te = "text";
@@ -402,8 +407,8 @@ export var CopilotIntentEvent$ = [3, n1, _CIE,
 ];
 export var CopilotLifecycleEvent$ = [3, n1, _CLE,
     0,
-    [_in, _ti, _sI, _stat, _rea],
-    [1, 0, 0, 0, 0], 4
+    [_in, _ti, _sI, _stat, _tI, _rea],
+    [1, 0, 0, 0, 0, 0], 4
 ];
 export var CopilotRelationshipEvent$ = [3, n1, _CRE,
     0,
@@ -475,6 +480,11 @@ export var OpenOutput$ = [3, n1, _OO,
     [_rI, _sess, _rel],
     [0, () => CopilotIngestedSession$, () => CopilotSessionSummaryList], 3
 ];
+export var PlaybookClientAction$ = [3, n1, _PCA,
+    0,
+    [_aI, _sIte, _com],
+    [0, 64 | 0, 2], 1
+];
 export var ResolveInput$ = [3, n1, _RI,
     0,
     [_loo, _co],
@@ -588,6 +598,7 @@ var CopilotSessionEvents = [1, n1, _CSE,
 var CopilotSessionSummaryList = [1, n1, _CSSL,
     0, () => CopilotSessionSummary$
 ];
+var PlaybookStepIdList = 64 | 0;
 var ActionsElementsList = [1, n4, _AEL,
     0, () => ActionElement$
 ];
@@ -607,8 +618,8 @@ var CopilotContextAttributes = 128 | 0;
 var ReactionCounts = 128 | 1;
 export var CopilotClientAction$ = [4, n1, _CCA,
     0,
-    [_kS, _sAm],
-    [() => KnowledgeSearchClientAction$, () => SmartActionClientAction$]
+    [_kS, _sAm, _pl],
+    [() => KnowledgeSearchClientAction$, () => SmartActionClientAction$, () => PlaybookClientAction$]
 ];
 export var CopilotSessionEvent$ = [4, n1, _CSEo,
     0,

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

@@ -27,11 +27,11 @@ declare const ActCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/types").EndpointParameterInstructions;
 };
 /**
- * Submits one user interaction with copilot output — a knowledge-search suggestion click or a
- *     smart-action invocation. The action is appended to the session's input mailbox and processed
- *     asynchronously by the session worker; outcomes surface in the event log as `action` events and
- *     asset updates. Clicks also feed the per-resource usage statistics in the wilma-copilot config
- *     API.
+ * Submits one user interaction with copilot output — a knowledge-search suggestion click, a
+ *     smart-action invocation, or playbook progress the agent made by hand. The action is appended to
+ *     the session's input mailbox and processed asynchronously by the session worker; outcomes surface
+ *     in the event log as `action` events and asset updates. Clicks also feed the per-resource usage
+ *     statistics in the wilma-copilot config API.
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -53,6 +53,13 @@ declare const ActCommand_base: {
  *       actionId: "STRING_VALUE", // required
  *       variables: "DOCUMENT_VALUE",
  *     },
+ *     playbook: { // PlaybookClientAction
+ *       assetId: "STRING_VALUE", // required
+ *       stepIds: [ // PlaybookStepIdList
+ *         "STRING_VALUE",
+ *       ],
+ *       complete: true || false,
+ *     },
  *   },
  * };
  * const command = new ActCommand(input);

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

@@ -51,6 +51,7 @@ declare const GetSessionEventsCommand_base: {
  * //         index: Number("int"), // required
  * //         timestamp: "STRING_VALUE", // required
  * //         sessionId: "STRING_VALUE", // required
+ * //         traceId: "STRING_VALUE",
  * //         status: "active" || "idle" || "archived" || "failed", // required
  * //         reason: "created" || "ended" || "stopped" || "inactivity" || "archive_timer" || "revived" || "error",
  * //       },

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

@@ -28,7 +28,7 @@ declare const StreamSessionEventsCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/types").EndpointParameterInstructions;
 };
 /**
- * Replays and tails copilot session events as Server-Sent Events (`text/event-stream`). Each frame carries one CopilotSessionEvent: `id:` is the event index, `event:` is the union member name, and `data:` is the JSON document of the union value. The stream closes after a `lifecycle` event that leaves the session dormant (`idle`, `archived`) or `failed`; reconnect with the last seen index + 1 as `startIndex` to resume, including after a dormant session revives.
+ * Replays and tails copilot session events as Server-Sent Events (`text/event-stream`). Each frame carries one CopilotSessionEvent: `id:` is the event index, `event:` is the union member name, and `data:` is the JSON document of the union value. The stream closes after a `lifecycle` event that leaves the session dormant (`idle`, `archived`) or `failed`; reconnect with the last seen index + 1 as `startIndex` to resume, including after a dormant session revives. `startIndex` is the only resume cursor — no `Last-Event-ID` header is read, because a client already tracks the index it is rendering, and that is the same cursor GetSessionEvents pages with.
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -439,6 +439,31 @@ export interface KnowledgeSearchClientAction {
      */
     question?: string | undefined;
 }
+/**
+ * Records playbook progress the agent made by hand: the steps that do not auto-complete from the
+ *     transcript, and — where the playbook allows it — the playbook itself. Progress is append-only, so
+ *     a step the transcript already completed stays complete and re-sending an id is a no-op.
+ * @public
+ */
+export interface PlaybookClientAction {
+    /**
+     * Id of the asset carrying the playbook.
+     * @public
+     */
+    assetId: string;
+    /**
+     * Steps the agent ticked. Ids that are not steps of this playbook are ignored.
+     * @public
+     */
+    stepIds?: string[] | undefined;
+    /**
+     * Marks the whole playbook complete. Honoured only when the playbook's `completionCriteria` is
+     *       `manual` with `allowAgentMarkComplete`; ignored for semantic criteria, where the model owns the
+     *       goal verdict. Required steps still gate the checkmark either way.
+     * @public
+     */
+    complete?: boolean | undefined;
+}
 /**
  * Invokes one smart action offered by an asset.
  * @public
@@ -464,7 +489,7 @@ export interface SmartActionClientAction {
  * One user interaction with copilot output. Exactly one member is set.
  * @public
  */
-export type CopilotClientAction = CopilotClientAction.KnowledgeSearchMember | CopilotClientAction.SmartActionMember | CopilotClientAction.$UnknownMember;
+export type CopilotClientAction = CopilotClientAction.KnowledgeSearchMember | CopilotClientAction.PlaybookMember | CopilotClientAction.SmartActionMember | CopilotClientAction.$UnknownMember;
 /**
  * @public
  */
@@ -476,6 +501,7 @@ export declare namespace CopilotClientAction {
     interface KnowledgeSearchMember {
         knowledgeSearch: KnowledgeSearchClientAction;
         smartAction?: never;
+        playbook?: never;
         $unknown?: never;
     }
     /**
@@ -485,6 +511,19 @@ export declare namespace CopilotClientAction {
     interface SmartActionMember {
         knowledgeSearch?: never;
         smartAction: SmartActionClientAction;
+        playbook?: never;
+        $unknown?: never;
+    }
+    /**
+     * Records playbook progress the agent made by hand: the steps that do not auto-complete from the
+     *     transcript, and — where the playbook allows it — the playbook itself. Progress is append-only, so
+     *     a step the transcript already completed stays complete and re-sending an id is a no-op.
+     * @public
+     */
+    interface PlaybookMember {
+        knowledgeSearch?: never;
+        smartAction?: never;
+        playbook: PlaybookClientAction;
         $unknown?: never;
     }
     /**
@@ -493,6 +532,7 @@ export declare namespace CopilotClientAction {
     interface $UnknownMember {
         knowledgeSearch?: never;
         smartAction?: never;
+        playbook?: never;
         $unknown: [string, any];
     }
     /**
@@ -502,6 +542,7 @@ export declare namespace CopilotClientAction {
     interface Visitor<T> {
         knowledgeSearch: (value: KnowledgeSearchClientAction) => T;
         smartAction: (value: SmartActionClientAction) => T;
+        playbook: (value: PlaybookClientAction) => T;
         _: (name: string, value: any) => T;
     }
 }
@@ -587,7 +628,7 @@ export interface CopilotActionEvent {
      */
     id: string;
     /**
-     * What was invoked: `knowledge_search`, `runAgent`, `runTool`, `transfer`, `handover` or `openUrl`.
+     * What was invoked: `knowledge_search`, `playbook`, `runAgent`, `transfer`, `handover` or `openUrl`.
      * @public
      */
     kind: string;
@@ -798,7 +839,9 @@ export interface CopilotIntentEvent {
     state: __DocumentType;
 }
 /**
- * Session lifecycle transition. Emitted on attach and on every status transition; `reason` says why the session moved.
+ * Session lifecycle transition. Emitted on attach and on every status transition; `reason` says
+ *     why the session moved. Copilot exposes no session read operation, so this is where a client
+ *     learns the session's identity — including the trace recording it, delivered on attach.
  * @public
  */
 export interface CopilotLifecycleEvent {
@@ -813,6 +856,11 @@ export interface CopilotLifecycleEvent {
      */
     timestamp: string;
     sessionId: string;
+    /**
+     * Opaque trace identifier generated by the tracing runtime.
+     * @public
+     */
+    traceId?: string | undefined;
     status: CopilotSessionStatus;
     /**
      * Why a lifecycle transition happened.
@@ -924,7 +972,9 @@ export type CopilotSessionEvent = CopilotSessionEvent.ActionMember | CopilotSess
  */
 export declare namespace CopilotSessionEvent {
     /**
-     * Session lifecycle transition. Emitted on attach and on every status transition; `reason` says why the session moved.
+     * Session lifecycle transition. Emitted on attach and on every status transition; `reason` says
+     *     why the session moved. Copilot exposes no session read operation, so this is where a client
+     *     learns the session's identity — including the trace recording it, delivered on attach.
      * @public
      */
     interface LifecycleMember {

package/dist-types/schemas/schemas_0.d.ts

@@ -49,6 +49,7 @@ export declare var ListSessionsInput$: StaticStructureSchema;
 export declare var ListSessionsOutput$: StaticStructureSchema;
 export declare var OpenInput$: StaticStructureSchema;
 export declare var OpenOutput$: StaticStructureSchema;
+export declare var PlaybookClientAction$: StaticStructureSchema;
 export declare var ResolveInput$: StaticStructureSchema;
 export declare var ResolveOutput$: StaticStructureSchema;
 export declare var SmartActionClientAction$: StaticStructureSchema;

package/package.json

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