pika-shared 1.4.1 → 1.4.2

package/dist/util/instruction-assistance-utils.d.ts

@@ -35,6 +35,33 @@ declare function generateInstructionAssistanceContent(instructionAssistanceConfi
  * Apply instruction assistance to the base prompt using placeholder replacement
  */
 declare function applyInstructionAssistance(basePrompt: string, instructionContent: InstructionAssistanceConfig): string;
+/**
+ * IMPORTANT!!!!!!!!!!!!!!!!!!!!!!
+ *
+ * See header at top of file for important notes.
+ *
+ * Generate component-specific instruction content for direct component invocations
+ *
+ * @param tagDefinition - The tag definition with component invocation instructions
+ * @param componentAgentInstructionName - The name of the instruction set to use
+ * @param instructionAssistanceConfig - Optional instruction assistance config for placeholder replacement
+ * @param agentInstructionFeature - Optional agent instruction feature to control which placeholders are replaced
+ * @returns The component instruction content or undefined if not found
+ */
+declare function generateComponentInstructionContent(tagDefinition: TagDefinition<TagDefinitionWidget>, componentAgentInstructionName: string, instructionAssistanceConfig?: InstructionAssistanceConfig, agentInstructionFeature?: AgentInstructionChatAppOverridableFeature): string | undefined;
+/**
+ * IMPORTANT!!!!!!!!!!!!!!!!!!!!!!
+ *
+ * See header at top of file for important notes.
+ *
+ * Apply instruction assistance placeholder replacement to component instructions
+ *
+ * @param componentInstructions - The raw component instructions with placeholders
+ * @param instructionConfig - The instruction assistance configuration
+ * @param agentInstructionFeature - The agent instruction feature configuration
+ * @returns The component instructions with placeholders replaced
+ */
+declare function applyComponentInstructionAssistance(componentInstructions: string, instructionConfig: InstructionAssistanceConfig, agentInstructionFeature: AgentInstructionChatAppOverridableFeature): string;
 /**
  * IMPORTANT!!!!!!!!!!!!!!!!!!!!!!
  *
@@ -47,4 +74,4 @@ declare function applyInstructionAssistance(basePrompt: string, instructionConte
  */
 declare function getInstructionsAssistanceConfigFromRawSsmParams(params: Record<string, string>): InstructionAssistanceConfig;
 
-export { applyInstructionAssistance, generateInstructionAssistanceContent, getInstructionsAssistanceConfigFromRawSsmParams };
+export { applyComponentInstructionAssistance, applyInstructionAssistance, generateComponentInstructionContent, generateInstructionAssistanceContent, getInstructionsAssistanceConfigFromRawSsmParams };

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

@@ -7,18 +7,21 @@ function generateInstructionAssistanceContent(instructionAssistanceConfig, tags,
     includeOutputFormattingRequirements: agentInstructionFeature?.includeOutputFormattingRequirements,
     includeInstructionsForTags: agentInstructionFeature?.includeInstructionsForTags,
     completeExampleEnabled: agentInstructionFeature?.completeExampleInstructionEnabled,
-    jsonOnlyEnabled: agentInstructionFeature?.jsonOnlyImperativeInstructionEnabled
+    jsonOnlyEnabled: agentInstructionFeature?.jsonOnlyImperativeInstructionEnabled,
+    includeTypescriptBackedOutputFormattingRequirements: agentInstructionFeature?.includeTypescriptBackedOutputFormattingRequirements
   });
   let outputFormattingRequirements = "";
   let tagInstructions = "";
   let completeExampleInstructionLine = "";
   let jsonOnlyImperativeInstructionLine = "";
