@botonic/shared 2.23.0

package/CHANGELOG.md

@@ -0,0 +1,240 @@
+## 2.23.0 (2026-03-23)
+
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
+
+## 2.22.1 (2026-03-19)
+
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
+
+## 2.22.0 (2026-03-16)
+
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
+
+## 2.21.0 (2026-03-16)
+
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
+
+## 2.20.0 (2026-03-13)
+
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
+
+## 2.19.0 (2026-03-12)
+
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
+
+## 2.18.0 (2026-03-04)
+
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
+
+## 2.17.0 (2026-03-02)
+
+### 🚀 Features
+
+- botonic working with v2 input format ([#660](https://github.com/metis-ai/hubtype-product/pull/660))
+
+### ❤️ Thank You
+
+- Marc Rabat @vanbasten17
+
+## 2.16.0 (2026-02-23)
+
+### 🚀 Features
+
+- add legacy input to v2 input adapter and missing defs ([#680](https://github.com/metis-ai/hubtype-product/pull/680))
+- add BotonicContext (will substitute BotContext) ([#677](https://github.com/metis-ai/hubtype-product/pull/677))
+
+### ❤️ Thank You
+
+- Marc Rabat @vanbasten17
+
+## 2.15.0 (2026-02-13)
+
+### 🚀 Features
+
+- update types for whatsapp template ([#658](https://github.com/metis-ai/hubtype-product/pull/658))
+
+### ❤️ Thank You
+
+- Oriol Raventós @Iru89
+
+## 2.14.0 (2026-02-05)
+
+### 🩹 Fixes
+
+- **botonic:** align tsconfig outDir with Nx outputPath to fix TS6305 errors ([#594](https://github.com/metis-ai/hubtype-product/pull/594))
+- reference as carousel instead of carrousel ([#542](https://github.com/metis-ai/hubtype-product/pull/542))
+
+### ❤️ Thank You
+
+- Marc Rabat @vanbasten17
+
+## 2.13.4 (2026-02-02)
+
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
+
+## 2.13.3 (2026-01-30)
+
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
+
+## 2.13.2 (2026-01-30)
+
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
+
+## 2.13.1 (2026-01-30)
+
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
+
+## 2.13.0 (2026-01-29)
+
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
+
+## 2.12.0 (2026-01-28)
+
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
+
+## 2.11.5 (2026-01-28)
+
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
+
+## 2.11.4 (2026-01-28)
+
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
+
+## 2.11.3 (2026-01-28)
+
+### 🩹 Fixes
+
+- update entrypoints to use .js and .d.ts extensions for module and types ([#552](https://github.com/metis-ai/hubtype-product/pull/552))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+
+## 2.11.2 (2026-01-21)
+
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
+
+## 2.11.1 (2026-01-21)
+
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
+
+## 2.11.0 (2026-01-21)
+
+### 🚀 Features
+
+- use webview contents hook in botonic webviews package #BLT-2039 ([#510](https://github.com/metis-ai/hubtype-product/pull/510))
+
+### ❤️ Thank You
+
+- Marc Rabat @vanbasten17
+
+## 2.10.1 (2026-01-19)
+
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
+
+## 2.10.0 (2026-01-18)
+
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
+
+## 2.9.1 (2026-01-17)
+
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
+
+## 2.9.0 (2026-01-17)
+
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
+
+## 2.8.1 (2026-01-16)
+
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
+
+## 2.8.0 (2026-01-16)
+
+### 🚀 Features
+
+- bump version ([#521](https://github.com/metis-ai/hubtype-product/pull/521))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+
+## 2.7.1 (2026-01-16)
+
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
+
+## 2.7.0 (2026-01-15)
+
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
+
+## 2.6.0 (2025-12-09)
+
+### 🚀 Features
+
+- plugin-flow-builder enable SmartIntents and add tests ([#469](https://github.com/metis-ai/hubtype-product/pull/469))
+
+### ❤️ Thank You
+
+- Oriol Raventós @Iru89
+
+## 2.5.0 (2025-12-09)
+
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
+
+## 2.4.1 (2025-12-08)
+
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
+
+## 2.4.0 (2025-12-05)
+
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
+
+## 2.3.3 (2025-12-04)
+
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
+
+## 2.3.2 (2025-12-04)
+
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
+
+## 2.3.1 (2025-12-04)
+
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
+
+## 2.3.0 (2025-12-04)
+
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
+
+## 2.2.1 (2025-12-04)
+
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
+
+## 2.2.0 (2025-12-04)
+
+### 🚀 Features
+
+- receiving unsent messages through pusher auth ([#453](https://github.com/metis-ai/hubtype-product/pull/453))
+- add support for all whatsapp outputs in domain, factories and whatsapp flow content fields ([#434](https://github.com/metis-ai/hubtype-product/pull/434))
+- implement locale detection and user data handling in webchat, refactor user-related methods for consistency #BLT-2045 ([#435](https://github.com/metis-ai/hubtype-product/pull/435))
+- fine tuning botonic release #BLT-2010 ([#428](https://github.com/metis-ai/hubtype-product/pull/428))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+- Marc Rabat @vanbasten17
+
+## 2.1.0 (2025-12-02)
+
+### 🚀 Features
+
+- add support for all whatsapp outputs in domain, factories and whatsapp flow content fields ([#434](https://github.com/metis-ai/hubtype-product/pull/434))
+- implement locale detection and user data handling in webchat, refactor user-related methods for consistency #BLT-2045 ([#435](https://github.com/metis-ai/hubtype-product/pull/435))
+- fine tuning botonic release #BLT-2010 ([#428](https://github.com/metis-ai/hubtype-product/pull/428))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+- Marc Rabat @vanbasten17
+
+## 2.0.1-alpha.0 (2025-11-27)
+
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.

package/README.md

@@ -0,0 +1,9 @@
+# shared
+
+## Building
+
+Run `nx build shared` to build the library.
+
+## Running unit tests
+
+Run `nx test shared` to execute the unit tests via [Vitest](https://vitest.dev/).

package/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@botonic/shared",
+  "version": "2.23.0",
+  "type": "module",
+  "module": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "dependencies": {
+    "tslib": "^2.3.0",
+    "uuid": "^11.1.0",
+    "vite": "7.1.9"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./src/index.js"
+}

package/src/index.d.ts

@@ -0,0 +1 @@
+export * from './lib';

package/src/index.js

@@ -0,0 +1,2 @@
+export * from './lib';
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/botonic/shared/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAA"}

package/src/lib/ai-agents-types.d.ts

@@ -0,0 +1,69 @@
+interface BaseAiAgentMessage {
+    type: 'text' | 'textWithButtons' | 'carousel' | 'exit';
+}
+export interface Button {
+    text: string;
+    payload?: string;
+    url?: string;
+}
+export interface TextMessage extends BaseAiAgentMessage {
+    type: 'text';
+    content: {
+        text: string;
+    };
+}
+export interface TextWithButtonsMessage extends BaseAiAgentMessage {
+    type: 'textWithButtons';
+    content: {
+        text: string;
+        buttons: Button[];
+    };
+}
+interface CarouselElement {
+    title: string;
+    subtitle: string;
+    image: string;
+    button: Button;
+}
+export interface CarouselMessage extends BaseAiAgentMessage {
+    type: 'carousel';
+    content: {
+        text?: string;
+        elements: CarouselElement[];
+    };
+}
+export interface ExitMessage extends BaseAiAgentMessage {
+    type: 'exit';
+}
+export type OutputMessage = TextMessage | TextWithButtonsMessage | CarouselMessage | ExitMessage;
+export type AgenticOutputMessage = Exclude<OutputMessage, ExitMessage>;
+export interface ToolExecution {
+    toolName: string;
+    toolArguments: Record<string, any>;
+    knowledgebaseSourcesIds?: string[];
+    knowledgebaseChunksIds?: string[];
+}
+export interface RunResult {
+    messages: AgenticOutputMessage[];
+    toolsExecuted: ToolExecution[];
+    memoryLength: number;
+    exit: boolean;
+    error: boolean;
+    inputGuardrailsTriggered: string[];
+    outputGuardrailsTriggered: string[];
+}
+export type InferenceResponse = RunResult;
+export interface GuardrailRule {
+    name: string;
+    description: string;
+}
+export interface AiAgentArgs {
+    name: string;
+    instructions: string;
+    activeTools?: {
+        name: string;
+    }[];
+    inputGuardrailRules?: GuardrailRule[];
+    sourceIds?: string[];
+}
+export {};

package/src/lib/ai-agents-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ai-agents-types.js.map

package/src/lib/ai-agents-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-agents-types.js","sourceRoot":"","sources":["../../../../../../libs/botonic/shared/src/lib/ai-agents-types.ts"],"names":[],"mappings":""}

package/src/lib/domain/botonic/exceptions.d.ts

@@ -0,0 +1,7 @@
+declare class BotonicException extends Error {
+    constructor(message: string);
+}
+export declare class BotonicMissingAttachmentUrlOrContentException extends BotonicException {
+    constructor();
+}
+export {};

package/src/lib/domain/botonic/exceptions.js

@@ -0,0 +1,12 @@
+class BotonicException extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'BotonicException';
+    }
+}
+export class BotonicMissingAttachmentUrlOrContentException extends BotonicException {
+    constructor() {
+        super('Missing attachment_url or attachment_content');
+    }
+}
+//# sourceMappingURL=exceptions.js.map

package/src/lib/domain/botonic/exceptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.js","sourceRoot":"","sources":["../../../../../../../../libs/botonic/shared/src/lib/domain/botonic/exceptions.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAiB,SAAQ,KAAK;IAClC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAA;IAChC,CAAC;CACF;AAED,MAAM,OAAO,6CAA8C,SAAQ,gBAAgB;IACjF;QACE,KAAK,CAAC,8CAA8C,CAAC,CAAA;IACvD,CAAC;CACF"}

package/src/lib/domain/botonic/index.d.ts

@@ -0,0 +1,9 @@
+export * from '../server/botonic-context';
+export * from '../server/botonic-context/botonic-context-input';
+export * from '../server/botonic-context/botonic-context-session';
+export * from './inputs';
+export * from './legacy';
+export * from './metadata';
+export * from './outputs';
+export * from './types';
+export * from './whatsapp-outputs';

package/src/lib/domain/botonic/index.js

@@ -0,0 +1,10 @@
+export * from '../server/botonic-context';
+export * from '../server/botonic-context/botonic-context-input';
+export * from '../server/botonic-context/botonic-context-session';
+export * from './inputs';
+export * from './legacy';
+export * from './metadata';
+export * from './outputs';
+export * from './types';
+export * from './whatsapp-outputs';
+//# sourceMappingURL=index.js.map

package/src/lib/domain/botonic/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../libs/botonic/shared/src/lib/domain/botonic/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAA;AACzC,cAAc,iDAAiD,CAAA;AAC/D,cAAc,mDAAmD,CAAA;AACjE,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA;AACvB,cAAc,oBAAoB,CAAA"}

package/src/lib/domain/botonic/inputs.d.ts

@@ -0,0 +1,48 @@
+import { BotonicAudioData, BotonicContactData, BotonicDocumentData, BotonicImageData, BotonicLocationData, BotonicPostbackData, BotonicTextData, BotonicTypingEventData, BotonicVideoData, MessageType } from './types';
+export { MessageType };
+export type InputMessageType = MessageType.Text | MessageType.Postback | MessageType.Audio | MessageType.Image | MessageType.Video | MessageType.Document | MessageType.Location | MessageType.Contact | MessageType.TypingEvent | MessageType.Contact;
+export type InputMessageTypeMap = {
+    [MessageType.Text]: BotonicTextData;
+    [MessageType.Postback]: BotonicPostbackData;
+    [MessageType.Audio]: BotonicAudioData;
+    [MessageType.Image]: BotonicImageData;
+    [MessageType.Video]: BotonicVideoData;
+    [MessageType.Document]: BotonicDocumentData;
+    [MessageType.Location]: BotonicLocationData;
+    [MessageType.Contact]: BotonicContactData;
+    [MessageType.TypingEvent]: BotonicTypingEventData;
+    [MessageType.Contact]: BotonicContactData;
+};
+export declare abstract class BotonicInput<T extends keyof InputMessageTypeMap = keyof InputMessageTypeMap> {
+    readonly type: T;
+    readonly data: InputMessageTypeMap[T];
+    constructor(type: T, data: InputMessageTypeMap[T]);
+}
+export declare class BotonicInputText extends BotonicInput<MessageType.Text> {
+    constructor(data: BotonicTextData);
+}
+export declare class BotonicInputPostback extends BotonicInput<MessageType.Postback> {
+    constructor(data: BotonicPostbackData);
+}
+export declare class BotonicInputAudio extends BotonicInput<MessageType.Audio> {
+    constructor(data: BotonicAudioData);
+}
+export declare class BotonicInputImage extends BotonicInput<MessageType.Image> {
+    constructor(data: BotonicImageData);
+}
+export declare class BotonicInputVideo extends BotonicInput<MessageType.Video> {
+    constructor(data: BotonicVideoData);
+}
+export declare class BotonicInputDocument extends BotonicInput<MessageType.Document> {
+    constructor(data: BotonicDocumentData);
+}
+export declare class BotonicInputLocation extends BotonicInput<MessageType.Location> {
+    constructor(data: BotonicLocationData);
+}
+export declare class BotonicInputContact extends BotonicInput<MessageType.Contact> {
+    constructor(data: BotonicContactData);
+}
+export declare class BotonicInputTypingEvent extends BotonicInput<MessageType.TypingEvent> {
+    constructor(data: BotonicTypingEventData);
+}
+export type BotonicInputType = BotonicInputText | BotonicInputPostback | BotonicInputAudio | BotonicInputImage | BotonicInputVideo | BotonicInputDocument | BotonicInputLocation | BotonicInputContact | BotonicInputTypingEvent | BotonicInputContact;

package/src/lib/domain/botonic/inputs.js

@@ -0,0 +1,60 @@
+import { MessageType, } from './types';
+// Re-export for convenience
+export { MessageType };
+// ============================================================================
+// BOTONIC INPUT PROTOCOL (discriminated union with classes)
+// ============================================================================
+// Base class for type safety using mapped types
+export class BotonicInput {
+    constructor(type, data) {
+        this.type = type;
+        this.data = data;
+    }
+}
+// Concrete implementations
+export class BotonicInputText extends BotonicInput {
+    constructor(data) {
+        super(MessageType.Text, data);
+    }
+}
+export class BotonicInputPostback extends BotonicInput {
+    constructor(data) {
+        super(MessageType.Postback, data);
+    }
+}
+export class BotonicInputAudio extends BotonicInput {
+    constructor(data) {
+        super(MessageType.Audio, data);
+    }
+}
+export class BotonicInputImage extends BotonicInput {
+    constructor(data) {
+        super(MessageType.Image, data);
+    }
+}
+export class BotonicInputVideo extends BotonicInput {
+    constructor(data) {
+        super(MessageType.Video, data);
+    }
+}
+export class BotonicInputDocument extends BotonicInput {
+    constructor(data) {
+        super(MessageType.Document, data);
+    }
+}
+export class BotonicInputLocation extends BotonicInput {
+    constructor(data) {
+        super(MessageType.Location, data);
+    }
+}
+export class BotonicInputContact extends BotonicInput {
+    constructor(data) {
+        super(MessageType.Contact, data);
+    }
+}
+export class BotonicInputTypingEvent extends BotonicInput {
+    constructor(data) {
+        super(MessageType.TypingEvent, data);
+    }
+}
+//# sourceMappingURL=inputs.js.map

package/src/lib/domain/botonic/inputs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputs.js","sourceRoot":"","sources":["../../../../../../../../libs/botonic/shared/src/lib/domain/botonic/inputs.ts"],"names":[],"mappings":"AAAA,OAAO,EAUL,WAAW,GACZ,MAAM,SAAS,CAAA;AAEhB,4BAA4B;AAC5B,OAAO,EAAE,WAAW,EAAE,CAAA;AAqCtB,+EAA+E;AAC/E,4DAA4D;AAC5D,+EAA+E;AAE/E,gDAAgD;AAChD,MAAM,OAAgB,YAAY;IAGhC,YACkB,IAAO,EACP,IAA4B;QAD5B,SAAI,GAAJ,IAAI,CAAG;QACP,SAAI,GAAJ,IAAI,CAAwB;IAC3C,CAAC;CACL;AAED,2BAA2B;AAC3B,MAAM,OAAO,gBAAiB,SAAQ,YAA8B;IAClE,YAAY,IAAqB;QAC/B,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,YAAkC;IAC1E,YAAY,IAAyB;QACnC,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;IACnC,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,YAA+B;IACpE,YAAY,IAAsB;QAChC,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IAChC,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,YAA+B;IACpE,YAAY,IAAsB;QAChC,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IAChC,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,YAA+B;IACpE,YAAY,IAAsB;QAChC,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IAChC,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,YAAkC;IAC1E,YAAY,IAAyB;QACnC,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;IACnC,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,YAAkC;IAC1E,YAAY,IAAyB;QACnC,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;IACnC,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,YAAiC;IACxE,YAAY,IAAwB;QAClC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;IAClC,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,YAAqC;IAChF,YAAY,IAA4B;QACtC,KAAK,CAAC,WAAW,CAAC,WAAW,EAAE,IAAI,CAAC,CAAA;IACtC,CAAC;CACF"}

package/src/lib/domain/botonic/legacy/index.d.ts

@@ -0,0 +1,2 @@
+export * from './input-adapter';
+export * from './types';

package/src/lib/domain/botonic/legacy/index.js

@@ -0,0 +1,3 @@
+export * from './input-adapter';
+export * from './types';
+//# sourceMappingURL=index.js.map

package/src/lib/domain/botonic/legacy/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../../libs/botonic/shared/src/lib/domain/botonic/legacy/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,SAAS,CAAA"}

package/src/lib/domain/botonic/legacy/input-adapter.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Adapter: convert RequestInputLegacy (ImpMsg flat) → RequestInputV2 (v2 BotonicInput).
+ * normalizeToV2Input is used inside CoreBot.input(); not exported to handlers.
+ * Constructs inputs using BotonicInput* and *Data classes where supported.
+ * Aligns with RequestInputLegacy (legacy) vs RequestInputV2 (v2) format: flat fields → nested data,
+ * message_id → provider_id, attachment_data → attachment_content, empty strings → null where specified.
+ */
+import type { RequestInputV2 } from '../../server/botonic-context/botonic-context-input';
+import { RequestInputLegacy } from './types';
+/**
+ * Returns true if the payload looks like InputLegacy (flat data string, payload at top level)
+ * rather than Input (nested data object).
+ */
+export declare function isInputLegacy(payload: unknown): payload is RequestInputLegacy;
+/**
+ * Converts InputLegacy to Input (v2) for the pipeline.
+ * Used at lambda handler level so CoreBot always receives Input.
+ */
+export declare function legacyInputToInput(legacy: RequestInputLegacy): RequestInputV2;
+/**
+ * Normalizes request input to RequestInputV2.
+ * If legacy shape, converts with legacyInputToInput; otherwise returns as RequestInputV2.
+ * Used inside CoreBot.input(); not exposed to handlers.
+ */
+export declare function normalizeToV2Input(requestInput: RequestInputLegacy | RequestInputV2): RequestInputV2;