pika-shared 1.4.1 → 1.4.3

package/dist/types/chatbot/chatbot-types.d.mts

@@ -148,6 +148,15 @@ interface ChatSession<T extends RecordOrUndef = undefined> {
     shareRevokedDate?: string;
     /** If set to 'mock', this session is used for integration testing purposes. */
     testType?: 'mock';
+    /**
+     * The source of the converse request. Defaults to 'user'.  The composite key chat_app_sk looks like this:
+     *
+     * ${chatAppId}#${source}#${updateDate}
+     *
+     * The source in the composite key here will only ever be either `user` or `component`.  If this attribute's value is missing or is `user` or `component-as-user`,
+     * then the composite key will be set to `user` so when we query on behalf of the user, we will get all sessions for that user.
+     */
+    source: ConverseSource;
 }
 /**
  * Convenience type for updating a session with the last analyzed message id and insights s3 url.
@@ -660,15 +669,19 @@ interface AgentInstructionChatAppOverridableFeature {
     completeExampleInstructionLine?: string;
     jsonOnlyImperativeInstructionEnabled: boolean;
     jsonOnlyImperativeInstructionLine?: string;
+    includeTypescriptBackedOutputFormattingRequirements: boolean;
+    typescriptBackedOutputFormattingRequirements?: string;
 }
 interface InstructionAssistanceConfig {
     outputFormattingRequirements: string;
     tagInstructions?: string;
     completeExampleInstructionLine: string;
     jsonOnlyImperativeInstructionLine: string;
+    typescriptBackedOutputFormattingRequirements: string;
 }
 interface TagsChatAppOverridableFeature {
     tagsEnabled: TagDefinitionLite[];
+    tagsDisabled: TagDefinitionLite[];
 }
 type ChatAppOverridableFeaturesForConverseFn = Omit<ChatAppOverridableFeatures, 'chatDisclaimerNotice' | 'traces' | 'logout' | 'suggestions' | 'promptInputFieldLabel' | 'uiCustomization' | 'fileUpload'>;
 /**
@@ -772,17 +785,65 @@ interface ConverseRequest extends BaseRequestData {
      * If provided, this will be used to determine the invocation mode of the converse request.
      *
      * If 'chat-app', then the converse request is a chat app request.
+     *
      * If 'direct-agent-invoke', then the converse request is a direct agent invoke request and is not
      * in the context of a chat app.  Since we are adding mode after the fact, if mode is provided
      * and it doesn't match what we expect, we will throw an error (chat-app requires that chatAppId is provided
      * and direct-agent-invoke requires that chatAppId is not provided).
      *
+     * If 'chat-app-component', then the converse request is coming from a chat app component and is not
+     * being initiated by the end user.  This is used to allow the component to invoke the agent directly
+     * without the need for the end user to initiate the request.  These do not show up as user-created sessions
+     * when we query for the users's sessions in this chat app.
+     *
+     * They are associated with the user and the chat app and the component in question.  When this mode is used,
+     * the caller must provide the chatAppId and the agentId and the complete "tag" that represents the component doing the calling.
+     * Tag definitions have both a scope and a tag.  Further, the `componentAgentInstructionName` must also provide so we
+     * know which set of instructions from the tag definition to use.
+     *
      * If invocationMode is not provided, uses the presence or absence of chatAppId to determine the mode (if chatAppId
      * is provided, then it's a chat app request, otherwise it's a direct agent invoke request).
      */
     invocationMode?: ConverseInvocationMode;
+    /**
+     * When invocationMode is 'chat-app-component', then this is the requiredconfiguration for the chat app component invocation.
+     */
+    chatAppComponentConfig?: ChatAppComponentConfig;
+    /**
+     * The source of the converse request. Defaults to 'user'.  The composite key chat_app_sk looks like this:
+     *
+     * ${chatAppId}#${source}#${updateDate}
+     *
+     * The source in the composite key here will only ever be either `user` or `component`.  If this attribute's value is missing or is `user` or `component-as-user`,
+     * then the composite key will be set to `user` so when we query on behalf of the user, we will get all sessions for that user.
+     *
+     * If 'user', then the converse request is coming from the user.
+     * If 'component-as-user', then the converse request is coming from a component acting as a user and thus sessions should show up in the user's sessions list.
+     * If 'component', then the converse request is coming from a component.
+     */
+    source: ConverseSource;
 }
