@animalabs/agent-framework 0.32.0 → 0.34.0

package/dist/src/gate/suppression-stats.js

@@ -0,0 +1,214 @@
+/**
+ * What the agent's suppress rules have kept out of its context
+ * (`suppression_stats`), read from the stored rows themselves: each carries
+ * the record a suppress rule stamped on it as it arrived
+ * (`metadata.suppressed = { rule, eventType }`, the framework's
+ * suppressedRow). The rows are the record, so the counts cover every start
+ * of the host and follow the branch the store is on, and nothing beside
+ * them is kept.
+ */
+/** Longest preview shown, in characters. */
+export const SUPPRESSION_PREVIEW_CHARS = 160;
+/** Most recent rows shown per rule. */
+export const MAX_RECENT = 20;
+const DEFAULT_RECENT = 3;
+const MAX_KEYS = 10;
+/** The record a row carries when a suppress rule took it, or undefined. */
+export function suppressionRecordOf(metadata) {
+    const record = metadata?.suppressed;
+    if (!record || typeof record !== 'object')
+        return undefined;
+    const { rule, eventType, source } = record;
+    if (typeof rule !== 'string')
+        return undefined;
+    return {
+        rule,
+        ...(typeof eventType === 'string' && eventType !== '' ? { eventType } : {}),
+        ...(typeof source === 'string' && source !== '' ? { source } : {}),
+    };
+}
+/** Where a suppressed row came from: the source its record names (a module's, which its metadata may not), else its server. */
+function sourceOf(row, record) {
+    if (record?.source)
+        return record.source;
+    const serverId = row.metadata?.serverId;
+    return typeof serverId === 'string' && serverId !== '' ? serverId : undefined;
+}
+/** The author a row names: a channel message's `author.name`, or a push event's `authorName`. */
+function authorOf(md) {
+    const name = md.author?.name ?? md.authorName;
+    return typeof name === 'string' && name !== '' ? name : undefined;
+}
+const textOf = (row) => row.content.filter((b) => b.type === 'text' && typeof b.text === 'string').map((b) => b.text).join('\n');
+const msOf = (timestamp) => timestamp instanceof Date ? timestamp.getTime() : typeof timestamp === 'number' ? timestamp : Date.parse(timestamp);
+const isoOf = (ms) => (Number.isFinite(ms) ? new Date(ms).toISOString() : 'unknown');
+/** A text on one line, cut at SUPPRESSION_PREVIEW_CHARS characters (code points), with an ellipsis where cut. */
+function previewOf(text) {
+    const line = text.replace(/\s+/g, ' ').trim();
+    const chars = [...line];
+    return chars.length <= SUPPRESSION_PREVIEW_CHARS ? line : `${chars.slice(0, SUPPRESSION_PREVIEW_CHARS - 1).join('')}…`;
+}
+/** Counts, the largest first; past MAX_KEYS, the rest summed as "(others)". Built from entries, so any name, "__proto__" included, is a key of its own. */
+function topCounts(counts) {
+    const sorted = [...counts].sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]));
+    const entries = sorted.slice(0, MAX_KEYS);
+    const rest = sorted.slice(MAX_KEYS).reduce((sum, [, n]) => sum + n, 0);
+    if (rest > 0)
+        entries.push(['(others)', rest]);
+    return Object.fromEntries(entries);
+}
+function shown(row, record) {
+    const md = row.metadata ?? {};
+    const source = sourceOf(row, record);
+    const channel = typeof md.channelId === 'string' && md.channelId !== '' ? md.channelId : undefined;
+    const author = authorOf(md);
+    return {
+        id: row.id,
+        at: isoOf(msOf(row.timestamp)),
+        eventType: record?.eventType ?? 'unknown',
+        ...(source ? { source } : {}),
+        ...(channel ? { channel } : {}),
+        ...(author ? { author } : {}),
+        preview: previewOf(textOf(row)),
+    };
+}
+/**
+ * The stats for `rows` (a message slot, oldest first), with every suppress
+ * rule in force listed even where it has hidden nothing yet. Rules in force
+ * come first, in gate.json's order; rules no longer in force follow, the
+ * most recently active first.
+ */
+export function suppressionStats(rows, inForce, opts = {}) {
+    const recentWanted = Math.max(0, Math.min(MAX_RECENT, Math.floor(opts.recent ?? DEFAULT_RECENT)));
+    const tallies = new Map();
+    let total = 0;
+    let totalCharacters = 0;
+    for (const row of rows) {
+        const record = suppressionRecordOf(row.metadata);
+        if (!record)
+            continue;
+        if (opts.rule !== undefined && record.rule !== opts.rule)
+            continue;
+        const at = msOf(row.timestamp);
+        if (opts.sinceMs !== undefined && !(at >= opts.sinceMs))
+            continue;
+        let tally = tallies.get(record.rule);
+        if (!tally) {
+            tally = { suppressed: 0, characters: 0, first: at, last: at, bySource: new Map(), byEventType: new Map(), recent: [] };
+            tallies.set(record.rule, tally);
+        }
+        const characters = [...textOf(row)].length;
+        tally.suppressed++;
+        tally.characters += characters;
+        if (at < tally.first)
+            tally.first = at;
+        if (at > tally.last)
+            tally.last = at;
+        const source = sourceOf(row, record) ?? '(none)';
+        tally.bySource.set(source, (tally.bySource.get(source) ?? 0) + 1);
+        const eventType = record.eventType ?? 'unknown';
+        tally.byEventType.set(eventType, (tally.byEventType.get(eventType) ?? 0) + 1);
+        if (recentWanted > 0) {
+            tally.recent.push({ row, record });
+            if (tally.recent.length > recentWanted)
+                tally.recent.shift();
+        }
+        total++;
+        totalCharacters += characters;
+    }
+    const ruleStats = (name, rule) => {
+        const tally = tallies.get(name);
+        return {
+            rule: name,
+            inForce: rule !== undefined,
+            ...(rule !== undefined ? { sinceStart: rule.sinceStart } : {}),
+            suppressed: tally?.suppressed ?? 0,
+            characters: tally?.characters ?? 0,
+            ...(tally ? { first: isoOf(tally.first), last: isoOf(tally.last) } : {}),
+            bySource: tally ? topCounts(tally.bySource) : {},
+            byEventType: tally ? topCounts(tally.byEventType) : {},
+            recent: tally ? tally.recent.slice().reverse().map(({ row, record }) => shown(row, record)) : [],
+        };
+    };
+    const listed = new Set();
+    const out = [];
+    for (const rule of inForce) {
+        if (listed.has(rule.name) || (opts.rule !== undefined && rule.name !== opts.rule))
+            continue;
+        listed.add(rule.name);
+        out.push(ruleStats(rule.name, rule));
+    }
+    const gone = [...tallies.keys()].filter((name) => !listed.has(name))
+        .sort((a, b) => tallies.get(b).last - tallies.get(a).last || a.localeCompare(b));
+    for (const name of gone)
+        out.push(ruleStats(name, undefined));
+    return { rules: out, total, totalCharacters };
+}
+/** A row's content as text: text blocks as written, any other block named in brackets. */
+function fullTextOf(row) {
+    return row.content
+        .map((b) => (b.type === 'text' && typeof b.text === 'string' ? b.text : `[${b.type}]`))
+        .join('\n');
+}
+/** The suppressed rows among `rows`, oldest first, their text in full; times are when each was stored. */
+export function suppressedRecords(rows, opts = {}) {
+    const out = [];
+    for (const row of rows) {
+        const record = suppressionRecordOf(row.metadata);
+        if (!record || (opts.rule !== undefined && record.rule !== opts.rule))
+            continue;
+        const at = msOf(row.timestamp);
+        if (opts.sinceMs !== undefined && !(at >= opts.sinceMs))
+            continue;
+        if (opts.untilMs !== undefined && !(at < opts.untilMs))
+            continue;
+        const { source, channel, author } = shown(row, record);
+        out.push({
+            id: row.id,
+            at: isoOf(at),
+            rule: record.rule,
+            eventType: record.eventType ?? 'unknown',
+            ...(source ? { source } : {}),
+            ...(channel ? { channel } : {}),
+            ...(author ? { author } : {}),
+            text: fullTextOf(row),
+        });
+    }
+    return out;
+}
+/**
+ * A dump's file content, at most `maxBytes` (UTF-8): the newest records that
+ * fit, oldest first, and how many older ones were left out to fit. A
+ * transcript opens with a header naming what it holds (`title`, given how
+ * many it holds and the oldest's time) and, when some were left out, how many.
+ */
+export function renderSuppressedDump(records, format, opts) {
+    const entry = (r) => format === 'jsonl'
+        ? `${JSON.stringify(r)}\n`
+        : `[${r.at}] ${r.rule} · ${r.eventType}${r.source ? ` · ${r.source}` : ''}${r.channel ? ` · ${r.channel}` : ''}`
+            + `${r.author ? ` · ${r.author}` : ''} · ${r.id}\n${r.text}\n\n`;
+    const entries = records.map(entry);
+    const titleOf = (from) => typeof opts.title === 'string'
+        ? opts.title
+        : opts.title(entries.length - from, records[from]?.at ?? '');
+    const header = (from) => format === 'jsonl'
+        ? ''
+        : `# ${titleOf(from)}\n${from > 0 ? `(${from} older events left out to fit)\n` : ''}\n`;
+    // The most records, newest first, that fit beside the header they make:
+    // the header names how many were left out, so it's sized for each count.
+    let bytes = 0;
+    let from = entries.length;
+    let best = entries.length;
+    while (from > 0) {
+        bytes += Buffer.byteLength(entries[from - 1]);
+        from--;
+        if (Buffer.byteLength(header(from)) + bytes <= opts.maxBytes)
+            best = from;
+        else if (bytes > opts.maxBytes)
+            break;
+    }
+    if (best === entries.length)
+        return { content: '', written: 0, omitted: entries.length };
+    return { content: header(best) + entries.slice(best).join(''), written: entries.length - best, omitted: best };
+}
+//# sourceMappingURL=suppression-stats.js.map

