@xemahq/contracts 0.81.0 → 0.82.0

package/dist/session-events/lib/session-event-payloads/assistant-message-metadata.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildAssistantMessageMetadata = buildAssistantMessageMetadata;
+function buildAssistantMessageMetadata(args) {
+    if (args.turnId.length === 0) {
+        throw new TypeError('Assistant message metadata field "turnId" must be a non-empty string.');
+    }
+    const reasoning = args.reasoning?.trim() ?? '';
+    const hasRailContent = (args.widgets?.length ?? 0) > 0 ||
+        (args.toolCalls?.length ?? 0) > 0 ||
+        reasoning.length > 0;
+    if (args.railNotRecorded === true && hasRailContent) {
+        throw new TypeError('Assistant message metadata cannot be marked railNotRecorded while ' +
+            'carrying rail content. A producer either observed the rail or did not.');
+    }
+    return {
+        turnId: args.turnId,
+        ...(args.widgets !== undefined &&
+            args.widgets.length > 0 && { widgets: [...args.widgets] }),
+        ...(args.toolCalls !== undefined &&
+            args.toolCalls.length > 0 && { toolCalls: [...args.toolCalls] }),
+        ...(reasoning.length > 0 && { reasoning }),
+        ...(args.railNotRecorded === true && { railNotRecorded: true }),
+    };
+}
+//# sourceMappingURL=assistant-message-metadata.js.map

package/dist/session-events/lib/session-event-payloads/assistant-message-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-message-metadata.js","sourceRoot":"","sources":["../../../../src/session-events/lib/session-event-payloads/assistant-message-metadata.ts"],"names":[],"mappings":";;AAuFA,sEA2CC;AA3CD,SAAgB,6BAA6B,CAAC,IAU7C;IACC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,SAAS,CACjB,uEAAuE,CACxE,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC/C,MAAM,cAAc,GAClB,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC;QAC/B,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC;QACjC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IAMvB,IAAI,IAAI,CAAC,eAAe,KAAK,IAAI,IAAI,cAAc,EAAE,CAAC;QACpD,MAAM,IAAI,SAAS,CACjB,oEAAoE;YAClE,wEAAwE,CAC3E,CAAC;IACJ,CAAC;IACD,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS;YAC5B,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5D,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS;YAC9B,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAClE,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;QAG1C,GAAG,CAAC,IAAI,CAAC,eAAe,KAAK,IAAI,IAAI,EAAE,eAAe,EAAE,IAAa,EAAE,CAAC;KACzE,CAAC;AACJ,CAAC"}

package/dist/session-events/lib/session-event-payloads/delta-ledger-policy.d.ts

@@ -0,0 +1,11 @@
+export declare const SESSION_DELTA_LEDGER_FLUSH_CHARS = 240;
+export declare class SessionDeltaLedgerBuffer {
+    private readonly flushChars;
+    private buffered;
+    private firstChunkEmitted;
+    constructor(flushChars?: number);
+    get hasPending(): boolean;
+    push(text: string): string | null;
+    flush(): string | null;
+}
+//# sourceMappingURL=delta-ledger-policy.d.ts.map

package/dist/session-events/lib/session-event-payloads/delta-ledger-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delta-ledger-policy.d.ts","sourceRoot":"","sources":["../../../../src/session-events/lib/session-event-payloads/delta-ledger-policy.ts"],"names":[],"mappings":"AA6BA,eAAO,MAAM,gCAAgC,MAAM,CAAC;AAqBpD,qBAAa,wBAAwB;IAKjC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJ7B,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,iBAAiB,CAAS;gBAGf,UAAU,GAAE,MAAyC;IAUxE,IAAI,UAAU,IAAI,OAAO,CAExB;IASD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAoBjC,KAAK,IAAI,MAAM,GAAG,IAAI;CASvB"}

package/dist/session-events/lib/session-event-payloads/delta-ledger-policy.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionDeltaLedgerBuffer = exports.SESSION_DELTA_LEDGER_FLUSH_CHARS = void 0;
+exports.SESSION_DELTA_LEDGER_FLUSH_CHARS = 240;
+class SessionDeltaLedgerBuffer {
+    flushChars;
+    buffered = '';
+    firstChunkEmitted = false;
+    constructor(flushChars = exports.SESSION_DELTA_LEDGER_FLUSH_CHARS) {
+        this.flushChars = flushChars;
+        if (!Number.isInteger(flushChars) || flushChars <= 0) {
+            throw new RangeError(`SessionDeltaLedgerBuffer flushChars must be a positive integer, received ${String(flushChars)}.`);
+        }
+    }
+    get hasPending() {
+        return this.buffered.length > 0;
+    }
+    push(text) {
+        if (text.length === 0) {
+            return null;
+        }
+        this.buffered += text;
+        const shouldFlush = !this.firstChunkEmitted || this.buffered.length >= this.flushChars;
+        if (!shouldFlush) {
+            return null;
+        }
+        const chunk = this.buffered;
+        this.buffered = '';
+        this.firstChunkEmitted = true;
+        return chunk;
+    }
+    flush() {
+        if (this.buffered.length === 0) {
+            return null;
+        }
+        const chunk = this.buffered;
+        this.buffered = '';
+        this.firstChunkEmitted = true;
+        return chunk;
+    }
+}
+exports.SessionDeltaLedgerBuffer = SessionDeltaLedgerBuffer;
+//# sourceMappingURL=delta-ledger-policy.js.map

