@actuarial-ts/agents 0.1.0

package/dist/judgment.js

@@ -0,0 +1,247 @@
+/**
+ * Judgment gates that write the compliance ledger: the generalization of the
+ * ActNG server's derive-expected-losses workflow (cap -> restoration ->
+ * trends -> ELR) into a factory any host can point at its own gate list.
+ *
+ * The loop each gate enforces is propose -> justify -> approve -> record:
+ * the gate gathers evidence and SUSPENDS with a recommendation; a human
+ * decides; the resume payload carries the decision plus a VERBATIM rationale;
+ * the gate applies the decision and appends the resulting assumptions to an
+ * @actuarial-ts/compliance ledger threaded through the workflow state. A
+ * completed chain returns { trail, ledger } - a ledger ready to hand straight
+ * to generateDisclosure, so ASOP 41 documentation falls out of running the
+ * analysis instead of being reconstructed afterwards.
+ *
+ * Ground truth (verified against @mastra/core 1.49 dist types and a live
+ * suspend/resume probe):
+ * - Steps execute as ({ inputData, resumeData, suspend, requestContext });
+ *   suspend(payload) pauses the run with the payload surfaced under
+ *   result.steps[stepId].suspendPayload; run.resume({ step, resumeData,
+ *   requestContext }) re-executes the step with resumeData set.
+ * - Resume data is validated against the gate's resumeSchema by Mastra
+ *   itself; run.resume REJECTS on schema violations. The chain additionally
+ *   rejects blank rationales at runtime (AgentsError MISSING_RATIONALE), so a
+ *   host schema of plain z.string() cannot smuggle undocumented judgment.
+ * - Suspend/resume requires snapshot storage: hosts register the returned
+ *   workflow on their Mastra instance (new Mastra({ workflows: { chain } })),
+ *   which provides in-memory storage by default and durable storage when
+ *   configured - exactly how the server keeps paused derivations resumable
+ *   across restarts.
+ *
+ * Purity: the package never reads a clock. The host supplies now() and every
+ * ledger timestamp comes from it.
+ *
+ * Tenant seam: the tenant id travels in the workflow requestContext, never in
+ * step inputs - the same boundary as every actuarial tool.
+ */
+import { createStep, createWorkflow } from "@mastra/core/workflows";
+import { z } from "zod";
+import { createLedger, recordAssumption, } from "@actuarial-ts/compliance";
+import { AgentsError } from "./errors.js";
+import { zodObjectShape } from "./tools.js";
+// ---------------------------------------------------------------------------
+// Chain state threaded through step outputs
+const trailEntrySchema = z.object({
+    stage: z.string(),
+    decision: z.string(),
+    rationale: z.string(),
+    skipped: z.boolean(),
+});
+// Declares EVERY AssumptionEntry field: zod strips undeclared keys on parse,
+// and losing previousValue/source between steps would corrupt the ledger.
+const ledgerEntrySchema = z.object({
+    seq: z.number().int().positive(),
+    timestamp: z.string(),
+    actor: z.enum(["default", "actuary", "agent"]),
+    field: z.string(),
+    value: z.unknown(),
+    previousValue: z.unknown().optional(),
+    source: z.string().optional(),
+    rationale: z.string().optional(),
+});
+const chainStateSchema = z.object({
+    trail: z.array(trailEntrySchema).default([]),
+    ledgerEntries: z.array(ledgerEntrySchema).default([]),
+    decisions: z.record(z.unknown()).default({}),
+});
+const suspendSchema = z.object({
+    stage: z.string(),
+    recommendation: z.string(),
+    evidence: z.unknown(),
+});
+const chainInputSchema = z.object({});
+const chainResultSchema = z.object({
+    trail: z.array(trailEntrySchema),
+    ledger: z.custom((value) => typeof value === "object" &&
+        value !== null &&
+        Array.isArray(value.entries)),
+});
+/**
+ * The first gate receives the workflow input ({}), and snapshot storage may
+ * round-trip state through JSON, so normalize defensively instead of trusting
+ * zod defaults to have been applied.
+ */
+function normalizeState(input) {
+    const raw = (input ?? {});
+    return {
+        trail: Array.isArray(raw.trail) ? raw.trail : [],
+        ledgerEntries: Array.isArray(raw.ledgerEntries) ? raw.ledgerEntries : [],
+        decisions: typeof raw.decisions === "object" && raw.decisions !== null ? raw.decisions : {},
+    };
+}
+/** Trail text for a decision when applyDecision returns no summary. */
+function describeDecision(decision) {
+    if (typeof decision === "object" && decision !== null) {
+        const named = decision.decision;
+        if (typeof named === "string" && named.length > 0)
+            return named;
+        const { rationale: _rationale, actor: _actor, ...rest } = decision;
+        if (Object.keys(rest).length > 0)
+            return JSON.stringify(rest);
+    }
+    return "decided";
+}
+function actorOf(decision) {
+    const actor = decision?.actor;
+    return actor === "agent" || actor === "default" || actor === "actuary" ? actor : "actuary";
+}
+// ---------------------------------------------------------------------------
+// Factory
+/** Reserved id of the terminal step that assembles { trail, ledger }. */
+const COMPLETE_STEP_ID = "complete";
+/**
+ * Builds a committed Mastra workflow from an ordered gate list. Each gate:
+ * skipWhen? -> pass through with a trail note; else gatherEvidence ->
+ * suspend({ stage, recommendation, evidence }); on resume -> validate the
+ * decision (schema + non-blank rationale), applyDecision, append the
+ * resulting assumptions to the threaded ledger. The terminal step rebuilds
+ * the frozen ledger, invokes onComplete, and returns { trail, ledger }.
+ *
+ * FOOTGUN (learned the hard way): a Mastra Workflow exposes a .then(step)
+ * builder method, which makes it an ACCIDENTAL THENABLE. Never await the
+ * returned workflow and never return it from an async function - JS will
+ * call .then(resolve, reject) with the promise resolver as a "step" and the
+ * promise never settles. Assign it synchronously and register it on your
+ * Mastra instance.
+ */
+export function createJudgmentChain(options) {
+    const { id, gates, now, onComplete, requestContextSchema } = options;
+    if (gates.length === 0) {
+        throw new AgentsError("BAD_GATE", `Judgment chain "${id}" needs at least one gate`);
+    }
+    const seen = new Set();
+    for (const gate of gates) {
+        if (gate.id === COMPLETE_STEP_ID) {
+            throw new AgentsError("BAD_GATE", `Gate id "${COMPLETE_STEP_ID}" is reserved for the chain's terminal step`);
+        }
+        if (seen.has(gate.id)) {
+            throw new AgentsError("BAD_GATE", `Duplicate gate id "${gate.id}" in chain "${id}"`);
+        }
+        seen.add(gate.id);
+        const shape = zodObjectShape(gate.resumeSchema);
+        if (!shape || !("rationale" in shape)) {
+            throw new AgentsError("BAD_GATE", `Gate "${gate.id}" resumeSchema must be a zod object containing a "rationale" key: every human decision enters the audit trail with its verbatim rationale`);
+        }
+    }
+    const gateSteps = gates.map((gate) => createStep({
+        id: gate.id,
+        inputSchema: chainStateSchema,
+        outputSchema: chainStateSchema,
+        suspendSchema,
+        resumeSchema: gate.resumeSchema,
+        execute: async ({ inputData, resumeData, suspend, requestContext }) => {
+            const state = normalizeState(inputData);
+            const ctx = {
+                requestContext,
+                now,
+                decisions: state.decisions,
+                trail: state.trail,
+            };
+            const skipReason = gate.skipWhen?.(ctx) ?? null;
+            if (skipReason !== null) {
+                const skip = { skipped: true, reason: skipReason };
+                return {
+                    trail: [
+                        ...state.trail,
+                        { stage: gate.stage, decision: "skipped", rationale: skipReason, skipped: true },
+                    ],
+                    ledgerEntries: state.ledgerEntries,
+                    decisions: { ...state.decisions, [gate.id]: skip },
+                };
+            }
+            if (resumeData === undefined) {
+                const { recommendation, evidence } = await gate.gatherEvidence(ctx);
+                await suspend({ stage: gate.stage, recommendation, evidence });
+                return state; // unreachable after suspend; satisfies the output type
+            }
+            const decision = resumeData;
+            const rationale = decision?.rationale;
+            if (typeof rationale !== "string" || rationale.trim() === "") {
+                throw new AgentsError("MISSING_RATIONALE", `Gate "${gate.id}" (${gate.stage}) resumed without a rationale; undocumented judgment is exactly what the ledger exists to prevent`);
+            }
+            const actor = actorOf(decision);
+            const applied = await gate.applyDecision(ctx, decision);
+            // recordAssumption is the single validator/freezer: replay the
+            // threaded entries into a ledger, append, and thread the plain
+            // entries array (snapshot storage may JSON round-trip state).
+            let ledger = { entries: state.ledgerEntries };
+            for (const entry of applied.ledgerEntries ?? []) {
+                ledger = recordAssumption(ledger, {
+                    field: entry.field,
+                    value: entry.value,
+                    ...(entry.previousValue !== undefined ? { previousValue: entry.previousValue } : {}),
+                    ...(entry.source !== undefined ? { source: entry.source } : {}),
+                    timestamp: entry.timestamp ?? now(),
+                    actor: entry.actor ?? actor,
+                    rationale: entry.rationale ?? rationale,
+                });
+            }
+            return {
+                trail: [
+                    ...state.trail,
+                    {
+                        stage: gate.stage,
+                        decision: applied.summary ?? describeDecision(decision),
+                        rationale,
+                        skipped: false,
+                    },
+                ],
+                ledgerEntries: [...ledger.entries],
+                decisions: { ...state.decisions, [gate.id]: decision },
+            };
+        },
+    }));
+    const completeStep = createStep({
+        id: COMPLETE_STEP_ID,
+        inputSchema: chainStateSchema,
+        outputSchema: chainResultSchema,
+        execute: async ({ inputData, requestContext }) => {
+            const state = normalizeState(inputData);
+            // Rebuild through recordAssumption so the returned ledger is frozen and
+            // seq-consistent even after a JSON round-trip through snapshot storage.
+            let ledger = createLedger();
+            for (const entry of state.ledgerEntries) {
+                const { seq: _seq, ...fresh } = entry;
+                ledger = recordAssumption(ledger, fresh);
+            }
+            const outcome = { trail: state.trail, ledger };
+            await onComplete?.(outcome, {
+                requestContext,
+                now,
+                decisions: state.decisions,
+                trail: state.trail,
+            });
+            return outcome;
+        },
+    });
+    let builder = createWorkflow({
+        id,
+        inputSchema: chainInputSchema,
+        outputSchema: chainResultSchema,
+        ...(requestContextSchema ? { requestContextSchema } : {}),
+    });
+    for (const step of gateSteps)
+        builder = builder.then(step);
+    return builder.then(completeStep).commit();
+}
+//# sourceMappingURL=judgment.js.map

