@animalabs/agent-framework 0.26.2 → 0.28.0

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

@@ -12,9 +12,10 @@
  * bucket are denied (decision: trigger=false). Tokens regenerate at one per
  * `refillIntervalMs`, capped at `tokens`. Buckets are partitioned by the
  * value of `keyBy` resolved against event metadata — so a per-user limit
- * uses `keyBy: "senderId"`, a per-channel limit uses `keyBy: "channelId"`,
- * etc. With no `keyBy` (or when the resolved value is missing), one shared
- * bucket is used for the policy.
+ * uses `keyBy: "senderId"`, a per-channel limit uses `keyBy: "channelId"`
+ * (resolved to the channel's registered id, as `keyBy` says), etc. With no
+ * `keyBy` (or when the resolved value is missing), one shared bucket is used
+ * for the policy.
  */
 export interface RateLimitConfig {
     /** Max bucket capacity, also the initial fill. Must be > 0. */
@@ -22,8 +23,12 @@ export interface RateLimitConfig {
     /** Milliseconds between token regenerations. Must be > 0. */
     refillIntervalMs: number;
     /**
-     * Metadata field name to partition buckets by. If absent or the metadata
-     * field is missing on a given event, all events share one bucket.
+     * Metadata field name to partition buckets by. `"channelId"` takes the
+     * channel's registered id where the gate resolves one, as `match.channel`
+     * does, so a channel's push events share its messages' bucket, a voice
+     * report's included, though it carries no `channelId`. Otherwise, if
+     * absent or the metadata field is missing on a given event, all such
+     * events share one bucket.
      */
     keyBy?: string;
 }
@@ -39,9 +44,42 @@ export interface RateLimitConfig {
 export interface PassiveSampleConfig {
     /** Trigger every N-th match. Must be > 0. */
     every: number;
-    /** Optional metadata field name for separate per-key counters. */
+    /** Optional metadata field name for separate per-key counters, resolved
+     *  as `RateLimitConfig.keyBy` is. */
     keyBy?: string;
 }
+/**
+ * Configuration for the `judge` behavior: batch matching events as `debounce`
+ * does, then, instead of waking the agent when the batch fires, ask a small,
+ * cheap model (the host's reply judge, `GateOptions.judge`) whether now is a
+ * good time for the agent to reply. The judge reads the agent's context as one
+ * document (its newest part), the agent's own `instructions` and the batch,
+ * and answers reply or wait. On reply the
+ * batch is delivered as a debounce's is; on wait the agent isn't woken: the
+ * events are in its context already, as for `defer`, and the next batch is
+ * judged afresh. Rules are read in order, as ever: a mention rule placed ahead
+ * of a judge rule wakes the agent without the judge. A judge that fails or
+ * times out wakes the agent (fail open),
+ * unless the host set its `onError` to `"skip"`.
+ */
+export interface JudgeConfig {
+    /** Quiet period (ms) before the batch is judged, as `debounce`'s. */
+    debounceMs: number;
+    /**
+     * The longest (ms) a batch waits from its first event before it's judged,
+     * even while events keep arriving and pushing the quiet period back. Left
+     * out, a batch is judged only after `debounceMs` of quiet, as a debounce
+     * delivers.
+     */
+    maxWaitMs?: number;
+    /**
+     * The agent's own word to the judge: when it wants to be woken and when it
+     * would rather stay quiet ("wake me when someone asks me something or the
+     * talk turns to the garden; let banter between others go by"). Shown to the
+     * judge with every batch this rule sends it.
+     */
+    instructions?: string;
+}
 /** How a matching policy affects inference triggering. */
 export type GateBehavior = 'always' | 'defer' | 'skip' | {
     debounce: number;
@@ -49,6 +87,8 @@ export type GateBehavior = 'always' | 'defer' | 'skip' | {
     rate_limit: RateLimitConfig;
 } | {
     passive_sample: PassiveSampleConfig;
+} | {
+    judge: JudgeConfig;
 };
 /** Criteria for matching an event. All specified fields must match (AND logic). */
 export interface GatePolicyMatch {
@@ -56,7 +96,12 @@ export interface GatePolicyMatch {
     scope?: string[];
     /** ServerId to match (exact or glob with *). */
     source?: string;
-    /** ChannelId to match (exact or glob with *). */
+    /** Channel to match (exact or glob with *): against the event's channel
+     *  id, then the registered id the gate resolves for it
+     *  (`resolveRouteChannel`). A channels/incoming message carries the
+     *  registered id (`discord:<guild>:<channel>`), and a push the adapter's
+     *  raw one or none, so a registered-form pattern meets every event in its
+     *  channel whose push names the channel, and a raw id only push events. */
     channel?: string;
     /** Content text filter. */
     filter?: {
@@ -131,7 +176,17 @@ export interface GateConfig {
 export interface GateOptions {
     /** Path to gate.json. Default: derived from storePath. */
     configPath?: string;
-    /** Initial config, seeded to gate.json if the file doesn't exist. */
+    /**
+     * The recipe's gate config. The first start seeds gate.json with it. Each
+     * later start merges it into gate.json against the recipe last applied,
+     * which the gate keeps beside gate.json (`gate.recipe.json`): a rule the
+     * recipe dropped, renamed, moved or redefined follows it, a rule edited at
+     * run time or by hand stays, and so does one no recipe declared. Rules are
+     * merged by name, compared by what they mean and kept as written: a
+     * recipe's rule with no name is never merged, as one with no name was never
+     * added, and where gate.json or the recipe names a rule twice, a start only
+     * adds the rules gate.json lacks. See `recipe-reconcile.ts`.
+     */
     config?: GateConfig;
     /**
      * Path to a JSON file listing user ids that may wake the agent even while
@@ -140,7 +195,110 @@ export interface GateOptions {
      * missing, no one bypasses sleep.
      */
     privilegedUsersPath?: string;
+    /** The reply judge that `judge` rules ask (see JudgeConfig). Left out (or
+     *  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;
+}
+/**
+ * Host options for the reply judge, the small model `judge` rules ask whether
+ * now is a good time for the agent to reply. The host sets the model and how
+ * the judge runs, not the agent: an agent's rule says when to ask and what to
+ * say.
+ */
+export interface ReplyJudgeOptions {
+    /** False leaves the judge unwired: `wake_add_rule` then offers no `judge`,
+     *  and a `judge` rule in gate.json wakes the agent as a debounce of its
+     *  `debounceMs` would, which gate_status says. Default true. */
+    enabled?: boolean;
+    /** The model the judge runs on, as the host's membrane names it. Default
+     *  `claude-haiku-5-5`. */
+    model?: string;
+    /**
+     * The most input tokens one judge request may carry, its instructions and
+     * the batch included; the context document is cut from its oldest end to
+     * fit. Default 90,000: Claude Haiku 5.5 costs five times as much past
+     * 100,000 input tokens, and the margin covers the estimate's error. The
+     * least is 4,000, a short tail of the conversation: cheaper and quicker,
+     * with less of the room's history to weigh.
+     */
+    maxInputTokens?: number;
+    /** The longest (ms) a judge request may take before the batch is decided by
+     *  `onError`. Default 20,000. */
+    timeoutMs?: number;
+    /** What a judge that fails, times out or answers unreadably does: `"wake"`
+     *  wakes the agent as a debounce would (the default, so a judge outage
+     *  never silences the agent); `"skip"` doesn't. */
+    onError?: 'wake' | 'skip';
+    /** The judge's effort (`output_config.effort`). Default `"low"`: a short
+     *  verdict, quickly. `"none"` sends no effort, for a provider that doesn't
+     *  take Anthropic's `output_config`. */
+    effort?: 'low' | 'medium' | 'high' | 'none';
+    /** The prompt cache's lifetime for the judge's context document. `"5m"`
+     *  (the default) suits judge rules that fire minutes apart; `"1h"` costs
+     *  more to write and suits ones that fire less often. */
+    cacheTtl?: '5m' | '1h';
 }
+/** One event of a batch, as the reply judge is shown it. */
+export interface JudgeEventSummary {
+    eventType: string;
+    /** The channel as the agent is shown it, when the event named one. */
+    channel?: string;
+    /** The author's id, when the event named one. */
+    authorId?: string;
+    /** Whether the event addressed the agent (mention, reply, DM). */
+    addressed: boolean;
+    /** The event's text, cut short when long. */
+    content: string;
+    /** When the event arrived (ms). */
+    at: number;
+}
+/**
+ * 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
+ * wait and nothing else arrives.
+ */
+export interface UpcomingWake {
+    /** When (ms), when known; absent for one due as soon as the agent is free. */
+    at?: number;
+    /** False when it only may wake the agent (a judge rule's batch goes to the judge then). */
+    certain: boolean;
+    /** What it is, as the judge is told ("its own skip_reply timer"). */
+    what: string;
+}
+/** What the gate asks the reply judge for one batch. */
+export interface JudgeRequest {
+    /** The rule whose batch this is. */
+    policyName: string;
+    /** The rule's `instructions`, the agent's own word to the judge. */
+    instructions?: string;
+    /** The batch, oldest first. */
+    events: JudgeEventSummary[];
+    /** The agents the batch would wake. */
+    agentNames: string[];
+    /** The gate's own timers that will wake those agents with no new event
+     *  (upcomingWakes): their self-wakes, a sleep's end, other rules' pending
+     *  batches. The judge adds what the framework knows besides. */
+    upcomingWakes?: UpcomingWake[];
+    /** Aborted when the judge's time is up or the gate is disposed. */
+    signal: AbortSignal;
+}
+/** The reply judge's answer for one batch. */
+export interface JudgeVerdict {
+    /** True: wake the agent now. False: let the batch go by. */
+    reply: boolean;
+    /** The judge's one-line reason. */
+    reason: string;
+    /** The model that answered. */
+    model?: string;
+    /** Input tokens the request carried (all of them: uncached, cache reads and writes). */
+    inputTokens?: number;
+    /** Of those, the tokens read from the prompt cache. */
+    cacheReadTokens?: number;
+    outputTokens?: number;
+}
+/** The judge's function, as the framework wires it into the gate. */
+export type JudgeFn = (request: JudgeRequest) => Promise<JudgeVerdict>;
 /** The result of evaluating an event against the gate. */
 export interface GateDecision {
     /** Whether to trigger inference. */
@@ -198,6 +356,45 @@ export interface GateEventInfo {
     /** Event tags (MCPL RFC-001), already implication-expanded by the host. */
     tags?: string[];
 }
+/** An MCPL event whose content the framework stored at arrival, as a
+ *  batched wake names it to the framework (EventGate's `isNewestEntry`):
+ *  a channel message by its server, channel and message id, a push event by
+ *  its server and event id. */
+export interface GateEntryRef {
+    eventType: string;
+    serverId?: string;
+    channelId?: string;
+    messageId?: string;
+    eventId?: string;
+}
+/** A batched wake's `[Gate: …]` line that the gate handed to the wake rather
+ *  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.
+ *
+ *  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
+ *  host that hands the gate's requests on itself passes the line on as it
+ *  is, not a copy per agent. */
+export interface WakeLine {
+    /** The event's own entry. */
+    entry: GateEntryRef;
+    policyNames: string[];
+    /** The channel as the line names it to the agent. */
+    shown: string;
+    /** When the event arrived (ms): the line's age is counted from it to when
+     *  the line is written (wakeLineText). */
+    at: number;
+    /** The channel the line names, as the omission's trace reports it. */
+    channelId?: string;
+}
 /** Per-policy runtime statistics (for gate:status). */
 export interface GatePolicyStats {
     name: string;
@@ -218,6 +415,30 @@ export interface GatePolicyStats {
         counterCount: number;
         fireCount: number;
     };
+    /** Present for `judge` behaviors. */
+    judgeState?: {
+        /** Events in the batch still waiting out its quiet period. */
+        pendingCount: number;
+        /** Whether the judge is deciding one of this rule's batches now. */
+        judging: boolean;
+        /** Events held for the judge until the agent's turn (or the host's quiesce) ends. */
+        heldCount: number;
+        /** Verdicts so far: woke the agent, let the batch go by, and judge failures. */
+        verdicts: {
+            reply: number;
+            wait: number;
+            error: number;
+        };
+        /** The newest verdict. */
+        last?: {
+            at: number;
+            verdict: 'reply' | 'wait' | 'error';
+            reason: string;
+            eventCount: number;
+            durationMs: number;
+            inputTokens?: number;
+        };
+    };
 }
 /** Full gate status returned by gate:status tool. */
 export interface GateStatus {

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

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

package/dist/src/heartbeat/heartbeat.d.ts

@@ -0,0 +1,184 @@
+/**
+ * The heartbeat: the agent's own schedule of wakes, in the framework.
+ *
+ * Two kinds of wake, both the agent's to set:
+ * - the ambient heartbeat, one periodic tick (`intervalSeconds`, `paused`,
+ *   `message`, `deliveryMode`): a message-mode tick is a timestamped prompt
+ *   stored in the agent's window, a silent tick a private wake that stores
+ *   no prompt and suppresses automatic prose (silent-heartbeat.ts);
+ * - reminders, one-off (a delay or an `atIso` time) or repeating (an
+ *   interval), each a stored message with a header naming it and the time.
+ *
+ * This was heartbeat-mcpl, an MCPL server; it moved here so the framework
+ * knows when the agent's next scheduled wake is (the reply judge is told,
+ * EventGate.upcomingWakes) and needs no server, policy exchange or push
+ * delivery to keep it. Its tools are listed as `heartbeat--heartbeat_status`
+ * and the rest, and calls by heartbeat-mcpl's names (`mcpl--heartbeat--…`)
+ * reach them too. Its wakes go to the gate as that server's pushes did, a
+ * push from the server id `heartbeat`, so the agent's rules decide them as
+ * they decided those, and a sleep lets them through, as it let that server
+ * id through.
+ *
+ * State (the schedule, when the next tick is due, and the reminders) is one
+ * JSON file, by default `{storePath}/config/heartbeat.json`. A first start
+ * with no file imports heartbeat-mcpl's two files when the host names them
+ * (`importFrom`). The next tick's time is kept, so a restart doesn't push it
+ * back; a tick or a reminder that fell due while the host was down fires
+ * once, shortly after start, a repeating reminder once for the periods it
+ * missed.
+ */
+import type { UpcomingWake } from '../gate/types.js';
+import type { ToolDefinition } from '../types/events.js';
+/** The prefix the heartbeat's tools carry. */
+export declare const HEARTBEAT_TOOL_PREFIX = "heartbeat--";
+/** The prefix heartbeat-mcpl's tools carried under the server id `heartbeat`
+ *  and the default tool prefix: a call by that name, as the agent's context
+ *  may still show them, reaches the same tool. */
+export declare const LEGACY_HEARTBEAT_TOOL_PREFIX = "mcpl--heartbeat--";
+/**
+ * Whether an MCPL server is heartbeat-mcpl, or names its tools as the
+ * heartbeat's: by its id, a tool prefix of `heartbeat` or `mcpl--heartbeat`,
+ * or a command or argument that runs heartbeat-mcpl. The framework's
+ * heartbeat refuses one beside it, at create and at a runtime connect.
+ */
+export declare function isHeartbeatMcplServer(server: {
+    id: string;
+    toolPrefix?: string;
+}): boolean;
+/** A heartbeat tool's name under the other prefix, for a name under one: the
+ *  framework's `heartbeat--x` and heartbeat-mcpl's `mcpl--heartbeat--x` are
+ *  one tool. Undefined for any other name. */
+export declare function heartbeatToolAlias(name: string): string | undefined;
+/** The tools that change the schedule, as against the two that only show it. */
+export declare const HEARTBEAT_CHANGING_TOOLS: readonly string[];
+export type HeartbeatDeliveryMode = 'message' | 'silent';
+/** The ambient heartbeat's schedule. */
+export interface HeartbeatSettings {
+    intervalSeconds: number;
+    paused: boolean;
+    message: string;
+    deliveryMode: HeartbeatDeliveryMode;
+}
+export declare const DEFAULT_HEARTBEAT: Readonly<HeartbeatSettings>;
+/** A scheduled reminder. `everySeconds` null: one-off, dropped once it fires. */
+export interface Reminder {
+    id: string;
+    message: string;
+    /** When it was set (ms). */
+    createdAt: number;
+    /** When it's next due (ms). */
+    fireAt: number;
+    everySeconds: number | null;
+    /** When a delivery that failed is tried again (ms); its `fireAt` stays the time it was due. */
+    retryAt?: number;
+}
+/** Host options (`FrameworkConfig.heartbeat`). */
+export interface HeartbeatOptions {
+    /** The state file. Default `{storePath}/config/heartbeat.json`. */
+    statePath?: string;
+    /** The schedule a first start writes when there's nothing to import. */
+    defaults?: Partial<HeartbeatSettings>;
+    /**
+     * heartbeat-mcpl's files (its HEARTBEAT_CONFIG_FILE and
+     * HEARTBEAT_REMINDERS_FILE), read once, by a start that finds no state
+     * file, so an agent moving off the server keeps its schedule and its
+     * reminders. They're left as they are.
+     */
+    importFrom?: {
+        configPath?: string;
+        remindersPath?: string;
+    };
+}
+/** A wake the heartbeat asks the framework to deliver. */
+export type HeartbeatWake = {
+    kind: 'heartbeat';
+    reason: 'schedule' | 'manual';
+    silent: boolean;
+    text: string;
+    eventId: string;
+} | {
+    kind: 'reminder';
+    reminderId: string;
+    recurring: boolean;
+    text: string;
+    eventId: string;
+};
+/**
+ * A time as the heartbeat's texts show it, to the second, with its offset and
+ * zone: `2026-10-26T09:00:00-07:00 [America/Los_Angeles]`, as heartbeat-mcpl
+ * wrote it, so the agent reads its ticks and reminders as before.
+ */
+export declare function formatHeartbeatTime(value: number, timeZone: string): string;
+/** The text a reminder brings: a header naming it, then its message. */
+export declare function reminderText(rem: Reminder, now: number, timeZone: string): string;
+export declare class Heartbeat {
+    private readonly statePath;
+    private readonly defaults;
+    private readonly importFrom;
+    private readonly timeZone;
+    private readonly deliver;
+    private readonly now;
+    private readonly tools;
+    private state;
+    /** Why the state file can't be written now, when it can't (its text couldn't be read and set aside). */
+    private unsaveable;
+    /** What the last save's failure was, for the tool that made the change. */
+    private lastSaveError;
+    private cancelTick;
+    private cancelReminders;
+    /** Nothing fires before this (ms): a start's grace for what fell due while the host was down. */
+    private notBefore;
+    private started;
+    constructor(opts: {
+        statePath: string;
+        timeZone: string;
+        deliver: (wake: HeartbeatWake) => void;
+        defaults?: Partial<HeartbeatSettings>;
+        importFrom?: HeartbeatOptions['importFrom'];
+        now?: () => number;
+    });
+    /** Load (or import, or create) the state and arm the timers. */
+    start(): void;
+    /** Clear the timers; the state stays saved. */
+    stop(): void;
+    /** The tools, named as agents call them (`heartbeat--…`). */
+    getTools(): ToolDefinition[];
+    /** Whether `name` is one of the heartbeat's tools, by its name or heartbeat-mcpl's. */
+    ownsTool(name: string): boolean;
+    /** What the heartbeat will wake the agent with, soonest first, for the reply judge (UpcomingWake). */
+    upcomingWakes(): UpcomingWake[];
+    /**
+     * Handle a call to one of the tools, by its full name. Arguments are read
+     * as a wake rule's are: a slip of a parameter's name, or a field given
+     * outside the parameter it belongs to, refuses the call, naming it; an
+     * unknown name is noted in the result.
+     */
+    handleToolCall(calledName: string, rawInput: unknown): {
+        success: boolean;
+        data?: string;
+        error?: string;
+        isError?: boolean;
+    };
+    private refuse;
+    private statusLine;
+    private statusText;
+    private saveNote;
+    private configure;
+    private trigger;
+    private addReminder;
+    private describe;
+    private listText;
+    private cancelReminder;
+    private armTick;
+    /** Deliver one tick; false when delivery threw. */
+    private fireTick;
+    private armReminders;
+    private fireDueReminders;
+    private load;
+    /** The state a file holds, or undefined when it isn't state this framework writes. */
+    private readState;
+    /** heartbeat-mcpl's files, read once when there's no state file and the host names them. */
+    private imported;
+    private save;
+}
+//# sourceMappingURL=heartbeat.d.ts.map

package/dist/src/heartbeat/heartbeat.d.ts.map

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