@multiplayer-app/agent 0.1.9 → 0.1.10

package/dist/persistence/workspace.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.test.js","sourceRoot":"","sources":["../../src/persistence/workspace.test.ts"],"names":[],"mappings":";;;;;AAAA,gEAAuC;AACvC,yCAA8B;AAE9B,yCAAoC;AACpC,mDAAoD;AACpD,2CAAwD;AAExD,KAAK,MAAM,IAAI,IAAI,CAAC,KAAK,EAAE,UAAU,CAAU,EAAE,CAAC;IAChD,IAAA,cAAE,EAAC,UAAU,IAAI,oEAAoE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QACjG,MAAM,MAAM,GAAG;YACb,GAAG,CAAC,IAAI,KAAK,KAAK;gBAChB,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;gBACxG,CAAC,CAAC,EAAE,cAAc,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC;SACrD,CAAA;QACvB,MAAM,SAAS,GAAG,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,kBAAO,CAAC,SAAS,CAAC,CAAC,CAAC,kCAAkB,CAAC,SAAS,CAAA;QACnF,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,CAAA;QACrD,IAAI,OAAO,GAAG,CAAC,CAAA;QACf,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAc,EAAE,EAAE;YAC1D,gBAAM,CAAC,KAAK,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAA;YACxC,OAAO,IAAI,CAAC,CAAA;YACZ,IAAI,OAAO,KAAK,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAA;YACpD,OAAO,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAA;QAC/C,CAAC,CAAC,CAAA;QACF,MAAM,WAAW,GAAG,IAAA,sCAA0B,EAAC,MAAM,CAAE,CAAA;QACvD,gBAAM,CAAC,KAAK,CAAC,MAAM,WAAW,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,CAAA;QAC/C,gBAAM,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAA;QACvE,MAAM,gBAAM,CAAC,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,gBAAgB,CAAC,CAAA;QAClF,gBAAM,CAAC,SAAS,CAAC,MAAM,WAAW,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,IAAI,KAAK,KAAK;YAC/E,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAA;QACjF,gBAAM,CAAC,SAAS,CAAC,MAAM,WAAW,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,IAAI,KAAK,KAAK;YAC/E,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAA;IACjF,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/research/extraction-tool.d.ts

@@ -0,0 +1,6 @@
+import { type Tool } from 'ai';
+import type { AgentModel } from '../agent/definition';
+import type { SessionToolContext } from '../session/tool-context';
+/** Bulk extraction on the cheaper model: one call per file, structured rows appended to a JSONL file. */
+export declare function createExtractionTool(context: SessionToolContext, modelConfig: AgentModel): Tool;
+//# sourceMappingURL=extraction-tool.d.ts.map

package/dist/research/extraction-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction-tool.d.ts","sourceRoot":"","sources":["../../src/research/extraction-tool.ts"],"names":[],"mappings":"AAEA,OAAO,EAAsB,KAAK,IAAI,EAAE,MAAM,IAAI,CAAA;AAGlD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAKjE,yGAAyG;AACzG,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,UAAU,GAAG,IAAI,CAiD/F"}

package/dist/research/extraction-tool.js