package/dist/session-events/lib/session-event-payloads/delta-ledger-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delta-ledger-policy.js","sourceRoot":"","sources":["../../../../src/session-events/lib/session-event-payloads/delta-ledger-policy.ts"],"names":[],"mappings":";;;AA6Ba,QAAA,gCAAgC,GAAG,GAAG,CAAC;AAqBpD,MAAa,wBAAwB;IAKhB;IAJX,QAAQ,GAAG,EAAE,CAAC;IACd,iBAAiB,GAAG,KAAK,CAAC;IAElC,YACmB,aAAqB,wCAAgC;QAArD,eAAU,GAAV,UAAU,CAA2C;QAEtE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,UAAU,CAClB,4EAA4E,MAAM,CAAC,UAAU,CAAC,GAAG,CAClG,CAAC;QACJ,CAAC;IACH,CAAC;IAGD,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAClC,CAAC;IASD,IAAI,CAAC,IAAY;QACf,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC;QACtB,MAAM,WAAW,GACf,CAAC,IAAI,CAAC,iBAAiB,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU,CAAC;QACrE,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAMD,KAAK;QACH,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAvDD,4DAuDC"}

package/dist/session-events/lib/session-event-payloads/error-codes.d.ts

@@ -0,0 +1,41 @@
+export declare enum SessionErrorPhase {
+    Chat = "chat",
+    Resume = "resume",
+    Provisioning = "provisioning"
+}
+export declare enum SessionErrorCode {
+    ThreadBusy = "CANOPY_THREAD_BUSY",
+    TurnFailed = "CANOPY_TURN_FAILED",
+    ConsentResumeFailed = "CANOPY_RESUME_FAILED",
+    ToolIterationLimit = "CANOPY_TOOL_ITERATION_LIMIT",
+    NoTerminalFrame = "CANOPY_NO_TERMINAL_FRAME",
+    WorkerTurnFailed = "SESSION_WORKER_TURN_FAILED",
+    LaunchConfigResolutionFailed = "config_resolution_failed",
+    LaunchSelectionInvalid = "launch_selection_invalid",
+    LaunchWorkerAcquireTimeout = "worker_acquire_timeout",
+    LaunchWorkerAcquireRejected = "worker_acquire_rejected",
+    LaunchWorkerAllocationLost = "worker_allocation_lost",
+    LaunchControlBundleFailed = "control_bundle_failed",
+    LaunchControlBundleRejected = "control_bundle_rejected",
+    LaunchBootstrapFailed = "bootstrap_failed",
+    LaunchBootstrapContractBroken = "bootstrap_contract_broken",
+    LaunchProvisionFailed = "provision_failed",
+    LaunchUnclassifiedFailure = "launch_unclassified",
+    LaunchWorkspaceRestoreFailed = "workspace_restore_failed",
+    LaunchWorkspaceSnapshotCorrupt = "workspace_snapshot_corrupt",
+    LaunchWorkspaceSnapshotRuntimeNewer = "workspace_snapshot_runtime_newer",
+    LaunchWorkingFileSourceMissing = "working_file_source_missing",
+    LaunchFinalizeFailed = "finalize_failed",
+    LaunchFinalizeReadinessFailed = "finalize_readiness_failed",
+    LaunchAgentUnavailable = "agent_unavailable",
+    LaunchDeadlineExceeded = "deadline_exceeded",
+    LaunchIllegalTransition = "illegal_transition",
+    LaunchAbandoned = "launch_abandoned"
+}
+export type SessionTurnErrorCode = SessionErrorCode.ThreadBusy | SessionErrorCode.TurnFailed | SessionErrorCode.ConsentResumeFailed | SessionErrorCode.ToolIterationLimit | SessionErrorCode.NoTerminalFrame | SessionErrorCode.WorkerTurnFailed;
+export declare const SESSION_TURN_ERROR_CODES: readonly [SessionErrorCode.ThreadBusy, SessionErrorCode.TurnFailed, SessionErrorCode.ConsentResumeFailed, SessionErrorCode.ToolIterationLimit, SessionErrorCode.NoTerminalFrame, SessionErrorCode.WorkerTurnFailed];
+export type SessionLaunchErrorCode = SessionErrorCode.LaunchConfigResolutionFailed | SessionErrorCode.LaunchSelectionInvalid | SessionErrorCode.LaunchWorkerAcquireTimeout | SessionErrorCode.LaunchWorkerAcquireRejected | SessionErrorCode.LaunchWorkerAllocationLost | SessionErrorCode.LaunchControlBundleFailed | SessionErrorCode.LaunchControlBundleRejected | SessionErrorCode.LaunchBootstrapFailed | SessionErrorCode.LaunchBootstrapContractBroken | SessionErrorCode.LaunchProvisionFailed | SessionErrorCode.LaunchUnclassifiedFailure | SessionErrorCode.LaunchWorkspaceRestoreFailed | SessionErrorCode.LaunchWorkspaceSnapshotCorrupt | SessionErrorCode.LaunchWorkspaceSnapshotRuntimeNewer | SessionErrorCode.LaunchWorkingFileSourceMissing | SessionErrorCode.LaunchFinalizeFailed | SessionErrorCode.LaunchFinalizeReadinessFailed | SessionErrorCode.LaunchAgentUnavailable | SessionErrorCode.LaunchDeadlineExceeded | SessionErrorCode.LaunchIllegalTransition | SessionErrorCode.LaunchAbandoned;
+export declare const SESSION_LAUNCH_ERROR_CODES: readonly [SessionErrorCode.LaunchConfigResolutionFailed, SessionErrorCode.LaunchSelectionInvalid, SessionErrorCode.LaunchWorkerAcquireTimeout, SessionErrorCode.LaunchWorkerAcquireRejected, SessionErrorCode.LaunchWorkerAllocationLost, SessionErrorCode.LaunchControlBundleFailed, SessionErrorCode.LaunchControlBundleRejected, SessionErrorCode.LaunchBootstrapFailed, SessionErrorCode.LaunchBootstrapContractBroken, SessionErrorCode.LaunchProvisionFailed, SessionErrorCode.LaunchUnclassifiedFailure, SessionErrorCode.LaunchWorkspaceRestoreFailed, SessionErrorCode.LaunchWorkspaceSnapshotCorrupt, SessionErrorCode.LaunchWorkspaceSnapshotRuntimeNewer, SessionErrorCode.LaunchWorkingFileSourceMissing, SessionErrorCode.LaunchFinalizeFailed, SessionErrorCode.LaunchFinalizeReadinessFailed, SessionErrorCode.LaunchAgentUnavailable, SessionErrorCode.LaunchDeadlineExceeded, SessionErrorCode.LaunchIllegalTransition, SessionErrorCode.LaunchAbandoned];
+export declare const SESSION_LAUNCH_FAILURE_CODES: Readonly<Record<string, SessionLaunchErrorCode>>;
+export declare function mapLaunchFailureToSessionErrorCode(launchFailureKind: string): SessionLaunchErrorCode;
+//# sourceMappingURL=error-codes.d.ts.map

