@vertesia/common 1.5.0-dev.20260806.125520Z → 1.5.0-dev.20260826.064249Z

package/lib/utils/schemas.d.ts

@@ -1,26 +1,4 @@
-import type { JSONSchema, ToolDefinition } from '@llumiverse/common';
-import type { InCodePrompt, InteractionRefWithSchema, PopulatedInteraction } from '../interaction.js';
-import { type ExecutablePromptSegmentDef } from '../prompt.js';
-/**
- * Sanitize a tool definition to only include fields expected by LLM APIs.
- * Removes extra fields like 'category', 'default', 'tools' that are
- * used internally but should not be sent to the LLM.
- */
-export declare function sanitizeToolDefinition(tool: ToolDefinition): ToolDefinition;
-/**
- * Sanitize an array of tool definitions.
- */
-export declare function sanitizeToolDefinitions(tools: ToolDefinition[] | undefined): ToolDefinition[] | undefined;
-export declare function removeExtraProperties<T>(schema: T): T;
-/**
- * Canonical hint string appended to document property descriptions.
- * Used by ensureDocumentStorePrefix (in @dglabs/workflows) to detect document
- * properties after serialization, when editor/format fields have been stripped.
- * Exported so both packages use the exact same string — do NOT duplicate.
- */
-export declare const DOCUMENT_STORE_HINT = "Use 'store:<document_id>' format to reference a document from the content store.";
-export declare function mergeJSONSchemas(schemas: JSONSchema[]): JSONSchema | null;
-export declare function _mergePromptsSchema(prompts: ExecutablePromptSegmentDef[]): JSONSchema | null;
-export declare function mergePromptsSchema(interaction: InteractionRefWithSchema | PopulatedInteraction): JSONSchema | null;
+import type { JSONSchema } from '@llumiverse/common';
+import type { InCodePrompt } from '../interaction.js';
 export declare function mergeInCodePromptSchemas(prompts: InCodePrompt[]): JSONSchema | null;
 //# sourceMappingURL=schemas.d.ts.map

package/lib/utils/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/utils/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAErE,OAAO,KAAK,EAAE,YAAY,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACtG,OAAO,EAAE,KAAK,0BAA0B,EAAwB,MAAM,cAAc,CAAC;AAErF;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,cAAc,GAAG,cAAc,CAM3E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,SAAS,GAAG,cAAc,EAAE,GAAG,SAAS,CAGzG;AAKD,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CA0BrD;AAUD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,qFAAqF,CAAC;AAuBtH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,UAAU,EAAE,qBAgBrD;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,EAAE,qBAyCxE;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,wBAAwB,GAAG,oBAAoB,qBAG9F;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,YAAY,EAAE,qBAsB/D"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/utils/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,YAAY,EAAE,qBAsB/D"}

package/lib/utils/schemas.js