package/dist/judgment.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Actuarial tool factory: Mastra createTool with the two hard guarantees the
+ * ActNG server proved in production, generalized for any host.
+ *
+ * 1. SECURITY SEAM. The tenant id (project id) ALWAYS comes from the
+ *    server-side request context, never from the model. tenantOf reads it;
+ *    defineActuarialTool REJECTS, at definition time, any input schema that
+ *    declares a tenant-id key - the model must not even be able to express
+ *    one. (Verified against @mastra/core 1.49: tools execute as
+ *    (inputData, context) with context.requestContext.get(key).)
+ *
+ * 2. ERROR CONTRACT. Tools never throw into the model. Anything the host's
+ *    execute throws is converted to { success: false, error: { code, message } }
+ *    so the agent can recover: retry with adjusted parameters, suggest an
+ *    alternative, or ask. Errors carrying a string code (the server's
+ *    HttpError, this package's AgentsError, compliance's ComplianceError)
+ *    keep their code; everything else gets the fallback.
+ */
+import type { z } from "zod";
+/** The uniform tool-failure shape: agents branch on success, hosts log code. */
+export type ToolEnvelopeFailure = {
+    success: false;
+    error: {
+        code: string;
+        message: string;
+    };
+};
+/**
+ * Converts anything thrown by a tool into the failure envelope. Never throws.
+ * Error-like values with a non-empty string "code" property (HttpError,
+ * AgentsError, ComplianceError) keep their code; everything else gets
+ * fallbackCode.
+ */
+export declare function envelopeFailure(err: unknown, fallbackCode?: string): ToolEnvelopeFailure;
+/**
+ * The structural slice of Mastra's ToolExecutionContext that the tenant seam
+ * needs. Typed structurally (not as the concrete Mastra type) so tests can
+ * pass a minimal object and hosts on any 1.49+ patch level are assignable.
+ */
+export interface TenantToolContext {
+    requestContext?: {
+        get(key: string): unknown;
+    };
+}
+/**
+ * Reads the tenant id from the server-set request context. Throws a typed
+ * AgentsError("NO_TENANT_CONTEXT") when absent, non-string, or empty; inside
+ * a defineActuarialTool execute the wrapper converts that throw into the
+ * failure envelope, so the model sees a recoverable error, never a crash.
+ */
+export declare function tenantOf(context: TenantToolContext | undefined, key?: string): string;
+/** Top-level shape keys of a zod object schema, or null when not an object schema. */
+export declare function zodObjectShape(schema: unknown): Record<string, unknown> | null;
+/** read = inspect/analyze only; action = mutates host state (drives client refresh). */
+export type ActuarialToolKind = "read" | "action";
+/**
+ * The execution context handed to an actuarial tool's execute. Structural on
+ * purpose: it is the slice of Mastra's ToolExecutionContext this package
+ * relies on, and tests exercise tools without booting an agent.
+ */
+export type ActuarialToolContext = TenantToolContext;
+export interface DefineActuarialToolOptions<TShape extends z.ZodRawShape, TResult> {
+    id: string;
+    description: string;
+    kind: ActuarialToolKind;
+    /**
+     * The model-facing input schema. MUST NOT contain a tenant-id key
+     * (projectId/tenantId in any casing) - defineActuarialTool throws
+     * AgentsError("TENANT_IN_SCHEMA") at definition time if it does.
+     */
+    inputSchema: z.ZodObject<TShape>;
+    /**
+     * The tool body. May throw freely (HttpError-style coded errors keep their
+     * code); the wrapper guarantees the model receives either the return value
+     * or a { success: false, error } envelope, never an exception.
+     */
+    execute: (input: z.infer<z.ZodObject<TShape>>, context: ActuarialToolContext) => Promise<TResult>;
+}
+/**
+ * Wraps Mastra's createTool with the envelope + tenant-seam guarantees and
+ * tags the result with its kind for toolRegistry classification.
+ */
+export declare function defineActuarialTool<TShape extends z.ZodRawShape, TResult>(options: DefineActuarialToolOptions<TShape, TResult>): import("@mastra/core/tools").Tool<z.objectUtil.addQuestionMarks<z.baseObjectOutputType<TShape>, any> extends infer T ? { [k in keyof T]: T[k]; } : never, unknown, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, string, unknown> & {
+    kind: ActuarialToolKind;
+};
+/** The minimal slice toolRegistry needs; every defineActuarialTool result satisfies it. */
+export interface RegistrableActuarialTool {
+    id: string;
+    kind: ActuarialToolKind;
+}
+export interface ActuarialToolRegistry<T extends RegistrableActuarialTool> {
+    /** Tools keyed by id, ready for new Agent({ tools }). */
+    tools: Record<string, T>;
+    /** Ids of state-mutating tools (the host client refreshes after these). */
+    actionToolIds: Set<string>;
+}
+/**
+ * Classifies a tool list into the shape hosts wire into their agent: a
+ * tools record keyed by id plus the action-tool id set that drives client
+ * refresh semantics (the generalization of the server's ACTION_TOOL_IDS).
+ */
+export declare function toolRegistry<T extends RegistrableActuarialTool>(tools: readonly T[]): ActuarialToolRegistry<T>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAM7B,gFAAgF;AAChF,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,YAAY,SAAe,GAAG,mBAAmB,CAkB9F;AAKD;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,cAAc,CAAC,EAAE;QAAE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;CAChD;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,EAAE,GAAG,SAAc,GAAG,MAAM,CAS1F;AASD,sFAAsF;AACtF,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAO9E;AAoFD,wFAAwF;AACxF,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAElD;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,iBAAiB,CAAC;AAErD,MAAM,WAAW,0BAA0B,CAAC,MAAM,SAAS,CAAC,CAAC,WAAW,EAAE,OAAO;IAC/E,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,iBAAiB,CAAC;IACxB;;;;OAIG;IACH,WAAW,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACjC;;;;OAIG;IACH,OAAO,EAAE,CACP,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EACnC,OAAO,EAAE,oBAAoB,KAC1B,OAAO,CAAC,OAAO,CAAC,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,SAAS,CAAC,CAAC,WAAW,EAAE,OAAO,EACvE,OAAO,EAAE,0BAA0B,CAAC,MAAM,EAAE,OAAO,CAAC;;EAyBrD;AAKD,2FAA2F;AAC3F,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC,SAAS,wBAAwB;IACvE,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACzB,2EAA2E;IAC3E,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,wBAAwB,EAC7D,KAAK,EAAE,SAAS,CAAC,EAAE,GAClB,qBAAqB,CAAC,CAAC,CAAC,CAc1B"}