package/dist/session-events/lib/session-event-payloads/error-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../../../src/session-events/lib/session-event-payloads/error-codes.ts"],"names":[],"mappings":"AA4BA,oBAAY,iBAAiB;IAC3B,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,YAAY,iBAAiB;CAC9B;AA6BD,oBAAY,gBAAgB;IAM1B,UAAU,uBAAuB;IAMjC,UAAU,uBAAuB;IAUjC,mBAAmB,yBAAyB;IAO5C,kBAAkB,gCAAgC;IAKlD,eAAe,6BAA6B;IAU5C,gBAAgB,+BAA+B;IAkB/C,4BAA4B,6BAA6B;IAOzD,sBAAsB,6BAA6B;IAEnD,0BAA0B,2BAA2B;IAErD,2BAA2B,4BAA4B;IAWvD,0BAA0B,2BAA2B;IAQrD,yBAAyB,0BAA0B;IAenD,2BAA2B,4BAA4B;IAEvD,qBAAqB,qBAAqB;IAa1C,6BAA6B,8BAA8B;IAkB3D,qBAAqB,qBAAqB;IAsB1C,yBAAyB,wBAAwB;IAYjD,4BAA4B,6BAA6B;IAazD,8BAA8B,+BAA+B;IAsB7D,mCAAmC,qCAAqC;IAYxE,8BAA8B,gCAAgC;IAiB9D,oBAAoB,oBAAoB;IAWxC,6BAA6B,8BAA8B;IAM3D,sBAAsB,sBAAsB;IAW5C,sBAAsB,sBAAsB;IAE5C,uBAAuB,uBAAuB;IAK9C,eAAe,qBAAqB;CACrC;AAUD,MAAM,MAAM,oBAAoB,GAC5B,gBAAgB,CAAC,UAAU,GAC3B,gBAAgB,CAAC,UAAU,GAC3B,gBAAgB,CAAC,mBAAmB,GACpC,gBAAgB,CAAC,kBAAkB,GACnC,gBAAgB,CAAC,eAAe,GAChC,gBAAgB,CAAC,gBAAgB,CAAC;AAGtC,eAAO,MAAM,wBAAwB,qNAOe,CAAC;AAUrD,MAAM,MAAM,sBAAsB,GAC9B,gBAAgB,CAAC,4BAA4B,GAC7C,gBAAgB,CAAC,sBAAsB,GACvC,gBAAgB,CAAC,0BAA0B,GAC3C,gBAAgB,CAAC,2BAA2B,GAC5C,gBAAgB,CAAC,0BAA0B,GAC3C,gBAAgB,CAAC,yBAAyB,GAC1C,gBAAgB,CAAC,2BAA2B,GAC5C,gBAAgB,CAAC,qBAAqB,GACtC,gBAAgB,CAAC,6BAA6B,GAC9C,gBAAgB,CAAC,qBAAqB,GACtC,gBAAgB,CAAC,yBAAyB,GAC1C,gBAAgB,CAAC,4BAA4B,GAC7C,gBAAgB,CAAC,8BAA8B,GAC/C,gBAAgB,CAAC,mCAAmC,GACpD,gBAAgB,CAAC,8BAA8B,GAC/C,gBAAgB,CAAC,oBAAoB,GACrC,gBAAgB,CAAC,6BAA6B,GAC9C,gBAAgB,CAAC,sBAAsB,GACvC,gBAAgB,CAAC,sBAAsB,GACvC,gBAAgB,CAAC,uBAAuB,GACxC,gBAAgB,CAAC,eAAe,CAAC;AAGrC,eAAO,MAAM,0BAA0B,66BAsBe,CAAC;AAiBvD,eAAO,MAAM,4BAA4B,EAAE,QAAQ,CACjD,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAKvC,CAAC;AAuBF,wBAAgB,kCAAkC,CAChD,iBAAiB,EAAE,MAAM,GACxB,sBAAsB,CAWxB"}

