@insiderfinance/totalfinance 0.1.0

package/modules/workflows/dist/local/jobs.js

@@ -0,0 +1,313 @@
+/// <reference types="node" />
+/**
+ * The worker-terminated job runner (Stage 7A Decision 5): a `costClass: 'job'` operation runs in a
+ * `worker_threads` Worker; `cancelJob` terminates it — a cancellation that actually stops work —
+ * and the record moves to `cancelled` with usage. A non-job operation runs inline. Every state
+ * lives in the job store, so another process can poll, cancel (by writing `cancelled`), and
+ * retrieve; the runner watches the store and terminates on an external cancel.
+ */
+import { existsSync } from 'node:fs';
+import { Worker } from 'node:worker_threads';
+import { ErrorCode, InputError } from '../../../core/dist/index.js';
+import { contentHash } from '../../../core/dist/artifacts/index.js';
+import { runOperation, toOperationError, } from '../index.js';
+import { REGISTRY_PROFILES } from './profiles.js';
+const SUBMIT_KEYS = [
+    'registry',
+    'jobs',
+    'artifacts',
+    'directory',
+    'id',
+    'input',
+    'profile',
+    'packs',
+    'clock',
+    'jobId',
+    'seed',
+    'maxInputBytes',
+    'deadlineMs',
+    'inlineResultBytes',
+    'pollMs',
+];
+function refuse(functionName, message, field, code) {
+    throw new InputError(`${functionName}: ${message}`, {
+        code,
+        context: { function: functionName, field },
+    });
+}
+function requireSubmitInput(input) {
+    const functionName = 'submitJob';
+    if (input === null || typeof input !== 'object' || Array.isArray(input)) {
+        refuse(functionName, 'input must be an object.', 'input', ErrorCode.InputWrongType);
+    }
+    for (const key of Object.keys(input)) {
+        if (!SUBMIT_KEYS.includes(key)) {
+            refuse(functionName, `unknown field "${key}" in input. Allowed fields: ${SUBMIT_KEYS.join(', ')}.`, 'input', ErrorCode.InputUnknownField);
+        }
+    }
+    const request = input;
+    const hasMethods = (value, names) => value !== null &&
+        typeof value === 'object' &&
+        names.every((name) => typeof value[name] === 'function');
+    const registry = request['registry'];
+    if (!hasMethods(request['registry'], ['list', 'get', 'require', 'describe', 'run', 'packs']) ||
+        !Number.isSafeInteger(registry?.size) ||
+        registry?.size < 0) {
+        refuse(functionName, 'input.registry must be an OperationRegistry ({ list, get, require, describe, run, packs }).', 'input.registry', ErrorCode.InputWrongType);
+    }
+    if (!hasMethods(request['jobs'], ['create', 'update', 'get', 'list'])) {
+        refuse(functionName, 'input.jobs must be a JobStore ({ create, update, get, list }).', 'input.jobs', ErrorCode.InputWrongType);
+    }
+    if (!hasMethods(request['artifacts'], ['put', 'get', 'list'])) {
+        refuse(functionName, 'input.artifacts must be a writable ArtifactStore ({ put, get, list }).', 'input.artifacts', ErrorCode.InputWrongType);
+    }
+    if (request['input'] === undefined) {
+        refuse(functionName, "input.input is required — the operation's input object (send {} for an operation with no fields).", 'input.input', ErrorCode.InputMissingField);
+    }
+    if (request['input'] === null ||
+        typeof request['input'] !== 'object' ||
+        Array.isArray(request['input'])) {
+        refuse(functionName, "input.input must be the operation's input object.", 'input.input', ErrorCode.InputWrongType);
+    }
+    if (typeof request['directory'] !== 'string' || request['directory'].length === 0) {
+        refuse(functionName, 'input.directory must be the store directory a worker reopens.', 'input.directory', ErrorCode.InputWrongType);
+    }
+    if (typeof request['id'] !== 'string' || request['id'].length === 0) {
+        refuse(functionName, 'input.id must be an operation id.', 'input.id', ErrorCode.InputWrongType);
+    }
+    if (typeof request['profile'] !== 'string' ||
+        !REGISTRY_PROFILES.includes(request['profile'])) {
+        refuse(functionName, `input.profile must be one of ${REGISTRY_PROFILES.join(', ')}.`, 'input.profile', typeof request['profile'] === 'string'
+            ? ErrorCode.InputInvalidEnum
+            : ErrorCode.InputWrongType);
+    }
+    if (request['packs'] !== undefined &&
+        (!Array.isArray(request['packs']) || request['packs'].some((p) => typeof p !== 'string'))) {
+        refuse(functionName, 'input.packs must be an array of pack names when present.', 'input.packs', ErrorCode.InputWrongType);
+    }
+    if (typeof request['clock'] !== 'function') {
+        refuse(functionName, 'input.clock must be a function returning an ISO-8601 instant.', 'input.clock', ErrorCode.InputWrongType);
+    }
+    if (request['jobId'] !== undefined &&
+        (typeof request['jobId'] !== 'string' || !/^[A-Za-z0-9:._-]+$/.test(request['jobId']))) {
+        refuse(functionName, 'input.jobId must be a string of [A-Za-z0-9:._-] when present.', 'input.jobId', typeof request['jobId'] === 'string' ? ErrorCode.InputWrongShape : ErrorCode.InputWrongType);
+    }
+    for (const key of [
+        'seed',
+        'maxInputBytes',
+        'deadlineMs',
+        'inlineResultBytes',
+        'pollMs',
+    ]) {
+        const value = request[key];
+        if (value !== undefined &&
+            !(typeof value === 'number' && Number.isSafeInteger(value) && (key === 'seed' || value > 0))) {
+            refuse(functionName, `input.${key} must be a ${key === 'seed' ? 'safe integer' : 'positive safe integer'} when present.`, `input.${key}`, typeof value === 'number' ? ErrorCode.InputOutOfRange : ErrorCode.InputWrongType);
+        }
+    }
+    return input;
+}
+/** Where the compiled worker lives: beside this module in `dist`, or `dist/` when running from source. */
+function workerEntry() {
+    const candidates = [
+        new URL('./job-worker.js', import.meta.url),
+        new URL('../../dist/local/job-worker.js', import.meta.url),
+    ];
+    for (const candidate of candidates) {
+        if (existsSync(candidate))
+            return candidate;
+    }
+    throw new InputError('submitJob: the compiled job worker is missing — reinstall @insiderfinance/totalfinance (or run pnpm build in a source checkout) before submitting a job-class operation.', { code: ErrorCode.OperationInternal, context: { function: 'submitJob', field: 'worker' } });
+}
+function internalError(operation, message) {
+    return { code: ErrorCode.OperationInternal, message, context: {}, operation };
+}
+/**
+ * Submit an operation: a job-class operation runs in a terminated-on-cancel worker; any other
+ * operation runs inline and its record is already terminal on return.
+ */
+export function submitJob(rawInput) {
+    const input = requireSubmitInput(rawInput);
+    const operation = input.registry.require(input.id);
+    const submittedAt = input.clock();
+    const inputsHash = contentHash((input.input ?? {}));
+    const jobId = input.jobId ??
+        `job-${inputsHash.replace(/^sha256:/, '').slice(0, 12)}-${submittedAt.replace(/\D/g, '')}`;
+    const identity = { id: operation.id, version: operation.version };
+    let record = input.jobs.create({
+        id: jobId,
+        operation: identity,
+        state: 'accepted',
+        progress: null,
+        inputsHash,
+        seed: input.seed ?? null,
+        submittedAt,
+        startedAt: null,
+        finishedAt: null,
+        result: null,
+        error: null,
+        usage: { elapsedMs: null },
+    });
+    const requestId = jobId;
+    if (operation.costClass !== 'job') {
+        // Inline: the record is terminal on return.
+        const started = Date.now();
+        record = input.jobs.update(jobId, { state: 'running', startedAt: input.clock() });
+        try {
+            const result = runOperation({
+                operation,
+                input: input.input,
+                artifacts: input.artifacts,
+                createdTimestampMs: Date.parse(submittedAt),
+                requestId,
+                ...(input.seed !== undefined ? { defaultSeed: input.seed } : {}),
+                ...(input.maxInputBytes !== undefined ? { maxInputBytes: input.maxInputBytes } : {}),
+                ...(input.deadlineMs !== undefined ? { deadlineMs: input.deadlineMs } : {}),
+                ...(input.inlineResultBytes !== undefined
+                    ? { inlineResultBytes: input.inlineResultBytes }
+                    : {}),
+            });
+            const handle = input.artifacts.put({
+                value: result,
+                kind: 'report',
+                createdTimestampMs: Date.parse(submittedAt),
+                provenance: { requestId },
+            });
+            record = input.jobs.update(jobId, {
+                state: 'completed',
+                finishedAt: input.clock(),
+                result: handle,
+                usage: { elapsedMs: Date.now() - started },
+            });
+        }
+        catch (error) {
+            record = input.jobs.update(jobId, {
+                state: 'failed',
+                finishedAt: input.clock(),
+                error: toOperationError(error, operation),
+                usage: { elapsedMs: Date.now() - started },
+            });
+        }
+        const terminal = record;
+        return {
+            record: terminal,
+            completion: Promise.resolve(terminal),
+            cancel: () => Promise.resolve(terminal),
+        };
+    }
+    const workerData = {
+        operationId: operation.id,
+        input: input.input,
+        profile: input.profile,
+        ...(input.packs !== undefined ? { packs: input.packs } : {}),
+        directory: input.directory,
+        createdTimestampMs: Date.parse(submittedAt),
+        requestId,
+        ...(input.seed !== undefined ? { seed: input.seed } : {}),
+        ...(input.maxInputBytes !== undefined ? { maxInputBytes: input.maxInputBytes } : {}),
+        ...(input.deadlineMs !== undefined ? { deadlineMs: input.deadlineMs } : {}),
+        ...(input.inlineResultBytes !== undefined
+            ? { inlineResultBytes: input.inlineResultBytes }
+            : {}),
+    };
+    const started = Date.now();
+    const worker = new Worker(workerEntry(), { workerData });
+    record = input.jobs.update(jobId, { state: 'running', startedAt: input.clock() });
+    let settled = false;
+    let resolveCompletion = () => undefined;
+    const completion = new Promise((resolve) => {
+        resolveCompletion = resolve;
+    });
+    const finish = (patch) => {
+        if (settled)
+            return input.jobs.get(jobId) ?? record;
+        settled = true;
+        clearInterval(poll);
+        const current = input.jobs.get(jobId);
+        // An external cancel already moved the record; only the usage is ours to add.
+        const next = current !== null && current.state === 'cancelled'
+            ? current
+            : input.jobs.update(jobId, {
+                finishedAt: input.clock(),
+                usage: { elapsedMs: Date.now() - started },
+                ...patch,
+            });
+        resolveCompletion(next);
+        return next;
+    };
+    const terminate = async () => {
+        await worker.terminate();
+        return finish({ state: 'cancelled' });
+    };
+    // Another process cancels by writing `cancelled` to the shared store; this runner honours it.
+    const poll = setInterval(() => {
+        const current = input.jobs.get(jobId);
+        if (current !== null && current.state === 'cancelled' && !settled)
+            void terminate();
+    }, input.pollMs ?? 250);
+    worker.once('message', (message) => {
+        if (message.ok)
+            finish({ state: 'completed', result: message.handle });
+        else
+            finish({ state: 'failed', error: message.error });
+    });
+    worker.once('error', (error) => {
+        finish({ state: 'failed', error: internalError(identity, `worker error: ${error.message}`) });
+    });
+    worker.once('exit', (code) => {
+        if (!settled) {
+            finish(code === 0
+                ? {
+                    state: 'failed',
+                    error: internalError(identity, 'the worker exited without posting a result'),
+                }
+                : { state: 'cancelled' });
+        }
+    });
+    return {
+        record,
+        completion,
+        cancel: async () => {
+            if (settled)
+                return input.jobs.get(jobId) ?? record;
+            input.jobs.update(jobId, { state: 'cancelled' });
+            return terminate();
+        },
+    };
+}
+/** Cancel a job from ANY process: the record moves to `cancelled`; the running process's runner terminates its worker on the next poll. */
+export function cancelJob(input) {
+    const functionName = 'cancelJob';
+    if (input === null || typeof input !== 'object' || Array.isArray(input)) {
+        refuse(functionName, 'input must be an object ({ jobs, id, clock }).', 'input', ErrorCode.InputWrongType);
+    }
+    for (const key of Object.keys(input)) {
+        if (!['jobs', 'id', 'clock'].includes(key)) {
+            refuse(functionName, `unknown field "${key}" in input. Allowed fields: jobs, id, clock.`, 'input', ErrorCode.InputUnknownField);
+        }
+    }
+    const jobs = input.jobs;
+    if (jobs === null ||
+        typeof jobs !== 'object' ||
+        typeof jobs.get !== 'function' ||
+        typeof jobs.update !== 'function') {
+        refuse(functionName, 'input.jobs must be a JobStore.', 'input.jobs', ErrorCode.InputWrongType);
+    }
+    if (typeof input.id !== 'string' || input.id.length === 0) {
+        refuse(functionName, 'input.id must be a job id.', 'input.id', ErrorCode.InputWrongType);
+    }
+    if (typeof input.clock !== 'function') {
+        refuse(functionName, 'input.clock must be a function returning an ISO-8601 instant.', 'input.clock', ErrorCode.InputWrongType);
+    }
+    const current = input.jobs.get(input.id);
+    if (current === null) {
+        throw new InputError(`${functionName}: unknown job '${input.id}'.`, {
+            code: ErrorCode.OperationHandleUnknown,
+            context: { function: functionName, field: 'input.id', id: input.id },
+        });
+    }
+    if (current.state === 'completed' || current.state === 'failed' || current.state === 'cancelled')
+        return current;
+    return input.jobs.update(input.id, { state: 'cancelled', finishedAt: input.clock() });
+}
+//# sourceMappingURL=jobs.js.map