package/dist/src/gate/suppression-stats.js.map

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

package/dist/src/gate/types.d.ts

@@ -165,6 +165,79 @@ export interface GatePolicy {
      * fire" has no meaning distinct from the behavior itself.
      */
     passthrough?: boolean;
+    /**
+     * Suppression: an event this rule takes is stored in the chronicle and
+     * never rendered into the residents' context. It isn't compiled, injected
+     * at a tool boundary, folded into memory, woken for, or counted as the
+     * latest inbound. The framework decides this once, as the event arrives
+     * (`EventGate.decideSuppression`), and stamps the row
+     * (`metadata.suppressed = { rule, eventType }`). The view filters read only
+     * that stamp, so changing the rule later never changes what was already
+     * rendered or hidden: a removed rule stops suppressing from then on, and
+     * the rows it hid stay hidden.
+     *
+     * The rule needs `behavior: "defer"` (or the legacy `"skip"`), so a release
+     * that doesn't know `suppress` defers its events instead of waking the
+     * agent on them, and a match that narrows something. Rules stay
+     * first-match, with three exceptions: an event addressed to the agent
+     * (`chat:addressed`), a heartbeat, and console or API input are never
+     * suppressed. The rule lets them by, and the rules after it decide them.
+     * A suppress rule decides no wake for an event suppression was asked about
+     * (`evaluate` and `probe` pass over it there, `GateEventInfo.suppressionAsked`);
+     * where suppression wasn't asked, it defers, as its behavior says.
+     */
+    suppress?: SuppressConfig;
+}
+/** A suppress rule's own settings (GatePolicy.suppress). */
+export interface SuppressConfig {
+    /**
+     * What the rule is for, in the agent's words ("the eye going on and off").
+     * Required: the periodic review (SuppressionReviewOptions), where the host
+     * runs it, checks a sample of the events the rule hid against it.
+     */
+    description: string;
+    /**
+     * The agent's own logic for the rule, when matching isn't enough: the
+     * source of a function `(event, state) => boolean`, called for each event
+     * the rule's match takes that reaches it (one an earlier rule decides, an
+     * addressed one, or the heartbeat's never does), only `true` hiding it. `event` is the event's type,
+     * source, channel, author, tags, text, arrival time (`at`, ms) and
+     * metadata. `state` is the rule's own JSON object, which the script reads
+     * and changes as it likes, kept between events and across restarts
+     * (suppress-scripts.ts), and started afresh when the script changes or the
+     * rule is removed. So a rule can hide repeats, count, or keep a window of
+     * its own. A script that throws or runs past its time counts as saying
+     * show: the event goes on to the rules after it. Left out, every event the
+     * rule matches is hidden.
+     */
+    script?: string;
+}
+/**
+ * The periodic review of what suppress rules hid (src/gate/suppression-review.ts):
+ * every `intervalMs`, for each rule that hid events since the last review, a
+ * small model reads the rule's description and the events it hid (a sample,
+ * past `maxEventsPerRule`) and flags any that don't fit the description or
+ * that the agent would plausibly need to see. The agent is told what each
+ * rule hid and what was flagged, in a `[suppression review]` notice; a
+ * flagged event wakes it.
+ */
+export interface SuppressionReviewOptions {
+    /** False turns the review off. Default true. */
+    enabled?: boolean;
+    /** How often, in ms. Default 2 hours; at least 10 minutes. */
+    intervalMs?: number;
+    /** The reviewer's model, as the host's membrane names it. Default `claude-haiku-5-5`. */
+    model?: string;
+    /** When the agent is told: after every review in which a rule hid something (`"always"`, the default), or only when an event was flagged (`"flagged"`). */
+    notify?: 'always' | 'flagged';
+    /** Whether a flagged event wakes the agent, which is a full turn of its own model, so a false flag costs that turn. Default true. */
+    wakeOnFlag?: boolean;
+    /** The most events of one rule the reviewer reads in one review, spread across the period. Default 60. */
+    maxEventsPerRule?: number;
+    /** How long one rule's review may take, in ms. Default 60,000. */
+    timeoutMs?: number;
+    /** The reviewer's effort (`output_config.effort`); `"none"` sends none. Default `"low"`. */
+    effort?: 'low' | 'medium' | 'high' | 'none';
 }
 /** Top-level gate configuration, stored in gate.json. */
 export interface GateConfig {
@@ -199,6 +272,21 @@ export interface GateOptions {
      *  null), the judge is wired with its defaults; it runs only for `judge`
      *  rules, so a gate with none makes no judge calls. */
     judge?: ReplyJudgeOptions | null;
+    /**
+     * The periodic review of what suppress rules hid (SuppressionReviewOptions).
+     * On by default wherever a gate is; false turns it off.
+     */
+    suppressionReview?: SuppressionReviewOptions | false;
+    /** How long a suppress rule's script may take for one event before the event is shown (ms). Default 50. */
+    suppressScriptTimeoutMs?: number;
+    /**
+     * Wake onboarding (gate/wake-onboarding.ts): the first event from an MCPL
+     * server that the agent's rules let go by without deciding about it brings
+     * the agent that server's suggested treatment (MCPL RFC-001 §5), once per
+     * declared ontology, with `wake_accept_suggestions` / `wake_decline` to
+     * answer. On unless set to false.
+     */
+    onboarding?: boolean;
 }
 /**
  * Host options for the reply judge, the small model `judge` rules ask whether
@@ -253,6 +341,8 @@ export interface JudgeEventSummary {
     /** When the event arrived (ms). */
     at: number;
 }