package/dist/session-events/lib/session-event-payloads/error-codes.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SESSION_LAUNCH_FAILURE_CODES = exports.SESSION_LAUNCH_ERROR_CODES = exports.SESSION_TURN_ERROR_CODES = exports.SessionErrorCode = exports.SessionErrorPhase = void 0;
+exports.mapLaunchFailureToSessionErrorCode = mapLaunchFailureToSessionErrorCode;
+var SessionErrorPhase;
+(function (SessionErrorPhase) {
+    SessionErrorPhase["Chat"] = "chat";
+    SessionErrorPhase["Resume"] = "resume";
+    SessionErrorPhase["Provisioning"] = "provisioning";
+})(SessionErrorPhase || (exports.SessionErrorPhase = SessionErrorPhase = {}));
+var SessionErrorCode;
+(function (SessionErrorCode) {
+    SessionErrorCode["ThreadBusy"] = "CANOPY_THREAD_BUSY";
+    SessionErrorCode["TurnFailed"] = "CANOPY_TURN_FAILED";
+    SessionErrorCode["ConsentResumeFailed"] = "CANOPY_RESUME_FAILED";
+    SessionErrorCode["ToolIterationLimit"] = "CANOPY_TOOL_ITERATION_LIMIT";
+    SessionErrorCode["NoTerminalFrame"] = "CANOPY_NO_TERMINAL_FRAME";
+    SessionErrorCode["WorkerTurnFailed"] = "SESSION_WORKER_TURN_FAILED";
+    SessionErrorCode["LaunchConfigResolutionFailed"] = "config_resolution_failed";
+    SessionErrorCode["LaunchSelectionInvalid"] = "launch_selection_invalid";
+    SessionErrorCode["LaunchWorkerAcquireTimeout"] = "worker_acquire_timeout";
+    SessionErrorCode["LaunchWorkerAcquireRejected"] = "worker_acquire_rejected";
+    SessionErrorCode["LaunchWorkerAllocationLost"] = "worker_allocation_lost";
+    SessionErrorCode["LaunchControlBundleFailed"] = "control_bundle_failed";
+    SessionErrorCode["LaunchControlBundleRejected"] = "control_bundle_rejected";
+    SessionErrorCode["LaunchBootstrapFailed"] = "bootstrap_failed";
+    SessionErrorCode["LaunchBootstrapContractBroken"] = "bootstrap_contract_broken";
+    SessionErrorCode["LaunchProvisionFailed"] = "provision_failed";
+    SessionErrorCode["LaunchUnclassifiedFailure"] = "launch_unclassified";
+    SessionErrorCode["LaunchWorkspaceRestoreFailed"] = "workspace_restore_failed";
+    SessionErrorCode["LaunchWorkspaceSnapshotCorrupt"] = "workspace_snapshot_corrupt";
+    SessionErrorCode["LaunchWorkspaceSnapshotRuntimeNewer"] = "workspace_snapshot_runtime_newer";
+    SessionErrorCode["LaunchWorkingFileSourceMissing"] = "working_file_source_missing";
+    SessionErrorCode["LaunchFinalizeFailed"] = "finalize_failed";
+    SessionErrorCode["LaunchFinalizeReadinessFailed"] = "finalize_readiness_failed";
+    SessionErrorCode["LaunchAgentUnavailable"] = "agent_unavailable";
+    SessionErrorCode["LaunchDeadlineExceeded"] = "deadline_exceeded";
+    SessionErrorCode["LaunchIllegalTransition"] = "illegal_transition";
+    SessionErrorCode["LaunchAbandoned"] = "launch_abandoned";
+})(SessionErrorCode || (exports.SessionErrorCode = SessionErrorCode = {}));
+exports.SESSION_TURN_ERROR_CODES = [
+    SessionErrorCode.ThreadBusy,
+    SessionErrorCode.TurnFailed,
+    SessionErrorCode.ConsentResumeFailed,
+    SessionErrorCode.ToolIterationLimit,
+    SessionErrorCode.NoTerminalFrame,
+    SessionErrorCode.WorkerTurnFailed,
+];
+exports.SESSION_LAUNCH_ERROR_CODES = [
+    SessionErrorCode.LaunchConfigResolutionFailed,
+    SessionErrorCode.LaunchSelectionInvalid,
+    SessionErrorCode.LaunchWorkerAcquireTimeout,
+    SessionErrorCode.LaunchWorkerAcquireRejected,
+    SessionErrorCode.LaunchWorkerAllocationLost,
+    SessionErrorCode.LaunchControlBundleFailed,
+    SessionErrorCode.LaunchControlBundleRejected,
+    SessionErrorCode.LaunchBootstrapFailed,
+    SessionErrorCode.LaunchBootstrapContractBroken,
+    SessionErrorCode.LaunchProvisionFailed,
+    SessionErrorCode.LaunchUnclassifiedFailure,
+    SessionErrorCode.LaunchWorkspaceRestoreFailed,
+    SessionErrorCode.LaunchWorkspaceSnapshotCorrupt,
+    SessionErrorCode.LaunchWorkspaceSnapshotRuntimeNewer,
+    SessionErrorCode.LaunchWorkingFileSourceMissing,
+    SessionErrorCode.LaunchFinalizeFailed,
+    SessionErrorCode.LaunchFinalizeReadinessFailed,
+    SessionErrorCode.LaunchAgentUnavailable,
+    SessionErrorCode.LaunchDeadlineExceeded,
+    SessionErrorCode.LaunchIllegalTransition,
+    SessionErrorCode.LaunchAbandoned,
+];
+exports.SESSION_LAUNCH_FAILURE_CODES = Object.freeze(Object.fromEntries(exports.SESSION_LAUNCH_ERROR_CODES.map((code) => [code, code])));
+function mapLaunchFailureToSessionErrorCode(launchFailureKind) {
+    const code = exports.SESSION_LAUNCH_FAILURE_CODES[launchFailureKind];
+    if (code === undefined) {
+        throw new TypeError(`Launch failure kind "${launchFailureKind}" has no SessionErrorCode. ` +
+            `Add the member to SessionErrorCode's launch family (its wire value ` +
+            `must equal the LaunchFailureKind value) and to ` +
+            `SESSION_LAUNCH_ERROR_CODES.`);
+    }
+    return code;
+}
+//# sourceMappingURL=error-codes.js.map