package/modules/workflows/dist/local/jobs.js.map

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

package/modules/workflows/dist/local/local-runner.d.ts

@@ -0,0 +1,39 @@
+/**
+ * The job-runner contract a transport composes (Stage 7A Decision 5/7): `submit` starts a job
+ * (a job-class operation in a worker, anything else inline), `cancel` stops one from any process
+ * through the shared store, `get` reads a record. `createLocalJobRunner` binds the file-backed
+ * runner in this package to one registry, one store directory, and one clock.
+ */
+import type { JobRecord } from '../stores.js';
+import type { OperationRegistry } from '../registry.js';
+import { type JobRun } from './jobs.js';
+import { type RegistryProfile } from './profiles.js';
+export interface JobSubmission {
+    /** The operation id. */
+    id: string;
+    input: unknown;
+    seed?: number;
+    requestId?: string;
+    maxInputBytes?: number;
+    deadlineMs?: number;
+    inlineResultBytes?: number;
+}
+/** What a transport needs from a job runner — structural, so a host can supply its own. */
+export interface JobRunner {
+    submit(submission: JobSubmission): JobRun;
+    cancel(id: string): JobRecord;
+    get(id: string): JobRecord | null;
+    list(): JobRecord[];
+}
+export interface LocalJobRunnerInput {
+    registry: OperationRegistry;
+    /** The store directory (absolute) jobs, artifacts, and workers share. */
+    directory: string;
+    /** The profile the worker rebuilds the registry from — it must produce the same set as `registry`. */
+    profile: RegistryProfile;
+    packs?: readonly string[];
+    clock: () => string;
+    pollMs?: number;
+}
+export declare function createLocalJobRunner(rawInput: LocalJobRunnerInput): JobRunner;
+//# sourceMappingURL=local-runner.d.ts.map