-declare const ConverseInvocationModes: readonly ["chat-app", "direct-agent-invoke"];
+declare const ConverseSource: readonly ["user", "component-as-user", "component"];
+type ConverseSource = (typeof ConverseSource)[number];
+/**
+ * This is the configuration for a chat app component invocation to the converse lambda function.
+ */
+interface ChatAppComponentConfig {
+    /**
+     * The name of the set of instructions to use for the component invocation.
+     * This is the key in the `componentAgentInstructionsMd` record in the tag definition as in
+     *
+     * `tagDef.componentAgentInstructionsMd[componentAgentInstructionName]`
+     */
+    componentAgentInstructionName: string;
+    /**
+     * The tag definition that represents the component doing the calling.  We use this to look up the
+     * right tag definition so we can get the correct instructions.  Note that you will get an exception
+     * if the tag definition isn't associated with this chat app or isn't marked as `chat-app-global`.
+     */
+    componentTagDefinition: TagDefinitionLite;
+}
+declare const ConverseInvocationModes: readonly ["chat-app", "direct-agent-invoke", "chat-app-component"];
 type ConverseInvocationMode = (typeof ConverseInvocationModes)[number];
 interface ChatTitleUpdateRequest extends BaseRequestData {
     /** If provided, this will be used as the title for the session */
@@ -871,6 +932,49 @@ interface SetChatUserPrefsResponse {
     prefs?: UserPrefs;
     error?: string;
 }
+/**
+ * Arbitrary key-value storage for web component state.
+ * Scoped to user + component (scope.tag).
+ * Max 400KB per component.
+ */
+type UserWidgetData = Record<string, unknown>;
+interface GetUserWidgetDataRequest {
+    scope: string;
+    tag: string;
+}
+interface GetUserWidgetDataResponse {
+    success: boolean;
+    userId: string;
+    scope: string;
+    tag: string;
+    data?: UserWidgetData;
+    error?: string;
+}
+interface SetUserWidgetDataRequest {
+    scope: string;
+    tag: string;
+    data: UserWidgetData;
+    partial?: boolean;
+}
+interface SetUserWidgetDataResponse {
+    success: boolean;
+    userId: string;
+    scope: string;
+    tag: string;
+    data: UserWidgetData;
+    error?: string;
+}
+interface DeleteUserWidgetDataRequest {
+    scope: string;
+    tag: string;
+}
+interface DeleteUserWidgetDataResponse {
+    success: boolean;
+    userId: string;
+    scope: string;
+    tag: string;
+    error?: string;
+}
 interface ChatUserAddOrUpdateResponse {
     success: boolean;
     user: ChatUser<RecordOrUndef>;
@@ -1124,7 +1228,11 @@ type AgentDefinitionForCreate = Omit<AgentDefinition, 'version' | 'createdAt' |
  *
  * If you use this you must provide an agentId so we can match up what's there already with what is being provided.
  * If you provide tools then you must provide a toolId for each tool so we can match up what's there already with what is being provided.
- * You may either provide agent.toolIds or tools but not both.
+ *
+ * Three patterns are supported:
+ * 1. tools only: Define new tools (create/update)
+ * 2. agent.toolIds only: Reference existing tools by ID
+ * 3. Both tools AND agent.toolIds: Mixed approach - define new tools while referencing existing ones
  */
 interface AgentDataRequest {
     /**
@@ -2077,6 +2185,14 @@ interface AgentInstructionAssistanceFeature {
         enabled: boolean;
         line?: string;
     };
+    /**
+     * This is only used for component invocation instructions.  If true, a line will be added to the component invocation
+     * instructions that instructs the agent to only respond with valid JSON conforming to the TypeScript interface defined in the <output_schema> block.
+     */
+    includeTypescriptBackedOutputFormattingRequirements?: {
+        enabled: boolean;
+        line?: string;
+    };
 }
 type SegmentType = 'text' | 'tag';
 /**
@@ -2988,10 +3104,9 @@ interface TagsSiteFeature {
      */
     tagsEnabled?: TagDefinitionLite[];
     /**
-     * The tag definitions that are prohibited by default.  If not provided, then no tag definitions are prohibited.
-     * Chat apps may not override this list.
+     * Global tags are enabled by default.  Turn them off here if you don't want them.
      */
-    tagsProhibited?: TagDefinitionLite[];
+    tagsDisabled?: TagDefinitionLite[];
 }
 /**
  * Configure whether the session insights feature is enabled.  When turned on, Pika will
@@ -3031,10 +3146,17 @@ interface SessionInsightsOpenSearchConfig {
 interface TagsFeatureForChatApp extends Feature {
     featureId: 'tags';
     /**
-     * The tag definitions that are enabled by default.  If not provided, then no tag definitions are enabled.
-     * Each chat app can override this list by providing its own list of tagsEnabled in its chat app config.
+     * The tag definitions that are explicitly enabled for this chat app.
+     * These are chat-app specific tags (usageMode='chat-app') that must be explicitly enabled.
+     * Global tags (usageMode='global') are automatically included unless listed in tagsDisabled.
      */
     tagsEnabled?: TagDefinitionLite[];
+    /**
+     * Global tag definitions that should be disabled for this chat app.
+     * Only applies to global tags (usageMode='global').
+     * Use this to exclude specific global tags that you don't want available.
+     */
+    tagsDisabled?: TagDefinitionLite[];
 }
 interface SessionInsightsFeatureForChatApp extends Feature {
     featureId: 'sessionInsights';
@@ -3264,6 +3386,63 @@ interface NameValueDescTriple<T> {
 interface ComponentTagDefinition<T extends TagDefinitionWidget> {
     definition: TagDefinition<T>;
 }
+declare const TAG_DEFINITION_STATUSES: readonly ["enabled", "disabled", "retired"];
+type TagDefinitionStatus = (typeof TAG_DEFINITION_STATUSES)[number];
+interface SpotlightContextConfig {
+    enabled: boolean;
+    isDefault?: boolean;
+    displayOrder?: number;
+}
+interface InlineContextConfig {
+    enabled: boolean;
+}
+interface DialogContextConfig {
+    enabled: boolean;
+    size?: 'small' | 'medium' | 'large' | 'fullscreen';
+}
+interface CanvasContextConfig {
+    enabled: boolean;
+}
+/**
+ * Tag definition for widgets that have static context enabled.
+ * Static widgets can run initialization code (like registering title bar actions)
+ * when the chat app loads. They can also have other rendering contexts for visual UI.
+ */
+type StaticWidgetTagDefinition = TagDefinition<TagDefinitionWidgetWebComponent> & {
+    renderingContexts: {
+        static: StaticContextConfig;
+        spotlight?: SpotlightContextConfig;
+        inline?: InlineContextConfig;
+        dialog?: DialogContextConfig;
+        canvas?: CanvasContextConfig;
+    };
+};
+/**
+ * The static context is used to render a static component that doesn't render visually but is used to run code that needs to be run once.
+ * For example, you might want to run a code snippet that puts an icon in the title bar of the chat app.
+ */
+interface StaticContextConfig {
+    enabled: boolean;
+    /**
+     * If provided, the static context container will be removed from the DOM after this many milliseconds.
+     * If not provided, the container stays in the DOM (hidden) indefinitely.
+     *
+     * Use this when the static component only needs to run initialization code and doesn't need to
+     * persist in the DOM afterwards.
+     *
+     * Example: 1000 (remove after 1 second)
+     */
+    shutDownAfterMs?: number;
+}
+declare const WIDGET_RENDERING_CONTEXT_TYPES: readonly ["spotlight", "inline", "dialog", "canvas", "static"];
+type WidgetRenderingContextType = (typeof WIDGET_RENDERING_CONTEXT_TYPES)[number];
+interface WidgetRenderingContexts {
+    spotlight?: SpotlightContextConfig;
+    inline?: InlineContextConfig;
+    dialog?: DialogContextConfig;
+    canvas?: CanvasContextConfig;
+    static?: StaticContextConfig;
+}
 interface TagDefinition<T extends TagDefinitionWidget> {
     /**
      * The tag type this definition is for.  If the tag is one of the built-in pika tags, then you are overriding the built-in pika tag instructions
@@ -3331,8 +3510,34 @@ interface TagDefinition<T extends TagDefinitionWidget> {
     dontCacheThis?: boolean;
     /** You must be explicit about whether this tag is a widget or not and if so what kind. */
     widget: T;
-    /** If true, the tag will be disabled and not available to the LLM or tools. */
-    disabled?: boolean;
+    /**
+     * Determines how this tag can be used across chat apps.
+     * - 'global': Tag is available to all chat apps by default (unless explicitly disabled)
+     * - 'chat-app': Tag must be explicitly enabled in a chat app's configuration to be available
+     *
+     * REQUIRED: Must be explicitly set.
+     * Built-in Pika tags (scope='pika') are typically 'global', while custom tags are typically 'chat-app'.
+     */
+    usageMode: TagDefinitionUsageMode;
+    /**
+     * The status of this tag definition.
+     * - 'enabled': Tag is active and available for use
+     * - 'disabled': Tag is temporarily disabled
+     * - 'retired': Tag is permanently retired/deprecated
+     *
+     * REQUIRED: Must be explicitly set. If not provided, defaults to 'enabled'.
+     * This is critical for the GSI to properly index all records.
+     */
+    status: TagDefinitionStatus;
+    /**
+     * Rendering contexts this widget supports.  Required.  Must have at least one context.
+     */
+    renderingContexts: WidgetRenderingContexts;
+    /**
+     * Indicates this is a mock/demo tag definition for development/testing purposes.
+     * Mock tags may be filtered out in production environments.
+     */
+    isMock?: boolean;
     /**
      * If `canBeGeneratedByLlm` is true, you must provide instructions for the LLM to generate the tag since chat app/agent builders can choose
      * to have the instructions injected into the agent instructions prompt for a given tag.
@@ -3360,6 +3565,64 @@ interface TagDefinition<T extends TagDefinitionWidget> {
      * The XML wrapper ensures that your formatting doesn't interfere with the overall instruction structure.
      */
     llmInstructionsMd?: string;
+    /**
+     * If the code that backs your tag definition, whether compile in or a separate web component, has need to
+     * directly invoke the agent to get assistance from an LLM, then you can create named sets of instructions
+     * so when the component makes the request for help from the agent, the agent will know which set of instructions
+     * to use.  For example, let's say you have a Spotlight component defined as a tag definition that needs to
+     * on startup get a list of cities and then make a request to the agent to get the weather for the list of cities.
+     * The default agent instructions for the agent probably woudn't return the weather information in a structured
+     * manner.  So, you'd want to create a new set of instructions for the agent to use, with the same set of tools,
+     * that the component code would cause to be used by asking for a direct agent invocation initiated from the
+     * code in the browser and that references the name of the instructions to use that will retrieve the
+     * weather as structured json let's say and that includes the list of cities you want the weather for.
+     *
+     * That way, the server side converse lambda function that responds to direct agent invocation requests will know
+     * which set of instructions to use.  It's not a good idea to allow the client to define the entire set of instructions.
+     *
+     * It's too risky.  So, here's an example of a good set of instructions that you could use.  Note that the input value
+     * sent from the browser webcomponent in this case would just be a list of locations that we would append to the bottom
+     * of the following.  Also note that the {{typescript-backed-output-formatting-requirements}} placeholder is used to
+     * inject the typescript backed output formatting requirements which are stored in S3.
+     *
+     * ```markdown
+     * You are **WeatherDataLookupAgent**, a highly skilled assistant used to turn a list of locations into weather data.
+     * Below you will find the list of locations you need to look up the weather for using the associated tools provided.
+     *
+     * <output_schema>
+     * interface WeatherData {
+     *     // ISO 8601 date string of when this data was generated
+     *     date: string;
+     *
+     *     // the weather data  itself
+     *     locations: LocationWeatherInfo[];
+     * }
+     *
+     * interface LocationWeatherInfo {
+     *     // The name of the location in a human readable format
+     *     locationName: string;
+     *
+     *     // longitude for the location. Optional just in case you can't get it.
+     *     lon?: string;
+     *
+     *     // latitude for the location.  Optional just in case you can't get it.
+     *     lat?: string;
+     *
+     *     // The temperature in celsius
+     *     tempC: string;
+     *
+     *     // The temperature in fahrenheit
+     *     tempF: string;
+     * }
+     * </output_schema>
+     *
+     * {{typescript-backed-output-formatting-requirements}}
+     * ```
+     *
+     * The key in the record is referred to as the "componentAgentInstructionName" and the value is the markdown string of the instructions.
+     *
+     */
+    componentAgentInstructionsMd?: Record<string, string>;
     /** The user id of the user who created the tag definition */
     createdBy: string;
     /** The user id of the user who last updated the tag definition */
@@ -3373,7 +3636,43 @@ interface TagDefinitionLite {
     tag: string;
     scope: string;
 }
-type TagDefinitionForCreateOrUpdate<T extends TagDefinitionWidget = TagDefinitionWidget> = Omit<TagDefinition<T>, 'createdBy' | 'lastUpdatedBy' | 'createDate' | 'lastUpdate'>;
+/**
+ * Web component definition for create/update operations.
+ * The s3Bucket field is omitted because it's filled in by the backend.
+ */
+interface TagDefinitionWebComponentForCreateOrUpdate extends Omit<TagDefinitionWebComponent, 's3'> {
+    s3?: {
+        /** Must follow pattern: wc/${scope}/fileName.js.gz */
+        s3Key: string;
+    };
+}
+/**
+ * Widget definition for web components in create/update operations.
+ * Uses TagDefinitionWebComponentForCreateOrUpdate which omits the backend-managed s3Bucket field.
+ */
+interface TagDefinitionWidgetWebComponentForCreateOrUpdate extends TagDefinitionWidgetBase {
+    type: 'web-component';
+    webComponent: TagDefinitionWebComponentForCreateOrUpdate;
+}
+/**
+ * Union type for all widget types in create/update operations.
+ * Uses the specialized web component type that omits backend-managed fields.
+ */
+type TagDefinitionWidgetForCreateOrUpdate = TagDefinitionWidgetPassThrough | TagDefinitionWidgetPikaCompiledIn | TagDefinitionWidgetCustomCompiledIn | TagDefinitionWidgetWebComponentForCreateOrUpdate;
+/**
+ * Tag definition for create/update operations.
+ * Omits backend-managed fields and uses TagDefinitionWidgetForCreateOrUpdate which excludes
+ * backend-managed fields from nested structures (like s3Bucket in web components).
+ *
+ * The usageMode field is optional and defaults to 'chat-app' if not provided.
+ */
+type TagDefinitionForCreateOrUpdate<T extends TagDefinitionWidgetForCreateOrUpdate = TagDefinitionWidgetForCreateOrUpdate> = Omit<TagDefinition<TagDefinitionWidget>, 'createdBy' | 'lastUpdatedBy' | 'createDate' | 'lastUpdate' | 'widget' | 'usageMode'> & {
+    widget: T;
+    usageMode?: TagDefinitionUsageMode;
+};
+declare const TAG_DEFINITION_USAGE_MODES: readonly ["global", "chat-app"];
+type TagDefinitionUsageMode = (typeof TAG_DEFINITION_USAGE_MODES)[number];
+declare const TAG_DEFINITION_WIDGET_TYPES: readonly ["pass-through", "pika-compiled-in", "custom-compiled-in", "web-component"];
 /**
  * Pika compiled-in components are those defined as part of the compiled svelte front end code in `apps/pika-chat/src/lib/client/features/chat/message-segments/default-components/index.ts`.
  *
@@ -3384,7 +3683,7 @@ type TagDefinitionForCreateOrUpdate<T extends TagDefinitionWidget = TagDefinitio
  *
  * Pass through means we will simply pass this through and not process the tag in any way.  This is useful for tags that are not meant to be rendered in the front end.
  */
-type TagDefinitionWidgetType = 'pass-through' | 'pika-compiled-in' | 'custom-compiled-in' | 'web-component';
+type TagDefinitionWidgetType = (typeof TAG_DEFINITION_WIDGET_TYPES)[number];
 interface TagDefinitionWidgetPikaCompiledIn extends TagDefinitionWidgetBase {
     type: 'pika-compiled-in';
 }
@@ -3405,15 +3704,150 @@ interface TagDefinitionWidgetBase {
     type: TagDefinitionWidgetType;
 }
 type TagDefinitionWidget = TagDefinitionWidgetPassThrough | TagDefinitionWidgetPikaCompiledIn | TagDefinitionWidgetCustomCompiledIn | TagDefinitionWidgetWebComponent;
-type TagWebComponentEncoding = 'gzip+base64';
+type TagWebComponentEncoding = 'gzip';
+/**
+ * Preset dialog size options for web component widgets.
+ * - 'fullscreen': 95vw x 90vh (default)
+ * - 'large': 85vw x 80vh
+ * - 'medium': 70vw x 70vh
+ * - 'small': 50vw x 50vh
+ */
+type WidgetDialogSizePreset = 'fullscreen' | 'large' | 'medium' | 'small';
+/**
+ * Custom dimensions for dialog sizing.
+ * Values must be viewport-relative units (vh, vw, vmin, vmax) or percentages.
+ * Pixel values are not supported to ensure responsive behavior.
+ *
+ * Examples:
+ * - { width: "80vw", height: "70vh" }
+ * - { width: "90%", height: "85%" }
+ */
+interface WidgetDialogSizeCustom {
+    /**
+     * Dialog width as viewport-relative unit or percentage.
+     * Examples: "80vw", "90%", "85vw"
+     */
+    width?: string;
+    /**
+     * Dialog height as viewport-relative unit or percentage.
+     * Examples: "70vh", "80%", "60vh"
+     */
+    height?: string;
+}
+/**
+ * Sizing configuration for dialog rendering context.
+ * Can be either a preset size or custom dimensions.
+ */
+type WidgetDialogSizing = WidgetDialogSizePreset | WidgetDialogSizeCustom;
+/**
+ * Sizing configuration for inline rendering context.
+ * Inline widgets appear within the chat message flow.
+ */
+interface WidgetInlineSizing {
+    /**
+     * Widget height for inline rendering.
+     * Supports any valid CSS height value, or "auto" to grow to content height.
+     * Defaults to "400px" if not specified.
+     *
+     * Special values:
+     * - "auto": Widget grows to fit its content height (no fixed height constraint)
+     *
+     * Fixed height examples: "400px", "50vh", "500px", "30rem"
+     */
+    height?: string;
+    /**
+     * Widget width for inline rendering.
+     * Reserved for future use. Currently, inline widgets always fill available width.
+     *
+     * Examples: "100%", "80vw", "600px"
+     */
+    width?: string;
+}
+/**
+ * Sizing configuration for web component widgets across different rendering contexts.
+ * Allows widget authors to control how their widget is sized in different visual contexts.
+ */
+interface WidgetSizing {
+    /**
+     * Sizing for dialog (modal) rendering context.
+     * When a widget is opened in a dialog, this controls its dimensions.
+     *
+     * Defaults to 'fullscreen' (95vw x 90vh) if not specified.
+     */
+    dialog?: WidgetDialogSizing;
+    /**
+     * Sizing for inline rendering context.
+     * When a widget is rendered inline within a chat message.
+     *
+     * Defaults to { height: "400px" } if not specified.
+     */
+    inline?: WidgetInlineSizing;
+}
 interface TagDefinitionWebComponent {
-    type: 'web-component';
-    s3Bucket: string;
-    s3Key: string;
+    /**
+     * Direct URL to the web component JavaScript file.
+     * Use this if the component is hosted externally (CDN, separate server, etc.)
+     *
+     * Either `url` OR `s3` must be provided, but not both.
+     */
+    url?: string;
+    /**
+     * S3 location of the web component JavaScript file in the Pika S3 bucket.
+     * If provided, the system will serve it via /api/webcomponent/:scope/:tag
+     *
+     * Either `url` OR `s3` must be provided, but not both.
+     */
+    s3?: {
+        /** Must be the Pika system S3 bucket (retrieved from SSM parameter) */
+        s3Bucket: string;
+        /** Must follow pattern: wc/${scope}/fileName.js.gz */
+        s3Key: string;
+    };
+    /**
+     * The actual custom element name that the JavaScript file defines.
+     * This is the name used in customElements.define() in the JavaScript file.
+     *
+     * If not provided, defaults to `${scope}.${tag}` (e.g., "pika.mock-spotlight-1").
+     *
+     * Use this when:
+     * - The JavaScript file defines a custom element with a different name than the tag
+     * - Multiple tag definitions share the same JavaScript file that defines one custom element
+     * - A JavaScript bundle file defines multiple custom elements
+     *
+     * Examples:
+     * - "hello-world" for a file that calls customElements.define("hello-world", ...)
+     * - "my-widget" for a file that calls customElements.define("my-widget", ...)
+     */
+    customElementName?: string;
+    /**
+     * Optional sizing configuration for this widget across different rendering contexts.
+     *
+     * If not provided, defaults are:
+     * - dialog: 'fullscreen' (95vw x 90vh)
+     * - inline: { height: "400px" }
+     *
+     * Examples:
+     * ```typescript
+     * // Preset dialog size
+     * sizing: { dialog: 'medium', inline: { height: '300px' } }
+     *
+     * // Custom dialog size
+     * sizing: { dialog: { width: '80vw', height: '60vh' } }
+     *
+     * // Only specify inline height
+     * sizing: { inline: { height: '500px' } }
+     * ```
+     */
+    sizing?: WidgetSizing;
     encoding: TagWebComponentEncoding;
     mediaType: 'application/javascript';
     encodedSizeBytes: number;
-    /** Hash of EXACT S3 object bytes (post-encoding) */
+    /**
+     * Hash of the GZIPPED file bytes as stored in S3 (NOT the decompressed JavaScript).
+     * This hash is used for integrity validation when serving the file from S3.
+     * When uploading to S3: hash = SHA256(gzippedBytes).toBase64()
+     * When serving: compare stored hash to SHA256(gzippedBytesFromS3).toBase64()
+     */
     encodedSha256Base64: string;
 }
 interface TagDefinitionCreateOrUpdateRequest {
@@ -3430,26 +3864,31 @@ interface TagDefinitionCreateOrUpdateResponse {
     tagDefinition: TagDefinition<TagDefinitionWidget>;
 }
 /**
- * You don't have to provide anything in this request if you don't want to.  If you don't pass in tagsDesire...
+ * Search for tag definitions with two primary modes:
  *
- * If this is being used in the context of admin API then
- * you will get all tag definitions.  If this is being used in the context of a chat app user, then you will get all tag defs not disabled.
+ * MODE 1 - Get specific tags (optionally including globals):
+ *   - Pass tagsDesired array for specific tags to retrieve
+ *   - Set includeGlobal=true to also include all global tags
+ *   - Uses primary key lookup (scope + tag) for specified tags
+ *   - Uses GSI (scope-status-index) for global tags if includeGlobal=true
+ *   - Returns requested tags + global tags (if includeGlobal=true)
  *
+ * MODE 2 - Get all tags:
+ *   - Don't pass tagsDesired or includeGlobal
+ *   - Scans entire table with pagination
+ *   - Returns all tag definitions
  *
- * If you do pass in tagsDesired, then our dynamodb query will scan the table for all rows (should be performant since there won't be more than a
- * few hundred tag defs at absolute most) and then will filter them to only those that match the tagsDesired.  Note if this is being called in the
- * context of a chat app user, then you will get all tag defs not disabled even if you pass in tagsDesired.
- *
- * Instructions can be big so unless you ask for them, we will not return them.
+ * If used in admin context, returns all tag definitions (including disabled/retired).
+ * If used in chat app context, filters to only 'enabled' status.
  */
 interface TagDefinitionSearchRequest {
+    /** Specific tags to retrieve by scope+tag */
     tagsDesired?: TagDefinitionLite[];
-    /** If not true, instructions will not be returned to save space. */
+    /** If true, also includes all global tags (usageMode='global') in addition to tagsDesired */
+    includeGlobal?: boolean;
+    /** If not true, instructions will not be returned to save space */
     includeInstructions?: boolean;
-    /**
-     * If you pass in a pagination token, we will return the next page of tag defs. Be sure to include your original
-     * request (tagsDesired, includeInstructions) if they were present in the original request.
-     */
+    /** Pagination token for continued queries */
     paginationToken?: Record<string, any> | undefined;
 }
 interface TagDefinitionSearchResponse {
@@ -3599,5 +4038,198 @@ interface ShowToastOptions {
 type ShowToastFn = (message: string, options: ShowToastOptions) => void;
 declare const ShareSessionStateList: readonly ["disable-share-feature", "shared-by-me", "shared-by-someone-else", "not-shared"];
 type ShareSessionState = (typeof ShareSessionStateList)[number];
+/**
+ * Options for invokeAgentAsComponent() method
+ */
+interface InvokeAgentAsComponentOptions {
+    /**
+     * Callback for streaming traces from the agent
+     */
+    onTrace?: (trace: any) => void;
+    /**
+     * Callback for progress updates (partial JSON text as it streams)
+     */
+    onProgress?: (partialText: string) => void;
+    /**
+     * Callback for agent thinking/rationale
+     */
+    onThinking?: (rationale: string) => void;
+    /**
+     * Callback for tool invocations
+     */
+    onToolCall?: (toolCall: {
+        name: string;
+        params: any;
+    }) => void;
+    /**
+     * Whether to include full traces in callbacks (default: false)
+     */
+    includeTraces?: boolean;
+    /**
+     * Request timeout in milliseconds (default: 60000)
+     */
+    timeout?: number;
+    /**
+     * The source of the converse request. Defaults to 'user'.  The composite key chat_app_sk looks like this:
+     *
+     * ${chatAppId}#${source}#${updateDate}
+     *
+     * The source in the composite key here will only ever be either `user` or `component`.  If this attribute's value is missing or is `user` or `component-as-user`,
+     * then the composite key will be set to `user` so when we query on behalf of the user, we will get all sessions for that user.
+     */
+    source: ConverseSource;
+}
+/**
+ * Action button that appears in the widget's chrome (title bar, toolbar, etc.)
+ *
+ * @example
+ * ```js
+ * const action: WidgetAction = {
+ *   id: 'refresh',
+ *   title: 'Refresh data',
+ *   iconSvg: '<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20">...</svg>',
+ *   callback: async () => { await fetchData(); }
+ * };
+ * ```
+ */
+interface WidgetAction {
+    /** Unique identifier for this action */
+    id: string;
+    /** Tooltip/label for the action (also button text in dialog context) */
+    title: string;
+    /** SVG markup string for the icon (e.g., from extractIconSvg() helper) */
+    iconSvg: string;
+    /** Whether action is currently disabled */
+    disabled?: boolean;
+    /** If true, renders as default/prominent button (used in dialog context) */
+    primary?: boolean;
+    /** Handler when clicked */
+    callback: () => void | Promise<void>;
+}
+/**
+ * A single action button that will appear at the top of the chat app in the title bar or
+ * that will appear in a button menu that pops up when the user clicks the title bar action button.
+ *
+ * @example
+ * ```js
+ * const action: ChatAppAction = {
+ *   id: 'refresh',
+ *   title: 'Refresh',
+ *   iconSvg: '<svg>...</svg>',
+ *   callback: () => refresh()
+ * };
+ * ```
+ */
+interface ChatAppAction {
+    /** Unique identifier for this action */
+    id: string;
+    /** Discriminator for the type */
+    type: 'action';
+    /** Tooltip or menu item description for the action */
+    title: string;
+    /** SVG markup string for the icon (e.g., from extractIconSvg() helper) */
+    iconSvg: string;
+    /** Whether action is currently disabled */
+    disabled?: boolean;
+    /** Handler when clicked */
+    callback: () => void | Promise<void>;
+}
+/**
+ * The only reason to use this is to get a title for the action group.
+ */
+interface ChatAppActionGroup {
+    /** Discriminator for the type */
+    type: 'group';
+    /** Title of the action group. The whole point of an action group is to get a title above the group. */
+    title: string;
+    /** Actions to display in the group */
+    actions: (ChatAppAction | 'separator')[];
+}
+/**
+ * The elements that can be displayed in a ChatAppActionMenu.
+ */
+type ChatAppActionMenuElements = ChatAppActionGroup | ChatAppAction | 'separator';
+/**
+ * Widgets can register a single icon button or icon button with a menu that will appear at the top of the chat app in the title bar.
+ */
+interface ChatAppActionMenu {
+    /** Unique identifier for this action */
+    id: string;
+    /** Tooltip/label for the action (also button text in dialog context) */
+    title: string;
+    /** SVG markup string for the icon (e.g., from extractIconSvg() helper) */
+    iconSvg: string;
+    /** Whether the action menu is currently disabled */
+    disabled?: boolean;
+    /**
+     * Actions to display in the menu
+     * Here are some common examples:
+     * - [
+     *     { type: 'action', id: 'refresh', title: 'Refresh', iconSvg: '<svg>...</svg>', callback: () => refresh() },
+     *     'separator',
+     *     { id: 'settings', title: 'Settings', iconSvg: '<svg>...</svg>', callback: () => showSettings() }
+     *   ]
+     * - [
+     *     { type: 'group', title: 'Settings', actions: [
+     *       { type: 'action', id: 'refresh', title: 'Refresh', iconSvg: '<svg>...</svg>', callback: () => refresh() },
+     *       'separator',
+     *       { type: 'action', id: 'settings', title: 'Settings', iconSvg: '<svg>...</svg>', callback: () => showSettings() }
+     *     ] }
+     *   ]
+     */
+    actions: ChatAppActionMenuElements[];
+}
+/**
+ * Metadata that widgets register with the parent app
+ *
+ * @example
+ * ```js
+ * const metadata: WidgetMetadata = {
+ *   title: 'My Widget',
+ *   iconSvg: '<svg>...</svg>',
+ *   iconColor: '#001F3F',
+ *   actions: [
+ *     { id: 'refresh', title: 'Refresh', iconSvg: '<svg>...</svg>', callback: () => refresh() }
+ *   ]
+ * };
+ * ```
+ */
+interface WidgetMetadata {
+    /** Widget title shown in chrome */
+    title: string;
+    /** Optional icon SVG markup for the widget title */
+    iconSvg?: string;
+    /** Optional color for the widget icon (hex, rgb, or CSS color name) */
+    iconColor?: string;
+    /** Optional action buttons */
+    actions?: WidgetAction[];
+    /** Optional loading status */
+    loadingStatus?: {
+        loading: boolean;
+        loadingMsg?: string;
+    };
+}
+/**
+ * Internal state tracked for each widget instance
+ */
+interface WidgetMetadataState extends WidgetMetadata {
+    /** Unique instance ID for this widget */
+    instanceId: string;
+    /** Widget scope (e.g., 'weather', 'pika') */
+    scope: string;
+    /** Widget tag (e.g., 'favorite-cities') */
+    tag: string;
+    /** Rendering context (spotlight, canvas, dialog, inline) */
+    renderingContext: WidgetRenderingContextType;
+}
+interface IUserWidgetDataStoreState {
+    readonly initialized: boolean;
+    readonly data: UserWidgetData | undefined;
+    readonly showToast: ShowToastFn;
+    refreshDataFromServer(): Promise<void>;
+    getValue<T>(key: string): Promise<T | undefined>;
+    setValue(key: string, value: unknown): Promise<void>;
+    deleteValue(key: string): Promise<void>;
+}
 
-export { type AccessRule, type AccessRules, Accurate, AccurateWithStatedAssumptions, AccurateWithUnstatedAssumptions, type AddChatSessionFeedbackAdminRequest, type AddChatSessionFeedbackRequest, type AddChatSessionFeedbackResponse, type AgentAndTools, type AgentDataRequest, type AgentDataResponse, type AgentDefinition, type AgentDefinitionForCreate, type AgentDefinitionForIdempotentCreateOrUpdate, type AgentDefinitionForUpdate, type AgentFramework, type AgentInstructionAssistanceFeature, type AgentInstructionAssistanceFeatureForChatApp, type AgentInstructionChatAppOverridableFeature, type ApplyRulesAs, type AssistantMessageContent, type AssistantRationaleContent, type Attachment, type AuthenticateResult, type AuthenticatedUser, type BaseRequestData, type BaseStackConfig, type ChatApp, type ChatAppDataRequest, type ChatAppDataResponse, type ChatAppFeature, type ChatAppForCreate, type ChatAppForIdempotentCreateOrUpdate, type ChatAppForUpdate, type ChatAppLite, type ChatAppMode, type ChatAppOverridableFeatures, type ChatAppOverridableFeaturesForConverseFn, type ChatAppOverride, type ChatAppOverrideDdb, type ChatAppOverrideForCreateOrUpdate, type ChatDisclaimerNoticeFeature, type ChatDisclaimerNoticeFeatureForChatApp, type ChatMessage, type ChatMessageFile, type ChatMessageFileBase, ChatMessageFileLocationType, type ChatMessageFileS3, ChatMessageFileUseCase, type ChatMessageForCreate, type ChatMessageForRendering, type ChatMessageResponse, type ChatMessageUsage, type ChatMessagesResponse, type ChatSession, type ChatSessionFeedback, type ChatSessionFeedbackForCreate, type ChatSessionFeedbackForUpdate, type ChatSessionForCreate, type ChatSessionLiteForUpdate, type ChatSessionResponse, type ChatSessionsResponse, type ChatTitleUpdateRequest, type ChatUser, type ChatUserAddOrUpdateResponse, type ChatUserFeature, type ChatUserFeatureBase, type ChatUserLite, type ChatUserResponse, type ChatUserSearchResponse, type ClearConverseLambdaCacheRequest, type ClearConverseLambdaCacheResponse, type ClearConverseLambdaCacheType, ClearConverseLambdaCacheTypes, type ClearSvelteKitCacheType, ClearSvelteKitCacheTypes, type ClearSvelteKitCachesRequest, type ClearSvelteKitCachesResponse, type ClearUserOverrideDataRequest, type ClearUserOverrideDataResponse, type CompanyType, type ComponentTagDefinition, ContentAdminCommand, type ContentAdminCommandRequestBase, type ContentAdminCommandResponseBase, type ContentAdminData, type ContentAdminRequest, type ContentAdminResponse, type ContentAdminSiteFeature, type ConverseInvocationMode, ConverseInvocationModes, type ConverseRequest, type ConverseRequestWithCommand, type CreateAgentRequest, type CreateChatAppRequest, type CreateOrUpdateChatAppOverrideRequest, type CreateOrUpdateChatAppOverrideResponse, type CreateOrUpdateMockAgentRequest, type CreateOrUpdateMockAgentResponse, type CreateOrUpdateMockChatAppRequest, type CreateOrUpdateMockChatAppResponse, type CreateOrUpdateMockSessionRequest, type CreateOrUpdateMockSessionResponse, type CreateOrUpdateMockToolRequest, type CreateOrUpdateMockToolResponse, type CreateOrUpdateMockUserRequest, type CreateOrUpdateMockUserResponse, type CreateOrUpdateTagDefinitionAdminRequest, type CreateSharedSessionRequest, type CreateSharedSessionResponse, type CreateToolRequest, type CustomDataUiRepresentation, DEFAULT_EVENT_EXPIRY_DURATION, DEFAULT_MAX_K_MATCHES_PER_STRATEGY, DEFAULT_MAX_MEMORY_RECORDS_PER_PROMPT, DEFAULT_MEMORY_STRATEGIES, type DeleteAllMockAgentsRequest, type DeleteAllMockAgentsResponse, type DeleteAllMockChatAppsRequest, type DeleteAllMockChatAppsResponse, type DeleteAllMockDataRequest, type DeleteAllMockDataResponse, type DeleteAllMockPinnedSessionsRequest, type DeleteAllMockPinnedSessionsResponse, type DeleteAllMockSessionsRequest, type DeleteAllMockSessionsResponse, type DeleteAllMockSharedSessionVisitsRequest, type DeleteAllMockSharedSessionVisitsResponse, type DeleteAllMockToolsRequest, type DeleteAllMockToolsResponse, type DeleteAllMockUsersRequest, type DeleteAllMockUsersResponse, type DeleteChatAppOverrideRequest, type DeleteChatAppOverrideResponse, type DeleteMockAgentRequest, type DeleteMockAgentResponse, type DeleteMockChatAppRequest, type DeleteMockChatAppResponse, type DeleteMockDataRequest, type DeleteMockDataResponse, type DeleteMockSessionRequest, type DeleteMockSessionResponse, type DeleteMockToolRequest, type DeleteMockToolResponse, type DeleteMockUserRequest, type DeleteMockUserResponse, type DeleteTagDefinitionAdminRequest, EndToEndFeatureIdList, type EndToEndFeatureIdType, type EntityFeatureForChatApp, type EntitySiteFeature, type ExecutionType, FEATURE_NAMES, FEEDBACK_INTERNAL_COMMENT_STATUS, FEEDBACK_INTERNAL_COMMENT_STATUS_VALUES, FEEDBACK_INTERNAL_COMMENT_TYPE, FEEDBACK_INTERNAL_COMMENT_TYPE_VALUES, type Feature, type FeatureError, FeatureIdList, type FeatureIdType, type FeatureType, FeatureTypeArr, type FeedbackInternalComment, type FeedbackInternalCommentStatus, type FeedbackInternalCommentType, type FileUploadFeature, type FileUploadFeatureForChatApp, type GetAgentRequest, type GetAgentResponse, type GetAllAgentsAdminRequest, type GetAllAgentsAdminResponse, type GetAllChatAppsAdminRequest, type GetAllChatAppsAdminResponse, type GetAllMemoryRecordsAdminRequest, type GetAllMemoryRecordsAdminResponse, type GetAllMockAgentsRequest, type GetAllMockAgentsResponse, type GetAllMockChatAppsRequest, type GetAllMockChatAppsResponse, type GetAllMockDataRequest, type GetAllMockDataResponse, type GetAllMockPinnedSessionsRequest, type GetAllMockPinnedSessionsResponse, type GetAllMockSessionsRequest, type GetAllMockSessionsResponse, type GetAllMockSharedSessionVisitsRequest, type GetAllMockSharedSessionVisitsResponse, type GetAllMockToolsRequest, type GetAllMockToolsResponse, type GetAllMockUsersRequest, type GetAllMockUsersResponse, type GetAllToolsAdminRequest, type GetAllToolsAdminResponse, type GetChatAppsByRulesRequest, type GetChatAppsByRulesResponse, type GetChatMessagesAsAdminRequest, type GetChatMessagesAsAdminResponse, type GetChatSessionFeedbackResponse, type GetChatUserPrefsResponse, type GetInitialDataRequest, type GetInitialDataResponse, type GetInitialDialogDataRequest, type GetInitialDialogDataResponse, type GetInstructionAssistanceConfigFromSsmRequest, type GetInstructionAssistanceConfigFromSsmResponse, type GetInstructionsAddedForUserMemoryAdminRequest, type GetInstructionsAddedForUserMemoryAdminResponse, type GetInstructionsAddedForUserMemoryRequest, type GetInstructionsAddedForUserMemoryResponse, type GetMockSessionByUserIdAndSessionIdRequest, type GetMockSessionByUserIdAndSessionIdResponse, type GetPinnedSessionsRequest, type GetPinnedSessionsResponse, type GetRecentSharedRequest, type GetRecentSharedResponse, type GetValuesForAutoCompleteRequest, type GetValuesForAutoCompleteResponse, type GetValuesForContentAdminAutoCompleteRequest, type GetValuesForContentAdminAutoCompleteResponse, type GetValuesForEntityAutoCompleteRequest, type GetValuesForEntityAutoCompleteResponse, type GetValuesForUserAutoCompleteRequest, type GetValuesForUserAutoCompleteResponse, type GetViewingContentForUserResponse, type HistoryFeature, type HomePageLinksToChatAppsSiteFeature, type HomePageSiteFeature, INSIGHT_STATUS_NEEDS_INSIGHTS_ANALYSIS, Inaccurate, type InlineToolDefinition, type InsightStatusNeedsInsightsAnalysis, type InsightsSearchParams, type InstructionAssistanceConfig, type InstructionAugmentationFeature, type InstructionAugmentationFeatureForChatApp, type InstructionAugmentationScopeType, type InstructionAugmentationScopeTypeDisplayName, InstructionAugmentationScopeTypeDisplayNames, InstructionAugmentationScopeTypes, type InstructionAugmentationType, type InstructionAugmentationTypeDisplayName, InstructionAugmentationTypeDisplayNames, InstructionAugmentationTypes, type InstructionFeature, type InvocationScopes, type KnowledgeBase, type LambdaToolDefinition, type LifecycleStatus, type LogoutFeature, type LogoutFeatureForChatApp, type McpToolDefinition, type MemoryContent, type MemoryQueryOptions, type MessageSegment, type MessageSegmentBase, MessageSource, type NameValueDescTriple, type NameValuePair, type OAuth, type PagedRecordsResult, type PikaConfig, type PikaStack, type PikaUserRole, PikaUserRoles, type PinSessionRequest, type PinSessionResponse, type PinnedObjAndChatSession, type PinnedSession, type PinnedSessionDynamoDb, type PromptInputFieldLabelFeature, type PromptInputFieldLabelFeatureForChatApp, type RecordOrUndef, type RecordShareVisitRequest, type RecordShareVisitResponse, type RefreshChatAppRequest, type RefreshChatAppResponse, type RetrievedMemoryContent, type RetrievedMemoryRecordSummary, type RetryableVerifyResponseClassification, RetryableVerifyResponseClassifications, type RevokeSharedSessionRequest, type RevokeSharedSessionResponse, type RolloutPolicy, SCORE_SEARCH_OPERATORS, SCORE_SEARCH_OPERATORS_VALUES, SESSION_FEEDBACK_SEVERITY, SESSION_FEEDBACK_SEVERITY_VALUES, SESSION_FEEDBACK_STATUS, SESSION_FEEDBACK_STATUS_VALUES, SESSION_FEEDBACK_TYPE, SESSION_FEEDBACK_TYPE_VALUES, SESSION_INSIGHT_GOAL_COMPLETION_STATUS, SESSION_INSIGHT_GOAL_COMPLETION_STATUS_VALUES, SESSION_INSIGHT_METRICS_AI_CONFIDENCE_LEVEL, SESSION_INSIGHT_METRICS_AI_CONFIDENCE_LEVEL_VALUES, SESSION_INSIGHT_METRICS_COMPLEXITY_LEVEL, SESSION_INSIGHT_METRICS_COMPLEXITY_LEVEL_VALUES, SESSION_INSIGHT_METRICS_SESSION_DURATION_ESTIMATE, SESSION_INSIGHT_METRICS_SESSION_DURATION_ESTIMATE_VALUES, SESSION_INSIGHT_METRICS_USER_EFFORT_REQUIRED, SESSION_INSIGHT_METRICS_USER_EFFORT_REQUIRED_VALUES, SESSION_INSIGHT_SATISFACTION_LEVEL, SESSION_INSIGHT_SATISFACTION_LEVEL_VALUES, SESSION_INSIGHT_USER_SENTIMENT, SESSION_INSIGHT_USER_SENTIMENT_VALUES, SESSION_SEARCH_DATE_PRESETS, SESSION_SEARCH_DATE_PRESETS_SHORT_VALUES, SESSION_SEARCH_DATE_PRESETS_VALUES, SESSION_SEARCH_DATE_TYPES, SESSION_SEARCH_DATE_TYPES_VALUES, SESSION_SEARCH_SORT_FIELDS, SESSION_SEARCH_SORT_FIELDS_VALUES, type SaveUserOverrideDataRequest, type SaveUserOverrideDataResponse, type ScoreSearchOperator, type ScoreSearchParams, type SearchAllMemoryRecordsRequest, type SearchAllMemoryRecordsResponse, type SearchAllMyMemoryRecordsRequest, type SearchAllMyMemoryRecordsResponse, type SearchSemanticDirectivesAdminRequest, type SearchSemanticDirectivesRequest, type SearchSemanticDirectivesResponse, type SearchTagDefinitionsAdminRequest, type SearchToolsRequest, type SegmentType, type SemanticDirective, type SemanticDirectiveCreateOrUpdateAdminRequest, type SemanticDirectiveCreateOrUpdateRequest, type SemanticDirectiveCreateOrUpdateResponse, type SemanticDirectiveDataRequest, type SemanticDirectiveDeleteAdminRequest, type SemanticDirectiveDeleteRequest, type SemanticDirectiveDeleteResponse, type SemanticDirectiveForCreateOrUpdate, type SemanticDirectiveScope, type SessionAttributes, type SessionAttributesWithoutToken, type SessionData, type SessionDataWithChatUserCustomDataSpreadIn, type SessionFeedbackSeverity, type SessionFeedbackStatus, type SessionFeedbackType, type SessionInsightGoalCompletionStatus, type SessionInsightMetricsAiConfidenceLevel, type SessionInsightMetricsComplexityLevel, type SessionInsightMetricsSessionDurationEstimate, type SessionInsightMetricsUserEffortRequired, type SessionInsightSatisfactionLevel, type SessionInsightScoring, type SessionInsightUsage, type SessionInsightUserSentiment, type SessionInsights, type SessionInsightsFeature, type SessionInsightsFeatureForChatApp, type SessionInsightsOpenSearchConfig, type SessionSearchAdminRequest, type SessionSearchDateFilter, type SessionSearchDatePreset, type SessionSearchDateType, type SessionSearchRequest, type SessionSearchResponse, type SessionSearchSortField, type SetChatUserPrefsRequest, type SetChatUserPrefsResponse, type ShareSessionState, ShareSessionStateList, type SharedSessionVisitHistory, type SharedSessionVisitHistoryDynamoDb, type ShowToastFn, type ShowToastOptions, type SimpleAuthenticatedUser, type SimpleOption, SiteAdminCommand, type SiteAdminCommandRequestBase, type SiteAdminCommandResponseBase, type SiteAdminFeature, type SiteAdminRequest, type SiteAdminResponse, type SiteFeatures, type StopViewingContentForUserRequest, type StopViewingContentForUserResponse, type StreamingStatus, type SuggestionsFeature, type SuggestionsFeatureForChatApp, type TagDefInJsonFile, type TagDefinition, type TagDefinitionCreateOrUpdateRequest, type TagDefinitionCreateOrUpdateResponse, type TagDefinitionDeleteRequest, type TagDefinitionDeleteResponse, type TagDefinitionForCreateOrUpdate, type TagDefinitionLite, type TagDefinitionSearchRequest, type TagDefinitionSearchResponse, type TagDefinitionWebComponent, type TagDefinitionWidget, type TagDefinitionWidgetBase, type TagDefinitionWidgetCustomCompiledIn, type TagDefinitionWidgetPassThrough, type TagDefinitionWidgetPikaCompiledIn, type TagDefinitionWidgetType, type TagDefinitionWidgetWebComponent, type TagDefinitionsJsonFile, type TagMessageSegment, type TagWebComponentEncoding, type TagsChatAppOverridableFeature, type TagsFeatureForChatApp, type TagsSiteFeature, type TextMessageSegment, type ToolDefinition, type ToolDefinitionBase, type ToolDefinitionForCreate, type ToolDefinitionForIdempotentCreateOrUpdate, type ToolDefinitionForUpdate, type ToolIdToLambdaArnMap, type ToolInvocationContent, type ToolLifecycle, type TracesFeature, type TracesFeatureForChatApp, type TypedContentWithRole, UPDATEABLE_FEEDBACK_FIELDS, type UiCustomizationFeature, type UiCustomizationFeatureForChatApp, Unclassified, type UnpinSessionRequest, type UnpinSessionResponse, type UnrevokeSharedSessionRequest, type UnrevokeSharedSessionResponse, type UpdateAgentRequest, type UpdateChatAppRequest, type UpdateChatSessionFeedbackAdminRequest, type UpdateChatSessionFeedbackRequest, type UpdateChatSessionFeedbackResponse, type UpdateToolRequest, type UpdateableAgentDefinitionFields, type UpdateableChatAppFields, type UpdateableChatAppOverrideFields, type UpdateableFeedbackFields, type UpdateableToolDefinitionFields, type UserAwsCredentials, type UserAwsCredentialsResponse, type UserChatAppRule, type UserCognitoIdentity, type UserDataOverrideFeatureForChatApp, type UserDataOverrideSettings, type UserDataOverridesSiteFeature, type UserMemoryFeature, type UserMemoryFeatureForChatApp, type UserMemoryFeatureWithMemoryInfo, UserMemoryStrategies, type UserMemoryStrategy, type UserMessageContent, type UserOverrideData, UserOverrideDataCommand, type UserOverrideDataCommandRequest, type UserOverrideDataCommandRequestBase, type UserOverrideDataCommandResponse, type UserOverrideDataCommandResponseBase, type UserPrefs, type UserRole, type UserType, UserTypes, type ValidateShareAccessRequest, type ValidateShareAccessResponse, type VerifyResponseClassification, type VerifyResponseClassificationDescription, VerifyResponseClassificationDescriptions, VerifyResponseClassifications, type VerifyResponseFeature, type VerifyResponseFeatureForChatApp, type VerifyResponseRetryableClassificationDescription, VerifyResponseRetryableClassificationDescriptions, type ViewContentForUserRequest, type ViewContentForUserResponse, type VitePreviewConfig, type ViteServerConfig };
+export { type AccessRule, type AccessRules, Accurate, AccurateWithStatedAssumptions, AccurateWithUnstatedAssumptions, type AddChatSessionFeedbackAdminRequest, type AddChatSessionFeedbackRequest, type AddChatSessionFeedbackResponse, type AgentAndTools, type AgentDataRequest, type AgentDataResponse, type AgentDefinition, type AgentDefinitionForCreate, type AgentDefinitionForIdempotentCreateOrUpdate, type AgentDefinitionForUpdate, type AgentFramework, type AgentInstructionAssistanceFeature, type AgentInstructionAssistanceFeatureForChatApp, type AgentInstructionChatAppOverridableFeature, type ApplyRulesAs, type AssistantMessageContent, type AssistantRationaleContent, type Attachment, type AuthenticateResult, type AuthenticatedUser, type BaseRequestData, type BaseStackConfig, type CanvasContextConfig, type ChatApp, type ChatAppAction, type ChatAppActionGroup, type ChatAppActionMenu, type ChatAppActionMenuElements, type ChatAppComponentConfig, type ChatAppDataRequest, type ChatAppDataResponse, type ChatAppFeature, type ChatAppForCreate, type ChatAppForIdempotentCreateOrUpdate, type ChatAppForUpdate, type ChatAppLite, type ChatAppMode, type ChatAppOverridableFeatures, type ChatAppOverridableFeaturesForConverseFn, type ChatAppOverride, type ChatAppOverrideDdb, type ChatAppOverrideForCreateOrUpdate, type ChatDisclaimerNoticeFeature, type ChatDisclaimerNoticeFeatureForChatApp, type ChatMessage, type ChatMessageFile, type ChatMessageFileBase, ChatMessageFileLocationType, type ChatMessageFileS3, ChatMessageFileUseCase, type ChatMessageForCreate, type ChatMessageForRendering, type ChatMessageResponse, type ChatMessageUsage, type ChatMessagesResponse, type ChatSession, type ChatSessionFeedback, type ChatSessionFeedbackForCreate, type ChatSessionFeedbackForUpdate, type ChatSessionForCreate, type ChatSessionLiteForUpdate, type ChatSessionResponse, type ChatSessionsResponse, type ChatTitleUpdateRequest, type ChatUser, type ChatUserAddOrUpdateResponse, type ChatUserFeature, type ChatUserFeatureBase, type ChatUserLite, type ChatUserResponse, type ChatUserSearchResponse, type ClearConverseLambdaCacheRequest, type ClearConverseLambdaCacheResponse, type ClearConverseLambdaCacheType, ClearConverseLambdaCacheTypes, type ClearSvelteKitCacheType, ClearSvelteKitCacheTypes, type ClearSvelteKitCachesRequest, type ClearSvelteKitCachesResponse, type ClearUserOverrideDataRequest, type ClearUserOverrideDataResponse, type CompanyType, type ComponentTagDefinition, ContentAdminCommand, type ContentAdminCommandRequestBase, type ContentAdminCommandResponseBase, type ContentAdminData, type ContentAdminRequest, type ContentAdminResponse, type ContentAdminSiteFeature, type ConverseInvocationMode, ConverseInvocationModes, type ConverseRequest, type ConverseRequestWithCommand, ConverseSource, type CreateAgentRequest, type CreateChatAppRequest, type CreateOrUpdateChatAppOverrideRequest, type CreateOrUpdateChatAppOverrideResponse, type CreateOrUpdateMockAgentRequest, type CreateOrUpdateMockAgentResponse, type CreateOrUpdateMockChatAppRequest, type CreateOrUpdateMockChatAppResponse, type CreateOrUpdateMockSessionRequest, type CreateOrUpdateMockSessionResponse, type CreateOrUpdateMockToolRequest, type CreateOrUpdateMockToolResponse, type CreateOrUpdateMockUserRequest, type CreateOrUpdateMockUserResponse, type CreateOrUpdateTagDefinitionAdminRequest, type CreateSharedSessionRequest, type CreateSharedSessionResponse, type CreateToolRequest, type CustomDataUiRepresentation, DEFAULT_EVENT_EXPIRY_DURATION, DEFAULT_MAX_K_MATCHES_PER_STRATEGY, DEFAULT_MAX_MEMORY_RECORDS_PER_PROMPT, DEFAULT_MEMORY_STRATEGIES, type DeleteAllMockAgentsRequest, type DeleteAllMockAgentsResponse, type DeleteAllMockChatAppsRequest, type DeleteAllMockChatAppsResponse, type DeleteAllMockDataRequest, type DeleteAllMockDataResponse, type DeleteAllMockPinnedSessionsRequest, type DeleteAllMockPinnedSessionsResponse, type DeleteAllMockSessionsRequest, type DeleteAllMockSessionsResponse, type DeleteAllMockSharedSessionVisitsRequest, type DeleteAllMockSharedSessionVisitsResponse, type DeleteAllMockToolsRequest, type DeleteAllMockToolsResponse, type DeleteAllMockUsersRequest, type DeleteAllMockUsersResponse, type DeleteChatAppOverrideRequest, type DeleteChatAppOverrideResponse, type DeleteMockAgentRequest, type DeleteMockAgentResponse, type DeleteMockChatAppRequest, type DeleteMockChatAppResponse, type DeleteMockDataRequest, type DeleteMockDataResponse, type DeleteMockSessionRequest, type DeleteMockSessionResponse, type DeleteMockToolRequest, type DeleteMockToolResponse, type DeleteMockUserRequest, type DeleteMockUserResponse, type DeleteTagDefinitionAdminRequest, type DeleteUserWidgetDataRequest, type DeleteUserWidgetDataResponse, type DialogContextConfig, EndToEndFeatureIdList, type EndToEndFeatureIdType, type EntityFeatureForChatApp, type EntitySiteFeature, type ExecutionType, FEATURE_NAMES, FEEDBACK_INTERNAL_COMMENT_STATUS, FEEDBACK_INTERNAL_COMMENT_STATUS_VALUES, FEEDBACK_INTERNAL_COMMENT_TYPE, FEEDBACK_INTERNAL_COMMENT_TYPE_VALUES, type Feature, type FeatureError, FeatureIdList, type FeatureIdType, type FeatureType, FeatureTypeArr, type FeedbackInternalComment, type FeedbackInternalCommentStatus, type FeedbackInternalCommentType, type FileUploadFeature, type FileUploadFeatureForChatApp, type GetAgentRequest, type GetAgentResponse, type GetAllAgentsAdminRequest, type GetAllAgentsAdminResponse, type GetAllChatAppsAdminRequest, type GetAllChatAppsAdminResponse, type GetAllMemoryRecordsAdminRequest, type GetAllMemoryRecordsAdminResponse, type GetAllMockAgentsRequest, type GetAllMockAgentsResponse, type GetAllMockChatAppsRequest, type GetAllMockChatAppsResponse, type GetAllMockDataRequest, type GetAllMockDataResponse, type GetAllMockPinnedSessionsRequest, type GetAllMockPinnedSessionsResponse, type GetAllMockSessionsRequest, type GetAllMockSessionsResponse, type GetAllMockSharedSessionVisitsRequest, type GetAllMockSharedSessionVisitsResponse, type GetAllMockToolsRequest, type GetAllMockToolsResponse, type GetAllMockUsersRequest, type GetAllMockUsersResponse, type GetAllToolsAdminRequest, type GetAllToolsAdminResponse, type GetChatAppsByRulesRequest, type GetChatAppsByRulesResponse, type GetChatMessagesAsAdminRequest, type GetChatMessagesAsAdminResponse, type GetChatSessionFeedbackResponse, type GetChatUserPrefsResponse, type GetInitialDataRequest, type GetInitialDataResponse, type GetInitialDialogDataRequest, type GetInitialDialogDataResponse, type GetInstructionAssistanceConfigFromSsmRequest, type GetInstructionAssistanceConfigFromSsmResponse, type GetInstructionsAddedForUserMemoryAdminRequest, type GetInstructionsAddedForUserMemoryAdminResponse, type GetInstructionsAddedForUserMemoryRequest, type GetInstructionsAddedForUserMemoryResponse, type GetMockSessionByUserIdAndSessionIdRequest, type GetMockSessionByUserIdAndSessionIdResponse, type GetPinnedSessionsRequest, type GetPinnedSessionsResponse, type GetRecentSharedRequest, type GetRecentSharedResponse, type GetUserWidgetDataRequest, type GetUserWidgetDataResponse, type GetValuesForAutoCompleteRequest, type GetValuesForAutoCompleteResponse, type GetValuesForContentAdminAutoCompleteRequest, type GetValuesForContentAdminAutoCompleteResponse, type GetValuesForEntityAutoCompleteRequest, type GetValuesForEntityAutoCompleteResponse, type GetValuesForUserAutoCompleteRequest, type GetValuesForUserAutoCompleteResponse, type GetViewingContentForUserResponse, type HistoryFeature, type HomePageLinksToChatAppsSiteFeature, type HomePageSiteFeature, INSIGHT_STATUS_NEEDS_INSIGHTS_ANALYSIS, type IUserWidgetDataStoreState, Inaccurate, type InlineContextConfig, type InlineToolDefinition, type InsightStatusNeedsInsightsAnalysis, type InsightsSearchParams, type InstructionAssistanceConfig, type InstructionAugmentationFeature, type InstructionAugmentationFeatureForChatApp, type InstructionAugmentationScopeType, type InstructionAugmentationScopeTypeDisplayName, InstructionAugmentationScopeTypeDisplayNames, InstructionAugmentationScopeTypes, type InstructionAugmentationType, type InstructionAugmentationTypeDisplayName, InstructionAugmentationTypeDisplayNames, InstructionAugmentationTypes, type InstructionFeature, type InvocationScopes, type InvokeAgentAsComponentOptions, type KnowledgeBase, type LambdaToolDefinition, type LifecycleStatus, type LogoutFeature, type LogoutFeatureForChatApp, type McpToolDefinition, type MemoryContent, type MemoryQueryOptions, type MessageSegment, type MessageSegmentBase, MessageSource, type NameValueDescTriple, type NameValuePair, type OAuth, type PagedRecordsResult, type PikaConfig, type PikaStack, type PikaUserRole, PikaUserRoles, type PinSessionRequest, type PinSessionResponse, type PinnedObjAndChatSession, type PinnedSession, type PinnedSessionDynamoDb, type PromptInputFieldLabelFeature, type PromptInputFieldLabelFeatureForChatApp, type RecordOrUndef, type RecordShareVisitRequest, type RecordShareVisitResponse, type RefreshChatAppRequest, type RefreshChatAppResponse, type RetrievedMemoryContent, type RetrievedMemoryRecordSummary, type RetryableVerifyResponseClassification, RetryableVerifyResponseClassifications, type RevokeSharedSessionRequest, type RevokeSharedSessionResponse, type RolloutPolicy, SCORE_SEARCH_OPERATORS, SCORE_SEARCH_OPERATORS_VALUES, SESSION_FEEDBACK_SEVERITY, SESSION_FEEDBACK_SEVERITY_VALUES, SESSION_FEEDBACK_STATUS, SESSION_FEEDBACK_STATUS_VALUES, SESSION_FEEDBACK_TYPE, SESSION_FEEDBACK_TYPE_VALUES, SESSION_INSIGHT_GOAL_COMPLETION_STATUS, SESSION_INSIGHT_GOAL_COMPLETION_STATUS_VALUES, SESSION_INSIGHT_METRICS_AI_CONFIDENCE_LEVEL, SESSION_INSIGHT_METRICS_AI_CONFIDENCE_LEVEL_VALUES, SESSION_INSIGHT_METRICS_COMPLEXITY_LEVEL, SESSION_INSIGHT_METRICS_COMPLEXITY_LEVEL_VALUES, SESSION_INSIGHT_METRICS_SESSION_DURATION_ESTIMATE, SESSION_INSIGHT_METRICS_SESSION_DURATION_ESTIMATE_VALUES, SESSION_INSIGHT_METRICS_USER_EFFORT_REQUIRED, SESSION_INSIGHT_METRICS_USER_EFFORT_REQUIRED_VALUES, SESSION_INSIGHT_SATISFACTION_LEVEL, SESSION_INSIGHT_SATISFACTION_LEVEL_VALUES, SESSION_INSIGHT_USER_SENTIMENT, SESSION_INSIGHT_USER_SENTIMENT_VALUES, SESSION_SEARCH_DATE_PRESETS, SESSION_SEARCH_DATE_PRESETS_SHORT_VALUES, SESSION_SEARCH_DATE_PRESETS_VALUES, SESSION_SEARCH_DATE_TYPES, SESSION_SEARCH_DATE_TYPES_VALUES, SESSION_SEARCH_SORT_FIELDS, SESSION_SEARCH_SORT_FIELDS_VALUES, type SaveUserOverrideDataRequest, type SaveUserOverrideDataResponse, type ScoreSearchOperator, type ScoreSearchParams, type SearchAllMemoryRecordsRequest, type SearchAllMemoryRecordsResponse, type SearchAllMyMemoryRecordsRequest, type SearchAllMyMemoryRecordsResponse, type SearchSemanticDirectivesAdminRequest, type SearchSemanticDirectivesRequest, type SearchSemanticDirectivesResponse, type SearchTagDefinitionsAdminRequest, type SearchToolsRequest, type SegmentType, type SemanticDirective, type SemanticDirectiveCreateOrUpdateAdminRequest, type SemanticDirectiveCreateOrUpdateRequest, type SemanticDirectiveCreateOrUpdateResponse, type SemanticDirectiveDataRequest, type SemanticDirectiveDeleteAdminRequest, type SemanticDirectiveDeleteRequest, type SemanticDirectiveDeleteResponse, type SemanticDirectiveForCreateOrUpdate, type SemanticDirectiveScope, type SessionAttributes, type SessionAttributesWithoutToken, type SessionData, type SessionDataWithChatUserCustomDataSpreadIn, type SessionFeedbackSeverity, type SessionFeedbackStatus, type SessionFeedbackType, type SessionInsightGoalCompletionStatus, type SessionInsightMetricsAiConfidenceLevel, type SessionInsightMetricsComplexityLevel, type SessionInsightMetricsSessionDurationEstimate, type SessionInsightMetricsUserEffortRequired, type SessionInsightSatisfactionLevel, type SessionInsightScoring, type SessionInsightUsage, type SessionInsightUserSentiment, type SessionInsights, type SessionInsightsFeature, type SessionInsightsFeatureForChatApp, type SessionInsightsOpenSearchConfig, type SessionSearchAdminRequest, type SessionSearchDateFilter, type SessionSearchDatePreset, type SessionSearchDateType, type SessionSearchRequest, type SessionSearchResponse, type SessionSearchSortField, type SetChatUserPrefsRequest, type SetChatUserPrefsResponse, type SetUserWidgetDataRequest, type SetUserWidgetDataResponse, type ShareSessionState, ShareSessionStateList, type SharedSessionVisitHistory, type SharedSessionVisitHistoryDynamoDb, type ShowToastFn, type ShowToastOptions, type SimpleAuthenticatedUser, type SimpleOption, SiteAdminCommand, type SiteAdminCommandRequestBase, type SiteAdminCommandResponseBase, type SiteAdminFeature, type SiteAdminRequest, type SiteAdminResponse, type SiteFeatures, type SpotlightContextConfig, type StaticContextConfig, type StaticWidgetTagDefinition, type StopViewingContentForUserRequest, type StopViewingContentForUserResponse, type StreamingStatus, type SuggestionsFeature, type SuggestionsFeatureForChatApp, TAG_DEFINITION_STATUSES, TAG_DEFINITION_USAGE_MODES, TAG_DEFINITION_WIDGET_TYPES, type TagDefInJsonFile, type TagDefinition, type TagDefinitionCreateOrUpdateRequest, type TagDefinitionCreateOrUpdateResponse, type TagDefinitionDeleteRequest, type TagDefinitionDeleteResponse, type TagDefinitionForCreateOrUpdate, type TagDefinitionLite, type TagDefinitionSearchRequest, type TagDefinitionSearchResponse, type TagDefinitionStatus, type TagDefinitionUsageMode, type TagDefinitionWebComponent, type TagDefinitionWebComponentForCreateOrUpdate, type TagDefinitionWidget, type TagDefinitionWidgetBase, type TagDefinitionWidgetCustomCompiledIn, type TagDefinitionWidgetForCreateOrUpdate, type TagDefinitionWidgetPassThrough, type TagDefinitionWidgetPikaCompiledIn, type TagDefinitionWidgetType, type TagDefinitionWidgetWebComponent, type TagDefinitionWidgetWebComponentForCreateOrUpdate, type TagDefinitionsJsonFile, type TagMessageSegment, type TagWebComponentEncoding, type TagsChatAppOverridableFeature, type TagsFeatureForChatApp, type TagsSiteFeature, type TextMessageSegment, type ToolDefinition, type ToolDefinitionBase, type ToolDefinitionForCreate, type ToolDefinitionForIdempotentCreateOrUpdate, type ToolDefinitionForUpdate, type ToolIdToLambdaArnMap, type ToolInvocationContent, type ToolLifecycle, type TracesFeature, type TracesFeatureForChatApp, type TypedContentWithRole, UPDATEABLE_FEEDBACK_FIELDS, type UiCustomizationFeature, type UiCustomizationFeatureForChatApp, Unclassified, type UnpinSessionRequest, type UnpinSessionResponse, type UnrevokeSharedSessionRequest, type UnrevokeSharedSessionResponse, type UpdateAgentRequest, type UpdateChatAppRequest, type UpdateChatSessionFeedbackAdminRequest, type UpdateChatSessionFeedbackRequest, type UpdateChatSessionFeedbackResponse, type UpdateToolRequest, type UpdateableAgentDefinitionFields, type UpdateableChatAppFields, type UpdateableChatAppOverrideFields, type UpdateableFeedbackFields, type UpdateableToolDefinitionFields, type UserAwsCredentials, type UserAwsCredentialsResponse, type UserChatAppRule, type UserCognitoIdentity, type UserDataOverrideFeatureForChatApp, type UserDataOverrideSettings, type UserDataOverridesSiteFeature, type UserMemoryFeature, type UserMemoryFeatureForChatApp, type UserMemoryFeatureWithMemoryInfo, UserMemoryStrategies, type UserMemoryStrategy, type UserMessageContent, type UserOverrideData, UserOverrideDataCommand, type UserOverrideDataCommandRequest, type UserOverrideDataCommandRequestBase, type UserOverrideDataCommandResponse, type UserOverrideDataCommandResponseBase, type UserPrefs, type UserRole, type UserType, UserTypes, type UserWidgetData, type ValidateShareAccessRequest, type ValidateShareAccessResponse, type VerifyResponseClassification, type VerifyResponseClassificationDescription, VerifyResponseClassificationDescriptions, VerifyResponseClassifications, type VerifyResponseFeature, type VerifyResponseFeatureForChatApp, type VerifyResponseRetryableClassificationDescription, VerifyResponseRetryableClassificationDescriptions, type ViewContentForUserRequest, type ViewContentForUserResponse, type VitePreviewConfig, type ViteServerConfig, WIDGET_RENDERING_CONTEXT_TYPES, type WidgetAction, type WidgetDialogSizeCustom, type WidgetDialogSizePreset, type WidgetDialogSizing, type WidgetInlineSizing, type WidgetMetadata, type WidgetMetadataState, type WidgetRenderingContextType, type WidgetRenderingContexts, type WidgetSizing };