@animalabs/agent-framework 0.31.0 → 0.33.0

package/dist/src/gate/suppress-scripts.js

@@ -0,0 +1,403 @@
+/**
+ * SuppressScripts — the agent's own logic for its suppress rules
+ * (`suppress.script`): a function `(event, state) => boolean` the rule's
+ * events are passed to, true hiding the event. `state` is the rule's own
+ * JSON object, which the script reads and changes as it likes, so a rule can
+ * hide what it has seen before, count, or keep a window of its own. The
+ * framework keeps each rule's state between events and across restarts, in
+ * `suppress-state.json` beside gate.json, and starts it afresh when the
+ * rule's script changes or the rule is removed.
+ *
+ * The scripts run on one worker thread, called synchronously from the gate
+ * (Atomics.wait) with a timeout, as gate.js is (gate-script.ts): a robustness
+ * boundary for code the agent wrote, not a security sandbox. Every failure
+ * lets the event go on to the rules after the script's (as a script that
+ * says show does): a script that throws, times out, isn't a function, or
+ * leaves a state that can't be kept. Its state then stays as it was, and the
+ * failure is counted and named in gate_status. A timeout stops the worker; a
+ * fresh one loads every script again, one at a time, so a script whose own
+ * loading hangs is set aside without the others. A script that times out
+ * MAX_TIMEOUTS_IN_WINDOW times in its last TIMEOUT_WINDOW runs, probes
+ * included, stops being run until its script changes: each timeout blocks the
+ * caller's thread for the timeout and a worker's restart, so neither a script
+ * that always hangs nor one that hangs now and then goes on costing that. A
+ * worker that fails to start or answer is tried again with a later event,
+ * each try later than the last, since a try can block for LOAD_TIMEOUT_MS.
+ *
+ * The worker starts with the first rule that has a script, so a gate with
+ * none runs no thread.
+ */
+import { createHash } from 'node:crypto';
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { Worker } from 'node:worker_threads';
+const WORKER_PATH = join(dirname(fileURLToPath(import.meta.url)), 'suppress-script-worker.js');
+/** The most a rule's state may hold, as JSON (bytes). */
+export const MAX_SUPPRESS_STATE_BYTES = 64 * 1024;
+/** Room for an answer: the state, and the rest of the answer around it. */
+const SAB_SIZE = 8 + 2 * MAX_SUPPRESS_STATE_BYTES + 16_384;
+/** How long one event's call may take before the script is stopped and the event shown (ms). */
+export const DEFAULT_SUPPRESS_SCRIPT_TIMEOUT_MS = 50;
+/** How long compiling one script may take, the worker's start included (ms). */
+const LOAD_TIMEOUT_MS = 3_000;
+/** Timeouts within a script's last TIMEOUT_WINDOW runs after which it isn't run again until its script changes. */
+export const MAX_TIMEOUTS_IN_WINDOW = 3;
+export const TIMEOUT_WINDOW = 20;
+/** How long after the worker failed to start or answer a later event first tries loading the scripts again (ms); doubled each failed try, up to the most. */
+const WORKER_RETRY_MS = 5_000;
+const WORKER_RETRY_MAX_MS = 5 * 60_000;
+/** How soon after a state changes it's written to disk (ms), and how long a failed write waits to be tried again. */
+const SAVE_DELAY_MS = 2_000;
+const SAVE_RETRY_MS = 30_000;
+const hashOf = (script) => createHash('sha256').update(script).digest('hex');
+const message = (e) => (e instanceof Error ? e.message : String(e));
+const isRecord = (v) => !!v && typeof v === 'object' && !Array.isArray(v);
+/** Saved states as read from disk: entries that aren't a script hash and an object state are skipped and named; a file of another shape throws. */
+function readSaved(raw, path) {
+    const out = new Map();
+    if (!isRecord(raw) || raw.version !== 1 || !isRecord(raw.rules))
+        throw new Error('it holds no version 1 states');
+    const skipped = [];
+    for (const [name, entry] of Object.entries(raw.rules)) {
+        if (isRecord(entry) && typeof entry.script === 'string' && isRecord(entry.state))
+            out.set(name, { script: entry.script, state: entry.state });
+        else
+            skipped.push(name);
+    }
+    if (skipped.length > 0)
+        console.error(`[gate] suppress-rule states in ${path}: ${skipped.map((n) => JSON.stringify(n)).join(', ')} can't be read, so those rules start afresh`);
+    return out;
+}
+export class SuppressScripts {
+    opts;
+    /** The worker and its own shared buffer: a worker stopped after a timeout may still write to the buffer it had. */
+    channel;
+    dec = new TextDecoder();
+    rules = new Map();
+    /** States read from disk, by rule, kept until the rule with that script is synced or forgotten. */
+    saved = new Map();
+    saveTimer = null;
+    disposed = false;
+    /** Whether the first sync, with every rule in force, has run: saved states it didn't take are then retired. */
+    synced = false;
+    /** When a later event may try loading again, after loading failed for want of a worker (not a script's own error). */
+    workerRetryAt = null;
+    workerRetryDelay = WORKER_RETRY_MS;
+    constructor(opts = {}) {
+        this.opts = opts;
+        if (opts.statePath && existsSync(opts.statePath)) {
+            try {
+                this.saved = readSaved(JSON.parse(readFileSync(opts.statePath, 'utf-8')), opts.statePath);
+            }
+            catch (error) {
+                // Moved aside, so the next save doesn't write over a file a later release wrote.
+                const aside = `${opts.statePath}.unreadable`;
+                let moved = '';
+                try {
+                    renameSync(opts.statePath, aside);
+                    moved = ` It's kept as ${aside}.`;
+                }
+                catch { /* the save may yet fail too; the log says what was read */ }
+                console.error(`[gate] suppress-rule states in ${opts.statePath} can't be read, so every rule's state starts afresh.${moved}`, error);
+            }
+        }
+    }
+    get timeoutMs() { return this.opts.timeoutMs ?? DEFAULT_SUPPRESS_SCRIPT_TIMEOUT_MS; }
+    /**
+     * Bring the scripts in step with the rules in force: compile new and
+     * changed ones, drop removed ones. A rule keeps its state while its script
+     * is the same text; a new or changed script starts from `{}`, or from the
+     * state saved for that very script before a restart.
+     */
+    sync(rules) {
+        if (this.disposed)
+            return;
+        const wanted = new Map(rules.filter((r) => typeof r.script === 'string').map((r) => [r.name, r.script]));
+        let changed = false;
+        for (const name of [...this.rules.keys()]) {
+            if (wanted.get(name) !== this.rules.get(name).script) {
+                this.rules.delete(name);
+                changed = true;
+            }
+        }
+        for (const [name, script] of wanted) {
+            if (this.rules.has(name))
+                continue;
+            const hash = hashOf(script);
+            const saved = this.saved.get(name);
+            this.saved.delete(name);
+            this.rules.set(name, {
+                script, hash, state: saved && saved.script === hash ? saved.state : {}, loaded: false, disabled: null,
+                runs: 0, hidden: 0, errors: 0, timeouts: 0, recentRuns: [], lastError: null,
+            });
+            changed = true;
+        }
+        // States saved for rules that weren't in force at the first sync are
+        // retired: the rule was removed while the host was down, and one made
+        // later under the name starts afresh.
+        if (!this.synced) {
+            this.synced = true;
+            if (this.saved.size > 0) {
+                this.saved.clear();
+                changed = true;
+            }
+        }
+        if (!changed)
+            return;
+        this.scheduleSave();
+        if (this.rules.size === 0) {
+            this.stopWorker();
+            return;
+        }
+        this.load();
+    }
+    /** Forget a rule's script and state (a rule removed or redefined), a state saved for it before a restart included. */
+    forget(name) {
+        const had = this.rules.delete(name) || this.saved.delete(name);
+        if (had)
+            this.scheduleSave();
+        if (this.rules.size === 0)
+            this.stopWorker();
+    }
+    /**
+     * Whether `script` compiles to a function, run on the worker: an error's
+     * text, or null. For wake_add_rule, before it saves a rule.
+     */
+    check(script) {
+        const answer = this.call({ type: 'check', script }, LOAD_TIMEOUT_MS);
+        if ('timeout' in answer) {
+            this.load(); // the worker was stopped: the rules' scripts go to a fresh one
+            return `compiling it took over ${LOAD_TIMEOUT_MS / 1000} s`;
+        }
+        // A gate with no scripts runs no thread, this check's included.
+        if (this.rules.size === 0)
+            this.stopWorker();
+        return typeof answer.error === 'string' ? answer.error : null;
+    }
+    /**
+     * Run a rule's script for one event. `commit` keeps the state it leaves and
+     * counts the run; without it (a probe) the state is as before. Undefined
+     * when the rule has no script; `{ error }` when the script failed, and the
+     * event goes on to the rules after it.
+     */
+    run(name, event, commit) {
+        const rule = this.rules.get(name);
+        if (!rule)
+            return undefined;
+        if (rule.disabled)
+            return { error: rule.disabled };
+        // A load that failed for want of a worker is tried again, later each time.
+        if (!rule.loaded && this.workerRetryAt !== null && Date.now() >= this.workerRetryAt)
+            this.load();
+        if (!rule.loaded)
+            return { error: rule.lastError ?? 'the script is not loaded' };
+        const answer = this.call({ type: 'eval', name, event, state: rule.state }, this.timeoutMs);
+        if ('timeout' in answer) {
+            // The worker was stopped; every script goes to a fresh one. A probe's
+            // timeout counts toward setting the script aside too: it costs the same.
+            const error = `it took over ${this.timeoutMs} ms, so it was stopped`;
+            if (commit)
+                rule.runs++;
+            rule.timeouts++;
+            rule.lastError = error;
+            if (this.noteRun(rule, true) >= MAX_TIMEOUTS_IN_WINDOW) {
+                rule.disabled = `it took over ${this.timeoutMs} ms ${MAX_TIMEOUTS_IN_WINDOW} times in its last ${TIMEOUT_WINDOW} runs, so it isn't run again until its script changes`;
+                rule.lastError = rule.disabled;
+            }
+            this.load();
+            return { error };
+        }
+        this.noteRun(rule, false);
+        if (!commit)
+            return typeof answer.error === 'string' ? { error: answer.error } : { hide: answer.hide === true };
+        rule.runs++;
+        if (typeof answer.error === 'string') {
+            rule.errors++;
+            rule.lastError = answer.error;
+            return { error: answer.error };
+        }
+        const next = isRecord(answer.state) ? answer.state : {};
+        if (JSON.stringify(next) !== JSON.stringify(rule.state)) {
+            rule.state = next;
+            this.scheduleSave();
+        }
+        const hide = answer.hide === true;
+        if (hide)
+            rule.hidden++;
+        return { hide };
+    }
+    /** One run in the rule's recent runs: how many of them timed out. */
+    noteRun(rule, timedOut) {
+        rule.recentRuns.push(timedOut);
+        if (rule.recentRuns.length > TIMEOUT_WINDOW)
+            rule.recentRuns.shift();
+        return rule.recentRuns.filter(Boolean).length;
+    }
+    status(name) {
+        const rule = this.rules.get(name);
+        if (!rule)
+            return undefined;
+        return {
+            loaded: rule.loaded, ...(rule.disabled ? { disabled: rule.disabled } : {}),
+            runs: rule.runs, hidden: rule.hidden, errors: rule.errors, timeouts: rule.timeouts,
+            lastError: rule.lastError, stateBytes: Buffer.byteLength(JSON.stringify(rule.state)),
+        };
+    }
+    /** A rule's state as its script left it (a copy). */
+    stateOf(name) {
+        const rule = this.rules.get(name);
+        return rule ? structuredClone(rule.state) : undefined;
+    }
+    dispose() {
+        if (this.disposed)
+            return;
+        this.flush();
+        this.disposed = true;
+        this.stopWorker();
+    }
+    /** Write the states now, if a write is due. */
+    flush() {
+        if (!this.saveTimer)
+            return;
+        clearTimeout(this.saveTimer);
+        this.saveTimer = null;
+        this.save();
+    }
+    /**
+     * Load every script that isn't set aside into the worker, one at a time,
+     * on a clean slate. A script whose loading times out is set aside (it
+     * would stop the worker each time), and the rest are loaded again on the
+     * fresh worker that follows.
+     */
+    load() {
+        if (this.rules.size === 0)
+            return;
+        for (let attempt = 0; attempt <= this.rules.size; attempt++) {
+            const reset = this.call({ type: 'reset' }, LOAD_TIMEOUT_MS);
+            if ('timeout' in reset || typeof reset.error === 'string') {
+                const why = 'timeout' in reset ? `the script worker didn't answer within ${LOAD_TIMEOUT_MS / 1000} s` : reset.error;
+                for (const rule of this.rules.values()) {
+                    rule.loaded = false;
+                    rule.lastError = rule.disabled ?? `${why}; it's tried again with a later event`;
+                }
+                this.workerRetryAt = Date.now() + this.workerRetryDelay;
+                this.workerRetryDelay = Math.min(WORKER_RETRY_MAX_MS, this.workerRetryDelay * 2);
+                return;
+            }
+            this.workerRetryAt = null;
+            this.workerRetryDelay = WORKER_RETRY_MS;
+            let restarted = false;
+            for (const [name, rule] of this.rules) {
+                if (rule.disabled) {
+                    rule.loaded = false;
+                    continue;
+                }
+                const answer = this.call({ type: 'load', name, script: rule.script }, LOAD_TIMEOUT_MS);
+                if ('timeout' in answer) {
+                    rule.loaded = false;
+                    rule.disabled = `compiling it took over ${LOAD_TIMEOUT_MS / 1000} s, so it isn't run until its rule changes`;
+                    rule.lastError = rule.disabled;
+                    restarted = true;
+                    break;
+                }
+                if (typeof answer.error === 'string') {
+                    rule.loaded = false;
+                    rule.lastError = `it doesn't compile: ${answer.error}`;
+                }
+                else {
+                    rule.loaded = true;
+                }
+            }
+            if (!restarted)
+                return;
+        }
+    }
+    /** One message to the worker, waited for: its answer, or a timeout, after which the worker is stopped (the caller loads the scripts again). */
+    call(msg, timeoutMs) {
+        if (this.disposed)
+            return { error: 'the gate is stopped' };
+        const channel = this.ensureWorker();
+        if (!channel)
+            return { error: 'the script worker could not start' };
+        const { worker, ctrl, data } = channel;
+        Atomics.store(ctrl, 0, 0);
+        try {
+            worker.postMessage(msg);
+        }
+        catch (e) {
+            return { error: message(e) };
+        }
+        if (Atomics.wait(ctrl, 0, 0, timeoutMs) === 'timed-out') {
+            this.stopWorker();
+            return { timeout: true };
+        }
+        const length = Atomics.load(ctrl, 1);
+        try {
+            return JSON.parse(this.dec.decode(data.slice(0, length)));
+        }
+        catch {
+            return { error: 'the script worker gave an unreadable answer' };
+        }
+    }
+    ensureWorker() {
+        if (this.channel)
+            return this.channel;
+        try {
+            const sab = new SharedArrayBuffer(SAB_SIZE);
+            const worker = new Worker(WORKER_PATH, { workerData: { sab, maxStateBytes: MAX_SUPPRESS_STATE_BYTES } });
+            worker.on('error', (e) => { console.error('[gate] the suppress-script worker failed:', e); });
+            // A worker that dies on its own (a script's stray asynchronous throw) is
+            // no one's timeout: the next run loads the scripts on a fresh one.
+            worker.once('exit', () => {
+                if (this.channel?.worker !== worker)
+                    return;
+                this.channel = undefined;
+                for (const rule of this.rules.values())
+                    rule.loaded = false;
+                this.workerRetryAt = 0;
+            });
+            worker.unref();
+            this.channel = { worker, ctrl: new Int32Array(sab, 0, 2), data: new Uint8Array(sab, 8) };
+            return this.channel;
+        }
+        catch (error) {
+            console.error('[gate] the suppress-script worker could not start:', error);
+            return undefined;
+        }
+    }
+    stopWorker() {
+        if (!this.channel)
+            return;
+        void this.channel.worker.terminate().catch(() => { });
+        this.channel = undefined;
+    }
+    scheduleSave(delayMs = SAVE_DELAY_MS) {
+        if (!this.opts.statePath || this.saveTimer || this.disposed)
+            return;
+        this.saveTimer = setTimeout(() => { this.saveTimer = null; this.save(); }, delayMs);
+        this.saveTimer.unref?.();
+    }
+    save() {
+        const path = this.opts.statePath;
+        if (!path)
+            return;
+        // A null-prototype object, so a rule named "__proto__" is an entry like any other.
+        const rules = Object.create(null);
+        for (const [name, saved] of this.saved)
+            rules[name] = saved;
+        for (const [name, rule] of this.rules)
+            rules[name] = { script: rule.hash, state: rule.state };
+        try {
+            mkdirSync(dirname(path), { recursive: true });
+            const temp = `${path}.${process.pid}.tmp`;
+            writeFileSync(temp, `${JSON.stringify({ version: 1, rules }, null, 2)}\n`);
+            renameSync(temp, path);
+        }
+        catch (error) {
+            console.error(`[gate] suppress-rule states couldn't be written to ${path}; they're kept in memory and written again shortly:`, error);
+            this.scheduleSave(SAVE_RETRY_MS);
+        }
+    }
+}
+//# sourceMappingURL=suppress-scripts.js.map

