pika-shared 1.1.0 → 1.2.0

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

@@ -41,6 +41,8 @@ interface ChatSession<T extends RecordOrUndef = undefined> {
     chatAppId: string;
     /** Unique identifier for the user's identity */
     identityId: string;
+    /** Mode of the invocation of the agent */
+    invocationMode: ConverseInvocationMode;
     /** Title or name of the chat session */
     title?: string;
     /** ID of the most recent message in the session */
@@ -493,6 +495,8 @@ interface ChatUserLite {
  */
 interface AuthenticatedUser<T extends RecordOrUndef = undefined, U extends RecordOrUndef = undefined> extends ChatUser<U> {
     authData?: T;
+    /** ISO 8601 timestamp of when ChatUser data was last refreshed from DynamoDB (the pikaframework sets this) */
+    lastChatUserRefresh?: string;
 }
 /**
  * This is a simplified version of AuthenticatedUser that is used for auth headers.
@@ -584,8 +588,9 @@ interface ChatAppOverridableFeatures {
         showUserRegionInLeftNav: boolean;
         showChatHistoryInStandaloneMode: boolean;
     };
-    tags: TagsChatAppOverridableFeature;
+    tags?: TagsChatAppOverridableFeature;
     agentInstructionAssistance: AgentInstructionChatAppOverridableFeature;
+    instructionAugmentation: InstructionAugmentationFeature;
 }
 interface AgentInstructionChatAppOverridableFeature {
     enabled: boolean;
@@ -674,9 +679,6 @@ interface BaseRequestData {
     sessionId?: string;
     chatAppId?: string;
     agentId?: string;
-    agentAliasId?: string;
-    companyId?: string;
-    companyType?: CompanyType;
     timezone?: string;
 }
 interface ConverseRequestWithCommand {
@@ -699,7 +701,29 @@ interface ConverseRequest extends BaseRequestData {
      * It allows us to dynamically change the agent used for the conversation.
      */
     agentId: string;
+    /**
+     * This is the attribute name in the user's custom data that is used to match against the entity access control lists.
+     * This is only used if the entity feature is enabled and the user has an entity associated with them.
+     *
+     * @see pika-config.ts#siteFeatures.entity.attributeName
+     */
+    entityAttributeNameInUserCustomData?: string;
+    /**
+     * 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 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;
 }
+declare const ConverseInvocationModes: readonly ["chat-app", "direct-agent-invoke"];
+type ConverseInvocationMode = (typeof ConverseInvocationModes)[number];
 interface ChatTitleUpdateRequest extends BaseRequestData {
     /** If provided, this will be used as the title for the session */
     title?: string;
@@ -1091,7 +1115,7 @@ type AgentDefinitionForIdempotentCreateOrUpdate = Omit<AgentDefinition, 'toolIds
 /**
  * Execution type for tool definitions.  Right now, only lambda is supported.
  */
-type ExecutionType = 'lambda' | 'http' | 'inline';
+type ExecutionType = 'lambda' | 'http' | 'inline' | 'mcp';
 /**
  * Lifecycle status for tool definitions
  */
@@ -1107,16 +1131,12 @@ interface ToolLifecycle {
     /** Optional migration path to newer tool version */
     migrationPath?: string;
 }
-/**
- * JSON Schema definition
- */
-/**
- * Bedrock function schema definition
- */
 /**
  * Tool definition representing a callable function/service
  */
-interface ToolDefinition {
+interface ToolDefinitionBase {
+    /** Type of execution (lambda, http, inline) */
+    executionType: ExecutionType;
     /** Unique tool name/version (e.g., 'weather-basic@1') */
     toolId: string;
     /** Friendly display name */
@@ -1125,15 +1145,8 @@ interface ToolDefinition {
     name: string;
     /** Description for LLM consumption. MUST BE LESS THAN 500 CHARACTERS */
     description: string;
-    /** Type of execution (lambda, http, inline) */
-    executionType: ExecutionType;
     /** Timeout in seconds (default: 30) */
     executionTimeout?: number;
-    /**
-     * If executionType is 'lambda', this is the required ARN of the Lambda function.
-     * Note that the Lambda function must have an 'agent-tool' tag set to 'true'.
-     */
-    lambdaArn?: string;
     /**
      * List of agent frameworks that this tool supports
      *
@@ -1161,18 +1174,45 @@ interface ToolDefinition {
     /** If true, this is a test tool that will get deleted after 1 day.  This is used for testing. */
     test?: boolean;
 }
-type UpdateableToolDefinitionFields = Extract<keyof ToolDefinition, 'name' | 'displayName' | 'description' | 'executionType' | 'executionTimeout' | 'lambdaArn' | 'supportedAgentFrameworks' | 'functionSchema' | 'tags' | 'lifecycle' | 'accessRules'>;
-type ToolDefinitionForCreate = Omit<ToolDefinition, 'version' | 'createdAt' | 'updatedAt' | 'lastModifiedBy' | 'createdBy'> & {
+interface LambdaToolDefinition extends ToolDefinitionBase {
+    executionType: 'lambda';
+    /**
+     * If executionType is 'lambda', this is the required ARN of the Lambda function.
+     * Note that the Lambda function must have an 'agent-tool' tag set to 'true'.
+     */
+    lambdaArn: string;
+}
+interface McpToolDefinition extends ToolDefinitionBase {
+    executionType: 'mcp';
+    url: string;
+    auth?: OAuth;
+}
+type ToolDefinition = LambdaToolDefinition | McpToolDefinition;
+type UpdateableToolDefinitionFields = Extract<keyof ToolDefinitionBase, 'name' | 'displayName' | 'description' | 'executionType' | 'executionTimeout' | 'supportedAgentFrameworks' | 'functionSchema' | 'tags' | 'lifecycle' | 'accessRules'> | 'lambdaArn' | 'url' | 'auth';
+type ToolDefinitionForCreate = (Omit<LambdaToolDefinition, 'version' | 'createdAt' | 'updatedAt' | 'lastModifiedBy' | 'createdBy'> & {
     toolId?: ToolDefinition['toolId'];
-};
+}) | (Omit<McpToolDefinition, 'version' | 'createdAt' | 'updatedAt' | 'lastModifiedBy' | 'createdBy'> & {
+    toolId?: ToolDefinition['toolId'];
+});
 type ToolDefinitionForIdempotentCreateOrUpdate = Omit<ToolDefinition, 'version' | 'createdAt' | 'updatedAt' | 'lastModifiedBy' | 'createdBy'> & {
     lambdaArn: string;
     functionSchema: FunctionDefinition[];
     supportedAgentFrameworks: ['bedrock'];
 };
-type ToolDefinitionForUpdate = Partial<Omit<ToolDefinition, 'version' | 'createdAt' | 'createdBy' | 'updatedAt' | 'lastModifiedBy'>> & {
+interface OAuth {
+    clientId: string;
+    clientSecret: string;
+    tokenUrl: string;
+    token?: {
+        accessToken: string;
+        expires: number;
+    };
+}
+type ToolDefinitionForUpdate = (Partial<Omit<LambdaToolDefinition, 'version' | 'createdAt' | 'createdBy' | 'updatedAt' | 'lastModifiedBy'>> & {
     toolId: string;
-};
+}) | (Partial<Omit<McpToolDefinition, 'version' | 'createdAt' | 'createdBy' | 'updatedAt' | 'lastModifiedBy'>> & {
+    toolId: string;
+});
 type AgentFramework = 'bedrock';
 interface CreateAgentRequest {
     agent: AgentDefinitionForCreate;
@@ -1385,7 +1425,7 @@ interface ChatAppDataRequest {
 /**
  * These are the features that are available to be overridden by the chat app.
  */
-type ChatAppFeature = FileUploadFeatureForChatApp | SuggestionsFeatureForChatApp | PromptInputFieldLabelFeatureForChatApp | UiCustomizationFeatureForChatApp | VerifyResponseFeatureForChatApp | TracesFeatureForChatApp | ChatDisclaimerNoticeFeatureForChatApp | LogoutFeatureForChatApp | SessionInsightsFeatureForChatApp | UserDataOverrideFeatureForChatApp | TagsFeatureForChatApp | AgentInstructionAssistanceFeatureForChatApp;
+type ChatAppFeature = FileUploadFeatureForChatApp | SuggestionsFeatureForChatApp | PromptInputFieldLabelFeatureForChatApp | UiCustomizationFeatureForChatApp | VerifyResponseFeatureForChatApp | TracesFeatureForChatApp | ChatDisclaimerNoticeFeatureForChatApp | LogoutFeatureForChatApp | SessionInsightsFeatureForChatApp | UserDataOverrideFeatureForChatApp | TagsFeatureForChatApp | AgentInstructionAssistanceFeatureForChatApp | InstructionAugmentationFeatureForChatApp;
 interface Feature {
     /**
      * Must be unique, only alphanumeric and -  _  allowed, may not start with a number
@@ -1396,7 +1436,7 @@ interface Feature {
     /** Whether the feature is on or off for the chat app in question. Most features are off by default, see the specific feature for details. */
     enabled: boolean;
 }
-declare const FeatureIdList: readonly ["fileUpload", "promptInputFieldLabel", "suggestions", "uiCustomization", "verifyResponse", "traces", "chatDisclaimerNotice", "logout", "sessionInsights", "userDataOverrides", "tags", "agentInstructionAssistance"];
+declare const FeatureIdList: readonly ["fileUpload", "promptInputFieldLabel", "suggestions", "uiCustomization", "verifyResponse", "traces", "chatDisclaimerNotice", "logout", "sessionInsights", "userDataOverrides", "tags", "agentInstructionAssistance", "instructionAugmentation"];
 type FeatureIdType = (typeof FeatureIdList)[number];
 declare const EndToEndFeatureIdList: readonly ["verifyResponse", "traces"];
 type EndToEndFeatureIdType = (typeof EndToEndFeatureIdList)[number];
@@ -1600,6 +1640,9 @@ interface PromptInputFieldLabelFeatureForChatApp extends PromptInputFieldLabelFe
 interface AgentInstructionAssistanceFeatureForChatApp extends Feature, AgentInstructionAssistanceFeature {
     featureId: 'agentInstructionAssistance';
 }
+interface InstructionAugmentationFeatureForChatApp extends InstructionAugmentationFeature, Feature {
+    featureId: 'instructionAugmentation';
+}
 /**
  * The prompt instruction assistance feature is used to add a markdown section to the prompt that instructs the agent on how to format its response.
  *
@@ -1736,8 +1779,8 @@ interface TextMessageSegment extends MessageSegmentBase {
     segmentType: 'text';
 }
 type MessageSegment = TagMessageSegment | TextMessageSegment;
-type SiteAdminRequest = GetAgentRequest | GetInitialDataRequest | RefreshChatAppRequest | CreateOrUpdateChatAppOverrideRequest | DeleteChatAppOverrideRequest | GetValuesForEntityAutoCompleteRequest | GetValuesForUserAutoCompleteRequest | ClearConverseLambdaCacheRequest | ClearSvelteKitCachesRequest | AddChatSessionFeedbackAdminRequest | UpdateChatSessionFeedbackAdminRequest | SessionSearchAdminRequest | GetChatMessagesAsAdminRequest | CreateOrUpdateTagDefinitionAdminRequest | DeleteTagDefinitionAdminRequest | SearchTagDefinitionsAdminRequest | GetInstructionAssistanceConfigFromSsmRequest;
-declare const SiteAdminCommand: readonly ["getAgent", "getInitialData", "refreshChatApp", "createOrUpdateChatAppOverride", "deleteChatAppOverride", "getValuesForEntityAutoComplete", "getValuesForUserAutoComplete", "clearConverseLambdaCache", "clearSvelteKitCaches", "addChatSessionFeedback", "updateChatSessionFeedback", "sessionSearch", "getChatMessagesAsAdmin", "createOrUpdateTagDefinition", "deleteTagDefinition", "searchTagDefinitions", "getInstructionAssistanceConfigFromSsm"];
+type SiteAdminRequest = GetAgentRequest | GetInitialDataRequest | RefreshChatAppRequest | CreateOrUpdateChatAppOverrideRequest | DeleteChatAppOverrideRequest | GetValuesForEntityAutoCompleteRequest | GetValuesForUserAutoCompleteRequest | ClearConverseLambdaCacheRequest | ClearSvelteKitCachesRequest | AddChatSessionFeedbackAdminRequest | UpdateChatSessionFeedbackAdminRequest | SessionSearchAdminRequest | GetChatMessagesAsAdminRequest | CreateOrUpdateTagDefinitionAdminRequest | DeleteTagDefinitionAdminRequest | SearchTagDefinitionsAdminRequest | SearchSemanticDirectivesAdminRequest | SemanticDirectiveCreateOrUpdateAdminRequest | SemanticDirectiveDeleteAdminRequest | GetInstructionAssistanceConfigFromSsmRequest | GetAllChatAppsAdminRequest | GetAllAgentsAdminRequest | GetAllToolsAdminRequest;
+declare const SiteAdminCommand: readonly ["getAgent", "getInitialData", "refreshChatApp", "createOrUpdateChatAppOverride", "deleteChatAppOverride", "getValuesForEntityAutoComplete", "getValuesForUserAutoComplete", "clearConverseLambdaCache", "clearSvelteKitCaches", "addChatSessionFeedback", "updateChatSessionFeedback", "sessionSearch", "getChatMessagesAsAdmin", "createOrUpdateTagDefinition", "deleteTagDefinition", "searchTagDefinitions", "searchSemanticDirectives", "createOrUpdateSemanticDirective", "deleteSemanticDirective", "getInstructionAssistanceConfigFromSsm", "getAllChatApps", "getAllAgents", "getAllTools"];
 type SiteAdminCommand = (typeof SiteAdminCommand)[number];
 interface SiteAdminCommandRequestBase {
     command: SiteAdminCommand;
@@ -1760,6 +1803,35 @@ interface SearchTagDefinitionsAdminRequest extends SiteAdminCommandRequestBase {
     command: 'searchTagDefinitions';
     request: TagDefinitionSearchRequest;
 }
+interface SearchSemanticDirectivesAdminRequest extends SiteAdminCommandRequestBase {
+    command: 'searchSemanticDirectives';
+    request: SearchSemanticDirectivesRequest;
+}
+interface SemanticDirectiveCreateOrUpdateAdminRequest extends SiteAdminCommandRequestBase {
+    command: 'createOrUpdateSemanticDirective';
+    request: SemanticDirectiveCreateOrUpdateRequest;
+}
+interface SemanticDirectiveDeleteAdminRequest extends SiteAdminCommandRequestBase {
+    command: 'deleteSemanticDirective';
+    request: SemanticDirectiveDeleteRequest;
+}
+interface GetAllChatAppsAdminRequest extends SiteAdminCommandRequestBase {
+    command: 'getAllChatApps';
+}
+interface GetAllAgentsAdminRequest extends SiteAdminCommandRequestBase {
+    command: 'getAllAgents';
+}
+interface GetAllToolsAdminRequest extends SiteAdminCommandRequestBase {
+    command: 'getAllTools';
+}
+/**
+ * Request format for semantic directive data passed to custom CloudFormation resource
+ */
+type SemanticDirectiveDataRequest = {
+    userId: string;
+    groupId: string;
+    semanticDirectives: SemanticDirectiveForCreateOrUpdate[];
+};
 interface GetValuesForEntityAutoCompleteRequest extends SiteAdminCommandRequestBase {
     command: 'getValuesForEntityAutoComplete';
     valueProvidedByUser: string;
@@ -1803,7 +1875,7 @@ interface ClearSvelteKitCachesRequest extends SiteAdminCommandRequestBase {
     cacheType: ClearSvelteKitCacheType;
     chatAppId?: string;
 }
-declare const ClearSvelteKitCacheTypes: readonly ["chatAppCache", "tagDefinitionsCache", "instructionAssistanceConfigCache", "all"];
+declare const ClearSvelteKitCacheTypes: readonly ["chatAppCache", "tagDefinitionsCache", "instructionAssistanceConfigCache", "encryptionKeysCache", "all"];
 type ClearSvelteKitCacheType = (typeof ClearSvelteKitCacheTypes)[number];
 interface GetInstructionAssistanceConfigFromSsmRequest extends SiteAdminCommandRequestBase {
     command: 'getInstructionAssistanceConfigFromSsm';
@@ -1811,7 +1883,16 @@ interface GetInstructionAssistanceConfigFromSsmRequest extends SiteAdminCommandR
 interface GetInstructionAssistanceConfigFromSsmResponse extends SiteAdminCommandResponseBase {
     config: InstructionAssistanceConfig;
 }
-type SiteAdminResponse = GetAgentResponse | GetInitialDataResponse | RefreshChatAppResponse | CreateOrUpdateChatAppOverrideResponse | DeleteChatAppOverrideResponse | GetValuesForEntityAutoCompleteResponse | GetValuesForUserAutoCompleteResponse | ClearConverseLambdaCacheResponse | ClearSvelteKitCachesResponse | AddChatSessionFeedbackResponse | UpdateChatSessionFeedbackResponse | SessionSearchResponse | GetChatMessagesAsAdminResponse | GetInstructionAssistanceConfigFromSsmResponse;
+interface GetAllChatAppsAdminResponse extends SiteAdminCommandResponseBase {
+    chatApps: ChatApp[];
+}
+interface GetAllAgentsAdminResponse extends SiteAdminCommandResponseBase {
+    agents: AgentDefinition[];
+}
+interface GetAllToolsAdminResponse extends SiteAdminCommandResponseBase {
+    tools: ToolDefinition[];
+}
+type SiteAdminResponse = GetAgentResponse | GetInitialDataResponse | RefreshChatAppResponse | CreateOrUpdateChatAppOverrideResponse | DeleteChatAppOverrideResponse | GetValuesForEntityAutoCompleteResponse | GetValuesForUserAutoCompleteResponse | ClearConverseLambdaCacheResponse | ClearSvelteKitCachesResponse | AddChatSessionFeedbackResponse | UpdateChatSessionFeedbackResponse | SessionSearchResponse | GetChatMessagesAsAdminResponse | GetInstructionAssistanceConfigFromSsmResponse | GetAllChatAppsAdminResponse | GetAllAgentsAdminResponse | GetAllToolsAdminResponse;
 interface SiteAdminCommandResponseBase {
     success: boolean;
     error?: string;
@@ -2156,6 +2237,288 @@ interface SiteFeatures {
     tags?: TagsSiteFeature;
     /** Configure whether the agent instruction assistance feature is enabled. */
     agentInstructionAssistance?: AgentInstructionAssistanceFeature;
+    /** Configure whether the instruction augmentation feature is enabled. */
+    instructionAugmentation?: InstructionAugmentationFeature;
+}
+/**
+ * Sometimes you need to augment the prompt you will give to the LLM with additional information.
+ * Currently, only one type of augmentation is supported: llm semantic search.  This uses the scope of the
+ * agent invocation (chat app ID, agent ID, entity ID) to search for semantic directives in a database
+ * of canned semantic directives that match the scope of the agent invocation.  Then, those semantic
+ * directives are added to the prompt to be used by the LLM.  The LLM then takes the end user's message
+ * and the semantic directives and uses them to determine if any of the semantic directives should be
+ * included in the prompt.  If they should be included, then the semantic directive instruction is added to the prompt.
+ *
+ * Note that by default the feature is turned off.  To turn it on, you must set the `enabled` property to `true` or
+ * it will not be turned on.  Then, all agents will have the type of augmentation chosen.
+ *
+ * Setting this as a site wide feature sets the default instruction augmentation type used, if turned on.  Individual chat apps
+ * may override this behavior, turning off the feature or changing the augmentation type.
+ *
+ * Note that today we only support one type of augmentation: llm semantic directive search.  This is a light-weight
+ * approach with a good balance of engineer velocity (don't have to ingest and index embeddings into a knowledge base),
+ * performance and cost.
+ */
+interface InstructionAugmentationFeature {
+    enabled: boolean;
+    type?: InstructionAugmentationType;
+}
+declare const InstructionAugmentationTypes: readonly ["llm-semantic-directive-search"];
+type InstructionAugmentationType = (typeof InstructionAugmentationTypes)[number];
+declare const InstructionAugmentationTypeDisplayNames: {
+    readonly 'llm-semantic-directive-search': "LLM Semantic Directive Search";
+};
+type InstructionAugmentationTypeDisplayName = (typeof InstructionAugmentationTypeDisplayNames)[keyof typeof InstructionAugmentationTypeDisplayNames];
+declare const InstructionAugmentationScopeTypes: readonly ["chatapp", "agent", "tool", "entity", "agent-entity"];
+type InstructionAugmentationScopeType = (typeof InstructionAugmentationScopeTypes)[number];
+declare const InstructionAugmentationScopeTypeDisplayNames: {
+    readonly chatapp: "Chat App";
+    readonly agent: "Agent";
+    readonly tool: "Tool";
+    readonly entity: "Entity";
+    readonly 'agent-entity': "Agent and Entity";
+};
+type InstructionAugmentationScopeTypeDisplayName = (typeof InstructionAugmentationScopeTypeDisplayNames)[keyof typeof InstructionAugmentationScopeTypeDisplayNames];
+/**
+ * This is used to take the actual chatapp, agent, tools, and entity values used in a given agent invocation and use them
+ * to go search for the matching semantic directives in the database.
+ */
+type InvocationScopes = Partial<Record<InstructionAugmentationScopeType, (string | number | Record<string, string | number>)[] | undefined>>;
+/**
+ * A semantic directive is a special case or additional instruction paragraph that you might want the LLM to have included
+ * in its context when responding to a user's question but that doesn't belong in the main prompt.  So, the LLM will
+ * be given the semantic directives in the context of the user's question and will decide if any of them should be
+ * included in the prompt.  If they should be included, then the semantic directive instruction is added to the prompt.
+ *
+ * One of the main use cases for this is when you have a tool with certain inputs and most of the time the LLM can
+ * craft the correct inputs to your tool based on the question from an end user.  But, occasionally, you might wish to give
+ * the LLM special instructions on certain details that are specific to a certain situation.
+ *
+ * Semantic directives are stored in a database and are associated with a scope.  The scope is used to narrow down which
+ * directives we will give to the light-weight LLM to consider for inclusion in your prompt.  We first search the
+ * database based on chat app, agent, tool and entity to get the set of directives that match the scope and then have the
+ * LLM tell us if we should include them in the prompt.
+ *
+ * IMPORTANT: when you see us refer to 'entity' in a scope, it means that the entity is the entity that is associated with the user,
+ * assuming you have turned on the entity feature. The value of the entity is entityFeature.attributeName.
+ *
+ * In your pika-config.ts file, you can turn on the entity feature by setting the entity feature to true.
+ */
+interface SemanticDirective {
+    /**
+     * You don't set this value directly.  Instead, you set the scopeType and scopeValue from which we will construct the scope.
+     *
+     * Remember that we might have a database full of these semantic directives.  The scope then narrows down which
+     * directives we will give to the light-weight LLM to consider for inclusion in your prompt.  We first search the
+     * database based on chat app, agent, tool and entity to get the set of directives that match the scope and then have the
+     * LLM tell us if we should include them in the prompt.
+     *
+     * We support the following scopes at present:
+     * - chatapp: The ID of the chat app this semantic directive is associated with.
+     * - agent: The ID of the agent this semantic directive is associated with.
+     * - tool: the ID of the tool this semantic directive is associated with.
+     * - entity: The ID of the entity this semantic directive is associated with.  Of course, if your pika instance
+     *           doesn't turn on the uses of entities, then this scope will not be used.
+     *
+     * We support only the following compound scopes at present:
+     * - agent#{agent-id}#entity#{entity-id}
+     *
+     * Examples:
+     *
+     * - `chatapp#weather-chat-app`
+     * - `agent#weather-agent`
+     * - `tool#weather-tool`
+     * - `entity#account-123`
+     * - `agent#weather-agent#entity#account-123` // matches only for queries by account-123 to the weather agent
+     */
+    scope: string;
+    /**
+     * The type of scope this semantic directive is associated with.  This tells us what
+     * the value in `scopeValue` is.
+     */
+    scopeType: InstructionAugmentationScopeType;
+    /**
+     * The value of the scope this semantic directive is associated with.  This is a string or an object
+     * depending on the value of `scopeType`.
+     *
+     * If `scopeType` is `agent` then this will be the agent ID.
+     * If `scopeType` is `tool` then this will be the tool ID.
+     * If `scopeType` is `entity` then this will be the entity ID (entityFeature.attributeName from user.customData).
+     * If `scopeType` is `agent-entity` then this will be {agent: string, entity: string}.
+     */
+    scopeValue: string | number | Record<string, string | number>;
+    /**
+     * This plus scope must be unique across all semantic directives.
+     *
+     * Just a human-readable ID for the semantic directive.  Consider it a variable name: may use dashes and underscores
+     * and should start with a letter (no spaces or special characters).  E.g. "account-details", "customer-support", "order-status", etc.
+     * Used for db queries and to help engineers identify the semantic directive easily in a UI or DB.
+     */
+    id: string;
+    /**
+     * Used internally to group semantic directives created by a custom cloudformation resource. You shouldn't use this.
+     * For example, a specific agent in a given stack may include CDK to define its semantic directives.  Pika needs to
+     * know the complete set of semantic directives that exist for that group so that the agent author can have the
+     * freedom to modify semantic directive scope values. This groupId then is how the pika platform will be able
+     * to query for all the semantic directives created as a "group" by the agent author and know which semantic directives
+     * should be deleted because they are no longer present in the CDK stack.
+     *
+     * Don't set this value directly.  Instead, let the custom cloudformation resource set it for you using the
+     * `event.StackName` of the stack that created the semantic directive.
+     */
+    groupId?: string;
+    /**
+     * This is what the light-weight LLM will use to decide if the question asked by the end user means that
+     * this semantic directive should be included in the prompt to ensure the final LLM gives a correct response.
+     */
+    description: string;
+    /**
+     * If the light-weight LLM determines that this semantic directive should be included in the prompt, then these
+     * instructions will be included in the final prompt to the final LLM to guide its response.
+     */
+    instructions: string;
+    /** If true, the semantic directive will not be used to augment the prompt. */
+    disabled?: boolean;
+    /** ISO 8601 formatted timestamp of when the semantic directive was created */
+    createDate: string;
+    /** User who created the semantic directive */
+    createdBy: string;
+    /** User who last updated the semantic directive */
+    lastUpdatedBy: string;
+    /** ISO 8601 formatted timestamp of the last semantic directive update */
+    lastUpdate: string;
+}
+interface SemanticDirectiveForCreateOrUpdate extends Omit<SemanticDirective, 'scope' | 'createDate' | 'lastUpdate'> {
+    createdBy: string;
+    lastUpdatedBy: string;
+}
+interface SemanticDirectiveCreateOrUpdateRequest {
+    semanticDirective: SemanticDirectiveForCreateOrUpdate;
+    /**
+     * If you are creating one of these objects through the CloudFormation custom resource, then you should set this
+     * to be something that is tied to the stack that did the creation/update and we ask that you prepend it with 'cloudformation/'
+     * so we understand it was created/updated by cloudformation as in 'cloudformation/my-stack-name'.
+     */
+    userId: string;
+}
+interface SemanticDirectiveCreateOrUpdateResponse {
+    success: boolean;
+    semanticDirective: SemanticDirective;
+}
+interface SemanticDirectiveScope {
+    scopeType: InstructionAugmentationScopeType;
+    scopeValue: string | number | Record<string, string | number>;
+}
+/**
+ * Search request for semantic directives. Supports multiple search patterns based on our DynamoDB table design:
+ * - If findOne is provided, then we will return the first directive that matches the scopeType, scopeValue and id.
+ * - Query by specific scopes (main table access pattern)
+ * - Query by creator and date range (GSI1: createdBy + createDate)
+ * - Query by directive ID(s) across scopes (GSI2: id + scope)
+ * - Date range filtering (created or updated)
+ *
+ * If no search criteria provided, returns all directives with pagination.
+ */
+interface SearchSemanticDirectivesRequest {
+    findOne?: {
+        scopeType: InstructionAugmentationScopeType;
+        scopeValue: string | number | Record<string, string | number>;
+        id: string;
+    };
+    /**
+     * Search for directives within specific scopes.
+     * Uses parallel DynamoDB queries against the main table (PK = scope).
+     */
+    scopes?: SemanticDirectiveScope[];
+    /** Will be used by the custom cloudformation resource to query for all semantic directives created as a "group" by the agent author. */
+    groupId?: string;
+    /**
+     * Search for directives created by a specific user.
+     * When provided, results are automatically sorted by createDate (newest first by default).
+     *
+     * Uses GSI1: createdBy + createDate
+     */
+    createdBy?: string;
+    /**
+     * Search for directives by specific IDs.
+     * Returns directives matching any of the provided IDs across all scopes.
+     *
+     * Uses GSI2: id + scope
+     */
+    directiveIds?: string[];
+    /**
+     * Filter directives created after this ISO 8601 timestamp.
+     * Can be combined with other filters.
+     * Example: "2024-01-15T00:00:00Z"
+     */
+    createdAfter?: string;
+    /**
+     * Filter directives created before this ISO 8601 timestamp.
+     * Can be combined with other filters.
+     * Example: "2024-01-31T23:59:59Z"
+     */
+    createdBefore?: string;
+    /**
+     * Filter directives updated after this ISO 8601 timestamp.
+     * Can be combined with other filters.
+     */
+    updatedAfter?: string;
+    /**
+     * Filter directives updated before this ISO 8601 timestamp.
+     * Can be combined with other filters.
+     */
+    updatedBefore?: string;
+    /**
+     * Sort order for results when using createdBy search or no specific search criteria.
+     * - 'asc': Oldest first
+     * - 'desc': Newest first (default)
+     */
+    sortOrder?: 'asc' | 'desc';
+    /**
+     * Maximum number of directives to return per page.
+     * Default: 50, Max: 100
+     */
+    limit?: number;
+    /**
+     * Pagination token from previous search response.
+     * Include your original search criteria when using pagination.
+     */
+    paginationToken?: Record<string, any>;
+    /**
+     * If true, includes the full directive instructions in response.
+     * If false, returns directive metadata only (scope, id, description, dates, etc).
+     * Default: false (to save bandwidth)
+     */
+    includeInstructions?: boolean;
+    /**
+     * If true, excludes disabled directives in the response.
+     * Default: false
+     */
+    excludeDisabled?: boolean;
+}
+interface SearchSemanticDirectivesResponse {
+    success: boolean;
+    /** Array of semantic directives matching the search criteria */
+    semanticDirectives: SemanticDirective[];
+    /** Total count of directives found (may be larger than returned array due to pagination) */
+    totalCount?: number;
+    /** If present, there are more results available. Pass this token back in the next request. */
+    paginationToken?: Record<string, any>;
+}
+interface SemanticDirectiveDeleteRequest {
+    semanticDirective: {
+        scope: string;
+        id: string;
+    };
+    /**
+     * If you are deleting one of these objects through the CloudFormation custom resource, then you should set this
+     * to be something that is tied to the stack that did the deletion and we ask that you prepend it with 'cloudformation/'
+     * so we understand it was deleted by cloudformation as in 'cloudformation/my-stack-name'.
+     */
+    userId: string;
+}
+interface SemanticDirectiveDeleteResponse {
+    success: boolean;
 }
 interface TagsSiteFeature {
     /**
@@ -2654,4 +3017,4 @@ interface TagDefInJsonFile {
     gzippedBase64EncodedString: string;
 }
 
-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 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 ConverseRequest, type ConverseRequestWithCommand, type CreateAgentRequest, type CreateChatAppRequest, type CreateOrUpdateChatAppOverrideRequest, type CreateOrUpdateChatAppOverrideResponse, type CreateOrUpdateTagDefinitionAdminRequest, type CreateToolRequest, type CustomDataUiRepresentation, type DeleteChatAppOverrideRequest, type DeleteChatAppOverrideResponse, type DeleteTagDefinitionAdminRequest, EndToEndFeatureIdList, type EndToEndFeatureIdType, 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 GetChatAppsByRulesRequest, type GetChatAppsByRulesResponse, type GetChatMessagesAsAdminRequest, type GetChatMessagesAsAdminResponse, type GetChatSessionFeedbackResponse, type GetChatUserPrefsResponse, type GetInitialDataRequest, type GetInitialDataResponse, type GetInitialDialogDataRequest, type GetInitialDialogDataResponse, type GetInstructionAssistanceConfigFromSsmRequest, type GetInstructionAssistanceConfigFromSsmResponse, 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 InsightStatusNeedsInsightsAnalysis, type InsightsSearchParams, type InstructionAssistanceConfig, type InstructionFeature, type KnowledgeBase, type LifecycleStatus, type LogoutFeature, type LogoutFeatureForChatApp, type MessageSegment, type MessageSegmentBase, MessageSource, type NameValueDescTriple, type NameValuePair, type PikaConfig, type PikaStack, type PikaUserRole, PikaUserRoles, type PromptInputFieldLabelFeature, type PromptInputFieldLabelFeatureForChatApp, type RecordOrUndef, type RefreshChatAppRequest, type RefreshChatAppResponse, type RetryableVerifyResponseClassification, RetryableVerifyResponseClassifications, 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 SearchTagDefinitionsAdminRequest, type SearchToolsRequest, type SegmentType, 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 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 ToolDefinitionForCreate, type ToolDefinitionForIdempotentCreateOrUpdate, type ToolDefinitionForUpdate, type ToolIdToLambdaArnMap, type ToolLifecycle, type TracesFeature, type TracesFeatureForChatApp, UPDATEABLE_FEEDBACK_FIELDS, type UiCustomizationFeature, type UiCustomizationFeatureForChatApp, Unclassified, 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 UserOverrideData, UserOverrideDataCommand, type UserOverrideDataCommandRequest, type UserOverrideDataCommandRequestBase, type UserOverrideDataCommandResponse, type UserOverrideDataCommandResponseBase, type UserPrefs, type UserRole, type UserType, UserTypes, 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 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 CreateOrUpdateTagDefinitionAdminRequest, type CreateToolRequest, type CustomDataUiRepresentation, type DeleteChatAppOverrideRequest, type DeleteChatAppOverrideResponse, type DeleteTagDefinitionAdminRequest, EndToEndFeatureIdList, type EndToEndFeatureIdType, 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 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 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 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 MessageSegment, type MessageSegmentBase, MessageSource, type NameValueDescTriple, type NameValuePair, type OAuth, type PikaConfig, type PikaStack, type PikaUserRole, PikaUserRoles, type PromptInputFieldLabelFeature, type PromptInputFieldLabelFeatureForChatApp, type RecordOrUndef, type RefreshChatAppRequest, type RefreshChatAppResponse, type RetryableVerifyResponseClassification, RetryableVerifyResponseClassifications, 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 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 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 ToolLifecycle, type TracesFeature, type TracesFeatureForChatApp, UPDATEABLE_FEEDBACK_FIELDS, type UiCustomizationFeature, type UiCustomizationFeatureForChatApp, Unclassified, 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 UserOverrideData, UserOverrideDataCommand, type UserOverrideDataCommandRequest, type UserOverrideDataCommandRequestBase, type UserOverrideDataCommandResponse, type UserOverrideDataCommandResponseBase, type UserPrefs, type UserRole, type UserType, UserTypes, type VerifyResponseClassification, type VerifyResponseClassificationDescription, VerifyResponseClassificationDescriptions, VerifyResponseClassifications, type VerifyResponseFeature, type VerifyResponseFeatureForChatApp, type VerifyResponseRetryableClassificationDescription, VerifyResponseRetryableClassificationDescriptions, type ViewContentForUserRequest, type ViewContentForUserResponse, type VitePreviewConfig, type ViteServerConfig };