@minded-ai/mindedjs 1.0.0-ec2-beta-1

package/dist/playbooks/playbooks.js

@@ -0,0 +1,208 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadPlaybooks = loadPlaybooks;
+exports.combinePlaybooks = combinePlaybooks;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const yaml = __importStar(require("js-yaml"));
+const mindedConnection = __importStar(require("../platform/mindedConnection"));
+const mindedConnectionTypes_1 = require("../platform/mindedConnectionTypes");
+const config_1 = require("../platform/config");
+const logger_1 = require("../utils/logger");
+const Platform_types_1 = require("../types/Platform.types");
+/**
+ * Decode HTML entities in a string
+ */
+function decodeHtmlEntities(text) {
+    const entities = {
+        '&amp;': '&',
+        '&lt;': '<',
+        '&gt;': '>',
+        '&quot;': '"',
+        '&#39;': "'",
+        '&apos;': "'",
+        '&#x27;': "'",
+        '&#x2F;': '/',
+        '&#x60;': '`',
+        '&#x3D;': '=',
+    };
+    return text.replace(/&[#\w]+;/g, (entity) => entities[entity] || entity);
+}
+/**
+ * Convert EditorJS blocks to markdown
+ */
+function editorJsToMarkdown(blocks) {
+    if (!blocks || blocks.length === 0) {
+        return '';
+    }
+    return blocks
+        .map((block) => {
+        var _a, _b, _c, _d, _e, _f, _g, _h;
+        try {
+            switch (block.type) {
+                case 'header': {
+                    const level = ((_a = block.data) === null || _a === void 0 ? void 0 : _a.level) || 1;
+                    const headerPrefix = '#'.repeat(level);
+                    const text = ((_b = block.data) === null || _b === void 0 ? void 0 : _b.text) || '';
+                    return `${headerPrefix} ${decodeHtmlEntities(text)}`;
+                }
+                case 'paragraph': {
+                    const text = ((_c = block.data) === null || _c === void 0 ? void 0 : _c.text) || '';
+                    return decodeHtmlEntities(text);
+                }
+                case 'list': {
+                    const items = ((_d = block.data) === null || _d === void 0 ? void 0 : _d.items) || [];
+                    const style = ((_e = block.data) === null || _e === void 0 ? void 0 : _e.style) || 'unordered';
+                    return items
+                        .map((item, index) => {
+                        const decodedItem = decodeHtmlEntities(item.content);
+                        if (style === 'ordered') {
+                            return `${index + 1}. ${decodedItem}`;
+                        }
+                        else {
+                            return `- ${decodedItem}`;
+                        }
+                    })
+                        .join('\n');
+                }
+                case 'quote': {
+                    const text = ((_f = block.data) === null || _f === void 0 ? void 0 : _f.text) || '';
+                    const caption = ((_g = block.data) === null || _g === void 0 ? void 0 : _g.caption) ? `\n*${decodeHtmlEntities(block.data.caption)}*` : '';
+                    return `> ${decodeHtmlEntities(text)}${caption}`;
+                }
+                case 'code': {
+                    const code = ((_h = block.data) === null || _h === void 0 ? void 0 : _h.code) || '';
+                    return `\`\`\`\n${decodeHtmlEntities(code)}\n\`\`\``;
+                }
+                case 'delimiter': {
+                    return '---';
+                }
+                default: {
+                    logger_1.logger.warn(`Unknown playbook block type: ${block.type}`);
+                    return '';
+                }
+            }
+        }
+        catch (err) {
+            logger_1.logger.error({ message: 'Error converting EditorJS blocks to markdown', err, block });
+            throw err;
+        }
+    })
+        .join('\n\n');
+}
+/**
+ * Load playbooks from directories or platform
+ */
+async function loadPlaybooks(playbooksDirectories) {
+    const { env, isDeployed } = (0, config_1.getConfig)();
+    let playbooks = [];
+    if ([Platform_types_1.Environment.DEVELOPMENT].includes(env) && isDeployed && mindedConnection.isConnected()) {
+        // Load from platform
+        const response = await mindedConnection.awaitEmit(mindedConnectionTypes_1.mindedConnectionSocketMessageType.GET_PLAYBOOKS, {});
+        if (response === null || response === void 0 ? void 0 : response.error) {
+            throw new Error(`Failed to load playbooks from platform: ${response.error}`);
+        }
+        playbooks = (response === null || response === void 0 ? void 0 : response.playbooks) || [];
+    }
+    else if (playbooksDirectories) {
+        // Load from directories
+        playbooks = loadPlaybooksFromDirectories(playbooksDirectories);
+    }
+    return playbooks;
+}
+/**
+ * Load playbooks from local directories
+ */
+function loadPlaybooksFromDirectories(directories) {
+    const playbooks = [];
+    for (const directory of directories) {
+        if (!fs.existsSync(directory)) {
+            logger_1.logger.info({ msg: `Playbooks directory does not exist: ${directory}` });
+            continue;
+        }
+        const files = getAllYamlFiles(directory);
+        for (const file of files) {
+            try {
+                const fileContent = fs.readFileSync(file, 'utf8');
+                const playbook = yaml.load(fileContent);
+                if (playbook && playbook.name && playbook.blocks) {
+                    playbooks.push(playbook);
+                    logger_1.logger.info({ msg: `Loaded playbook: ${playbook.name} from ${file}` });
+                }
+                else {
+                    logger_1.logger.warn({ msg: `Invalid playbook structure in ${file}` });
+                }
+            }
+            catch (err) {
+                logger_1.logger.error({ message: `Failed to load playbook file ${file}: ${err}` });
+            }
+        }
+    }
+    return playbooks;
+}
+/**
+ * Recursively get all YAML files in a directory
+ */
+function getAllYamlFiles(dir) {
+    const files = [];
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...getAllYamlFiles(fullPath));
+        }
+        else if (entry.name.endsWith('.yaml') || entry.name.endsWith('.yml')) {
+            files.push(fullPath);
+        }
+    }
+    return files;
+}
+/**
+ * Combine playbooks into a single string
+ */
+function combinePlaybooks(playbooks) {
+    if (playbooks.length === 0) {
+        return null;
+    }
+    // Combine all playbooks into sections
+    const sections = playbooks.map((playbook) => {
+        const markdownContent = editorJsToMarkdown(playbook.blocks);
+        return `# ${playbook.name}\n${markdownContent}`;
+    });
+    const combinedPlaybooks = sections.join('\n\n');
+    return combinedPlaybooks;
+}
+//# sourceMappingURL=playbooks.js.map

