@animalabs/agent-framework 0.28.0 → 0.29.0

package/dist/src/gate/event-gate.d.ts

@@ -127,17 +127,28 @@ export declare function shownValue(value: unknown): string;
  * left out.
  */
 export declare function checkToolInput(tool: string, input: Record<string, unknown>, properties: Readonly<Record<string, unknown>>, notes: string[], means?: Readonly<Record<string, string>>): Record<string, unknown>;
+/** The event types the gate can see from an MCPL server: its pushes and its
+ *  channels' messages. */
+export declare const MCPL_GATE_EVENT_TYPES: readonly string[];
+/** The event types a host knows a source sends (EventGate's
+ *  `eventTypesFrom`), or undefined when it could send any. */
+export type EventTypesFrom = (source: string) => readonly string[] | undefined;
 /**
- * Find rules made unreachable by earlier, broader rules (first match wins).
+ * Find rules an earlier, broader rule keeps from applying (first match wins),
+ * in whole or for some event types.
  * The 2026-08-08 Mythos incident is the canonical catch: a prepended
  * `{scope:[mcpl:channel-incoming]}` sampler silently made the
  * direct-address and mention rules dead for the whole incoming lane.
  * `passthrough` observers shadow nothing — non-firing matches fall through.
+ * `eventTypesFrom` leaves out types a rule's source is known never to send:
+ * a rule for an MCPL server's events isn't told about another rule that
+ * takes every `external-message`.
  */