+/** The kinds of UpcomingWake. */
+export type UpcomingWakeKind = 'heartbeat' | 'reminder' | 'self-wake' | 'sleep-end' | 'debounce' | 'judge-batch' | 'queued' | 'provider-hold';
 /**
  * Something that will (or, for a batch going to the judge, may) wake the
  * agent with no new event: what the judge is told would happen if it answers
@@ -265,6 +355,9 @@ export interface UpcomingWake {
     certain: boolean;
     /** What it is, as the judge is told ("its own skip_reply timer"). */
     what: string;
+    /** What it is, in a word that quotes nothing, for healthSnapshot: `what` can
+     *  quote a reminder or a queue reason. The judge isn't told it. */
+    kind?: UpcomingWakeKind;
 }
 /** What the gate asks the reply judge for one batch. */
 export interface JudgeRequest {
@@ -365,6 +458,27 @@ export interface GateEventInfo {
     paths?: string[];
     /** Event tags (MCPL RFC-001), already implication-expanded by the host. */
     tags?: string[];
+    /** The agents admission delivered a targeted event to (its targetAgents).
+     *  A debounced batch wakes each agent with the events it may see, those
+     *  naming it and those naming no agent, and agents that may see the same
+     *  events share one line. Absent for an untargeted event, whose batch wakes
+     *  every agent getAgentNames lists. */
+    recipients?: readonly string[];
+    /**
+     * Set when the framework asked whether the event is suppressed before it
+     * asked about its wake (decideSuppression), so a suppress rule that
+     * matches it let it by. Left out, a suppress rule defers the events it
+     * matches, as its behavior says: suppression wasn't asked, as for an event
+     * that lands where no view hides suppressed rows.
+     */
+    suppressionAsked?: boolean;
+    /**
+     * A coalesced render, which folds its batch's every occurrence while its
+     * `tags` are the latest's (MCPL RFC-006): never taken as a `chat:system`
+     * notice, as the render's own wake isn't, so a message it folds keeps
+     * its channel when a notice came last.
+     */
+    folds?: true;
 }
 /** An MCPL event whose content the framework stored at arrival, as a
  *  batched wake names it to the framework (EventGate's `isNewestEntry`):
@@ -381,13 +495,13 @@ export interface GateEntryRef {
  *  than wrote: its batch was one event whose entry was still the newest in
  *  the window when the batch fired (EventGate's `isNewestEntry`). A fresh
  *  start of the wake's turn decides it (the framework's placeWakeLines): the
- *  delivery agent's own start leaves it out while that entry is still the
- *  newest, and writes it once something follows; a co-resident's start
- *  places none; two or more such lines are each written;
- *  and none is written while the host is quiesced or another reader of the
- *  residents' shared slot has a turn alive. A line left out stays for a
- *  later fresh start of the same wake. Its text is rendered when it's
- *  written (wakeLineText), so its age is true then.
+ *  delivery agent's start, and on a presented window each resident's own
+ *  start, decides its own line, leaving it out while that entry is still
+ *  the newest in its window and writing it once something follows; a
+ *  co-resident whose window isn't presented places none; two or more such
+ *  lines are each written; and none is written while the host is quiesced.
+ *  A line left out stays for a later fresh start of the same wake. Its text
+ *  is rendered when it's written (wakeLineText), so its age is true then.
  *
  *  Every request for one wake carries the same object: the framework writes
  *  each line once by its identity, across the wake's retries and holds. A
@@ -411,6 +525,17 @@ export interface GatePolicyStats {
     behavior: GateBehavior;
     matchCount: number;
     lastMatchTimestamp: number | null;
+    /**
+     * Present on a suppress rule: its settings, and with a script, how the
+     * script has run since this process started. Its `matchCount` and
+     * `lastMatchTimestamp` count the events it took since then: those it
+     * suppressed, and those it only deferred where suppression wasn't asked
+     * (a channel under conversation routing). `suppression_stats` reads the
+     * stamped rows themselves, so its counts cover every start.
+     */
+    suppress?: SuppressConfig & {
+        scriptStatus?: import('./suppress-scripts.js').SuppressScriptStatus;
+    };
     debounceState?: {
         pendingCount: number;
         nextDeliveryMs: number | null;
@@ -466,6 +591,16 @@ export interface GateStatus {
      * same hazards wake_add_rule warns about at install time.
      */
     shadowWarnings: string[];
+    /**
+     * The first rule that takes MCPL servers' events without naming a server, a
+     * channel or a tag (gate/wake-onboarding.ts placementFor): every server
+     * connected later is handled by it until a rule for that server goes ahead of
+     * it. Absent when there is none.
+     */
+    catchAll?: {
+        rule: string;
+        note: string;
+    };
     /** Total events the gate has evaluated since startup. */
     totalEvaluations: number;
     /**

package/dist/src/gate/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/gate/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd;yCACqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,WAAW;IAC1B,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,0DAA0D;AAC1D,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,OAAO,GACP,MAAM,GACN;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GACpB;IAAE,UAAU,EAAE,eAAe,CAAA;CAAE,GAC/B;IAAE,cAAc,EAAE,mBAAmB,CAAA;CAAE,GACvC;IAAE,KAAK,EAAE,WAAW,CAAA;CAAE,CAAC;AAM3B,mFAAmF;AACnF,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;+EAK2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAMD,kEAAkE;AAClE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,eAAe,CAAC;IACvB,QAAQ,EAAE,YAAY,CAAC;IACvB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB;;;;;;;;;;;;;;OAcG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAMD,yDAAyD;AACzD,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;CACvC;AAMD,iEAAiE;AACjE,MAAM,WAAW,WAAW;IAC1B,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;2DAEuD;IACvD,KAAK,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;CAClC;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC;;oEAEgE;IAChE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;8BAC0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;qCACiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;uDAEmD;IACnD,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B;;4CAEwC;IACxC,MAAM,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IAC5C;;6DAEyD;IACzD,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CACxB;AAED,4DAA4D;AAC5D,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,SAAS,EAAE,OAAO,CAAC;IACnB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,2FAA2F;IAC3F,OAAO,EAAE,OAAO,CAAC;IACjB,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wDAAwD;AACxD,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,uCAAuC;IACvC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB;;oEAEgE;IAChE,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;IAC/B,mEAAmE;IACnE,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,8CAA8C;AAC9C,MAAM,WAAW,YAAY;IAC3B,4DAA4D;IAC5D,KAAK,EAAE,OAAO,CAAC;IACf,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wFAAwF;IACxF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qEAAqE;AACrE,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;AAMvE,0DAA0D;AAC1D,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,6DAA6D;IAC7D,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,qCAAqC;IACrC,QAAQ,EAAE,YAAY,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd;;6EAEyE;IACzE,UAAU,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAC7B;yBACqB;IACrB,KAAK,EAAE,OAAO,CAAC;IACf;;;2CAGuC;IACvC,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC3B,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC;IACjB;gEAC4D;IAC5D,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;+BAG+B;AAC/B,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;gCAegC;AAChC,MAAM,WAAW,QAAQ;IACvB,6BAA6B;IAC7B,KAAK,EAAE,YAAY,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd;8CAC0C;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,YAAY,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,aAAa,CAAC,EAAE;QACd,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;KAC/B,CAAC;IACF,0CAA0C;IAC1C,cAAc,CAAC,EAAE;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,8CAA8C;IAC9C,kBAAkB,CAAC,EAAE;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,qCAAqC;IACrC,UAAU,CAAC,EAAE;QACX,8DAA8D;QAC9D,YAAY,EAAE,MAAM,CAAC;QACrB,oEAAoE;QACpE,OAAO,EAAE,OAAO,CAAC;QACjB,qFAAqF;QACrF,SAAS,EAAE,MAAM,CAAC;QAClB,gFAAgF;QAChF,QAAQ,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QACzD,0BAA0B;QAC1B,IAAI,CAAC,EAAE;YACL,EAAE,EAAE,MAAM,CAAC;YACX,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;YACpC,MAAM,EAAE,MAAM,CAAC;YACf,UAAU,EAAE,MAAM,CAAC;YACnB,UAAU,EAAE,MAAM,CAAC;YACnB,WAAW,CAAC,EAAE,MAAM,CAAC;SACtB,CAAC;KACH,CAAC;CACH;AAED,qDAAqD;AACrD,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IAC7C,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,OAAO,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;IACrC,0DAA0D;IAC1D,MAAM,EAAE,OAAO,kBAAkB,EAAE,gBAAgB,CAAC;IACpD,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB;;;;OAIG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,yDAAyD;IACzD,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;;;;OAMG;IACH,gBAAgB,EAAE;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACrE,CAAC;IACF,+DAA+D;IAC/D,KAAK,CAAC,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,0EAA0E;QAC1E,UAAU,EAAE,MAAM,CAAC;QACnB,gEAAgE;QAChE,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/gate/types.ts"],"names":[],"mappings":"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"}

package/dist/src/gate/wake-onboarding.d.ts

@@ -0,0 +1,119 @@
+import type { GateBehavior, GateDecision, GatePolicy } from './types.js';
+/**
+ * Tags that say an event is addressed to the agent or waiting on it (MCPL
+ * RFC-001 `chat:addressed`, RFC-014 `surface:turn`/`surface:alert`; not
+ * `surface:invite`, which only suggests). The first undecided event carrying
+ * one wakes the agent to decide; any other undecided event leaves its offer
+ * for the agent's next turn.
+ */
+export declare const ATTENTION_TAGS: readonly string[];
+/** Accepted rules are named `suggested:<server>:<n>`: the name is the attribution. */
+export declare const SUGGESTED_RULE_PREFIX = "suggested:";
+export declare const suggestedRuleName: (server: string, n: number) => string;
+/** Exactly `suggested:<server>:<n>`: a server id that another extends (`games`, `games:beta`) never claims the other's rules. */
+export declare const isSuggestedRuleOf: (name: string, server: string) => boolean;
+/** One of a server's suggestions as the host offers it: the server's words and the rule it becomes. */
+export interface OfferedRule {
+    /** 1-based: the number `wake_accept_suggestions` takes it by. */
+    n: number;
+    /** The feature set that declared it; empty for the host's own fallback. */
+    featureSet: string;
+    match: {
+        tagsAny?: string[];
+        tagsAll?: string[];
+        tagsNone?: string[];
+    };
+    /** The gate behavior the suggestion becomes. */
+    behavior: GateBehavior;
+    /** The server's own word for it (`immediate`, `{ debounce: 60000 }`, …). */
+    said: unknown;
+    /** The server's account of what the rule is for and what declining costs. */
+    rationale?: string;
+    /** The host wrote it: the server suggested nothing it could use. */
+    fallback?: boolean;
+}
+export interface ServerOffer {
+    server: string;
+    /** What the decision is about: a digest of the server's declared ontologies ('none' without one). */
+    digest: string;
+    rules: OfferedRule[];
+    /** Descriptions the server gave of the tags its rules name. */
+    tagDescriptions: Record<string, string>;
+    /** Suggestions in the declaration the host could not translate, as given. */
+    untranslated: unknown[];
+}
+/**
+ * A suggested behavior (RFC-001 §6's vocabulary, or the gate's own names) as a
+ * gate behavior; null for one with no faithful translation.
+ */
+export declare function translateBehavior(said: unknown): GateBehavior | null;
+/**
+ * A server's suggestions from its declared feature sets (null: none declared).
+ * Feature sets in name order; in each, its ordered rules as declared, then
+ * per-tag suggestions no ordered rule already makes, by tag. A server that suggests nothing the host can
+ * use gets one host-written rule: wake for its events tagged as addressed to
+ * the agent or waiting on it, nothing else.
+ */
+export declare function offerFor(server: string, declared: Record<string, {
+    tagOntology?: unknown;
+}> | null): ServerOffer;
+export { ruleDecides } from './rule-scope.js';
+/**
+ * Whether the gate let an event go by without anyone having decided to: it did
+ * not wake and will not (`defer`/`skip`), by the default or by a rule that
+ * doesn't decide about it (ruleDecides). `policy` is the matched rule, as in
+ * force; undefined when the decision named none or it can't be found.
+ */
+export declare function isUndecided(decision: GateDecision, policy: GatePolicy | undefined): boolean;
+export declare const carriesAttention: (tags: readonly string[] | undefined) => boolean;
+/**
+ * Where an accepted rule goes: ahead of the first rule that would let the
+ * server's events by without deciding about them (a catch-all that defers or
+ * skips), so the rules the agent wrote for this server, or for a channel or
+ * tags, keep their place before it, and so do catch-alls that wake (a mention
+ * rule on metadata): a muted suggestion can't swallow an explicit mention.
+ * Null: there is none; the rule goes last, ahead of the default. (Accepted
+ * rules name their source, so they are never the catch-all.)
+ */
+export declare const placementFor: (policies: readonly GatePolicy[]) => string | null;
+/** The gate rules accepting `rules` of `offer` writes. */
+export declare function rulesToWrite(offer: ServerOffer, accepted: readonly OfferedRule[]): GatePolicy[];
+/** The least time between two offers for one server (WakeDecisions.mayOffer). */
+export declare const OFFER_FLOOR_MS: number;
+export type DecisionState = 'offered' | 'accepted' | 'declined';
+export interface DecisionRecord {
+    digest: string;
+    state: DecisionState;
+    /** The rule names an acceptance wrote (kept while a newer ontology is being asked about). */
+    rules?: string[];
+    /** The digest whose numbered list the agent was last shown, when newer than `digest` (a drift refusal re-showed it). */
+    shown?: string;
+    at: string;
+}
+/**
+ * The agent's decisions per server, beside gate.json (`wake-decisions.json`).
+ * Written whole, through a temporary file; one that can't be read is set aside
+ * and starts empty, so a damaged file costs a repeated offer, never a crash.
+ */
+export declare class WakeDecisions {
+    private readonly path;
+    private readonly log;
+    private records;
+    constructor(path: string, log?: (message: string) => void);
+    get(server: string): DecisionRecord | undefined;
+    /**
+     * Whether an offer for `server` may go out now: never twice for the same
+     * digest, answered or not, and not within OFFER_FLOOR_MS of the server's
+     * last offer or decision even when its ontology changed — a server can't
+     * buy itself a stream of questions by editing what it declares.
+     */
+    /** Whether an offer for `server` could go out at all, before its digest is known: not within the floor of the last one. */
+    mayOfferSoon(server: string, now?: number): boolean;
+    mayOffer(server: string, digest: string, now?: number): boolean;
+    set(server: string, record: Omit<DecisionRecord, 'at'>, now?: number): DecisionRecord;
+    /** Record that the agent was shown `digest`'s list, leaving the decision and its time as they are (the floor doesn't restart). */
+    markShown(server: string, digest: string): void;
+    all(): Readonly<Record<string, DecisionRecord>>;
+    private write;
+}
+//# sourceMappingURL=wake-onboarding.d.ts.map

package/dist/src/gate/wake-onboarding.d.ts.map

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