@animalabs/agent-framework 0.31.0 → 0.33.0

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

@@ -1,4 +1,4 @@
 export { EventGate, MCPL_GATE_EVENT_TYPES, wakeProvenance, wakeLineText, type EventTypesFrom, type WakeProvenance, type WritePlacement } from './event-gate.js';
-export type { GateConfig, GateOptions, GatePolicy, GatePolicyMatch, GateBehavior, GateDecision, GateEventInfo, GateStatus, GatePolicyStats, WakeLine, JudgeConfig, JudgeEventSummary, JudgeFn, JudgeRequest, JudgeVerdict, ReplyJudgeOptions, UpcomingWake, } from './types.js';
+export type { GateConfig, GateOptions, GatePolicy, GatePolicyMatch, GateBehavior, GateDecision, GateEventInfo, GateStatus, GatePolicyStats, WakeLine, JudgeConfig, JudgeEventSummary, JudgeFn, JudgeRequest, JudgeVerdict, ReplyJudgeOptions, UpcomingWake, UpcomingWakeKind, SuppressConfig, SuppressionReviewOptions, } from './types.js';
 export { ReplyJudge, DEFAULT_JUDGE_MODEL, DEFAULT_JUDGE_MAX_INPUT_TOKENS, MIN_JUDGE_INPUT_TOKENS, type ReplyJudgeDeps } from './reply-judge.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/gate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,cAAc,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAChK,YAAY,EACV,UAAU,EACV,WAAW,EACX,UAAU,EACV,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,UAAU,EACV,eAAe,EACf,QAAQ,EACR,WAAW,EACX,iBAAiB,EACjB,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,8BAA8B,EAAE,sBAAsB,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/gate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,cAAc,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAChK,YAAY,EACV,UAAU,EACV,WAAW,EACX,UAAU,EACV,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,UAAU,EACV,eAAe,EACf,QAAQ,EACR,WAAW,EACX,iBAAiB,EACjB,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,wBAAwB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,8BAA8B,EAAE,sBAAsB,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/src/gate/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/gate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,cAAc,EAAE,YAAY,EAAiE,MAAM,iBAAiB,CAAC;AAoBhK,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,8BAA8B,EAAE,sBAAsB,EAAuB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/gate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,cAAc,EAAE,YAAY,EAAiE,MAAM,iBAAiB,CAAC;AAuBhK,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,8BAA8B,EAAE,sBAAsB,EAAuB,MAAM,kBAAkB,CAAC"}

package/dist/src/gate/rule-scope.d.ts

@@ -0,0 +1,30 @@
+/**
+ * What a gate rule decides about: whether its match names an event's server,
+ * channel or tags, or takes events without naming any of them (a catch-all).
+ * Shared by the gate (gate_status.catchAll) and wake onboarding, which treats
+ * a catch-all's let-by as no decision at all (MCPL RFC-001 §6, revision 4).
+ */
+import type { GatePolicy } from './types.js';
+/**
+ * Whether a glob names something: a pattern made only of wildcards and
+ * separators (`*`, `**`, `*:*`) matches everything, so it names nothing. A
+ * namespace glob such as `surface:*` names its namespace.
+ */
+export declare const namesSomething: (pattern: unknown) => boolean;
+/**
+ * Whether a rule's match is a decision about the events it takes: it names a
+ * source, a channel, or a tag (a tagsAny/tagsAll pattern that names
+ * something). Content filters and metadata flags (`metadataTrue`) don't: they
+ * take events from every server alike.
+ */
+export declare function ruleDecides(policy: GatePolicy): boolean;
+/**
+ * The first rule that takes MCPL events without deciding about them, or null.
+ * A rule whose scope names no `mcpl:` event type never sees them. With
+ * `lettingBy`, only one that lets them by without waking (`defer`/`skip`):
+ * the rule that leaves a new server's events undecided.
+ */
+export declare function firstCatchAll(policies: readonly GatePolicy[], opts?: {
+    lettingBy?: boolean;
+}): string | null;
+//# sourceMappingURL=rule-scope.d.ts.map

package/dist/src/gate/rule-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-scope.d.ts","sourceRoot":"","sources":["../../../src/gate/rule-scope.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,cAAc,YAAa,OAAO,KAAG,OAAgE,CAAC;AAEnH;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAIvD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,EAAE,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,MAAM,GAAG,IAAI,CAWhH"}

package/dist/src/gate/rule-scope.js

