pika-shared 1.4.0 → 1.4.2

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AAUO,IAAM,WAAc,GAAA;AAAA,EACvB,IAAM,EAAA,aAAA;AAAA,EACN,WAAa,EAAA;AACjB","file":"index.js","sourcesContent":["/**\n * pika-shared package\n *\n * This package contains shared types, utilities, and other code used across the Pika project.\n *\n * You can import specific modules using direct paths:\n * import { ChatUser } from 'pika-shared/types/chatbot/chatbot';\n * import { apiGatewayFunctionDecorator } from 'pika-shared/util/api-gateway-utils';\n */\n\nexport const packageInfo = {\n    name: 'pika-shared',\n    description: 'Shared utilities and types for Pika project'\n};\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AAUO,IAAM,WAAA,GAAc;AAAA,EACvB,IAAA,EAAM,aAAA;AAAA,EACN,WAAA,EAAa;AACjB","file":"index.js","sourcesContent":["/**\n * pika-shared package\n *\n * This package contains shared types, utilities, and other code used across the Pika project.\n *\n * You can import specific modules using direct paths:\n * import { ChatUser } from 'pika-shared/types/chatbot/chatbot';\n * import { apiGatewayFunctionDecorator } from 'pika-shared/util/api-gateway-utils';\n */\n\nexport const packageInfo = {\n    name: 'pika-shared',\n    description: 'Shared utilities and types for Pika project'\n};\n"]}

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";AAUO,IAAM,WAAc,GAAA;AAAA,EACvB,IAAM,EAAA,aAAA;AAAA,EACN,WAAa,EAAA;AACjB","file":"index.mjs","sourcesContent":["/**\n * pika-shared package\n *\n * This package contains shared types, utilities, and other code used across the Pika project.\n *\n * You can import specific modules using direct paths:\n * import { ChatUser } from 'pika-shared/types/chatbot/chatbot';\n * import { apiGatewayFunctionDecorator } from 'pika-shared/util/api-gateway-utils';\n */\n\nexport const packageInfo = {\n    name: 'pika-shared',\n    description: 'Shared utilities and types for Pika project'\n};\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";AAUO,IAAM,WAAA,GAAc;AAAA,EACvB,IAAA,EAAM,aAAA;AAAA,EACN,WAAA,EAAa;AACjB","file":"index.mjs","sourcesContent":["/**\n * pika-shared package\n *\n * This package contains shared types, utilities, and other code used across the Pika project.\n *\n * You can import specific modules using direct paths:\n * import { ChatUser } from 'pika-shared/types/chatbot/chatbot';\n * import { apiGatewayFunctionDecorator } from 'pika-shared/util/api-gateway-utils';\n */\n\nexport const packageInfo = {\n    name: 'pika-shared',\n    description: 'Shared utilities and types for Pika project'\n};\n"]}

package/dist/types/chatbot/bedrock-lambda-error.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/types/chatbot/bedrock-lambda-error.ts"],"names":[],"mappings":";;;AAOa,IAAA,kBAAA,GAAN,cAAiC,KAAM,CAAA;AAAA,EAC1C,YAAY,OAAiB,EAAA;AACzB,IAAA,KAAA,CAAM,OAAO,CAAA;AAAA;AAErB","file":"bedrock-lambda-error.js","sourcesContent":["/**\n * This error is used to allow us to distinguish between errors that are\n * expected to be returned to the user and errors that are unexpected.\n *\n * These errors are caught in the Bedrock Lambda and converted into a\n * BedrockLambdaResponse object using the message as the body.\n */\nexport class BedrockLambdaError extends Error {\n    constructor(message: string) {\n        super(message);\n    }\n}\n"]}
+{"version":3,"sources":["../../../src/types/chatbot/bedrock-lambda-error.ts"],"names":[],"mappings":";;;AAOO,IAAM,kBAAA,GAAN,cAAiC,KAAA,CAAM;AAAA,EAC1C,YAAY,OAAA,EAAiB;AACzB,IAAA,KAAA,CAAM,OAAO,CAAA;AAAA,EACjB;AACJ","file":"bedrock-lambda-error.js","sourcesContent":["/**\n * This error is used to allow us to distinguish between errors that are\n * expected to be returned to the user and errors that are unexpected.\n *\n * These errors are caught in the Bedrock Lambda and converted into a\n * BedrockLambdaResponse object using the message as the body.\n */\nexport class BedrockLambdaError extends Error {\n    constructor(message: string) {\n        super(message);\n    }\n}\n"]}

package/dist/types/chatbot/bedrock-lambda-error.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/types/chatbot/bedrock-lambda-error.ts"],"names":[],"mappings":";AAOa,IAAA,kBAAA,GAAN,cAAiC,KAAM,CAAA;AAAA,EAC1C,YAAY,OAAiB,EAAA;AACzB,IAAA,KAAA,CAAM,OAAO,CAAA;AAAA;AAErB","file":"bedrock-lambda-error.mjs","sourcesContent":["/**\n * This error is used to allow us to distinguish between errors that are\n * expected to be returned to the user and errors that are unexpected.\n *\n * These errors are caught in the Bedrock Lambda and converted into a\n * BedrockLambdaResponse object using the message as the body.\n */\nexport class BedrockLambdaError extends Error {\n    constructor(message: string) {\n        super(message);\n    }\n}\n"]}
+{"version":3,"sources":["../../../src/types/chatbot/bedrock-lambda-error.ts"],"names":[],"mappings":";AAOO,IAAM,kBAAA,GAAN,cAAiC,KAAA,CAAM;AAAA,EAC1C,YAAY,OAAA,EAAiB;AACzB,IAAA,KAAA,CAAM,OAAO,CAAA;AAAA,EACjB;AACJ","file":"bedrock-lambda-error.mjs","sourcesContent":["/**\n * This error is used to allow us to distinguish between errors that are\n * expected to be returned to the user and errors that are unexpected.\n *\n * These errors are caught in the Bedrock Lambda and converted into a\n * BedrockLambdaResponse object using the message as the body.\n */\nexport class BedrockLambdaError extends Error {\n    constructor(message: string) {\n        super(message);\n    }\n}\n"]}

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

@@ -454,6 +454,20 @@ type UserRole = PikaUserRole | (string & {
     __pika?: never;
 });
 type RecordOrUndef = Record<string, string | undefined> | undefined;
+interface UserCognitoIdentity {
+    cognitoIdentityId: string;
+    cognitoAccessToken: string;
+}
+interface UserAwsCredentials {
+    accessKeyId: string;
+    secretKey: string;
+    sessionToken: string;
+    expiration: string;
+}
+interface UserAwsCredentialsResponse {
+    success: boolean;
+    awsCredentials: UserAwsCredentials;
+}
 /**
  * Represents a user in the chat system with their associated features and preferences.
  * This is saved in the chat user database.
@@ -646,12 +660,15 @@ 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[];
@@ -758,17 +775,50 @@ 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;
+}
+/**
+ * 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"];
+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 */
@@ -857,6 +907,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>;
@@ -2063,6 +2156,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';
 /**
@@ -3250,6 +3351,31 @@ 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;
+}
+declare const WIDGET_RENDERING_CONTEXT_TYPES: readonly ["spotlight", "inline", "dialog", "canvas"];
+type WidgetRenderingContextType = (typeof WIDGET_RENDERING_CONTEXT_TYPES)[number];
+interface WidgetRenderingContexts {
+    spotlight?: SpotlightContextConfig;
+    inline?: InlineContextConfig;
+    dialog?: DialogContextConfig;
+    canvas?: CanvasContextConfig;
+}
 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
@@ -3317,8 +3443,31 @@ 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;
+    /**
+     * The chat app ID this tag is associated with.
+     * Use the special value 'chat-app-global' for tags available to all chat apps.
+     * REQUIRED: Every tag must be associated with either a specific chat app or be global.
+     */
+    chatAppId: string;
+    /**
+     * 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.
@@ -3346,6 +3495,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 */
@@ -3359,7 +3566,38 @@ 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).
+ */
+type TagDefinitionForCreateOrUpdate<T extends TagDefinitionWidgetForCreateOrUpdate = TagDefinitionWidgetForCreateOrUpdate> = Omit<TagDefinition<TagDefinitionWidget>, 'createdBy' | 'lastUpdatedBy' | 'createDate' | 'lastUpdate' | 'widget'> & {
+    widget: T;
+};
+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`.
  *
@@ -3370,7 +3608,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';
 }
@@ -3391,15 +3629,52 @@ interface TagDefinitionWidgetBase {
     type: TagDefinitionWidgetType;
 }
 type TagDefinitionWidget = TagDefinitionWidgetPassThrough | TagDefinitionWidgetPikaCompiledIn | TagDefinitionWidgetCustomCompiledIn | TagDefinitionWidgetWebComponent;
-type TagWebComponentEncoding = 'gzip+base64';
+type TagWebComponentEncoding = 'gzip';
 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;
     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 {
@@ -3416,26 +3691,30 @@ 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 all tags for a chat app (including global):
+ *   - Pass chatAppId
+ *   - System automatically queries BOTH the specified chatAppId AND 'chat-app-global'
+ *   - Uses GSI (chatAppId-status-index) for efficient retrieval
+ *   - Returns all enabled tags for the chat app + all global tags
  *
+ * MODE 2 - Get specific tags by scope/tag:
+ *   - Pass tagsDesired array
+ *   - Returns only the requested tags (if they exist and user has access)
+ *   - Uses primary key lookup (scope + tag)
  *
- * 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 (MODE 2) */
     tagsDesired?: TagDefinitionLite[];
-    /** If not true, instructions will not be returned to save space. */
+    /** Chat app ID to filter tags for (MODE 1) - system automatically includes global tags */
+    chatAppId?: string;
+    /** 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 {
@@ -3578,5 +3857,123 @@ interface RecordShareVisitResponse {
     success: boolean;
     error?: string;
 }
+interface ShowToastOptions {
+    type: 'success' | 'error' | 'warning' | 'info';
+    duration?: number | 'infinite';
+}
+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;
+}
+/**
+ * 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>;
+}
+/**
+ * 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 SharedSessionVisitHistory, type SharedSessionVisitHistoryDynamoDb, 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 UserChatAppRule, 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 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, 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 StopViewingContentForUserRequest, type StopViewingContentForUserResponse, type StreamingStatus, type SuggestionsFeature, type SuggestionsFeatureForChatApp, TAG_DEFINITION_STATUSES, 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 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 WidgetMetadata, type WidgetMetadataState, type WidgetRenderingContextType, type WidgetRenderingContexts };