package/modules/workflows/dist/local/local-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-runner.d.ts","sourceRoot":"","sources":["../../src/local/local-runner.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,EAAwB,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAExE,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,2FAA2F;AAC3F,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,UAAU,EAAE,aAAa,GAAG,MAAM,CAAC;IAC1C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IAClC,IAAI,IAAI,SAAS,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAC;IAClB,sGAAsG;IACtG,OAAO,EAAE,eAAe,CAAC;IACzB,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,KAAK,EAAE,MAAM,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAuFD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,SAAS,CAsC7E"}

package/modules/workflows/dist/local/local-runner.js

@@ -0,0 +1,102 @@
+/// <reference types="node" />
+/**
+ * The job-runner contract a transport composes (Stage 7A Decision 5/7): `submit` starts a job
+ * (a job-class operation in a worker, anything else inline), `cancel` stops one from any process
+ * through the shared store, `get` reads a record. `createLocalJobRunner` binds the file-backed
+ * runner in this package to one registry, one store directory, and one clock.
+ */
+import { isAbsolute } from 'node:path';
+import { ErrorCode, InputError } from '../../../core/dist/index.js';
+import { createFileArtifactStore, createFileJobStore } from './file-stores.js';
+import { cancelJob, submitJob } from './jobs.js';
+import { REGISTRY_PROFILES } from './profiles.js';
+/** A runner over the file stores in `directory`, for the `totalfinance-http` binary and any host that wants the same. */
+const RUNNER_KEYS = ['registry', 'directory', 'profile', 'packs', 'clock', 'pollMs'];
+function refuse(message, field, code = ErrorCode.InputWrongType) {
+    throw new InputError(`createLocalJobRunner: ${message}`, {
+        code,
+        context: { function: 'createLocalJobRunner', field },
+    });
+}
+function requireRunnerInput(input) {
+    if (input === null || typeof input !== 'object' || Array.isArray(input)) {
+        refuse('input must be an object ({ registry, directory, profile, packs?, clock, pollMs? }).', 'input');
+    }
+    for (const key of Object.keys(input)) {
+        if (!RUNNER_KEYS.includes(key)) {
+            refuse(`unknown field "${key}" in input. Allowed fields: ${RUNNER_KEYS.join(', ')}.`, 'input', ErrorCode.InputUnknownField);
+        }
+    }
+    const request = input;
+    const registry = request['registry'];
+    if (registry === null ||
+        typeof registry !== 'object' ||
+        ['list', 'get', 'require', 'describe', 'run', 'packs'].some((member) => typeof registry[member] !== 'function') ||
+        !Number.isSafeInteger(registry['size']) ||
+        registry['size'] < 0) {
+        refuse('input.registry must be an OperationRegistry ({ list, get, require, describe, run, packs, size }).', 'input.registry');
+    }
+    if (typeof request['directory'] !== 'string' || !isAbsolute(request['directory'])) {
+        refuse('input.directory must be an absolute path (the store directory jobs, artifacts, and workers share).', 'input.directory', typeof request['directory'] === 'string'
+            ? ErrorCode.InputWrongShape
+            : ErrorCode.InputWrongType);
+    }
+    if (typeof request['profile'] !== 'string' ||
+        !REGISTRY_PROFILES.includes(request['profile'])) {
+        refuse(`input.profile must be one of ${REGISTRY_PROFILES.join(', ')}.`, 'input.profile', typeof request['profile'] === 'string'
+            ? ErrorCode.InputInvalidEnum
+            : ErrorCode.InputWrongType);
+    }
+    if (request['packs'] !== undefined &&
+        (!Array.isArray(request['packs']) || request['packs'].some((name) => typeof name !== 'string'))) {
+        refuse('input.packs must be an array of pack names when present.', 'input.packs');
+    }
+    if (typeof request['clock'] !== 'function') {
+        refuse('input.clock must be a function returning an ISO-8601 instant.', 'input.clock');
+    }
+    if (request['pollMs'] !== undefined &&
+        !(Number.isSafeInteger(request['pollMs']) && request['pollMs'] > 0)) {
+        refuse('input.pollMs must be a positive safe integer when present.', 'input.pollMs', typeof request['pollMs'] === 'number' ? ErrorCode.InputOutOfRange : ErrorCode.InputWrongType);
+    }
+    return input;
+}
+export function createLocalJobRunner(rawInput) {
+    const input = requireRunnerInput(rawInput);
+    const jobs = createFileJobStore({ directory: input.directory });
+    const artifacts = createFileArtifactStore({ directory: input.directory });
+    return {
+        submit(submission) {
+            return submitJob({
+                registry: input.registry,
+                jobs,
+                artifacts,
+                directory: input.directory,
+                id: submission.id,
+                input: submission.input,
+                profile: input.profile,
+                ...(input.packs !== undefined ? { packs: input.packs } : {}),
+                clock: input.clock,
+                ...(submission.requestId !== undefined ? { jobId: submission.requestId } : {}),
+                ...(submission.seed !== undefined ? { seed: submission.seed } : {}),
+                ...(submission.maxInputBytes !== undefined
+                    ? { maxInputBytes: submission.maxInputBytes }
+                    : {}),
+                ...(submission.deadlineMs !== undefined ? { deadlineMs: submission.deadlineMs } : {}),
+                ...(submission.inlineResultBytes !== undefined
+                    ? { inlineResultBytes: submission.inlineResultBytes }
+                    : {}),
+                ...(input.pollMs !== undefined ? { pollMs: input.pollMs } : {}),
+            });
+        },
+        cancel(id) {
+            return cancelJob({ jobs, id, clock: input.clock });
+        },
+        get(id) {
+            return jobs.get(id);
+        },
+        list() {
+            return jobs.list();
+        },
+    };
+}
+//# sourceMappingURL=local-runner.js.map