package/dist/session-events/lib/session-event-payloads/error-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-codes.js","sourceRoot":"","sources":["../../../../src/session-events/lib/session-event-payloads/error-codes.ts"],"names":[],"mappings":";;;AA+cA,gFAaC;AAhcD,IAAY,iBAIX;AAJD,WAAY,iBAAiB;IAC3B,kCAAa,CAAA;IACb,sCAAiB,CAAA;IACjB,kDAA6B,CAAA;AAC/B,CAAC,EAJW,iBAAiB,iCAAjB,iBAAiB,QAI5B;AA6BD,IAAY,gBAkRX;AAlRD,WAAY,gBAAgB;IAM1B,qDAAiC,CAAA;IAMjC,qDAAiC,CAAA;IAUjC,gEAA4C,CAAA;IAO5C,sEAAkD,CAAA;IAKlD,gEAA4C,CAAA;IAU5C,mEAA+C,CAAA;IAkB/C,6EAAyD,CAAA;IAOzD,uEAAmD,CAAA;IAEnD,yEAAqD,CAAA;IAErD,2EAAuD,CAAA;IAWvD,yEAAqD,CAAA;IAQrD,uEAAmD,CAAA;IAenD,2EAAuD,CAAA;IAEvD,8DAA0C,CAAA;IAa1C,+EAA2D,CAAA;IAkB3D,8DAA0C,CAAA;IAsB1C,qEAAiD,CAAA;IAYjD,6EAAyD,CAAA;IAazD,iFAA6D,CAAA;IAsB7D,4FAAwE,CAAA;IAYxE,kFAA8D,CAAA;IAiB9D,4DAAwC,CAAA;IAWxC,+EAA2D,CAAA;IAM3D,gEAA4C,CAAA;IAW5C,gEAA4C,CAAA;IAE5C,kEAA8C,CAAA;IAK9C,wDAAoC,CAAA;AACtC,CAAC,EAlRW,gBAAgB,gCAAhB,gBAAgB,QAkR3B;AAmBY,QAAA,wBAAwB,GAAG;IACtC,gBAAgB,CAAC,UAAU;IAC3B,gBAAgB,CAAC,UAAU;IAC3B,gBAAgB,CAAC,mBAAmB;IACpC,gBAAgB,CAAC,kBAAkB;IACnC,gBAAgB,CAAC,eAAe;IAChC,gBAAgB,CAAC,gBAAgB;CACiB,CAAC;AAkCxC,QAAA,0BAA0B,GAAG;IACxC,gBAAgB,CAAC,4BAA4B;IAC7C,gBAAgB,CAAC,sBAAsB;IACvC,gBAAgB,CAAC,0BAA0B;IAC3C,gBAAgB,CAAC,2BAA2B;IAC5C,gBAAgB,CAAC,0BAA0B;IAC3C,gBAAgB,CAAC,yBAAyB;IAC1C,gBAAgB,CAAC,2BAA2B;IAC5C,gBAAgB,CAAC,qBAAqB;IACtC,gBAAgB,CAAC,6BAA6B;IAC9C,gBAAgB,CAAC,qBAAqB;IACtC,gBAAgB,CAAC,yBAAyB;IAC1C,gBAAgB,CAAC,4BAA4B;IAC7C,gBAAgB,CAAC,8BAA8B;IAC/C,gBAAgB,CAAC,mCAAmC;IACpD,gBAAgB,CAAC,8BAA8B;IAC/C,gBAAgB,CAAC,oBAAoB;IACrC,gBAAgB,CAAC,6BAA6B;IAC9C,gBAAgB,CAAC,sBAAsB;IACvC,gBAAgB,CAAC,sBAAsB;IACvC,gBAAgB,CAAC,uBAAuB;IACxC,gBAAgB,CAAC,eAAe;CACoB,CAAC;AAiB1C,QAAA,4BAA4B,GAErC,MAAM,CAAC,MAAM,CACf,MAAM,CAAC,WAAW,CAChB,kCAA0B,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAc,EAAE,IAAI,CAAC,CAAC,CACvB,CAC5C,CAAC;AAuBF,SAAgB,kCAAkC,CAChD,iBAAyB;IAEzB,MAAM,IAAI,GAAG,oCAA4B,CAAC,iBAAiB,CAAC,CAAC;IAC7D,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,SAAS,CACjB,wBAAwB,iBAAiB,6BAA6B;YACpE,qEAAqE;YACrE,iDAAiD;YACjD,6BAA6B,CAChC,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/session-events/lib/session-event-payloads/index.d.ts

@@ -0,0 +1,8 @@
+export * from './actor';
+export * from './assistant-message-metadata';
+export * from './delta-ledger-policy';
+export * from './error-codes';
+export * from './payloads';
+export * from './tool-call-enums';
+export * from './validation';
+//# sourceMappingURL=index.d.ts.map

package/dist/session-events/lib/session-event-payloads/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/session-events/lib/session-event-payloads/index.ts"],"names":[],"mappings":"AAyBA,cAAc,SAAS,CAAC;AACxB,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC"}