package/dist/playbooks/playbooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playbooks.js","sourceRoot":"","sources":["../../src/playbooks/playbooks.ts"],"names":[],"mappings":"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"}

package/dist/toolsLibrary/classifier.d.ts

@@ -0,0 +1,74 @@
+import { z } from 'zod';
+import { Tool } from '../types/Tools.types';
+import { BaseLanguageModel } from '@langchain/core/language_models/base';
+export interface ClassDefinition {
+    name: string;
+    description: string;
+}
+export interface ClassifierConfig {
+    classes: ClassDefinition[];
+    systemPrompt?: string;
+    defaultClass: string;
+    defaultReason: string;
+}
+export interface ClassificationResult {
+    class: string;
+    reason: string;
+    confidence: number;
+    [key: string]: any;
+}
+/**
+ * Generic classifier utility that can be used standalone
+ * @param content The content to classify
+ * @param config The classifier configuration
+ * @param llm The language model to use for classification
+ * @returns The classification result
+ */
+export declare function classify(content: string, config: ClassifierConfig, llm: BaseLanguageModel): Promise<ClassificationResult>;
+/**
+ * Create a classifier from a simple class list
+ * @param classes Array of class names or [name, description] tuples
+ * @param options Configuration options (includeReason, defaultClass, defaultReason are required)
+ * @returns A configured classify function
+ */
+export declare function createClassifier(classes: string[] | [string, string][], options: Omit<ClassifierConfig, 'classes'>): (content: string, llm: BaseLanguageModel) => Promise<ClassificationResult>;
+export declare const schema: z.ZodObject<{
+    content: z.ZodString;
+    classes: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodString, z.ZodString], null>, z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        description: string;
+    }, {
+        name: string;
+        description: string;
+    }>]>, "many">>;
+    systemPrompt: z.ZodOptional<z.ZodString>;
+    defaultClass: z.ZodString;
+    defaultReason: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    content: string;
+    defaultClass: string;
+    defaultReason: string;
+    systemPrompt?: string | undefined;
+    classes?: (string | [string, string] | {
+        name: string;
+        description: string;
+    })[] | undefined;
+}, {
+    content: string;
+    defaultClass: string;
+    defaultReason: string;
+    systemPrompt?: string | undefined;
+    classes?: (string | [string, string] | {
+        name: string;
+        description: string;
+    })[] | undefined;
+}>;
+declare const classifierTool: Tool<typeof schema, any>;
+export default classifierTool;
+export declare function multiClassify(content: string, config: ClassifierConfig & {
+    maxClasses?: number;
+}, llm: BaseLanguageModel): Promise<ClassificationResult[]>;
+//# sourceMappingURL=classifier.d.ts.map

