@multiplayer-app/agent 0.1.5 → 0.1.7

package/dist/research/filingramp-tools.test.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 });
+const strict_1 = __importDefault(require("node:assert/strict"));
+const node_test_1 = require("node:test");
+const filingramp_client_1 = require("./filingramp-client");
+const filingramp_tools_1 = require("./filingramp-tools");
+function tools() {
+    return (0, filingramp_tools_1.createFilingRampTools)({
+        client: new filingramp_client_1.FilingRampClient({ baseUrl: 'https://example.test', authToken: 'test', industryData: false }),
+        workspaceDir: '/unused',
+        scope: { states: ['TX', 'AZ'], lines: ['04.0'] },
+    });
+}
+(0, node_test_1.describe)('research filing requests', () => {
+    for (const name of ['count_filings', 'summarize_filings']) {
+        (0, node_test_1.it)(`${name} sends plural filters and keeps singular summary groups`, async (t) => {
+            let body;
+            t.mock.method(globalThis, 'fetch', async (_url, init) => {
+                body = JSON.parse(String(init.body));
+                return Response.json(name === 'count_filings' ? { count: 12 } : { items: [{ key: { typeOfInsurance: '04.0' }, filings: 12 }] });
+            });
+            const result = await tools()[name].execute({
+                filters: [
+                    { field: 'state', comparisonOperator: 'in', value: ['TX', 'AZ'] },
+                    { field: 'typeOfInsurance', comparisonOperator: 'cn', value: ['04.0'] },
+                ],
+                ...(name === 'summarize_filings' ? { groupBy: ['typeOfInsurance'] } : {}),
+            }, { toolCallId: 'test', messages: [] });
+            strict_1.default.deepEqual(body === null || body === void 0 ? void 0 : body.filters, [
+                { field: 'states', comparisonOperator: 'in', value: ['TX', 'AZ'] },
+                { field: 'typeOfInsurances', comparisonOperator: 'cn', value: ['04.0'] },
+            ]);
+            if (name === 'summarize_filings')
+                strict_1.default.deepEqual(body === null || body === void 0 ? void 0 : body.groupBy, ['typeOfInsurance']);
+            strict_1.default.ok(result);
+        });
+        (0, node_test_1.it)(`${name} propagates validation failure instead of returning zero`, async (t) => {
+            t.mock.method(globalThis, 'fetch', async () => Response.json({ message: 'Invalid filter field' }, { status: 400 }));
+            await strict_1.default.rejects(async () => tools()[name].execute({}, { toolCallId: 'test', messages: [] }), (error) => error instanceof filingramp_client_1.FilingRampHttpError && error.status === 400);
+        });
+    }
+    (0, node_test_1.it)('search_documents sends one scoped request per index group with the exact line labels', async (t) => {
+        const calls = [];
+        t.mock.method(globalThis, 'fetch', async (url, init) => {
+            const body = JSON.parse(String(init.body));
+            calls.push({ url: String(url), body });
+            if (String(url).endsWith('/v2/search/filings/summary')) {
+                return Response.json({ items: [{ key: { typeOfInsurance: '04.0 Homeowners', subTypeOfInsurance: '04.0000 Homeowners Sub-type' }, filings: 3 }] });
+            }
+            return Response.json([{ _id: `${body.indexNames[0]}-hit`, _index: body.indexNames[0], _score: body.indexNames[0].startsWith('library') ? 2 : 1, _source: { trackingNumber: 'TRK-1', name: 'HO 3' } }]);
+        });
+        const result = (await tools().search_documents.execute({ query: 'water shut-off valve', indexes: ['filings', 'library_forms'], filters: [{ field: 'filingType', value: 'Form' }] }, { toolCallId: 'test', messages: [] }));
+        const searches = calls.filter((call) => call.url.endsWith('/v1/content-search/global'));
+        strict_1.default.equal(searches.length, 2);
+        strict_1.default.deepEqual(searches[0].body.indexNames, ['filings_keyword_index']);
+        strict_1.default.deepEqual(searches[0].body.filters, [
+            { field: 'states', comparisonOperator: 'in', value: ['TX', 'AZ'] },
+            { field: 'typeOfInsurance', comparisonOperator: 'in', value: ['04.0 Homeowners'] },
+            { field: 'filingTypes', comparisonOperator: 'in', value: ['Form'] },
+        ]);
+        strict_1.default.deepEqual(searches[1].body.indexNames, ['library_forms_keyword_index']);
+        strict_1.default.deepEqual(searches[1].body.filters, []);
+        strict_1.default.deepEqual(result.requests[1].unscoped, ['states', 'lines']);
+        strict_1.default.deepEqual(result.requests[1].ignoredFilters, ['filingType']);
+        strict_1.default.deepEqual(result.hits.map((hit) => hit.id), ['library_forms_keyword_index-hit', 'filings_keyword_index-hit']);
+    });
+    (0, node_test_1.it)('search_documents skips filing indexes when no filing in scope carries the scope lines', async (t) => {
+        var _a;
+        const urls = [];
+        t.mock.method(globalThis, 'fetch', async (url) => {
+            urls.push(String(url));
+            return Response.json({ items: [] });
+        });
+        const result = (await tools().search_documents.execute({ query: 'leak detection' }, { toolCallId: 'test', messages: [] }));
+        strict_1.default.deepEqual(result.hits, []);
+        strict_1.default.match((_a = result.requests[0].skipped) !== null && _a !== void 0 ? _a : '', /no filing in scope/);
+        strict_1.default.ok(!urls.some((url) => url.endsWith('/v1/content-search/global')));
+    });
+    (0, node_test_1.it)('search_documents reports a validation failure as a fix, not an outage', async (t) => {
+        t.mock.method(globalThis, 'fetch', async (url) => {
+            if (String(url).endsWith('/v2/search/filings/summary'))
+                return Response.json({ items: [{ key: { typeOfInsurance: '04.0 Homeowners' }, filings: 1 }] });
+            return Response.json({ message: '"body.filters[0].field" must be [resourceTypes]' }, { status: 400 });
+        });
+        await strict_1.default.rejects(async () => tools().search_documents.execute({ query: 'x' }, { toolCallId: 'test', messages: [] }), /Document search rejected the request: .*must be \[resourceTypes\].*Fix the filter/s);
+    });
+    (0, node_test_1.it)('search_documents turns an opaque FilingRamp failure into a fallback instruction', async (t) => {
+        t.mock.method(globalThis, 'fetch', async (url) => {
+            if (String(url).endsWith('/v2/search/filings/summary'))
+                return Response.json({ items: [{ key: { typeOfInsurance: '04.0 Homeowners' }, filings: 1 }] });
+            return Response.json({ message: 'An error occurred. We are looking into it.' }, { status: 400 });
+        });
+        await strict_1.default.rejects(async () => tools().search_documents.execute({ query: 'water shut-off valve' }, { toolCallId: 'test', messages: [] }), /Document search is unavailable \(FilingRamp 400: .*Do not retry.*get_filing and download_attachment/s);
+    });
+});
+//# sourceMappingURL=filingramp-tools.test.js.map

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

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

package/dist/research/prompt.d.ts

@@ -5,9 +5,13 @@ export declare const RESEARCH_OUTPUT_FILES: {
     readonly evidence: "research/evidence.json";
     readonly notes: "research/notes.md";
 };
+/** Directories the research profile guarantees exist in the workspace before the first turn. */
+export declare const RESEARCH_WORKSPACE_DIRS: readonly ["research", "data", "data/text"];
 export declare function buildResearchSystemPrompt(options: {
     scope?: ResearchScope;
     industryData: boolean;
     tokenBudget?: number;
+    /** True when the workspace (files or conversation) was restored from a previous run of this session. */
+    restored?: boolean;
 }): string;
 //# sourceMappingURL=prompt.d.ts.map

package/dist/research/prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/research/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAG9C,eAAO,MAAM,qBAAqB;;;;;CAKxB,CAAA;AAEV,wBAAgB,yBAAyB,CAAC,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,aAAa,CAAC;IAAC,YAAY,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CA8BjI"}
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/research/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAG9C,eAAO,MAAM,qBAAqB;;;;;CAKxB,CAAA;AAEV,gGAAgG;AAChG,eAAO,MAAM,uBAAuB,4CAA6C,CAAA;AAEjF,wBAAgB,yBAAyB,CAAC,OAAO,EAAE;IACjD,KAAK,CAAC,EAAE,aAAa,CAAA;IACrB,YAAY,EAAE,OAAO,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,wGAAwG;IACxG,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,GAAG,MAAM,CAuCT"}

package/dist/research/prompt.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RESEARCH_OUTPUT_FILES = void 0;
+exports.RESEARCH_WORKSPACE_DIRS = exports.RESEARCH_OUTPUT_FILES = void 0;
 exports.buildResearchSystemPrompt = buildResearchSystemPrompt;
 const scope_1 = require("./scope");
 exports.RESEARCH_OUTPUT_FILES = {
@@ -9,19 +9,26 @@ exports.RESEARCH_OUTPUT_FILES = {
     evidence: 'research/evidence.json',
     notes: 'research/notes.md',
 };
+/** Directories the research profile guarantees exist in the workspace before the first turn. */
+exports.RESEARCH_WORKSPACE_DIRS = ['research', 'data', 'data/text'];
 function buildResearchSystemPrompt(options) {
     const budget = options.tokenBudget ? `Token budget for this session: ${options.tokenBudget.toLocaleString()} tokens. ` : '';
+    const workspaceState = options.restored
+        ? `This session was restored from a previous run: read ${exports.RESEARCH_OUTPUT_FILES.notes} first and continue from what it says is next.`
+        : 'This is a fresh session: the workspace holds only the empty research/ and data/ folders, so start with the plan rather than looking for earlier work.';
     return `You are a deep research agent for insurance regulatory filings, running inside an isolated session workspace with a persistent disk. You answer one research question at a time by reading the actual filing documents, and you leave a verifiable trail.
 
+Workspace layout: research/ holds everything you publish (findings, results, evidence, notes, codebook); data/ holds downloaded documents and intermediate tables, with extracted text under data/text/. ${workspaceState}
+
 Scope of this session (enforced on every FilingRamp call; you may narrow, never widen):
 ${(0, scope_1.describeScope)(options.scope)}
 ${options.industryData ? 'Industry (public) filings are available with searchType/scope INDUSTRY.' : 'Only this account\'s own filings are available.'}
 
 Method — plan, size, confirm, narrow, download, analyze, report:
 1. Plan. Restate the question as concrete, checkable criteria (which document types, which clauses or values, which time range). Write the plan to ${exports.RESEARCH_OUTPUT_FILES.notes} and tell the user in two or three sentences.
-2. Size. Use count_filings and summarize_filings (grouped by state, filingType, typeOfInsurance, submittedMonth) to see how big the population is before reading anything.
-3. Confirm. If the population is large (more than ~300 filings or ~1,000 documents) or the question is ambiguous, call ask_user with the counts and the choice to make. Stop and wait for the answer.
-3b. Codebook checkpoint (classification questions: "how do carriers treat X", "sort into categories", "which variants exist"). Discover the categories on a sample first — read 15–30 documents, write the candidate categories with one quoted example each to research/codebook.md and publish it — then call ask_user to have the codebook approved or revised before extracting over the whole population. Never classify thousands of documents against categories the user has not seen.
+2. Size. Use count_filings and summarize_filings (grouped by state, filingType, typeOfInsurance, submittedMonth) to see how big the population is before reading anything. A count of 0 inside the scope is a finding, not a dead end: report exactly which filters were applied and call request_clarification so the user can correct the scope (a line code such as "04.0000" is one SERFF sub-line, "Homeowners" or "04.0" is the whole line).
+3. Confirm. If the population is large (more than ~300 filings or ~1,000 documents) or the question is ambiguous, call request_clarification with the counts and the choice to make (explicit options; allowFreeText when they may not cover it). Stop and wait for the answer.
+3b. Codebook checkpoint (classification questions: "how do carriers treat X", "sort into categories", "which variants exist"). Discover the categories on a sample first — read 15–30 documents, write the candidate categories with one quoted example each to research/codebook.md and publish it — then call request_clarification to have the codebook approved or revised before extracting over the whole population. Never classify thousands of documents against categories the user has not seen.
 4. Narrow. Use search_documents (KEYWORD with exact phrases first, SEMANTIC/HYBRID for concepts like "water shut-off valve requirement") to find the documents that matter. Pass saveText=true so the extracted text lands in data/text/ for grep.
 5. Download only what search cannot answer: download_attachment extracts PDF text locally. Note documents with no text (scanned) — they go in the findings as "not readable".
 6. Analyze locally. Use run_command with rg/grep, jq, python3 (pandas, sqlite3, openpyxl for Excel rate pages) and the files under data/. Keep intermediate tables in data/*.csv. Never paste whole documents into the conversation; read_text only the lines around a match. Normalize values before comparing (a credit on the water peril is not a credit on total premium; 30 vs 45 days must be read as numbers, not matched as text).
@@ -34,6 +41,10 @@ Method — plan, size, confirm, narrow, download, analyze, report:
    Then call publish_results with those paths so they appear in the session, and finish with a short summary message.
 
 Working rules:
+- Filters are {field, comparisonOperator, value}. List fields (states, typeOfInsurances, subTypeOfInsurances, filingTypes, statusIds, companies, trackingNumbers, …) take a string array: "cn" matches part of the label ({field: "typeOfInsurances", comparisonOperator: "cn", value: ["04.0"]} covers the whole Homeowners line), "in" the exact label. Dates (dateSubmitted, createdAt, updatedAt) take one date string with eq/gt/gte/lt/lte; hasObjection takes ex with a boolean. The tools wrap a single value, choose the operator a field accepts and reject unknown fields before calling FilingRamp: a failure names the accepted fields, so fix the call rather than retry it. Summary groupBy uses singular names (state, typeOfInsurance, filingType, statusId, submittedMonth, …).
+- To learn which lines, states or companies the account has, call summarize_filings grouped by that field with no filter on it. Never probe with fragments ("e", "a") or empty values. search_documents has its own vocabulary; its description lists it.
+- A failed API call is not a zero count. Correct validation errors and retry; if the request still fails, report that the population could not be determined.
+- Narrate: before each group of tool calls write one short line in plain language saying what you are about to do and why ("Counting TX and AZ homeowners filings to size the population."). The user watches these lines while you work; keep them to one sentence, no headings, no restating results the tool rows already show.
 - Progress: call report_progress when a phase starts and finishes, so the user sees a checklist while you work. Post a short message every ~10 minutes of work with counts so far.
 - ${budget}Prefer counts and summaries over listing rows; request only the fields you need; let files hold bulk data.
 - Dates, states and lines you were given are the scope: always say when the data can not answer the question within it.

package/dist/research/prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/research/prompt.ts"],"names":[],"mappings":";;;AAUA,8DA8BC;AAvCD,mCAAuC;AAE1B,QAAA,qBAAqB,GAAG;IACnC,QAAQ,EAAE,sBAAsB;IAChC,OAAO,EAAE,sBAAsB;IAC/B,QAAQ,EAAE,wBAAwB;IAClC,KAAK,EAAE,mBAAmB;CAClB,CAAA;AAEV,SAAgB,yBAAyB,CAAC,OAA+E;IACvH,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,kCAAkC,OAAO,CAAC,WAAW,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAA;IAC3H,OAAO;;;EAGP,IAAA,qBAAa,EAAC,OAAO,CAAC,KAAK,CAAC;EAC5B,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,yEAAyE,CAAC,CAAC,CAAC,iDAAiD;;;qJAGD,6BAAqB,CAAC,KAAK;;;;;;;;;OASzK,6BAAqB,CAAC,QAAQ;OAC9B,6BAAqB,CAAC,OAAO;OAC7B,6BAAqB,CAAC,QAAQ;;;;;;IAMjC,MAAM;;;2CAGiC,6BAAqB,CAAC,KAAK,2EAA2E,CAAA;AACjJ,CAAC"}
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/research/prompt.ts"],"names":[],"mappings":";;;AAaA,8DA6CC;AAzDD,mCAAuC;AAE1B,QAAA,qBAAqB,GAAG;IACnC,QAAQ,EAAE,sBAAsB;IAChC,OAAO,EAAE,sBAAsB;IAC/B,QAAQ,EAAE,wBAAwB;IAClC,KAAK,EAAE,mBAAmB;CAClB,CAAA;AAEV,gGAAgG;AACnF,QAAA,uBAAuB,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,CAAU,CAAA;AAEjF,SAAgB,yBAAyB,CAAC,OAMzC;IACC,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,kCAAkC,OAAO,CAAC,WAAW,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,CAAA;IAC3H,MAAM,cAAc,GAAG,OAAO,CAAC,QAAQ;QACrC,CAAC,CAAC,uDAAuD,6BAAqB,CAAC,KAAK,gDAAgD;QACpI,CAAC,CAAC,uJAAuJ,CAAA;IAC3J,OAAO;;2MAEkM,cAAc;;;EAGvN,IAAA,qBAAa,EAAC,OAAO,CAAC,KAAK,CAAC;EAC5B,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,yEAAyE,CAAC,CAAC,CAAC,iDAAiD;;;qJAGD,6BAAqB,CAAC,KAAK;;;;;;;;;OASzK,6BAAqB,CAAC,QAAQ;OAC9B,6BAAqB,CAAC,OAAO;OAC7B,6BAAqB,CAAC,QAAQ;;;;;;;;;;IAUjC,MAAM;;;2CAGiC,6BAAqB,CAAC,KAAK,2EAA2E,CAAA;AACjJ,CAAC"}

package/dist/research/scope.d.ts

@@ -1,9 +1,6 @@
 import type { ResearchScope } from '../config';
-export interface FilingsFilter {
-    field: string;
-    comparisonOperator: string;
-    value: unknown;
-}
+import { type FilingsFilter } from './filingramp-contract';
+export type { FilingsFilter } from './filingramp-contract';
 /** Four-decimal codes ("17.0001") are sub-lines; anything else is a broad line or a name. */
 export declare function isSubLineCode(line: string): boolean;
 /**
@@ -14,10 +11,27 @@ export declare function isSubLineCode(line: string): boolean;
  */
 export declare function scopeFilingsFilters(scope: ResearchScope | undefined, requested?: FilingsFilter[]): FilingsFilter[];
 /**
- * Same idea for POST /v1/search/global (OpenSearch): its filter vocabulary differs (singular
- * typeOfInsurance / subTypeOfInsurance, exact "in" matches only).
+ * The exact type-of-insurance labels the scope's lines stand for, as the filings carry them
+ * ("04.0 Homeowners" for a scope line "Homeowners" or "04.0"). Document search matches these
+ * fields exactly, so the labels are resolved from the filings summary before searching.
+ */
+export interface ScopeLineLabels {
+    lines: string[];
+    subLines: string[];
+}
+export interface ScopedDocumentFilters {
+    filters: FilingsFilter[];
+    /** Scope constraints this index group cannot express (its filter vocabulary lacks the field). */
+    unscoped: string[];
+    /** True when the scope names lines but no filing in scope carries them: nothing can match. */
+    emptyByLines: boolean;
+}
+/**
+ * Same idea for POST /v1/content-search/global (OpenSearch). Its vocabulary differs per index
+ * (singular typeOfInsurance, exact "in" matches only, no state field on library indexes), so
+ * the scope is applied field by field against what the group accepts and the rest reported.
  */
-export declare function scopeDocumentFilters(scope: ResearchScope | undefined, requested?: FilingsFilter[]): FilingsFilter[];
+export declare function scopeDocumentFilters(scope: ResearchScope | undefined, requested: FilingsFilter[], accepted: readonly string[], lineLabels?: ScopeLineLabels): ScopedDocumentFilters;
 /** 'INDUSTRY' only when the session asked for it and the account is entitled; otherwise account data. */
 export declare function resolveSearchType(scope: ResearchScope | undefined, industryData: boolean, requested?: 'ACCOUNT' | 'INDUSTRY'): 'ACCOUNT' | 'INDUSTRY';
 export declare function describeScope(scope: ResearchScope | undefined): string;

package/dist/research/scope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/research/scope.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAE9C,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,kBAAkB,EAAE,MAAM,CAAA;IAC1B,KAAK,EAAE,OAAO,CAAA;CACf;AAED,6FAA6F;AAC7F,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,EAAE,SAAS,GAAE,aAAa,EAAO,GAAG,aAAa,EAAE,CAkCtH;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,EAAE,SAAS,GAAE,aAAa,EAAO,GAAG,aAAa,EAAE,CAwBvH;AAED,yGAAyG;AACzG,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,GAAG,SAAS,EAChC,YAAY,EAAE,OAAO,EACrB,SAAS,CAAC,EAAE,SAAS,GAAG,UAAU,GACjC,SAAS,GAAG,UAAU,CAMxB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,GAAG,MAAM,CAUtE"}
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/research/scope.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAC9C,OAAO,EAAyB,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAEjF,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAE1D,6FAA6F;AAC7F,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,EAAE,SAAS,GAAE,aAAa,EAAO,GAAG,aAAa,EAAE,CAsCtH;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,iGAAiG;IACjG,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,8FAA8F;IAC9F,YAAY,EAAE,OAAO,CAAA;CACtB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,GAAG,SAAS,EAChC,SAAS,EAAE,aAAa,EAAE,EAC1B,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,UAAU,CAAC,EAAE,eAAe,GAC3B,qBAAqB,CAyCvB;AAED,yGAAyG;AACzG,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,GAAG,SAAS,EAChC,YAAY,EAAE,OAAO,EACrB,SAAS,CAAC,EAAE,SAAS,GAAG,UAAU,GACjC,SAAS,GAAG,UAAU,CAMxB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,GAAG,MAAM,CAUtE"}

package/dist/research/scope.js

@@ -5,6 +5,7 @@ exports.scopeFilingsFilters = scopeFilingsFilters;
 exports.scopeDocumentFilters = scopeDocumentFilters;
 exports.resolveSearchType = resolveSearchType;
 exports.describeScope = describeScope;
+const filingramp_contract_1 = require("./filingramp-contract");
 /** Four-decimal codes ("17.0001") are sub-lines; anything else is a broad line or a name. */
 function isSubLineCode(line) {
     return /^\d{1,2}\.\d{4}$/.test(line.trim());
@@ -17,6 +18,13 @@ function isSubLineCode(line) {
  */
 function scopeFilingsFilters(scope, requested = []) {
     var _a, _b;
+    requested = requested.map((filter) => {
+        var _a;
+        return ({
+            ...filter,
+            field: (_a = filingramp_contract_1.FILING_FILTER_ALIASES[filter.field]) !== null && _a !== void 0 ? _a : filter.field,
+        });
+    });
     const filters = [];
     const requestedByField = new Map(requested.map((filter) => [filter.field, filter]));
     if ((_a = scope === null || scope === void 0 ? void 0 : scope.states) === null || _a === void 0 ? void 0 : _a.length) {
@@ -49,33 +57,59 @@ function scopeFilingsFilters(scope, requested = []) {
     return filters;
 }
 /**
- * Same idea for POST /v1/search/global (OpenSearch): its filter vocabulary differs (singular
- * typeOfInsurance / subTypeOfInsurance, exact "in" matches only).
+ * Same idea for POST /v1/content-search/global (OpenSearch). Its vocabulary differs per index
+ * (singular typeOfInsurance, exact "in" matches only, no state field on library indexes), so
+ * the scope is applied field by field against what the group accepts and the rest reported.
  */
-function scopeDocumentFilters(scope, requested = []) {
+function scopeDocumentFilters(scope, requested, accepted, lineLabels) {
     var _a, _b;
     const filters = [];
+    const unscoped = [];
+    let emptyByLines = false;
     const has = (field) => requested.some((filter) => filter.field === field);
-    if (((_a = scope === null || scope === void 0 ? void 0 : scope.states) === null || _a === void 0 ? void 0 : _a.length) && !has('states')) {
-        filters.push({ field: 'states', comparisonOperator: 'in', value: scope.states.map((state) => state.toUpperCase()) });
+    const can = (field) => accepted.includes(field);
+    if ((_a = scope === null || scope === void 0 ? void 0 : scope.states) === null || _a === void 0 ? void 0 : _a.length) {
+        if (!can('states'))
+            unscoped.push('states');
+        else if (!has('states'))
+            filters.push({ field: 'states', comparisonOperator: 'in', value: scope.states.map((state) => state.toUpperCase()) });
     }
     if ((_b = scope === null || scope === void 0 ? void 0 : scope.lines) === null || _b === void 0 ? void 0 : _b.length) {
         const subLines = scope.lines.filter(isSubLineCode);
         const lines = scope.lines.filter((line) => !isSubLineCode(line));
-        if (subLines.length && !has('subTypeOfInsurance')) {
-            filters.push({ field: 'subTypeOfInsurance', comparisonOperator: 'in', value: subLines });
+        if (!can('typeOfInsurance')) {
+            unscoped.push('lines');
         }
-        if (lines.length && !has('typeOfInsurance')) {
-            filters.push({ field: 'typeOfInsurance', comparisonOperator: 'in', value: lines });
+        else {
+            const labels = lineLabels !== null && lineLabels !== void 0 ? lineLabels : { lines: [], subLines: [] };
+            if (subLines.length && !has('subTypeOfInsurance')) {
+                if (labels.subLines.length)
+                    filters.push({ field: 'subTypeOfInsurance', comparisonOperator: 'in', value: labels.subLines });
+                else
+                    emptyByLines = true;
+            }
+            if (lines.length && !has('typeOfInsurance')) {
+                if (labels.lines.length)
+                    filters.push({ field: 'typeOfInsurance', comparisonOperator: 'in', value: labels.lines });
+                else
+                    emptyByLines = true;
+            }
         }
     }
-    if ((scope === null || scope === void 0 ? void 0 : scope.dateFrom) && !has('dateSubmitted')) {
-        filters.push({ field: 'dateSubmitted', comparisonOperator: 'gte', value: scope.dateFrom });
-    }
-    if ((scope === null || scope === void 0 ? void 0 : scope.dateTo) && !requested.some((f) => f.field === 'dateSubmitted' && ['lte', 'lt'].includes(f.comparisonOperator))) {
-        filters.push({ field: 'dateSubmitted', comparisonOperator: 'lte', value: scope.dateTo });
+    if ((scope === null || scope === void 0 ? void 0 : scope.dateFrom) || (scope === null || scope === void 0 ? void 0 : scope.dateTo)) {
+        if (!can('dateSubmitted')) {
+            unscoped.push('dates');
+        }
+        else {
+            if (scope.dateFrom && !requested.some((f) => f.field === 'dateSubmitted' && ['gte', 'gt'].includes(f.comparisonOperator))) {
+                filters.push({ field: 'dateSubmitted', comparisonOperator: 'gte', value: scope.dateFrom });
+            }
+            if (scope.dateTo && !requested.some((f) => f.field === 'dateSubmitted' && ['lte', 'lt'].includes(f.comparisonOperator))) {
+                filters.push({ field: 'dateSubmitted', comparisonOperator: 'lte', value: scope.dateTo });
+            }
+        }
     }
-    return [...filters, ...requested];
+    return { filters: [...filters, ...requested], unscoped, emptyByLines };
 }
 /** 'INDUSTRY' only when the session asked for it and the account is entitled; otherwise account data. */
 function resolveSearchType(scope, industryData, requested) {

package/dist/research/scope.js.map

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

package/dist/research/scope.test.js

@@ -5,8 +5,16 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const strict_1 = __importDefault(require("node:assert/strict"));
 const node_test_1 = require("node:test");
+const filingramp_contract_1 = require("./filingramp-contract");
 const scope_1 = require("./scope");
+const [FILINGS_GROUP] = (0, filingramp_contract_1.documentIndexGroups)(['filings']);
+const [LIBRARY_GROUP] = (0, filingramp_contract_1.documentIndexGroups)(['library_forms']);
 (0, node_test_1.describe)('research scope filters', () => {
+    (0, node_test_1.it)('normalizes singular and plural filter names per endpoint family', () => {
+        const singular = [{ field: 'typeOfInsurance', comparisonOperator: 'cn', value: ['Homeowners'] }];
+        strict_1.default.equal((0, scope_1.scopeFilingsFilters)(undefined, singular)[0].field, 'typeOfInsurances');
+        strict_1.default.equal((0, filingramp_contract_1.documentFilterField)('typeOfInsurances'), 'typeOfInsurance');
+    });
     (0, node_test_1.it)('adds state, line and date filters the scope implies', () => {
         const filters = (0, scope_1.scopeFilingsFilters)({ states: ['tx', 'AZ'], lines: ['17.0001', 'Homeowners'], dateFrom: '2024-01-01', dateTo: '2024-12-31' });
         strict_1.default.deepEqual(filters, [
@@ -24,16 +32,49 @@ const scope_1 = require("./scope");
         strict_1.default.deepEqual(widened[0], { field: 'states', comparisonOperator: 'in', value: ['TX'] });
         strict_1.default.equal(widened.length, 1);
     });
+    (0, node_test_1.it)('normalizes result-field aliases before merging the session scope', () => {
+        const requested = [
+            { field: 'state', comparisonOperator: 'in', value: ['AZ', 'CA'] },
+            { field: 'typeOfInsurance', comparisonOperator: 'cn', value: ['04.0'] },
+        ];
+        strict_1.default.deepEqual((0, scope_1.scopeFilingsFilters)({ states: ['TX', 'AZ'], lines: ['04.0'] }, requested), [
+            { field: 'states', comparisonOperator: 'in', value: ['AZ'] },
+            { field: 'typeOfInsurances', comparisonOperator: 'cn', value: ['04.0'] },
+        ]);
+        strict_1.default.equal(requested[0].field, 'state');
+        strict_1.default.deepEqual((0, scope_1.scopeFilingsFilters)(undefined, [
+            { field: 'subTypeOfInsurance', comparisonOperator: 'cn', value: ['04.0000'] },
+        ]), [{ field: 'subTypeOfInsurances', comparisonOperator: 'cn', value: ['04.0000'] }]);
+    });
     (0, node_test_1.it)('keeps caller filters on other fields and passes through with no scope', () => {
         const own = [{ field: 'filingTypes', comparisonOperator: 'in', value: ['Form'] }];
         strict_1.default.deepEqual((0, scope_1.scopeFilingsFilters)(undefined, own), own);
-        strict_1.default.deepEqual((0, scope_1.scopeDocumentFilters)(undefined, own), own);
+        strict_1.default.deepEqual((0, scope_1.scopeDocumentFilters)(undefined, own, FILINGS_GROUP.fields), { filters: own, unscoped: [], emptyByLines: false });
     });
-    (0, node_test_1.it)('uses the singular OpenSearch vocabulary for document search', () => {
-        strict_1.default.deepEqual((0, scope_1.scopeDocumentFilters)({ states: ['tx'], lines: ['17.0001'] }), [
-            { field: 'states', comparisonOperator: 'in', value: ['TX'] },
-            { field: 'subTypeOfInsurance', comparisonOperator: 'in', value: ['17.0001'] },
-        ]);
+    (0, node_test_1.it)('applies the scope to document search with the exact labels the filings carry', () => {
+        const scope = { states: ['tx'], lines: ['17.0001', 'Homeowners'], dateFrom: '2024-01-01' };
+        const labels = { lines: ['04.0 Homeowners'], subLines: ['17.0001 Sub-line'] };
+        strict_1.default.deepEqual((0, scope_1.scopeDocumentFilters)(scope, [], FILINGS_GROUP.fields, labels), {
+            filters: [
+                { field: 'states', comparisonOperator: 'in', value: ['TX'] },
+                { field: 'subTypeOfInsurance', comparisonOperator: 'in', value: ['17.0001 Sub-line'] },
+                { field: 'typeOfInsurance', comparisonOperator: 'in', value: ['04.0 Homeowners'] },
+                { field: 'dateSubmitted', comparisonOperator: 'gte', value: '2024-01-01' },
+            ],
+            unscoped: [],
+            emptyByLines: false,
+        });
+    });
+    (0, node_test_1.it)('reports what an index group cannot express and when no filing carries the scope lines', () => {
+        const scope = { states: ['TX'], lines: ['Homeowners'], dateTo: '2024-12-31' };
+        strict_1.default.deepEqual((0, scope_1.scopeDocumentFilters)(scope, [], LIBRARY_GROUP.fields, { lines: ['04.0 Homeowners'], subLines: [] }), {
+            filters: [],
+            unscoped: ['states', 'lines', 'dates'],
+            emptyByLines: false,
+        });
+        const empty = (0, scope_1.scopeDocumentFilters)(scope, [], FILINGS_GROUP.fields, { lines: [], subLines: [] });
+        strict_1.default.equal(empty.emptyByLines, true);
+        strict_1.default.deepEqual(empty.filters.map((filter) => filter.field), ['states', 'dateSubmitted']);
     });
     (0, node_test_1.it)('refuses industry data when the account is not entitled', () => {
         strict_1.default.equal((0, scope_1.resolveSearchType)({ dataSource: 'industry' }, true), 'INDUSTRY');

package/dist/research/scope.test.js.map

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

package/dist/runtime.d.ts

@@ -6,5 +6,7 @@ export interface RunningAgent {
     session?: SessionAgent;
     close(): Promise<void>;
 }
+/** A lifecycle request can race startup; never acknowledge a freeze before restore finishes. */
+export declare function checkpointBeforeFreeze(starting: Promise<RunningAgent> | undefined, reason: string): Promise<void>;
 export declare function startAgent(env?: NodeJS.ProcessEnv): Promise<RunningAgent>;
 //# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAGA,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAIrE,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,WAAW,CAAA;AAE9D,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,kBAAkB,CAAA;IAC1B,oCAAoC;IACpC,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAED,wBAAsB,UAAU,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAAC,YAAY,CAAC,CAsB5F"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAGA,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAIrE,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,WAAW,CAAA;AAE9D,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,kBAAkB,CAAA;IAC1B,oCAAoC;IACpC,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAED,gGAAgG;AAChG,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIvH;AAED,wBAAsB,UAAU,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAAC,YAAY,CAAC,CA6B5F"}

package/dist/runtime.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkpointBeforeFreeze = checkpointBeforeFreeze;
 exports.startAgent = startAgent;
 // Mode dispatch shared by both entrypoints (cli.ts for engines that materialize env before
 // start, lambda-microvm-entrypoint.ts for the /run hook): task mode runs once and resolves;
@@ -9,17 +10,33 @@ const link_1 = require("./link");
 const loop_1 = require("./loop");
 const report_1 = require("./report");
 const session_1 = require("./session");
+/** A lifecycle request can race startup; never acknowledge a freeze before restore finishes. */
+async function checkpointBeforeFreeze(starting, reason) {
+    var _a;
+    if (!starting)
+        throw new Error('Agent has not started; cannot checkpoint before freezing');
+    const agent = await starting;
+    await ((_a = agent.session) === null || _a === void 0 ? void 0 : _a.checkpoint(reason));
+}
 async function startAgent(env = process.env) {
     const config = (0, config_1.loadConfigFromEnv)(env);
     if (config.mode === 'session') {
         const link = (0, link_1.createSessionLink)(config.sessionId, config.socketUrl, config.socketToken);
-        const session = await (0, session_1.runSessionAgent)(config, link);
+        const session = await (0, session_1.runSessionAgent)(config, link).catch(async (error) => {
+            link.send({ type: 'error', message: `Workspace restore failed: ${error instanceof Error ? error.message : String(error)}` });
+            await link.close();
+            throw error;
+        });
         return {
             config,
             session,
             async close() {
-                await session.stop();
-                await link.close();
+                try {
+                    await session.stop();
+                }
+                finally {
+                    await link.close();
+                }
             },
         };
     }

package/dist/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":";;AAgBA,gCAsBC;AAtCD,2FAA2F;AAC3F,4FAA4F;AAC5F,6FAA6F;AAC7F,qCAAqE;AACrE,iCAA0C;AAC1C,iCAAqC;AACrC,qCAAyC;AACzC,uCAA8D;AASvD,KAAK,UAAU,UAAU,CAAC,MAAyB,OAAO,CAAC,GAAG;IACnE,MAAM,MAAM,GAAG,IAAA,0BAAiB,EAAC,GAAG,CAAC,CAAA;IACrC,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,IAAA,wBAAiB,EAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,CAAA;QACtF,MAAM,OAAO,GAAG,MAAM,IAAA,yBAAe,EAAC,MAAM,EAAE,IAAI,CAAC,CAAA;QACnD,OAAO;YACL,MAAM;YACN,OAAO;YACP,KAAK,CAAC,KAAK;gBACT,MAAM,OAAO,CAAC,IAAI,EAAE,CAAA;gBACpB,MAAM,IAAI,CAAC,KAAK,EAAE,CAAA;YACpB,CAAC;SACF,CAAA;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,IAAA,uBAAc,EAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,CAAA;IACvF,IAAI,CAAC;QACH,MAAM,IAAA,mBAAY,EAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IACtC,CAAC;YAAS,CAAC;QACT,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAA;IACxB,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,KAAK,KAAI,CAAC,EAAE,CAAA;AACrC,CAAC"}
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":";;AAiBA,wDAIC;AAED,gCA6BC;AApDD,2FAA2F;AAC3F,4FAA4F;AAC5F,6FAA6F;AAC7F,qCAAqE;AACrE,iCAA0C;AAC1C,iCAAqC;AACrC,qCAAyC;AACzC,uCAA8D;AAS9D,gGAAgG;AACzF,KAAK,UAAU,sBAAsB,CAAC,QAA2C,EAAE,MAAc;;IACtG,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAA;IAC1F,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAA;IAC5B,MAAM,CAAA,MAAA,KAAK,CAAC,OAAO,0CAAE,UAAU,CAAC,MAAM,CAAC,CAAA,CAAA;AACzC,CAAC;AAEM,KAAK,UAAU,UAAU,CAAC,MAAyB,OAAO,CAAC,GAAG;IACnE,MAAM,MAAM,GAAG,IAAA,0BAAiB,EAAC,GAAG,CAAC,CAAA;IACrC,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,IAAA,wBAAiB,EAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,CAAA;QACtF,MAAM,OAAO,GAAG,MAAM,IAAA,yBAAe,EAAC,MAAM,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,KAAc,EAAE,EAAE;YACjF,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,6BAA6B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAA;YAC5H,MAAM,IAAI,CAAC,KAAK,EAAE,CAAA;YAClB,MAAM,KAAK,CAAA;QACb,CAAC,CAAC,CAAA;QACF,OAAO;YACL,MAAM;YACN,OAAO;YACP,KAAK,CAAC,KAAK;gBACT,IAAI,CAAC;oBACH,MAAM,OAAO,CAAC,IAAI,EAAE,CAAA;gBACtB,CAAC;wBAAS,CAAC;oBACT,MAAM,IAAI,CAAC,KAAK,EAAE,CAAA;gBACpB,CAAC;YACH,CAAC;SACF,CAAA;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,IAAA,uBAAc,EAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,CAAA;IACvF,IAAI,CAAC;QACH,MAAM,IAAA,mBAAY,EAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IACtC,CAAC;YAAS,CAAC;QACT,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAA;IACxB,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,KAAK,KAAI,CAAC,EAAE,CAAA;AACrC,CAAC"}

package/dist/session.d.ts

@@ -1,6 +1,7 @@
 import { type ModelMessage } from 'ai';
 import type { AgentRuntimeConfig } from './config';
 import type { SessionLink } from './link';
+export declare const PERIODIC_CHECKPOINT_MS: number;
 /** Drops the oldest turns (user message + everything up to the next user message) past the cap, keeping the first one. */
 export declare function limitConversation(messages: ModelMessage[], charBudget?: number): ModelMessage[];
 export declare class SessionAgent {
@@ -17,12 +18,16 @@ export declare class SessionAgent {
     private systemPrompt;
     private periodic?;
     private stopped;
+    private turnTask?;
+    private checkpointTask;
+    private lastCheckpointAt;
     constructor(config: AgentRuntimeConfig, link: SessionLink);
     private get workspaceDir();
     start(): Promise<void>;
     /** Lifecycle hooks (suspend / terminate) call this; it is safe to call repeatedly. */
-    checkpoint(reason: string): Promise<void>;
+    checkpoint(reason: string, requestId?: string): Promise<void>;
     stop(): Promise<void>;
+    private scheduleCheckpoint;
     private handle;
     private buildTools;
     /** Bulk extraction on the cheaper model: one call per file, structured rows appended to a JSONL file. */

package/dist/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAUA,OAAO,EAA+C,KAAK,YAAY,EAAa,MAAM,IAAI,CAAA;AAE9F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAElD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AAoCzC,0HAA0H;AAC1H,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,UAAU,SAAsB,GAAG,YAAY,EAAE,CAa5G;AAUD,qBAAa,YAAY;IAcrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAdvB,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,UAAU,CAAI;IACtB,OAAO,CAAC,MAAM,CAAC,CAAQ;IACvB,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,OAAO,CAAC,CAAY;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiD;IACvE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAClC,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,QAAQ,CAAC,CAAgB;IACjC,OAAO,CAAC,OAAO,CAAQ;gBAGJ,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE,WAAW;IAMpC,OAAO,KAAK,YAAY,GAEvB;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B5B,sFAAsF;IAChF,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWzC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAMb,MAAM;IAmBpB,OAAO,CAAC,UAAU;IAsFlB,yGAAyG;IACzG,OAAO,CAAC,cAAc;IA0CtB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,cAAc;YAIR,OAAO;IA0GrB,OAAO,CAAC,gBAAgB;YAIV,gBAAgB;YAehB,gBAAgB;CAM/B;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAI1G"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAUA,OAAO,EAA+C,KAAK,YAAY,EAAa,MAAM,IAAI,CAAA;AAE9F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAElD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AAczC,eAAO,MAAM,sBAAsB,QAAa,CAAA;AAwBhD,0HAA0H;AAC1H,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,UAAU,SAAsB,GAAG,YAAY,EAAE,CAa5G;AAUD,qBAAa,YAAY;IAiBrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAjBvB,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,UAAU,CAAI;IACtB,OAAO,CAAC,MAAM,CAAC,CAAQ;IACvB,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,OAAO,CAAC,CAAY;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiD;IACvE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAClC,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,QAAQ,CAAC,CAAgB;IACjC,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,QAAQ,CAAC,CAAe;IAChC,OAAO,CAAC,cAAc,CAAmC;IACzD,OAAO,CAAC,gBAAgB,CAAI;gBAGT,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE,WAAW;IAMpC,OAAO,KAAK,YAAY,GAEvB;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B5B,sFAAsF;IACtF,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBvD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAU3B,OAAO,CAAC,kBAAkB;YAeZ,MAAM;IAoBpB,OAAO,CAAC,UAAU;IAmGlB,yGAAyG;IACzG,OAAO,CAAC,cAAc;IAwDtB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,cAAc;YAIR,OAAO;IAuGrB,OAAO,CAAC,gBAAgB;YAIV,gBAAgB;YAkBhB,gBAAgB;CAO/B;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAI1G"}