@animalabs/agent-framework 0.26.2 → 0.28.0

package/dist/src/gate/recipe-reconcile.js

@@ -0,0 +1,325 @@
+/**
+ * What a start does to an existing gate.json, given the recipe's gate config.
+ *
+ * The gate keeps the recipe it last applied in a file of its own beside
+ * gate.json (`gate.recipe.json` for `gate.json`), written by the gate. A start
+ * merges the recipe into gate.json three ways, rule by rule, against it:
+ * - a rule as the last recipe left it follows the new recipe: it takes the
+ *   new definition, or goes when the new recipe no longer declares it, so a
+ *   renamed rule goes under its old name and comes in under its new one;
+ * - a rule edited since the last recipe keeps its definition, unless it now
+ *   agrees with the recipe's;
+ * - a rule both recipes declare, removed from gate.json since, comes back;
+ * - a rule no recipe declared (added at run time, or by hand) stays, and if
+ *   the recipe now declares it as it stands, it's the recipe's from then on;
+ * - a rule new in the recipe comes in.
+ *
+ * Order is an edit of its own, apart from a rule's definition. When gate.json
+ * holds the rules both recipes declare in the last recipe's order, the recipe's
+ * rules take the new recipe's order, in the places gate.json gives them, and
+ * every other rule keeps its place. When one of them was moved since
+ * (wake_add_rule's position moves one), gate.json's order stays. Either way, a
+ * recipe rule new to gate.json goes before the recipe rule that follows it
+ * there, or after the one before it when none follows.
+ * `default` follows the same rule as a definition.
+ *
+ * Without a last recipe, as at the first start after this change, nothing is
+ * removed or redefined: the rules that match the recipe by name and definition
+ * take its order, every other rule stays, and the line names those that differ
+ * from the recipe or aren't in it. A rule that differs can be removed, and the
+ * next start restores it from the recipe.
+ *
+ * Rules are compared by what they mean and kept as written. Two rules agree
+ * when the gate reads them the same, so a rule `wake_add_rule` wrote as the
+ * gate reads it agrees with the recipe's rule as written, and a change to a
+ * field the gate doesn't read alone isn't an edit; the caller gives the
+ * meaning (`meaningOf`). A rule the gate leaves out has no reading, so it is
+ * compared as written, a change to any of its fields an edit. A rule that agrees with the recipe stays as gate.json
+ * holds it, and one that follows the recipe takes the recipe's rule as
+ * written. A rule with no name stays where gate.json holds it, and a recipe's
+ * rule with no name is never merged: the merge keys rules by name.
+ */
+/** The file beside gate.json that holds the recipe the gate last applied. */
+export function lastRecipePath(configPath) {
+    return `${configPath.replace(/\.json$/, '')}.recipe.json`;
+}
+function sortKeys(value) {
+    if (Array.isArray(value))
+        return value.map(sortKeys);
+    if (value && typeof value === 'object') {
+        // No prototype, so a key such as "__proto__", which JSON.parse gives as an
+        // own field, is copied as one rather than setting the prototype.
+        const out = Object.create(null);
+        for (const key of Object.keys(value).sort()) {
+            out[key] = sortKeys(value[key]);
+        }
+        return out;
+    }
+    return value;
+}
+/** A config or policy as text that doesn't depend on its keys' order. */
+export function canonical(value) {
+    return JSON.stringify(sortKeys(value));
+}
+const same = (a, b) => canonical(a) === canonical(b);
+/** Changes with nothing in them, for a start to fill. */
+export function noChanges() {
+    return {
+        added: [], removed: [], updated: [], restored: [], moved: [],
+        keptEdited: [], differsFromRecipe: [], outsideRecipe: [], orderKept: false,
+    };
+}
+/** A rule's name as written, when it has a usable one. */
+export function ruleName(rule) {
+    if (!rule || typeof rule !== 'object' || Array.isArray(rule))
+        return undefined;
+    const name = rule.name;
+    return typeof name === 'string' && name ? name : undefined;
+}
+/** A rule name the list gives more than once, if any: the merge keys rules by name. */
+export function duplicateName(rules) {
+    const seen = new Set();
+    for (const rule of rules) {
+        const name = ruleName(rule);
+        if (name === undefined)
+            continue;
+        if (seen.has(name))
+            return name;
+        seen.add(name);
+    }
+    return undefined;
+}
+/** A `default` as the gate reads one: left out, null or "" is "always". */
+function behaviorOf(value) {
+    return value === undefined || value === null || value === '' ? 'always' : value;
+}
+/** The names in one longest sequence that `a` and `b` share in order. */
+function longestShared(a, b) {
+    const rows = a.length + 1;
+    const cols = b.length + 1;
+    const table = Array.from({ length: rows }, () => new Array(cols).fill(0));
+    for (let i = a.length - 1; i >= 0; i--) {
+        for (let j = b.length - 1; j >= 0; j--) {
+            table[i][j] = a[i] === b[j] ? table[i + 1][j + 1] + 1 : Math.max(table[i + 1][j], table[i][j + 1]);
+        }
+    }
+    const shared = new Set();
+    let i = 0;
+    let j = 0;
+    while (i < a.length && j < b.length) {
+        if (a[i] === b[j]) {
+            shared.add(a[i]);
+            i++;
+            j++;
+        }
+        else if (table[i + 1][j] > table[i][j + 1]) {
+            i++;
+        }
+        else {
+            // On a tie, the result's rule is the one named as moved: the rule a
+            // swap brought earlier, such as one the old appending left behind a
+            // catch-all.
+            j++;
+        }
+    }
+    return shared;
+}
+/**
+ * Merge `recipe` into `live` against `last`, the recipe last applied (null
+ * when there is none), each as written. Pure: the caller reads and writes the
+ * files, and gives `meaningOf`, a rule's meaning as a string two rules share
+ * when they mean the same (as written, unless given). Returns the rule list
+ * and `default` to write, each as written, and whether `default` changed.
+ * Throws when `live` or `recipe` names a rule twice, since the merge keys
+ * rules by name.
+ */
+export function reconcileWithRecipe(live, recipe, last, meaningOf = canonical) {
+    const agree = (a, b) => meaningOf(a) === meaningOf(b);
+    const liveDuplicate = duplicateName(live.rules);
+    if (liveDuplicate !== undefined) {
+        throw new Error(`gate.json names the rule "${liveDuplicate}" twice`);
+    }
+    const recipeDuplicate = duplicateName(recipe.rules);
+    if (recipeDuplicate !== undefined) {
+        throw new Error(`the recipe names the rule "${recipeDuplicate}" twice`);
+    }
+    const changes = noChanges();
+    // Each rule by its name; a rule with no name by a key no name can be, so
+    // it keeps its place and matches nothing.
+    const keyOf = (rule, index) => ruleName(rule) ?? `\u0000nameless ${index}`;
+    const byName = (rules) => new Map(rules.flatMap((rule) => {
+        const name = ruleName(rule);
+        return name === undefined ? [] : [[name, rule]];
+    }));
+    const inLive = new Map(live.rules.map((rule, index) => [keyOf(rule, index), rule]));
+    const inRecipe = byName(recipe.rules);
+    const inLast = last ? byName(last.rules) : null;
+    // Each rule gate.json keeps, with its definition, and which of them take
+    // the recipe's order (`ordered`); the rest keep their places.
+    const definitions = new Map();
+    const ordered = new Set();
+    live.rules.forEach((rule, index) => {
+        const name = keyOf(rule, index);
+        const declared = inRecipe.get(name);
+        const before = inLast?.get(name);
+        if (declared !== undefined && agree(rule, declared)) {
+            // As the recipe has it: kept as written, whatever the record says, and
+            // nothing to change or name.
+            definitions.set(name, rule);
+            ordered.add(name);
+        }
+        else if (ruleName(rule) === undefined) {
+            definitions.set(name, rule);
+        }
+        else if (!inLast) {
+            definitions.set(name, rule);
+            (declared !== undefined ? changes.differsFromRecipe : changes.outsideRecipe).push(name);
+        }
+        else if (before !== undefined) {
+            const edited = !agree(rule, before);
+            if (declared === undefined) {
+                if (edited) {
+                    definitions.set(name, rule);
+                    changes.keptEdited.push(name);
+                }
+                else {
+                    changes.removed.push(name);
+                }
+            }
+            else {
+                // Both recipes declare it: it's a recipe rule, so it takes the recipe's order.
+                ordered.add(name);
+                if (edited) {
+                    definitions.set(name, rule);
+                    if (!agree(declared, before))
+                        changes.keptEdited.push(name);
+                }
+                else {
+                    definitions.set(name, declared);
+                    changes.updated.push(name);
+                }
+            }
+        }
+        else {
+            // No recipe declared it as it stands: a run-time rule, or one the recipe
+            // now declares otherwise.
+            definitions.set(name, rule);
+            if (declared !== undefined)
+                changes.differsFromRecipe.push(name);
+        }
+    });
+    const liveOrder = live.rules.map(keyOf);
+    const recipeOrder = recipe.rules.flatMap((rule) => {
+        const name = ruleName(rule);
+        return name === undefined ? [] : [name];
+    });
+    const staying = liveOrder.filter((name) => definitions.has(name));
+    // Whether gate.json holds the rules both recipes declare in the last recipe's order.
+    const shared = (order) => order.filter((name) => inLast?.has(name) && inRecipe.has(name) && inLive.has(name));
+    const lastOrder = last ? last.rules.flatMap((rule) => {
+        const name = ruleName(rule);
+        return name === undefined ? [] : [name];
+    }) : [];
+    const followsLast = canonical(shared(liveOrder)) === canonical(shared(lastOrder));
+    let order;
+    if (followsLast) {
+        // The recipe's rules fill the places its rules hold, in the recipe's order.
+        const recipeRules = recipeOrder.filter((name) => ordered.has(name));
+        let next = 0;
+        order = staying.map((name) => (ordered.has(name) ? recipeRules[next++] : name));
+    }
+    else {
+        order = staying;
+        // Named only when it holds something back: the recipe reordered these
+        // rules, and gate.json doesn't already hold the recipe's order.
+        changes.orderKept = canonical(shared(recipeOrder)) !== canonical(shared(lastOrder))
+            && canonical(shared(liveOrder)) !== canonical(shared(recipeOrder));
+    }
+    // A recipe rule new to gate.json goes before the recipe rule that follows it
+    // there, or after the one before it when none follows.
+    recipeOrder.forEach((name, index) => {
+        if (inLive.has(name))
+            return;
+        definitions.set(name, inRecipe.get(name));
+        (inLast?.has(name) ? changes.restored : changes.added).push(name);
+        const following = recipeOrder.slice(index + 1).find((later) => order.includes(later));
+        if (following !== undefined) {
+            order.splice(order.indexOf(following), 0, name);
+            return;
+        }
+        const preceding = recipeOrder.slice(0, index).reverse().find((earlier) => order.includes(earlier));
+        if (preceding !== undefined)
+            order.splice(order.indexOf(preceding) + 1, 0, name);
+        else
+            order.push(name);
+    });
+    // Only the recipe's rules move; every other rule keeps its place.
+    const stayedInOrder = longestShared(staying.filter((name) => ordered.has(name)), order.filter((name) => ordered.has(name)));
+    changes.moved = order.filter((name) => ordered.has(name) && !stayedInOrder.has(name));
+    // `default` as the gate reads it, compared as written once read.
+    const liveDefault = behaviorOf(live.default);
+    const recipeDefault = behaviorOf(recipe.default);
+    let defaultBehavior = live.default;
+    let defaultChanged = false;
+    const shownBehavior = (value) => (typeof value === 'string' ? value : JSON.stringify(value));
+    if (!last) {
+        if (!same(liveDefault, recipeDefault))
+            changes.defaultDiffers = { kept: shownBehavior(liveDefault), recipe: shownBehavior(recipeDefault) };
+    }
+    else {
+        const lastDefault = behaviorOf(last.default);
+        if (same(liveDefault, lastDefault) || same(liveDefault, recipeDefault)) {
+            if (!same(recipeDefault, liveDefault)) {
+                defaultBehavior = recipe.default;
+                defaultChanged = true;
+                changes.defaultChange = { from: shownBehavior(liveDefault), to: shownBehavior(recipeDefault) };
+            }
+        }
+        else if (!same(recipeDefault, lastDefault)) {
+            changes.defaultKept = shownBehavior(liveDefault);
+        }
+    }
+    return {
+        rules: order.map((name) => definitions.get(name)),
+        default: defaultBehavior,
+        defaultChanged,
+        changes,
+    };
+}
+/** The log line a start gives its changes, or null when it changed nothing worth saying. */
+export function reconcileLine(changes) {
+    const parts = [];
+    if (changes.recordUnreadable !== undefined) {
+        parts.push(`the recorded recipe couldn't be read (${changes.recordUnreadable}), so this start removed and redefined nothing`);
+    }
+    const list = (label, names) => {
+        if (names.length > 0)
+            parts.push(`${label} ${names.join(', ')}`);
+    };
+    list('added', changes.added);
+    list('removed', changes.removed);
+    list('updated', changes.updated);
+    list('restored', changes.restored);
+    list('moved', changes.moved);
+    list('kept as edited, though the recipe changed or dropped it:', changes.keptEdited);
+    if (changes.differsFromRecipe.length > 0) {
+        parts.push(`kept, though the recipe defines it otherwise: ${changes.differsFromRecipe.join(', ')} `
+            + '(remove such a rule, and the next start restores it from the recipe)');
+    }
+    if (changes.outsideRecipe.length > 0) {
+        parts.push(`kept, not in the recipe: ${changes.outsideRecipe.join(', ')} `
+            + "(a stale one can be removed, and no start brings it back)");
+    }
+    if (changes.defaultChange)
+        parts.push(`default ${changes.defaultChange.from} → ${changes.defaultChange.to}`);
+    if (changes.defaultKept)
+        parts.push(`default kept as edited (${changes.defaultKept}), though the recipe changed it`);
+    if (changes.defaultDiffers) {
+        parts.push(`default kept as gate.json has it (${changes.defaultDiffers.kept}), though the recipe's is ${changes.defaultDiffers.recipe} `
+            + "(set it to the recipe's, and later starts follow the recipe)");
+    }
+    if (changes.orderKept)
+        parts.push("gate.json's order kept, though the recipe reordered its rules, since a recipe rule was moved in it");
+    return parts.length > 0 ? `[gate] the recipe was applied to gate.json: ${parts.join('; ')}` : null;
+}
+//# sourceMappingURL=recipe-reconcile.js.map

