@memberjunction/ai-agents 5.27.1 → 5.29.0

package/dist/artifact-tools/DocxToolLibrary.js

@@ -0,0 +1,160 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+/**
+ * @fileoverview Artifact tool library for DOCX content.
+ *
+ * Parses a DOCX Buffer and exposes tools for extracting text,
+ * HTML, searching, reading lines, and splitting into sections.
+ */
+import { RegisterClass } from '@memberjunction/global';
+import { BaseArtifactToolLibrary } from '@memberjunction/ai-core-plus';
+let DocxToolLibrary = class DocxToolLibrary extends BaseArtifactToolLibrary {
+    GetToolList() {
+        return [
+            {
+                name: 'get_text',
+                description: 'Extracts raw text from the DOCX and returns it with character and word counts.',
+                inputSchema: { type: 'object', properties: {}, required: [] },
+            },
+            {
+                name: 'get_html',
+                description: 'Converts the DOCX to HTML, useful for understanding document structure.',
+                inputSchema: { type: 'object', properties: {}, required: [] },
+            },
+            {
+                name: 'search_text',
+                description: 'Regex search on the extracted text. Returns matching lines with line numbers.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        pattern: { type: 'string', description: 'Regex pattern to search for' },
+                        flags: { type: 'string', description: 'Regex flags (default: "g")' },
+                    },
+                    required: ['pattern'],
+                },
+            },
+            {
+                name: 'get_lines',
+                description: 'Returns a range of lines from the extracted text (0-based start).',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        start: { type: 'number', description: 'Zero-based start line index' },
+                        count: { type: 'number', description: 'Number of lines to return' },
+                    },
+                    required: ['start', 'count'],
+                },
+            },
+            {
+                name: 'get_sections',
+                description: 'Splits text by double newlines into logical sections, each with a 200-char preview.',
+                inputSchema: { type: 'object', properties: {}, required: [] },
+            },
+        ];
+    }
+    async InvokeTool(toolName, input, artifactContent) {
+        let extractedText;
+        try {
+            const buffer = this.toBuffer(artifactContent);
+            const mammoth = await this.loadMammoth();
+            const result = await mammoth.default.extractRawText({ buffer });
+            extractedText = result.value;
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return this.errorResult(`Failed to parse DOCX: ${message}`);
+        }
+        switch (toolName) {
+            case 'get_text':
+                return this.handleGetText(extractedText);
+            case 'get_html':
+                return this.handleGetHtml(artifactContent);
+            case 'search_text':
+                return this.handleSearchText(extractedText, input);
+            case 'get_lines':
+                return this.handleGetLines(extractedText, input);
+            case 'get_sections':
+                return this.handleGetSections(extractedText);
+            default:
+                return this.errorResult(`Unknown tool: "${toolName}".`);
+        }
+    }
+    handleGetText(text) {
+        return this.successResult({
+            text,
+            characterCount: text.length,
+            wordCount: text.length > 0 ? text.split(/\s+/).filter((w) => w.length > 0).length : 0,
+        });
+    }
+    async handleGetHtml(artifactContent) {
+        try {
+            const buffer = this.toBuffer(artifactContent);
+            const mammoth = await this.loadMammoth();
+            const result = await mammoth.default.convertToHtml({ buffer });
+            return this.successResult({ html: result.value });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return this.errorResult(`Failed to convert DOCX to HTML: ${message}`);
+        }
+    }
+    handleSearchText(text, input) {
+        const pattern = input.pattern;
+        const flags = input.flags ?? 'g';
+        let regex;
+        try {
+            regex = new RegExp(pattern, flags);
+        }
+        catch {
+            return this.errorResult(`Invalid regex pattern: "${pattern}".`);
+        }
+        const lines = text.split('\n');
+        const matches = [];
+        for (let i = 0; i < lines.length; i++) {
+            if (regex.test(lines[i])) {
+                matches.push({ lineNumber: i, text: lines[i] });
+            }
+            regex.lastIndex = 0;
+        }
+        return this.successResult({ matches });
+    }
+    handleGetLines(text, input) {
+        const start = input.start;
+        const count = input.count;
+        const lines = text.split('\n');
+        if (start < 0 || start >= lines.length) {
+            return this.errorResult(`Start index ${start} is out of range (0–${lines.length - 1}).`);
+        }
+        const sliced = lines.slice(start, start + count);
+        return this.successResult({ lines: sliced, start, count: sliced.length });
+    }
+    handleGetSections(text) {
+        const parts = text.split(/\n\s*\n/).filter((s) => s.trim().length > 0);
+        const sections = parts.map((section, index) => ({
+            index,
+            preview: section.substring(0, 200),
+        }));
+        return this.successResult({ sections });
+    }
+    toBuffer(content) {
+        return Buffer.isBuffer(content) ? content : Buffer.from(content, 'utf-8');
+    }
+    async loadMammoth() {
+        return import('mammoth');
+    }
+    successResult(data) {
+        return { success: true, data };
+    }
+    errorResult(errorMessage) {
+        return { success: false, data: null, errorMessage };
+    }
+};
+DocxToolLibrary = __decorate([
+    RegisterClass(BaseArtifactToolLibrary, 'DocxToolLibrary')
+], DocxToolLibrary);
+export { DocxToolLibrary };
+//# sourceMappingURL=DocxToolLibrary.js.map