package/modules/workflows/dist/local/local-runner.js.map

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

package/modules/workflows/dist/local/profiles.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Registry profiles (Stage 7A Decision 6): a named, exact selection of packs — the same registry a
+ * worker rebuilds by name, so a job runs against exactly the set its submitter saw.
+ */
+import { defaultPacks, type OperationPack, type OperationRegistry } from '../index.js';
+declare const PROFILE_PACKS: {
+    readonly default: typeof defaultPacks;
+    readonly options: () => OperationPack[];
+    readonly research: () => OperationPack[];
+    readonly strategies: () => OperationPack[];
+    readonly portfolio: () => OperationPack[];
+    readonly valuation: () => OperationPack[];
+    readonly backtesting: () => OperationPack[];
+    readonly scenarios: () => OperationPack[];
+    readonly full: () => OperationPack[];
+};
+export type RegistryProfile = keyof typeof PROFILE_PACKS;
+export declare const REGISTRY_PROFILES: readonly RegistryProfile[];
+/** The packs a profile selects — `full` is every shipped pack, the journey packs and the backtests included. */
+export declare function packsForProfile(profile: RegistryProfile): OperationPack[];
+/** The registry for a profile, optionally narrowed to named packs (`--packs a,b`). */
+export declare function registryForProfile(input: {
+    profile: RegistryProfile;
+    packs?: readonly string[];
+}): OperationRegistry;
+export {};
+//# sourceMappingURL=profiles.d.ts.map