@@ -0,0 +1,67 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createExtractionTool = createExtractionTool;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const ai_1 = require("ai");
+const zod_1 = require("zod");
+const resolve_model_1 = require("../models/resolve-model");
+const usage_1 = require("../models/usage");
+const MAX_EXTRACTION_CHARS = 60000;
+/** Bulk extraction on the cheaper model: one call per file, structured rows appended to a JSONL file. */
+function createExtractionTool(context, modelConfig) {
+    const { workspaceDir, abortSignal, recordUsage } = context;
+    return (0, ai_1.tool)({
+        description: 'Extract the same facts from many extracted-text files with a cheaper model, one file at a time, appending one JSON row per file to outputPath (JSONL). Use after search_documents/download_attachment saved texts under data/text/. Each row has the requested fields plus `quote` (the supporting span) and `source`.',
+        inputSchema: zod_1.z.object({
+            paths: zod_1.z.array(zod_1.z.string().min(1).max(500)).min(1).max(50),
+            question: zod_1.z.string().min(1).max(2000).describe('What to look for, precisely'),
+            fields: zod_1.z.array(zod_1.z.string().min(1).max(60)).min(1).max(15).describe('Field names each row must contain'),
+            outputPath: zod_1.z.string().min(1).max(300).describe('e.g. data/extracted/water-valve.jsonl'),
+        }),
+        execute: async ({ paths, question, fields, outputPath }, { toolCallId }) => {
+            const model = (0, resolve_model_1.resolveLanguageModel)(modelConfig.provider, modelConfig.id, modelConfig.attribution);
+            const output = node_path_1.default.resolve(workspaceDir, outputPath);
+            await node_fs_1.promises.mkdir(node_path_1.default.dirname(output), { recursive: true });
+            let rows = 0;
+            const failures = [];
+            const report = (index) => {
+                context.reportProgress([
+                    { key: 'extract', label: 'Extracting facts', status: index < paths.length ? 'active' : 'done', detail: `${index}/${paths.length} documents` },
+                ], toolCallId);
+            };
+            report(0);
+            for (const [index, relative] of paths.entries()) {
+                if (abortSignal.aborted)
+                    break;
+                if (index > 0 && index % 3 === 0)
+                    report(index);
+                try {
+                    const text = (await node_fs_1.promises.readFile(node_path_1.default.resolve(workspaceDir, relative), 'utf8')).slice(0, MAX_EXTRACTION_CHARS);
+                    const result = await (0, ai_1.generateText)({
+                        model,
+                        abortSignal,
+                        system: 'You extract facts from one insurance filing document. Answer with a single JSON object only — no prose. Use null for a field the document does not state. Always include "quote": the exact supporting text (max 300 characters) or null, and "found": true|false.',
+                        prompt: `Question: ${question}\nFields: ${fields.join(', ')}\n\nDocument (${relative}):\n${text}`,
+                    });
+                    const usage = (0, usage_1.usageOf)(result);
+                    if (usage)
+                        recordUsage(usage, modelConfig.id);
+                    const match = result.text.match(/\{[\s\S]*\}/);
+                    const parsed = match ? JSON.parse(match[0]) : { found: false };
+                    await node_fs_1.promises.appendFile(output, `${JSON.stringify({ source: relative, ...parsed })}\n`);
+                    rows += 1;
+                }
+                catch (error) {
+                    failures.push({ path: relative, reason: error.message });
+                }
+            }
+            report(paths.length);
+            return { outputPath, rows, failures, model: modelConfig.id };
+        },
+    });
+}
+//# sourceMappingURL=extraction-tool.js.map

package/dist/research/extraction-tool.js.map

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

package/dist/research/extraction-tool.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=extraction-tool.test.d.ts.map

package/dist/research/extraction-tool.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction-tool.test.d.ts","sourceRoot":"","sources":["../../src/research/extraction-tool.test.ts"],"names":[],"mappings":""}

package/dist/research/extraction-tool.test.js