package/dist/artifact-tools/DocxToolLibrary.js.map

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

package/dist/artifact-tools/ExcelToolLibrary.d.ts

@@ -0,0 +1,16 @@
+import { BaseArtifactToolLibrary, type ArtifactToolDefinition, type ArtifactToolResult } from '@memberjunction/ai-core-plus';
+export declare class ExcelToolLibrary extends BaseArtifactToolLibrary {
+    GetToolList(): ArtifactToolDefinition[];
+    InvokeTool(toolName: string, input: Record<string, unknown>, artifactContent: string | Buffer): Promise<ArtifactToolResult>;
+    private handleGetSheets;
+    private handleGetSheetData;
+    private handleSearchCells;
+    private handleAggregateColumn;
+    private handleGetFormulas;
+    private computeAggregate;
+    private buildHeaderMap;
+    private toBuffer;
+    private successResult;
+    private errorResult;
+}
+//# sourceMappingURL=ExcelToolLibrary.d.ts.map

package/dist/artifact-tools/ExcelToolLibrary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExcelToolLibrary.d.ts","sourceRoot":"","sources":["../../src/artifact-tools/ExcelToolLibrary.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,uBAAuB,EAAE,KAAK,sBAAsB,EAAE,KAAK,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AA6D7H,qBACa,gBAAiB,SAAQ,uBAAuB;IAKpD,WAAW,IAAI,sBAAsB,EAAE;IA+DjC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAiCxI,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,kBAAkB;IAmC1B,OAAO,CAAC,iBAAiB;IAuCzB,OAAO,CAAC,qBAAqB;IAkD7B,OAAO,CAAC,iBAAiB;IA0BzB,OAAO,CAAC,gBAAgB;IAqBxB,OAAO,CAAC,cAAc;IAetB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,WAAW;CAGpB"}

package/dist/artifact-tools/ExcelToolLibrary.js