package/dist/session-events/lib/session-event-payloads/index.js

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./actor"), exports);
+__exportStar(require("./assistant-message-metadata"), exports);
+__exportStar(require("./delta-ledger-policy"), exports);
+__exportStar(require("./error-codes"), exports);
+__exportStar(require("./payloads"), exports);
+__exportStar(require("./tool-call-enums"), exports);
+__exportStar(require("./validation"), exports);
+//# sourceMappingURL=index.js.map

package/dist/session-events/lib/session-event-payloads/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/session-events/lib/session-event-payloads/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAyBA,0CAAwB;AACxB,+DAA6C;AAC7C,wDAAsC;AACtC,gDAA8B;AAC9B,6CAA2B;AAC3B,oDAAkC;AAClC,+CAA6B"}

package/dist/session-events/lib/session-event-payloads/payloads.d.ts

@@ -0,0 +1,140 @@
+import { SessionErrorPhase } from './error-codes';
+import { SessionToolCallStatus } from './tool-call-enums';
+import type { SessionEventActor } from './actor';
+import type { SessionLaunchErrorCode, SessionTurnErrorCode } from './error-codes';
+import type { SessionCapabilityOutcome } from './tool-call-enums';
+export declare enum SessionEventMessageRole {
+    User = "user",
+    Assistant = "assistant"
+}
+export type SessionTurnId = string;
+export type SessionMessageSentPayload = {
+    turnId: SessionTurnId;
+    role: SessionEventMessageRole.User;
+    actorId: string;
+    actor: SessionEventActor;
+    contentPreview: string;
+    executor?: string;
+    delegationId?: string;
+};
+export type SessionMessageReceivedPayload = {
+    turnId: SessionTurnId;
+    role: SessionEventMessageRole.Assistant;
+    contentPreview: string;
+};
+export type SessionTextDeltaPayload = {
+    turnId: SessionTurnId;
+    text: string;
+};
+export type SessionReasoningDeltaPayload = {
+    turnId: SessionTurnId;
+    text: string;
+};
+export type SessionTurnErrorPayload = {
+    phase: SessionErrorPhase.Chat;
+    turnId: SessionTurnId;
+    code: SessionTurnErrorCode;
+    message: string;
+    detail?: Record<string, unknown>;
+};
+export type SessionResumeErrorPayload = {
+    phase: SessionErrorPhase.Resume;
+    code: SessionLaunchErrorCode;
+    message: string;
+    agentSlug?: string;
+};
+export type SessionProvisioningErrorPayload = {
+    phase: SessionErrorPhase.Provisioning;
+    code: SessionLaunchErrorCode;
+    message: string;
+};
+export type SessionErrorPayload = SessionTurnErrorPayload | SessionResumeErrorPayload | SessionProvisioningErrorPayload;
+export type SessionToolCallCapabilityStart = {
+    ref: string;
+    idempotencyKey?: string;
+};
+export type SessionToolCallCapabilityResult = SessionToolCallCapabilityStart & {
+    outcome: SessionCapabilityOutcome;
+    auditId: string;
+};
+export type SessionToolCallStartedPayload = {
+    turnId: SessionTurnId;
+    toolName: string;
+    status: SessionToolCallStatus.Started;
+    toolCallId?: string;
+    summary?: string;
+    capabilityRef?: string;
+    idempotencyKey?: string;
+    delegateSessionId?: string;
+    vista?: Record<string, unknown>;
+};
+export type SessionToolCallCompletedPayload = {
+    turnId: SessionTurnId;
+    toolName: string;
+    status: SessionToolCallStatus.Completed | SessionToolCallStatus.Error;
+    toolCallId?: string;
+    summary?: string;
+    errorMessage?: string;
+    capabilityRef?: string;
+    idempotencyKey?: string;
+    capabilityOutcome?: SessionCapabilityOutcome;
+    auditId?: string;
+    delegateSessionId?: string;
+    vista?: Record<string, unknown>;
+};
+export declare function buildMessageSentPayload(args: {
+    turnId: SessionTurnId;
+    actorId: string;
+    actor: SessionEventActor;
+    content: string;
+    executor?: string;
+    delegationId?: string;
+}): SessionMessageSentPayload;
+export declare function buildMessageReceivedPayload(args: {
+    turnId: SessionTurnId;
+    content: string;
+}): SessionMessageReceivedPayload;
+export declare function buildTextDeltaPayload(args: {
+    turnId: SessionTurnId;
+    text: string;
+}): SessionTextDeltaPayload;
+export declare function buildReasoningDeltaPayload(args: {
+    turnId: SessionTurnId;
+    text: string;
+}): SessionReasoningDeltaPayload;
+export declare function buildSessionTurnErrorPayload(args: {
+    turnId: SessionTurnId;
+    code: SessionTurnErrorCode;
+    message: string;
+    detail?: Record<string, unknown>;
+}): SessionTurnErrorPayload;
+export declare function buildSessionResumeErrorPayload(args: {
+    code: SessionLaunchErrorCode;
+    message: string;
+    agentSlug?: string;
+}): SessionResumeErrorPayload;
+export declare function buildSessionProvisioningErrorPayload(args: {
+    code: SessionLaunchErrorCode;
+    message: string;
+}): SessionProvisioningErrorPayload;
+export declare function buildToolCallStartedPayload(args: {
+    turnId: SessionTurnId;
+    toolName: string;
+    toolCallId?: string;
+    summary?: string;
+    capability?: SessionToolCallCapabilityStart;
+    delegateSessionId?: string;
+    vista?: Record<string, unknown>;
+}): SessionToolCallStartedPayload;
+export declare function buildToolCallCompletedPayload(args: {
+    turnId: SessionTurnId;
+    toolName: string;
+    status: SessionToolCallStatus.Completed | SessionToolCallStatus.Error;
+    toolCallId?: string;
+    summary?: string;
+    errorMessage?: string;
+    capability?: SessionToolCallCapabilityResult;
+    delegateSessionId?: string;
+    vista?: Record<string, unknown>;
+}): SessionToolCallCompletedPayload;
+//# sourceMappingURL=payloads.d.ts.map

