@multiplayer-app/agent 0.1.8 → 0.1.10

package/dist/research/filingramp-tools.js

@@ -1,573 +1,22 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createFilingRampTools = createFilingRampTools;
-// FilingRamp tools for the research profile. Design rule: token cost first. Every tool
-// returns a lean projection and writes anything bulky (document text, downloaded files,
-// full result pages) to the workspace, where grep / DuckDB / Python work on it for free.
-// The session scope (scope.ts) is applied server-side here, before the model's own filters.
-const child_process_1 = require("child_process");
-const fs_1 = require("fs");
-const path_1 = __importDefault(require("path"));
-const util_1 = require("util");
-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 execFileAsync = (0, util_1.promisify)(child_process_1.execFile);
-const DEFAULT_FILING_FIELDS = [
-    '_id',
-    'trackingNumber',
-    'state',
-    'statusId',
-    'status',
-    'filingType',
-    'typeOfInsurance',
-    'subTypeOfInsurance',
-    'dateSubmitted',
-    'product',
-    'project',
-];
-/** Filing fields the v2 search accepts (FilingRamp's Filing shape); unknown names fail the whole call. */
-const FILING_FIELDS = [
-    '_id', 'accountId', 'trackingNumber', 'customTrackingNumber', 'resourceId', 'state', 'statusId', 'status', 'filingType',
-    'businessType', 'typeOfInsurance', 'subTypeOfInsurance', 'dateSubmitted', 'serffDateLastModified', 'source', 'projectId',
-    'productId', 'product', 'project', 'companies', 'authors', 'reviewers', 'objections', 'dispositions', 'generalInformation',
-    'stateSpecifics', 'hasPreviousVersion', 'associatedFilings', 'createdAt', 'updatedAt',
-];
-const MAX_PAGE = 200;
-const MAX_DOC_HITS = 100;
-const MAX_HIGHLIGHTS = 3;
-const MAX_INLINE_TEXT_CHARS = 4000;
-// What the model may pass. The contract (filingramp-contract.ts) wraps single values, picks the
-// operator a field accepts and rejects unknown fields before the request leaves the VM.
-const filterInputSchema = zod_1.z.object({
-    field: zod_1.z.string().min(1).max(100),
-    comparisonOperator: zod_1.z
-        .enum(['cn', 'in', 'eq', 'gt', 'gte', 'lt', 'lte', 'ex'])
-        .optional()
-        .describe('Omit to let the field decide: cn (contains) for names, lines and authors; in (exact) for codes; eq/gt/gte/lt/lte for dates; ex for hasObjection'),
-    value: zod_1.z
-        .union([zod_1.z.string(), zod_1.z.number(), zod_1.z.boolean(), zod_1.z.array(zod_1.z.union([zod_1.z.string(), zod_1.z.number()]))])
-        .describe('A string array for list fields (a bare string is wrapped), one date string for date fields, a boolean for hasObjection'),
-});
-const filingsFilterSchema = filterInputSchema.extend({
-    field: zod_1.z.string().min(1).max(100).describe('Filings filter (plural): states, typeOfInsurances, subTypeOfInsurances, filingTypes, statusIds, statuses, companies, authors, reviewers, productNames, projectNames, trackingNumbers, form.formNumbers, rate.ruleNumbers, dateSubmitted, createdAt, updatedAt, hasObjection. Singular record names are converted. Not a result field or groupBy.'),
-});
-const searchTypeSchema = zod_1.z.enum(['ACCOUNT', 'INDUSTRY']).optional().describe('Defaults to the session scope. INDUSTRY needs the industry-data entitlement.');
-/** Joi-style message: `"body.fields[7]" must be one of [a, b, c, …]` → the accepted values. */
-function allowedValuesFromError(error) {
-    const message = error instanceof Error ? error.message : String(error);
-    const match = message.match(/must be one of \[([^\]]*)/);
-    if (!match)
-        return undefined;
-    return new Set(match[1].split(',').map((item) => item.trim()).filter((item) => item && item !== '…'));
-}
-function safeName(value) {
-    return value.replace(/[^A-Za-z0-9._-]+/g, '_').replace(/^_+|_+$/g, '').slice(0, 120) || 'item';
-}
-function pick(record, fields) {
-    const out = {};
-    for (const field of fields) {
-        if (record[field] !== undefined)
-            out[field] = record[field];
-    }
-    return out;
-}
-function asRecordList(payload) {
-    if (Array.isArray(payload))
-        return payload;
-    if (payload && typeof payload === 'object' && Array.isArray(payload.items)) {
-        return payload.items;
-    }
-    return [];
-}
-async function writeWorkspaceFile(workspaceDir, relativePath, content) {
-    const target = path_1.default.resolve(workspaceDir, relativePath);
-    if (!target.startsWith(path_1.default.resolve(workspaceDir) + path_1.default.sep))
-        throw new Error(`path escapes the workspace: ${relativePath}`);
-    await fs_1.promises.mkdir(path_1.default.dirname(target), { recursive: true });
-    const buffer = typeof content === 'string' ? Buffer.from(content, 'utf8') : content;
-    await fs_1.promises.writeFile(target, buffer);
-    return { path: relativePath, bytes: buffer.byteLength };
-}
-/** 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 fs_1.promises.stat(output);
-            return stat.size;
-        }
-        catch (_b) {
-            /* try the next extractor */
-        }
-    }
-    return 0;
-}
-/** Walks a filing record and lists every attachment with where it sits in the filing. */
-function collectAttachments(filing) {
-    var _b, _c;
-    const out = [];
-    const sections = [
-        ['forms', 'formNumber'],
-        ['rates', 'name'],
-        ['supportings', 'name'],
-        ['dispositions', 'status'],
-    ];
-    for (const [section, labelField] of sections) {
-        const items = filing[section];
-        if (!Array.isArray(items))
-            continue;
-        for (const item of items) {
-            const attachments = Array.isArray(item.attachments) ? item.attachments : [];
-            for (const attachment of attachments) {
-                out.push({
-                    section,
-                    item: (_c = (_b = item[labelField]) !== null && _b !== void 0 ? _b : item.name) !== null && _c !== void 0 ? _c : item.title,
-                    itemId: item._id,
-                    action: item.action,
-                    key: attachment.key,
-                    name: attachment.name,
-                    type: attachment.type,
-                    size: attachment.size,
-                });
-            }
-        }
-    }
-    const objections = Array.isArray(filing.objections) ? filing.objections : [];
-    for (const letter of objections) {
-        for (const attachment of Array.isArray(letter.attachments) ? letter.attachments : []) {
-            out.push({ section: 'objections', item: letter.letterDate, key: attachment.key, name: attachment.name, size: attachment.size });
-        }
-    }
-    return out;
-}
+const attachment_tools_1 = require("./filingramp/attachment-tools");
+const document_search_tool_1 = require("./filingramp/document-search-tool");
+const filing_detail_tool_1 = require("./filingramp/filing-detail-tool");
+const filing_search_tools_1 = require("./filingramp/filing-search-tools");
 function createFilingRampTools(options) {
-    const { client, workspaceDir, scope } = options;
-    const industryData = client.industryData;
-    const searchFilings = (0, ai_1.tool)({
-        description: 'List filings matching filters (account filings by default). Lean rows: pass `fields` for exactly what you need. Page with lastItemId (sortKey "_id") until a page is shorter than limit. For counts or breakdowns use count_filings / summarize_filings instead — never page to count.',
-        inputSchema: zod_1.z.object({
-            text: zod_1.z.string().max(500).optional().describe('Free-text match over filing metadata'),
-            filters: zod_1.z.array(filingsFilterSchema).max(30).optional(),
-            fields: zod_1.z
-                .array(zod_1.z.string().max(100))
-                .max(40)
-                .optional()
-                .describe(`Filing fields to return, from: ${FILING_FIELDS.join(', ')}. Default ${DEFAULT_FILING_FIELDS.join(', ')}`),
-            limit: zod_1.z.number().int().min(1).max(MAX_PAGE).optional(),
-            lastItemId: zod_1.z.string().optional(),
-            lastItemSortValue: zod_1.z.union([zod_1.z.string(), zod_1.z.number()]).optional(),
-            sortKey: zod_1.z.string().max(60).optional(),
-            sortDirection: zod_1.z.union([zod_1.z.literal(1), zod_1.z.literal(-1)]).optional(),
-            searchType: searchTypeSchema,
-            saveAs: zod_1.z.string().max(200).optional().describe('Also write the full page as JSON to this workspace path (e.g. data/filings/page-1.json)'),
-        }),
-        execute: async (input) => {
-            var _b, _c, _d, _e;
-            const searchType = (0, scope_1.resolveSearchType)(scope, industryData, input.searchType);
-            const filters = (0, scope_1.scopeFilingsFilters)(scope, (0, filingramp_contract_1.normalizeFilingsFilters)(input.filters, 'search'));
-            const fields = ((_b = input.fields) === null || _b === void 0 ? void 0 : _b.length) ? [...new Set(['_id', ...input.fields])] : DEFAULT_FILING_FIELDS;
-            const limit = (_c = input.limit) !== null && _c !== void 0 ? _c : 100;
-            let items;
-            if (searchType === 'INDUSTRY') {
-                // v2 has no industry search; v1 pages by offset. lastItemSortValue carries the offset here.
-                const offset = typeof input.lastItemSortValue === 'number' ? input.lastItemSortValue : 0;
-                const payload = await client.request('/v1/search/filings', {
-                    method: 'POST',
-                    body: { text: input.text, filters, limit, offset, searchType, sortKey: (_d = input.sortKey) !== null && _d !== void 0 ? _d : '_id', sortDirection: (_e = input.sortDirection) !== null && _e !== void 0 ? _e : 1 },
-                });
-                items = asRecordList(payload);
-            }
-            else {
-                const requestPage = (fieldList) => {
-                    var _b, _c;
-                    return client.request('/v2/search/filings', {
-                        method: 'POST',
-                        body: {
-                            text: input.text,
-                            filters,
-                            fields: fieldList,
-                            limit,
-                            lastItemId: input.lastItemId,
-                            lastItemSortValue: input.lastItemSortValue,
-                            sortKey: (_b = input.sortKey) !== null && _b !== void 0 ? _b : '_id',
-                            sortDirection: (_c = input.sortDirection) !== null && _c !== void 0 ? _c : 1,
-                            searchType,
-                        },
-                    });
-                };
-                let payload;
-                try {
-                    payload = await requestPage(fields);
-                }
-                catch (error) {
-                    // `"body.fields[7]" must be one of [...]`: drop what the API rejected and retry once.
-                    const allowed = allowedValuesFromError(error);
-                    if (!allowed)
-                        throw error;
-                    const kept = fields.filter((field) => allowed.has(field));
-                    if (kept.length === fields.length)
-                        throw error;
-                    payload = await requestPage(kept.length ? kept : DEFAULT_FILING_FIELDS);
-                }
-                items = asRecordList(payload);
-            }
-            const saved = input.saveAs ? await writeWorkspaceFile(workspaceDir, input.saveAs, JSON.stringify(items, null, 2)) : undefined;
-            const rows = items.map((item) => pick(item, fields));
-            const last = items[items.length - 1];
-            return {
-                count: rows.length,
-                items: rows,
-                nextLastItemId: rows.length === limit ? last === null || last === void 0 ? void 0 : last._id : undefined,
-                nextOffset: searchType === 'INDUSTRY' && rows.length === limit ? ((typeof input.lastItemSortValue === 'number' ? input.lastItemSortValue : 0) + limit) : undefined,
-                appliedFilters: filters,
-                saved,
-            };
-        },
-    });
-    const countFilings = (0, ai_1.tool)({
-        description: 'One total count of filings matching filters. For counts per state, line or status use summarize_filings.',
-        inputSchema: zod_1.z.object({
-            text: zod_1.z.string().max(500).optional(),
-            filters: zod_1.z.array(filingsFilterSchema).max(30).optional(),
-            searchType: searchTypeSchema,
-        }),
-        execute: async (input) => {
-            var _b;
-            const searchType = (0, scope_1.resolveSearchType)(scope, industryData, input.searchType);
-            const filters = (0, scope_1.scopeFilingsFilters)(scope, (0, filingramp_contract_1.normalizeFilingsFilters)(input.filters, 'count'));
-            const payload = await client.request('/v2/search/filings/count', {
-                method: 'POST',
-                body: { text: input.text, filters, searchType },
-            });
-            return { count: (_b = payload === null || payload === void 0 ? void 0 : payload.count) !== null && _b !== void 0 ? _b : 0, appliedFilters: filters };
-        },
-    });
-    const summarizeFilings = (0, ai_1.tool)({
-        description: 'Counts and totals per group (state, filingType, statusId, typeOfInsurance, subTypeOfInsurance, company, submittedMonth, dispositionMonth, source, businessType). Use this to size a population before reading documents, and for rankings or trends. Never page search_filings to count.',
-        inputSchema: zod_1.z.object({
-            text: zod_1.z.string().max(500).optional(),
-            filters: zod_1.z.array(filingsFilterSchema).max(30).optional(),
-            groupBy: zod_1.z.array(zod_1.z.string().max(40)).max(4).optional().describe('Singular names: state, typeOfInsurance, subTypeOfInsurance, filingType, statusId, company, businessType, source, submittedMonth, dispositionMonth, createdMonth. Omit for one total row.'),
-            limit: zod_1.z.number().int().min(1).max(50000).optional(),
-            sortBy: zod_1.z.enum(['key', 'filings']).optional(),
-            searchType: searchTypeSchema,
-            saveAs: zod_1.z.string().max(200).optional().describe('Write the full summary rows as JSON to this workspace path'),
-        }),
-        execute: async (input) => {
-            var _b, _c;
-            const searchType = (0, scope_1.resolveSearchType)(scope, industryData, input.searchType);
-            const filters = (0, scope_1.scopeFilingsFilters)(scope, (0, filingramp_contract_1.normalizeFilingsFilters)(input.filters, 'summary'));
-            const groupBy = (0, filingramp_contract_1.normalizeSummaryGroupBy)(input.groupBy);
-            const payload = await client.request('/v2/search/filings/summary', {
-                method: 'POST',
-                body: { text: input.text, filters, groupBy, limit: input.limit, sortBy: input.sortBy, searchType },
-            });
-            const items = (_b = payload === null || payload === void 0 ? void 0 : payload.items) !== null && _b !== void 0 ? _b : [];
-            const saved = input.saveAs ? await writeWorkspaceFile(workspaceDir, input.saveAs, JSON.stringify(items, null, 2)) : undefined;
-            // Rows carry per-status day sums the model rarely needs; keep the counts.
-            const rows = items.slice(0, 200).map((row) => ({
-                key: row.key,
-                filings: row.filings,
-                filingsWithObjections: row.filingsWithObjections,
-                filingsWithForms: row.filingsWithForms,
-                objectionLetters: row.objectionLetters,
-                forms: row.forms,
-                rates: row.rates,
-                statusIds: row.statusIds && typeof row.statusIds === 'object'
-                    ? Object.fromEntries(Object.entries(row.statusIds).map(([k, v]) => { var _b; return [k, (_b = v === null || v === void 0 ? void 0 : v.filings) !== null && _b !== void 0 ? _b : 0]; }))
-                    : undefined,
-            }));
-            return { rows, totalRows: items.length, truncated: (_c = payload === null || payload === void 0 ? void 0 : payload.truncated) !== null && _c !== void 0 ? _c : false, appliedFilters: filters, saved };
-        },
-    });
-    const getFiling = (0, ai_1.tool)({
-        description: 'One filing in full: general information, forms, rates, supporting documents, objection letters, dispositions and every attachment (with the `key` download_attachment needs). Large: ask for `include` sections only when you need them.',
-        inputSchema: zod_1.z.object({
-            id: zod_1.z.string().min(1).max(100).describe('Filing _id or SERFF tracking number'),
-            include: zod_1.z.array(zod_1.z.enum(['general', 'forms', 'rates', 'supportings', 'objections', 'dispositions', 'attachments'])).optional(),
-            saveAs: zod_1.z.string().max(200).optional().describe('Write the full filing JSON to this workspace path'),
-        }),
-        execute: async (input) => {
-            var _b;
-            const filing = await client.request(`/v1/filings/${encodeURIComponent(input.id)}`);
-            const saved = input.saveAs ? await writeWorkspaceFile(workspaceDir, input.saveAs, JSON.stringify(filing, null, 2)) : undefined;
-            const include = new Set((_b = input.include) !== null && _b !== void 0 ? _b : ['general', 'attachments']);
-            const out = {
-                _id: filing._id,
-                trackingNumber: filing.trackingNumber,
-                state: filing.state,
-                statusId: filing.statusId,
-                status: filing.status,
-                filingType: filing.filingType,
-                typeOfInsurance: filing.typeOfInsurance,
-                subTypeOfInsurance: filing.subTypeOfInsurance,
-                dateSubmitted: filing.dateSubmitted,
-                companyNames: Array.isArray(filing.companies) ? filing.companies.map((c) => c.name) : undefined,
-            };
-            if (include.has('general'))
-                out.generalInformation = filing.generalInformation;
-            for (const section of ['forms', 'rates', 'supportings', 'objections', 'dispositions']) {
-                if (!include.has(section))
-                    continue;
-                const items = Array.isArray(filing[section]) ? filing[section] : [];
-                out[section] = items.map((item) => {
-                    const { attachments: _a, ...rest } = item;
-                    return rest;
-                });
-            }
-            if (include.has('attachments'))
-                out.attachments = collectAttachments(filing);
-            return { filing: out, saved };
-        },
-    });
-    // 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 _b;
-        if (!((_b = scope === null || scope === void 0 ? void 0 : scope.lines) === null || _b === void 0 ? void 0 : _b.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 _b;
-            const keys = ((_b = payload === null || payload === void 0 ? void 0 : payload.items) !== null && _b !== void 0 ? _b : []).map((row) => { var _b; return (_b = row.key) !== null && _b !== void 0 ? _b : {}; });
-            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 : 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;
-        }
-    };
-    const searchDocuments = (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(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 _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t;
-            const searchType = (_b = input.searchType) !== null && _b !== void 0 ? _b : 'KEYWORD';
-            const suffix = searchType === 'KEYWORD' ? 'keyword_index' : 'semantic_index';
-            const matchMode = (_c = input.matchMode) !== null && _c !== void 0 ? _c : (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)((_d = input.indexes) !== null && _d !== void 0 ? _d : ['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: (_e = input.limit) !== null && _e !== void 0 ? _e : 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 _b, _c; return Number((_b = b._score) !== null && _b !== void 0 ? _b : 0) - Number((_c = a._score) !== null && _c !== void 0 ? _c : 0); });
-            const results = [];
-            for (const hit of hits.slice(0, MAX_DOC_HITS)) {
-                const source = ((_f = hit._source) !== null && _f !== void 0 ? _f : {});
-                const highlight = ((_g = hit.highlight) !== null && _g !== void 0 ? _g : {});
-                const fragments = Object.values(highlight).flat().slice(0, MAX_HIGHLIGHTS);
-                const text = typeof source.attachmentText === 'string' ? source.attachmentText : undefined;
-                const trackingNumber = String((_l = (_k = (_j = (_h = source.trackingNumber) !== null && _h !== void 0 ? _h : source.filingTrackingNumber) !== null && _j !== void 0 ? _j : source.resourceId) !== null && _k !== void 0 ? _k : hit._id) !== null && _l !== void 0 ? _l : 'unknown');
-                const name = String((_r = (_q = (_p = (_o = (_m = source.name) !== null && _m !== void 0 ? _m : source.attachmentName) !== null && _o !== void 0 ? _o : source.formNumber) !== null && _p !== void 0 ? _p : source.title) !== null && _q !== void 0 ? _q : hit._id) !== null && _r !== void 0 ? _r : 'document');
-                let textPath;
-                if (input.saveText && text) {
-                    textPath = `data/text/${safeName(trackingNumber)}/${safeName(name)}.txt`;
-                    await writeWorkspaceFile(workspaceDir, textPath, text);
-                }
-                results.push({
-                    id: hit._id,
-                    index: hit._index,
-                    score: hit._score,
-                    resourceType: source.resourceType,
-                    trackingNumber,
-                    state: source.state,
-                    filingType: source.filingType,
-                    dateSubmitted: source.dateSubmitted,
-                    name,
-                    formNumber: source.formNumber,
-                    attachmentKey: (_s = source.key) !== null && _s !== void 0 ? _s : source.attachmentKey,
-                    textChars: (_t = text === null || text === void 0 ? void 0 : text.length) !== null && _t !== void 0 ? _t : 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 };
-        },
-    });
-    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 _b, _c, _d;
-            const bytes = await client.downloadAttachment(input.key);
-            const folder = safeName((_b = input.trackingNumber) !== null && _b !== void 0 ? _b : 'misc');
-            const fileName = safeName((_d = (_c = input.name) !== null && _c !== void 0 ? _c : input.key.split('/').pop()) !== null && _d !== void 0 ? _d : 'attachment');
-            const filePath = `data/attachments/${folder}/${fileName}`;
-            const written = await 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 = path_1.default.resolve(workspaceDir, textPath);
-                await fs_1.promises.mkdir(path_1.default.dirname(absoluteText), { recursive: true });
-                textChars = await extractPdfText(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 searchObjections = (0, ai_1.tool)({
-        description: 'Objection letters on account filings, open or closed, with their respond-by dates. Account data only.',
-        inputSchema: zod_1.z.object({
-            type: zod_1.z.enum(['OPEN', 'CLOSED']),
-            filters: zod_1.z.array(filingsFilterSchema).max(20).optional(),
-            limit: zod_1.z.number().int().min(1).max(MAX_PAGE).optional(),
-            offset: zod_1.z.number().int().min(0).optional(),
-            sortKey: zod_1.z.enum(['filingType', 'objection.letterDate', 'objection.respondByDate']).optional(),
-            sortDirection: zod_1.z.union([zod_1.z.literal(1), zod_1.z.literal(-1)]).optional(),
-        }),
-        execute: async (input) => {
-            var _b, _c, _d, _e, _f;
-            const filters = (0, scope_1.scopeFilingsFilters)(scope, (0, filingramp_contract_1.normalizeFilingsFilters)(input.filters, 'objections'));
-            const payload = await client.request('/v2/search/filings/objections', {
-                method: 'POST',
-                query: { type: input.type },
-                body: { filters, limit: (_b = input.limit) !== null && _b !== void 0 ? _b : 50, offset: (_c = input.offset) !== null && _c !== void 0 ? _c : 0, sortKey: input.sortKey, sortDirection: (_d = input.sortDirection) !== null && _d !== void 0 ? _d : -1 },
-            });
-            return { count: (_e = payload === null || payload === void 0 ? void 0 : payload.count) !== null && _e !== void 0 ? _e : 0, items: (_f = payload === null || payload === void 0 ? void 0 : payload.items) !== null && _f !== void 0 ? _f : [], appliedFilters: filters };
-        },
-    });
-    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 _b, _c;
-            const target = path_1.default.resolve(workspaceDir, input.path);
-            if (!target.startsWith(path_1.default.resolve(workspaceDir) + path_1.default.sep))
-                throw new Error('path escapes the workspace');
-            const content = await fs_1.promises.readFile(target, 'utf8');
-            const lines = content.split('\n');
-            const start = Math.max(1, (_b = input.startLine) !== null && _b !== void 0 ? _b : 1);
-            const end = Math.min(lines.length, (_c = input.endLine) !== null && _c !== void 0 ? _c : 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,
-            };
-        },
-    });
+    const filings = (0, filing_search_tools_1.createFilingSearchTools)(options);
+    const attachments = (0, attachment_tools_1.createAttachmentTools)(options);
     return {
-        search_filings: searchFilings,
-        count_filings: countFilings,
-        summarize_filings: summarizeFilings,
-        get_filing: getFiling,
-        search_documents: searchDocuments,
-        download_attachment: downloadAttachment,
-        search_objections: searchObjections,
-        read_text: readText,
+        search_filings: filings.search_filings,
+        count_filings: filings.count_filings,
+        summarize_filings: filings.summarize_filings,
+        get_filing: (0, filing_detail_tool_1.createFilingDetailTool)(options),
+        search_documents: (0, document_search_tool_1.createDocumentSearchTool)(options),
+        download_attachment: attachments.download_attachment,
+        search_objections: filings.search_objections,
+        read_text: attachments.read_text,
     };
 }
 //# sourceMappingURL=filingramp-tools.js.map