+  let typescriptBackedOutputFormattingRequirements = "";
   if (!agentInstructionFeature?.enabled) {
     return {
       outputFormattingRequirements,
       tagInstructions,
       completeExampleInstructionLine,
-      jsonOnlyImperativeInstructionLine
+      jsonOnlyImperativeInstructionLine,
+      typescriptBackedOutputFormattingRequirements
     };
   }
   if (agentInstructionFeature.includeOutputFormattingRequirements) {
@@ -29,7 +32,7 @@ function generateInstructionAssistanceContent(instructionAssistanceConfig, tags,
   if (agentInstructionFeature.includeInstructionsForTags && tags && tags.tagsEnabled?.length > 0) {
     console.log("Fetching tag definitions for instruction generation:", tags.tagsEnabled);
     if (tagDefinitions.length > 0) {
-      const tagDictionary = tagDefinitions.filter((tagDef) => tagDef.canBeGeneratedByLlm && !tagDef.disabled).map((tagDef) => `  - ${tagDef.tagTitle}: \`${tagDef.shortTagEx}\``).join("\n");
+      const tagDictionary = tagDefinitions.filter((tagDef) => tagDef.canBeGeneratedByLlm && tagDef.status === "enabled").map((tagDef) => `  - ${tagDef.tagTitle}: \`${tagDef.shortTagEx}\``).join("\n");
       let tagInstructionsContent = "";
       if (tagDictionary) {
         tagInstructionsContent += `- **Custom Tags Supported:**
@@ -37,7 +40,7 @@ ${tagDictionary}
 `;
       }
       for (const tagDef of tagDefinitions) {
-        if (tagDef.canBeGeneratedByLlm && !tagDef.disabled && tagDef.llmInstructionsMd) {
+        if (tagDef.canBeGeneratedByLlm && tagDef.status === "enabled" && tagDef.llmInstructionsMd) {
           const tagType = `${tagDef.scope}.${tagDef.tag}`;
           tagInstructionsContent += `- **${tagDef.tagTitle}:**
   <tag-instructions type="${tagType}">
@@ -61,13 +64,15 @@ ${tagDef.llmInstructionsMd}
     hasOutputFormatting: !!outputFormattingRequirements,
     hasTagInstructions: !!tagInstructions,
     hasCompleteExample: !!completeExampleInstructionLine,
-    hasJsonValidation: !!jsonOnlyImperativeInstructionLine
+    hasJsonValidation: !!jsonOnlyImperativeInstructionLine,
+    hasTypescriptBackedOutputFormattingRequirements: false
   });
   return {
     outputFormattingRequirements,
     tagInstructions,
     completeExampleInstructionLine,
-    jsonOnlyImperativeInstructionLine
+    jsonOnlyImperativeInstructionLine,
+    typescriptBackedOutputFormattingRequirements
   };
 }
 function applyInstructionAssistance(basePrompt, instructionContent) {
@@ -111,8 +116,48 @@ function applyInstructionAssistance(basePrompt, instructionContent) {
   }
   return enhancedPrompt;
 }
+function generateComponentInstructionContent(tagDefinition, componentAgentInstructionName, instructionAssistanceConfig, agentInstructionFeature) {
+  console.log("Generating component instruction content:", {
+    scope: tagDefinition.scope,
+    tag: tagDefinition.tag,
+    componentAgentInstructionName,
+    hasDirectInvocationInstructions: !!tagDefinition.componentAgentInstructionsMd,
+    hasInstructionAssistanceConfig: !!instructionAssistanceConfig
+  });
+  if (!tagDefinition.componentAgentInstructionsMd) {
+    return void 0;
+  }
+  const instructions = tagDefinition.componentAgentInstructionsMd[componentAgentInstructionName];
+  if (!instructions) {
+    console.log(`No instructions found for componentAgentInstructionName: ${componentAgentInstructionName}`);
+    console.log("Available instruction names:", Object.keys(tagDefinition.componentAgentInstructionsMd));
+    return void 0;
+  }
+  console.log("Component instructions found:", {
+    instructionLength: instructions.length
+  });
+  if (instructionAssistanceConfig && agentInstructionFeature) {
+    return applyComponentInstructionAssistance(instructions, instructionAssistanceConfig, agentInstructionFeature);
+  }
+  return instructions;
+}
+function applyComponentInstructionAssistance(componentInstructions, instructionConfig, agentInstructionFeature) {
+  let enhancedInstructions = componentInstructions;
+  console.log("Applying component instruction assistance:", {
+    includeTypescriptBackedOutputFormattingRequirements: agentInstructionFeature.includeTypescriptBackedOutputFormattingRequirements,
+    hasPlaceholder: enhancedInstructions.includes("{{typescript-backed-output-formatting-requirements}}")
+  });
+  if (agentInstructionFeature.includeTypescriptBackedOutputFormattingRequirements && instructionConfig.typescriptBackedOutputFormattingRequirements) {
+    const placeholder = "{{typescript-backed-output-formatting-requirements}}";
+    if (enhancedInstructions.includes(placeholder)) {
+      console.log("Replacing typescript-backed-output-formatting-requirements placeholder");
+      enhancedInstructions = enhancedInstructions.replace(placeholder, instructionConfig.typescriptBackedOutputFormattingRequirements);
+    }
+  }
+  return enhancedInstructions;
+}
 function getInstructionsAssistanceConfigFromRawSsmParams(params) {
-  const expectedKeys = ["output-formatting-requirements", "default-complete-example-line", "default-json-validation-line"];
+  const expectedKeys = ["output-formatting-requirements", "default-complete-example-line", "default-json-validation-line", "typescript-backed-output-formatting-requirements"];
   const missingKeys = expectedKeys.filter((key) => !params[key]);
   if (missingKeys.length > 0) {
     throw new Error(
@@ -122,11 +167,14 @@ function getInstructionsAssistanceConfigFromRawSsmParams(params) {
   return {
     outputFormattingRequirements: params["output-formatting-requirements"],
     completeExampleInstructionLine: params["default-complete-example-line"],
-    jsonOnlyImperativeInstructionLine: params["default-json-validation-line"]
+    jsonOnlyImperativeInstructionLine: params["default-json-validation-line"],
+    typescriptBackedOutputFormattingRequirements: params["typescript-backed-output-formatting-requirements"]
   };
 }
 
+exports.applyComponentInstructionAssistance = applyComponentInstructionAssistance;
 exports.applyInstructionAssistance = applyInstructionAssistance;
+exports.generateComponentInstructionContent = generateComponentInstructionContent;
 exports.generateInstructionAssistanceContent = generateInstructionAssistanceContent;
 exports.getInstructionsAssistanceConfigFromRawSsmParams = getInstructionsAssistanceConfigFromRawSsmParams;
 //# sourceMappingURL=instruction-assistance-utils.js.map

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

@@ -1 +1 @@
-{"version":3,"sources":["../../src/util/instruction-assistance-utils.ts"],"names":[],"mappings":";;;AAgCO,SAAS,oCAAA,CACZ,2BAAA,EACA,IAAA,EACA,uBAAA,EACA,cAAA,EAC2B;AAC3B,EAAA,OAAA,CAAQ,IAAI,4CAAA,EAA8C;AAAA,IACtD,SAAS,uBAAA,EAAyB,OAAA;AAAA,IAClC,qCAAqC,uBAAA,EAAyB,mCAAA;AAAA,IAC9D,4BAA4B,uBAAA,EAAyB,0BAAA;AAAA,IACrD,wBAAwB,uBAAA,EAAyB,iCAAA;AAAA,IACjD,iBAAiB,uBAAA,EAAyB;AAAA,GAC7C,CAAA;AAED,EAAA,IAAI,4BAAA,GAA+B,EAAA;AACnC,EAAA,IAAI,eAAA,GAAkB,EAAA;AACtB,EAAA,IAAI,8BAAA,GAAiC,EAAA;AACrC,EAAA,IAAI,iCAAA,GAAoC,EAAA;AAExC,EAAA,IAAI,CAAC,yBAAyB,OAAA,EAAS;AACnC,IAAA,OAAO;AAAA,MACH,4BAAA;AAAA,MACA,eAAA;AAAA,MACA,8BAAA;AAAA,MACA;AAAA,KACJ;AAAA,EACJ;AAGA,EAAA,IAAI,wBAAwB,mCAAA,EAAqC;AAC7D,IAAA,4BAAA,GACI,6BAA6B,4BAAA,IAC7B,CAAA;AAAA;AAAA,0FAAA,CAAA;AAAA,EAGR;AAGA,EAAA,IAAI,wBAAwB,0BAAA,IAA8B,IAAA,IAAQ,IAAA,CAAK,WAAA,EAAa,SAAS,CAAA,EAAG;AAC5F,IAAA,OAAA,CAAQ,GAAA,CAAI,sDAAA,EAAwD,IAAA,CAAK,WAAW,CAAA;AAEpF,IAAA,IAAI,cAAA,CAAe,SAAS,CAAA,EAAG;AAE3B,MAAA,MAAM,aAAA,GAAgB,eACjB,MAAA,CAAO,CAAC,WAAW,MAAA,CAAO,mBAAA,IAAuB,CAAC,MAAA,CAAO,QAAQ,CAAA,CACjE,IAAI,CAAC,MAAA,KAAW,CAAA,IAAA,EAAO,MAAA,CAAO,QAAQ,CAAA,IAAA,EAAO,OAAO,UAAU,CAAA,EAAA,CAAI,CAAA,CAClE,IAAA,CAAK,IAAI,CAAA;AAEd,MAAA,IAAI,sBAAA,GAAyB,EAAA;AAC7B,MAAA,IAAI,aAAA,EAAe;AACf,QAAA,sBAAA,IAA0B,CAAA;AAAA,EAAiC,aAAa;AAAA,CAAA;AAAA,MAC5E;AAGA,MAAA,KAAA,MAAW,UAAU,cAAA,EAAgB;AACjC,QAAA,IAAI,OAAO,mBAAA,IAAuB,CAAC,MAAA,CAAO,QAAA,IAAY,OAAO,iBAAA,EAAmB;AAC5E,UAAA,MAAM,UAAU,CAAA,EAAG,MAAA,CAAO,KAAK,CAAA,CAAA,EAAI,OAAO,GAAG,CAAA,CAAA;AAC7C,UAAA,sBAAA,IAA0B,CAAA,IAAA,EAAO,OAAO,QAAQ,CAAA;AAAA,0BAAA,EAAkC,OAAO,CAAA;AAAA,EAAO,OAAO,iBAAiB;AAAA;AAAA,CAAA;AAAA,QAC5H;AAAA,MACJ;AAEA,MAAA,IAAI,sBAAA,EAAwB;AACxB,QAAA,eAAA,GAAkB,sBAAA;AAAA,MACtB;AAAA,IACJ;AAAA,EACJ;AAGA,EAAA,IAAI,wBAAwB,iCAAA,EAAmC;AAC3D,IAAA,8BAAA,GACI,uBAAA,CAAwB,8BAAA,IACxB,2BAAA,EAA6B,8BAAA,IAC7B,yKAAA;AAAA,EACR;AAGA,EAAA,IAAI,wBAAwB,oCAAA,EAAsC;AAC9D,IAAA,iCAAA,GACI,uBAAA,CAAwB,iCAAA,IACxB,2BAAA,EAA6B,iCAAA,IAC7B,6HAAA;AAAA,EACR;AAEA,EAAA,OAAA,CAAQ,IAAI,2CAAA,EAA6C;AAAA,IACrD,mBAAA,EAAqB,CAAC,CAAC,4BAAA;AAAA,IACvB,kBAAA,EAAoB,CAAC,CAAC,eAAA;AAAA,IACtB,kBAAA,EAAoB,CAAC,CAAC,8BAAA;AAAA,IACtB,iBAAA,EAAmB,CAAC,CAAC;AAAA,GACxB,CAAA;AAED,EAAA,OAAO;AAAA,IACH,4BAAA;AAAA,IACA,eAAA;AAAA,IACA,8BAAA;AAAA,IACA;AAAA,GACJ;AACJ;AASO,SAAS,0BAAA,CAA2B,YAAoB,kBAAA,EAAyD;AACpH,EAAA,IAAI,cAAA,GAAiB,UAAA;AAGrB,EAAA,IAAI,cAAA,CAAe,QAAA,CAAS,uBAAuB,CAAA,EAAG;AAClD,IAAA,OAAA,CAAQ,IAAI,yCAAyC,CAAA;AAErD,IAAA,MAAM,UAAA,GAAa;AAAA,MACf,kBAAA,CAAmB,4BAAA;AAAA,MACnB,kBAAA,CAAmB,eAAA;AAAA,MACnB,kBAAA,CAAmB,8BAAA;AAAA,MACnB,kBAAA,CAAmB;AAAA,KACvB,CACK,MAAA,CAAO,CAAC,OAAA,KAAY,OAAA,IAAW,OAAA,CAAQ,IAAA,EAAK,CAAE,MAAA,GAAS,CAAC,CAAA,CACxD,IAAA,CAAK,MAAM,CAAA;AAEhB,IAAA,cAAA,GAAiB,cAAA,CAAe,OAAA,CAAQ,uBAAA,EAAyB,UAAU,CAAA;AAAA,EAC/E,CAAA,MAAO;AAEH,IAAA,MAAM,YAAA,GAAe;AAAA,MACjB,EAAE,WAAA,EAAa,oCAAA,EAAsC,OAAA,EAAS,mBAAmB,4BAAA,EAA6B;AAAA,MAC9G,EAAE,WAAA,EAAa,sBAAA,EAAwB,OAAA,EAAS,mBAAmB,eAAA,EAAgB;AAAA,MACnF,EAAE,WAAA,EAAa,uCAAA,EAAyC,OAAA,EAAS,mBAAmB,8BAAA,EAA+B;AAAA,MACnH,EAAE,WAAA,EAAa,2CAAA,EAA6C,OAAA,EAAS,mBAAmB,iCAAA;AAAkC,KAC9H;AAEA,IAAA,IAAI,iBAAA,GAAoB,KAAA;AACxB,IAAA,KAAA,MAAW,EAAE,WAAA,EAAa,OAAA,EAAQ,IAAK,YAAA,EAAc;AACjD,MAAA,IAAI,cAAA,CAAe,QAAA,CAAS,WAAW,CAAA,IAAK,OAAA,EAAS;AACjD,QAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,MAAA,EAAS,WAAW,CAAA,YAAA,CAAc,CAAA;AAC9C,QAAA,iBAAA,GAAoB,IAAA;AACpB,QAAA,cAAA,GAAiB,cAAA,CAAe,OAAA,CAAQ,WAAA,EAAa,OAAO,CAAA;AAAA,MAChE;AAAA,IACJ;AAGA,IAAA,IAAI,CAAC,iBAAA,EAAmB;AACpB,MAAA,OAAA,CAAQ,IAAI,mDAAmD,CAAA;AAC/D,MAAA,MAAM,UAAA,GAAa;AAAA,QACf,kBAAA,CAAmB,4BAAA;AAAA,QACnB,kBAAA,CAAmB,eAAA;AAAA,QACnB,kBAAA,CAAmB,8BAAA;AAAA,QACnB,kBAAA,CAAmB;AAAA,OACvB,CAAE,OAAO,CAAC,OAAA,KAAY,WAAW,OAAA,CAAQ,IAAA,EAAK,CAAE,MAAA,GAAS,CAAC,CAAA;AAE1D,MAAA,IAAI,UAAA,CAAW,SAAS,CAAA,EAAG;AACvB,QAAA,cAAA,GAAiB,cAAA,GAAiB,MAAA,GAAS,UAAA,CAAW,IAAA,CAAK,MAAM,CAAA;AAAA,MACrE;AAAA,IACJ;AAAA,EACJ;AAEA,EAAA,OAAO,cAAA;AACX;AAYO,SAAS,gDAAgD,MAAA,EAA6D;AACzH,EAAA,MAAM,YAAA,GAAe,CAAC,gCAAA,EAAkC,+BAAA,EAAiC,8BAA8B,CAAA;AACvH,EAAA,MAAM,WAAA,GAAc,aAAa,MAAA,CAAO,CAAC,QAAQ,CAAC,MAAA,CAAO,GAAG,CAAC,CAAA;AAC7D,EAAA,IAAI,WAAA,CAAY,SAAS,CAAA,EAAG;AACxB,IAAA,MAAM,IAAI,KAAA;AAAA,MACN,uDAAuD,MAAA,CAAO,IAAA,CAAK,MAAM,CAAA,CACpE,OAAO,CAAC,GAAA,KAAQ,CAAC,YAAA,CAAa,SAAS,GAAG,CAAC,CAAA,CAC3C,IAAA,CAAK,IAAI,CAAC,CAAA;AAAA,KACnB;AAAA,EACJ;AAEA,EAAA,OAAO;AAAA,IACH,4BAAA,EAA8B,OAAO,gCAAgC,CAAA;AAAA,IACrE,8BAAA,EAAgC,OAAO,+BAA+B,CAAA;AAAA,IACtE,iCAAA,EAAmC,OAAO,8BAA8B;AAAA,GAC5E;AACJ","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        includeTypescriptBackedOutputFormattingRequirements: agentInstructionFeature?.includeTypescriptBackedOutputFormattingRequirements\n    });\n\n    let outputFormattingRequirements = '';\n    let tagInstructions = '';\n    let completeExampleInstructionLine = '';\n    let jsonOnlyImperativeInstructionLine = '';\n    let typescriptBackedOutputFormattingRequirements = '';\n\n    if (!agentInstructionFeature?.enabled) {\n        return {\n            outputFormattingRequirements,\n            tagInstructions,\n            completeExampleInstructionLine,\n            jsonOnlyImperativeInstructionLine,\n            typescriptBackedOutputFormattingRequirements\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.status === 'enabled')\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.status === 'enabled' && 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        hasTypescriptBackedOutputFormattingRequirements: !!typescriptBackedOutputFormattingRequirements\n    });\n\n    return {\n        outputFormattingRequirements,\n        tagInstructions,\n        completeExampleInstructionLine,\n        jsonOnlyImperativeInstructionLine,\n        typescriptBackedOutputFormattingRequirements\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 * Generate component-specific instruction content for direct component invocations\n *\n * @param tagDefinition - The tag definition with component invocation instructions\n * @param componentAgentInstructionName - The name of the instruction set to use\n * @param instructionAssistanceConfig - Optional instruction assistance config for placeholder replacement\n * @param agentInstructionFeature - Optional agent instruction feature to control which placeholders are replaced\n * @returns The component instruction content or undefined if not found\n */\nexport function generateComponentInstructionContent(\n    tagDefinition: TagDefinition<TagDefinitionWidget>,\n    componentAgentInstructionName: string,\n    instructionAssistanceConfig?: InstructionAssistanceConfig,\n    agentInstructionFeature?: AgentInstructionChatAppOverridableFeature\n): string | undefined {\n    console.log('Generating component instruction content:', {\n        scope: tagDefinition.scope,\n        tag: tagDefinition.tag,\n        componentAgentInstructionName,\n        hasDirectInvocationInstructions: !!tagDefinition.componentAgentInstructionsMd,\n        hasInstructionAssistanceConfig: !!instructionAssistanceConfig\n    });\n\n    if (!tagDefinition.componentAgentInstructionsMd) {\n        // console.log('No componentAgentInstructionsMd found on tag definition');\n        return undefined;\n    }\n\n    const instructions = tagDefinition.componentAgentInstructionsMd[componentAgentInstructionName];\n\n    if (!instructions) {\n        console.log(`No instructions found for componentAgentInstructionName: ${componentAgentInstructionName}`);\n        console.log('Available instruction names:', Object.keys(tagDefinition.componentAgentInstructionsMd));\n        return undefined;\n    }\n\n    console.log('Component instructions found:', {\n        instructionLength: instructions.length\n    });\n\n    // Apply placeholder replacement if instruction assistance config is provided\n    if (instructionAssistanceConfig && agentInstructionFeature) {\n        return applyComponentInstructionAssistance(instructions, instructionAssistanceConfig, agentInstructionFeature);\n    }\n\n    return instructions;\n}\n\n/**\n * IMPORTANT!!!!!!!!!!!!!!!!!!!!!!\n *\n * See header at top of file for important notes.\n *\n * Apply instruction assistance placeholder replacement to component instructions\n *\n * @param componentInstructions - The raw component instructions with placeholders\n * @param instructionConfig - The instruction assistance configuration\n * @param agentInstructionFeature - The agent instruction feature configuration\n * @returns The component instructions with placeholders replaced\n */\nexport function applyComponentInstructionAssistance(\n    componentInstructions: string,\n    instructionConfig: InstructionAssistanceConfig,\n    agentInstructionFeature: AgentInstructionChatAppOverridableFeature\n): string {\n    let enhancedInstructions = componentInstructions;\n\n    console.log('Applying component instruction assistance:', {\n        includeTypescriptBackedOutputFormattingRequirements: agentInstructionFeature.includeTypescriptBackedOutputFormattingRequirements,\n        hasPlaceholder: enhancedInstructions.includes('{{typescript-backed-output-formatting-requirements}}')\n    });\n\n    // Replace typescript-backed-output-formatting-requirements placeholder if enabled\n    if (agentInstructionFeature.includeTypescriptBackedOutputFormattingRequirements && instructionConfig.typescriptBackedOutputFormattingRequirements) {\n        const placeholder = '{{typescript-backed-output-formatting-requirements}}';\n        if (enhancedInstructions.includes(placeholder)) {\n            console.log('Replacing typescript-backed-output-formatting-requirements placeholder');\n            enhancedInstructions = enhancedInstructions.replace(placeholder, instructionConfig.typescriptBackedOutputFormattingRequirements);\n        }\n    }\n\n    return enhancedInstructions;\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', 'typescript-backed-output-formatting-requirements'];\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        typescriptBackedOutputFormattingRequirements: params['typescript-backed-output-formatting-requirements']\n    };\n}\n"]}

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

@@ -5,18 +5,21 @@ function generateInstructionAssistanceContent(instructionAssistanceConfig, tags,
     includeOutputFormattingRequirements: agentInstructionFeature?.includeOutputFormattingRequirements,
     includeInstructionsForTags: agentInstructionFeature?.includeInstructionsForTags,
     completeExampleEnabled: agentInstructionFeature?.completeExampleInstructionEnabled,
-    jsonOnlyEnabled: agentInstructionFeature?.jsonOnlyImperativeInstructionEnabled
+    jsonOnlyEnabled: agentInstructionFeature?.jsonOnlyImperativeInstructionEnabled,
+    includeTypescriptBackedOutputFormattingRequirements: agentInstructionFeature?.includeTypescriptBackedOutputFormattingRequirements
   });
   let outputFormattingRequirements = "";
   let tagInstructions = "";
   let completeExampleInstructionLine = "";
   let jsonOnlyImperativeInstructionLine = "";
+  let typescriptBackedOutputFormattingRequirements = "";
   if (!agentInstructionFeature?.enabled) {
     return {
       outputFormattingRequirements,
       tagInstructions,
       completeExampleInstructionLine,
-      jsonOnlyImperativeInstructionLine
+      jsonOnlyImperativeInstructionLine,
+      typescriptBackedOutputFormattingRequirements
     };
   }
   if (agentInstructionFeature.includeOutputFormattingRequirements) {
@@ -27,7 +30,7 @@ function generateInstructionAssistanceContent(instructionAssistanceConfig, tags,
   if (agentInstructionFeature.includeInstructionsForTags && tags && tags.tagsEnabled?.length > 0) {
     console.log("Fetching tag definitions for instruction generation:", tags.tagsEnabled);
     if (tagDefinitions.length > 0) {
-      const tagDictionary = tagDefinitions.filter((tagDef) => tagDef.canBeGeneratedByLlm && !tagDef.disabled).map((tagDef) => `  - ${tagDef.tagTitle}: \`${tagDef.shortTagEx}\``).join("\n");
+      const tagDictionary = tagDefinitions.filter((tagDef) => tagDef.canBeGeneratedByLlm && tagDef.status === "enabled").map((tagDef) => `  - ${tagDef.tagTitle}: \`${tagDef.shortTagEx}\``).join("\n");
       let tagInstructionsContent = "";
       if (tagDictionary) {
         tagInstructionsContent += `- **Custom Tags Supported:**
@@ -35,7 +38,7 @@ ${tagDictionary}
 `;
       }
       for (const tagDef of tagDefinitions) {
-        if (tagDef.canBeGeneratedByLlm && !tagDef.disabled && tagDef.llmInstructionsMd) {
+        if (tagDef.canBeGeneratedByLlm && tagDef.status === "enabled" && tagDef.llmInstructionsMd) {
           const tagType = `${tagDef.scope}.${tagDef.tag}`;
           tagInstructionsContent += `- **${tagDef.tagTitle}:**
   <tag-instructions type="${tagType}">
@@ -59,13 +62,15 @@ ${tagDef.llmInstructionsMd}
     hasOutputFormatting: !!outputFormattingRequirements,
     hasTagInstructions: !!tagInstructions,
     hasCompleteExample: !!completeExampleInstructionLine,
-    hasJsonValidation: !!jsonOnlyImperativeInstructionLine
+    hasJsonValidation: !!jsonOnlyImperativeInstructionLine,
+    hasTypescriptBackedOutputFormattingRequirements: false
   });
   return {
     outputFormattingRequirements,
     tagInstructions,
     completeExampleInstructionLine,
-    jsonOnlyImperativeInstructionLine
+    jsonOnlyImperativeInstructionLine,
+    typescriptBackedOutputFormattingRequirements
   };
 }
 function applyInstructionAssistance(basePrompt, instructionContent) {
@@ -109,8 +114,48 @@ function applyInstructionAssistance(basePrompt, instructionContent) {
   }
   return enhancedPrompt;
 }
+function generateComponentInstructionContent(tagDefinition, componentAgentInstructionName, instructionAssistanceConfig, agentInstructionFeature) {
+  console.log("Generating component instruction content:", {
+    scope: tagDefinition.scope,
+    tag: tagDefinition.tag,
+    componentAgentInstructionName,
+    hasDirectInvocationInstructions: !!tagDefinition.componentAgentInstructionsMd,
+    hasInstructionAssistanceConfig: !!instructionAssistanceConfig
+  });
+  if (!tagDefinition.componentAgentInstructionsMd) {
+    return void 0;
+  }
+  const instructions = tagDefinition.componentAgentInstructionsMd[componentAgentInstructionName];
+  if (!instructions) {
+    console.log(`No instructions found for componentAgentInstructionName: ${componentAgentInstructionName}`);
+    console.log("Available instruction names:", Object.keys(tagDefinition.componentAgentInstructionsMd));
+    return void 0;
+  }
+  console.log("Component instructions found:", {
+    instructionLength: instructions.length
+  });
+  if (instructionAssistanceConfig && agentInstructionFeature) {
+    return applyComponentInstructionAssistance(instructions, instructionAssistanceConfig, agentInstructionFeature);
+  }
+  return instructions;
+}
+function applyComponentInstructionAssistance(componentInstructions, instructionConfig, agentInstructionFeature) {
+  let enhancedInstructions = componentInstructions;
+  console.log("Applying component instruction assistance:", {
+    includeTypescriptBackedOutputFormattingRequirements: agentInstructionFeature.includeTypescriptBackedOutputFormattingRequirements,
+    hasPlaceholder: enhancedInstructions.includes("{{typescript-backed-output-formatting-requirements}}")
+  });
+  if (agentInstructionFeature.includeTypescriptBackedOutputFormattingRequirements && instructionConfig.typescriptBackedOutputFormattingRequirements) {
+    const placeholder = "{{typescript-backed-output-formatting-requirements}}";
+    if (enhancedInstructions.includes(placeholder)) {
+      console.log("Replacing typescript-backed-output-formatting-requirements placeholder");
+      enhancedInstructions = enhancedInstructions.replace(placeholder, instructionConfig.typescriptBackedOutputFormattingRequirements);
+    }
+  }
+  return enhancedInstructions;
+}
 function getInstructionsAssistanceConfigFromRawSsmParams(params) {
-  const expectedKeys = ["output-formatting-requirements", "default-complete-example-line", "default-json-validation-line"];
+  const expectedKeys = ["output-formatting-requirements", "default-complete-example-line", "default-json-validation-line", "typescript-backed-output-formatting-requirements"];
   const missingKeys = expectedKeys.filter((key) => !params[key]);
   if (missingKeys.length > 0) {
     throw new Error(
@@ -120,10 +165,11 @@ function getInstructionsAssistanceConfigFromRawSsmParams(params) {
   return {
     outputFormattingRequirements: params["output-formatting-requirements"],
     completeExampleInstructionLine: params["default-complete-example-line"],
-    jsonOnlyImperativeInstructionLine: params["default-json-validation-line"]
+    jsonOnlyImperativeInstructionLine: params["default-json-validation-line"],
+    typescriptBackedOutputFormattingRequirements: params["typescript-backed-output-formatting-requirements"]
   };
 }
 
-export { applyInstructionAssistance, generateInstructionAssistanceContent, getInstructionsAssistanceConfigFromRawSsmParams };
+export { applyComponentInstructionAssistance, applyInstructionAssistance, generateComponentInstructionContent, generateInstructionAssistanceContent, getInstructionsAssistanceConfigFromRawSsmParams };
 //# sourceMappingURL=instruction-assistance-utils.mjs.map
 //# sourceMappingURL=instruction-assistance-utils.mjs.map

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        includeTypescriptBackedOutputFormattingRequirements: agentInstructionFeature?.includeTypescriptBackedOutputFormattingRequirements\n    });\n\n    let outputFormattingRequirements = '';\n    let tagInstructions = '';\n    let completeExampleInstructionLine = '';\n    let jsonOnlyImperativeInstructionLine = '';\n    let typescriptBackedOutputFormattingRequirements = '';\n\n    if (!agentInstructionFeature?.enabled) {\n        return {\n            outputFormattingRequirements,\n            tagInstructions,\n            completeExampleInstructionLine,\n            jsonOnlyImperativeInstructionLine,\n            typescriptBackedOutputFormattingRequirements\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.status === 'enabled')\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.status === 'enabled' && 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        hasTypescriptBackedOutputFormattingRequirements: !!typescriptBackedOutputFormattingRequirements\n    });\n\n    return {\n        outputFormattingRequirements,\n        tagInstructions,\n        completeExampleInstructionLine,\n        jsonOnlyImperativeInstructionLine,\n        typescriptBackedOutputFormattingRequirements\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 * Generate component-specific instruction content for direct component invocations\n *\n * @param tagDefinition - The tag definition with component invocation instructions\n * @param componentAgentInstructionName - The name of the instruction set to use\n * @param instructionAssistanceConfig - Optional instruction assistance config for placeholder replacement\n * @param agentInstructionFeature - Optional agent instruction feature to control which placeholders are replaced\n * @returns The component instruction content or undefined if not found\n */\nexport function generateComponentInstructionContent(\n    tagDefinition: TagDefinition<TagDefinitionWidget>,\n    componentAgentInstructionName: string,\n    instructionAssistanceConfig?: InstructionAssistanceConfig,\n    agentInstructionFeature?: AgentInstructionChatAppOverridableFeature\n): string | undefined {\n    console.log('Generating component instruction content:', {\n        scope: tagDefinition.scope,\n        tag: tagDefinition.tag,\n        componentAgentInstructionName,\n        hasDirectInvocationInstructions: !!tagDefinition.componentAgentInstructionsMd,\n        hasInstructionAssistanceConfig: !!instructionAssistanceConfig\n    });\n\n    if (!tagDefinition.componentAgentInstructionsMd) {\n        // console.log('No componentAgentInstructionsMd found on tag definition');\n        return undefined;\n    }\n\n    const instructions = tagDefinition.componentAgentInstructionsMd[componentAgentInstructionName];\n\n    if (!instructions) {\n        console.log(`No instructions found for componentAgentInstructionName: ${componentAgentInstructionName}`);\n        console.log('Available instruction names:', Object.keys(tagDefinition.componentAgentInstructionsMd));\n        return undefined;\n    }\n\n    console.log('Component instructions found:', {\n        instructionLength: instructions.length\n    });\n\n    // Apply placeholder replacement if instruction assistance config is provided\n    if (instructionAssistanceConfig && agentInstructionFeature) {\n        return applyComponentInstructionAssistance(instructions, instructionAssistanceConfig, agentInstructionFeature);\n    }\n\n    return instructions;\n}\n\n/**\n * IMPORTANT!!!!!!!!!!!!!!!!!!!!!!\n *\n * See header at top of file for important notes.\n *\n * Apply instruction assistance placeholder replacement to component instructions\n *\n * @param componentInstructions - The raw component instructions with placeholders\n * @param instructionConfig - The instruction assistance configuration\n * @param agentInstructionFeature - The agent instruction feature configuration\n * @returns The component instructions with placeholders replaced\n */\nexport function applyComponentInstructionAssistance(\n    componentInstructions: string,\n    instructionConfig: InstructionAssistanceConfig,\n    agentInstructionFeature: AgentInstructionChatAppOverridableFeature\n): string {\n    let enhancedInstructions = componentInstructions;\n\n    console.log('Applying component instruction assistance:', {\n        includeTypescriptBackedOutputFormattingRequirements: agentInstructionFeature.includeTypescriptBackedOutputFormattingRequirements,\n        hasPlaceholder: enhancedInstructions.includes('{{typescript-backed-output-formatting-requirements}}')\n    });\n\n    // Replace typescript-backed-output-formatting-requirements placeholder if enabled\n    if (agentInstructionFeature.includeTypescriptBackedOutputFormattingRequirements && instructionConfig.typescriptBackedOutputFormattingRequirements) {\n        const placeholder = '{{typescript-backed-output-formatting-requirements}}';\n        if (enhancedInstructions.includes(placeholder)) {\n            console.log('Replacing typescript-backed-output-formatting-requirements placeholder');\n            enhancedInstructions = enhancedInstructions.replace(placeholder, instructionConfig.typescriptBackedOutputFormattingRequirements);\n        }\n    }\n\n    return enhancedInstructions;\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', 'typescript-backed-output-formatting-requirements'];\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        typescriptBackedOutputFormattingRequirements: params['typescript-backed-output-formatting-requirements']\n    };\n}\n"]}

package/dist/util/server-utils.js

@@ -67,7 +67,9 @@ function getOverridableFeatures(siteFeatures, chatApp, user) {
       completeExampleInstructionEnabled: false,
       completeExampleInstructionLine: void 0,
       jsonOnlyImperativeInstructionEnabled: false,
-      jsonOnlyImperativeInstructionLine: void 0
+      jsonOnlyImperativeInstructionLine: void 0,
+      includeTypescriptBackedOutputFormattingRequirements: false,
+      typescriptBackedOutputFormattingRequirements: void 0
     },
     instructionAugmentation: {
       enabled: false,
@@ -170,7 +172,9 @@ function getOverridableFeatures(siteFeatures, chatApp, user) {
       completeExampleInstructionEnabled: feature.completeExampleInstructionLine?.enabled ?? false,
       completeExampleInstructionLine: feature.completeExampleInstructionLine?.mdLine ?? void 0,
       jsonOnlyImperativeInstructionEnabled: feature.jsonOnlyImperativeInstructionLine?.enabled ?? false,
-      jsonOnlyImperativeInstructionLine: feature.jsonOnlyImperativeInstructionLine?.line ?? void 0
+      jsonOnlyImperativeInstructionLine: feature.jsonOnlyImperativeInstructionLine?.line ?? void 0,
+      includeTypescriptBackedOutputFormattingRequirements: feature.includeTypescriptBackedOutputFormattingRequirements?.enabled ?? false,
+      typescriptBackedOutputFormattingRequirements: feature.typescriptBackedOutputFormattingRequirements ?? void 0
     })
   );
   const effectiveInstructionAugmentationFeature = chatApp.override?.features?.instructionAugmentation || chatApp.features?.instructionAugmentation;