@cortexkit/opencode-magic-context 0.21.1 → 0.21.2

package/dist/hooks/magic-context/compartment-runner.d.ts

@@ -3,6 +3,14 @@ import type { CompartmentRunnerDeps } from "./compartment-runner-types";
 export interface ActiveCompartmentRun {
     promise: Promise<void>;
     published: boolean;
+    /**
+     * Set to true once the 95%-emergency user-facing notification has been
+     * dispatched for this run. Prevents the notification from re-firing on
+     * every subsequent transform pass while the same compartment run is
+     * still active — which would otherwise persist a fresh ignored user
+     * message every pass and drive OpenCode's runLoop break condition false.
+     */
+    notificationSent?: boolean;
 }
 export declare function getActiveCompartmentRun(sessionId: string): ActiveCompartmentRun | undefined;
 export declare function markActiveCompartmentRunPublished(sessionId: string): void;

package/dist/hooks/magic-context/compartment-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compartment-runner.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/compartment-runner.ts"],"names":[],"mappings":"AAGA,OAAO,EAEH,KAAK,kBAAkB,EAC1B,MAAM,qCAAqC,CAAC;AAE7C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAExE,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;CACtB;AAID,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAE3F;AAED,wBAAgB,iCAAiC,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAGzE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,4BAA4B,CACxC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GACvB,oBAAoB,CAetB;AAYD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,CA6BvE;AAED,MAAM,WAAW,2BAA2B;IACxC;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED,wBAAsB,oBAAoB,CACtC,IAAI,EAAE,qBAAqB,EAC3B,OAAO,GAAE,2BAAgC,GAC1C,OAAO,CAAC,MAAM,CAAC,CAuBjB;AAED,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,YAAY,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC"}
+{"version":3,"file":"compartment-runner.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/compartment-runner.ts"],"names":[],"mappings":"AAGA,OAAO,EAEH,KAAK,kBAAkB,EAC1B,MAAM,qCAAqC,CAAC;AAE7C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAExE,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAID,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAE3F;AAED,wBAAgB,iCAAiC,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAGzE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,4BAA4B,CACxC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GACvB,oBAAoB,CAetB;AAYD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,CA6BvE;AAED,MAAM,WAAW,2BAA2B;IACxC;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED,wBAAsB,oBAAoB,CACtC,IAAI,EAAE,qBAAqB,EAC3B,OAAO,GAAE,2BAAgC,GAC1C,OAAO,CAAC,MAAM,CAAC,CAuBjB;AAED,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,YAAY,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/hooks/magic-context/transform-compartment-phase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transform-compartment-phase.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/transform-compartment-phase.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,eAAe,EAAqB,MAAM,sCAAsC,CAAC;AAC/F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAYxD,OAAO,EACH,KAAK,4BAA4B,EAEpC,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAc1D,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAE/D;AAED,UAAU,uBAAuB;IAC7B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,EAAE;QAAE,qBAAqB,EAAE,OAAO,CAAA;KAAE,CAAC;IAChD,YAAY,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,MAAM,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IACjC,EAAE,EAAE,eAAe,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,2BAA2B,EAAE,4BAA4B,GAAG,IAAI,CAAC;IACjE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uBAAuB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,qBAAqB,CAAC,EAAE,MAAM,OAAO,6BAA6B,EAAE,kBAAkB,CAAC;IACvF,6EAA6E;IAC7E,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC,yFAAyF;IACzF,qCAAqC,CAAC,EAAE,OAAO,CAAC;IAChD,8BAA8B,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5C,yFAAyF;IACzF,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,0FAA0F;IAC1F,6BAA6B,CAAC,EAAE,OAAO,CAAC;IACxC,0EAA0E;IAC1E,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,+EAA+E;IAC/E,6BAA6B,CAAC,EAAE,OAAO,CAAC;IACxC,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,kFAAkF;IAClF,6BAA6B,CAAC,EAAE,MAAM,CAAC;IACvC,yFAAyF;IACzF,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,mEAAmE;IACnE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,uEAAuE;IACvE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,+FAA+F;IAC/F,2BAA2B,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7D;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC;IAC9E,2BAA2B,EAAE,4BAA4B,GAAG,IAAI,CAAC;IACjE,qBAAqB,EAAE,OAAO,CAAC;IAC/B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,sBAAsB,EAAE,OAAO,CAAC;IAChC,sBAAsB,EAAE,OAAO,CAAC;CACnC,CAAC,CA2QD"}
+{"version":3,"file":"transform-compartment-phase.d.ts","sourceRoot":"","sources":["../../../src/hooks/magic-context/transform-compartment-phase.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,eAAe,EAAqB,MAAM,sCAAsC,CAAC;AAC/F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAYxD,OAAO,EACH,KAAK,4BAA4B,EAEpC,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAc1D,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAE/D;AAED,UAAU,uBAAuB;IAC7B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,EAAE;QAAE,qBAAqB,EAAE,OAAO,CAAA;KAAE,CAAC;IAChD,YAAY,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,MAAM,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IACjC,EAAE,EAAE,eAAe,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,2BAA2B,EAAE,4BAA4B,GAAG,IAAI,CAAC;IACjE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uBAAuB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,qBAAqB,CAAC,EAAE,MAAM,OAAO,6BAA6B,EAAE,kBAAkB,CAAC;IACvF,6EAA6E;IAC7E,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC,yFAAyF;IACzF,qCAAqC,CAAC,EAAE,OAAO,CAAC;IAChD,8BAA8B,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5C,yFAAyF;IACzF,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,0FAA0F;IAC1F,6BAA6B,CAAC,EAAE,OAAO,CAAC;IACxC,0EAA0E;IAC1E,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,+EAA+E;IAC/E,6BAA6B,CAAC,EAAE,OAAO,CAAC;IACxC,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,kFAAkF;IAClF,6BAA6B,CAAC,EAAE,MAAM,CAAC;IACvC,yFAAyF;IACzF,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,mEAAmE;IACnE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,uEAAuE;IACvE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,+FAA+F;IAC/F,2BAA2B,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7D;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC;IAC9E,2BAA2B,EAAE,4BAA4B,GAAG,IAAI,CAAC;IACjE,qBAAqB,EAAE,OAAO,CAAC;IAC/B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,sBAAsB,EAAE,OAAO,CAAC;IAChC,sBAAsB,EAAE,OAAO,CAAC;CACnC,CAAC,CAyRD"}

package/dist/index.js

@@ -157007,7 +157007,10 @@ async function getSessionMessages(client, sessionId) {
   try {
     const c = client;
     if (typeof c.session?.messages === "function") {
-      const result = await c.session.messages({ path: { id: sessionId } });
+      const result = await c.session.messages({
+        path: { id: sessionId },
+        query: { limit: 50 }
+      });
       return result?.data ?? [];
     }
   } catch (error51) {
@@ -163695,7 +163698,7 @@ async function runHistorianPrompt(args) {
     }
     const messagesResponse = await client.session.messages({
       path: { id: agentSessionId },
-      query: { directory: sessionDirectory }
+      query: { directory: sessionDirectory, limit: 50 }
     });
     const messages = normalizeSDKResponse(messagesResponse, [], {
       preferResponseOnMissingData: true
@@ -165653,7 +165656,7 @@ async function runCompressorPass(args) {
     });
     const messagesResponse = await client.session.messages({
       path: { id: agentSessionId },
-      query: { directory }
+      query: { directory, limit: 50 }
     });
     const messages = normalizeSDKResponse(messagesResponse, [], {
       preferResponseOnMissingData: true
@@ -167265,7 +167268,7 @@ async function runSidekick(deps) {
     }, { timeoutMs: deps.config.timeout_ms, fallbackModels, callContext: "sidekick" });
     const messagesResponse = await deps.client.session.messages({
       path: { id: agentSessionId },
-      query: { directory: deps.sessionDirectory ?? deps.projectPath }
+      query: { directory: deps.sessionDirectory ?? deps.projectPath, limit: 50 }
     });
     const messages = normalizeSDKResponse(messagesResponse, [], {
       preferResponseOnMissingData: true
@@ -168513,7 +168516,7 @@ async function runKeyFilesLlm(args) {
     });
     const messagesResponse = await args.client.session.messages({
       path: { id: agentSessionId },
-      query: { directory: args.projectPath }
+      query: { directory: args.projectPath, limit: 50 }
     });
     const messages = normalizeSDKResponse(messagesResponse, [], {
       preferResponseOnMissingData: true
@@ -168709,7 +168712,7 @@ If no promotions are warranted, return empty arrays. Always consume reviewed can
     });
     const messagesResponse = await args.client.session.messages({
       path: { id: agentSessionId },
-      query: { directory: args.sessionDirectory }
+      query: { directory: args.sessionDirectory, limit: 50 }
     });
     const messages = normalizeSDKResponse(messagesResponse, [], {
       preferResponseOnMissingData: true
@@ -169014,7 +169017,7 @@ async function runDream(args) {
         }
         const messagesResponse = await args.client.session.messages({
           path: { id: agentSessionId },
-          query: { directory: args.sessionDirectory ?? args.projectIdentity }
+          query: { directory: args.sessionDirectory ?? args.projectIdentity, limit: 50 }
         });
         const messages = normalizeSDKResponse(messagesResponse, [], {
           preferResponseOnMissingData: true
@@ -169337,7 +169340,7 @@ Only include notes whose conditions you could definitively evaluate. Skip notes
     });
     const messagesResponse = await args.client.session.messages({
       path: { id: agentSessionId },
-      query: { directory: args.sessionDirectory ?? args.projectIdentity }
+      query: { directory: args.sessionDirectory ?? args.projectIdentity, limit: 50 }
     });
     const messages = normalizeSDKResponse(messagesResponse, [], {
       preferResponseOnMissingData: true
@@ -172477,7 +172480,8 @@ async function runCompartmentPhase(args) {
       sessionLog(args.sessionId, "transform: cannot force-start compartment agent without client");
     }
     if (activeRun) {
-      if (args.client) {
+      if (args.client && !activeRun.notificationSent) {
+        activeRun.notificationSent = true;
         const notifParams = args.getNotificationParams?.() ?? {};
         sendIgnoredMessage(args.client, args.sessionId, `⏳ Context at ${args.contextUsage.percentage.toFixed(0)}% — Magic Context is compacting history before continuing. This may take up to 2 minutes.`, notifParams);
       }

package/dist/plugin/conflict-warning-hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conflict-warning-hook.d.ts","sourceRoot":"","sources":["../../src/plugin/conflict-warning-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AA0KlE;;GAEG;AACH,wBAAsB,mBAAmB,CACrC,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,cAAc,GAC/B,OAAO,CAAC,IAAI,CAAC,CA+Cf;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CACzC,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAqHf;AAkCD;;;GAGG;AACH,wBAAsB,wBAAwB,CAC1C,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAkEf"}
+{"version":3,"file":"conflict-warning-hook.d.ts","sourceRoot":"","sources":["../../src/plugin/conflict-warning-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAmLlE;;GAEG;AACH,wBAAsB,mBAAmB,CACrC,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,cAAc,GAC/B,OAAO,CAAC,IAAI,CAAC,CA+Cf;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CACzC,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAqHf;AAkCD;;;GAGG;AACH,wBAAsB,wBAAwB,CAC1C,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAkEf"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cortexkit/opencode-magic-context",
-	"version": "0.21.1",
+	"version": "0.21.2",
 	"type": "module",
 	"description": "OpenCode plugin for Magic Context — cross-session memory and context management",
 	"main": "dist/index.js",

package/src/shared/session-messages-bounded.test.ts

@@ -0,0 +1,112 @@
+/// <reference types="bun-types" />
+
+// Regression guard: every `client.session.messages(...)` call in plugin code
+// must include `limit` in its `query`. Without `limit`, OpenCode's legacy
+// messages endpoint hydrates the ENTIRE session into RAM — catastrophic on
+// huge sessions (10k+ messages) which is exactly when Magic Context shines.
+//
+// Background: the plugin only ever needs the latest assistant message of a
+// helper subagent (historian / dreamer / sidekick / key-files / user-memory)
+// or a bounded tail of the active session (conflict-warning cleanup). Both
+// fit comfortably in `limit: 50` with massive headroom.
+//
+// If you add a new `session.messages(...)` call, this test fails until you
+// include a `limit` in the query. The test does a static source-text scan
+// so it catches the issue at lint-time without runtime mocking overhead.
+
+import { describe, expect, it } from "bun:test";
+import { readdirSync, readFileSync, statSync } from "node:fs";
+import { join } from "node:path";
+
+const PLUGIN_SRC = join(__dirname, "..", "..", "src");
+
+/** Recursively walk a directory and return paths of all `.ts` files
+ *  excluding `.test.ts`, `.gen.ts`, and node_modules. */
+function walkSourceFiles(dir: string, out: string[] = []): string[] {
+    for (const entry of readdirSync(dir)) {
+        if (entry === "node_modules" || entry === "dist") continue;
+        const full = join(dir, entry);
+        const s = statSync(full);
+        if (s.isDirectory()) {
+            walkSourceFiles(full, out);
+        } else if (
+            s.isFile() &&
+            entry.endsWith(".ts") &&
+            !entry.endsWith(".test.ts") &&
+            !entry.endsWith(".gen.ts")
+        ) {
+            out.push(full);
+        }
+    }
+    return out;
+}
+
+/** Find call expressions matching `session.messages(...)` and return the
+ *  source text of each call (from "session.messages(" to its matching ")"). */
+function findSessionMessagesCalls(source: string): string[] {
+    const calls: string[] = [];
+    const needle = "session.messages(";
+    let i = 0;
+    while (true) {
+        const idx = source.indexOf(needle, i);
+        if (idx === -1) break;
+        // Skip comments — if the line starts with `*` or `//` we ignore.
+        const lineStart = source.lastIndexOf("\n", idx) + 1;
+        const linePrefix = source.slice(lineStart, idx).trimStart();
+        if (linePrefix.startsWith("//") || linePrefix.startsWith("*")) {
+            i = idx + needle.length;
+            continue;
+        }
+        // Walk forward to find the matching closing paren, respecting
+        // brace/bracket/paren nesting.
+        let depth = 1;
+        let j = idx + needle.length;
+        while (j < source.length && depth > 0) {
+            const ch = source[j];
+            if (ch === "(" || ch === "{" || ch === "[") depth++;
+            else if (ch === ")" || ch === "}" || ch === "]") depth--;
+            j++;
+        }
+        if (depth === 0) {
+            calls.push(source.slice(idx, j));
+        }
+        i = j;
+    }
+    return calls;
+}
+
+describe("session.messages() callsites must include query.limit", () => {
+    const files = walkSourceFiles(PLUGIN_SRC);
+    const violations: Array<{ file: string; callText: string }> = [];
+
+    for (const file of files) {
+        // Skip the regression test itself
+        if (file.endsWith("session-messages-bounded.test.ts")) continue;
+        const source = readFileSync(file, "utf-8");
+        const calls = findSessionMessagesCalls(source);
+        for (const call of calls) {
+            // The call text spans from "session.messages(" to the closing
+            // ")". A correct call must mention `limit` (the SDK key) somewhere
+            // inside that span — typically `query: { ..., limit: N }`.
+            if (!/\blimit\b/.test(call)) {
+                violations.push({ file: file.replace(PLUGIN_SRC, "<plugin>/src"), callText: call });
+            }
+        }
+    }
+
+    it("has no unbounded session.messages() calls in plugin code", () => {
+        if (violations.length > 0) {
+            const report = violations
+                .map(
+                    (v) =>
+                        `\n  in ${v.file}:\n    ${v.callText.replace(/\n/g, "\n    ").slice(0, 300)}`,
+                )
+                .join("\n");
+            throw new Error(
+                `Found ${violations.length} unbounded session.messages() call(s). ` +
+                    `Add \`limit: 50\` (or appropriate bound) to query.${report}`,
+            );
+        }
+        expect(violations).toEqual([]);
+    });
+});