package/dist/tools.js

@@ -0,0 +1,185 @@
+/**
+ * Actuarial tool factory: Mastra createTool with the two hard guarantees the
+ * ActNG server proved in production, generalized for any host.
+ *
+ * 1. SECURITY SEAM. The tenant id (project id) ALWAYS comes from the
+ *    server-side request context, never from the model. tenantOf reads it;
+ *    defineActuarialTool REJECTS, at definition time, any input schema that
+ *    declares a tenant-id key - the model must not even be able to express
+ *    one. (Verified against @mastra/core 1.49: tools execute as
+ *    (inputData, context) with context.requestContext.get(key).)
+ *
+ * 2. ERROR CONTRACT. Tools never throw into the model. Anything the host's
+ *    execute throws is converted to { success: false, error: { code, message } }
+ *    so the agent can recover: retry with adjusted parameters, suggest an
+ *    alternative, or ask. Errors carrying a string code (the server's
+ *    HttpError, this package's AgentsError, compliance's ComplianceError)
+ *    keep their code; everything else gets the fallback.
+ */
+import { createTool } from "@mastra/core/tools";
+import { AgentsError } from "./errors.js";
+/**
+ * Converts anything thrown by a tool into the failure envelope. Never throws.
+ * Error-like values with a non-empty string "code" property (HttpError,
+ * AgentsError, ComplianceError) keep their code; everything else gets
+ * fallbackCode.
+ */
+export function envelopeFailure(err, fallbackCode = "TOOL_ERROR") {
+    let code = fallbackCode;
+    let message = "Unknown error";
+    try {
+        const candidate = err?.code;
+        if (typeof candidate === "string" && candidate.length > 0)
+            code = candidate;
+        if (err instanceof Error) {
+            message = err.message;
+        }
+        else if (typeof err === "string" && err.length > 0) {
+            message = err;
+        }
+        else {
+            const msg = err?.message;
+            if (typeof msg === "string" && msg.length > 0)
+                message = msg;
+        }
+    }
+    catch {
+        // A hostile getter must not break the envelope; keep the fallbacks.
+    }
+    return { success: false, error: { code, message } };
+}
+/**
+ * Reads the tenant id from the server-set request context. Throws a typed
+ * AgentsError("NO_TENANT_CONTEXT") when absent, non-string, or empty; inside
+ * a defineActuarialTool execute the wrapper converts that throw into the
+ * failure envelope, so the model sees a recoverable error, never a crash.
+ */
+export function tenantOf(context, key = "projectId") {
+    const value = context?.requestContext?.get(key);
+    if (typeof value !== "string" || value.length === 0) {
+        throw new AgentsError("NO_TENANT_CONTEXT", `Tool invoked without a "${key}" in the request context; the host must set it server-side from the authenticated request, never from the model`);
+    }
+    return value;
+}
+/**
+ * Tenant-id keys a tool input schema may never declare. Case-insensitive and
+ * separator-tolerant (projectId, project_id, tenantId, TenantID, ...): the
+ * lint exists to make the security seam unexpressable, so it errs wide.
+ */
+const TENANT_KEY_PATTERN = /^(project|tenant)[_-]?id$/i;
+/** Top-level shape keys of a zod object schema, or null when not an object schema. */
+export function zodObjectShape(schema) {
+    if (typeof schema !== "object" || schema === null)
+        return null;
+    const def = schema._def;
+    if (def?.typeName !== "ZodObject")
+        return null;
+    const shape = schema.shape;
+    if (typeof shape !== "object" || shape === null)
+        return null;
+    return shape;
+}
+/**
+ * The recursive tenant-key lint behind defineActuarialTool. Walks every
+ * container the model could reach — nested objects, arrays, optional /
+ * nullable / default / effects wrappers, unions — and rejects:
+ * - any object key matching TENANT_KEY_PATTERN at any depth;
+ * - .passthrough() objects and non-never .catchall(...) (they let the model
+ *   smuggle arbitrary keys past the lint);
+ * - z.record(...) (dynamic string keys — same smuggling surface).
+ * Leaves (strings, numbers, enums, literals) end recursion. Anything with
+ * an unrecognized CONTAINER shape simply is not traversed further; the
+ * fail-closed top-level check in defineActuarialTool guarantees the root is
+ * an inspectable plain object.
+ */
+function assertNoTenantKeys(schema, toolId, path) {
+    if (typeof schema !== "object" || schema === null)
+        return;
+    const def = schema._def;
+    if (!def)
+        return;
+    const typeName = def.typeName;
+    if (typeName === "ZodObject") {
+        if (def.unknownKeys === "passthrough") {
+            throw new AgentsError("TENANT_IN_SCHEMA", `Tool "${toolId}": the object at "${path}" uses .passthrough(), which lets the model smuggle arbitrary keys (including tenant ids) past the seam; declare every key explicitly`);
+        }
+        const catchallType = def.catchall?._def?.typeName;
+        if (catchallType !== undefined && catchallType !== "ZodNever") {
+            throw new AgentsError("TENANT_IN_SCHEMA", `Tool "${toolId}": the object at "${path}" uses .catchall(...), which admits undeclared keys; declare every key explicitly`);
+        }
+        const shape = zodObjectShape(schema) ?? {};
+        for (const [key, value] of Object.entries(shape)) {
+            if (TENANT_KEY_PATTERN.test(key)) {
+                throw new AgentsError("TENANT_IN_SCHEMA", `Tool "${toolId}" declares input key "${path}.${key}": tenant ids travel only via the server-set RequestContext (read them with tenantOf), never through the model-facing input schema`);
+            }
+            assertNoTenantKeys(value, toolId, `${path}.${key}`);
+        }
+        return;
+    }
+    if (typeName === "ZodRecord") {
+        throw new AgentsError("TENANT_IN_SCHEMA", `Tool "${toolId}": the record at "${path}" admits arbitrary string keys (including tenant ids); use an explicit z.object shape`);
+    }
+    if (typeName === "ZodArray") {
+        assertNoTenantKeys(def.type, toolId, `${path}[]`);
+        return;
+    }
+    if (typeName === "ZodOptional" || typeName === "ZodNullable" || typeName === "ZodDefault") {
+        assertNoTenantKeys(def.innerType, toolId, path);
+        return;
+    }
+    if (typeName === "ZodEffects") {
+        assertNoTenantKeys(def.schema, toolId, path);
+        return;
+    }
+    if (typeName === "ZodUnion" || typeName === "ZodDiscriminatedUnion") {
+        for (const opt of def.options ?? [])
+            assertNoTenantKeys(opt, toolId, path);
+        return;
+    }
+}
+/**
+ * Wraps Mastra's createTool with the envelope + tenant-seam guarantees and
+ * tags the result with its kind for toolRegistry classification.
+ */
+export function defineActuarialTool(options) {
+    // FAIL CLOSED: a schema the seam cannot inspect is not definable, and the
+    // tenant-key lint recurses through every container the model could reach.
+    const shape = zodObjectShape(options.inputSchema);
+    if (!shape) {
+        throw new AgentsError("BAD_INPUT_SCHEMA", `Tool "${options.id}": inputSchema must be a plain z.object(...) the tenant seam can inspect; got a schema whose shape is unreadable`);
+    }
+    assertNoTenantKeys(options.inputSchema, options.id, "input");
+    const tool = createTool({
+        id: options.id,
+        description: options.description,
+        inputSchema: options.inputSchema,
+        execute: async (input, context) => {
+            try {
+                return await options.execute(input, context);
+            }
+            catch (err) {
+                return envelopeFailure(err);
+            }
+        },
+    });
+    return Object.assign(tool, { kind: options.kind });
+}
+/**
+ * Classifies a tool list into the shape hosts wire into their agent: a
+ * tools record keyed by id plus the action-tool id set that drives client
+ * refresh semantics (the generalization of the server's ACTION_TOOL_IDS).
+ */
+export function toolRegistry(tools) {
+    const record = {};
+    const actionToolIds = new Set();
+    for (const tool of tools) {
+        if (record[tool.id]) {
+            throw new AgentsError("DUPLICATE_TOOL_ID", `Two tools share the id "${tool.id}"; tool ids must be unique within a registry`);
+        }
+        record[tool.id] = tool;
+        if (tool.kind === "action")
+            actionToolIds.add(tool.id);
+    }
+    return { tools: record, actionToolIds };
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@actuarial-ts/agents",
+  "version": "0.1.0",
+  "description": "Mastra agent toolkit for the actuarial-ts SDK: typed actuarial tools with a hard tenant seam, human-gated judgment workflows that write the compliance assumption ledger, a reserving advisor factory, and a golden-prompt eval harness.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yerromnitsuj/actng.git",
+    "directory": "packages/agents"
+  },
+  "keywords": [
+    "actuarial",
+    "agents",
+    "mastra",
+    "ai",
+    "reserving",
+    "human-in-the-loop",
+    "tools"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prepack": "tsc -p tsconfig.build.json"
+  },
+  "dependencies": {
+    "@actuarial-ts/compliance": "^0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.5",
+    "@mastra/core": "^1.49.0",
+    "zod": "^3.25.76"
+  },
+  "peerDependencies": {
+    "@mastra/core": ">=1.49.0 <2",
+    "zod": "^3.25.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}