pika-shared 1.3.0 → 1.4.1

package/dist/util/chatbot-shared-utils.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/util/chatbot-shared-utils.ts"],"names":[],"mappings":";;;;AAwBO,SAAS,+BAAA,CAAgC,MAAgB,EAAA,QAAA,EAAkB,MAAwB,EAAA;AACtG,EAAA,OAAO,CAAW,QAAA,EAAA,MAAM,CAAI,CAAA,EAAA,MAAM,IAAI,QAAQ,CAAA,CAAA;AAClD;AAQO,SAAS,iBAAiB,QAA0B,EAAA;AACvD,EAAM,MAAA,YAAA,GAAe,QAAS,CAAA,WAAA,CAAY,GAAG,CAAA;AAG7C,EAAA,IAAI,iBAAiB,EAAM,IAAA,YAAA,KAAiB,SAAS,MAAS,GAAA,CAAA,IAAK,iBAAiB,CAAG,EAAA;AACnF,IAAO,OAAA,QAAA,CAAS,OAAQ,CAAA,iBAAA,EAAmB,EAAE,CAAA;AAAA;AAGjD,EAAA,MAAM,oBAAuB,GAAA,QAAA,CAAS,SAAU,CAAA,CAAA,EAAG,YAAY,CAAA;AAC/D,EAAA,MAAM,SAAY,GAAA,QAAA,CAAS,SAAU,CAAA,YAAA,GAAe,CAAC,CAAA;AAErD,EAAA,MAAM,aAAgB,GAAA,oBAAA,CAAqB,OAAQ,CAAA,iBAAA,EAAmB,EAAE,CAAA;AACxE,EAAA,MAAM,kBAAqB,GAAA,SAAA,CAAU,OAAQ,CAAA,iBAAA,EAAmB,EAAE,CAAA;AAElE,EAAA,OAAO,gBAAgB,GAAM,GAAA,kBAAA;AACjC;AAcO,SAAS,mBAAqC,IAAuB,EAAA;AACxE,EAAA,OAAO,aAAc,CAAA,IAAA,EAAM,EAAE,IAAA,EAAM,MAAM,CAAA;AAC7C;AAEO,SAAS,mBAAqD,IAAuB,EAAA;AACxF,EAAA,OAAO,aAAc,CAAA,IAAA,EAAM,EAAE,IAAA,EAAM,MAAM,CAAA;AAC7C;AAEO,SAAS,yBAAyB,GAAqB,EAAA;AAC1D,EAAA,MAAM,OAAU,GAAA,EAAE,CAAC,GAAG,GAAG,IAAK,EAAA;AAC9B,EAAM,MAAA,SAAA,GAAY,cAAc,OAAO,CAAA;AACvC,EAAA,OAAO,MAAO,CAAA,IAAA,CAAK,SAAS,CAAA,CAAE,CAAC,CAAA;AACnC","file":"chatbot-shared-utils.mjs","sourcesContent":["/**\n * These utilities are meant to be shared both client and server.\n * Don't add anything that can't be shared (especially dependencies)\n */\n\nimport type { ChatApp, ChatAppFeature, FeatureIdType } from '../types/chatbot/chatbot-types';\nimport camelcaseKeys from 'camelcase-keys';\nimport snakecaseKeys from 'snakecase-keys';\n\n/**\n * Generate a unique S3 key name for a chat file upload.\n *\n * Use the uuid module to generate the v7 uuid as in\n *\n * Replace punctation that isn't _ or - with a _\n *\n * import { v7 as uuidv7 } from 'uuid';\n * uuidv7()\n *\n * @param userId - The user id of the user uploading the file\n * @param fileName - The name of the file to upload. it should already be sanitized by calling sanitizeFileName\n * @param v7Uuid - The uuidv7 uuid of the file\n * @returns The S3 key name for the file\n */\nexport function generateChatFileUploadS3KeyName(userId: string, fileName: string, v7Uuid: string): string {\n    return `uploads/${userId}/${v7Uuid}_${fileName}`;\n}\n\n/**\n * Remove all punctuation from a file name except for the ending period for the file extension if it exists\n *\n * @param fileName - The name of the file to sanitize\n * @returns The sanitized file name\n */\nexport function sanitizeFileName(fileName: string): string {\n    const lastDotIndex = fileName.lastIndexOf('.');\n\n    // If there's no dot, or the dot is at the end, or the dot is at the beginning, just remove all punctuation\n    if (lastDotIndex === -1 || lastDotIndex === fileName.length - 1 || lastDotIndex === 0) {\n        return fileName.replace(/[^a-zA-Z0-9_-]/g, '');\n    }\n\n    const nameWithoutExtension = fileName.substring(0, lastDotIndex);\n    const extension = fileName.substring(lastDotIndex + 1);\n\n    const sanitizedName = nameWithoutExtension.replace(/[^a-zA-Z0-9_-]/g, '');\n    const sanitizedExtension = extension.replace(/[^a-zA-Z0-9_-]/g, '');\n\n    return sanitizedName + '.' + sanitizedExtension;\n}\n\ntype ToSnakeCase<S extends string> = S extends `${infer T}${infer U}` ? `${T extends Capitalize<T> ? '_' : ''}${Lowercase<T>}${ToSnakeCase<U>}` : S;\n\ntype ToCamelCase<S extends string> = S extends `${infer P1}_${infer P2}${infer P3}` ? `${Lowercase<P1>}${Uppercase<P2>}${ToCamelCase<P3>}` : Lowercase<S>;\n\nexport type SnakeCase<T> = {\n    [K in keyof T as K extends string ? ToSnakeCase<K> : K]: T[K] extends object ? SnakeCase<T[K]> : T[K];\n};\n\nexport type CamelCase<T> = {\n    [K in keyof T as K extends string ? ToCamelCase<K> : K]: T[K] extends object ? CamelCase<T[K]> : T[K];\n};\n\nexport function convertToCamelCase<T extends object>(data: SnakeCase<T>): T {\n    return camelcaseKeys(data, { deep: true }) as unknown as T;\n}\n\nexport function convertToSnakeCase<T extends { [key: string]: any }>(data: T): SnakeCase<T> {\n    return snakecaseKeys(data, { deep: true }) as SnakeCase<T>;\n}\n\nexport function convertStringToSnakeCase(str: string): string {\n    const tempObj = { [str]: true };\n    const converted = snakecaseKeys(tempObj);\n    return Object.keys(converted)[0];\n}\n\n// /**\n//  * This lets us get a feature from a chat app and make sure it is the correct type.\n//  */\n// export function getFeature<T extends FeatureIdType>(chatApp: ChatApp, featureId: T): Extract<ChatAppFeature, { featureId: T }> | undefined {\n//     const feature = chatApp.features?.[featureId];\n\n//     if (feature && feature.featureId === featureId) {\n//         return feature as Extract<ChatAppFeature, { featureId: T }>;\n//     }\n\n//     return undefined;\n// }\n"]}
+{"version":3,"sources":["../../src/util/chatbot-shared-utils.ts"],"names":[],"mappings":";;;;AAwBO,SAAS,+BAAA,CAAgC,MAAA,EAAgB,QAAA,EAAkB,MAAA,EAAwB;AACtG,EAAA,OAAO,CAAA,QAAA,EAAW,MAAM,CAAA,CAAA,EAAI,MAAM,IAAI,QAAQ,CAAA,CAAA;AAClD;AAQO,SAAS,iBAAiB,QAAA,EAA0B;AACvD,EAAA,MAAM,YAAA,GAAe,QAAA,CAAS,WAAA,CAAY,GAAG,CAAA;AAG7C,EAAA,IAAI,iBAAiB,EAAA,IAAM,YAAA,KAAiB,SAAS,MAAA,GAAS,CAAA,IAAK,iBAAiB,CAAA,EAAG;AACnF,IAAA,OAAO,QAAA,CAAS,OAAA,CAAQ,iBAAA,EAAmB,EAAE,CAAA;AAAA,EACjD;AAEA,EAAA,MAAM,oBAAA,GAAuB,QAAA,CAAS,SAAA,CAAU,CAAA,EAAG,YAAY,CAAA;AAC/D,EAAA,MAAM,SAAA,GAAY,QAAA,CAAS,SAAA,CAAU,YAAA,GAAe,CAAC,CAAA;AAErD,EAAA,MAAM,aAAA,GAAgB,oBAAA,CAAqB,OAAA,CAAQ,iBAAA,EAAmB,EAAE,CAAA;AACxE,EAAA,MAAM,kBAAA,GAAqB,SAAA,CAAU,OAAA,CAAQ,iBAAA,EAAmB,EAAE,CAAA;AAElE,EAAA,OAAO,gBAAgB,GAAA,GAAM,kBAAA;AACjC;AAcO,SAAS,mBAAqC,IAAA,EAAuB;AACxE,EAAA,OAAO,aAAA,CAAc,IAAA,EAAM,EAAE,IAAA,EAAM,MAAM,CAAA;AAC7C;AAEO,SAAS,mBAAqD,IAAA,EAAuB;AACxF,EAAA,OAAO,aAAA,CAAc,IAAA,EAAM,EAAE,IAAA,EAAM,MAAM,CAAA;AAC7C;AAEO,SAAS,yBAAyB,GAAA,EAAqB;AAC1D,EAAA,MAAM,OAAA,GAAU,EAAE,CAAC,GAAG,GAAG,IAAA,EAAK;AAC9B,EAAA,MAAM,SAAA,GAAY,cAAc,OAAO,CAAA;AACvC,EAAA,OAAO,MAAA,CAAO,IAAA,CAAK,SAAS,CAAA,CAAE,CAAC,CAAA;AACnC","file":"chatbot-shared-utils.mjs","sourcesContent":["/**\n * These utilities are meant to be shared both client and server.\n * Don't add anything that can't be shared (especially dependencies)\n */\n\nimport type { ChatApp, ChatAppFeature, FeatureIdType } from '../types/chatbot/chatbot-types';\nimport camelcaseKeys from 'camelcase-keys';\nimport snakecaseKeys from 'snakecase-keys';\n\n/**\n * Generate a unique S3 key name for a chat file upload.\n *\n * Use the uuid module to generate the v7 uuid as in\n *\n * Replace punctation that isn't _ or - with a _\n *\n * import { v7 as uuidv7 } from 'uuid';\n * uuidv7()\n *\n * @param userId - The user id of the user uploading the file\n * @param fileName - The name of the file to upload. it should already be sanitized by calling sanitizeFileName\n * @param v7Uuid - The uuidv7 uuid of the file\n * @returns The S3 key name for the file\n */\nexport function generateChatFileUploadS3KeyName(userId: string, fileName: string, v7Uuid: string): string {\n    return `uploads/${userId}/${v7Uuid}_${fileName}`;\n}\n\n/**\n * Remove all punctuation from a file name except for the ending period for the file extension if it exists\n *\n * @param fileName - The name of the file to sanitize\n * @returns The sanitized file name\n */\nexport function sanitizeFileName(fileName: string): string {\n    const lastDotIndex = fileName.lastIndexOf('.');\n\n    // If there's no dot, or the dot is at the end, or the dot is at the beginning, just remove all punctuation\n    if (lastDotIndex === -1 || lastDotIndex === fileName.length - 1 || lastDotIndex === 0) {\n        return fileName.replace(/[^a-zA-Z0-9_-]/g, '');\n    }\n\n    const nameWithoutExtension = fileName.substring(0, lastDotIndex);\n    const extension = fileName.substring(lastDotIndex + 1);\n\n    const sanitizedName = nameWithoutExtension.replace(/[^a-zA-Z0-9_-]/g, '');\n    const sanitizedExtension = extension.replace(/[^a-zA-Z0-9_-]/g, '');\n\n    return sanitizedName + '.' + sanitizedExtension;\n}\n\ntype ToSnakeCase<S extends string> = S extends `${infer T}${infer U}` ? `${T extends Capitalize<T> ? '_' : ''}${Lowercase<T>}${ToSnakeCase<U>}` : S;\n\ntype ToCamelCase<S extends string> = S extends `${infer P1}_${infer P2}${infer P3}` ? `${Lowercase<P1>}${Uppercase<P2>}${ToCamelCase<P3>}` : Lowercase<S>;\n\nexport type SnakeCase<T> = {\n    [K in keyof T as K extends string ? ToSnakeCase<K> : K]: T[K] extends object ? SnakeCase<T[K]> : T[K];\n};\n\nexport type CamelCase<T> = {\n    [K in keyof T as K extends string ? ToCamelCase<K> : K]: T[K] extends object ? CamelCase<T[K]> : T[K];\n};\n\nexport function convertToCamelCase<T extends object>(data: SnakeCase<T>): T {\n    return camelcaseKeys(data, { deep: true }) as unknown as T;\n}\n\nexport function convertToSnakeCase<T extends { [key: string]: any }>(data: T): SnakeCase<T> {\n    return snakecaseKeys(data, { deep: true }) as SnakeCase<T>;\n}\n\nexport function convertStringToSnakeCase(str: string): string {\n    const tempObj = { [str]: true };\n    const converted = snakecaseKeys(tempObj);\n    return Object.keys(converted)[0];\n}\n\n// /**\n//  * This lets us get a feature from a chat app and make sure it is the correct type.\n//  */\n// export function getFeature<T extends FeatureIdType>(chatApp: ChatApp, featureId: T): Extract<ChatAppFeature, { featureId: T }> | undefined {\n//     const feature = chatApp.features?.[featureId];\n\n//     if (feature && feature.featureId === featureId) {\n//         return feature as Extract<ChatAppFeature, { featureId: T }>;\n//     }\n\n//     return undefined;\n// }\n"]}

package/dist/util/forbidden-error.d.mts

@@ -0,0 +1,7 @@
+import { HttpStatusError } from './http-status-error.mjs';
+
+declare class ForbiddenError extends HttpStatusError {
+    constructor(message: string);
+}
+
+export { ForbiddenError };

package/dist/util/forbidden-error.d.ts

@@ -0,0 +1,7 @@
+import { HttpStatusError } from './http-status-error.js';
+
+declare class ForbiddenError extends HttpStatusError {
+    constructor(message: string);
+}
+
+export { ForbiddenError };

package/dist/util/forbidden-error.js

@@ -0,0 +1,20 @@
+'use strict';
+
+// src/util/http-status-error.ts
+var HttpStatusError = class extends Error {
+  constructor(message, statusCode) {
+    super(message);
+    this.statusCode = statusCode;
+  }
+};
+
+// src/util/forbidden-error.ts
+var ForbiddenError = class extends HttpStatusError {
+  constructor(message) {
+    super(message, 403);
+  }
+};
+
+exports.ForbiddenError = ForbiddenError;
+//# sourceMappingURL=forbidden-error.js.map
+//# sourceMappingURL=forbidden-error.js.map

package/dist/util/forbidden-error.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/util/http-status-error.ts","../../src/util/forbidden-error.ts"],"names":[],"mappings":";;;AAGO,IAAM,eAAA,GAAN,cAA8B,KAAA,CAAM;AAAA,EACvC,WAAA,CACI,SACgB,UAAA,EAClB;AACE,IAAA,KAAA,CAAM,OAAO,CAAA;AAFG,IAAA,IAAA,CAAA,UAAA,GAAA,UAAA;AAAA,EAGpB;AACJ,CAAA;;;ACRO,IAAM,cAAA,GAAN,cAA6B,eAAA,CAAgB;AAAA,EAChD,YAAY,OAAA,EAAiB;AACzB,IAAA,KAAA,CAAM,SAAS,GAAG,CAAA;AAAA,EACtB;AACJ","file":"forbidden-error.js","sourcesContent":["/**\n * Throw this error to return a specific HTTP status code from an API Gateway Lambda function.\n */\nexport class HttpStatusError extends Error {\n    constructor(\n        message: string,\n        public readonly statusCode: number\n    ) {\n        super(message);\n    }\n}\n","import { HttpStatusError } from './http-status-error';\n\nexport class ForbiddenError extends HttpStatusError {\n    constructor(message: string) {\n        super(message, 403);\n    }\n}\n"]}

package/dist/util/forbidden-error.mjs

@@ -0,0 +1,18 @@
+// src/util/http-status-error.ts
+var HttpStatusError = class extends Error {
+  constructor(message, statusCode) {
+    super(message);
+    this.statusCode = statusCode;
+  }
+};
+
+// src/util/forbidden-error.ts
+var ForbiddenError = class extends HttpStatusError {
+  constructor(message) {
+    super(message, 403);
+  }
+};
+
+export { ForbiddenError };
+//# sourceMappingURL=forbidden-error.mjs.map
+//# sourceMappingURL=forbidden-error.mjs.map

package/dist/util/forbidden-error.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/util/http-status-error.ts","../../src/util/forbidden-error.ts"],"names":[],"mappings":";AAGO,IAAM,eAAA,GAAN,cAA8B,KAAA,CAAM;AAAA,EACvC,WAAA,CACI,SACgB,UAAA,EAClB;AACE,IAAA,KAAA,CAAM,OAAO,CAAA;AAFG,IAAA,IAAA,CAAA,UAAA,GAAA,UAAA;AAAA,EAGpB;AACJ,CAAA;;;ACRO,IAAM,cAAA,GAAN,cAA6B,eAAA,CAAgB;AAAA,EAChD,YAAY,OAAA,EAAiB;AACzB,IAAA,KAAA,CAAM,SAAS,GAAG,CAAA;AAAA,EACtB;AACJ","file":"forbidden-error.mjs","sourcesContent":["/**\n * Throw this error to return a specific HTTP status code from an API Gateway Lambda function.\n */\nexport class HttpStatusError extends Error {\n    constructor(\n        message: string,\n        public readonly statusCode: number\n    ) {\n        super(message);\n    }\n}\n","import { HttpStatusError } from './http-status-error';\n\nexport class ForbiddenError extends HttpStatusError {\n    constructor(message: string) {\n        super(message, 403);\n    }\n}\n"]}

package/dist/util/http-status-error.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/util/http-status-error.ts"],"names":[],"mappings":";;;AAGa,IAAA,eAAA,GAAN,cAA8B,KAAM,CAAA;AAAA,EACvC,WAAA,CACI,SACgB,UAClB,EAAA;AACE,IAAA,KAAA,CAAM,OAAO,CAAA;AAFG,IAAA,IAAA,CAAA,UAAA,GAAA,UAAA;AAAA;AAIxB","file":"http-status-error.js","sourcesContent":["/**\n * Throw this error to return a specific HTTP status code from an API Gateway Lambda function.\n */\nexport class HttpStatusError extends Error {\n    constructor(\n        message: string,\n        public readonly statusCode: number\n    ) {\n        super(message);\n    }\n}\n"]}
+{"version":3,"sources":["../../src/util/http-status-error.ts"],"names":[],"mappings":";;;AAGO,IAAM,eAAA,GAAN,cAA8B,KAAA,CAAM;AAAA,EACvC,WAAA,CACI,SACgB,UAAA,EAClB;AACE,IAAA,KAAA,CAAM,OAAO,CAAA;AAFG,IAAA,IAAA,CAAA,UAAA,GAAA,UAAA;AAAA,EAGpB;AACJ","file":"http-status-error.js","sourcesContent":["/**\n * Throw this error to return a specific HTTP status code from an API Gateway Lambda function.\n */\nexport class HttpStatusError extends Error {\n    constructor(\n        message: string,\n        public readonly statusCode: number\n    ) {\n        super(message);\n    }\n}\n"]}

package/dist/util/http-status-error.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/util/http-status-error.ts"],"names":[],"mappings":";AAGa,IAAA,eAAA,GAAN,cAA8B,KAAM,CAAA;AAAA,EACvC,WAAA,CACI,SACgB,UAClB,EAAA;AACE,IAAA,KAAA,CAAM,OAAO,CAAA;AAFG,IAAA,IAAA,CAAA,UAAA,GAAA,UAAA;AAAA;AAIxB","file":"http-status-error.mjs","sourcesContent":["/**\n * Throw this error to return a specific HTTP status code from an API Gateway Lambda function.\n */\nexport class HttpStatusError extends Error {\n    constructor(\n        message: string,\n        public readonly statusCode: number\n    ) {\n        super(message);\n    }\n}\n"]}
+{"version":3,"sources":["../../src/util/http-status-error.ts"],"names":[],"mappings":";AAGO,IAAM,eAAA,GAAN,cAA8B,KAAA,CAAM;AAAA,EACvC,WAAA,CACI,SACgB,UAAA,EAClB;AACE,IAAA,KAAA,CAAM,OAAO,CAAA;AAFG,IAAA,IAAA,CAAA,UAAA,GAAA,UAAA;AAAA,EAGpB;AACJ","file":"http-status-error.mjs","sourcesContent":["/**\n * Throw this error to return a specific HTTP status code from an API Gateway Lambda function.\n */\nexport class HttpStatusError extends Error {\n    constructor(\n        message: string,\n        public readonly statusCode: number\n    ) {\n        super(message);\n    }\n}\n"]}

package/dist/util/instruction-assistance-utils.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/util/instruction-assistance-utils.ts"],"names":[],"mappings":"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","file":"instruction-assistance-utils.js","sourcesContent":["/**\n * IMPORTANT!!!!!!!!!!!!!!!!!!!!!!\n *\n * The functions in this utility are used both by the front end svelte kit web client in the browser\n * and in the backend lambda converse functions.  So, that means it needs to be able\n * to run in a browser.  Do not add additional imports beyond anodine types.\n *\n * To be super clear: this is just logic to generate instruction assistance content given\n * the right inputs.  It does not collect up those inputs, it is given them.\n *\n */\n\nimport type {\n    AgentInstructionChatAppOverridableFeature,\n    InstructionAssistanceConfig,\n    TagDefinition,\n    TagDefinitionWidget,\n    TagsChatAppOverridableFeature\n} from '../types/chatbot/chatbot-types';\n\n/**\n * IMPORTANT!!!!!!!!!!!!!!!!!!!!!!\n *\n * See header at top of file for important notes.\n *\n * Generate instruction assistance content based on enabled features\n *\n * @param instructionAssistanceConfig - The instruction assistance configuration from SSM\n * @param tags - The tags configuration from the chat app\n * @param agentInstructionFeature - The agent instruction feature configuration from the chat app\n * @returns The instruction assistance content\n */\nexport function generateInstructionAssistanceContent(\n    instructionAssistanceConfig: InstructionAssistanceConfig | undefined,\n    tags: TagsChatAppOverridableFeature | undefined,\n    agentInstructionFeature: AgentInstructionChatAppOverridableFeature | undefined,\n    tagDefinitions: TagDefinition<TagDefinitionWidget>[]\n): InstructionAssistanceConfig {\n    console.log('Generating instruction assistance content:', {\n        enabled: agentInstructionFeature?.enabled,\n        includeOutputFormattingRequirements: agentInstructionFeature?.includeOutputFormattingRequirements,\n        includeInstructionsForTags: agentInstructionFeature?.includeInstructionsForTags,\n        completeExampleEnabled: agentInstructionFeature?.completeExampleInstructionEnabled,\n        jsonOnlyEnabled: agentInstructionFeature?.jsonOnlyImperativeInstructionEnabled\n    });\n\n    let outputFormattingRequirements = '';\n    let tagInstructions = '';\n    let completeExampleInstructionLine = '';\n    let jsonOnlyImperativeInstructionLine = '';\n\n    if (!agentInstructionFeature?.enabled) {\n        return {\n            outputFormattingRequirements,\n            tagInstructions,\n            completeExampleInstructionLine,\n            jsonOnlyImperativeInstructionLine\n        };\n    }\n\n    // Generate output formatting requirements\n    if (agentInstructionFeature.includeOutputFormattingRequirements) {\n        outputFormattingRequirements =\n            instructionAssistanceConfig?.outputFormattingRequirements ||\n            `**Output Formatting Requirements:**\n- **Output Response Enclosure**: All response output MUST be completely enclosed within <answer></answer> tags, including supported custom tags.\n- **Output Content Format:** All responses MUST be in Markdown with supported custom tags.`;\n    }\n\n    // Generate tag instructions\n    if (agentInstructionFeature.includeInstructionsForTags && tags && tags.tagsEnabled?.length > 0) {\n        console.log('Fetching tag definitions for instruction generation:', tags.tagsEnabled);\n\n        if (tagDefinitions.length > 0) {\n            // First create a dictionary listing all supported tags\n            const tagDictionary = tagDefinitions\n                .filter((tagDef) => tagDef.canBeGeneratedByLlm && !tagDef.disabled)\n                .map((tagDef) => `  - ${tagDef.tagTitle}: \\`${tagDef.shortTagEx}\\``)\n                .join('\\n');\n\n            let tagInstructionsContent = '';\n            if (tagDictionary) {\n                tagInstructionsContent += `- **Custom Tags Supported:**\\n${tagDictionary}\\n`;\n            }\n\n            // Then add detailed instructions for each tag\n            for (const tagDef of tagDefinitions) {\n                if (tagDef.canBeGeneratedByLlm && !tagDef.disabled && tagDef.llmInstructionsMd) {\n                    const tagType = `${tagDef.scope}.${tagDef.tag}`;\n                    tagInstructionsContent += `- **${tagDef.tagTitle}:**\\n  <tag-instructions type=\"${tagType}\">\\n${tagDef.llmInstructionsMd}\\n  </tag-instructions>\\n`;\n                }\n            }\n\n            if (tagInstructionsContent) {\n                tagInstructions = tagInstructionsContent;\n            }\n        }\n    }\n\n    // Generate complete example instruction line\n    if (agentInstructionFeature.completeExampleInstructionEnabled) {\n        completeExampleInstructionLine =\n            agentInstructionFeature.completeExampleInstructionLine ||\n            instructionAssistanceConfig?.completeExampleInstructionLine ||\n            '- **Complete Example Output:**\\n  `<answer>##Example markdown\\nNormal text and an <image>http://some.url</image> and some **bold text**\\n<chart>(...)</chart></answer>`';\n    }\n\n    // Generate JSON validation instruction line\n    if (agentInstructionFeature.jsonOnlyImperativeInstructionEnabled) {\n        jsonOnlyImperativeInstructionLine =\n            agentInstructionFeature.jsonOnlyImperativeInstructionLine ||\n            instructionAssistanceConfig?.jsonOnlyImperativeInstructionLine ||\n            'BE ABSOLUTELY CERTAIN ANY JSON INCLUDED IS 100% VALID (especially for charts). Invalid JSON will break the user experience.';\n    }\n\n    console.log('Generated instruction assistance content:', {\n        hasOutputFormatting: !!outputFormattingRequirements,\n        hasTagInstructions: !!tagInstructions,\n        hasCompleteExample: !!completeExampleInstructionLine,\n        hasJsonValidation: !!jsonOnlyImperativeInstructionLine\n    });\n\n    return {\n        outputFormattingRequirements,\n        tagInstructions,\n        completeExampleInstructionLine,\n        jsonOnlyImperativeInstructionLine\n    };\n}\n\n/**\n * IMPORTANT!!!!!!!!!!!!!!!!!!!!!!\n *\n * See header at top of file for important notes.\n *\n * Apply instruction assistance to the base prompt using placeholder replacement\n */\nexport function applyInstructionAssistance(basePrompt: string, instructionContent: InstructionAssistanceConfig): string {\n    let enhancedPrompt = basePrompt;\n\n    // Check for primary placeholder first\n    if (enhancedPrompt.includes('{{prompt-assistance}}')) {\n        console.log('Found {{prompt-assistance}} placeholder');\n\n        const allContent = [\n            instructionContent.outputFormattingRequirements,\n            instructionContent.tagInstructions,\n            instructionContent.completeExampleInstructionLine,\n            instructionContent.jsonOnlyImperativeInstructionLine\n        ]\n            .filter((content) => content && content.trim().length > 0)\n            .join('\\n\\n');\n\n        enhancedPrompt = enhancedPrompt.replace('{{prompt-assistance}}', allContent);\n    } else {\n        // Look for fine-grained placeholders\n        const placeholders = [\n            { placeholder: '{{output-formatting-requirements}}', content: instructionContent.outputFormattingRequirements },\n            { placeholder: '{{tag-instructions}}', content: instructionContent.tagInstructions },\n            { placeholder: '{{complete-example-instruction-line}}', content: instructionContent.completeExampleInstructionLine },\n            { placeholder: '{{json-only-imperative-instruction-line}}', content: instructionContent.jsonOnlyImperativeInstructionLine }\n        ];\n\n        let hasAnyPlaceholder = false;\n        for (const { placeholder, content } of placeholders) {\n            if (enhancedPrompt.includes(placeholder) && content) {\n                console.log(`Found ${placeholder} placeholder`);\n                hasAnyPlaceholder = true;\n                enhancedPrompt = enhancedPrompt.replace(placeholder, content);\n            }\n        }\n\n        // If no placeholders found, append to end\n        if (!hasAnyPlaceholder) {\n            console.log('No placeholders found, appending to end of prompt');\n            const allContent = [\n                instructionContent.outputFormattingRequirements,\n                instructionContent.tagInstructions,\n                instructionContent.completeExampleInstructionLine,\n                instructionContent.jsonOnlyImperativeInstructionLine\n            ].filter((content) => content && content.trim().length > 0);\n\n            if (allContent.length > 0) {\n                enhancedPrompt = enhancedPrompt + '\\n\\n' + allContent.join('\\n\\n');\n            }\n        }\n    }\n\n    return enhancedPrompt;\n}\n\n/**\n * IMPORTANT!!!!!!!!!!!!!!!!!!!!!!\n *\n * See header at top of file for important notes.\n *\n * Get the instruction assistance configuration from raw SSM parameters\n *\n * @param params - The raw SSM parameters\n * @returns The instruction assistance configuration\n */\nexport function getInstructionsAssistanceConfigFromRawSsmParams(params: Record<string, string>): InstructionAssistanceConfig {\n    const expectedKeys = ['output-formatting-requirements', 'default-complete-example-line', 'default-json-validation-line'];\n    const missingKeys = expectedKeys.filter((key) => !params[key]);\n    if (missingKeys.length > 0) {\n        throw new Error(\n            `Missing required instruction assistance parameters: ${Object.keys(params)\n                .filter((key) => !expectedKeys.includes(key))\n                .join(', ')}`\n        );\n    }\n\n    return {\n        outputFormattingRequirements: params['output-formatting-requirements'],\n        completeExampleInstructionLine: params['default-complete-example-line'],\n        jsonOnlyImperativeInstructionLine: params['default-json-validation-line']\n    };\n}\n"]}
+{"version":3,"sources":["../../src/util/instruction-assistance-utils.ts"],"names":[],"mappings":"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","file":"instruction-assistance-utils.js","sourcesContent":["/**\n * IMPORTANT!!!!!!!!!!!!!!!!!!!!!!\n *\n * The functions in this utility are used both by the front end svelte kit web client in the browser\n * and in the backend lambda converse functions.  So, that means it needs to be able\n * to run in a browser.  Do not add additional imports beyond anodine types.\n *\n * To be super clear: this is just logic to generate instruction assistance content given\n * the right inputs.  It does not collect up those inputs, it is given them.\n *\n */\n\nimport type {\n    AgentInstructionChatAppOverridableFeature,\n    InstructionAssistanceConfig,\n    TagDefinition,\n    TagDefinitionWidget,\n    TagsChatAppOverridableFeature\n} from '../types/chatbot/chatbot-types';\n\n/**\n * IMPORTANT!!!!!!!!!!!!!!!!!!!!!!\n *\n * See header at top of file for important notes.\n *\n * Generate instruction assistance content based on enabled features\n *\n * @param instructionAssistanceConfig - The instruction assistance configuration from SSM\n * @param tags - The tags configuration from the chat app\n * @param agentInstructionFeature - The agent instruction feature configuration from the chat app\n * @returns The instruction assistance content\n */\nexport function generateInstructionAssistanceContent(\n    instructionAssistanceConfig: InstructionAssistanceConfig | undefined,\n    tags: TagsChatAppOverridableFeature | undefined,\n    agentInstructionFeature: AgentInstructionChatAppOverridableFeature | undefined,\n    tagDefinitions: TagDefinition<TagDefinitionWidget>[]\n): InstructionAssistanceConfig {\n    console.log('Generating instruction assistance content:', {\n        enabled: agentInstructionFeature?.enabled,\n        includeOutputFormattingRequirements: agentInstructionFeature?.includeOutputFormattingRequirements,\n        includeInstructionsForTags: agentInstructionFeature?.includeInstructionsForTags,\n        completeExampleEnabled: agentInstructionFeature?.completeExampleInstructionEnabled,\n        jsonOnlyEnabled: agentInstructionFeature?.jsonOnlyImperativeInstructionEnabled\n    });\n\n    let outputFormattingRequirements = '';\n    let tagInstructions = '';\n    let completeExampleInstructionLine = '';\n    let jsonOnlyImperativeInstructionLine = '';\n\n    if (!agentInstructionFeature?.enabled) {\n        return {\n            outputFormattingRequirements,\n            tagInstructions,\n            completeExampleInstructionLine,\n            jsonOnlyImperativeInstructionLine\n        };\n    }\n\n    // Generate output formatting requirements\n    if (agentInstructionFeature.includeOutputFormattingRequirements) {\n        outputFormattingRequirements =\n            instructionAssistanceConfig?.outputFormattingRequirements ||\n            `**Output Formatting Requirements:**\n- **Output Response Enclosure**: All response output MUST be completely enclosed within <answer></answer> tags, including supported custom tags.\n- **Output Content Format:** All responses MUST be in Markdown with supported custom tags.`;\n    }\n\n    // Generate tag instructions\n    if (agentInstructionFeature.includeInstructionsForTags && tags && tags.tagsEnabled?.length > 0) {\n        console.log('Fetching tag definitions for instruction generation:', tags.tagsEnabled);\n\n        if (tagDefinitions.length > 0) {\n            // First create a dictionary listing all supported tags\n            const tagDictionary = tagDefinitions\n                .filter((tagDef) => tagDef.canBeGeneratedByLlm && !tagDef.disabled)\n                .map((tagDef) => `  - ${tagDef.tagTitle}: \\`${tagDef.shortTagEx}\\``)\n                .join('\\n');\n\n            let tagInstructionsContent = '';\n            if (tagDictionary) {\n                tagInstructionsContent += `- **Custom Tags Supported:**\\n${tagDictionary}\\n`;\n            }\n\n            // Then add detailed instructions for each tag\n            for (const tagDef of tagDefinitions) {\n                if (tagDef.canBeGeneratedByLlm && !tagDef.disabled && tagDef.llmInstructionsMd) {\n                    const tagType = `${tagDef.scope}.${tagDef.tag}`;\n                    tagInstructionsContent += `- **${tagDef.tagTitle}:**\\n  <tag-instructions type=\"${tagType}\">\\n${tagDef.llmInstructionsMd}\\n  </tag-instructions>\\n`;\n                }\n            }\n\n            if (tagInstructionsContent) {\n                tagInstructions = tagInstructionsContent;\n            }\n        }\n    }\n\n    // Generate complete example instruction line\n    if (agentInstructionFeature.completeExampleInstructionEnabled) {\n        completeExampleInstructionLine =\n            agentInstructionFeature.completeExampleInstructionLine ||\n            instructionAssistanceConfig?.completeExampleInstructionLine ||\n            '- **Complete Example Output:**\\n  `<answer>##Example markdown\\nNormal text and an <image>http://some.url</image> and some **bold text**\\n<chart>(...)</chart></answer>`';\n    }\n\n    // Generate JSON validation instruction line\n    if (agentInstructionFeature.jsonOnlyImperativeInstructionEnabled) {\n        jsonOnlyImperativeInstructionLine =\n            agentInstructionFeature.jsonOnlyImperativeInstructionLine ||\n            instructionAssistanceConfig?.jsonOnlyImperativeInstructionLine ||\n            'BE ABSOLUTELY CERTAIN ANY JSON INCLUDED IS 100% VALID (especially for charts). Invalid JSON will break the user experience.';\n    }\n\n    console.log('Generated instruction assistance content:', {\n        hasOutputFormatting: !!outputFormattingRequirements,\n        hasTagInstructions: !!tagInstructions,\n        hasCompleteExample: !!completeExampleInstructionLine,\n        hasJsonValidation: !!jsonOnlyImperativeInstructionLine\n    });\n\n    return {\n        outputFormattingRequirements,\n        tagInstructions,\n        completeExampleInstructionLine,\n        jsonOnlyImperativeInstructionLine\n    };\n}\n\n/**\n * IMPORTANT!!!!!!!!!!!!!!!!!!!!!!\n *\n * See header at top of file for important notes.\n *\n * Apply instruction assistance to the base prompt using placeholder replacement\n */\nexport function applyInstructionAssistance(basePrompt: string, instructionContent: InstructionAssistanceConfig): string {\n    let enhancedPrompt = basePrompt;\n\n    // Check for primary placeholder first\n    if (enhancedPrompt.includes('{{prompt-assistance}}')) {\n        console.log('Found {{prompt-assistance}} placeholder');\n\n        const allContent = [\n            instructionContent.outputFormattingRequirements,\n            instructionContent.tagInstructions,\n            instructionContent.completeExampleInstructionLine,\n            instructionContent.jsonOnlyImperativeInstructionLine\n        ]\n            .filter((content) => content && content.trim().length > 0)\n            .join('\\n\\n');\n\n        enhancedPrompt = enhancedPrompt.replace('{{prompt-assistance}}', allContent);\n    } else {\n        // Look for fine-grained placeholders\n        const placeholders = [\n            { placeholder: '{{output-formatting-requirements}}', content: instructionContent.outputFormattingRequirements },\n            { placeholder: '{{tag-instructions}}', content: instructionContent.tagInstructions },\n            { placeholder: '{{complete-example-instruction-line}}', content: instructionContent.completeExampleInstructionLine },\n            { placeholder: '{{json-only-imperative-instruction-line}}', content: instructionContent.jsonOnlyImperativeInstructionLine }\n        ];\n\n        let hasAnyPlaceholder = false;\n        for (const { placeholder, content } of placeholders) {\n            if (enhancedPrompt.includes(placeholder) && content) {\n                console.log(`Found ${placeholder} placeholder`);\n                hasAnyPlaceholder = true;\n                enhancedPrompt = enhancedPrompt.replace(placeholder, content);\n            }\n        }\n\n        // If no placeholders found, append to end\n        if (!hasAnyPlaceholder) {\n            console.log('No placeholders found, appending to end of prompt');\n            const allContent = [\n                instructionContent.outputFormattingRequirements,\n                instructionContent.tagInstructions,\n                instructionContent.completeExampleInstructionLine,\n                instructionContent.jsonOnlyImperativeInstructionLine\n            ].filter((content) => content && content.trim().length > 0);\n\n            if (allContent.length > 0) {\n                enhancedPrompt = enhancedPrompt + '\\n\\n' + allContent.join('\\n\\n');\n            }\n        }\n    }\n\n    return enhancedPrompt;\n}\n\n/**\n * IMPORTANT!!!!!!!!!!!!!!!!!!!!!!\n *\n * See header at top of file for important notes.\n *\n * Get the instruction assistance configuration from raw SSM parameters\n *\n * @param params - The raw SSM parameters\n * @returns The instruction assistance configuration\n */\nexport function getInstructionsAssistanceConfigFromRawSsmParams(params: Record<string, string>): InstructionAssistanceConfig {\n    const expectedKeys = ['output-formatting-requirements', 'default-complete-example-line', 'default-json-validation-line'];\n    const missingKeys = expectedKeys.filter((key) => !params[key]);\n    if (missingKeys.length > 0) {\n        throw new Error(\n            `Missing required instruction assistance parameters: ${Object.keys(params)\n                .filter((key) => !expectedKeys.includes(key))\n                .join(', ')}`\n        );\n    }\n\n    return {\n        outputFormattingRequirements: params['output-formatting-requirements'],\n        completeExampleInstructionLine: params['default-complete-example-line'],\n        jsonOnlyImperativeInstructionLine: params['default-json-validation-line']\n    };\n}\n"]}

package/dist/util/instruction-assistance-utils.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/util/instruction-assistance-utils.ts"],"names":[],"mappings":"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","file":"instruction-assistance-utils.mjs","sourcesContent":["/**\n * IMPORTANT!!!!!!!!!!!!!!!!!!!!!!\n *\n * The functions in this utility are used both by the front end svelte kit web client in the browser\n * and in the backend lambda converse functions.  So, that means it needs to be able\n * to run in a browser.  Do not add additional imports beyond anodine types.\n *\n * To be super clear: this is just logic to generate instruction assistance content given\n * the right inputs.  It does not collect up those inputs, it is given them.\n *\n */\n\nimport type {\n    AgentInstructionChatAppOverridableFeature,\n    InstructionAssistanceConfig,\n    TagDefinition,\n    TagDefinitionWidget,\n    TagsChatAppOverridableFeature\n} from '../types/chatbot/chatbot-types';\n\n/**\n * IMPORTANT!!!!!!!!!!!!!!!!!!!!!!\n *\n * See header at top of file for important notes.\n *\n * Generate instruction assistance content based on enabled features\n *\n * @param instructionAssistanceConfig - The instruction assistance configuration from SSM\n * @param tags - The tags configuration from the chat app\n * @param agentInstructionFeature - The agent instruction feature configuration from the chat app\n * @returns The instruction assistance content\n */\nexport function generateInstructionAssistanceContent(\n    instructionAssistanceConfig: InstructionAssistanceConfig | undefined,\n    tags: TagsChatAppOverridableFeature | undefined,\n    agentInstructionFeature: AgentInstructionChatAppOverridableFeature | undefined,\n    tagDefinitions: TagDefinition<TagDefinitionWidget>[]\n): InstructionAssistanceConfig {\n    console.log('Generating instruction assistance content:', {\n        enabled: agentInstructionFeature?.enabled,\n        includeOutputFormattingRequirements: agentInstructionFeature?.includeOutputFormattingRequirements,\n        includeInstructionsForTags: agentInstructionFeature?.includeInstructionsForTags,\n        completeExampleEnabled: agentInstructionFeature?.completeExampleInstructionEnabled,\n        jsonOnlyEnabled: agentInstructionFeature?.jsonOnlyImperativeInstructionEnabled\n    });\n\n    let outputFormattingRequirements = '';\n    let tagInstructions = '';\n    let completeExampleInstructionLine = '';\n    let jsonOnlyImperativeInstructionLine = '';\n\n    if (!agentInstructionFeature?.enabled) {\n        return {\n            outputFormattingRequirements,\n            tagInstructions,\n            completeExampleInstructionLine,\n            jsonOnlyImperativeInstructionLine\n        };\n    }\n\n    // Generate output formatting requirements\n    if (agentInstructionFeature.includeOutputFormattingRequirements) {\n        outputFormattingRequirements =\n            instructionAssistanceConfig?.outputFormattingRequirements ||\n            `**Output Formatting Requirements:**\n- **Output Response Enclosure**: All response output MUST be completely enclosed within <answer></answer> tags, including supported custom tags.\n- **Output Content Format:** All responses MUST be in Markdown with supported custom tags.`;\n    }\n\n    // Generate tag instructions\n    if (agentInstructionFeature.includeInstructionsForTags && tags && tags.tagsEnabled?.length > 0) {\n        console.log('Fetching tag definitions for instruction generation:', tags.tagsEnabled);\n\n        if (tagDefinitions.length > 0) {\n            // First create a dictionary listing all supported tags\n            const tagDictionary = tagDefinitions\n                .filter((tagDef) => tagDef.canBeGeneratedByLlm && !tagDef.disabled)\n                .map((tagDef) => `  - ${tagDef.tagTitle}: \\`${tagDef.shortTagEx}\\``)\n                .join('\\n');\n\n            let tagInstructionsContent = '';\n            if (tagDictionary) {\n                tagInstructionsContent += `- **Custom Tags Supported:**\\n${tagDictionary}\\n`;\n            }\n\n            // Then add detailed instructions for each tag\n            for (const tagDef of tagDefinitions) {\n                if (tagDef.canBeGeneratedByLlm && !tagDef.disabled && tagDef.llmInstructionsMd) {\n                    const tagType = `${tagDef.scope}.${tagDef.tag}`;\n                    tagInstructionsContent += `- **${tagDef.tagTitle}:**\\n  <tag-instructions type=\"${tagType}\">\\n${tagDef.llmInstructionsMd}\\n  </tag-instructions>\\n`;\n                }\n            }\n\n            if (tagInstructionsContent) {\n                tagInstructions = tagInstructionsContent;\n            }\n        }\n    }\n\n    // Generate complete example instruction line\n    if (agentInstructionFeature.completeExampleInstructionEnabled) {\n        completeExampleInstructionLine =\n            agentInstructionFeature.completeExampleInstructionLine ||\n            instructionAssistanceConfig?.completeExampleInstructionLine ||\n            '- **Complete Example Output:**\\n  `<answer>##Example markdown\\nNormal text and an <image>http://some.url</image> and some **bold text**\\n<chart>(...)</chart></answer>`';\n    }\n\n    // Generate JSON validation instruction line\n    if (agentInstructionFeature.jsonOnlyImperativeInstructionEnabled) {\n        jsonOnlyImperativeInstructionLine =\n            agentInstructionFeature.jsonOnlyImperativeInstructionLine ||\n            instructionAssistanceConfig?.jsonOnlyImperativeInstructionLine ||\n            'BE ABSOLUTELY CERTAIN ANY JSON INCLUDED IS 100% VALID (especially for charts). Invalid JSON will break the user experience.';\n    }\n\n    console.log('Generated instruction assistance content:', {\n        hasOutputFormatting: !!outputFormattingRequirements,\n        hasTagInstructions: !!tagInstructions,\n        hasCompleteExample: !!completeExampleInstructionLine,\n        hasJsonValidation: !!jsonOnlyImperativeInstructionLine\n    });\n\n    return {\n        outputFormattingRequirements,\n        tagInstructions,\n        completeExampleInstructionLine,\n        jsonOnlyImperativeInstructionLine\n    };\n}\n\n/**\n * IMPORTANT!!!!!!!!!!!!!!!!!!!!!!\n *\n * See header at top of file for important notes.\n *\n * Apply instruction assistance to the base prompt using placeholder replacement\n */\nexport function applyInstructionAssistance(basePrompt: string, instructionContent: InstructionAssistanceConfig): string {\n    let enhancedPrompt = basePrompt;\n\n    // Check for primary placeholder first\n    if (enhancedPrompt.includes('{{prompt-assistance}}')) {\n        console.log('Found {{prompt-assistance}} placeholder');\n\n        const allContent = [\n            instructionContent.outputFormattingRequirements,\n            instructionContent.tagInstructions,\n            instructionContent.completeExampleInstructionLine,\n            instructionContent.jsonOnlyImperativeInstructionLine\n        ]\n            .filter((content) => content && content.trim().length > 0)\n            .join('\\n\\n');\n\n        enhancedPrompt = enhancedPrompt.replace('{{prompt-assistance}}', allContent);\n    } else {\n        // Look for fine-grained placeholders\n        const placeholders = [\n            { placeholder: '{{output-formatting-requirements}}', content: instructionContent.outputFormattingRequirements },\n            { placeholder: '{{tag-instructions}}', content: instructionContent.tagInstructions },\n            { placeholder: '{{complete-example-instruction-line}}', content: instructionContent.completeExampleInstructionLine },\n            { placeholder: '{{json-only-imperative-instruction-line}}', content: instructionContent.jsonOnlyImperativeInstructionLine }\n        ];\n\n        let hasAnyPlaceholder = false;\n        for (const { placeholder, content } of placeholders) {\n            if (enhancedPrompt.includes(placeholder) && content) {\n                console.log(`Found ${placeholder} placeholder`);\n                hasAnyPlaceholder = true;\n                enhancedPrompt = enhancedPrompt.replace(placeholder, content);\n            }\n        }\n\n        // If no placeholders found, append to end\n        if (!hasAnyPlaceholder) {\n            console.log('No placeholders found, appending to end of prompt');\n            const allContent = [\n                instructionContent.outputFormattingRequirements,\n                instructionContent.tagInstructions,\n                instructionContent.completeExampleInstructionLine,\n                instructionContent.jsonOnlyImperativeInstructionLine\n            ].filter((content) => content && content.trim().length > 0);\n\n            if (allContent.length > 0) {\n                enhancedPrompt = enhancedPrompt + '\\n\\n' + allContent.join('\\n\\n');\n            }\n        }\n    }\n\n    return enhancedPrompt;\n}\n\n/**\n * IMPORTANT!!!!!!!!!!!!!!!!!!!!!!\n *\n * See header at top of file for important notes.\n *\n * Get the instruction assistance configuration from raw SSM parameters\n *\n * @param params - The raw SSM parameters\n * @returns The instruction assistance configuration\n */\nexport function getInstructionsAssistanceConfigFromRawSsmParams(params: Record<string, string>): InstructionAssistanceConfig {\n    const expectedKeys = ['output-formatting-requirements', 'default-complete-example-line', 'default-json-validation-line'];\n    const missingKeys = expectedKeys.filter((key) => !params[key]);\n    if (missingKeys.length > 0) {\n        throw new Error(\n            `Missing required instruction assistance parameters: ${Object.keys(params)\n                .filter((key) => !expectedKeys.includes(key))\n                .join(', ')}`\n        );\n    }\n\n    return {\n        outputFormattingRequirements: params['output-formatting-requirements'],\n        completeExampleInstructionLine: params['default-complete-example-line'],\n        jsonOnlyImperativeInstructionLine: params['default-json-validation-line']\n    };\n}\n"]}
+{"version":3,"sources":["../../src/util/instruction-assistance-utils.ts"],"names":[],"mappings":"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","file":"instruction-assistance-utils.mjs","sourcesContent":["/**\n * IMPORTANT!!!!!!!!!!!!!!!!!!!!!!\n *\n * The functions in this utility are used both by the front end svelte kit web client in the browser\n * and in the backend lambda converse functions.  So, that means it needs to be able\n * to run in a browser.  Do not add additional imports beyond anodine types.\n *\n * To be super clear: this is just logic to generate instruction assistance content given\n * the right inputs.  It does not collect up those inputs, it is given them.\n *\n */\n\nimport type {\n    AgentInstructionChatAppOverridableFeature,\n    InstructionAssistanceConfig,\n    TagDefinition,\n    TagDefinitionWidget,\n    TagsChatAppOverridableFeature\n} from '../types/chatbot/chatbot-types';\n\n/**\n * IMPORTANT!!!!!!!!!!!!!!!!!!!!!!\n *\n * See header at top of file for important notes.\n *\n * Generate instruction assistance content based on enabled features\n *\n * @param instructionAssistanceConfig - The instruction assistance configuration from SSM\n * @param tags - The tags configuration from the chat app\n * @param agentInstructionFeature - The agent instruction feature configuration from the chat app\n * @returns The instruction assistance content\n */\nexport function generateInstructionAssistanceContent(\n    instructionAssistanceConfig: InstructionAssistanceConfig | undefined,\n    tags: TagsChatAppOverridableFeature | undefined,\n    agentInstructionFeature: AgentInstructionChatAppOverridableFeature | undefined,\n    tagDefinitions: TagDefinition<TagDefinitionWidget>[]\n): InstructionAssistanceConfig {\n    console.log('Generating instruction assistance content:', {\n        enabled: agentInstructionFeature?.enabled,\n        includeOutputFormattingRequirements: agentInstructionFeature?.includeOutputFormattingRequirements,\n        includeInstructionsForTags: agentInstructionFeature?.includeInstructionsForTags,\n        completeExampleEnabled: agentInstructionFeature?.completeExampleInstructionEnabled,\n        jsonOnlyEnabled: agentInstructionFeature?.jsonOnlyImperativeInstructionEnabled\n    });\n\n    let outputFormattingRequirements = '';\n    let tagInstructions = '';\n    let completeExampleInstructionLine = '';\n    let jsonOnlyImperativeInstructionLine = '';\n\n    if (!agentInstructionFeature?.enabled) {\n        return {\n            outputFormattingRequirements,\n            tagInstructions,\n            completeExampleInstructionLine,\n            jsonOnlyImperativeInstructionLine\n        };\n    }\n\n    // Generate output formatting requirements\n    if (agentInstructionFeature.includeOutputFormattingRequirements) {\n        outputFormattingRequirements =\n            instructionAssistanceConfig?.outputFormattingRequirements ||\n            `**Output Formatting Requirements:**\n- **Output Response Enclosure**: All response output MUST be completely enclosed within <answer></answer> tags, including supported custom tags.\n- **Output Content Format:** All responses MUST be in Markdown with supported custom tags.`;\n    }\n\n    // Generate tag instructions\n    if (agentInstructionFeature.includeInstructionsForTags && tags && tags.tagsEnabled?.length > 0) {\n        console.log('Fetching tag definitions for instruction generation:', tags.tagsEnabled);\n\n        if (tagDefinitions.length > 0) {\n            // First create a dictionary listing all supported tags\n            const tagDictionary = tagDefinitions\n                .filter((tagDef) => tagDef.canBeGeneratedByLlm && !tagDef.disabled)\n                .map((tagDef) => `  - ${tagDef.tagTitle}: \\`${tagDef.shortTagEx}\\``)\n                .join('\\n');\n\n            let tagInstructionsContent = '';\n            if (tagDictionary) {\n                tagInstructionsContent += `- **Custom Tags Supported:**\\n${tagDictionary}\\n`;\n            }\n\n            // Then add detailed instructions for each tag\n            for (const tagDef of tagDefinitions) {\n                if (tagDef.canBeGeneratedByLlm && !tagDef.disabled && tagDef.llmInstructionsMd) {\n                    const tagType = `${tagDef.scope}.${tagDef.tag}`;\n                    tagInstructionsContent += `- **${tagDef.tagTitle}:**\\n  <tag-instructions type=\"${tagType}\">\\n${tagDef.llmInstructionsMd}\\n  </tag-instructions>\\n`;\n                }\n            }\n\n            if (tagInstructionsContent) {\n                tagInstructions = tagInstructionsContent;\n            }\n        }\n    }\n\n    // Generate complete example instruction line\n    if (agentInstructionFeature.completeExampleInstructionEnabled) {\n        completeExampleInstructionLine =\n            agentInstructionFeature.completeExampleInstructionLine ||\n            instructionAssistanceConfig?.completeExampleInstructionLine ||\n            '- **Complete Example Output:**\\n  `<answer>##Example markdown\\nNormal text and an <image>http://some.url</image> and some **bold text**\\n<chart>(...)</chart></answer>`';\n    }\n\n    // Generate JSON validation instruction line\n    if (agentInstructionFeature.jsonOnlyImperativeInstructionEnabled) {\n        jsonOnlyImperativeInstructionLine =\n            agentInstructionFeature.jsonOnlyImperativeInstructionLine ||\n            instructionAssistanceConfig?.jsonOnlyImperativeInstructionLine ||\n            'BE ABSOLUTELY CERTAIN ANY JSON INCLUDED IS 100% VALID (especially for charts). Invalid JSON will break the user experience.';\n    }\n\n    console.log('Generated instruction assistance content:', {\n        hasOutputFormatting: !!outputFormattingRequirements,\n        hasTagInstructions: !!tagInstructions,\n        hasCompleteExample: !!completeExampleInstructionLine,\n        hasJsonValidation: !!jsonOnlyImperativeInstructionLine\n    });\n\n    return {\n        outputFormattingRequirements,\n        tagInstructions,\n        completeExampleInstructionLine,\n        jsonOnlyImperativeInstructionLine\n    };\n}\n\n/**\n * IMPORTANT!!!!!!!!!!!!!!!!!!!!!!\n *\n * See header at top of file for important notes.\n *\n * Apply instruction assistance to the base prompt using placeholder replacement\n */\nexport function applyInstructionAssistance(basePrompt: string, instructionContent: InstructionAssistanceConfig): string {\n    let enhancedPrompt = basePrompt;\n\n    // Check for primary placeholder first\n    if (enhancedPrompt.includes('{{prompt-assistance}}')) {\n        console.log('Found {{prompt-assistance}} placeholder');\n\n        const allContent = [\n            instructionContent.outputFormattingRequirements,\n            instructionContent.tagInstructions,\n            instructionContent.completeExampleInstructionLine,\n            instructionContent.jsonOnlyImperativeInstructionLine\n        ]\n            .filter((content) => content && content.trim().length > 0)\n            .join('\\n\\n');\n\n        enhancedPrompt = enhancedPrompt.replace('{{prompt-assistance}}', allContent);\n    } else {\n        // Look for fine-grained placeholders\n        const placeholders = [\n            { placeholder: '{{output-formatting-requirements}}', content: instructionContent.outputFormattingRequirements },\n            { placeholder: '{{tag-instructions}}', content: instructionContent.tagInstructions },\n            { placeholder: '{{complete-example-instruction-line}}', content: instructionContent.completeExampleInstructionLine },\n            { placeholder: '{{json-only-imperative-instruction-line}}', content: instructionContent.jsonOnlyImperativeInstructionLine }\n        ];\n\n        let hasAnyPlaceholder = false;\n        for (const { placeholder, content } of placeholders) {\n            if (enhancedPrompt.includes(placeholder) && content) {\n                console.log(`Found ${placeholder} placeholder`);\n                hasAnyPlaceholder = true;\n                enhancedPrompt = enhancedPrompt.replace(placeholder, content);\n            }\n        }\n\n        // If no placeholders found, append to end\n        if (!hasAnyPlaceholder) {\n            console.log('No placeholders found, appending to end of prompt');\n            const allContent = [\n                instructionContent.outputFormattingRequirements,\n                instructionContent.tagInstructions,\n                instructionContent.completeExampleInstructionLine,\n                instructionContent.jsonOnlyImperativeInstructionLine\n            ].filter((content) => content && content.trim().length > 0);\n\n            if (allContent.length > 0) {\n                enhancedPrompt = enhancedPrompt + '\\n\\n' + allContent.join('\\n\\n');\n            }\n        }\n    }\n\n    return enhancedPrompt;\n}\n\n/**\n * IMPORTANT!!!!!!!!!!!!!!!!!!!!!!\n *\n * See header at top of file for important notes.\n *\n * Get the instruction assistance configuration from raw SSM parameters\n *\n * @param params - The raw SSM parameters\n * @returns The instruction assistance configuration\n */\nexport function getInstructionsAssistanceConfigFromRawSsmParams(params: Record<string, string>): InstructionAssistanceConfig {\n    const expectedKeys = ['output-formatting-requirements', 'default-complete-example-line', 'default-json-validation-line'];\n    const missingKeys = expectedKeys.filter((key) => !params[key]);\n    if (missingKeys.length > 0) {\n        throw new Error(\n            `Missing required instruction assistance parameters: ${Object.keys(params)\n                .filter((key) => !expectedKeys.includes(key))\n                .join(', ')}`\n        );\n    }\n\n    return {\n        outputFormattingRequirements: params['output-formatting-requirements'],\n        completeExampleInstructionLine: params['default-complete-example-line'],\n        jsonOnlyImperativeInstructionLine: params['default-json-validation-line']\n    };\n}\n"]}

package/dist/util/jwt.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/util/jwt.ts"],"names":["jwt2"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAIA,IAAI,GAAM,GAAAA,eAAA;AACV,IAAI,aAAa,GAAK,EAAA;AAClB,EAAA,GAAA,GAAM,IAAI,SAAS,CAAA;AACvB;AAUO,SAAS,kBAAA,CAAwD,SAAqC,SAA2B,EAAA;AACpI,EAAA,OAAO,IAAI,IAAK,CAAA,OAAA,EAAS,WAAW,EAAE,SAAA,EAAW,MAAM,CAAA;AAC3D;AAWO,SAAS,oBAAA,CAA0D,UAAkB,SAA8E,EAAA;AACtK,EAAI,IAAA;AAEA,IAAM,MAAA,KAAA,GAAQ,SAAS,UAAW,CAAA,SAAS,IAAI,QAAS,CAAA,SAAA,CAAU,CAAC,CAAI,GAAA,QAAA;AACvE,IAAA,MAAM,OAAU,GAAA,GAAA,CAAI,MAAO,CAAA,KAAA,EAAO,SAAS,CAAA;AAE3C,IAAI,IAAA,MAAA;AACJ,IAAI,IAAA,cAAA;AAEJ,IAAA,IAAI,OAAO,OAAY,KAAA,QAAA,IAAY,OAAY,KAAA,IAAA,IAAQ,YAAY,OAAS,EAAA;AACxE,MAAA,MAAA,GAAU,OAA+B,CAAA,MAAA;AACzC,MAAA,cAAA,GAAkB,QAAkC,cAAkB,IAAA,KAAA,CAAA;AACtE,MAAA,OAAO,CAAC,EAAE,MAAQ,EAAA,cAAA,IAAkB,KAAS,CAAA,CAAA;AAAA;AAGjD,IAAO,OAAA,CAAC,KAAK,qDAAqD,CAAA;AAAA,WAC7D,KAAO,EAAA;AACZ,IAAA,OAAA,CAAQ,IAAI,uCAAyC,EAAA,KAAA,YAAiB,KAAQ,GAAA,KAAA,CAAM,UAAU,eAAe,CAAA;AAC7G,IAAO,OAAA,CAAC,KAAK,CAAqD,mDAAA,CAAA,CAAA;AAAA;AAE1E","file":"jwt.js","sourcesContent":["import type { RecordOrUndef, SimpleAuthenticatedUser } from '../types/chatbot/chatbot-types';\nimport * as jwt2 from 'jsonwebtoken';\n\n// Added this because running locally did not import default correctly\nlet jwt = jwt2;\nif ('default' in jwt) {\n    jwt = jwt['default'] as any;\n}\n\n/**\n * Converts a payload containing a userId and optional customUserData into a JWT string.\n *\n * Here the generic T is the type of the customUserData field.  If not known, pass unknown.\n *\n * @param payload The payload to convert to a JWT string.\n * @returns A JWT string.\n */\nexport function convertToJwtString<T extends RecordOrUndef = undefined>(payload: SimpleAuthenticatedUser<T>, jwtSecret: string): string {\n    return jwt.sign(payload, jwtSecret, { expiresIn: '1h' });\n}\n\n/**\n * Extracts the payload from a JWT string.  If successful, the first value in the tuple will be the SimpleAuthenticatedUser<T> object.\n * If not successful, the first value in the tuple will be the number of the HTTP status code and the second value will be the error message,\n * so check the first value to see if it is a number and if it is, then the second value will be the error message.\n *\n * Here the generic T is the type of the customUserData field.  If not known, pass unknown.\n * @param jwtToken - The JWT string to decode. Can include \"Bearer \" prefix which will be stripped.\n * @returns An object containing the userId and optional customUserData or the number of the HTTP status code and the error message.\n */\nexport function extractFromJwtString<T extends RecordOrUndef = undefined>(jwtToken: string, jwtSecret: string): [SimpleAuthenticatedUser<T> | number, string | undefined] {\n    try {\n        // Strip \"Bearer \" prefix if present\n        const token = jwtToken.startsWith('Bearer ') ? jwtToken.substring(7) : jwtToken;\n        const decoded = jwt.verify(token, jwtSecret);\n\n        let userId: string;\n        let customUserData: T | undefined;\n\n        if (typeof decoded === 'object' && decoded !== null && 'userId' in decoded) {\n            userId = (decoded as { userId: string }).userId;\n            customUserData = (decoded as { customUserData: T }).customUserData ?? undefined;\n            return [{ userId, customUserData }, undefined];\n        }\n\n        return [401, 'Unauthorized: Invalid or expired JWT token: code 1A'];\n    } catch (error) {\n        console.log('extractFromJwtString - Error message:', error instanceof Error ? error.message : 'Unknown error');\n        return [401, `Unauthorized: Invalid or expired JWT token: code 1B`];\n    }\n}\n"]}
+{"version":3,"sources":["../../src/util/jwt.ts"],"names":["jwt2"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAIA,IAAI,GAAA,GAAMA,eAAA;AACV,IAAI,aAAa,GAAA,EAAK;AAClB,EAAA,GAAA,GAAM,IAAI,SAAS,CAAA;AACvB;AAUO,SAAS,kBAAA,CAAwD,SAAqC,SAAA,EAA2B;AACpI,EAAA,OAAO,IAAI,IAAA,CAAK,OAAA,EAAS,WAAW,EAAE,SAAA,EAAW,MAAM,CAAA;AAC3D;AAWO,SAAS,oBAAA,CAA0D,UAAkB,SAAA,EAA8E;AACtK,EAAA,IAAI;AAEA,IAAA,MAAM,KAAA,GAAQ,SAAS,UAAA,CAAW,SAAS,IAAI,QAAA,CAAS,SAAA,CAAU,CAAC,CAAA,GAAI,QAAA;AACvE,IAAA,MAAM,OAAA,GAAU,GAAA,CAAI,MAAA,CAAO,KAAA,EAAO,SAAS,CAAA;AAE3C,IAAA,IAAI,MAAA;AACJ,IAAA,IAAI,cAAA;AAEJ,IAAA,IAAI,OAAO,OAAA,KAAY,QAAA,IAAY,OAAA,KAAY,IAAA,IAAQ,YAAY,OAAA,EAAS;AACxE,MAAA,MAAA,GAAU,OAAA,CAA+B,MAAA;AACzC,MAAA,cAAA,GAAkB,QAAkC,cAAA,IAAkB,KAAA,CAAA;AACtE,MAAA,OAAO,CAAC,EAAE,MAAA,EAAQ,cAAA,IAAkB,KAAA,CAAS,CAAA;AAAA,IACjD;AAEA,IAAA,OAAO,CAAC,KAAK,qDAAqD,CAAA;AAAA,EACtE,SAAS,KAAA,EAAO;AACZ,IAAA,OAAA,CAAQ,IAAI,uCAAA,EAAyC,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,UAAU,eAAe,CAAA;AAC7G,IAAA,OAAO,CAAC,KAAK,CAAA,mDAAA,CAAqD,CAAA;AAAA,EACtE;AACJ","file":"jwt.js","sourcesContent":["import type { RecordOrUndef, SimpleAuthenticatedUser } from '../types/chatbot/chatbot-types';\nimport * as jwt2 from 'jsonwebtoken';\n\n// Added this because running locally did not import default correctly\nlet jwt = jwt2;\nif ('default' in jwt) {\n    jwt = jwt['default'] as any;\n}\n\n/**\n * Converts a payload containing a userId and optional customUserData into a JWT string.\n *\n * Here the generic T is the type of the customUserData field.  If not known, pass unknown.\n *\n * @param payload The payload to convert to a JWT string.\n * @returns A JWT string.\n */\nexport function convertToJwtString<T extends RecordOrUndef = undefined>(payload: SimpleAuthenticatedUser<T>, jwtSecret: string): string {\n    return jwt.sign(payload, jwtSecret, { expiresIn: '1h' });\n}\n\n/**\n * Extracts the payload from a JWT string.  If successful, the first value in the tuple will be the SimpleAuthenticatedUser<T> object.\n * If not successful, the first value in the tuple will be the number of the HTTP status code and the second value will be the error message,\n * so check the first value to see if it is a number and if it is, then the second value will be the error message.\n *\n * Here the generic T is the type of the customUserData field.  If not known, pass unknown.\n * @param jwtToken - The JWT string to decode. Can include \"Bearer \" prefix which will be stripped.\n * @returns An object containing the userId and optional customUserData or the number of the HTTP status code and the error message.\n */\nexport function extractFromJwtString<T extends RecordOrUndef = undefined>(jwtToken: string, jwtSecret: string): [SimpleAuthenticatedUser<T> | number, string | undefined] {\n    try {\n        // Strip \"Bearer \" prefix if present\n        const token = jwtToken.startsWith('Bearer ') ? jwtToken.substring(7) : jwtToken;\n        const decoded = jwt.verify(token, jwtSecret);\n\n        let userId: string;\n        let customUserData: T | undefined;\n\n        if (typeof decoded === 'object' && decoded !== null && 'userId' in decoded) {\n            userId = (decoded as { userId: string }).userId;\n            customUserData = (decoded as { customUserData: T }).customUserData ?? undefined;\n            return [{ userId, customUserData }, undefined];\n        }\n\n        return [401, 'Unauthorized: Invalid or expired JWT token: code 1A'];\n    } catch (error) {\n        console.log('extractFromJwtString - Error message:', error instanceof Error ? error.message : 'Unknown error');\n        return [401, `Unauthorized: Invalid or expired JWT token: code 1B`];\n    }\n}\n"]}

package/dist/util/jwt.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/util/jwt.ts"],"names":[],"mappings":";;;AAIA,IAAI,GAAM,GAAA,IAAA;AACV,IAAI,aAAa,GAAK,EAAA;AAClB,EAAA,GAAA,GAAM,IAAI,SAAS,CAAA;AACvB;AAUO,SAAS,kBAAA,CAAwD,SAAqC,SAA2B,EAAA;AACpI,EAAA,OAAO,IAAI,IAAK,CAAA,OAAA,EAAS,WAAW,EAAE,SAAA,EAAW,MAAM,CAAA;AAC3D;AAWO,SAAS,oBAAA,CAA0D,UAAkB,SAA8E,EAAA;AACtK,EAAI,IAAA;AAEA,IAAM,MAAA,KAAA,GAAQ,SAAS,UAAW,CAAA,SAAS,IAAI,QAAS,CAAA,SAAA,CAAU,CAAC,CAAI,GAAA,QAAA;AACvE,IAAA,MAAM,OAAU,GAAA,GAAA,CAAI,MAAO,CAAA,KAAA,EAAO,SAAS,CAAA;AAE3C,IAAI,IAAA,MAAA;AACJ,IAAI,IAAA,cAAA;AAEJ,IAAA,IAAI,OAAO,OAAY,KAAA,QAAA,IAAY,OAAY,KAAA,IAAA,IAAQ,YAAY,OAAS,EAAA;AACxE,MAAA,MAAA,GAAU,OAA+B,CAAA,MAAA;AACzC,MAAA,cAAA,GAAkB,QAAkC,cAAkB,IAAA,KAAA,CAAA;AACtE,MAAA,OAAO,CAAC,EAAE,MAAQ,EAAA,cAAA,IAAkB,KAAS,CAAA,CAAA;AAAA;AAGjD,IAAO,OAAA,CAAC,KAAK,qDAAqD,CAAA;AAAA,WAC7D,KAAO,EAAA;AACZ,IAAA,OAAA,CAAQ,IAAI,uCAAyC,EAAA,KAAA,YAAiB,KAAQ,GAAA,KAAA,CAAM,UAAU,eAAe,CAAA;AAC7G,IAAO,OAAA,CAAC,KAAK,CAAqD,mDAAA,CAAA,CAAA;AAAA;AAE1E","file":"jwt.mjs","sourcesContent":["import type { RecordOrUndef, SimpleAuthenticatedUser } from '../types/chatbot/chatbot-types';\nimport * as jwt2 from 'jsonwebtoken';\n\n// Added this because running locally did not import default correctly\nlet jwt = jwt2;\nif ('default' in jwt) {\n    jwt = jwt['default'] as any;\n}\n\n/**\n * Converts a payload containing a userId and optional customUserData into a JWT string.\n *\n * Here the generic T is the type of the customUserData field.  If not known, pass unknown.\n *\n * @param payload The payload to convert to a JWT string.\n * @returns A JWT string.\n */\nexport function convertToJwtString<T extends RecordOrUndef = undefined>(payload: SimpleAuthenticatedUser<T>, jwtSecret: string): string {\n    return jwt.sign(payload, jwtSecret, { expiresIn: '1h' });\n}\n\n/**\n * Extracts the payload from a JWT string.  If successful, the first value in the tuple will be the SimpleAuthenticatedUser<T> object.\n * If not successful, the first value in the tuple will be the number of the HTTP status code and the second value will be the error message,\n * so check the first value to see if it is a number and if it is, then the second value will be the error message.\n *\n * Here the generic T is the type of the customUserData field.  If not known, pass unknown.\n * @param jwtToken - The JWT string to decode. Can include \"Bearer \" prefix which will be stripped.\n * @returns An object containing the userId and optional customUserData or the number of the HTTP status code and the error message.\n */\nexport function extractFromJwtString<T extends RecordOrUndef = undefined>(jwtToken: string, jwtSecret: string): [SimpleAuthenticatedUser<T> | number, string | undefined] {\n    try {\n        // Strip \"Bearer \" prefix if present\n        const token = jwtToken.startsWith('Bearer ') ? jwtToken.substring(7) : jwtToken;\n        const decoded = jwt.verify(token, jwtSecret);\n\n        let userId: string;\n        let customUserData: T | undefined;\n\n        if (typeof decoded === 'object' && decoded !== null && 'userId' in decoded) {\n            userId = (decoded as { userId: string }).userId;\n            customUserData = (decoded as { customUserData: T }).customUserData ?? undefined;\n            return [{ userId, customUserData }, undefined];\n        }\n\n        return [401, 'Unauthorized: Invalid or expired JWT token: code 1A'];\n    } catch (error) {\n        console.log('extractFromJwtString - Error message:', error instanceof Error ? error.message : 'Unknown error');\n        return [401, `Unauthorized: Invalid or expired JWT token: code 1B`];\n    }\n}\n"]}
+{"version":3,"sources":["../../src/util/jwt.ts"],"names":[],"mappings":";;;AAIA,IAAI,GAAA,GAAM,IAAA;AACV,IAAI,aAAa,GAAA,EAAK;AAClB,EAAA,GAAA,GAAM,IAAI,SAAS,CAAA;AACvB;AAUO,SAAS,kBAAA,CAAwD,SAAqC,SAAA,EAA2B;AACpI,EAAA,OAAO,IAAI,IAAA,CAAK,OAAA,EAAS,WAAW,EAAE,SAAA,EAAW,MAAM,CAAA;AAC3D;AAWO,SAAS,oBAAA,CAA0D,UAAkB,SAAA,EAA8E;AACtK,EAAA,IAAI;AAEA,IAAA,MAAM,KAAA,GAAQ,SAAS,UAAA,CAAW,SAAS,IAAI,QAAA,CAAS,SAAA,CAAU,CAAC,CAAA,GAAI,QAAA;AACvE,IAAA,MAAM,OAAA,GAAU,GAAA,CAAI,MAAA,CAAO,KAAA,EAAO,SAAS,CAAA;AAE3C,IAAA,IAAI,MAAA;AACJ,IAAA,IAAI,cAAA;AAEJ,IAAA,IAAI,OAAO,OAAA,KAAY,QAAA,IAAY,OAAA,KAAY,IAAA,IAAQ,YAAY,OAAA,EAAS;AACxE,MAAA,MAAA,GAAU,OAAA,CAA+B,MAAA;AACzC,MAAA,cAAA,GAAkB,QAAkC,cAAA,IAAkB,KAAA,CAAA;AACtE,MAAA,OAAO,CAAC,EAAE,MAAA,EAAQ,cAAA,IAAkB,KAAA,CAAS,CAAA;AAAA,IACjD;AAEA,IAAA,OAAO,CAAC,KAAK,qDAAqD,CAAA;AAAA,EACtE,SAAS,KAAA,EAAO;AACZ,IAAA,OAAA,CAAQ,IAAI,uCAAA,EAAyC,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,UAAU,eAAe,CAAA;AAC7G,IAAA,OAAO,CAAC,KAAK,CAAA,mDAAA,CAAqD,CAAA;AAAA,EACtE;AACJ","file":"jwt.mjs","sourcesContent":["import type { RecordOrUndef, SimpleAuthenticatedUser } from '../types/chatbot/chatbot-types';\nimport * as jwt2 from 'jsonwebtoken';\n\n// Added this because running locally did not import default correctly\nlet jwt = jwt2;\nif ('default' in jwt) {\n    jwt = jwt['default'] as any;\n}\n\n/**\n * Converts a payload containing a userId and optional customUserData into a JWT string.\n *\n * Here the generic T is the type of the customUserData field.  If not known, pass unknown.\n *\n * @param payload The payload to convert to a JWT string.\n * @returns A JWT string.\n */\nexport function convertToJwtString<T extends RecordOrUndef = undefined>(payload: SimpleAuthenticatedUser<T>, jwtSecret: string): string {\n    return jwt.sign(payload, jwtSecret, { expiresIn: '1h' });\n}\n\n/**\n * Extracts the payload from a JWT string.  If successful, the first value in the tuple will be the SimpleAuthenticatedUser<T> object.\n * If not successful, the first value in the tuple will be the number of the HTTP status code and the second value will be the error message,\n * so check the first value to see if it is a number and if it is, then the second value will be the error message.\n *\n * Here the generic T is the type of the customUserData field.  If not known, pass unknown.\n * @param jwtToken - The JWT string to decode. Can include \"Bearer \" prefix which will be stripped.\n * @returns An object containing the userId and optional customUserData or the number of the HTTP status code and the error message.\n */\nexport function extractFromJwtString<T extends RecordOrUndef = undefined>(jwtToken: string, jwtSecret: string): [SimpleAuthenticatedUser<T> | number, string | undefined] {\n    try {\n        // Strip \"Bearer \" prefix if present\n        const token = jwtToken.startsWith('Bearer ') ? jwtToken.substring(7) : jwtToken;\n        const decoded = jwt.verify(token, jwtSecret);\n\n        let userId: string;\n        let customUserData: T | undefined;\n\n        if (typeof decoded === 'object' && decoded !== null && 'userId' in decoded) {\n            userId = (decoded as { userId: string }).userId;\n            customUserData = (decoded as { customUserData: T }).customUserData ?? undefined;\n            return [{ userId, customUserData }, undefined];\n        }\n\n        return [401, 'Unauthorized: Invalid or expired JWT token: code 1A'];\n    } catch (error) {\n        console.log('extractFromJwtString - Error message:', error instanceof Error ? error.message : 'Unknown error');\n        return [401, `Unauthorized: Invalid or expired JWT token: code 1B`];\n    }\n}\n"]}

package/dist/util/server-client-utils.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/util/server-client-utils.ts"],"names":[],"mappings":"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","file":"server-client-utils.js","sourcesContent":["/*\n * These are utils that are safe to use both on the server and the client.\n */\n\n/**\n * Helper function to redact sensitive data from specified attributes\n * @param data - The object containing data to redact\n * @param attributesToRedact - Single attribute name or array of attribute names to redact\n * @returns A new object with specified attributes redacted\n */\nfunction redactData(data: any, attributesToRedact: string | string[]): any {\n    if (!data || typeof data !== 'object') {\n        return data;\n    }\n\n    const attributes = Array.isArray(attributesToRedact) ? attributesToRedact : [attributesToRedact];\n    const redacted = { ...data };\n\n    for (const attr of attributes) {\n        if (attr in redacted) {\n            redacted[attr] = redactValue(redacted[attr]);\n        }\n    }\n\n    return redacted;\n}\n\n/**\n * Recursively redacts a value based on its type\n * @param value - The value to redact\n * @returns The redacted value\n */\nfunction redactValue(value: any): any {\n    if (typeof value === 'string') {\n        return '[REDACTED]';\n    } else if (Array.isArray(value)) {\n        return value.map((item) => redactValue(item));\n    } else if (value && typeof value === 'object') {\n        const redactedObj: any = {};\n        for (const key in value) {\n            if (value.hasOwnProperty(key)) {\n                redactedObj[key] = redactValue(value[key]);\n            }\n        }\n        return redactedObj;\n    }\n    return value; // Return as-is for other types (numbers, booleans, null, etc.)\n}\n\n/**\n * Validates that a scope value doesn't contain the '#' character which is reserved for scope construction\n */\nfunction validateScopeValue(scopeValue: string | number | Record<string, string | number>, scopeType: string): void {\n    if (typeof scopeValue === 'string' && scopeValue.includes('#')) {\n        throw new Error(`Scope value cannot contain '#' character. Found in ${scopeType} scope value: ${scopeValue}`);\n    }\n    if (typeof scopeValue === 'object' && scopeValue !== null) {\n        for (const [key, value] of Object.entries(scopeValue)) {\n            if (typeof value === 'string' && value.includes('#')) {\n                throw new Error(`Scope value cannot contain '#' character. Found in ${scopeType}.${key}: ${value}`);\n            }\n        }\n    }\n}\n\n/**\n * Constructs a scope string from scopeType and scopeValue\n * @param scopeType - The type of scope (chatapp, agent, tool, entity, agent-entity)\n * @param scopeValue - The value(s) for the scope\n * @returns The constructed scope string\n */\nfunction constructScope(scopeType: string, scopeValue: string | number | Record<string, string | number>): string {\n    // Validate scope value doesn't contain '#'\n    validateScopeValue(scopeValue, scopeType);\n\n    switch (scopeType) {\n        case 'chatapp':\n        case 'agent':\n        case 'tool':\n        case 'entity':\n            return `${scopeType}#${scopeValue}`;\n        case 'agent-entity':\n            if (typeof scopeValue !== 'object' || scopeValue === null) {\n                throw new Error('agent-entity scopeType requires an object with agent and entity properties');\n            }\n\n            const agentEntityValue = scopeValue as Record<string, string | number>;\n            if (!('agent' in agentEntityValue) || !('entity' in agentEntityValue)) {\n                throw new Error('agent-entity scopeType requires an object with both agent and entity properties');\n            }\n\n            return `agent#${agentEntityValue.agent}#entity#${agentEntityValue.entity}`;\n\n        default:\n            throw new Error(`Unsupported scopeType: ${scopeType}`);\n    }\n}\n\n/**\n * Parses a scope string back into scopeType and scopeValue\n * @param scope - The scope string to parse\n * @returns Object containing scopeType and scopeValue\n */\nfunction parseScope(scope: string): { scopeType: string; scopeValue: string | number | Record<string, string | number> } {\n    if (!scope || typeof scope !== 'string') {\n        throw new Error('Invalid scope: must be a non-empty string');\n    }\n\n    const parts = scope.split('#');\n    if (parts.length < 2) {\n        throw new Error(`Invalid scope format: ${scope}. Expected format: scopeType#scopeValue`);\n    }\n\n    const [firstType, firstValue, ...remaining] = parts;\n\n    // Handle compound scopes (agent-entity)\n    if (remaining.length >= 2 && firstType === 'agent' && remaining[0] === 'entity') {\n        return {\n            scopeType: 'agent-entity',\n            scopeValue: {\n                agent: firstValue,\n                entity: remaining[1]\n            }\n        };\n    }\n\n    // Handle simple scopes\n    if (remaining.length === 0) {\n        // For simple scopes, try to convert to number if it's numeric\n        const numericValue = Number(firstValue);\n        const scopeValue = !isNaN(numericValue) && isFinite(numericValue) ? numericValue : firstValue;\n\n        return {\n            scopeType: firstType,\n            scopeValue: scopeValue\n        };\n    }\n\n    throw new Error(`Unsupported scope format: ${scope}`);\n}\n\n// Export both functions\nexport { redactData, redactValue, constructScope, parseScope };\n"]}
+{"version":3,"sources":["../../src/util/server-client-utils.ts"],"names":[],"mappings":"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","file":"server-client-utils.js","sourcesContent":["/*\n * These are utils that are safe to use both on the server and the client.\n */\n\n/**\n * Helper function to redact sensitive data from specified attributes\n * @param data - The object containing data to redact\n * @param attributesToRedact - Single attribute name or array of attribute names to redact\n * @returns A new object with specified attributes redacted\n */\nfunction redactData(data: any, attributesToRedact: string | string[]): any {\n    if (!data || typeof data !== 'object') {\n        return data;\n    }\n\n    const attributes = Array.isArray(attributesToRedact) ? attributesToRedact : [attributesToRedact];\n    const redacted = { ...data };\n\n    for (const attr of attributes) {\n        if (attr in redacted) {\n            redacted[attr] = redactValue(redacted[attr]);\n        }\n    }\n\n    return redacted;\n}\n\n/**\n * Recursively redacts a value based on its type\n * @param value - The value to redact\n * @returns The redacted value\n */\nfunction redactValue(value: any): any {\n    if (typeof value === 'string') {\n        return '[REDACTED]';\n    } else if (Array.isArray(value)) {\n        return value.map((item) => redactValue(item));\n    } else if (value && typeof value === 'object') {\n        const redactedObj: any = {};\n        for (const key in value) {\n            if (value.hasOwnProperty(key)) {\n                redactedObj[key] = redactValue(value[key]);\n            }\n        }\n        return redactedObj;\n    }\n    return value; // Return as-is for other types (numbers, booleans, null, etc.)\n}\n\n/**\n * Validates that a scope value doesn't contain the '#' character which is reserved for scope construction\n */\nfunction validateScopeValue(scopeValue: string | number | Record<string, string | number>, scopeType: string): void {\n    if (typeof scopeValue === 'string' && scopeValue.includes('#')) {\n        throw new Error(`Scope value cannot contain '#' character. Found in ${scopeType} scope value: ${scopeValue}`);\n    }\n    if (typeof scopeValue === 'object' && scopeValue !== null) {\n        for (const [key, value] of Object.entries(scopeValue)) {\n            if (typeof value === 'string' && value.includes('#')) {\n                throw new Error(`Scope value cannot contain '#' character. Found in ${scopeType}.${key}: ${value}`);\n            }\n        }\n    }\n}\n\n/**\n * Constructs a scope string from scopeType and scopeValue\n * @param scopeType - The type of scope (chatapp, agent, tool, entity, agent-entity)\n * @param scopeValue - The value(s) for the scope\n * @returns The constructed scope string\n */\nfunction constructScope(scopeType: string, scopeValue: string | number | Record<string, string | number>): string {\n    // Validate scope value doesn't contain '#'\n    validateScopeValue(scopeValue, scopeType);\n\n    switch (scopeType) {\n        case 'chatapp':\n        case 'agent':\n        case 'tool':\n        case 'entity':\n            return `${scopeType}#${scopeValue}`;\n        case 'agent-entity':\n            if (typeof scopeValue !== 'object' || scopeValue === null) {\n                throw new Error('agent-entity scopeType requires an object with agent and entity properties');\n            }\n\n            const agentEntityValue = scopeValue as Record<string, string | number>;\n            if (!('agent' in agentEntityValue) || !('entity' in agentEntityValue)) {\n                throw new Error('agent-entity scopeType requires an object with both agent and entity properties');\n            }\n\n            return `agent#${agentEntityValue.agent}#entity#${agentEntityValue.entity}`;\n\n        default:\n            throw new Error(`Unsupported scopeType: ${scopeType}`);\n    }\n}\n\n/**\n * Parses a scope string back into scopeType and scopeValue\n * @param scope - The scope string to parse\n * @returns Object containing scopeType and scopeValue\n */\nfunction parseScope(scope: string): { scopeType: string; scopeValue: string | number | Record<string, string | number> } {\n    if (!scope || typeof scope !== 'string') {\n        throw new Error('Invalid scope: must be a non-empty string');\n    }\n\n    const parts = scope.split('#');\n    if (parts.length < 2) {\n        throw new Error(`Invalid scope format: ${scope}. Expected format: scopeType#scopeValue`);\n    }\n\n    const [firstType, firstValue, ...remaining] = parts;\n\n    // Handle compound scopes (agent-entity)\n    if (remaining.length >= 2 && firstType === 'agent' && remaining[0] === 'entity') {\n        return {\n            scopeType: 'agent-entity',\n            scopeValue: {\n                agent: firstValue,\n                entity: remaining[1]\n            }\n        };\n    }\n\n    // Handle simple scopes\n    if (remaining.length === 0) {\n        // For simple scopes, try to convert to number if it's numeric\n        const numericValue = Number(firstValue);\n        const scopeValue = !isNaN(numericValue) && isFinite(numericValue) ? numericValue : firstValue;\n\n        return {\n            scopeType: firstType,\n            scopeValue: scopeValue\n        };\n    }\n\n    throw new Error(`Unsupported scope format: ${scope}`);\n}\n\n// Export both functions\nexport { redactData, redactValue, constructScope, parseScope };\n"]}

package/dist/util/server-client-utils.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/util/server-client-utils.ts"],"names":[],"mappings":"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","file":"server-client-utils.mjs","sourcesContent":["/*\n * These are utils that are safe to use both on the server and the client.\n */\n\n/**\n * Helper function to redact sensitive data from specified attributes\n * @param data - The object containing data to redact\n * @param attributesToRedact - Single attribute name or array of attribute names to redact\n * @returns A new object with specified attributes redacted\n */\nfunction redactData(data: any, attributesToRedact: string | string[]): any {\n    if (!data || typeof data !== 'object') {\n        return data;\n    }\n\n    const attributes = Array.isArray(attributesToRedact) ? attributesToRedact : [attributesToRedact];\n    const redacted = { ...data };\n\n    for (const attr of attributes) {\n        if (attr in redacted) {\n            redacted[attr] = redactValue(redacted[attr]);\n        }\n    }\n\n    return redacted;\n}\n\n/**\n * Recursively redacts a value based on its type\n * @param value - The value to redact\n * @returns The redacted value\n */\nfunction redactValue(value: any): any {\n    if (typeof value === 'string') {\n        return '[REDACTED]';\n    } else if (Array.isArray(value)) {\n        return value.map((item) => redactValue(item));\n    } else if (value && typeof value === 'object') {\n        const redactedObj: any = {};\n        for (const key in value) {\n            if (value.hasOwnProperty(key)) {\n                redactedObj[key] = redactValue(value[key]);\n            }\n        }\n        return redactedObj;\n    }\n    return value; // Return as-is for other types (numbers, booleans, null, etc.)\n}\n\n/**\n * Validates that a scope value doesn't contain the '#' character which is reserved for scope construction\n */\nfunction validateScopeValue(scopeValue: string | number | Record<string, string | number>, scopeType: string): void {\n    if (typeof scopeValue === 'string' && scopeValue.includes('#')) {\n        throw new Error(`Scope value cannot contain '#' character. Found in ${scopeType} scope value: ${scopeValue}`);\n    }\n    if (typeof scopeValue === 'object' && scopeValue !== null) {\n        for (const [key, value] of Object.entries(scopeValue)) {\n            if (typeof value === 'string' && value.includes('#')) {\n                throw new Error(`Scope value cannot contain '#' character. Found in ${scopeType}.${key}: ${value}`);\n            }\n        }\n    }\n}\n\n/**\n * Constructs a scope string from scopeType and scopeValue\n * @param scopeType - The type of scope (chatapp, agent, tool, entity, agent-entity)\n * @param scopeValue - The value(s) for the scope\n * @returns The constructed scope string\n */\nfunction constructScope(scopeType: string, scopeValue: string | number | Record<string, string | number>): string {\n    // Validate scope value doesn't contain '#'\n    validateScopeValue(scopeValue, scopeType);\n\n    switch (scopeType) {\n        case 'chatapp':\n        case 'agent':\n        case 'tool':\n        case 'entity':\n            return `${scopeType}#${scopeValue}`;\n        case 'agent-entity':\n            if (typeof scopeValue !== 'object' || scopeValue === null) {\n                throw new Error('agent-entity scopeType requires an object with agent and entity properties');\n            }\n\n            const agentEntityValue = scopeValue as Record<string, string | number>;\n            if (!('agent' in agentEntityValue) || !('entity' in agentEntityValue)) {\n                throw new Error('agent-entity scopeType requires an object with both agent and entity properties');\n            }\n\n            return `agent#${agentEntityValue.agent}#entity#${agentEntityValue.entity}`;\n\n        default:\n            throw new Error(`Unsupported scopeType: ${scopeType}`);\n    }\n}\n\n/**\n * Parses a scope string back into scopeType and scopeValue\n * @param scope - The scope string to parse\n * @returns Object containing scopeType and scopeValue\n */\nfunction parseScope(scope: string): { scopeType: string; scopeValue: string | number | Record<string, string | number> } {\n    if (!scope || typeof scope !== 'string') {\n        throw new Error('Invalid scope: must be a non-empty string');\n    }\n\n    const parts = scope.split('#');\n    if (parts.length < 2) {\n        throw new Error(`Invalid scope format: ${scope}. Expected format: scopeType#scopeValue`);\n    }\n\n    const [firstType, firstValue, ...remaining] = parts;\n\n    // Handle compound scopes (agent-entity)\n    if (remaining.length >= 2 && firstType === 'agent' && remaining[0] === 'entity') {\n        return {\n            scopeType: 'agent-entity',\n            scopeValue: {\n                agent: firstValue,\n                entity: remaining[1]\n            }\n        };\n    }\n\n    // Handle simple scopes\n    if (remaining.length === 0) {\n        // For simple scopes, try to convert to number if it's numeric\n        const numericValue = Number(firstValue);\n        const scopeValue = !isNaN(numericValue) && isFinite(numericValue) ? numericValue : firstValue;\n\n        return {\n            scopeType: firstType,\n            scopeValue: scopeValue\n        };\n    }\n\n    throw new Error(`Unsupported scope format: ${scope}`);\n}\n\n// Export both functions\nexport { redactData, redactValue, constructScope, parseScope };\n"]}
+{"version":3,"sources":["../../src/util/server-client-utils.ts"],"names":[],"mappings":"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","file":"server-client-utils.mjs","sourcesContent":["/*\n * These are utils that are safe to use both on the server and the client.\n */\n\n/**\n * Helper function to redact sensitive data from specified attributes\n * @param data - The object containing data to redact\n * @param attributesToRedact - Single attribute name or array of attribute names to redact\n * @returns A new object with specified attributes redacted\n */\nfunction redactData(data: any, attributesToRedact: string | string[]): any {\n    if (!data || typeof data !== 'object') {\n        return data;\n    }\n\n    const attributes = Array.isArray(attributesToRedact) ? attributesToRedact : [attributesToRedact];\n    const redacted = { ...data };\n\n    for (const attr of attributes) {\n        if (attr in redacted) {\n            redacted[attr] = redactValue(redacted[attr]);\n        }\n    }\n\n    return redacted;\n}\n\n/**\n * Recursively redacts a value based on its type\n * @param value - The value to redact\n * @returns The redacted value\n */\nfunction redactValue(value: any): any {\n    if (typeof value === 'string') {\n        return '[REDACTED]';\n    } else if (Array.isArray(value)) {\n        return value.map((item) => redactValue(item));\n    } else if (value && typeof value === 'object') {\n        const redactedObj: any = {};\n        for (const key in value) {\n            if (value.hasOwnProperty(key)) {\n                redactedObj[key] = redactValue(value[key]);\n            }\n        }\n        return redactedObj;\n    }\n    return value; // Return as-is for other types (numbers, booleans, null, etc.)\n}\n\n/**\n * Validates that a scope value doesn't contain the '#' character which is reserved for scope construction\n */\nfunction validateScopeValue(scopeValue: string | number | Record<string, string | number>, scopeType: string): void {\n    if (typeof scopeValue === 'string' && scopeValue.includes('#')) {\n        throw new Error(`Scope value cannot contain '#' character. Found in ${scopeType} scope value: ${scopeValue}`);\n    }\n    if (typeof scopeValue === 'object' && scopeValue !== null) {\n        for (const [key, value] of Object.entries(scopeValue)) {\n            if (typeof value === 'string' && value.includes('#')) {\n                throw new Error(`Scope value cannot contain '#' character. Found in ${scopeType}.${key}: ${value}`);\n            }\n        }\n    }\n}\n\n/**\n * Constructs a scope string from scopeType and scopeValue\n * @param scopeType - The type of scope (chatapp, agent, tool, entity, agent-entity)\n * @param scopeValue - The value(s) for the scope\n * @returns The constructed scope string\n */\nfunction constructScope(scopeType: string, scopeValue: string | number | Record<string, string | number>): string {\n    // Validate scope value doesn't contain '#'\n    validateScopeValue(scopeValue, scopeType);\n\n    switch (scopeType) {\n        case 'chatapp':\n        case 'agent':\n        case 'tool':\n        case 'entity':\n            return `${scopeType}#${scopeValue}`;\n        case 'agent-entity':\n            if (typeof scopeValue !== 'object' || scopeValue === null) {\n                throw new Error('agent-entity scopeType requires an object with agent and entity properties');\n            }\n\n            const agentEntityValue = scopeValue as Record<string, string | number>;\n            if (!('agent' in agentEntityValue) || !('entity' in agentEntityValue)) {\n                throw new Error('agent-entity scopeType requires an object with both agent and entity properties');\n            }\n\n            return `agent#${agentEntityValue.agent}#entity#${agentEntityValue.entity}`;\n\n        default:\n            throw new Error(`Unsupported scopeType: ${scopeType}`);\n    }\n}\n\n/**\n * Parses a scope string back into scopeType and scopeValue\n * @param scope - The scope string to parse\n * @returns Object containing scopeType and scopeValue\n */\nfunction parseScope(scope: string): { scopeType: string; scopeValue: string | number | Record<string, string | number> } {\n    if (!scope || typeof scope !== 'string') {\n        throw new Error('Invalid scope: must be a non-empty string');\n    }\n\n    const parts = scope.split('#');\n    if (parts.length < 2) {\n        throw new Error(`Invalid scope format: ${scope}. Expected format: scopeType#scopeValue`);\n    }\n\n    const [firstType, firstValue, ...remaining] = parts;\n\n    // Handle compound scopes (agent-entity)\n    if (remaining.length >= 2 && firstType === 'agent' && remaining[0] === 'entity') {\n        return {\n            scopeType: 'agent-entity',\n            scopeValue: {\n                agent: firstValue,\n                entity: remaining[1]\n            }\n        };\n    }\n\n    // Handle simple scopes\n    if (remaining.length === 0) {\n        // For simple scopes, try to convert to number if it's numeric\n        const numericValue = Number(firstValue);\n        const scopeValue = !isNaN(numericValue) && isFinite(numericValue) ? numericValue : firstValue;\n\n        return {\n            scopeType: firstType,\n            scopeValue: scopeValue\n        };\n    }\n\n    throw new Error(`Unsupported scope format: ${scope}`);\n}\n\n// Export both functions\nexport { redactData, redactValue, constructScope, parseScope };\n"]}

package/dist/util/server-utils.d.mts

@@ -1,4 +1,44 @@
+import { SiteFeatures, ChatApp, AuthenticatedUser, RecordOrUndef, ChatAppOverridableFeatures, AccessRules, ChatUser } from '../types/chatbot/chatbot-types.mjs';
+import '@aws-sdk/client-bedrock-agent-runtime';
+import '@aws-sdk/client-bedrock-agentcore';
+
 declare function gunzipBase64EncodedString(base64EncodedString: string): string;
 declare function gzipAndBase64EncodeString(string: string): string;
+/**
+ * Compute what features the user is and isn't allowed to use for this chat app.
+ *
+ * Feature hierarchy (in order of precedence):
+ * 1. Site level (<root>/pika-config.ts) - Controls ultimate availability
+ * 2. Chat app level (chatApp.features) - Can override site settings
+ * 3. Admin override level (chatApp.override.features) - Can override chat app settings
+ *
+ * Note that we always return siteAdmin: { websiteEnabled: false } because we only check that for real when they try to access the admin page itself.
+ *
+ * Override rules:
+ * - Site level controls whether a feature can be used at all
+ * - Chat apps can override site level (but only to restrict)
+ * - Admins can override chat app level completely (but cannot enable features disabled at site level)
+ * - When overriding, complete feature configuration must be provided (no merging)
+ */
+declare function getOverridableFeatures(siteFeatures: SiteFeatures, chatApp: ChatApp, user: AuthenticatedUser<RecordOrUndef, RecordOrUndef>): ChatAppOverridableFeatures;
+/**
+ * Generic function to check if a user has access to a feature based on user types and roles.
+ * This implements the same logic used in get for checking user access rules.
+ *
+ * **Access Control Logic:**
+ * - If the feature is disabled (`enabled: false`), no access regardless of other rules
+ * - If no userTypes or userRoles are specified, no access is granted (secure by default)
+ * - If multiple userTypes are provided, a user need only have one of them to have access (OR logic)
+ * - If multiple userRoles are provided, a user need only have one of them to have access (OR logic)
+ * - If both userTypes and userRoles are provided, the `applyRulesAs` setting determines how they're combined:
+ *   - `'and'` (default): User must match a userType AND have a userRole
+ *   - `'or'`: User must match a userType OR have a userRole
+ *
+ * @param user - The authenticated user to check access for
+ * @param feature - The feature configuration with user access rules
+ * @returns Whether the user has access to the feature
+ */
+declare function checkUserAccessToFeature(user: AuthenticatedUser<RecordOrUndef, RecordOrUndef>, feature: AccessRules): boolean;
+declare function getEntityIdForUser(user: ChatUser<RecordOrUndef>, overrideDataForThisChatApp: RecordOrUndef, entityAttributeName?: string): string | undefined;
 
-export { gunzipBase64EncodedString, gzipAndBase64EncodeString };
+export { checkUserAccessToFeature, getEntityIdForUser, getOverridableFeatures, gunzipBase64EncodedString, gzipAndBase64EncodeString };

package/dist/util/server-utils.d.ts

@@ -1,4 +1,44 @@
+import { SiteFeatures, ChatApp, AuthenticatedUser, RecordOrUndef, ChatAppOverridableFeatures, AccessRules, ChatUser } from '../types/chatbot/chatbot-types.js';
+import '@aws-sdk/client-bedrock-agent-runtime';
+import '@aws-sdk/client-bedrock-agentcore';
+
 declare function gunzipBase64EncodedString(base64EncodedString: string): string;
 declare function gzipAndBase64EncodeString(string: string): string;
+/**
+ * Compute what features the user is and isn't allowed to use for this chat app.
+ *
+ * Feature hierarchy (in order of precedence):
+ * 1. Site level (<root>/pika-config.ts) - Controls ultimate availability
+ * 2. Chat app level (chatApp.features) - Can override site settings
+ * 3. Admin override level (chatApp.override.features) - Can override chat app settings
+ *
+ * Note that we always return siteAdmin: { websiteEnabled: false } because we only check that for real when they try to access the admin page itself.
+ *
+ * Override rules:
+ * - Site level controls whether a feature can be used at all
+ * - Chat apps can override site level (but only to restrict)
+ * - Admins can override chat app level completely (but cannot enable features disabled at site level)
+ * - When overriding, complete feature configuration must be provided (no merging)
+ */
+declare function getOverridableFeatures(siteFeatures: SiteFeatures, chatApp: ChatApp, user: AuthenticatedUser<RecordOrUndef, RecordOrUndef>): ChatAppOverridableFeatures;
+/**
+ * Generic function to check if a user has access to a feature based on user types and roles.
+ * This implements the same logic used in get for checking user access rules.
+ *
+ * **Access Control Logic:**
+ * - If the feature is disabled (`enabled: false`), no access regardless of other rules
+ * - If no userTypes or userRoles are specified, no access is granted (secure by default)
+ * - If multiple userTypes are provided, a user need only have one of them to have access (OR logic)
+ * - If multiple userRoles are provided, a user need only have one of them to have access (OR logic)
+ * - If both userTypes and userRoles are provided, the `applyRulesAs` setting determines how they're combined:
+ *   - `'and'` (default): User must match a userType AND have a userRole
+ *   - `'or'`: User must match a userType OR have a userRole
+ *
+ * @param user - The authenticated user to check access for
+ * @param feature - The feature configuration with user access rules
+ * @returns Whether the user has access to the feature
+ */
+declare function checkUserAccessToFeature(user: AuthenticatedUser<RecordOrUndef, RecordOrUndef>, feature: AccessRules): boolean;
+declare function getEntityIdForUser(user: ChatUser<RecordOrUndef>, overrideDataForThisChatApp: RecordOrUndef, entityAttributeName?: string): string | undefined;
 
-export { gunzipBase64EncodedString, gzipAndBase64EncodeString };
+export { checkUserAccessToFeature, getEntityIdForUser, getOverridableFeatures, gunzipBase64EncodedString, gzipAndBase64EncodeString };