@looprun-ai/mastra 0.2.0 → 0.4.0

package/dist/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAY,MAAM,kBAAkB,CAAC;AAE5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,WAAW,UAAU;IACzB,cAAc,CAAC,GAAG,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,GAAG;QAAE,OAAO,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC/G,aAAa,CAAC,GAAG,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACnH;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,GAAG,UAAU,CAmCvF;AAED;;;;;GAKG;AAEH,wBAAgB,oBAAoB,CAAC,EAAE,KAAK,EAAE,EAAE,GAAG,GAAG,OAAO,CAU5D;AAED,gGAAgG;AAChG,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,SAAS,EACf,UAAU,EAAE,eAAe,GAE1B,GAAG,EAAE,GAAG,SAAS,CAcnB"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAY,MAAM,kBAAkB,CAAC;AAE5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,WAAW,UAAU;IACzB,cAAc,CAAC,GAAG,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,GAAG;QAAE,OAAO,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC/G,aAAa,CAAC,GAAG,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACnH;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,GAAG,UAAU,CAyCvF;AAED;;;;;GAKG;AAEH,wBAAgB,oBAAoB,CAAC,EAAE,KAAK,EAAE,EAAE,GAAG,GAAG,OAAO,CAU5D;AAED,gGAAgG;AAChG,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,SAAS,EACf,UAAU,EAAE,eAAe,GAE1B,GAAG,EAAE,GAAG,SAAS,CAcnB"}

package/dist/hooks.js

@@ -6,12 +6,17 @@
  * fed by `hooks.afterToolCall`. Mastra applies hooks to ALL tool sources (assigned, toolsets,
  * client, MCP), so guards also govern native/MCP tools with zero extra wiring.
  */