-export declare function findShadowedPolicies(policies: GatePolicy[]): ShadowWarning[];
-/** Human-readable one-liner for a ShadowWarning, used in tool results,
- *  traces, and gate_status alike so the same hazard reads the same way
- *  everywhere. */
+export declare function findShadowedPolicies(policies: GatePolicy[], eventTypesFrom?: EventTypesFrom): ShadowWarning[];
+/** A ShadowWarning in words, used in tool results, traces, and gate_status
+ *  alike so the same note reads the same way everywhere. It says which of
+ *  three it is (the rule never applies; it misses some of its events; it
+ *  may not be meant for those events at all) and what to do. */
 export declare function formatShadowWarning(w: ShadowWarning): string;
 export declare class EventGate {
     private configPath;
@@ -207,8 +218,9 @@ export declare class EventGate {
     /** Lifetime count of buffer-cap evictions (see bufferForInference). */
     private droppedBufferedEvents;
     private stats;
-    private shadowWarningsCache;
     private shadowWarningsFingerprint;
+    /** See the constructor's `eventTypesFrom`. */
+    private eventTypesFromFn;
     private totalEvaluations;
     private defaultTriggered;
     private defaultSkipped;
@@ -293,6 +305,11 @@ export declare class EventGate {
          *  (WakeProvenance.line), for a fresh start of the wake's turn to decide
          *  (WakeLine). Absent: every batched wake writes its line, as before. */
         isNewestEntry?: (entry: GateEntryRef) => boolean;
+        /** The event types the gate can see from a source, when the host knows
+         *  them (an MCPL server's id: MCPL_GATE_EVENT_TYPES), else undefined.
+         *  The rule-order notes (findShadowedPolicies) leave out types a rule's
+         *  source never sends. Absent: any source can send any type. */
+        eventTypesFrom?: EventTypesFrom;
     });
     /**
      * Write the starting rules to gate.json, as given, when it's absent, and
@@ -553,10 +570,17 @@ export declare class EventGate {
      *  cheap (policy lists are tens of entries at most). */
     lintShadows(): ShadowWarning[];
     /**
-     * Recompute shadow warnings and, when the set changed and is non-empty,
-     * emit a `gate:shadow-warnings` trace so the hazard lands in ops
-     * observability at the moment the order changed — not at the next missed
-     * DM. Called from writeConfig and reloadIfChanged.
+     * The sources the host knows changed (eventTypesFrom answers differently),
+     * as when an MCPL server connects or is removed: the rule-order notes are
+     * made again, and traced if they changed, as a change to the rules would.
+     */
+    sourcesChanged(): void;
+    /**
+     * Recompute shadow warnings and, when the set changed, emit a
+     * `gate:shadow-warnings` trace so the hazard lands in ops observability at
+     * the moment the order changed — not at the next missed DM — and, with an
+     * empty list, the moment the last of them went. Called from writeConfig,
+     * reloadIfChanged and sourcesChanged.
      */
     private refreshShadowWarnings;
     /**

package/dist/src/gate/event-gate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-gate.d.ts","sourceRoot":"","sources":["../../../src/gate/event-gate.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"event-gate.d.ts","sourceRoot":"","sources":["../../../src/gate/event-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAYH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EAGV,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,aAAa,EAEb,UAAU,EACV,aAAa,EACb,YAAY,EAGZ,OAAO,EAEP,YAAY,EACb,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAC5E,WAAW,EAAE,iBAAiB,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,YAAY,GACrG,MAAM,YAAY,CAAC;AAiEpB,UAAU,YAAY;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB;;;;8DAI0D;IAC1D,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;gCAE4B;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;mFAC+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;8EAC0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;iEAE6D;IAC7D,SAAS,EAAE,OAAO,CAAC;IACnB;;;wEAGoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;2EACuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;qEAEqE;AACrE,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B;;;+EAG2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;gFAC4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;;kEAO8D;IAC9D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;4CAEwC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;mEAC+D;IAC/D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;;;;;oBAKgB;IAChB,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AAkED,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AA6BD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,cAAc,GAAG,SAAS,CA8BjF;AAWD;kEACkE;AAClE,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhE;AA+KD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAWjD;AA+JD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAC5G,KAAK,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,GAC3C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA8BzB;AAkkCD;0BAC0B;AAC1B,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAAiD,CAAC;AAErG;8DAC8D;AAC9D,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;AA0F/E;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,cAAc,CAAC,EAAE,cAAc,GAAG,aAAa,EAAE,CAa7G;AAED;;;gEAGgE;AAChE,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAgB5D;AA6CD,qBAAa,SAAS;IACpB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAa;IAC3B,2DAA2D;IAC3D,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,gBAAgB,CAAwB;IAChD;;;;;;yEAMqE;IACrE,OAAO,CAAC,UAAU,CAAqB;IACvC,oFAAoF;IACpF,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,YAAY,CAA6C;IACjE,OAAO,CAAC,mBAAmB,CAAuB;IAClD;mEAC+D;IAC/D,OAAO,CAAC,WAAW,CAAuB;IAC1C;2EACuE;IACvE,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,eAAe,CAAuB;IAC9C;;sBAEkB;IAClB,OAAO,CAAC,WAAW,CAAuB;IAC1C;mEAC+D;IAC/D,OAAO,CAAC,YAAY,CAAuB;IAC3C,sHAAsH;IACtH,OAAO,CAAC,cAAc,CAAuB;IAC7C,mGAAmG;IACnG,OAAO,CAAC,kBAAkB,CAAS;IAGnC,OAAO,CAAC,cAAc,CAAoC;IAI1D,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,YAAY,CAAkB;IACtC,qDAAqD;IACrD,OAAO,CAAC,OAAO,CAAmC;IAClD;;gEAE4D;IAC5D,OAAO,CAAC,SAAS,CAAqE;IACtF,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,sBAAsB,CAA+C;IAC7E;sEACkE;IAClE,OAAO,CAAC,kBAAkB,CAAK;IAC/B;;oEAEgE;IAChE,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,gBAAgB,CAAM;IAG9B,OAAO,CAAC,gBAAgB,CAA8C;IAEtE,OAAO,CAAC,qBAAqB,CAA0C;IAEvE,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,kBAAkB,CAA6B;IAGvD,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,eAAe,CAAsB;IAC7C,kDAAkD;IAClD,OAAO,CAAC,QAAQ,CAAS;IACzB,uEAAuE;IACvE,OAAO,CAAC,qBAAqB,CAAK;IAGlC,OAAO,CAAC,KAAK,CAAkC;IAK/C,OAAO,CAAC,yBAAyB,CAAQ;IACzC,8CAA8C;IAC9C,OAAO,CAAC,gBAAgB,CAA6B;IAGrD,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,kBAAkB,CAA6D;IAOvF,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,UAAU,CAAqB;IAGvC,OAAO,CAAC,QAAQ,CAAS;IAOzB,OAAO,CAAC,cAAc,CAAoD;IAC1E;;6DAEyD;IACzD,OAAO,CAAC,WAAW,CAAqD;IAIxE,OAAO,CAAC,mBAAmB,CAAqB;IAChD,OAAO,CAAC,iBAAiB,CAAqB;IAC9C;iEAC6D;IAC7D,OAAO,CAAC,cAAc,CAAqB;IAC3C,OAAO,CAAC,mBAAmB,CAAK;IAGhC,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,YAAY,CAQP;IACb,OAAO,CAAC,kBAAkB,CAAmH;IAC7I,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,qBAAqB,CAA8C;IAC3E,OAAO,CAAC,cAAc,CAAC,CAA+D;IACtF,OAAO,CAAC,eAAe,CAAC,CAAmC;IAC3D;8DAC0D;IAC1D,OAAO,CAAC,GAAG,CAAe;IAE1B,YAAY,IAAI,EAAE;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,UAAU,CAAC;QAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,SAAS,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;QAC3C,UAAU,EAAE,CACV,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,EAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,QAAQ,CAAC,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,cAAc,KACvB,OAAO,CAAC;QACb;;mCAE2B;QAC3B,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,cAAc,KAAK,IAAI,CAAC;QACnI,aAAa,EAAE,MAAM,MAAM,EAAE,CAAC;QAC9B,kFAAkF;QAClF,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;QACnB,0EAA0E;QAC1E,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB;kFAC0E;QAC1E,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB;;;0EAGkE;QAClE,oBAAoB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;QACtD,8DAA8D;QAC9D,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,yDAAyD;QACzD,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAC/B;;;;;;kEAM0D;QAC1D,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,MAAM,GAAG,SAAS,CAAC;QAClE;;;sBAGc;QACd,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,KAAK,MAAM,CAAC;QAC5E;;;;;iFAKyE;QACzE,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC;QACjD;;;wEAGgE;QAChE,cAAc,CAAC,EAAE,cAAc,CAAC;KACjC,EAgGA;IAMD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAC,eAAe;IAwKvB;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAUpB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,cAAc;IA4CtB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAKxB,8GAA8G;IAC9G,OAAO,CAAC,QAAQ;IAgBhB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAC,cAAc;IA6CtB,OAAO,CAAC,eAAe;IAyBvB;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,eAAe;IA+CvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4CG;IACH,SAAS,CACP,SAAS,EAAE,OAAO,EAClB,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,GAAG;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QACzE,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;KAC7C,GACA,UAAU,CA+CZ;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAiBlC;IAED;;;;;OAKG;IACH,eAAe,IAAI,MAAM,EAAE,CAI1B;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAC,WAAW;IA+CnB,OAAO,CAAC,eAAe;IAiFvB,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,YAAY,CAwF1C;IAED,OAAO,CAAC,eAAe;IAsDvB;;;8EAG0E;IAC1E,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,cAAc;IAiDtB,OAAO,CAAC,kBAAkB;IAuB1B;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAQnB;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;;;OAIG;IACH,OAAO,CAAC,YAAY;IA+BpB;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,EAAE,aAAa,GAAG,YAAY,CAUvC;IAED,+GAA+G;IAC/G,OAAO,CAAC,WAAW;IAiDnB;;;;;OAKG;IACH,cAAc,IAAI,MAAM,EAAE,CAKzB;IAED;;;;;;;;;OASG;IACH,UAAU,IAAI,YAAY,EAAE,CAa3B;IAMD;4DACwD;IACxD,WAAW,IAAI,aAAa,EAAE,CAE7B;IAED;;;;OAIG;IACH,cAAc,IAAI,IAAI,CAErB;IAED;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IAoB7B;;;OAGG;IACH,uBAAuB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAYzF;IAMD,6EAA6E;IAC7E,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,cAAc;IA8CtB,OAAO,CAAC,YAAY;IAsDpB,OAAO,CAAC,aAAa;IA6FrB,oEAAoE;IACpE,OAAO,CAAC,WAAW;IAanB;;;;;;;;OAQG;IACH,OAAO,CAAC,UAAU;IAoDlB;qFACiF;IACjF,OAAO,CAAC,YAAY;IAapB;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;IActB,iHAAiH;IACjH,OAAO,CAAC,YAAY;IAKpB;;;;;;OAMG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAqBzE;IAED,gDAAgD;IAChD,OAAO,CAAC,iBAAiB;IAwBzB;;;;;;;;OAQG;IACH,OAAO,CAAC,aAAa;IAqErB;;4BAEwB;IACxB,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,oBAAoB;IAI5B,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,WAAW;IASnB,uHAAuH;IACvH,OAAO,CAAC,qBAAqB;IAe7B,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAW1C;IAED;;;;;;yBAMqB;IACrB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAG1C;IAED,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAIxC;IAED;;;;;;;;OAQG;IACH,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAYnC;IAED,OAAO,CAAC,2BAA2B;IAqBnC;;;oDAGgD;IAChD,oBAAoB,IAAI;QACtB,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;QACvB,qBAAqB,EAAE,MAAM,CAAC;QAC9B,UAAU,EAAE,MAAM,CAAC;QACnB,4GAA4G;QAC5G,eAAe,EAAE,MAAM,CAAC;QACxB,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAWA;IAMD,8DAA8D;IAC9D,OAAO,CAAC,kBAAkB;IA6B1B,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAqB9E;IAED;;;;;;OAMG;IACH,WAAW,IAAI,IAAI,CAIlB;IAED;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAOpB;;;;;OAKG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAMjC;IAMD;;;;;;OAMG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAe,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAqDvG;IAED,mEAAmE;IACnE,UAAU,IAAI,OAAO,CAOpB;IAED;;;;;;;;OAQG;IACH,OAAO,CAAC,aAAa;IA4BrB,6CAA6C;IAC7C,aAAa,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAIhG;IAED,4EAA4E;IAC5E,OAAO,CAAC,eAAe;IAQvB;;;;OAIG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAI7D;IAED;;;;;;;;;OASG;IACH,OAAO,CAAC,cAAc;IA+CtB,yGAAyG;IACzG,OAAO,CAAC,yBAAyB;IAQjC,iBAAiB,IAAI,cAAc,CAQlC;IAEK,cAAc,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,UAAU,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAOvF;IAED,SAAS,IAAI,UAAU,CA+EtB;IAED,sEAAsE;IACtE,OAAO,CAAC,kBAAkB;IAU1B,wFAAwF;IACxF,OAAO,CAAC,kBAAkB;IAa1B,OAAO,IAAI,IAAI,CAyCd;CACF"}

package/dist/src/gate/event-gate.js

@@ -10,6 +10,8 @@
  * and are always dispatched to modules — the gate decides whether to spend
  * inference tokens, not whether the agent should know about the event.
  */
+import { NOTICE_TAG } from '../notice-tags.js';
+import { cutToFit, suppliedValue } from '../supplied-text.js';
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
 import { basename, dirname, join } from 'node:path';
 import { GateScript } from './gate-script.js';
@@ -151,7 +153,7 @@ function referenceLine(count, channel, oldest, now) {
 /** A handed batched-wake line's text (WakeLine), as it reads when written at
  *  `now`: the gate's words, its message's age counted to then. */
 export function wakeLineText(line, now) {
-    return `[Gate: 1 event matched]\n\n${referenceLine(1, line.shown, line.at, now)}`;
+    return `[${NOTICE_TAG.gate}: 1 event matched]\n\n${referenceLine(1, line.shown, line.at, now)}`;
 }
 /** The event's own stored entry, as the framework is asked about it. */
 function entryRef(event) {
@@ -1476,32 +1478,69 @@ function globAtLeastAsBroad(earlier, later) {
         return true;
     return earlier === later;
 }
+/** The event types the gate can see from an MCPL server: its pushes and its
+ *  channels' messages. */
+export const MCPL_GATE_EVENT_TYPES = ['mcpl:push-event', 'mcpl:channel-incoming'];
+/** The event types `rule` can match: its scope's, narrowed to those its
+ *  source is known to send; 'all' when neither says. */
+function typesSeenBy(rule, eventTypesFrom) {
+    const scope = rule.match.scope && rule.match.scope.length > 0 ? rule.match.scope : undefined;
+    const source = rule.match.source;
+    let sent;
+    if (eventTypesFrom && source !== undefined && !source.includes('*')) {
+        try {
+            sent = eventTypesFrom(source);
+        }
+        catch {
+            sent = undefined;
+        }
+    }
+    if (scope && sent)
+        return { types: scope.filter((t) => sent.includes(t)), known: true };
+    if (scope)
+        return { types: scope, known: true };
+    if (sent)
+        return { types: [...sent], known: true };
+    return { types: 'all', known: false };
+}
 /**
- * Event types for which `earlier` provably matches EVERY event that `later`
- * would match — i.e. the types for which `later` is unreachable when
- * `earlier` sits before it and consumes its matches. Returns null when
- * subsumption can't be proven (which is not proof of safety — the lint is
- * deliberately one-sided so every warning it emits is true).
+ * Whether `earlier` provably matches events `later` would match, so that
+ * `later` doesn't see them when `earlier` sits before it and consumes its
+ * matches: the event types concerned, whether that's every event `later`
+ * would match, and whether `later` is known to see those types. Returns null
+ * when it can't be proven (which is not proof of safety — the lint is
+ * deliberately one-sided so every note it emits is true).
  */
-function subsumedEventTypes(earlier, later) {
+function subsumedEventTypes(earlier, later, eventTypesFrom) {
     const e = earlier.match;
     const l = later.match;
-    // Scope: which of `later`'s event types does `earlier` cover?
-    let covered;
-    if (!e.scope || e.scope.length === 0) {
-        covered = l.scope && l.scope.length > 0 ? l.scope : 'all';
-    }
-    else if (!l.scope || l.scope.length === 0) {
-        // `later` matches all types; `earlier` only consumes its own scope, so
-        // the shadow is partial — exactly those types.
-        covered = e.scope;
+    // Event types: which of those `later` can match does `earlier` cover?
+    const seen = typesSeenBy(later, eventTypesFrom);
+    const earlierTypes = e.scope && e.scope.length > 0 ? e.scope : 'all';
+    let eventTypes;
+    let whole;
+    let known = seen.known;
+    if (earlierTypes === 'all') {
+        eventTypes = seen.types;
+        whole = true;
+    }
+    else if (seen.types === 'all') {
+        // `later` matches every type; `earlier` only consumes its own scope, so
+        // the overlap is partial — exactly those types, which may never reach
+        // `later`.
+        eventTypes = earlierTypes;
+        whole = false;
     }
     else {
-        const overlap = l.scope.filter((t) => e.scope.includes(t));
+        const overlap = seen.types.filter((t) => earlierTypes.includes(t));
         if (overlap.length === 0)
             return null;
-        covered = overlap;
+        eventTypes = overlap;
+        whole = overlap.length === seen.types.length;
+        known = true;
     }
+    if (Array.isArray(eventTypes) && eventTypes.length === 0)
+        return null;
     // Every remaining discriminator on `earlier` must be at least as broad as
     // `later`'s, otherwise some `later` events slip past `earlier`.
     if (!globAtLeastAsBroad(e.source, l.source))
@@ -1533,37 +1572,54 @@ function subsumedEventTypes(earlier, later) {
         return null;
     if (e.tagsNone && !subsetOf(e.tagsNone, l.tagsNone ?? []))
         return null;
-    return covered;
+    return { eventTypes, whole, known };
 }
 /**
- * Find rules made unreachable by earlier, broader rules (first match wins).
+ * Find rules an earlier, broader rule keeps from applying (first match wins),
+ * in whole or for some event types.
  * The 2026-08-08 Mythos incident is the canonical catch: a prepended
  * `{scope:[mcpl:channel-incoming]}` sampler silently made the
  * direct-address and mention rules dead for the whole incoming lane.
  * `passthrough` observers shadow nothing — non-firing matches fall through.
+ * `eventTypesFrom` leaves out types a rule's source is known never to send:
+ * a rule for an MCPL server's events isn't told about another rule that
+ * takes every `external-message`.
  */
-export function findShadowedPolicies(policies) {
+export function findShadowedPolicies(policies, eventTypesFrom) {
     const out = [];
     for (let i = 0; i < policies.length; i++) {
         const earlier = policies[i];
         if (earlier.passthrough)
             continue;
         for (let j = i + 1; j < policies.length; j++) {
-            const covered = subsumedEventTypes(earlier, policies[j]);
-            if (covered) {
-                out.push({ earlier: earlier.name, later: policies[j].name, eventTypes: covered });
+            const found = subsumedEventTypes(earlier, policies[j], eventTypesFrom);
+            if (found) {
+                out.push({ earlier: earlier.name, later: policies[j].name, ...found });
             }
         }
     }
     return out;
 }
-/** Human-readable one-liner for a ShadowWarning, used in tool results,
- *  traces, and gate_status alike so the same hazard reads the same way
- *  everywhere. */
+/** A ShadowWarning in words, used in tool results, traces, and gate_status
+ *  alike so the same note reads the same way everywhere. It says which of
+ *  three it is (the rule never applies; it misses some of its events; it
+ *  may not be meant for those events at all) and what to do. */
 export function formatShadowWarning(w) {
-    const types = w.eventTypes === 'all' ? 'ALL event types' : w.eventTypes.join(', ');
-    return `rule "${w.earlier}" makes "${w.later}" unreachable for ${types} `
-        + `(first match wins — every event "${w.later}" would match is consumed by "${w.earlier}" first)`;
+    const later = `"${w.later}"`;
+    const earlier = `"${w.earlier}"`;
+    const move = `move ${later} above ${earlier} (wake_add_rule with the whole rule and insertBefore: "${w.earlier}")`;
+    if (w.whole) {
+        return `${later} never applies: ${earlier} comes first and matches every event ${later} would. `
+            + `If ${later} should apply, ${move}, or narrow ${earlier}.`;
+    }
+    const types = w.eventTypes === 'all' ? 'all' : w.eventTypes.join(', ');
+    if (w.known) {
+        return `${earlier} comes first and takes ${later}'s ${types} events, so ${later} applies only to its others. `
+            + `If it should apply to those too, ${move}.`;
+    }
+    return `${earlier} comes first and takes every ${types} event, so ${later} sees none. `
+        + `Nothing to do unless ${later} is meant for ${types} events; then ${move}. `
+        + `A scope on ${later} naming the event types it's for clears this note.`;
 }
 /** The text of a thrown value, for a log line. It never throws itself, whatever was thrown. */
 function errorText(err) {
@@ -1682,10 +1738,12 @@ export class EventGate {
     droppedBufferedEvents = 0;
     // Per-policy stats
     stats = new Map();
-    // Shadow-lint cache (see refreshShadowWarnings) — recomputed on every
-    // config change, fingerprinted so an unchanged hazard set doesn't re-trace.
-    shadowWarningsCache = [];
+    // The shadow lint's last findings (see refreshShadowWarnings), recomputed
+    // on every config change and fingerprinted so an unchanged set doesn't
+    // re-trace.
     shadowWarningsFingerprint = '[]';
+    /** See the constructor's `eventTypesFrom`. */
+    eventTypesFromFn;
     // Observability counters for events that didn't match any policy
     totalEvaluations = 0;
     defaultTriggered = 0;
@@ -1743,6 +1801,7 @@ export class EventGate {
         this.resolveRouteChannelFn = opts.resolveRouteChannel ?? defaultRouteChannel;
         this.channelShownFn = opts.channelShown;
         this.isNewestEntryFn = opts.isNewestEntry;
+        this.eventTypesFromFn = opts.eventTypesFrom;
         this.now = opts.now ?? (() => Date.now());
         this.judgeFn = opts.judge;
         this.changesJudgedContextFn = opts.changesJudgedContext;
@@ -2988,22 +3047,31 @@ export class EventGate {
     /** Current shadow-lint findings for the live policy order. Fresh compute —
      *  cheap (policy lists are tens of entries at most). */
     lintShadows() {
-        return findShadowedPolicies(this.config.policies);
+        return findShadowedPolicies(this.config.policies, this.eventTypesFromFn);
+    }
+    /**
+     * The sources the host knows changed (eventTypesFrom answers differently),
+     * as when an MCPL server connects or is removed: the rule-order notes are
+     * made again, and traced if they changed, as a change to the rules would.
+     */
+    sourcesChanged() {
+        this.refreshShadowWarnings('sources-changed');
     }
     /**
-     * Recompute shadow warnings and, when the set changed and is non-empty,
-     * emit a `gate:shadow-warnings` trace so the hazard lands in ops
-     * observability at the moment the order changed — not at the next missed
-     * DM. Called from writeConfig and reloadIfChanged.
+     * Recompute shadow warnings and, when the set changed, emit a
+     * `gate:shadow-warnings` trace so the hazard lands in ops observability at
+     * the moment the order changed — not at the next missed DM — and, with an
+     * empty list, the moment the last of them went. Called from writeConfig,
+     * reloadIfChanged and sourcesChanged.
      */
     refreshShadowWarnings(reason) {
         const warnings = this.lintShadows();
         const fingerprint = JSON.stringify(warnings);
         if (fingerprint === this.shadowWarningsFingerprint)
             return;
+        const hadSome = this.shadowWarningsFingerprint !== '[]';
         this.shadowWarningsFingerprint = fingerprint;
-        this.shadowWarningsCache = warnings;
-        if (warnings.length > 0) {
+        if (warnings.length > 0 || hadSome) {
             this.emitTrace({
                 type: 'gate:shadow-warnings',
                 reason,
@@ -3144,7 +3212,7 @@ export class EventGate {
         // Only events with no context entry of their own carry their content.
         const quoted = events.filter(e => !e.inContext);
         const referenced = events.filter(e => e.inContext);
-        const lines = quoted.map(e => `- [${e.policyName}] (${e.eventType}): ${e.content}`);
+        const lines = quoted.map(e => `- [${e.policyName}] (${e.eventType}): ${suppliedValue(e.content)}`);
         // How each referenced channel is named in the line, in order.
         const shown = [];
         if (referenced.length > 0) {
@@ -3163,7 +3231,7 @@ export class EventGate {
                     ? '(unknown channel)'
                     : e.routeChannelId !== undefined && e.serverId !== undefined && this.channelShownFn
                         ? this.channelShownFn({ serverId: e.serverId, channelId: e.routeChannelId })
-                        : id;
+                        : suppliedValue(id);
                 const key = JSON.stringify([e.serverId ?? null, id ?? null]);
                 const entry = byChannel.get(key) ?? { name, count: 0, oldest: e.timestamp, label: e.channelLabel };
                 entry.count += 1;
@@ -3176,7 +3244,7 @@ export class EventGate {
                 // agent can still address tools that want the composite id. A name
                 // may carry its own `#`, so one is added only where the name lacks
                 // it, as at the other places that add a `#`.
-                const channel = label ? `${label.startsWith('#') ? label : `#${label}`} (${name})` : name;
+                const channel = label ? `${label.startsWith('#') ? '' : '#'}${suppliedValue(label)} (${name})` : name;
                 shown.push(channel);
                 lines.push(referenceLine(count, channel, oldest, Date.now()));
             }
@@ -3188,7 +3256,7 @@ export class EventGate {
         // gate hands the line to the wake (WakeProvenance.line) and a fresh start
         // of the wake's turn decides it (WakeLine). Several messages, one with
         // anything after it, or content the line quotes, keep the line now.
-        const text = `[Gate: ${events.length} event${events.length > 1 ? 's' : ''} matched]\n\n${lines.join('\n')}`;
+        const text = `[${NOTICE_TAG.gate}: ${events.length} event${events.length > 1 ? 's' : ''} matched]\n\n${lines.join('\n')}`;
         const only = events.length === 1 && events[0].inContext ? events[0] : undefined;
         let line;
         if (only && this.newestEntry(only)) {
@@ -3431,7 +3499,7 @@ export class EventGate {
         record.last = {
             at: Date.now(),
             verdict: outcome,
-            reason: safeSlice(reason, 0, 300),
+            reason: cutToFit(suppliedValue(reason), 300),
             eventCount: state.events.length,
             durationMs,
             ...(!failed && typeof verdict.inputTokens === 'number' ? { inputTokens: verdict.inputTokens } : {}),
@@ -3440,7 +3508,7 @@ export class EventGate {
             this.judgeRecords.set(policyName, record);
         if (failed) {
             this.judgeFailStreak++;
-            this.judgeLastFailure = safeSlice(reason, 0, 200);
+            this.judgeLastFailure = cutToFit(suppliedValue(reason), 200);
         }
         else {
             this.judgeFailStreak = 0;
@@ -3752,7 +3820,7 @@ export class EventGate {
             const placement = {};
             this.addMessageFn('user', [{
                     type: 'text',
-                    text: `[self-wake] your ${source} timer (${Math.round(ms / 1000)}s) elapsed — now ${nowIso}`,
+                    text: `[${NOTICE_TAG.selfWake}] your ${source} timer (${Math.round(ms / 1000)}s) elapsed — now ${nowIso}`,
                 }], { source: 'gate:self-wake' }, agentName, placement);
             this.requestInferenceFn(agentName, `self-scheduled wake (${source}, ${Math.round(ms / 1000)}s)`, 'self-wake', undefined, placement);
         }, ms);
@@ -4008,7 +4076,9 @@ export class EventGate {
                 this.judgeUnwiredNotice(), this.judgeFailingNotice(),
             ]
                 .filter((e) => e !== null),
-            shadowWarnings: this.shadowWarningsCache.map(formatShadowWarning),
+            // Fresh, not the cache: the sources the host knows (eventTypesFrom)
+            // change as servers connect, with no change to the rules.
+            shadowWarnings: this.lintShadows().map(formatShadowWarning),
             totalEvaluations: this.totalEvaluations,
             defaultDecisions: {
                 triggered: this.defaultTriggered,