package/dist/src/gate/recipe-reconcile.js.map

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

package/dist/src/gate/reply-judge.d.ts

@@ -0,0 +1,116 @@
+/**
+ * ReplyJudge — the small model a `judge` wake rule asks whether now is a good
+ * time for the agent to reply (JudgeConfig).
+ *
+ * Per batch it takes the request the agent WOULD send if woken now (the
+ * framework's previewActivation, a dry run that commits nothing), renders it
+ * as one plain-text document (the agent's system prompt, abridged, then its
+ * conversation, oldest first), keeps the newest part of that document that
+ * fits the judge's input budget, and asks the model, with the agent's own
+ * instructions and the batch, for one line: `REPLY: <reason>` or
+ * `WAIT: <reason>`.
+ *
+ * Cost and latency. The budget (`maxInputTokens`, default 90,000) keeps every
+ * request under the 100,000-token line past which Claude Haiku 5.5 costs five
+ * times as much. Tokens are estimated from characters, at a ratio the judge
+ * corrects from every response's reported input, so the estimate tracks the
+ * model's tokenizer and the context's mix of prose and code. The document is
+ * sent as a run of chunks that start at an anchor, the first message shown,
+ * which stays put while the window grows into its budget: the chunks before
+ * the newest stay byte-identical from one request to the next, and a cache
+ * breakpoint after the last full one lets every later request read them from
+ * the prompt cache. Only when the window outgrows its budget does the anchor
+ * move, to leave the window a share of the budget to grow into again.
+ *
+ * The judge reads; it never writes into the agent's context and never speaks.
+ */
+import type { DetailedUsage, Membrane, NormalizedMessage, NormalizedRequest } from '@animalabs/membrane';
+import type { JudgeFn, JudgeRequest, ReplyJudgeOptions, UpcomingWake } from './types.js';
+/** The judge's model when the host names none. */
+export declare const DEFAULT_JUDGE_MODEL = "claude-haiku-5-5";
+/** The judge's input budget when the host names none: under Haiku 5.5's 100K price line, with margin. */
+export declare const DEFAULT_JUDGE_MAX_INPUT_TOKENS = 90000;
+/** The smallest input budget the judge takes: its instructions, the batch and a little context. A
+ *  host that wants only the newest few messages read (a short tail, cheaper and quicker, with less
+ *  of the room's history to weigh) sets a budget near it. */
+export declare const MIN_JUDGE_INPUT_TOKENS = 4000;
+/** What the framework gives the judge. */
+export interface ReplyJudgeDeps {
+    /** The membrane the judge calls for an agent. The framework's binds the
+     *  judge as it binds compression, refusing a call rather than waiting under
+     *  a hold, and never waits on the agent's turn. */
+    membraneFor: (agentName: string) => Membrane;
+    options?: ReplyJudgeOptions;
+    /** Which of the batch's agents the judge reads the context of. */
+    chooseAgent: (agentNames: string[]) => string | undefined;
+    /** The request the agent would send if woken now, as a dry run (previewActivation). */
+    preview: (agentName: string) => Promise<NormalizedRequest>;
+    /** Count a judge request's usage as the agent's, where its turns' usage is counted. */
+    recordUsage?: (agentName: string, usage: DetailedUsage) => void;
+    /** What else will wake the agent with no new event, beyond the gate's own
+     *  timers the request carries: wakes the framework has queued or holds. A
+     *  provider that throws counts as knowing of none. */
+    upcomingWakes?: (agentName: string) => UpcomingWake[] | Promise<UpcomingWake[]>;
+}
+/** A message as the document shows it: its participant, and each block as text. Thinking is the agent's own, and isn't shown. */
+export declare function renderMessage(message: NormalizedMessage): string;
+/** Text no longer than `max` characters: a longer one keeps its head and tail, the middle named as cut. */
+export declare function cut(text: string, max: number): string;
+/**
+ * What waiting would leave the agent with: what wakes it anyway, soonest
+ * first, or that nothing the host knows of is scheduled. A server's own
+ * timers (a heartbeat, a reminder) are listed only where the host was told
+ * of them, so the empty case says so.
+ */
+export declare function ifYouWait(wakes: readonly UpcomingWake[], agentName: string, now: number): string;
+/**
+ * The verdict in a response's text: its last line that starts with REPLY or
+ * WAIT in capitals followed by a colon or a dash, as the judge is asked to
+ * write it. A capital word without one, or a lower-case "reply" or "wait" in
+ * the judge's reasoning ("Wait, they did ask"), isn't a verdict.
+ */
+export declare function parseVerdict(text: string): {
+    reply: boolean;
+    reason: string;
+} | undefined;
+/** The judge's own system prompt: stable per agent, so it caches. */
+export declare function judgeSystemPrompt(agentName: string): string;
+/** The closing message: the batch, the agent's instructions, the question. */
+export declare function judgeQuestion(request: Pick<JudgeRequest, 'events' | 'instructions' | 'upcomingWakes'>, agentName: string, now: number, maxEventChars?: number): string;
+export declare class ReplyJudge {
+    private readonly membraneFor;
+    private readonly cacheTtl;
+    private readonly model;
+    private readonly maxInputTokens;
+    private readonly effort;
+    private readonly chooseAgent;
+    private readonly preview;
+    private readonly recordUsage;
+    private readonly extraWakes;
+    /** Characters per token, corrected from each response's reported input. */
+    private charsPerToken;
+    private readonly anchors;
+    constructor(deps: ReplyJudgeDeps);
+    /** The gate's judge function. */
+    readonly judge: JudgeFn;
+    /** The ratio the judge estimates tokens by now (for tests and status). */
+    estimateRatio(): number;
+    private tokens;
+    /** Build the judge's request for one batch: the system prompt, the document in chunks, the question. */
+    buildRequest(request: JudgeRequest, now?: number): Promise<{
+        request: NormalizedRequest;
+        agentName: string;
+        chars: number;
+    }>;
+    /**
+     * Where the window starts: at last request's anchor, while the window from
+     * there fits; otherwise where the newest messages fill FRESH_WINDOW_SHARE
+     * of the budget, leaving room to grow before it moves again.
+     */
+    private windowStart;
+    private findAnchor;
+    /** Learn the tokenizer's ratio from one response, leaning conservative after an overshoot. */
+    private calibrate;
+    private decide;
+}
+//# sourceMappingURL=reply-judge.d.ts.map

package/dist/src/gate/reply-judge.d.ts.map

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