@@ -0,0 +1,100 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const strict_1 = __importDefault(require("node:assert/strict"));
+const node_fs_1 = require("node:fs");
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_test_1 = require("node:test");
+const test_1 = require("ai/test");
+const modelProvider = __importStar(require("../models/resolve-model"));
+const attribution_1 = require("../models/attribution");
+const extraction_tool_1 = require("./extraction-tool");
+for (const cancelAfterFirst of [false, true]) {
+    (0, node_test_1.it)(`bulk extraction ${cancelAfterFirst ? 'stops after cancellation' : 'records usage and continues past missing files'}`, async (t) => {
+        const dir = await node_fs_1.promises.mkdtemp(node_path_1.default.join(node_os_1.default.tmpdir(), 'agent-extraction-'));
+        t.after(() => node_fs_1.promises.rm(dir, { recursive: true, force: true }));
+        await node_fs_1.promises.writeFile(node_path_1.default.join(dir, 'first.txt'), 'A water valve is required.');
+        await node_fs_1.promises.writeFile(node_path_1.default.join(dir, 'second.txt'), 'Another filing.');
+        const model = new test_1.MockLanguageModelV3({
+            doGenerate: async () => ({
+                content: [{ type: 'text', text: '{"found":true,"quote":"A water valve is required."}' }],
+                finishReason: { unified: 'stop', raw: 'stop' },
+                usage: {
+                    inputTokens: { total: 10, noCache: 10, cacheRead: 0, cacheWrite: 0 },
+                    outputTokens: { total: 5, text: 5, reasoning: 0 },
+                },
+                warnings: [],
+            }),
+        });
+        t.mock.method(modelProvider, 'resolveLanguageModel', (_provider, modelId, app) => {
+            strict_1.default.equal(modelId, 'extraction-model');
+            strict_1.default.equal(app, attribution_1.OPENROUTER_APPS.DEEP_RESEARCH);
+            return model;
+        });
+        const turn = { messageId: 'extract-turn', abort: new AbortController(), askedUser: false };
+        const events = [];
+        let usedTokens = 0;
+        const context = {
+            workspaceDir: dir,
+            abortSignal: turn.abort.signal,
+            reportProgress: (steps, toolCallId) => events.push({ type: 'progress', messageId: turn.messageId, toolCallId, steps }),
+            requestClarification() { },
+            publishFiles() { },
+            recordUsage(usage, modelId) {
+                usedTokens += usage.totalTokens;
+                strict_1.default.equal(modelId, 'extraction-model');
+                if (cancelAfterFirst)
+                    turn.abort.abort();
+            },
+        };
+        const result = await (0, extraction_tool_1.createExtractionTool)(context, { id: 'extraction-model', provider: {}, attribution: attribution_1.OPENROUTER_APPS.DEEP_RESEARCH }).execute({
+            paths: ['missing.txt', 'first.txt', 'second.txt'], question: 'Is a valve required?', fields: ['found'], outputPath: 'results/rows.jsonl',
+        }, { toolCallId: 'extract', messages: [] });
+        const expectedRows = cancelAfterFirst ? 1 : 2;
+        strict_1.default.equal(result.rows, expectedRows);
+        strict_1.default.deepEqual(result.failures.map((failure) => failure.path), ['missing.txt']);
+        strict_1.default.equal(model.doGenerateCalls.length, expectedRows);
+        strict_1.default.equal(usedTokens, 15 * expectedRows);
+        const rows = (await node_fs_1.promises.readFile(node_path_1.default.join(dir, 'results/rows.jsonl'), 'utf8')).trim().split('\n').map((line) => JSON.parse(line));
+        strict_1.default.equal(rows.length, expectedRows);
+        strict_1.default.deepEqual(rows[0], { source: 'first.txt', found: true, quote: 'A water valve is required.' });
+        strict_1.default.ok(events.every((event) => event.type === 'progress' && event.messageId === 'extract-turn' && event.toolCallId === 'extract'));
+    });
+}
+//# sourceMappingURL=extraction-tool.test.js.map

package/dist/research/extraction-tool.test.js.map

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

package/dist/research/filingramp/attachment-tools.d.ts

@@ -0,0 +1,4 @@
+import { type Tool } from 'ai';
+import { type FilingRampToolsOptions } from './shared';
+export declare function createAttachmentTools(options: FilingRampToolsOptions): Record<string, Tool>;
+//# sourceMappingURL=attachment-tools.d.ts.map