package/dist/src/gate/suppress-scripts.js.map

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

package/dist/src/gate/suppression-review.d.ts

@@ -0,0 +1,143 @@
+import type { DetailedUsage, Membrane, NormalizedRequest } from '@animalabs/membrane';
+import type { SuppressedEventRecord } from './suppression-stats.js';
+import type { SuppressionReviewOptions } from './types.js';
+import type { TraceEventInput } from '../types/trace.js';
+export declare const DEFAULT_REVIEW_INTERVAL_MS: number;
+export declare const MIN_REVIEW_INTERVAL_MS: number;
+export declare const MAX_REVIEW_INTERVAL_MS: number;
+export declare const DEFAULT_REVIEW_MODEL = "claude-haiku-5-5";
+export declare const DEFAULT_REVIEW_MAX_EVENTS = 60;
+/**
+ * Characters of event text the reviewer reads for one rule, shared among its
+ * sample: a short event takes what it needs and a long one the rest
+ * (eventTextCap), so what makes a long message matter past its start is
+ * read. Chosen, not measured: with the default sample it keeps one rule's
+ * request to roughly 8,000 input tokens, which a review every two hours can
+ * afford.
+ */
+export declare const EVENT_TEXT_BUDGET = 24000;
+/** A suppress rule as the review knows it. */
+export interface ReviewRuleInfo {
+    name: string;
+    description: string;
+    match?: unknown;
+    /** The rule's script, which decides which matching events it hides. */
+    script?: string;
+}
+/** One rule's review. */
+export interface RuleReview {
+    rule: string;
+    /** The description judged against: the rule's own, or its last known one for a removed rule. */
+    description?: string;
+    /** Whether gate.json has the rule now. */
+    inForce: boolean;
+    /** Events it hid in the period. */
+    suppressed: number;
+    /** Of those, how many the reviewer read. */
+    read: number;
+    /** `fits`: nothing flagged; `flagged`: some events flagged; `error`: the reviewer couldn't answer; `unjudged`: no description to judge against. */
+    verdict: 'fits' | 'flagged' | 'error' | 'unjudged';
+    flagged: SuppressedEventRecord[];
+    /** The reviewer's one-line note, or what went wrong. */
+    note?: string;
+}
+export interface SuppressionReviewSummary {
+    fromMs: number;
+    toMs: number;
+    rules: RuleReview[];
+    total: number;
+    flagged: number;
+}
+export interface SuppressionReviewDeps {
+    /** The agent whose message slot is reviewed and who is told: the primary resident. */
+    agentName(): string | undefined;
+    /** The membrane the reviewer calls for that agent (the framework's judge membrane). */
+    membraneFor(agentName: string): Membrane;
+    /** The suppressed rows stored in the agent's slot, at or after `sinceMs` and before `untilMs`, oldest first. */
+    records(agentName: string, sinceMs: number, untilMs: number): SuppressedEventRecord[];
+    /** The suppress rules in force. */
+    rules(): ReviewRuleInfo[];
+    /** Tell the agent: store the notice, and wake it when `wake`. Throws when the notice can't be written. */
+    deliver(agentName: string, text: string, wake: boolean, summary: SuppressionReviewSummary): void;
+    recordUsage?(agentName: string, usage: DetailedUsage): void;
+    emitTrace?(event: TraceEventInput): void;
+    /** Where the review keeps what it reviewed through; left out, nothing is kept and a restart starts afresh. */
+    statePath?: string;
+    /** Whether a review may run now (not while the host is quiesced or stopping); a review not run waits for the next. */
+    mayRun?(): boolean;
+    /** Whether the agent has dump_suppressed (a workspace), for the notice to point at it. */
+    dumpAvailable?(): boolean;
+    now?(): number;
+}
+/** The options as the review runs them: each at its default or within its bounds. */
+export declare function reviewSettings(options?: SuppressionReviewOptions): {
+    intervalMs: number;
+    model: string;
+    notify: "always" | "flagged";
+    wakeOnFlag: boolean;
+    maxEventsPerRule: number;
+    timeoutMs: number;
+    effort: "high" | "low" | "medium" | "none";
+};
+/** `max` of `items`, spread evenly from the first to the last; all of them when there are no more. */
+export declare function spread<T>(items: readonly T[], max: number): T[];
+/**
+ * The most characters any event may take so that the sample fits `budget`:
+ * every event shorter than it is read whole, and the budget they leave is
+ * shared among the rest.
+ */
+export declare function eventTextCap(lengths: readonly number[], budget: number): number;
+/** The reviewer's request for one rule's events. */
+export declare function reviewRequest(rule: {
+    name: string;
+    description: string;
+    match?: unknown;
+    script?: string;
+}, events: readonly SuppressedEventRecord[], hidden: number, period: {
+    fromMs: number;
+    toMs: number;
+}, settings: ReturnType<typeof reviewSettings>): NormalizedRequest;
+/** The reviewer's answer read from its text, or undefined when it holds none this can use. */
+export declare function parseReviewAnswer(text: string, count: number): {
+    flagged: number[];
+    note: string;
+} | undefined;
+/** The `[suppression review]` notice the agent is told; `dump` when it has dump_suppressed to point at. */
+export declare function reviewNoticeText(summary: SuppressionReviewSummary, opts?: {
+    dump?: boolean;
+}): string;
+export declare class SuppressionReview {
+    private readonly deps;
+    private readonly settings;
+    private readonly now;
+    private timer;
+    private running;
+    private stopped;
+    private readonly inFlight;
+    private reviewedThrough;
+    private readonly retryFrom;
+    private readonly descriptions;
+    constructor(deps: SuppressionReviewDeps, options?: SuppressionReviewOptions);
+    /** A rule's description as it stands when it hides a row: the one its rows are judged against later, though the rule be gone by then. */
+    noteRule(name: string, description: string): void;
+    get intervalMs(): number;
+    get nextReviewAfter(): number;
+    /** Schedule reviews: the first when the interval since the last review is up, and no sooner than a minute from now. */
+    start(): void;
+    stop(): void;
+    private schedule;
+    /**
+     * Review what was hidden since the last review, tell the agent, and record
+     * how far it reviewed. A call while a review runs gets that review's
+     * result. Null when no review ran: no agent is registered, the host isn't
+     * taking one now (mayRun, asked again before the agent is told), or the
+     * agent changed while the reviewer was asked; the next review covers the
+     * period. A review whose notice couldn't be written throws, and the next
+     * review covers its period again.
+     */
+    runOnce(): Promise<SuppressionReviewSummary | null>;
+    private review;
+    private judge;
+    private saveState;
+}
+//# sourceMappingURL=suppression-review.d.ts.map

package/dist/src/gate/suppression-review.d.ts.map

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