@@ -0,0 +1,300 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+/**
+ * @fileoverview Artifact tool library for Excel (.xlsx) content.
+ *
+ * Parses an Excel workbook from a Buffer and exposes tools for inspecting
+ * sheets, reading rows, searching cells, aggregating columns, and listing formulas.
+ */
+import { RegisterClass } from '@memberjunction/global';
+import { BaseArtifactToolLibrary } from '@memberjunction/ai-core-plus';
+const VALID_AGGREGATE_OPS = new Set(['sum', 'avg', 'count', 'min', 'max']);
+// ---------------------------------------------------------------------------
+// ExcelToolLibrary
+// ---------------------------------------------------------------------------
+let ExcelToolLibrary = class ExcelToolLibrary extends BaseArtifactToolLibrary {
+    // -----------------------------------------------------------------------
+    // GetToolList
+    // -----------------------------------------------------------------------
+    GetToolList() {
+        return [
+            {
+                name: 'get_sheets',
+                description: 'Returns sheet names, row counts, and column counts for every sheet in the workbook.',
+                inputSchema: { type: 'object', properties: {}, required: [] },
+            },
+            {
+                name: 'get_sheet_data',
+                description: 'Returns rows from a sheet as key-value objects using the header row as keys. Defaults to first 50 data rows.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        sheet: { type: 'string', description: 'Sheet name' },
+                        startRow: { type: 'number', description: '1-based data row to start from (after header). Default: 1' },
+                        rowCount: { type: 'number', description: 'Number of data rows to return. Default: 50' },
+                    },
+                    required: ['sheet'],
+                },
+            },
+            {
+                name: 'search_cells',
+                description: 'Regex search across all cells. Optionally scope to a single sheet. Returns up to 100 matches.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        query: { type: 'string', description: 'Regex pattern to search for' },
+                        sheet: { type: 'string', description: 'Optional sheet name to limit search scope' },
+                    },
+                    required: ['query'],
+                },
+            },
+            {
+                name: 'aggregate_column',
+                description: 'Computes an aggregate (sum, avg, count, min, max) on a column identified by its header name.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        sheet: { type: 'string', description: 'Sheet name' },
+                        column: { type: 'string', description: 'Column header name' },
+                        operation: { type: 'string', description: 'Aggregate operation: sum, avg, count, min, max' },
+                    },
+                    required: ['sheet', 'column', 'operation'],
+                },
+            },
+            {
+                name: 'get_formulas',
+                description: 'Returns all cells containing formulas in a given sheet.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        sheet: { type: 'string', description: 'Sheet name' },
+                    },
+                    required: ['sheet'],
+                },
+            },
+        ];
+    }
+    // -----------------------------------------------------------------------
+    // InvokeTool — dispatcher
+    // -----------------------------------------------------------------------
+    async InvokeTool(toolName, input, artifactContent) {
+        const buffer = this.toBuffer(artifactContent);
+        let workbook;
+        try {
+            const ExcelJS = await import('exceljs');
+            workbook = new ExcelJS.default.Workbook();
+            await workbook.xlsx.load(buffer);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return this.errorResult(`Failed to parse Excel content: ${message}`);
+        }
+        switch (toolName) {
+            case 'get_sheets':
+                return this.handleGetSheets(workbook);
+            case 'get_sheet_data':
+                return this.handleGetSheetData(workbook, input);
+            case 'search_cells':
+                return this.handleSearchCells(workbook, input);
+            case 'aggregate_column':
+                return this.handleAggregateColumn(workbook, input);
+            case 'get_formulas':
+                return this.handleGetFormulas(workbook, input);
+            default:
+                return this.errorResult(`Unknown tool: "${toolName}".`);
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Tool handlers
+    // -----------------------------------------------------------------------
+    handleGetSheets(workbook) {
+        const sheets = workbook.worksheets.map((ws) => ({
+            name: ws.name,
+            rowCount: ws.rowCount,
+            columnCount: ws.columnCount,
+        }));
+        return this.successResult({ sheets });
+    }
+    handleGetSheetData(workbook, input) {
+        const sheetName = input.sheet;
+        const ws = workbook.getWorksheet(sheetName);
+        if (!ws) {
+            return this.errorResult(`Sheet "${sheetName}" not found.`);
+        }
+        const startRow = input.startRow ?? 1;
+        const rowCount = input.rowCount ?? 50;
+        const headerMap = this.buildHeaderMap(ws);
+        if (headerMap.size === 0) {
+            return this.successResult({ rows: [] });
+        }
+        const rows = [];
+        // Row 1 is header, data starts at row 2. startRow is 1-based offset after header.
+        const firstDataRow = 1 + startRow;
+        const lastDataRow = Math.min(1 + startRow + rowCount - 1, ws.rowCount);
+        for (let r = firstDataRow; r <= lastDataRow; r++) {
+            const row = ws.getRow(r);
+            if (!row || !row.values || row.values.length === 0)
+                continue;
+            const record = {};
+            const values = row.values;
+            for (const [colIndex, colName] of headerMap.entries()) {
+                record[colName] = values[colIndex] ?? null;
+            }
+            rows.push(record);
+        }
+        return this.successResult({ rows });
+    }
+    handleSearchCells(workbook, input) {
+        const query = input.query;
+        let regex;
+        try {
+            regex = new RegExp(query, 'i');
+        }
+        catch {
+            return this.errorResult(`Invalid regex pattern: "${query}".`);
+        }
+        const targetSheets = input.sheet ? [workbook.getWorksheet(input.sheet)] : workbook.worksheets;
+        const matches = [];
+        const MATCH_LIMIT = 100;
+        for (const ws of targetSheets) {
+            if (!ws)
+                continue;
+            ws.eachRow({ includeEmpty: false }, (row) => {
+                if (matches.length >= MATCH_LIMIT)
+                    return;
+                row.eachCell({ includeEmpty: false }, (cell) => {
+                    if (matches.length >= MATCH_LIMIT)
+                        return;
+                    const text = cell.text ?? String(cell.value ?? '');
+                    if (regex.test(text)) {
+                        matches.push({
+                            sheet: ws.name,
+                            cell: cell.address,
+                            value: text,
+                        });
+                    }
+                });
+            });
+        }
+        if (input.sheet && !targetSheets[0]) {
+            return this.errorResult(`Sheet "${input.sheet}" not found.`);
+        }
+        return this.successResult({ matches });
+    }
+    handleAggregateColumn(workbook, input) {
+        const sheetName = input.sheet;
+        const columnName = input.column;
+        const operation = input.operation;
+        const ws = workbook.getWorksheet(sheetName);
+        if (!ws) {
+            return this.errorResult(`Sheet "${sheetName}" not found.`);
+        }
+        if (!VALID_AGGREGATE_OPS.has(operation)) {
+            return this.errorResult(`Unsupported aggregate operation: "${operation}". Valid operations: ${[...VALID_AGGREGATE_OPS].join(', ')}.`);
+        }
+        const headerMap = this.buildHeaderMap(ws);
+        let targetCol = -1;
+        for (const [colIdx, name] of headerMap.entries()) {
+            if (name === columnName) {
+                targetCol = colIdx;
+                break;
+            }
+        }
+        if (targetCol === -1) {
+            return this.errorResult(`Column "${columnName}" not found in sheet "${sheetName}". Available columns: ${[...headerMap.values()].join(', ')}.`);
+        }
+        const numericValues = [];
+        for (let r = 2; r <= ws.rowCount; r++) {
+            const row = ws.getRow(r);
+            const values = row.values;
+            const raw = values[targetCol];
+            if (raw == null)
+                continue;
+            const num = Number(raw);
+            if (!isNaN(num)) {
+                numericValues.push(num);
+            }
+        }
+        if (operation === 'count') {
+            return this.successResult({ operation, column: columnName, value: numericValues.length });
+        }
+        if (numericValues.length === 0) {
+            return this.errorResult(`No numeric values found in column "${columnName}".`);
+        }
+        const result = this.computeAggregate(numericValues, operation);
+        return this.successResult({ operation, column: columnName, value: result });
+    }
+    handleGetFormulas(workbook, input) {
+        const sheetName = input.sheet;
+        const ws = workbook.getWorksheet(sheetName);
+        if (!ws) {
+            return this.errorResult(`Sheet "${sheetName}" not found.`);
+        }
+        const formulas = [];
+        ws.eachRow({ includeEmpty: false }, (row) => {
+            row.eachCell({ includeEmpty: false }, (cell) => {
+                if (cell.formula) {
+                    formulas.push({
+                        cell: cell.address,
+                        formula: cell.formula,
+                    });
+                }
+            });
+        });
+        return this.successResult({ formulas });
+    }
+    // -----------------------------------------------------------------------
+    // Aggregate computation (pure)
+    // -----------------------------------------------------------------------
+    computeAggregate(values, operation) {
+        switch (operation) {
+            case 'sum':
+                return values.reduce((acc, v) => acc + v, 0);
+            case 'avg': {
+                const sum = values.reduce((acc, v) => acc + v, 0);
+                return values.length > 0 ? sum / values.length : 0;
+            }
+            case 'count':
+                return values.length;
+            case 'min':
+                return Math.min(...values);
+            case 'max':
+                return Math.max(...values);
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Helpers
+    // -----------------------------------------------------------------------
+    buildHeaderMap(ws) {
+        const headerRow = ws.getRow(1);
+        const headerMap = new Map();
+        if (!headerRow || !headerRow.values)
+            return headerMap;
+        const values = headerRow.values;
+        for (let i = 1; i < values.length; i++) {
+            const val = values[i];
+            if (val != null && String(val).trim() !== '') {
+                headerMap.set(i, String(val).trim());
+            }
+        }
+        return headerMap;
+    }
+    toBuffer(content) {
+        return typeof content === 'string' ? Buffer.from(content, 'base64') : content;
+    }
+    successResult(data) {
+        return { success: true, data };
+    }
+    errorResult(errorMessage) {
+        return { success: false, data: null, errorMessage };
+    }
+};
+ExcelToolLibrary = __decorate([
+    RegisterClass(BaseArtifactToolLibrary, 'ExcelToolLibrary')
+], ExcelToolLibrary);
+export { ExcelToolLibrary };
+//# sourceMappingURL=ExcelToolLibrary.js.map

package/dist/artifact-tools/ExcelToolLibrary.js.map

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

package/dist/artifact-tools/JSONToolLibrary.d.ts

@@ -0,0 +1,18 @@
+import { BaseArtifactToolLibrary, ArtifactToolDefinition, ArtifactToolResult } from '@memberjunction/ai-core-plus';
+/**
+ * Tool library for navigating and querying JSON artifact content.
+ * Provides path navigation, key listing, recursive search, and array iteration.
+ */
+export declare class JSONToolLibrary extends BaseArtifactToolLibrary {
+    GetToolList(): ArtifactToolDefinition[];
+    InvokeTool(toolName: string, input: Record<string, unknown>, artifactContent: string | Buffer): Promise<ArtifactToolResult>;
+    private handleJsonPath;
+    private handleJsonKeys;
+    private handleJsonSearch;
+    private handleJsonIterate;
+    /** Navigate a dot-separated path through a parsed JSON value. */
+    private navigatePath;
+    /** Recursively search for keys matching `targetKey` with string values matching `pattern`. */
+    private searchRecursive;
+}
+//# sourceMappingURL=JSONToolLibrary.d.ts.map

package/dist/artifact-tools/JSONToolLibrary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JSONToolLibrary.d.ts","sourceRoot":"","sources":["../../src/artifact-tools/JSONToolLibrary.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAOnH;;;GAGG;AACH,qBACa,eAAgB,SAAQ,uBAAuB;IACxD,WAAW,IAAI,sBAAsB,EAAE;IAmDjC,UAAU,CACZ,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,eAAe,EAAE,MAAM,GAAG,MAAM,GACjC,OAAO,CAAC,kBAAkB,CAAC;IAwB9B,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,cAAc;IActB,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,iBAAiB;IAYzB,iEAAiE;IACjE,OAAO,CAAC,YAAY;IA2BpB,8FAA8F;IAC9F,OAAO,CAAC,eAAe;CA8B1B"}