package/dist/toolsLibrary/classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifier.d.ts","sourceRoot":"","sources":["../../src/toolsLibrary/classifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAG5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAYzE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AA0BD;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA4E/H;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,IAazG,SAAS,MAAM,EAAE,KAAK,iBAAiB,mCAChD;AAGD,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBjB,CAAC;AAEH,QAAA,MAAM,cAAc,EAAE,IAAI,CAAC,OAAO,MAAM,EAAE,GAAG,CA2E5C,CAAC;AAEF,eAAe,cAAc,CAAC;AAG9B,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,gBAAgB,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,EAClD,GAAG,EAAE,iBAAiB,GACrB,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAsDjC"}

package/dist/toolsLibrary/classifier.js

@@ -0,0 +1,256 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.schema = void 0;
+exports.classify = classify;
+exports.createClassifier = createClassifier;
+exports.multiClassify = multiClassify;
+const zod_1 = require("zod");
+const logger_1 = require("../utils/logger");
+const messages_1 = require("@langchain/core/messages");
+function supportsStructuredOutput(llm) {
+    return 'withStructuredOutput' in llm && typeof llm.withStructuredOutput === 'function';
+}
+/**
+ * Create a dynamic Zod schema for classification result based on valid classes
+ */
+function createClassificationSchema(config) {
+    const validClassNames = config.classes.map((c) => c.name);
+    // Validate that we have at least one class (z.enum requires at least one value)
+    if (validClassNames.length === 0) {
+        throw new Error('Cannot create classification schema with empty classes array');
+    }
+    // Create a union type for valid class names
+    const classEnum = zod_1.z.enum(validClassNames);
+    // Build the schema - always include all fields
+    const schemaShape = {
+        class: classEnum.describe('The selected classification category'),
+        reason: zod_1.z.string().describe('Explanation for the classification'),
+        confidence: zod_1.z.number().min(0).max(1).describe('Confidence score between 0 and 1'),
+    };
+    return zod_1.z.object(schemaShape);
+}
+/**
+ * Generic classifier utility that can be used standalone
+ * @param content The content to classify
+ * @param config The classifier configuration
+ * @param llm The language model to use for classification
+ * @returns The classification result
+ */
+async function classify(content, config, llm) {
+    const MAX_RETRIES = 3;
+    let lastError = null;
+    // Validate that classes array is not empty
+    if (!config.classes || config.classes.length === 0) {
+        throw new Error('At least one class must be provided for classification');
+    }
+    // Check if LLM supports structured output upfront
+    if (!supportsStructuredOutput(llm)) {
+        throw new Error('LLM does not support structured output, which is required for classification');
+    }
+    for (let attempt = 1; attempt <= MAX_RETRIES; attempt++) {
+        try {
+            // Build the classification prompt
+            const classesDescription = config.classes.map((c) => `${c.name}: ${c.description}`).join('\n');
+            const basePrompt = config.systemPrompt || 'You are a classifier. Your task is to classify the given content into one of the following categories:';
+            let prompt = `${basePrompt}\n\n${classesDescription}\n\n`;
+            // Add retry feedback if this is not the first attempt
+            if (attempt > 1) {
+                const validClassNames = config.classes.map((c) => c.name);
+                prompt += `\n⚠️ IMPORTANT: Your previous classification attempt failed. `;
+                prompt += `You MUST select ONLY from these valid classes:\n${validClassNames.join(', ')}\n\n`;
+            }
+            // Create dynamic schema based on valid classes
+            const classificationSchema = createClassificationSchema(config);
+            // Add content to classify to the prompt
+            prompt += `\n\nContent to classify:\n${content}`;
+            // Use structured output for guaranteed compliance
+            const structuredLLM = llm.withStructuredOutput(classificationSchema);
+            const messages = [new messages_1.SystemMessage(prompt)];
+            const result = (await structuredLLM.invoke(messages));
+            // The result is already validated by withStructuredOutput
+            logger_1.logger.debug({
+                message: 'Classification successful with structured output',
+                attempt,
+                class: result.class,
+            });
+            return result;
+        }
+        catch (err) {
+            lastError = err;
+            logger_1.logger.warn({
+                message: `Classification attempt ${attempt} failed`,
+                attempt,
+                maxRetries: MAX_RETRIES,
+                error: lastError.message,
+            });
+        }
+    }
+    // All retries exhausted - fallback to default
+    logger_1.logger.warn({
+        message: 'Classification failed after max retries, using default class',
+        maxRetries: MAX_RETRIES,
+        lastError: lastError === null || lastError === void 0 ? void 0 : lastError.message,
+        defaultClass: config.defaultClass,
+        defaultReason: config.defaultReason,
+    });
+    // Return default classification
+    return {
+        class: config.defaultClass,
+        reason: config.defaultReason,
+        confidence: 0,
+    };
+}
+/**
+ * Create a classifier from a simple class list
+ * @param classes Array of class names or [name, description] tuples
+ * @param options Configuration options (includeReason, defaultClass, defaultReason are required)
+ * @returns A configured classify function
+ */
+function createClassifier(classes, options) {
+    const classDefinitions = classes.map((c) => {
+        if (typeof c === 'string') {
+            return { name: c, description: '' };
+        }
+        return { name: c[0], description: c[1] };
+    });
+    const config = {
+        ...options,
+        classes: classDefinitions,
+    };
+    return (content, llm) => classify(content, config, llm);
+}
+// Schema for the classifier tool
+exports.schema = zod_1.z.object({
+    content: zod_1.z.string().describe('The content to classify'),
+    classes: zod_1.z
+        .array(zod_1.z.union([
+        zod_1.z.string(),
+        zod_1.z.tuple([zod_1.z.string(), zod_1.z.string()]),
+        zod_1.z.object({
+            name: zod_1.z.string(),
+            description: zod_1.z.string(),
+        }),
+    ]))
+        .optional()
+        .describe('Classes to classify into. Can be strings, [name, description] tuples, or objects with name and description'),
+    systemPrompt: zod_1.z.string().optional().describe('Custom system prompt for classification'),
+    defaultClass: zod_1.z.string().describe('Default class to use if classification fails'),
+    defaultReason: zod_1.z.string().describe('Default reason to use if classification fails'),
+});
+const classifierTool = {
+    name: 'minded-classifier',
+    description: 'Classify content into predefined categories using AI. Supports custom classes and system prompts. Uses structured output for guaranteed schema compliance. Requires default fallback values.',
+    input: exports.schema,
+    isGlobal: false,
+    execute: async ({ input, state, agent }) => {
+        var _a, _b;
+        const { content, classes, systemPrompt, defaultClass, defaultReason } = input;
+        logger_1.logger.info({
+            message: 'Classifying content',
+            sessionId: state.sessionId,
+            contentLength: content.length,
+            classCount: classes === null || classes === void 0 ? void 0 : classes.length,
+        });
+        // Convert input classes to ClassDefinition format
+        let classDefinitions = [];
+        if (classes) {
+            classDefinitions = classes.map((c) => {
+                if (typeof c === 'string') {
+                    return { name: c, description: '' };
+                }
+                else if (Array.isArray(c)) {
+                    return { name: c[0], description: c[1] };
+                }
+                else {
+                    return c;
+                }
+            });
+        }
+        // If no classes provided, try to get from state memory
+        if (classDefinitions.length === 0 && ((_b = (_a = state.memory) === null || _a === void 0 ? void 0 : _a.classifierConfig) === null || _b === void 0 ? void 0 : _b.classes)) {
+            classDefinitions = state.memory.classifierConfig.classes;
+        }
+        if (classDefinitions.length === 0) {
+            throw new Error('No classes provided for classification');
+        }
+        const config = {
+            classes: classDefinitions,
+            systemPrompt,
+            defaultClass,
+            defaultReason,
+        };
+        try {
+            const result = await classify(content, config, agent.llm);
+            logger_1.logger.info({
+                message: 'Classification completed',
+                sessionId: state.sessionId,
+                class: result.class,
+                confidence: result.confidence,
+            });
+            state.memory.lastClassification = {
+                content: content.substring(0, 100) + (content.length > 100 ? '...' : ''),
+                result,
+                timestamp: new Date().toISOString(),
+            };
+            return {
+                result,
+            };
+        }
+        catch (err) {
+            logger_1.logger.error({
+                message: 'Classification failed',
+                sessionId: state.sessionId,
+                err,
+            });
+            throw err;
+        }
+    },
+};
+exports.default = classifierTool;
+// Export utility for multi-label classification
+async function multiClassify(content, config, llm) {
+    const maxClasses = config.maxClasses || 3;
+    // Validate that classes array is not empty
+    if (!config.classes || config.classes.length === 0) {
+        throw new Error('At least one class must be provided for multi-classification');
+    }
+    // Check if LLM supports structured output
+    if (!supportsStructuredOutput(llm)) {
+        throw new Error('LLM does not support structured output, which is required for multi-classification');
+    }
+    try {
+        const classesDescription = config.classes.map((c) => `${c.name}: ${c.description}`).join('\n');
+        const validClassNames = config.classes.map((c) => c.name);
+        const basePrompt = config.systemPrompt || 'You are a multi-label classifier. Select all applicable categories for the given content:';
+        const prompt = `${basePrompt}\n\n${classesDescription}\n\n
+Select up to ${maxClasses} classifications, ordered by relevance.
+
+Content to classify:
+${content}`;
+        // Create schema for array of classifications
+        const classEnum = zod_1.z.enum(validClassNames);
+        const multiClassSchema = zod_1.z
+            .array(zod_1.z.object({
+            class: classEnum.describe('The selected classification category'),
+            reason: zod_1.z.string().describe('Explanation for the classification'),
+            confidence: zod_1.z.number().min(0).max(1).describe('Confidence score between 0 and 1'),
+        }))
+            .min(1)
+            .max(maxClasses);
+        const structuredLLM = llm.withStructuredOutput(multiClassSchema);
+        const messages = [new messages_1.SystemMessage(prompt)];
+        const result = (await structuredLLM.invoke(messages));
+        return result;
+    }
+    catch (err) {
+        logger_1.logger.error({ message: 'Multi-classification failed', err });
+        return [
+            {
+                class: config.defaultClass,
+                reason: config.defaultReason,
+                confidence: 0,
+            },
+        ];
+    }
+}
+//# sourceMappingURL=classifier.js.map