-import { evaluatePreTool, evaluateOnInput, enforcePostTool, isTerminal, recordToolResult, resolveGuards } from '@looprun-ai/core';
+import { evaluatePreTool, evaluateOnInput, enforcePostTool, isTerminal, recordTerminalCall, recordToolResult, resolveGuards } from '@looprun-ai/core';
 export function makeGuardHooks(spec, getSession) {
     return {
         async beforeToolCall({ toolName, input }) {
-            if (isTerminal(toolName))
+            if (isTerminal(toolName)) {
+                // SYNCHRONOUS segment (no await above): record the terminal call at HOOK time so a same-step
+                // sibling call's preTool checks can see it — see recordTerminalCall's doc for the concurrency
+                // rationale. The terminal tool's execute captures the reply text and does NOT push again.
+                recordTerminalCall(getSession().ledger, toolName, (input ?? {}));
                 return undefined;
+            }
             const session = getSession();
             const args = (input ?? {});
             const verdict = await evaluatePreTool(spec, session.ledger, session.world, toolName, args);

package/dist/hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAUtJ,MAAM,UAAU,cAAc,CAAC,IAAe,EAAE,UAA2B;IACzE,OAAO;QACL,KAAK,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE;YACtC,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACzB,6FAA6F;gBAC7F,8FAA8F;gBAC9F,0FAA0F;gBAC1F,kBAAkB,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,IAAI,EAAE,CAA4B,CAAC,CAAC;gBAC5F,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,CAAC,KAAK,IAAI,EAAE,CAA4B,CAAC;YACtD,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;YAC3F,IAAI,OAAO,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;gBAC/B,OAAO,EAAE,OAAO,EAAE,KAAc,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YACxF,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,KAAK,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE;YAC7C,IAAI,UAAU,CAAC,QAAQ,CAAC;gBAAE,OAAO;YACjC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;YAC7B,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;YAClC,MAAM,IAAI,GAAG,CAAC,KAAK,IAAI,EAAE,CAA4B,CAAC;YACtD,gBAAgB,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YACjD,gGAAgG;YAChG,iGAAiG;YACjG,iGAAiG;YACjG,kGAAkG;YAClG,8FAA8F;YAC9F,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM;gBAAE,OAAO;YAC1C,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACjE,IAAI,CAAC,UAAU,CAAC,MAAM;gBAAE,OAAO;YAC/B,MAAM,IAAI,GAAa;gBACrB,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS;gBACnF,mBAAmB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM;aACxD,CAAC;YACF,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,eAAe,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YAC5E,IAAI,WAAW,CAAC,MAAM;gBAAE,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;YACpE,IAAI,UAAU,CAAC,MAAM;gBAAE,MAAM,CAAC,kBAAkB,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;QACvE,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,8DAA8D;AAC9D,MAAM,UAAU,oBAAoB,CAAC,EAAE,KAAK,EAAO;IACjD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;QAC9B,KAAK,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,CAAC;YACrC,MAAM,GAAG,GAAG,CAAC,EAAE,CAAC,QAAQ,IAAI,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YAC7F,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC/B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,mBAAmB,CACjC,IAAe,EACf,UAA2B;IAG3B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM;QAAE,OAAO,SAAS,CAAC;IACnD,OAAO;QACL;YACE,EAAE,EAAE,iBAAiB;YACrB,8DAA8D;YAC9D,KAAK,CAAC,YAAY,CAAC,CAAM;gBACvB,MAAM,OAAO,GAAmB,UAAU,EAAE,CAAC;gBAC7C,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;gBAC1E,IAAI,MAAM;oBAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBAC5B,OAAO,CAAC,CAAC,QAAQ,CAAC;YACpB,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/testing/fake-llm.d.ts

@@ -0,0 +1,27 @@
+/**
+ * A script-driven LanguageModelV3 mock: each LLM call pops the next scripted step.
+ *
+ * Wraps `MockLanguageModelV3` from `ai/test` (the `ai` package is already a peer dependency of this
+ * backend). A `ScriptStep` is one LLM response: a list of tool-calls and/or text parts.
+ * `scriptedModel(script)` returns a model whose Nth generate() emits the Nth step (the last step repeats
+ * once the script is exhausted), plus `calls()` and the raw `received` options for prompt inspection.
+ * `fakeLLM` is a friendly alias.
+ */
+import { MockLanguageModelV3 } from 'ai/test';
+export type ScriptPart = {
+    tool: string;
+    args: Record<string, unknown>;
+} | {
+    text: string;
+};
+export type ScriptStep = ScriptPart[];
+export interface ScriptedModel {
+    model: MockLanguageModelV3;
+    calls: () => number;
+    /** The raw call options seen by the model (prompt inspection). */
+    received: any[];
+}
+export declare function scriptedModel(script: ScriptStep[]): ScriptedModel;
+/** Friendly alias for {@link scriptedModel}. */
+export declare const fakeLLM: typeof scriptedModel;
+//# sourceMappingURL=fake-llm.d.ts.map

package/dist/testing/fake-llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-llm.d.ts","sourceRoot":"","sources":["../../src/testing/fake-llm.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAE9C,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAC5F,MAAM,MAAM,UAAU,GAAG,UAAU,EAAE,CAAC;AAEtC,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,mBAAmB,CAAC;IAC3B,KAAK,EAAE,MAAM,MAAM,CAAC;IACpB,kEAAkE;IAElE,QAAQ,EAAE,GAAG,EAAE,CAAC;CACjB;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,aAAa,CAuDjE;AAED,gDAAgD;AAChD,eAAO,MAAM,OAAO,sBAAgB,CAAC"}

package/dist/testing/fake-llm.js

@@ -0,0 +1,66 @@
+/**
+ * A script-driven LanguageModelV3 mock: each LLM call pops the next scripted step.
+ *
+ * Wraps `MockLanguageModelV3` from `ai/test` (the `ai` package is already a peer dependency of this
+ * backend). A `ScriptStep` is one LLM response: a list of tool-calls and/or text parts.
+ * `scriptedModel(script)` returns a model whose Nth generate() emits the Nth step (the last step repeats
+ * once the script is exhausted), plus `calls()` and the raw `received` options for prompt inspection.
+ * `fakeLLM` is a friendly alias.
+ */
+import { MockLanguageModelV3 } from 'ai/test';
+export function scriptedModel(script) {
+    let call = 0;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const received = [];
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const next = (options) => {
+        received.push(options);
+        const step = script[Math.min(call, script.length - 1)] ?? [{ text: '' }];
+        call++;
+        let id = 0;
+        const content = step.map((p) => 'text' in p
+            ? { type: 'text', text: p.text }
+            : {
+                type: 'tool-call',
+                toolCallId: `c${call}-${id++}`,
+                toolName: p.tool,
+                input: JSON.stringify(p.args),
+            });
+        const finishReason = step.some((p) => 'tool' in p) ? 'tool-calls' : 'stop';
+        return { content, finishReason, usage: { inputTokens: 1, outputTokens: 1, totalTokens: 2 }, warnings: [] };
+    };
+    const model = new MockLanguageModelV3({
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        doGenerate: (async (options) => next(options)),
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        doStream: async (options) => {
+            const r = next(options);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const parts = [{ type: 'stream-start', warnings: [] }];
+            let t = 0;
+            for (const c of r.content) {
+                if (c.type === 'text') {
+                    const tid = `t${++t}`;
+                    parts.push({ type: 'text-start', id: tid }, { type: 'text-delta', id: tid, delta: c.text }, { type: 'text-end', id: tid });
+                }
+                else {
+                    parts.push(c);
+                }
+            }
+            parts.push({ type: 'finish', finishReason: r.finishReason, usage: r.usage });
+            return {
+                stream: new ReadableStream({
+                    start(controller) {
+                        for (const p of parts)
+                            controller.enqueue(p);
+                        controller.close();
+                    },
+                }),
+            };
+        },
+    });
+    return { model, calls: () => call, received };
+}
+/** Friendly alias for {@link scriptedModel}. */
+export const fakeLLM = scriptedModel;
+//# sourceMappingURL=fake-llm.js.map

package/dist/testing/fake-llm.js.map

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

package/dist/testing/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @looprun-ai/mastra `/testing` — the backend half of the shippable, domain-NEUTRAL testing kit.
+ *
+ * The fake LLM (scripted model) + the full-loop (L3) proof runners that drive a real
+ * runSpecConversation. Pair with `@looprun-ai/core/testing` (the fixture world + proof format + L1
+ * runner + spec builders) for the complete guard-proof harness.
+ */
+export * from './fake-llm.js';
+export * from './proof-loop.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC"}

package/dist/testing/index.js

@@ -0,0 +1,10 @@
+/**
+ * @looprun-ai/mastra `/testing` — the backend half of the shippable, domain-NEUTRAL testing kit.
+ *
+ * The fake LLM (scripted model) + the full-loop (L3) proof runners that drive a real
+ * runSpecConversation. Pair with `@looprun-ai/core/testing` (the fixture world + proof format + L1
+ * runner + spec builders) for the complete guard-proof harness.
+ */
+export * from './fake-llm.js';
+export * from './proof-loop.js';
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC"}

package/dist/testing/proof-loop.d.ts

@@ -0,0 +1,16 @@
+import type { GuardProof, ProofLoopCase } from '@looprun-ai/core/testing';
+import type { AgentSpec, RunResult, RuntimeTurnRecord } from '@looprun-ai/core';
+/** L3 — drive the full runSpecConversation loop for a proof's loop case. The fixture theme rides on the
+ *  spec (set by the core spec builders); `redrives` is overridable (default 1). The runtime's fixed
+ *  veto-storm limit never trips these single-veto scripts. */
+export declare function runProofLoop(spec: AgentSpec, l3: ProofLoopCase, redrives?: number): Promise<RunResult>;
+/** The `recoveryEvents` tag we expect this proof's loop case to emit ('' for a clean pass). */
+export declare function expectedSignal(proof: GuardProof, l3: ProofLoopCase): string;
+/** Pick the turnRecord a loop case asserts on (l3.turn, default the last). */
+export declare function pickRecord(res: RunResult, l3: ProofLoopCase): RuntimeTurnRecord | undefined;
+/** Assert the expected signal is present in a turnRecord's recoveryEvents. Returns a verdict + detail. */
+export declare function assertSignal(record: RuntimeTurnRecord | undefined, proof: GuardProof, l3: ProofLoopCase): {
+    ok: boolean;
+    detail: string;
+};
+//# sourceMappingURL=proof-loop.d.ts.map

package/dist/testing/proof-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proof-loop.d.ts","sourceRoot":"","sources":["../../src/testing/proof-loop.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAIhF;;8DAE8D;AAC9D,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,aAAa,EAAE,QAAQ,SAAI,GAAG,OAAO,CAAC,SAAS,CAAC,CAQjG;AAED,+FAA+F;AAC/F,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,aAAa,GAAG,MAAM,CAkB3E;AAED,8EAA8E;AAC9E,wBAAgB,UAAU,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE,aAAa,GAAG,iBAAiB,GAAG,SAAS,CAG3F;AAED,0GAA0G;AAC1G,wBAAgB,YAAY,CAC1B,MAAM,EAAE,iBAAiB,GAAG,SAAS,EACrC,KAAK,EAAE,UAAU,EACjB,EAAE,EAAE,aAAa,GAChB;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAUjC"}

package/dist/testing/proof-loop.js

@@ -0,0 +1,67 @@
+/**
+ * The full-loop (L3) proof runners for the testing kit — the half that needs a framework backend.
+ *
+ * Each runner drives a real {@link runSpecConversation} loop: the {@link fakeLLM} scripted model against a
+ * fresh {@link FixtureWorld}, on a spec built by the core kit ({@link buildIsolatedSpec} /
+ * {@link buildCollectiveSpec}, which set the fixture theme). It then asserts the expected `recoveryEvents`
+ * SIGNAL — the tag the runtime emits when a guard fires.
+ *
+ * recoveryEvents tag formats (from the @looprun-ai/core runtime): preTool veto `${dim}:${kind}:${tool}`,
+ * onInput refusal `onInput:${kind}`, postTool report `output:${kind}:${tool}`, onReply redrive
+ * `redrive:${kind}`, exhaustion `exhaustion-terminal`.
+ */
+import { requireMake } from '@looprun-ai/core/testing';
+import { FixtureWorld, FIXTURE_TOOL_DEFS } from '@looprun-ai/core/testing';
+import { runSpecConversation } from '../run-conversation.js';
+import { fakeLLM } from './fake-llm.js';
+/** L3 — drive the full runSpecConversation loop for a proof's loop case. The fixture theme rides on the
+ *  spec (set by the core spec builders); `redrives` is overridable (default 1). The runtime's fixed
+ *  veto-storm limit never trips these single-veto scripts. */
+export function runProofLoop(spec, l3, redrives = 1) {
+    return runSpecConversation(spec, l3.turns, {
+        model: fakeLLM(l3.script).model,
+        modelParams: {},
+        world: new FixtureWorld(l3.preset),
+        toolDefs: FIXTURE_TOOL_DEFS,
+        redrives,
+    });
+}
+/** The `recoveryEvents` tag we expect this proof's loop case to emit ('' for a clean pass). */
+export function expectedSignal(proof, l3) {
+    const kind = proof.guard;
+    const tool = l3.tool ?? (Array.isArray(proof.target) ? proof.target[0] ?? '' : '');
+    switch (l3.expect) {
+        case 'veto': {
+            const dim = requireMake(proof)().dim;
+            return `${dim}:${kind}:${tool}`;
+        }
+        case 'redrive':
+            // A postTool result invariant reports via `output:${kind}:${tool}` (then joins the redrive set);
+            // an onReply guard redrives via `redrive:${kind}`.
+            return proof.hook === 'postTool' ? `output:${kind}:${tool}` : `redrive:${kind}`;
+        case 'refusal':
+            return `onInput:${kind}`;
+        case 'pass':
+        default:
+            return '';
+    }
+}
+/** Pick the turnRecord a loop case asserts on (l3.turn, default the last). */
+export function pickRecord(res, l3) {
+    const idx = l3.turn ?? res.turnRecords.length - 1;
+    return res.turnRecords[idx];
+}
+/** Assert the expected signal is present in a turnRecord's recoveryEvents. Returns a verdict + detail. */
+export function assertSignal(record, proof, l3) {
+    if (!record)
+        return { ok: false, detail: 'no turnRecord to assert on' };
+    const events = record.recoveryEvents ?? [];
+    if (l3.expect === 'pass') {
+        const ok = events.length === 0;
+        return { ok, detail: ok ? 'clean pass (no recovery events)' : `expected no recovery events, got: [${events.join(', ')}]` };
+    }
+    const sig = expectedSignal(proof, l3);
+    const ok = events.includes(sig);
+    return { ok, detail: ok ? `found '${sig}'` : `expected '${sig}' in recoveryEvents, got: [${events.join(', ')}]` };
+}
+//# sourceMappingURL=proof-loop.js.map

package/dist/testing/proof-loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proof-loop.js","sourceRoot":"","sources":["../../src/testing/proof-loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC;;8DAE8D;AAC9D,MAAM,UAAU,YAAY,CAAC,IAAe,EAAE,EAAiB,EAAE,QAAQ,GAAG,CAAC;IAC3E,OAAO,mBAAmB,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,EAAE;QACzC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,KAAK;QAC/B,WAAW,EAAE,EAAE;QACf,KAAK,EAAE,IAAI,YAAY,CAAC,EAAE,CAAC,MAAM,CAAC;QAClC,QAAQ,EAAE,iBAAiB;QAC3B,QAAQ;KACT,CAAC,CAAC;AACL,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,cAAc,CAAC,KAAiB,EAAE,EAAiB;IACjE,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC;IACzB,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACnF,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC;QAClB,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,GAAG,GAAG,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC;YACrC,OAAO,GAAG,GAAG,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;QAClC,CAAC;QACD,KAAK,SAAS;YACZ,iGAAiG;YACjG,mDAAmD;YACnD,OAAO,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC;QAClF,KAAK,SAAS;YACZ,OAAO,WAAW,IAAI,EAAE,CAAC;QAC3B,KAAK,MAAM,CAAC;QACZ;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,UAAU,CAAC,GAAc,EAAE,EAAiB;IAC1D,MAAM,GAAG,GAAG,EAAE,CAAC,IAAI,IAAI,GAAG,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;IAClD,OAAO,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;AAC9B,CAAC;AAED,0GAA0G;AAC1G,MAAM,UAAU,YAAY,CAC1B,MAAqC,EACrC,KAAiB,EACjB,EAAiB;IAEjB,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,4BAA4B,EAAE,CAAC;IACxE,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,IAAI,EAAE,CAAC;IAC3C,IAAI,EAAE,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QACzB,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;QAC/B,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,iCAAiC,CAAC,CAAC,CAAC,sCAAsC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7H,CAAC;IACD,MAAM,GAAG,GAAG,cAAc,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACtC,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAChC,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,CAAC,aAAa,GAAG,8BAA8B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;AACpH,CAAC"}

package/dist/world-adapters.d.ts

@@ -7,7 +7,7 @@
  * `theme.stateBlock`. A `StateView` supplies those reads; `refresh` (if given) runs at each
  * turn boundary so remote state can be re-fetched.
  *
- * Ledger-based guards (requiresBefore, noDuplicateCall, confirmFirst, maxCallsPerTurn, …) need
+ * Ledger-based guards (requiresBefore, noDuplicateCall, confirmFirst, maxCalls, …) need
  * NO state view — they read the observed ledger the hooks feed.
  */
 import type { AgentWorld } from '@looprun-ai/core';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@looprun-ai/mastra",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "type": "module",
   "description": "looprun on Mastra: LoopRunAgent — a genuine @mastra/core Agent compiled from an AgentSpec, with deterministic guard enforcement (beforeToolCall veto), the terminal protocol, bounded no-tools redrive and honest-abstain exhaustion. Studio-compatible.",
   "keywords": [
@@ -28,6 +28,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "default": "./dist/testing/index.js"
     }
   },
   "files": [
@@ -37,7 +41,7 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@looprun-ai/core": "^0.2.0"
+    "@looprun-ai/core": "^0.4.0"
   },
   "peerDependencies": {
     "@mastra/core": "^1.42.0",
@@ -50,11 +54,13 @@
     "ai": "^6.0.184",
     "typescript": "^5.7.0",
     "vitest": "^2.0.0",
-    "zod": "^3.24.0"
+    "zod": "^3.24.0",
+    "@looprun-ai/models": "^0.4.0"
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
     "typecheck": "tsc --noEmit",
-    "test": "vitest run"
+    "test": "vitest run",
+    "test:proofs": "vitest run test/proofs --passWithNoTests"
   }
 }