package/modules/workflows/dist/local/profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../src/local/profiles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAGL,YAAY,EAYZ,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AAIrB,QAAA,MAAM,aAAa;;;;;;;;;;CAUT,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,aAAa,CAAC;AAEzD,eAAO,MAAM,iBAAiB,EAAE,SAAS,eAAe,EAEvD,CAAC;AAEF,gHAAgH;AAChH,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,aAAa,EAAE,CAWzE;AAED,sFAAsF;AACtF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,OAAO,EAAE,eAAe,CAAC;IACzB,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B,GAAG,iBAAiB,CAgDpB"}

package/modules/workflows/dist/local/profiles.js

@@ -0,0 +1,77 @@
+/**
+ * Registry profiles (Stage 7A Decision 6): a named, exact selection of packs — the same registry a
+ * worker rebuilds by name, so a job runs against exactly the set its submitter saw.
+ */
+import { ErrorCode, InputError } from '../../../core/dist/index.js';
+import { tradePack } from '../operations-trade.js';
+import { backtestPack, createOperationRegistry, defaultPacks, journeyPacks, optionsPack, researchPack, strategyPack, portfolioPack, valuationPack, scenarioPack, riskPack, performancePack, artifactPack, volatilityPack, } from '../index.js';
+// One selection registry: names and discovery descriptions (derived from these packs' titles)
+// cannot drift between transports. Profiles select operations; they NEVER grant capabilities.
+const PROFILE_PACKS = {
+    default: defaultPacks,
+    options: () => [optionsPack(), volatilityPack()],
+    research: () => [researchPack()],
+    strategies: () => [optionsPack(), strategyPack(), volatilityPack()],
+    portfolio: () => [portfolioPack(), riskPack(), performancePack(), artifactPack()],
+    valuation: () => [valuationPack()],
+    backtesting: () => [backtestPack(), performancePack(), artifactPack()],
+    scenarios: () => [scenarioPack(), artifactPack()],
+    full: () => [...defaultPacks(), ...journeyPacks(), backtestPack(), tradePack()],
+};
+export const REGISTRY_PROFILES = Object.freeze(Object.keys(PROFILE_PACKS));
+/** The packs a profile selects — `full` is every shipped pack, the journey packs and the backtests included. */
+export function packsForProfile(profile) {
+    if (typeof profile !== 'string' || !Object.hasOwn(PROFILE_PACKS, profile)) {
+        throw new InputError(`packsForProfile: profile must be one of ${REGISTRY_PROFILES.join(', ')}. Received ${JSON.stringify(profile)}.`, {
+            code: typeof profile === 'string' ? ErrorCode.InputInvalidEnum : ErrorCode.InputWrongType,
+            context: { function: 'packsForProfile', field: 'profile' },
+        });
+    }
+    return PROFILE_PACKS[profile]();
+}
+/** The registry for a profile, optionally narrowed to named packs (`--packs a,b`). */
+export function registryForProfile(input) {
+    const functionName = 'registryForProfile';
+    if (input === null || typeof input !== 'object' || Array.isArray(input)) {
+        throw new InputError(`${functionName}: input must be an object ({ profile, packs? }).`, {
+            code: ErrorCode.InputWrongType,
+            context: { function: functionName, field: 'input' },
+        });
+    }
+    for (const key of Object.keys(input)) {
+        if (key !== 'profile' && key !== 'packs') {
+            throw new InputError(`${functionName}: unknown field "${key}" in input. Allowed fields: profile, packs.`, {
+                code: ErrorCode.InputUnknownField,
+                context: { function: functionName, field: 'input', key },
+            });
+        }
+    }
+    const available = packsForProfile(input.profile);
+    if (input.packs === undefined)
+        return createOperationRegistry({ packs: available });
+    if (!Array.isArray(input.packs) || input.packs.some((name) => typeof name !== 'string')) {
+        throw new InputError(`${functionName}: packs must be an array of pack names when present.`, {
+            code: ErrorCode.InputWrongType,
+            context: { function: functionName, field: 'input.packs' },
+        });
+    }
+    const byName = new Map(available.map((pack) => [pack.name, pack]));
+    if (new Set(input.packs).size !== input.packs.length) {
+        throw new InputError(`${functionName}: packs must name each selected pack only once.`, {
+            code: ErrorCode.InputWrongShape,
+            context: { function: functionName, field: 'input.packs' },
+        });
+    }
+    const selected = input.packs.map((name) => {
+        const pack = byName.get(name);
+        if (!pack) {
+            throw new InputError(`${functionName}: pack '${name}' is not in the '${input.profile}' profile. Available: ${[...byName.keys()].join(', ')}.`, {
+                code: ErrorCode.InputInvalidEnum,
+                context: { function: functionName, field: 'input.packs', name },
+            });
+        }
+        return pack;
+    });
+    return createOperationRegistry({ packs: selected });
+}
+//# sourceMappingURL=profiles.js.map

package/modules/workflows/dist/local/profiles.js.map

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

package/modules/workflows/dist/operation-kit.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Shared helpers for operation bodies: the row cap every series operation applies before compute,
+ * and the composed object schema that lets an operation add knobs to a library input schema
+ * without re-declaring it (moved from `@insiderfinance/totalfinance-mcp` in Stage 7A — one home).
+ */
+import { type Schema } from '../../core/dist/schema/index.js';
+export declare const MAX_ROWS = 5000;
+export declare function capRows<Rows extends readonly unknown[]>(rows: Rows, field: string, operationId: string, max?: number): Rows;
+export declare function extendObjectSchema<B, E>(base: Schema<B>, extension: Schema<E>): Schema<B & E>;
+//# sourceMappingURL=operation-kit.d.ts.map

package/modules/workflows/dist/operation-kit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-kit.d.ts","sourceRoot":"","sources":["../src/operation-kit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAIL,KAAK,MAAM,EAIZ,MAAM,iCAA2B,CAAC;AAKnC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAE7B,wBAAgB,OAAO,CAAC,IAAI,SAAS,SAAS,OAAO,EAAE,EACrD,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,GAAG,GAAE,MAAiB,GACrB,IAAI,CA2CN;AA0JD,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAS7F"}