@multiplayer-app/agent 0.0.6 → 0.1.0

package/dist/research/scope.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSubLineCode = isSubLineCode;
+exports.scopeFilingsFilters = scopeFilingsFilters;
+exports.scopeDocumentFilters = scopeDocumentFilters;
+exports.resolveSearchType = resolveSearchType;
+exports.describeScope = describeScope;
+/** 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());
+}
+/**
+ * Filters the scope implies for the filings search / count / summary endpoints
+ * (FilingsFilters in the FilingRamp catalog). A field the caller already set wins — the
+ * caller is the model narrowing within the scope, never a way around it: when the caller's
+ * value falls outside the scope the scope's filter is kept and the caller's is dropped.
+ */
+function scopeFilingsFilters(scope, requested = []) {
+    var _a, _b;
+    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) {
+        const wanted = new Set(scope.states.map((state) => state.toUpperCase()));
+        const own = requestedByField.get('states');
+        const narrowed = Array.isArray(own === null || own === void 0 ? void 0 : own.value)
+            ? own.value.filter((state) => wanted.has(String(state).toUpperCase()))
+            : [];
+        filters.push({ field: 'states', comparisonOperator: 'in', value: narrowed.length ? narrowed : [...wanted] });
+        requestedByField.delete('states');
+    }
+    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 && !requestedByField.has('subTypeOfInsurances')) {
+            filters.push({ field: 'subTypeOfInsurances', comparisonOperator: 'cn', value: subLines });
+        }
+        if (lines.length && !requestedByField.has('typeOfInsurances')) {
+            filters.push({ field: 'typeOfInsurances', comparisonOperator: 'cn', value: lines });
+        }
+    }
+    if ((scope === null || scope === void 0 ? void 0 : scope.dateFrom) && !requested.some((f) => f.field === 'dateSubmitted' && ['gte', 'gt'].includes(f.comparisonOperator))) {
+        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 });
+    }
+    for (const filter of requestedByField.values())
+        filters.push(filter);
+    return filters;
+}
+/**
+ * Same idea for POST /v1/search/global (OpenSearch): its filter vocabulary differs (singular
+ * typeOfInsurance / subTypeOfInsurance, exact "in" matches only).
+ */
+function scopeDocumentFilters(scope, requested = []) {
+    var _a, _b;
+    const filters = [];
+    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()) });
+    }
+    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 (lines.length && !has('typeOfInsurance')) {
+            filters.push({ field: 'typeOfInsurance', comparisonOperator: 'in', value: lines });
+        }
+    }
+    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 });
+    }
+    return [...filters, ...requested];
+}
+/** 'INDUSTRY' only when the session asked for it and the account is entitled; otherwise account data. */
+function resolveSearchType(scope, industryData, requested) {
+    const wanted = requested !== null && requested !== void 0 ? requested : ((scope === null || scope === void 0 ? void 0 : scope.dataSource) === 'industry' ? 'INDUSTRY' : 'ACCOUNT');
+    if (wanted === 'INDUSTRY' && !industryData) {
+        throw new Error('Industry data is not enabled for this account; search account filings instead.');
+    }
+    return wanted;
+}
+function describeScope(scope) {
+    var _a, _b;
+    if (!scope)
+        return 'No scope was set: the whole account is in scope.';
+    const parts = [];
+    parts.push(`Data source: ${scope.dataSource === 'industry' ? 'industry (public) filings' : "this account's filings"}.`);
+    if ((_a = scope.states) === null || _a === void 0 ? void 0 : _a.length)
+        parts.push(`States: ${scope.states.join(', ')}.`);
+    if ((_b = scope.lines) === null || _b === void 0 ? void 0 : _b.length)
+        parts.push(`Lines of business: ${scope.lines.join(', ')}.`);
+    if (scope.dateFrom || scope.dateTo) {
+        parts.push(`Submitted ${scope.dateFrom ? `from ${scope.dateFrom}` : ''}${scope.dateTo ? ` to ${scope.dateTo}` : ''}.`.replace('  ', ' '));
+    }
+    return parts.join(' ');
+}
+//# sourceMappingURL=scope.js.map

package/dist/research/scope.js.map

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

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

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

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

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

package/dist/research/scope.test.js