@@ -1,154 +1,3 @@
-import { PromptRole } from '@llumiverse/common';
-import { PromptSegmentDefType } from '../prompt.js';
-/**
- * Sanitize a tool definition to only include fields expected by LLM APIs.
- * Removes extra fields like 'category', 'default', 'tools' that are
- * used internally but should not be sent to the LLM.
- */
-export function sanitizeToolDefinition(tool) {
-    return {
-        name: tool.name,
-        description: tool.description,
-        input_schema: tool.input_schema,
-    };
-}
-/**
- * Sanitize an array of tool definitions.
- */
-export function sanitizeToolDefinitions(tools) {
-    if (!tools)
-        return tools;
-    return tools.map(sanitizeToolDefinition);
-}
-// Remove custom properties from the JSON before sending further down execution pipeline.
-// Before stripping UI-only fields (editor, format), translate them into LLM-friendly
-// schema hints so the model knows the expected value format.
-export function removeExtraProperties(schema) {
-    if (!schema)
-        return schema;
-    if (Array.isArray(schema)) {
-        for (const item of schema) {
-            removeExtraProperties(item);
-        }
-    }
-    else if (typeof schema === 'object') {
-        const obj = schema;
-        // If this looks like a property definition (has editor/format for document/media),
-        // enrich it with type and description hints before stripping.
-        if (isDocumentProperty(obj)) {
-            enrichDocumentProperty(obj);
-        }
-        for (const [key, value] of Object.entries(obj)) {
-            if (key === 'editor' && (value === 'textarea' || value === 'document' || value === 'media')) {
-                delete obj[key];
-            }
-            else if (key === 'format' && (value === 'textarea' || value === 'document' || value === 'media')) {
-                delete obj[key];
-            }
-            else if (typeof value === 'object') {
-                removeExtraProperties(value);
-            }
-        }
-    }
-    return schema;
-}
-/**
- * Returns true if the schema property represents a document reference
- * (identified by editor: "document" or format: "document" / "media").
- */
-function isDocumentProperty(obj) {
-    return obj.editor === 'document' || obj.format === 'document' || obj.format === 'media';
-}
-/**
- * Canonical hint string appended to document property descriptions.
- * Used by ensureDocumentStorePrefix (in @dglabs/workflows) to detect document
- * properties after serialization, when editor/format fields have been stripped.
- * Exported so both packages use the exact same string — do NOT duplicate.
- */
-export const DOCUMENT_STORE_HINT = "Use 'store:<document_id>' format to reference a document from the content store.";
-/**
- * Enriches a document property schema with LLM-friendly hints:
- * - Sets type to "string" if not already set
- * - Appends a store: prefix hint to the description
- */
-function enrichDocumentProperty(obj) {
-    // Set type to string if missing (document references are string IDs)
-    if (!obj.type) {
-        obj.type = 'string';
-    }
-    // Always ensure the canonical hint is present in the description.
-    // Check for the exact hint string (not just 'store:') to avoid missing detection
-    // after serialization when only the description survives.
-    if (!obj.description) {
-        obj.description = DOCUMENT_STORE_HINT;
-    }
-    else if (typeof obj.description === 'string' && !obj.description.includes(DOCUMENT_STORE_HINT)) {
-        obj.description = `${obj.description} ${DOCUMENT_STORE_HINT}`;
-    }
-}
-export function mergeJSONSchemas(schemas) {
-    const props = {};
-    const required = [];
-    for (const schema of schemas) {
-        if (schema.properties) {
-            if (schema.required) {
-                for (const prop of schema.required) {
-                    if (!required.includes(prop))
-                        required.push(prop);
-                }
-            }
-            Object.assign(props, schema.properties);
-        }
-    }
-    const schema = Object.keys(props).length > 0 ? { properties: props, required, type: 'object' } : null;
-    return schema;
-}
-export function _mergePromptsSchema(prompts) {
-    const props = {};
-    const required = new Set();
-    for (const prompt of prompts) {
-        if (prompt.template?.inputSchema?.properties) {
-            const schema = prompt.template?.inputSchema;
-            if (schema.required) {
-                for (const prop of schema.required) {
-                    required.add(prop);
-                }
-            }
-            Object.assign(props, schema.properties);
-        }
-        else if (prompt.type === PromptSegmentDefType.chat) {
-            Object.assign(props, {
-                chat: {
-                    type: 'array',
-                    items: {
-                        type: 'object',
-                        properties: {
-                            role: {
-                                type: 'string',
-                                enum: [PromptRole.assistant, PromptRole.user],
-                            },
-                            content: { type: 'string' },
-                        },
-                        required: ['role', 'content'],
-                    },
-                },
-            });
-            required.add('chat');
-        }
-    }
-    const schema = Object.keys(props).length > 0
-        ? {
-            properties: props,
-            required: Array.from(required),
-        }
-        : null;
-    return schema;
-}
-export function mergePromptsSchema(interaction) {
-    if (!interaction.prompts)
-        return null;
-    return _mergePromptsSchema(interaction.prompts);
-}
 export function mergeInCodePromptSchemas(prompts) {
     const props = {};
     const required = new Set();

package/lib/utils/schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/utils/schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/utils/schemas.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,wBAAwB,CAAC,OAAuB;IAC5D,MAAM,KAAK,GAA+B,EAAE,CAAC;IAC7C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YAC7B,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBAClB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,QAAoB,EAAE,CAAC;oBAC7C,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACvB,CAAC;YACL,CAAC;YACD,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QAC5C,CAAC;IACL,CAAC;IACD,MAAM,MAAM,GACR,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC;QACzB,CAAC,CAAC;YACI,UAAU,EAAE,KAAK;YACjB,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;SACjC;QACH,CAAC,CAAC,IAAI,CAAC;IACf,OAAO,MAAM,CAAC;AAClB,CAAC"}