package/dist/session-events/lib/session-event-payloads/payloads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payloads.d.ts","sourceRoot":"","sources":["../../../../src/session-events/lib/session-event-payloads/payloads.ts"],"names":[],"mappings":"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"}

package/dist/session-events/lib/session-event-payloads/payloads.js

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionEventMessageRole = void 0;
+exports.buildMessageSentPayload = buildMessageSentPayload;
+exports.buildMessageReceivedPayload = buildMessageReceivedPayload;
+exports.buildTextDeltaPayload = buildTextDeltaPayload;
+exports.buildReasoningDeltaPayload = buildReasoningDeltaPayload;
+exports.buildSessionTurnErrorPayload = buildSessionTurnErrorPayload;
+exports.buildSessionResumeErrorPayload = buildSessionResumeErrorPayload;
+exports.buildSessionProvisioningErrorPayload = buildSessionProvisioningErrorPayload;
+exports.buildToolCallStartedPayload = buildToolCallStartedPayload;
+exports.buildToolCallCompletedPayload = buildToolCallCompletedPayload;
+const agent_session_types_1 = require("../agent-session.types");
+const safe_truncate_1 = require("../safe-truncate");
+const error_codes_1 = require("./error-codes");
+const tool_call_enums_1 = require("./tool-call-enums");
+var SessionEventMessageRole;
+(function (SessionEventMessageRole) {
+    SessionEventMessageRole["User"] = "user";
+    SessionEventMessageRole["Assistant"] = "assistant";
+})(SessionEventMessageRole || (exports.SessionEventMessageRole = SessionEventMessageRole = {}));
+function requireNonEmpty(value, field) {
+    if (value.length === 0) {
+        throw new TypeError(`Session event payload field "${field}" must be a non-empty string.`);
+    }
+    return value;
+}
+function buildMessageSentPayload(args) {
+    if ((args.executor === undefined) !== (args.delegationId === undefined)) {
+        throw new TypeError('Session event payload fields "executor" and "delegationId" must be given together or not at all.');
+    }
+    return {
+        turnId: requireNonEmpty(args.turnId, 'turnId'),
+        role: SessionEventMessageRole.User,
+        actorId: requireNonEmpty(args.actorId, 'actorId'),
+        actor: {
+            subjectKind: args.actor.subjectKind,
+            subjectRef: requireNonEmpty(args.actor.subjectRef, 'actor.subjectRef'),
+            displayName: requireNonEmpty(args.actor.displayName, 'actor.displayName'),
+            ...(args.actor.avatarUrl !== undefined && {
+                avatarUrl: args.actor.avatarUrl,
+            }),
+        },
+        contentPreview: (0, safe_truncate_1.safeTruncate)(args.content, agent_session_types_1.SESSION_EVENT_CONTENT_PREVIEW_LIMITS[agent_session_types_1.SessionEventType.MessageSent]),
+        ...(args.executor !== undefined &&
+            args.delegationId !== undefined && {
+            executor: requireNonEmpty(args.executor, 'executor'),
+            delegationId: requireNonEmpty(args.delegationId, 'delegationId'),
+        }),
+    };
+}
+function buildMessageReceivedPayload(args) {
+    return {
+        turnId: requireNonEmpty(args.turnId, 'turnId'),
+        role: SessionEventMessageRole.Assistant,
+        contentPreview: (0, safe_truncate_1.safeTruncate)(args.content, agent_session_types_1.SESSION_EVENT_CONTENT_PREVIEW_LIMITS[agent_session_types_1.SessionEventType.MessageReceived]),
+    };
+}
+function buildTextDeltaPayload(args) {
+    return {
+        turnId: requireNonEmpty(args.turnId, 'turnId'),
+        text: requireNonEmpty(args.text, 'text'),
+    };
+}
+function buildReasoningDeltaPayload(args) {
+    return {
+        turnId: requireNonEmpty(args.turnId, 'turnId'),
+        text: requireNonEmpty(args.text, 'text'),
+    };
+}
+function buildSessionTurnErrorPayload(args) {
+    return {
+        phase: error_codes_1.SessionErrorPhase.Chat,
+        turnId: requireNonEmpty(args.turnId, 'turnId'),
+        code: args.code,
+        message: requireNonEmpty(args.message, 'message'),
+        ...(args.detail !== undefined && { detail: args.detail }),
+    };
+}
+function buildSessionResumeErrorPayload(args) {
+    return {
+        phase: error_codes_1.SessionErrorPhase.Resume,
+        code: args.code,
+        message: requireNonEmpty(args.message, 'message'),
+        ...(args.agentSlug !== undefined && {
+            agentSlug: requireNonEmpty(args.agentSlug, 'agentSlug'),
+        }),
+    };
+}
+function buildSessionProvisioningErrorPayload(args) {
+    return {
+        phase: error_codes_1.SessionErrorPhase.Provisioning,
+        code: args.code,
+        message: requireNonEmpty(args.message, 'message'),
+    };
+}
+function buildToolCallStartedPayload(args) {
+    return {
+        turnId: requireNonEmpty(args.turnId, 'turnId'),
+        toolName: requireNonEmpty(args.toolName, 'toolName'),
+        status: tool_call_enums_1.SessionToolCallStatus.Started,
+        ...(args.toolCallId !== undefined && {
+            toolCallId: requireNonEmpty(args.toolCallId, 'toolCallId'),
+        }),
+        ...(args.summary !== undefined && {
+            summary: requireNonEmpty(args.summary, 'summary'),
+        }),
+        ...(args.capability !== undefined && {
+            capabilityRef: requireNonEmpty(args.capability.ref, 'capability.ref'),
+            ...(args.capability.idempotencyKey !== undefined && {
+                idempotencyKey: requireNonEmpty(args.capability.idempotencyKey, 'capability.idempotencyKey'),
+            }),
+        }),
+        ...(args.delegateSessionId !== undefined && {
+            delegateSessionId: requireNonEmpty(args.delegateSessionId, 'delegateSessionId'),
+        }),
+        ...(args.vista !== undefined && { vista: args.vista }),
+    };
+}
+function buildToolCallCompletedPayload(args) {
+    return {
+        turnId: requireNonEmpty(args.turnId, 'turnId'),
+        toolName: requireNonEmpty(args.toolName, 'toolName'),
+        status: args.status,
+        ...(args.toolCallId !== undefined && {
+            toolCallId: requireNonEmpty(args.toolCallId, 'toolCallId'),
+        }),
+        ...(args.summary !== undefined && {
+            summary: requireNonEmpty(args.summary, 'summary'),
+        }),
+        ...(args.errorMessage !== undefined && {
+            errorMessage: requireNonEmpty(args.errorMessage, 'errorMessage'),
+        }),
+        ...(args.capability !== undefined && {
+            capabilityRef: requireNonEmpty(args.capability.ref, 'capability.ref'),
+            capabilityOutcome: args.capability.outcome,
+            auditId: requireNonEmpty(args.capability.auditId, 'capability.auditId'),
+            ...(args.capability.idempotencyKey !== undefined && {
+                idempotencyKey: requireNonEmpty(args.capability.idempotencyKey, 'capability.idempotencyKey'),
+            }),
+        }),
+        ...(args.delegateSessionId !== undefined && {
+            delegateSessionId: requireNonEmpty(args.delegateSessionId, 'delegateSessionId'),
+        }),
+        ...(args.vista !== undefined && { vista: args.vista }),
+    };
+}
+//# sourceMappingURL=payloads.js.map