@@ -0,0 +1,45 @@
+"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 scope_1 = require("./scope");
+(0, node_test_1.describe)('research scope filters', () => {
+    (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, [
+            { field: 'states', comparisonOperator: 'in', value: ['TX', 'AZ'] },
+            { field: 'subTypeOfInsurances', comparisonOperator: 'cn', value: ['17.0001'] },
+            { field: 'typeOfInsurances', comparisonOperator: 'cn', value: ['Homeowners'] },
+            { field: 'dateSubmitted', comparisonOperator: 'gte', value: '2024-01-01' },
+            { field: 'dateSubmitted', comparisonOperator: 'lte', value: '2024-12-31' },
+        ]);
+    });
+    (0, node_test_1.it)('lets the caller narrow states inside the scope but never widen past it', () => {
+        const narrowed = (0, scope_1.scopeFilingsFilters)({ states: ['TX', 'AZ'] }, [{ field: 'states', comparisonOperator: 'in', value: ['AZ'] }]);
+        strict_1.default.deepEqual(narrowed[0], { field: 'states', comparisonOperator: 'in', value: ['AZ'] });
+        const widened = (0, scope_1.scopeFilingsFilters)({ states: ['TX'] }, [{ field: 'states', comparisonOperator: 'in', value: ['CA'] }]);
+        strict_1.default.deepEqual(widened[0], { field: 'states', comparisonOperator: 'in', value: ['TX'] });
+        strict_1.default.equal(widened.length, 1);
+    });
+    (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);
+    });
+    (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)('refuses industry data when the account is not entitled', () => {
+        strict_1.default.equal((0, scope_1.resolveSearchType)({ dataSource: 'industry' }, true), 'INDUSTRY');
+        strict_1.default.equal((0, scope_1.resolveSearchType)(undefined, false), 'ACCOUNT');
+        strict_1.default.throws(() => (0, scope_1.resolveSearchType)({ dataSource: 'industry' }, false), /not enabled/);
+        strict_1.default.throws(() => (0, scope_1.resolveSearchType)(undefined, false, 'INDUSTRY'), /not enabled/);
+    });
+});
+//# sourceMappingURL=scope.test.js.map

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

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

package/dist/runtime.d.ts

@@ -0,0 +1,10 @@
+import { type AgentRuntimeConfig } from './config';
+import { type SessionAgent } from './session';
+export interface RunningAgent {
+    config: AgentRuntimeConfig;
+    /** Present in session mode only. */
+    session?: SessionAgent;
+    close(): Promise<void>;
+}
+export declare function startAgent(env?: NodeJS.ProcessEnv): Promise<RunningAgent>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +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"}

package/dist/runtime.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+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;
+// session mode stays up and resolves with the running agent so lifecycle hooks can reach it.
+const config_1 = require("./config");
+const link_1 = require("./link");
+const loop_1 = require("./loop");
+const report_1 = require("./report");
+const session_1 = require("./session");
+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);
+        return {
+            config,
+            session,
+            async close() {
+                await session.stop();
+                await link.close();
+            },
+        };
+    }
+    const reporter = (0, report_1.createReporter)(config.socketUrl, config.socketToken, config.sessionId);
+    try {
+        await (0, loop_1.runAgentLoop)(config, reporter);
+    }
+    finally {
+        await reporter.close();
+    }
+    return { config, async close() { } };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +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"}

package/dist/session.d.ts

@@ -0,0 +1,38 @@
+import { type ModelMessage } from 'ai';
+import type { AgentRuntimeConfig } from './config';
+import type { SessionLink } from './link';
+/** 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 {
+    private readonly config;
+    private readonly link;
+    private messages;
+    private usedTokens;
+    private budget?;
+    private budgetPaused;
+    private current?;
+    private readonly queue;
+    private readonly gitSync?;
+    private tools;
+    private systemPrompt;
+    private periodic?;
+    private stopped;
+    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>;
+    stop(): Promise<void>;
+    private handle;
+    private buildTools;
+    /** Bulk extraction on the cheaper model: one call per file, structured rows appended to a JSONL file. */
+    private extractionTool;
+    private recordUsage;
+    private budgetExceeded;
+    private runTurn;
+    private conversationPath;
+    private loadConversation;
+    private saveConversation;
+}
+export declare function runSessionAgent(config: AgentRuntimeConfig, link: SessionLink): Promise<SessionAgent>;
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +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"}