wotann 0.5.39 → 0.5.41

package/dist/middleware/output-truncation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"output-truncation.d.ts","sourceRoot":"","sources":["../../src/middleware/output-truncation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAkC,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAyB,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAI5F,MAAM,WAAW,gBAAgB;IAC/B,gFAAgF;IAChF,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,2DAA2D;IAC3D,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,mDAAmD;IACnD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,2DAA2D;IAC3D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,yDAAyD;IACzD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAYD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAgBD,qBAAa,0BAA0B;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,iBAAiB,CAAK;IAK9B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA8B;IAC7D,OAAO,CAAC,eAAe,CAAK;gBAEhB,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC;IAI9C;;;;;;;;OAQG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG;QACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;QAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;KAC/B;IAwDD,+EAA+E;IAC/E,iBAAiB,IAAI,oBAAoB;IAIzC,oEAAoE;IACpE,iBAAiB,IAAI,MAAM;IAI3B;;OAEG;IACH,QAAQ,IAAI,eAAe;IAQ3B;;OAEG;IACH,KAAK,IAAI,IAAI;CAKd;AAID;;;;GAIG;AACH,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,0BAA0B,GAAG,UAAU,CAoBjG"}
+{"version":3,"file":"output-truncation.d.ts","sourceRoot":"","sources":["../../src/middleware/output-truncation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAkC,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAyB,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAInE,MAAM,WAAW,gBAAgB;IAC/B,gFAAgF;IAChF,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,2DAA2D;IAC3D,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,mDAAmD;IACnD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,2DAA2D;IAC3D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,yDAAyD;IACzD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAYD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAgBD,qBAAa,0BAA0B;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,iBAAiB,CAAK;IAK9B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA8B;IAC7D,OAAO,CAAC,eAAe,CAAK;IAM5B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA0B;IACxD,OAAO,CAAC,mBAAmB,CAAK;gBAEpB,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC;IAI9C;;;;;OAKG;IACH,eAAe,CACb,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAoBvE,kDAAkD;IAClD,qBAAqB,IAAI,MAAM;IAI/B,qEAAqE;IACrE,gBAAgB,IAAI,gBAAgB;IAIpC;;;;;;;;OAQG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG;QACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;QAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;KAC/B;IAwDD,+EAA+E;IAC/E,iBAAiB,IAAI,oBAAoB;IAIzC,oEAAoE;IACpE,iBAAiB,IAAI,MAAM;IAI3B;;OAEG;IACH,QAAQ,IAAI,eAAe;IAQ3B;;OAEG;IACH,KAAK,IAAI,IAAI;CAKd;AAmBD,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,0BAA0B,GAAG,UAAU,CA6CjG"}

package/dist/middleware/output-truncation.js

@@ -10,6 +10,7 @@
  * Runs in the `after` phase at order 6.5 (after ToolError, before Summarization).
  */
 import { formatIsolatedPreview, OutputIsolationStore } from "../sandbox/output-isolator.js";
+import { SessionArtifacts } from "../storage/session-artifacts.js";
 const DEFAULT_CONFIG = {
     maxToolOutputChars: 8000,
     maxToolOutputLines: 200,
@@ -39,9 +40,49 @@ export class OutputTruncationMiddleware {
     // via getIsolationStore() to fetch full content by handle.
     isolationStore = new OutputIsolationStore();
     totalIsolations = 0;
+    // V9 ZW-4: persistent artifact spill. Stores oversize tool outputs at
+    // ~/.wotann/artifacts/{sessionId}/ so the transcript carries a small
+    // reference instead of the full payload. Survives process restart,
+    // unlike the in-process isolation store.
+    artifactStore = new SessionArtifacts();
+    totalArtifactSpills = 0;
     constructor(config) {
         this.config = { ...DEFAULT_CONFIG, ...config };
     }
+    /**
+     * V9 ZW-4: spill a tool output to durable storage and return an inline
+     * reference. Used by the middleware adapter when a `sessionId` is
+     * available on the result. Best-effort — if spill fails we return null
+     * and the caller falls through to plain truncation.
+     */
+    spillToolOutput(sessionId, toolName, content) {
+        try {
+            // Use the tool name as the artifact name. SessionArtifacts.spill
+            // sanitises it internally so unsafe chars become `_`.
+            const record = this.artifactStore.spill(sessionId, toolName, content);
+            this.totalArtifactSpills++;
+            this.totalTruncations++;
+            const linesDropped = content.split("\n").length;
+            this.totalLinesDropped += linesDropped;
+            this.totalCharsDropped += content.length;
+            // Inline reference replaces the full payload. The model can ask for
+            // the full content by tool-name later.
+            const ref = `[Tool output spilled to artifact: ${record.path} (${record.sizeBytes} bytes, sha=${record.sha.slice(0, 8)})]`;
+            return { content: ref, truncated: true, linesDropped };
+        }
+        catch {
+            // Honest fallback — never block the agent on a spill I/O hiccup.
+            return null;
+        }
+    }
+    /** V9 ZW-4: artifact spill count this session. */
+    getArtifactSpillCount() {
+        return this.totalArtifactSpills;
+    }
+    /** V9 ZW-4: expose the artifact store for handle-based retrieval. */
+    getArtifactStore() {
+        return this.artifactStore;
+    }
     /**
      * Truncate content if it exceeds configured limits.
      * Returns the original content if within limits, or a truncated version
@@ -130,13 +171,44 @@ export class OutputTruncationMiddleware {
  * Runs at order 6.5 (between ToolError at 6 and Summarization at 7).
  * Operates in the `after` phase to inspect and truncate tool results.
  */
+/**
+ * V9 ZW-4 artifact-spill threshold. Tool outputs above this size go to
+ * durable storage instead of being summarised by the in-context isolator.
+ * The threshold is intentionally higher than ISOLATION_SIZE_BYTES so the
+ * isolator handles the common case and the artifact spill catches the
+ * truly huge outputs (full repo dumps, multi-MB log slices) that benefit
+ * from cross-process persistence.
+ */
+const ARTIFACT_SPILL_THRESHOLD_BYTES = 200 * 1024; // 200 KB
 export function createOutputTruncationMiddleware(instance) {
     return {
         name: "OutputTruncation",
         order: 6.5,
-        after(_ctx, result) {
+        after(ctx, result) {
             if (!result.content)
                 return result;
+            // V9 ZW-4: for very large outputs spill the content to
+            // ~/.wotann/artifacts/{sessionId}/ and replace inline with a
+            // reference. Best-effort: failures fall through to plain truncation.
+            // SessionArtifacts validates sessionId at the boundary; if the
+            // pipeline ever passes a malformed id we silently fall through
+            // rather than crash a tool result.
+            if (typeof ctx.sessionId === "string" &&
+                ctx.sessionId.length > 0 &&
+                /^[A-Za-z0-9_-]+$/.test(ctx.sessionId) &&
+                result.content.length >= ARTIFACT_SPILL_THRESHOLD_BYTES) {
+                const toolName = result.toolName ?? "unknown";
+                const spill = instance.spillToolOutput(ctx.sessionId, toolName, result.content);
+                if (spill !== null) {
+                    const traceNote = `[OutputTruncation] Spilled ${spill.linesDropped} lines from ${toolName} to artifact storage`;
+                    return {
+                        ...result,
+                        content: spill.content,
+                        followUp: result.followUp ? `${result.followUp}\n\n${traceNote}` : traceNote,
+                    };
+                }
+                // Spill failed — fall through to existing isolation/truncate path.
+            }
             const { content, truncated, linesDropped } = instance.truncate(result.content);
             if (!truncated)
                 return result;

package/dist/middleware/output-truncation.js.map

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

package/dist/middleware/ttsr.d.ts

@@ -3,7 +3,30 @@
  * Intercepts model output mid-stream via regex triggers.
  * Rules fire DURING generation, not before or after.
  * Zero upfront context cost — rules only consume tokens when triggered.
+ *
+ * ── Surface split (do not collapse these into one class) ──────────────
+ *
+ *   TTSREngine        ← legacy: severity-tiered regex-only scan with
+ *                       per-rule fire caps. Used by tests/unit/ttsr.test.ts
+ *                       and existing callers that don't know about stream
+ *                       scopes. Kept stable so downstream wires keep
+ *                       working unchanged.
+ *
+ *   TTSRRunner        ← new: scope-aware, per-token, one-shot-by-default
+ *                       runner ported from oh-my-pi. Lives in
+ *                       src/runtime-hooks/ttsr-runner.ts. The orchestrator
+ *                       (not the engine) decides abort/retry.
+ *
+ * The engine OPTIONALLY hosts a runner — when constructed with one,
+ * `processChunk` consults the runner and surfaces structured triggers
+ * via the same `injections` channel so legacy callers stay
+ * compatible. Orchestrators that want full scope-aware semantics use
+ * the new `processScopedChunk` path instead, which preserves the
+ * `TTSRTrigger` shape end to end.
  */
+import type { TTSRRule as ScopedTTSRRule } from "../runtime-hooks/ttsr-rule.js";
+import { TTSRRunner, type TTSRTrigger } from "../runtime-hooks/ttsr-runner.js";
+import type { StreamContext } from "../runtime-hooks/ttsr-scope.js";
 export type TTSRSeverity = "critical" | "warning" | "info";
 export interface TTSRRule {
     readonly trigger: RegExp;
@@ -17,18 +40,70 @@ export interface TTSRResult {
     readonly injections: readonly string[];
     readonly shouldAbort: boolean;
     readonly retrySystemMessage?: string;
+    /** Structured triggers from the scope-aware runner (if attached). */
+    readonly triggers?: readonly TTSRTrigger[];
+}
+/**
+ * Result of a scope-aware chunk evaluation. Carries the same fields
+ * as `TTSRResult` plus the trigger list. `shouldAbort` is true when
+ * any scoped trigger fired — the orchestrator decides whether to
+ * actually abort.
+ */
+export interface TTSRScopedResult extends TTSRResult {
+    readonly triggers: readonly TTSRTrigger[];
 }
 export declare class TTSREngine {
     private readonly rules;
-    constructor(customRules?: readonly TTSRRule[]);
+    private readonly runner?;
+    constructor(customRules?: readonly TTSRRule[], runner?: TTSRRunner);
+    /**
+     * Build an engine that owns a scope-aware `TTSRRunner` populated
+     * with the supplied scoped rules.
+     *
+     * Pass `legacyRules: false` to disable the legacy severity-tiered
+     * regex rules (only the runner fires).
+     */
+    static withScopedRules(scopedRules: readonly ScopedTTSRRule[], options?: {
+        legacyRules?: boolean;
+    }): TTSREngine;
+    /** Read-only access to the underlying scoped runner, if attached. */
+    getRunner(): TTSRRunner | undefined;
     static defaultRules(): TTSRRule[];
     /**
-     * Process a chunk of streaming model output.
+     * Process a chunk of streaming model output (legacy path).
+     *
      * Returns the chunk (unmodified) plus any triggered injections.
+     *
+     * If a scoped runner is attached, the chunk is ALSO fed to it
+     * with a permissive `{ kind: "text" }` context so legacy callers
+     * receive any runner-emitted triggers via the same `injections`
+     * channel. Scope-aware callers should use `processScopedChunk`
+     * instead so they can supply real stream context (thinking
+     * channel, tool-call args, file paths).
      */
     processChunk(chunk: string): TTSRResult;
     /**
-     * Reset fire counts for a new session.
+     * Scope-aware streaming evaluation. Use this when you have real
+     * stream context (text vs thinking vs a specific tool call) and
+     * you want only scoped rules to fire.
+     *
+     * Returns a `TTSRScopedResult` whose `triggers` field is the
+     * primary signal — `injections` and `shouldAbort` are present
+     * for compatibility with legacy callers.
+     *
+     * NOTE: This method does NOT run the legacy severity rules; if
+     * you want both, call `processChunk` after this and merge.
+     */
+    processScopedChunk(chunk: string, ctx: StreamContext): TTSRScopedResult;
+    /**
+     * Acknowledge that the orchestrator processed the trigger for
+     * `ruleId`. Forwards to the runner so one-shot rules stop
+     * firing.
+     */
+    acknowledgeFired(ruleId: string): void;
+    /**
+     * Reset fire counts for a new session. Also clears scoped
+     * runner state when attached (buffers AND fired records).
      */
     reset(): void;
     /**
@@ -37,4 +112,5 @@ export declare class TTSREngine {
     addRule(rule: TTSRRule): void;
     getRules(): readonly TTSRRule[];
 }
+export type { TTSRTrigger } from "../runtime-hooks/ttsr-runner.js";
 //# sourceMappingURL=ttsr.d.ts.map

package/dist/middleware/ttsr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ttsr.d.ts","sourceRoot":"","sources":["../../src/middleware/ttsr.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;AAE3D,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;gBAEvB,WAAW,CAAC,EAAE,SAAS,QAAQ,EAAE;IAM7C,MAAM,CAAC,YAAY,IAAI,QAAQ,EAAE;IA0CjC;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU;IAiCvC;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAI7B,QAAQ,IAAI,SAAS,QAAQ,EAAE;CAGhC"}
+{"version":3,"file":"ttsr.d.ts","sourceRoot":"","sources":["../../src/middleware/ttsr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAEpE,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;AAE3D,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;CAC5C;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;CAC3C;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAa;gBAEzB,WAAW,CAAC,EAAE,SAAS,QAAQ,EAAE,EAAE,MAAM,CAAC,EAAE,UAAU;IAOlE;;;;;;OAMG;IACH,MAAM,CAAC,eAAe,CACpB,WAAW,EAAE,SAAS,cAAc,EAAE,EACtC,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAClC,UAAU;IAMb,qEAAqE;IACrE,SAAS,IAAI,UAAU,GAAG,SAAS;IAInC,MAAM,CAAC,YAAY,IAAI,QAAQ,EAAE;IA0CjC;;;;;;;;;;;OAWG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU;IA2DvC;;;;;;;;;;;OAWG;IACH,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,gBAAgB;IAkCvE;;;;OAIG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAItC;;;OAGG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAI7B,QAAQ,IAAI,SAAS,QAAQ,EAAE;CAGhC;AAED,YAAY,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/middleware/ttsr.js

@@ -3,13 +3,52 @@
  * Intercepts model output mid-stream via regex triggers.
  * Rules fire DURING generation, not before or after.
  * Zero upfront context cost — rules only consume tokens when triggered.
+ *
+ * ── Surface split (do not collapse these into one class) ──────────────
+ *
+ *   TTSREngine        ← legacy: severity-tiered regex-only scan with
+ *                       per-rule fire caps. Used by tests/unit/ttsr.test.ts
+ *                       and existing callers that don't know about stream
+ *                       scopes. Kept stable so downstream wires keep
+ *                       working unchanged.
+ *
+ *   TTSRRunner        ← new: scope-aware, per-token, one-shot-by-default
+ *                       runner ported from oh-my-pi. Lives in
+ *                       src/runtime-hooks/ttsr-runner.ts. The orchestrator
+ *                       (not the engine) decides abort/retry.
+ *
+ * The engine OPTIONALLY hosts a runner — when constructed with one,
+ * `processChunk` consults the runner and surfaces structured triggers
+ * via the same `injections` channel so legacy callers stay
+ * compatible. Orchestrators that want full scope-aware semantics use
+ * the new `processScopedChunk` path instead, which preserves the
+ * `TTSRTrigger` shape end to end.
  */
+import { TTSRRunner } from "../runtime-hooks/ttsr-runner.js";
 export class TTSREngine {
     rules;
-    constructor(customRules) {
-        this.rules = customRules
-            ? [...customRules]
-            : TTSREngine.defaultRules();
+    runner;
+    constructor(customRules, runner) {
+        this.rules = customRules ? [...customRules] : TTSREngine.defaultRules();
+        if (runner) {
+            this.runner = runner;
+        }
+    }
+    /**
+     * Build an engine that owns a scope-aware `TTSRRunner` populated
+     * with the supplied scoped rules.
+     *
+     * Pass `legacyRules: false` to disable the legacy severity-tiered
+     * regex rules (only the runner fires).
+     */
+    static withScopedRules(scopedRules, options) {
+        const runner = new TTSRRunner({ rules: scopedRules });
+        const legacyRules = options?.legacyRules ?? true;
+        return new TTSREngine(legacyRules ? undefined : [], runner);
+    }
+    /** Read-only access to the underlying scoped runner, if attached. */
+    getRunner() {
+        return this.runner;
     }
     static defaultRules() {
         return [
@@ -53,8 +92,16 @@ export class TTSREngine {
         ];
     }
     /**
-     * Process a chunk of streaming model output.
+     * Process a chunk of streaming model output (legacy path).
+     *
      * Returns the chunk (unmodified) plus any triggered injections.
+     *
+     * If a scoped runner is attached, the chunk is ALSO fed to it
+     * with a permissive `{ kind: "text" }` context so legacy callers
+     * receive any runner-emitted triggers via the same `injections`
+     * channel. Scope-aware callers should use `processScopedChunk`
+     * instead so they can supply real stream context (thinking
+     * channel, tool-call args, file paths).
      */
     processChunk(chunk) {
         const injections = [];
@@ -70,29 +117,102 @@ export class TTSREngine {
                 }
             }
         }
+        const triggers = [];
+        if (this.runner) {
+            const scoped = this.runner.observeAll(chunk, { kind: "text" });
+            for (const t of scoped) {
+                injections.push(t.rule.body);
+                triggers.push(t);
+            }
+        }
         const hasCritical = criticalInjections.length > 0;
-        // Only abort on critical severity injections; warnings and info are advisory only
+        // Scoped triggers also count as abort-worthy: they represent a
+        // hard rule (file-typed, scope-gated) that the orchestrator
+        // explicitly opted into via withScopedRules.
+        const shouldAbort = hasCritical || triggers.length > 0;
+        const retryLines = [];
+        if (hasCritical) {
+            retryLines.push("TTSR RETRY SYSTEM MESSAGE", "The previous streaming attempt was aborted because it emitted one of the following critical patterns:", ...criticalInjections);
+        }
+        if (triggers.length > 0) {
+            if (retryLines.length === 0) {
+                retryLines.push("TTSR RETRY SYSTEM MESSAGE");
+            }
+            retryLines.push("The previous streaming attempt was aborted by scoped rules:", ...triggers.map((t) => `- ${t.rule.id}: ${t.rule.body}`));
+        }
+        if (retryLines.length > 0) {
+            retryLines.push("Restart the response and do not repeat the flagged patterns.");
+        }
         return {
             modified: chunk,
             injections,
-            shouldAbort: hasCritical,
-            retrySystemMessage: hasCritical
-                ? [
-                    "TTSR RETRY SYSTEM MESSAGE",
-                    "The previous streaming attempt was aborted because it emitted one of the following critical patterns:",
-                    ...criticalInjections,
-                    "Restart the response from scratch and do not repeat the flagged patterns.",
-                ].join("\n")
-                : undefined,
+            shouldAbort,
+            retrySystemMessage: retryLines.length > 0 ? retryLines.join("\n") : undefined,
+            ...(triggers.length > 0 ? { triggers } : {}),
         };
     }
     /**
-     * Reset fire counts for a new session.
+     * Scope-aware streaming evaluation. Use this when you have real
+     * stream context (text vs thinking vs a specific tool call) and
+     * you want only scoped rules to fire.
+     *
+     * Returns a `TTSRScopedResult` whose `triggers` field is the
+     * primary signal — `injections` and `shouldAbort` are present
+     * for compatibility with legacy callers.
+     *
+     * NOTE: This method does NOT run the legacy severity rules; if
+     * you want both, call `processChunk` after this and merge.
+     */
+    processScopedChunk(chunk, ctx) {
+        if (!this.runner) {
+            return {
+                modified: chunk,
+                injections: [],
+                shouldAbort: false,
+                triggers: [],
+            };
+        }
+        const triggers = this.runner.observeAll(chunk, ctx);
+        const injections = triggers.map((t) => t.rule.body);
+        if (triggers.length === 0) {
+            return {
+                modified: chunk,
+                injections,
+                shouldAbort: false,
+                triggers,
+            };
+        }
+        const retry = [
+            "TTSR RETRY SYSTEM MESSAGE",
+            "The previous streaming attempt was aborted by scoped rules:",
+            ...triggers.map((t) => `- ${t.rule.id}: ${t.rule.body}`),
+            "Restart the response and do not repeat the flagged patterns.",
+        ].join("\n");
+        return {
+            modified: chunk,
+            injections,
+            shouldAbort: true,
+            retrySystemMessage: retry,
+            triggers,
+        };
+    }
+    /**
+     * Acknowledge that the orchestrator processed the trigger for
+     * `ruleId`. Forwards to the runner so one-shot rules stop
+     * firing.
+     */
+    acknowledgeFired(ruleId) {
+        this.runner?.acknowledgeFired(ruleId);
+    }
+    /**
+     * Reset fire counts for a new session. Also clears scoped
+     * runner state when attached (buffers AND fired records).
      */
     reset() {
         for (const rule of this.rules) {
             rule.firedCount = 0;
         }
+        this.runner?.reset();
     }
     /**
      * Add a custom rule at runtime.

package/dist/middleware/ttsr.js.map

@@ -1 +1 @@
-{"version":3,"file":"ttsr.js","sourceRoot":"","sources":["../../src/middleware/ttsr.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmBH,MAAM,OAAO,UAAU;IACJ,KAAK,CAAa;IAEnC,YAAY,WAAiC;QAC3C,IAAI,CAAC,KAAK,GAAG,WAAW;YACtB,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC;YAClB,CAAC,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC;IAChC,CAAC;IAED,MAAM,CAAC,YAAY;QACjB,OAAO;YACL;gBACE,OAAO,EAAE,iBAAiB;gBAC1B,SAAS,EAAE,yEAAyE;gBACpF,QAAQ,EAAE,SAAS;gBACnB,kBAAkB,EAAE,CAAC;gBACrB,UAAU,EAAE,CAAC;aACd;YACD;gBACE,4EAA4E;gBAC5E,+EAA+E;gBAC/E,OAAO,EAAE,sCAAsC;gBAC/C,SAAS,EAAE,gEAAgE;gBAC3E,QAAQ,EAAE,SAAS;gBACnB,kBAAkB,EAAE,CAAC;gBACrB,UAAU,EAAE,CAAC;aACd;YACD;gBACE,OAAO,EAAE,gBAAgB;gBACzB,SAAS,EAAE,wDAAwD;gBACnE,QAAQ,EAAE,MAAM;gBAChB,kBAAkB,EAAE,CAAC;gBACrB,UAAU,EAAE,CAAC;aACd;YACD;gBACE,OAAO,EAAE,+BAA+B;gBACxC,SAAS,EAAE,8EAA8E;gBACzF,QAAQ,EAAE,UAAU;gBACpB,kBAAkB,EAAE,CAAC;gBACrB,UAAU,EAAE,CAAC;aACd;YACD;gBACE,OAAO,EAAE,iBAAiB;gBAC1B,SAAS,EAAE,2EAA2E;gBACtF,QAAQ,EAAE,UAAU;gBACpB,kBAAkB,EAAE,CAAC;gBACrB,UAAU,EAAE,CAAC;aACd;SACF,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,KAAa;QACxB,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,MAAM,kBAAkB,GAAa,EAAE,CAAC;QAExC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,kBAAkB;gBAAE,SAAS;YACzD,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7B,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAChC,IAAI,CAAC,UAAU,EAAE,CAAC;gBAClB,IAAI,IAAI,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;oBACjC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAC1C,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,WAAW,GAAG,kBAAkB,CAAC,MAAM,GAAG,CAAC,CAAC;QAElD,kFAAkF;QAClF,OAAO;YACL,QAAQ,EAAE,KAAK;YACf,UAAU;YACV,WAAW,EAAE,WAAW;YACxB,kBAAkB,EAAE,WAAW;gBAC7B,CAAC,CAAC;oBACA,2BAA2B;oBAC3B,uGAAuG;oBACvG,GAAG,kBAAkB;oBACrB,2EAA2E;iBAC5E,CAAC,IAAI,CAAC,IAAI,CAAC;gBACZ,CAAC,CAAC,SAAS;SACd,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK;QACH,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,IAAc;QACpB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF"}
+{"version":3,"file":"ttsr.js","sourceRoot":"","sources":["../../src/middleware/ttsr.ts"],"names":[],"mappings":"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"}