package/dist/research/filingramp/attachment-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-tools.d.ts","sourceRoot":"","sources":["../../../src/research/filingramp/attachment-tools.ts"],"names":[],"mappings":"AAIA,OAAO,EAAQ,KAAK,IAAI,EAAE,MAAM,IAAI,CAAA;AAEpC,OAAO,EAAgC,KAAK,sBAAsB,EAAE,MAAM,UAAU,CAAA;AAuBpF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAgE3F"}

package/dist/research/filingramp/attachment-tools.js

@@ -0,0 +1,99 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAttachmentTools = createAttachmentTools;
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const node_util_1 = require("node:util");
+const ai_1 = require("ai");
+const zod_1 = require("zod");
+const shared_1 = require("./shared");
+const execFileAsync = (0, node_util_1.promisify)(node_child_process_1.execFile);
+const MAX_INLINE_TEXT_CHARS = 4000;
+/** PDF → text with whatever the image has (mupdf first, poppler second). Empty text = scanned or protected. */
+async function extractPdfText(file, output) {
+    const attempts = [
+        ['mutool', ['draw', '-F', 'txt', '-o', output, file]],
+        ['pdftotext', ['-layout', file, output]],
+    ];
+    for (const [bin, args] of attempts) {
+        try {
+            await execFileAsync(bin, args, { timeout: 120000 });
+            const stat = await node_fs_1.promises.stat(output);
+            return stat.size;
+        }
+        catch (_a) {
+            /* try the next extractor */
+        }
+    }
+    return 0;
+}
+function createAttachmentTools(options) {
+    const { client, workspaceDir } = options;
+    const downloadAttachment = (0, ai_1.tool)({
+        description: 'Download one attachment by key into data/attachments/<trackingNumber>/<name> and, for PDFs, extract its text to data/text/<trackingNumber>/<name>.txt. Use when search_documents has no text for a document (large or scanned PDFs) or you need the original file. Returns paths and sizes, never the content.',
+        inputSchema: zod_1.z.object({
+            key: zod_1.z.string().min(1).max(2000),
+            trackingNumber: zod_1.z.string().max(100).optional(),
+            name: zod_1.z.string().max(300).optional(),
+            extractText: zod_1.z.boolean().optional().describe('default true for PDFs'),
+        }),
+        execute: async (input) => {
+            var _a, _b, _c;
+            const bytes = await client.downloadAttachment(input.key);
+            const folder = (0, shared_1.safeName)((_a = input.trackingNumber) !== null && _a !== void 0 ? _a : 'misc');
+            const fileName = (0, shared_1.safeName)((_c = (_b = input.name) !== null && _b !== void 0 ? _b : input.key.split('/').pop()) !== null && _c !== void 0 ? _c : 'attachment');
+            const filePath = `data/attachments/${folder}/${fileName}`;
+            const written = await (0, shared_1.writeWorkspaceFile)(workspaceDir, filePath, bytes);
+            const isPdf = /\.pdf$/i.test(fileName) || bytes.subarray(0, 4).toString() === '%PDF';
+            let textPath;
+            let textChars = 0;
+            if (isPdf && input.extractText !== false) {
+                textPath = `data/text/${folder}/${fileName.replace(/\.pdf$/i, '')}.txt`;
+                const absoluteText = node_path_1.default.resolve(workspaceDir, textPath);
+                await node_fs_1.promises.mkdir(node_path_1.default.dirname(absoluteText), { recursive: true });
+                textChars = await extractPdfText(node_path_1.default.resolve(workspaceDir, filePath), absoluteText);
+                if (textChars === 0)
+                    textPath = undefined;
+            }
+            return {
+                path: written.path,
+                bytes: written.bytes,
+                textPath,
+                textChars,
+                note: isPdf && textChars === 0 ? 'No extractable text (scanned or protected PDF) — record it as unreadable in findings.' : undefined,
+            };
+        },
+    });
+    const readText = (0, ai_1.tool)({
+        description: 'Read a slice of an extracted text file in the workspace (data/text/…). Prefer run_command with rg/grep to locate the passage first, then read only the lines around it. Hard cap per call keeps the conversation small.',
+        inputSchema: zod_1.z.object({
+            path: zod_1.z.string().min(1).max(500),
+            startLine: zod_1.z.number().int().min(1).optional(),
+            endLine: zod_1.z.number().int().min(1).optional(),
+        }),
+        execute: async (input) => {
+            var _a, _b;
+            const target = node_path_1.default.resolve(workspaceDir, input.path);
+            if (!target.startsWith(node_path_1.default.resolve(workspaceDir) + node_path_1.default.sep))
+                throw new Error('path escapes the workspace');
+            const content = await node_fs_1.promises.readFile(target, 'utf8');
+            const lines = content.split('\n');
+            const start = Math.max(1, (_a = input.startLine) !== null && _a !== void 0 ? _a : 1);
+            const end = Math.min(lines.length, (_b = input.endLine) !== null && _b !== void 0 ? _b : start + 80);
+            const slice = lines.slice(start - 1, end).join('\n');
+            return {
+                path: input.path,
+                totalLines: lines.length,
+                startLine: start,
+                endLine: end,
+                text: slice.length > MAX_INLINE_TEXT_CHARS ? `${slice.slice(0, MAX_INLINE_TEXT_CHARS)}…[truncated — narrow the line range]` : slice,
+            };
+        },
+    });
+    return { download_attachment: downloadAttachment, read_text: readText };
+}
+//# sourceMappingURL=attachment-tools.js.map