package/dist/session-events/lib/session-event-payloads/payloads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payloads.js","sourceRoot":"","sources":["../../../../src/session-events/lib/session-event-payloads/payloads.ts"],"names":[],"mappings":"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"}

package/dist/session-events/lib/session-event-payloads/tool-call-enums.d.ts

@@ -0,0 +1,11 @@
+export declare enum SessionToolCallStatus {
+    Started = "started",
+    Completed = "completed",
+    Error = "error"
+}
+export declare enum SessionCapabilityOutcome {
+    Allowed = "allowed",
+    Denied = "denied",
+    AwaitingApproval = "awaiting-approval"
+}
+//# sourceMappingURL=tool-call-enums.d.ts.map

package/dist/session-events/lib/session-event-payloads/tool-call-enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call-enums.d.ts","sourceRoot":"","sources":["../../../../src/session-events/lib/session-event-payloads/tool-call-enums.ts"],"names":[],"mappings":"AAyBA,oBAAY,qBAAqB;IAC/B,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,KAAK,UAAU;CAChB;AAeD,oBAAY,wBAAwB;IAClC,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,gBAAgB,sBAAsB;CACvC"}

package/dist/session-events/lib/session-event-payloads/tool-call-enums.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionCapabilityOutcome = exports.SessionToolCallStatus = void 0;
+var SessionToolCallStatus;
+(function (SessionToolCallStatus) {
+    SessionToolCallStatus["Started"] = "started";
+    SessionToolCallStatus["Completed"] = "completed";
+    SessionToolCallStatus["Error"] = "error";
+})(SessionToolCallStatus || (exports.SessionToolCallStatus = SessionToolCallStatus = {}));
+var SessionCapabilityOutcome;
+(function (SessionCapabilityOutcome) {
+    SessionCapabilityOutcome["Allowed"] = "allowed";
+    SessionCapabilityOutcome["Denied"] = "denied";
+    SessionCapabilityOutcome["AwaitingApproval"] = "awaiting-approval";
+})(SessionCapabilityOutcome || (exports.SessionCapabilityOutcome = SessionCapabilityOutcome = {}));
+//# sourceMappingURL=tool-call-enums.js.map

package/dist/session-events/lib/session-event-payloads/tool-call-enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call-enums.js","sourceRoot":"","sources":["../../../../src/session-events/lib/session-event-payloads/tool-call-enums.ts"],"names":[],"mappings":";;;AAyBA,IAAY,qBAIX;AAJD,WAAY,qBAAqB;IAC/B,4CAAmB,CAAA;IACnB,gDAAuB,CAAA;IACvB,wCAAe,CAAA;AACjB,CAAC,EAJW,qBAAqB,qCAArB,qBAAqB,QAIhC;AAeD,IAAY,wBAIX;AAJD,WAAY,wBAAwB;IAClC,+CAAmB,CAAA;IACnB,6CAAiB,CAAA;IACjB,kEAAsC,CAAA;AACxC,CAAC,EAJW,wBAAwB,wCAAxB,wBAAwB,QAInC"}