@tstdl/base 0.93.193 → 0.93.194

package/ai/prompts/prompt-builder.d.ts

@@ -16,6 +16,8 @@ export declare class PromptBuilder {
     setOutputSchema<Input = ObjectLiteral, Output = ObjectLiteral>(schema: SchemaTestable<Output>, examples?: FewShotExample<Input, Output>[]): this;
     setSystemOutputExamples<Input = ObjectLiteral, Output = ObjectLiteral>(examples: FewShotExample<Input, Output>[]): this;
     setOutputExamples<Input = ObjectLiteral, Output = ObjectLiteral>(examples: FewShotExample<Input, Output>[]): this;
+    enableSystemOutputRules(enabled?: boolean): this;
+    enableOutputRules(enabled?: boolean): this;
     setSystemInstructionsOverride(override: ((instructions: Instructions) => Instructions | string) | undefined): this;
     setInstructionsOverride(override: ((instructions: Instructions) => Instructions | string) | undefined): this;
     setLanguage(language: string): this;

package/ai/prompts/prompt-builder.js

@@ -14,8 +14,10 @@ export class PromptBuilder {
     #task;
     #systemOutputSchema;
     #systemOutputExamples;
+    #systemOutputRules = false;
     #outputSchema;
     #outputExamples;
+    #outputRules = false;
     #systemInstructions = {};
     #instructions = {};
     #systemContextParts = {};
@@ -57,6 +59,14 @@ export class PromptBuilder {
         this.#outputExamples = examples;
         return this;
     }
+    enableSystemOutputRules(enabled = true) {
+        this.#systemOutputRules = enabled;
+        return this;
+    }
+    enableOutputRules(enabled = true) {
+        this.#outputRules = enabled;
+        return this;
+    }
     setSystemInstructionsOverride(override) {
         this.#systemInstructionsOverride = override;
         return this;
@@ -108,6 +118,7 @@ export class PromptBuilder {
             instructions: this.#systemInstructions,
             outputSchema: this.#systemOutputSchema,
             outputExamples: this.#systemOutputExamples,
+            outputRules: this.#systemOutputRules,
             task: this.#systemTask,
             media: this.#systemMedia,
             language: this.#language,
@@ -121,6 +132,7 @@ export class PromptBuilder {
             instructions: this.#instructions,
             outputSchema: this.#outputSchema,
             outputExamples: this.#outputExamples,
+            outputRules: this.#outputRules,
             task: this.#task,
             media: this.#media,
             language: this.#language,
@@ -152,17 +164,19 @@ function buildPrompt(data) {
         instructions['**Instructions**'] = data.instructions;
     }
     const hasOutputSchema = isDefined(data.outputSchema);
-    if (hasOutputSchema || isDefined(data.outputExamples)) {
+    if (hasOutputSchema || data.outputRules || isDefined(data.outputExamples)) {
         if (hasOutputSchema) {
             const schema = convertToOpenApiSchema(data.outputSchema);
             const schemaJson = JSON.stringify(schema, null, 2);
             instructions['**Output Schema**'] = `\`\`\`json\n${schemaJson}\n\`\`\``;
         }
-        instructions['**Output Schema Instructions**'] = unorderedList({
-            'Schema Compliance': 'Generate valid JSON that strictly matches the provided schema.',
-            'Nullable fields with missing data': 'Must be set to literal `null`, not the string "null".',
-            'Optional fields with missing data': 'Omit the key entirely (sparse JSON).',
-        });
+        if (data.outputRules) {
+            instructions['**Output Schema Instructions**'] = unorderedList({
+                'Schema Compliance': 'Generate valid JSON that strictly matches the provided schema.',
+                'Nullable fields with missing data': 'Must be set to literal `null`, not the string "null".',
+                'Optional fields with missing data': 'Omit the key entirely (sparse JSON).',
+            });
+        }
         if (isDefined(data.outputExamples) && (data.outputExamples.length > 0)) {
             instructions['**Output Examples**'] = fewShotPrompt(data.outputExamples);
         }

package/document-management/server/services/document-management-ai.prompts.d.ts

@@ -16,7 +16,7 @@ export declare const dataExtractionFields: {
     Tags: string;
     Date: string;
 };
-export declare function createDataExtractionPrompt(schema: SchemaTestable): PromptBuilder;
+export declare function createDataExtractionPrompt(): PromptBuilder;
 export declare const assignCollectionSchema: import("../../../schema/index.js").ObjectSchema<{
     collectionIds: string[];
 }>;

package/document-management/server/services/document-management-ai.prompts.js

@@ -8,7 +8,7 @@ export function createContentExtractionPrompt() {
     return promptBuilder()
         .setSystemRole(DOCUMENT_MANAGEMENT_SYSTEM_ROLE)
         .setTask('Transcribe the attached document into Markdown following the instructions.')
-        .setOutputSchema(contentExtractionSchema)
+        .enableOutputRules()
         .addInstructions({
         'Objective': 'Convert the provided document into semantically structured, clean Markdown.',
         'Critical Constraints': orderedList([
@@ -56,12 +56,11 @@ export function createClassifySchema(validTypes) {
     return object({ documentType: enumeration(validTypes) });
 }
 export function createClassifyPrompt(validTypes) {
-    const schema = createClassifySchema(validTypes);
     return promptBuilder()
         .setSystemRole(DOCUMENT_MANAGEMENT_SYSTEM_ROLE)
         .setRole('Document Taxonomy Specialist')
         .setTask('Determine the single most accurate document type from the provided list based on the document.')
-        .setOutputSchema(schema, CLASSIFY_FEW_SHOT)
+        .setOutputExamples(CLASSIFY_FEW_SHOT)
         .addInstructions({
         'Analysis Strategy': orderedList([
             'Scan the header and title for explicit document type names (e.g., "Invoice", "Contract", "Bill of Lading").',
@@ -85,12 +84,12 @@ export const dataExtractionFields = {
     Tags: 'Generate 3-5 keywords for categorization. Only use important information missing in title, subtitle and properties. Prioritize reusing of existing tags where possible.',
     Date: 'Identify the *creation* date of the document. If multiple dates exist, prioritize the primary date (like invoice or letter Date). Return as object with year, month and day.',
 };
-export function createDataExtractionPrompt(schema) {
+export function createDataExtractionPrompt() {
     return promptBuilder()
         .setSystemRole(DOCUMENT_MANAGEMENT_SYSTEM_ROLE)
         .setRole('Structured Data Extraction Analyst')
         .setTask('Analyze the document and extract metadata and specific properties defined in the output schema following the instructions.')
-        .setOutputSchema(schema)
+        .enableOutputRules()
         .addInstructions({
         'Field Specific Instructions': dataExtractionFields,
         'Property Extraction': orderedList([
@@ -119,7 +118,7 @@ export function createAssignCollectionPrompt() {
         .setSystemRole(DOCUMENT_MANAGEMENT_SYSTEM_ROLE)
         .setRole('Digital Filing Assistant')
         .setTask('Select the most appropriate collections for this document from the provided list following the instructions.')
-        .setOutputSchema(assignCollectionSchema, ASSIGN_COLLECTION_FEW_SHOT)
+        .setOutputExamples(ASSIGN_COLLECTION_FEW_SHOT)
         .addInstructions({
         'Matching Logic': orderedList([
             'Direct Key-Match: Look for exact keyword matches between the collection name and the document metadata.',
@@ -146,7 +145,7 @@ export function createAssignRequestPrompt() {
         .setSystemRole(DOCUMENT_MANAGEMENT_SYSTEM_ROLE)
         .setRole('Workflow Routing Agent')
         .setTask('Evaluate the document against the list of open requests and find the best match following the instructions.')
-        .setOutputSchema(assignRequestSchema, ASSIGN_REQUEST_FEW_SHOT)
+        .setOutputExamples(ASSIGN_REQUEST_FEW_SHOT)
         .addInstructions({
         'Matching Rules': orderedList({
             'Hard Constraints': 'If a Request has a "Comment" or specific property requirement, the document MUST fulfill it strictly (e.g., "Need bill from July" must match date).',

package/document-management/server/services/document-management-ai.service.js

@@ -134,7 +134,7 @@ let DocumentManagementAiService = DocumentManagementAiService_1 = class Document
             const override = (isNotNull(property.key) ? aiConfig.extraction?.properties?.[property.key] : undefined) ?? aiConfig.extraction?.properties?.[property.label];
             return isDefined(override) ? mergeInstructions(`Extract value for property "${property.label}".`, [override]) : undefined;
         }).filter(isDefined);
-        const promptBuilder = createDataExtractionPrompt(generationSchema);
+        const promptBuilder = createDataExtractionPrompt();
         promptBuilder.addInstructions({
             'Field Specific Instructions': mergedFieldInstructions,
             'Additional Property Extraction': isDefined(mergedPropertyInstructions) && (mergedPropertyInstructions.length > 0)

package/document-management/server/validators/ai-validation-executor.js

@@ -26,7 +26,7 @@ export class AiValidationExecutor extends DocumentValidationExecutor {
             .setSystemTask('Validate a document based on the provided validation instructions and document content.')
             .setTask('Validate the document based on the provided system and validation instructions and the document content.')
             .addInstructions({ 'Validation Instructions': validationInstructions })
-            .setOutputSchema(this.schema)
+            .enableOutputRules()
             .addMedia(documentContent, context.document.mimeType);
         if (isDefined(language)) {
             builder.setLanguage(language);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tstdl/base",
-  "version": "0.93.193",
+  "version": "0.93.194",
   "author": "Patrick Hein",
   "publishConfig": {
     "access": "public"