package/dist/research/filingramp/attachment-tools.js.map

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

package/dist/research/filingramp/document-search-tool.d.ts

@@ -0,0 +1,4 @@
+import { type Tool } from 'ai';
+import { type FilingRampToolsOptions } from './shared';
+export declare function createDocumentSearchTool(options: FilingRampToolsOptions): Tool;
+//# sourceMappingURL=document-search-tool.d.ts.map

package/dist/research/filingramp/document-search-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-search-tool.d.ts","sourceRoot":"","sources":["../../../src/research/filingramp/document-search-tool.ts"],"names":[],"mappings":"AAEA,OAAO,EAAQ,KAAK,IAAI,EAAE,MAAM,IAAI,CAAA;AAKpC,OAAO,EAAiE,KAAK,sBAAsB,EAAE,MAAM,UAAU,CAAA;AAKrH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CA2K9E"}

package/dist/research/filingramp/document-search-tool.js

@@ -0,0 +1,173 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDocumentSearchTool = createDocumentSearchTool;
+// Document indexes have different filter vocabularies. Search each group independently so
+// an unavailable index does not discard successful results from the other groups.
+const ai_1 = require("ai");
+const zod_1 = require("zod");
+const filingramp_client_1 = require("../filingramp-client");
+const filingramp_contract_1 = require("../filingramp-contract");
+const scope_1 = require("../scope");
+const shared_1 = require("./shared");
+const MAX_DOC_HITS = 100;
+const MAX_HIGHLIGHTS = 3;
+function createDocumentSearchTool(options) {
+    const { client, workspaceDir, scope } = options;
+    const industryData = client.industryData;
+    // Document search matches typeOfInsurance exactly, while the scope holds names or codes
+    // ("Homeowners", "04.0"); the filings summary says which exact labels those stand for in this
+    // account. Resolved once per process.
+    let lineLabels;
+    const scopeLineLabels = (searchType) => {
+        var _a;
+        if (!((_a = scope === null || scope === void 0 ? void 0 : scope.lines) === null || _a === void 0 ? void 0 : _a.length))
+            return Promise.resolve({ lines: [], subLines: [] });
+        lineLabels !== null && lineLabels !== void 0 ? lineLabels : (lineLabels = client
+            .request('/v2/search/filings/summary', {
+            method: 'POST',
+            body: { filters: (0, scope_1.scopeFilingsFilters)(scope), groupBy: ['typeOfInsurance', 'subTypeOfInsurance'], limit: 1000, searchType },
+        })
+            .then((payload) => {
+            var _a;
+            const keys = ((_a = payload === null || payload === void 0 ? void 0 : payload.items) !== null && _a !== void 0 ? _a : []).map((row) => { var _a; return (_a = row.key) !== null && _a !== void 0 ? _a : {}; });
+            const labels = (field) => [...new Set(keys.map((key) => key[field]).filter((value) => typeof value === 'string' && value.length > 0))];
+            return { lines: labels('typeOfInsurance'), subLines: labels('subTypeOfInsurance') };
+        })
+            .catch((error) => {
+            lineLabels = undefined;
+            throw error;
+        }));
+        return lineLabels;
+    };
+    const requestDocuments = async (body) => {
+        try {
+            // ramp-web-api mounts the OpenSearch router at /content-search (POST /global).
+            const payload = await client.request('/v1/content-search/global', {
+                method: 'POST',
+                body,
+                timeoutMs: 120000,
+            });
+            return Array.isArray(payload) ? payload : (0, shared_1.asRecordList)(payload);
+        }
+        catch (error) {
+            if (error instanceof filingramp_client_1.FilingRampHttpError && error.status === 403) {
+                throw new Error(`Document search is not enabled for this account (FilingRamp "searchV2" feature): ${error.message}. Report it in the findings; filing metadata tools still work.`);
+            }
+            if (error instanceof filingramp_client_1.FilingRampHttpError && error.status === 400 && /must be|is not a valid|not allowed|required|invalid/i.test(error.message)) {
+                throw new Error(`Document search rejected the request: ${error.message}. Fix the filter (the tool description lists the fields and operators) and call again.`);
+            }
+            // FilingRamp hides OpenSearch failures (e.g. a missing document index) behind a generic
+            // "An error occurred": rephrasing the query will not help, falling back will.
+            if (error instanceof filingramp_client_1.FilingRampHttpError && (error.status === 400 || error.status >= 500)) {
+                throw new Error(`Document search is unavailable (FilingRamp ${error.status}: ${error.message}). Do not retry it with other wording. ` +
+                    'Find candidate filings with search_filings / summarize_filings, then read their documents with get_filing and download_attachment (extracted text lands in the workspace for grep). Note the gap in the findings.');
+            }
+            throw error;
+        }
+    };
+    return (0, ai_1.tool)({
+        description: 'Full-text or semantic search INSIDE documents (extracted PDF text of forms, rate and supporting documents, objection letters, responses, library forms and rates, circulars). This is how you find which filings contain a clause. Returns hits with highlights; set saveText=true to write each hit\'s full extracted text to data/text/<trackingNumber>/<name>.txt for grep and analysis — never read whole documents into the chat. Filters use OpenSearch\'s vocabulary: states, typeOfInsurance, subTypeOfInsurance, filingTypes, statuses, resourceTypes, productIds, projectIds take exact string arrays ("in"); authors, contacts, reviewers match a substring ("cn"); dateSubmitted, createdAt, updatedAt take one date (eq/gt/gte/lt/lte). The session scope is added for you. Library and circular indexes accept only their own fields (resourceTypes, formNumbers, editionDates, circularNumbers…), so neither the scope nor filing filters apply to them; the result reports what was not applied.',
+        inputSchema: zod_1.z.object({
+            query: zod_1.z.string().min(1).max(2000),
+            searchType: zod_1.z.enum(['KEYWORD', 'SEMANTIC', 'HYBRID']).optional().describe('KEYWORD for exact phrases (default), SEMANTIC for meaning, HYBRID for both'),
+            indexes: zod_1.z
+                .array(zod_1.z.enum(filingramp_contract_1.DOCUMENT_INDEXES))
+                .min(1)
+                .optional()
+                .describe('Which document collections; default ["filings"]. A collection this deployment has no index for fails on its own (requests[].failed) while the others still answer.'),
+            matchMode: zod_1.z.enum(['EXACT', 'ANY_WORD', 'PROXIMITY', 'PREFIX', 'FUZZY', 'BOOLEAN']).optional(),
+            filters: zod_1.z.array(shared_1.filterInputSchema).max(20).optional().describe('See the tool description for fields and operators'),
+            scope: zod_1.z.enum(['ACCOUNT', 'INDUSTRY']).optional(),
+            limit: zod_1.z.number().int().min(1).max(1000).optional(),
+            saveText: zod_1.z.boolean().optional(),
+        }),
+        execute: async (input) => {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y;
+            const searchType = (_a = input.searchType) !== null && _a !== void 0 ? _a : 'KEYWORD';
+            const suffix = searchType === 'KEYWORD' ? 'keyword_index' : 'semantic_index';
+            const matchMode = (_b = input.matchMode) !== null && _b !== void 0 ? _b : (searchType === 'KEYWORD' ? 'EXACT' : 'ANY_WORD');
+            const scopeValue = (0, scope_1.resolveSearchType)(scope, industryData, input.scope);
+            const labels = await scopeLineLabels(scopeValue);
+            const requests = [];
+            const hits = [];
+            const failures = [];
+            let answered = 0;
+            // One request per index group: each group has its own filter vocabulary, and one filter
+            // outside it fails the whole request. A group whose indexes an environment does not have
+            // (circulars on most deployments) fails alone; the other groups still answer.
+            for (const group of (0, filingramp_contract_1.documentIndexGroups)((_c = input.indexes) !== null && _c !== void 0 ? _c : ['filings'])) {
+                const own = (0, filingramp_contract_1.normalizeDocumentFilters)(input.filters, group);
+                const scoped = (0, scope_1.scopeDocumentFilters)(scope, own.filters, group.fields, labels);
+                const entry = { indexes: group.indexes, filters: scoped.filters, unscoped: scoped.unscoped, ignoredFilters: own.ignored };
+                if (scoped.emptyByLines) {
+                    requests.push({ ...entry, skipped: "no filing in scope carries the scope's lines, so no document in these indexes can match" });
+                    continue;
+                }
+                try {
+                    const payload = await requestDocuments({
+                        searchType,
+                        searchText: input.query,
+                        matchMode,
+                        indexNames: group.indexes.map((index) => `${index}_${suffix}`),
+                        scope: scopeValue,
+                        limit: (_d = input.limit) !== null && _d !== void 0 ? _d : 50,
+                        filters: scoped.filters,
+                    });
+                    hits.push(...payload);
+                    requests.push(entry);
+                    answered += 1;
+                }
+                catch (error) {
+                    const failure = error instanceof Error ? error : new Error(String(error));
+                    failures.push(failure);
+                    requests.push({ ...entry, failed: failure.message });
+                }
+            }
+            // Every group failed: the first failure carries the right instruction (fix the filter,
+            // or fall back to downloads). A partial failure is reported per group instead.
+            if (answered === 0 && failures.length > 0)
+                throw failures[0];
+            hits.sort((a, b) => { var _a, _b; return Number((_a = b._score) !== null && _a !== void 0 ? _a : 0) - Number((_b = a._score) !== null && _b !== void 0 ? _b : 0); });
+            const results = [];
+            for (const hit of hits.slice(0, MAX_DOC_HITS)) {
+                const source = ((_e = hit._source) !== null && _e !== void 0 ? _e : {});
+                const highlight = ((_f = hit.highlight) !== null && _f !== void 0 ? _f : {});
+                const fragments = Object.values(highlight).flat().slice(0, MAX_HIGHLIGHTS);
+                // An indexed document is the filing's metadata at the top level plus one sub-object
+                // for the document itself (form, rate, supporting, attachment, disposition …) that
+                // carries attachmentKey / attachmentText; objection letters keep their text top-level.
+                const document = Object.values(source).find((value) => !!value && typeof value === 'object' && !Array.isArray(value) && ('attachmentText' in value || 'attachmentKey' in value));
+                const textValue = (_h = (_g = document === null || document === void 0 ? void 0 : document.attachmentText) !== null && _g !== void 0 ? _g : source.attachmentText) !== null && _h !== void 0 ? _h : source.allMetadataText;
+                const text = typeof textValue === 'string' && textValue.length > 0 ? textValue : undefined;
+                const keyValue = (_k = (_j = document === null || document === void 0 ? void 0 : document.attachmentKey) !== null && _j !== void 0 ? _j : source.attachmentKey) !== null && _k !== void 0 ? _k : source.key;
+                const attachmentKey = typeof keyValue === 'string' ? keyValue : undefined;
+                const trackingNumber = String((_p = (_o = (_m = (_l = source.trackingNumber) !== null && _l !== void 0 ? _l : source.filingTrackingNumber) !== null && _m !== void 0 ? _m : source.resourceId) !== null && _o !== void 0 ? _o : hit._id) !== null && _p !== void 0 ? _p : 'unknown');
+                const name = String((_w = (_v = (_u = (_t = (_s = (_r = (_q = (attachmentKey ? decodeURIComponent(attachmentKey.slice(attachmentKey.lastIndexOf('/') + 1)) : undefined)) !== null && _q !== void 0 ? _q : document === null || document === void 0 ? void 0 : document.formNumber) !== null && _r !== void 0 ? _r : source.name) !== null && _s !== void 0 ? _s : source.attachmentName) !== null && _t !== void 0 ? _t : source.formNumber) !== null && _u !== void 0 ? _u : source.title) !== null && _v !== void 0 ? _v : hit._id) !== null && _w !== void 0 ? _w : 'document');
+                let textPath;
+                if (input.saveText && text) {
+                    textPath = `data/text/${(0, shared_1.safeName)(trackingNumber)}/${(0, shared_1.safeName)(name)}.txt`;
+                    await (0, shared_1.writeWorkspaceFile)(workspaceDir, textPath, text);
+                }
+                results.push({
+                    id: hit._id,
+                    index: hit._index,
+                    score: hit._score,
+                    resourceType: source.resourceType,
+                    filingId: source.filingId,
+                    trackingNumber,
+                    state: source.state,
+                    filingType: source.filingType,
+                    dateSubmitted: source.dateSubmitted,
+                    name,
+                    formNumber: (_x = document === null || document === void 0 ? void 0 : document.formNumber) !== null && _x !== void 0 ? _x : source.formNumber,
+                    attachmentKey,
+                    textChars: (_y = text === null || text === void 0 ? void 0 : text.length) !== null && _y !== void 0 ? _y : 0,
+                    textPath,
+                    highlights: fragments.map((fragment) => fragment.replace(/<\/?em>/g, '**').slice(0, 300)),
+                });
+            }
+            return { hits: results, total: hits.length, truncated: hits.length > MAX_DOC_HITS, requests };
+        },
+    });
+}
+//# sourceMappingURL=document-search-tool.js.map

package/dist/research/filingramp/document-search-tool.js.map

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

package/dist/research/filingramp/filing-detail-tool.d.ts

@@ -0,0 +1,4 @@
+import { type Tool } from 'ai';
+import { type FilingRampToolsOptions } from './shared';
+export declare function createFilingDetailTool(options: FilingRampToolsOptions): Tool;
+//# sourceMappingURL=filing-detail-tool.d.ts.map

package/dist/research/filingramp/filing-detail-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filing-detail-tool.d.ts","sourceRoot":"","sources":["../../../src/research/filingramp/filing-detail-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,IAAI,EAAE,MAAM,IAAI,CAAA;AAGpC,OAAO,EAAoC,KAAK,sBAAsB,EAAE,MAAM,UAAU,CAAA;AAuCxF,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAmE5E"}