package/dist/toolsLibrary/classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifier.js","sourceRoot":"","sources":["../../src/toolsLibrary/classifier.ts"],"names":[],"mappings":"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"}

package/dist/toolsLibrary/extraction.d.ts

@@ -0,0 +1,83 @@
+import { z } from 'zod';
+import { Tool } from '../types/Tools.types';
+import { BaseLanguageModel } from '@langchain/core/language_models/base';
+export type ExtractionSchema = z.ZodTypeAny;
+export interface ExtractionConfig {
+    schema: ExtractionSchema;
+    systemPrompt?: string;
+    examples?: Array<{
+        input: string;
+        output?: any;
+    }>;
+    defaultValue?: any;
+    maxRetries?: number;
+    strictMode?: boolean;
+}
+export type ExtractionResult = z.infer<ExtractionSchema>;
+/**
+ * Generic extraction utility that can be used standalone
+ *
+ * When strictMode is true:
+ * - If the LLM supports withStructuredOutput, it will use that for guaranteed schema compliance
+ * - Otherwise, it falls back to JSON parsing with Zod validation and retries
+ *
+ * When strictMode is false:
+ * - Uses JSON parsing without validation for more flexibility
+ *
+ * @param content The content to extract from
+ * @param config The extraction configuration
+ * @param llm The language model to use for extraction
+ * @param attemptNumber Current attempt number (used internally for retries)
+ * @returns The extraction result
+ */
+export declare function extract(content: string, config: ExtractionConfig, llm: BaseLanguageModel, attemptNumber?: number): Promise<ExtractionResult>;
+/**
+ * Create a simple extractor for common use cases
+ * @param schemaOrPrompt Either a Zod schema or a simple prompt string
+ * @param options Additional configuration options
+ * @returns A configured extract function
+ */
+export declare function createExtractor(schemaOrPrompt: ExtractionSchema | string, options?: Partial<ExtractionConfig>): (content: string, llm: BaseLanguageModel) => Promise<any>;
+export declare const schema: z.ZodObject<{
+    content: z.ZodString;
+    schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    systemPrompt: z.ZodOptional<z.ZodString>;
+    examples: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        input: z.ZodString;
+        output: z.ZodAny;
+    }, "strip", z.ZodTypeAny, {
+        input: string;
+        output?: any;
+    }, {
+        input: string;
+        output?: any;
+    }>, "many">>;
+    strictMode: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    maxRetries: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    defaultValue: z.ZodOptional<z.ZodAny>;
+}, "strip", z.ZodTypeAny, {
+    maxRetries: number;
+    content: string;
+    strictMode: boolean;
+    schema?: Record<string, any> | undefined;
+    systemPrompt?: string | undefined;
+    examples?: {
+        input: string;
+        output?: any;
+    }[] | undefined;
+    defaultValue?: any;
+}, {
+    content: string;
+    maxRetries?: number | undefined;
+    schema?: Record<string, any> | undefined;
+    systemPrompt?: string | undefined;
+    examples?: {
+        input: string;
+        output?: any;
+    }[] | undefined;
+    defaultValue?: any;
+    strictMode?: boolean | undefined;
+}>;
+declare const extractionTool: Tool<typeof schema, any>;
+export default extractionTool;
+//# sourceMappingURL=extraction.d.ts.map

package/dist/toolsLibrary/extraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction.d.ts","sourceRoot":"","sources":["../../src/toolsLibrary/extraction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAI5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAYzE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,UAAU,CAAC;AAE5C,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IAClD,YAAY,CAAC,EAAE,GAAG,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;AA0EzD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE,iBAAiB,EACtB,aAAa,GAAE,MAAU,GACxB,OAAO,CAAC,gBAAgB,CAAC,CA+G3B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,cAAc,EAAE,gBAAgB,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,IAoBpG,SAAS,MAAM,EAAE,KAAK,iBAAiB,kBAChD;AAGD,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBjB,CAAC;AAEH,QAAA,MAAM,cAAc,EAAE,IAAI,CAAC,OAAO,MAAM,EAAE,GAAG,CAyG5C,CAAC;AAEF,eAAe,cAAc,CAAC"}