@@ -0,0 +1,41 @@
+/**
+ * Whether a glob names something: a pattern made only of wildcards and
+ * separators (`*`, `**`, `*:*`) matches everything, so it names nothing. A
+ * namespace glob such as `surface:*` names its namespace.
+ */
+export const namesSomething = (pattern) => typeof pattern === 'string' && /[^*?:]/.test(pattern);
+/**
+ * Whether a rule's match is a decision about the events it takes: it names a
+ * source, a channel, or a tag (a tagsAny/tagsAll pattern that names
+ * something). Content filters and metadata flags (`metadataTrue`) don't: they
+ * take events from every server alike.
+ */
+export function ruleDecides(policy) {
+    const m = policy.match ?? {};
+    if (namesSomething(m.source) || namesSomething(m.channel))
+        return true;
+    return [...(m.tagsAny ?? []), ...(m.tagsAll ?? [])].some(namesSomething);
+}
+/**
+ * The first rule that takes MCPL events without deciding about them, or null.
+ * A rule whose scope names no `mcpl:` event type never sees them. With
+ * `lettingBy`, only one that lets them by without waking (`defer`/`skip`):
+ * the rule that leaves a new server's events undecided.
+ */
+export function firstCatchAll(policies, opts = {}) {
+    for (const p of policies) {
+        // A suppress rule decides no wake: what it lets by goes on to the rules after it.
+        if (p.suppress)
+            continue;
+        if (ruleDecides(p))
+            continue;
+        if (opts.lettingBy && p.behavior !== 'defer' && p.behavior !== 'skip')
+            continue;
+        const scope = p.match?.scope;
+        if (scope && !scope.some((s) => s.startsWith('mcpl:')))
+            continue;
+        return p.name;
+    }
+    return null;
+}
+//# sourceMappingURL=rule-scope.js.map

package/dist/src/gate/rule-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-scope.js","sourceRoot":"","sources":["../../../src/gate/rule-scope.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAgB,EAAW,EAAE,CAAC,OAAO,OAAO,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAEnH;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,MAAkB;IAC5C,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IAC7B,IAAI,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACvE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AAC3E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,QAA+B,EAAE,IAAI,GAA4B,EAAE;IAC/F,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,kFAAkF;QAClF,IAAI,CAAC,CAAC,QAAQ;YAAE,SAAS;QACzB,IAAI,WAAW,CAAC,CAAC,CAAC;YAAE,SAAS;QAC7B,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,CAAC,QAAQ,KAAK,MAAM;YAAE,SAAS;QAChF,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC;QAC7B,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YAAE,SAAS;QACjE,OAAO,CAAC,CAAC,IAAI,CAAC;IAChB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/src/gate/suppress-script-worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=suppress-script-worker.d.ts.map

package/dist/src/gate/suppress-script-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suppress-script-worker.d.ts","sourceRoot":"","sources":["../../../src/gate/suppress-script-worker.ts"],"names":[],"mappings":""}

package/dist/src/gate/suppress-script-worker.js

@@ -0,0 +1,103 @@
+/**
+ * Worker that runs agents' suppress-rule scripts (`suppress.script`, see
+ * suppress-scripts.ts).
+ *
+ * As with gate.js, the agent is trusted (it has shell and filesystem
+ * already), so this is a robustness boundary, not a security sandbox: on a
+ * thread of its own, a script that loops or hangs is timed out by the main
+ * thread (Atomics.wait) instead of freezing the agent's event loop.
+ *
+ * Protocol: the parent posts one message at a time and blocks in
+ * Atomics.wait until this worker writes the JSON answer into the shared
+ * buffer and flips the control word.
+ *   - `{ type: 'reset' }` drops every script held: `{}`.
+ *   - `{ type: 'load', name, script }` compiles one script (an expression
+ *     that evaluates to a function) and keeps it under the rule's name:
+ *     `{ error? }`.
+ *   - `{ type: 'check', script }` compiles one without keeping it: `{ error? }`.
+ *   - `{ type: 'eval', name, event, state }` calls the rule's function with
+ *     the event and the state, and answers `{ hide, state }`: the state as
+ *     the script left it, and `hide` true only where the script returned
+ *     true. A script may be async.
+ */
+import { parentPort, workerData } from 'node:worker_threads';
+const { sab, maxStateBytes } = workerData;
+const ctrl = new Int32Array(sab, 0, 2); // [0]=status (0 pending, 1 done), [1]=answer byte length
+const data = new Uint8Array(sab, 8);
+const enc = new TextEncoder();
+const fns = new Map();
+function answer(obj) {
+    let bytes = enc.encode(JSON.stringify(obj));
+    if (bytes.length > data.length)
+        bytes = enc.encode(JSON.stringify({ error: 'the answer was too large to pass back' }));
+    data.set(bytes);
+    Atomics.store(ctrl, 1, bytes.length);
+    Atomics.store(ctrl, 0, 1);
+    Atomics.notify(ctrl, 0);
+}
+const message = (e) => (e instanceof Error ? e.message : String(e));
+function compile(script) {
+    // An expression, as `(event, state) => …` or `function (event, state) { … }`.
+    const made = new Function(`"use strict";\nreturn (${script}\n);`)();
+    if (typeof made !== 'function')
+        throw new Error(`the script is ${made === null ? 'null' : typeof made}, not a function such as (event, state) => false`);
+    return made;
+}
+parentPort?.on('message', (msg) => {
+    if (msg?.type === 'reset') {
+        fns.clear();
+        answer({});
+        return;
+    }
+    if (msg?.type === 'load') {
+        const name = msg.name ?? '';
+        try {
+            fns.set(name, compile(msg.script ?? ''));
+            answer({});
+        }
+        catch (e) {
+            fns.delete(name);
+            answer({ error: message(e) });
+        }
+        return;
+    }
+    if (msg?.type === 'check') {
+        try {
+            compile(msg.script ?? '');
+            answer({});
+        }
+        catch (e) {
+            answer({ error: message(e) });
+        }
+        return;
+    }
+    if (msg?.type !== 'eval')
+        return;
+    void (async () => {
+        const fn = fns.get(msg.name ?? '');
+        if (!fn)
+            return answer({ error: 'the script is not loaded' });
+        const state = (msg.state && typeof msg.state === 'object' && !Array.isArray(msg.state) ? msg.state : {});
+        try {
+            let hide = fn(msg.event, state);
+            if (hide && typeof hide.then === 'function')
+                hide = await hide;
+            let kept;
+            try {
+                kept = JSON.stringify(state);
+            }
+            catch (e) {
+                return answer({ error: `its state can't be kept as JSON: ${message(e)}` });
+            }
+            if (kept === undefined || enc.encode(kept).length > maxStateBytes) {
+                return answer({ error: `its state is over the ${maxStateBytes.toLocaleString('en-US')} bytes it may keep` });
+            }
+            // Only true hides: anything else, a truthy string included, shows the event.
+            answer({ hide: hide === true, state: JSON.parse(kept) });
+        }
+        catch (e) {
+            answer({ error: message(e) });
+        }
+    })();
+});
+//# sourceMappingURL=suppress-script-worker.js.map

package/dist/src/gate/suppress-script-worker.js.map

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

package/dist/src/gate/suppress-scripts.d.ts

@@ -0,0 +1,105 @@
+/** The most a rule's state may hold, as JSON (bytes). */
+export declare const MAX_SUPPRESS_STATE_BYTES: number;
+/** How long one event's call may take before the script is stopped and the event shown (ms). */
+export declare const DEFAULT_SUPPRESS_SCRIPT_TIMEOUT_MS = 50;
+/** Timeouts within a script's last TIMEOUT_WINDOW runs after which it isn't run again until its script changes. */
+export declare const MAX_TIMEOUTS_IN_WINDOW = 3;
+export declare const TIMEOUT_WINDOW = 20;
+/** What a script is given for each event. */
+export interface SuppressScriptEvent {
+    eventType: string;
+    source: string;
+    channel?: string;
+    author?: string;
+    tags: string[];
+    /** The event's text. */
+    text: string;
+    /** When the event arrived (ms since the epoch). */
+    at: number;
+    /** The event's metadata, as JSON. */
+    metadata: Record<string, unknown>;
+}
+/** How a rule's script has run, for gate_status. */
+export interface SuppressScriptStatus {
+    loaded: boolean;
+    /** Present when the script no longer runs until its rule changes: why. */
+    disabled?: string;
+    runs: number;
+    hidden: number;
+    errors: number;
+    timeouts: number;
+    lastError: string | null;
+    /** Its state's size as JSON (bytes). */
+    stateBytes: number;
+}
+export declare class SuppressScripts {
+    private readonly opts;
+    /** The worker and its own shared buffer: a worker stopped after a timeout may still write to the buffer it had. */
+    private channel?;
+    private readonly dec;
+    private readonly rules;
+    /** States read from disk, by rule, kept until the rule with that script is synced or forgotten. */
+    private saved;
+    private saveTimer;
+    private disposed;
+    /** Whether the first sync, with every rule in force, has run: saved states it didn't take are then retired. */
+    private synced;
+    /** When a later event may try loading again, after loading failed for want of a worker (not a script's own error). */
+    private workerRetryAt;
+    private workerRetryDelay;
+    constructor(opts?: {
+        statePath?: string;
+        timeoutMs?: number;
+    });
+    private get timeoutMs();
+    /**
+     * 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: ReadonlyArray<{
+        name: string;
+        script?: string;
+    }>): void;
+    /** Forget a rule's script and state (a rule removed or redefined), a state saved for it before a restart included. */
+    forget(name: string): void;
+    /**
+     * 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: string): string | 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: string, event: SuppressScriptEvent, commit: boolean): {
+        hide: boolean;
+    } | {
+        error: string;
+    } | undefined;
+    /** One run in the rule's recent runs: how many of them timed out. */
+    private noteRun;
+    status(name: string): SuppressScriptStatus | undefined;
+    /** A rule's state as its script left it (a copy). */
+    stateOf(name: string): Record<string, unknown> | undefined;
+    dispose(): void;
+    /** Write the states now, if a write is due. */
+    flush(): void;
+    /**
+     * 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.
+     */
+    private load;
+    /** One message to the worker, waited for: its answer, or a timeout, after which the worker is stopped (the caller loads the scripts again). */
+    private call;
+    private ensureWorker;
+    private stopWorker;
+    private scheduleSave;
+    private save;
+}
+//# sourceMappingURL=suppress-scripts.d.ts.map

package/dist/src/gate/suppress-scripts.d.ts.map

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