@seanhogg/builderforce-memory 2026.9.32 → 2026.9.34

package/dist/handoff/budget.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Token estimate + budget math for the hand-off packer.
+ *
+ * The estimate matches Builderforce's gateway heuristic (`workingTranscript.ts`
+ * `messageTokens`): a string content's length / 4, a non-string content's JSON length / 4,
+ * plus any `tool_calls` payload's JSON length, plus 4 tokens of role/framing overhead.
+ */
+import type { HandoffBudgetInput, HandoffMessage, TokenEstimator } from './types.js';
+/** Per-message role/framing overhead, in tokens. */
+export declare const MESSAGE_OVERHEAD_TOKENS = 4;
+/** Default estimator — chars/4, rounded up. */
+export declare const defaultEstimateTokens: TokenEstimator;
+/**
+ * The tokens a hand-off may use: the next model's window less the reply reserve and the
+ * advertised tool schemas. Never negative.
+ */
+export declare function handoffBudget(input: HandoffBudgetInput): number;
+/** A message's content as text: the string itself, else its JSON. */
+export declare function contentText(content: unknown): string;
+/** Does this assistant message carry tool calls? */
+export declare function hasToolCalls(m: HandoffMessage): boolean;
+/** Estimated tokens for one message (content + tool-call payload + framing). */
+export declare function messageTokens(m: HandoffMessage, estimate: TokenEstimator): number;
+/** Estimated tokens for a list of messages. */
+export declare function tokensOf(msgs: readonly HandoffMessage[], estimate: TokenEstimator): number;
+/**
+ * The longest prefix of `text` (with a trailing ellipsis when cut) whose estimate is at
+ * most `maxTokens`; '' when not even one character fits. Binary search, so it works for
+ * any monotone estimator, not only chars/4.
+ */
+export declare function fitText(text: string, maxTokens: number, estimate: TokenEstimator): string;
+/** A char budget a `recall` callback can honour for `tokens` tokens under `estimate`. */
+export declare function charsForTokens(tokens: number, estimate: TokenEstimator): number;
+//# sourceMappingURL=budget.d.ts.map

package/dist/handoff/budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../src/handoff/budget.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAErF,oDAAoD;AACpD,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,+CAA+C;AAC/C,eAAO,MAAM,qBAAqB,EAAE,cAAqD,CAAC;AAE1F;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAG/D;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAGpD;AAED,oDAAoD;AACpD,wBAAgB,YAAY,CAAC,CAAC,EAAE,cAAc,GAAG,OAAO,CAGvD;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,CAAC,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,CAIjF;AAED,+CAA+C;AAC/C,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,cAAc,EAAE,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,CAI1F;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,CAWzF;AAED,yFAAyF;AACzF,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,CAO/E"}

package/dist/handoff/budget.js

@@ -0,0 +1,77 @@
+/**
+ * Token estimate + budget math for the hand-off packer.
+ *
+ * The estimate matches Builderforce's gateway heuristic (`workingTranscript.ts`
+ * `messageTokens`): a string content's length / 4, a non-string content's JSON length / 4,
+ * plus any `tool_calls` payload's JSON length, plus 4 tokens of role/framing overhead.
+ */
+/** Per-message role/framing overhead, in tokens. */
+export const MESSAGE_OVERHEAD_TOKENS = 4;
+/** Default estimator — chars/4, rounded up. */
+export const defaultEstimateTokens = (text) => Math.ceil(text.length / 4);
+/**
+ * The tokens a hand-off may use: the next model's window less the reply reserve and the
+ * advertised tool schemas. Never negative.
+ */
+export function handoffBudget(input) {
+    const budget = input.targetContextTokens - input.reserveOutputTokens - (input.toolsTokens ?? 0);
+    return Math.max(0, Math.floor(budget));
+}
+/** A message's content as text: the string itself, else its JSON. */
+export function contentText(content) {
+    if (typeof content === 'string')
+        return content;
+    return JSON.stringify(content ?? '') ?? '';
+}
+/** Does this assistant message carry tool calls? */
+export function hasToolCalls(m) {
+    if (m.tool_calls == null)
+        return false;
+    return Array.isArray(m.tool_calls) ? m.tool_calls.length > 0 : true;
+}
+/** Estimated tokens for one message (content + tool-call payload + framing). */
+export function messageTokens(m, estimate) {
+    let text = contentText(m.content);
+    if (m.tool_calls != null)
+        text += JSON.stringify(m.tool_calls) ?? '';
+    return estimate(text) + MESSAGE_OVERHEAD_TOKENS;
+}
+/** Estimated tokens for a list of messages. */
+export function tokensOf(msgs, estimate) {
+    let total = 0;
+    for (const m of msgs)
+        total += messageTokens(m, estimate);
+    return total;
+}
+/**
+ * The longest prefix of `text` (with a trailing ellipsis when cut) whose estimate is at
+ * most `maxTokens`; '' when not even one character fits. Binary search, so it works for
+ * any monotone estimator, not only chars/4.
+ */
+export function fitText(text, maxTokens, estimate) {
+    if (maxTokens <= 0)
+        return '';
+    if (estimate(text) <= maxTokens)
+        return text;
+    let lo = 0;
+    let hi = text.length;
+    while (lo < hi) {
+        const mid = Math.ceil((lo + hi) / 2);
+        if (estimate(`${text.slice(0, mid)}…`) <= maxTokens)
+            lo = mid;
+        else
+            hi = mid - 1;
+    }
+    return lo > 0 ? `${text.slice(0, lo).trimEnd()}…` : '';
+}
+/** A char budget a `recall` callback can honour for `tokens` tokens under `estimate`. */
+export function charsForTokens(tokens, estimate) {
+    if (tokens <= 0)
+        return 0;
+    // Calibrate on a probe so a custom estimator gets a proportionate budget; fitText
+    // enforces the token ceiling on whatever comes back either way.
+    const probe = 'x'.repeat(400);
+    const perChar = Math.max(estimate(probe), 1) / probe.length;
+    return Math.max(0, Math.floor(tokens / perChar));
+}
+//# sourceMappingURL=budget.js.map

package/dist/handoff/budget.js.map

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

package/dist/handoff/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Model hand-off packing — the `@seanhogg/builderforce-memory/handoff` subpath (PRD 34 §3.3).
+ *
+ * When a conversation moves to another model (a local one with a small window, say),
+ * {@link packHandoff} fits the transcript into that model's budget: the system message(s)
+ * stay, the latest user directive stays verbatim, tool calls are never split from their
+ * results, the verbatim tail takes what the budget allows, and the dropped middle becomes
+ * ONE assistant note (summary → memory recall → elision marker, with a one-line hand-off
+ * note when the models differ).
+ *
+ * Pure: no WebGPU, no IndexedDB, no `node:*` — runs in a Cloudflare Worker, a browser
+ * page and Node alike.
+ */
+export { packHandoff } from './pack.js';
+export { handoffBudget, defaultEstimateTokens, messageTokens, tokensOf } from './budget.js';
+export { handoffLine, elisionMarker } from './note.js';
+export type { HandoffMessage, HandoffPackInput, HandoffPack, HandoffBudgetInput, TokenEstimator, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/handoff/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/handoff/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5F,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACvD,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EAClB,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/handoff/index.js

@@ -0,0 +1,17 @@
+/**
+ * Model hand-off packing — the `@seanhogg/builderforce-memory/handoff` subpath (PRD 34 §3.3).
+ *
+ * When a conversation moves to another model (a local one with a small window, say),
+ * {@link packHandoff} fits the transcript into that model's budget: the system message(s)
+ * stay, the latest user directive stays verbatim, tool calls are never split from their
+ * results, the verbatim tail takes what the budget allows, and the dropped middle becomes
+ * ONE assistant note (summary → memory recall → elision marker, with a one-line hand-off
+ * note when the models differ).
+ *
+ * Pure: no WebGPU, no IndexedDB, no `node:*` — runs in a Cloudflare Worker, a browser
+ * page and Node alike.
+ */
+export { packHandoff } from './pack.js';
+export { handoffBudget, defaultEstimateTokens, messageTokens, tokensOf } from './budget.js';
+export { handoffLine, elisionMarker } from './note.js';
+//# sourceMappingURL=index.js.map

package/dist/handoff/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/handoff/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5F,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}

package/dist/handoff/note.d.ts

@@ -0,0 +1,35 @@
+/**
+ * The ONE assistant note that stands in for the dropped middle of a handed-off
+ * transcript: an optional one-line hand-off note, then the first body source that
+ * succeeds — the `summarize` result, else the `recall` memory block for the latest
+ * directive, else an elision marker. A failing, timing-out or empty source falls through
+ * to the next; nothing here throws for those.
+ */
+import type { HandoffMessage, HandoffPackInput, TokenEstimator } from './types.js';
+/** The hand-off line, or '' when either ref is missing or they are the same model. */
+export declare function handoffLine(from?: string, to?: string): string;
+/** The marker for `n` messages that were dropped with nothing to stand in for them. */
+export declare function elisionMarker(n: number): string;
+/** Header + body as one note text. */
+export declare function composeNote(header: string, body: string): string;
+/** Tokens the note message costs, framing included. */
+export declare function noteTokens(text: string, estimate: TokenEstimator): number;
+export interface NoteRequest {
+    header: string;
+    dropped: readonly HandoffMessage[];
+    directive: HandoffMessage | undefined;
+    /** Tokens the note message may cost, framing included. */
+    room: number;
+    estimate: TokenEstimator;
+    summarize?: HandoffPackInput['summarize'];
+    recall?: HandoffPackInput['recall'];
+    timeoutMs?: number;
+}
+export interface NoteResult {
+    text: string;
+    summarized: boolean;
+    recalled: boolean;
+}
+/** Build the note, or null when not even the elision marker fits `room`. */
+export declare function buildNote(req: NoteRequest): Promise<NoteResult | null>;
+//# sourceMappingURL=note.d.ts.map

package/dist/handoff/note.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"note.d.ts","sourceRoot":"","sources":["../../src/handoff/note.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEnF,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,sCAAsC;AACtC,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,uDAAuD;AACvD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,CAEzE;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IACnC,SAAS,EAAE,cAAc,GAAG,SAAS,CAAC;IACtC,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,CAAC,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAC1C,MAAM,CAAC,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAgCD,4EAA4E;AAC5E,wBAAsB,SAAS,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAqB5E"}

package/dist/handoff/note.js

@@ -0,0 +1,82 @@
+/**
+ * The ONE assistant note that stands in for the dropped middle of a handed-off
+ * transcript: an optional one-line hand-off note, then the first body source that
+ * succeeds — the `summarize` result, else the `recall` memory block for the latest
+ * directive, else an elision marker. A failing, timing-out or empty source falls through
+ * to the next; nothing here throws for those.
+ */
+import { MESSAGE_OVERHEAD_TOKENS, charsForTokens, contentText, fitText } from './budget.js';
+/** The hand-off line, or '' when either ref is missing or they are the same model. */
+export function handoffLine(from, to) {
+    return from && to && from !== to ? `Handed off from ${from} to ${to}.` : '';
+}
+/** The marker for `n` messages that were dropped with nothing to stand in for them. */
+export function elisionMarker(n) {
+    return `[${n} earlier messages omitted]`;
+}
+/** Header + body as one note text. */
+export function composeNote(header, body) {
+    return header ? `${header}\n${body}` : body;
+}
+/** Tokens the note message costs, framing included. */
+export function noteTokens(text, estimate) {
+    return estimate(text) + MESSAGE_OVERHEAD_TOKENS;
+}
+/** Settle `run()` to its trimmed string, or '' on throw, rejection, timeout or non-string. */
+async function attempt(run, timeoutMs) {
+    let timer;
+    try {
+        const work = Promise.resolve().then(run);
+        const raced = timeoutMs && timeoutMs > 0
+            ? Promise.race([work, new Promise((resolve) => { timer = setTimeout(() => resolve(''), timeoutMs); })])
+            : work;
+        const out = await raced;
+        return typeof out === 'string' ? out.trim() : '';
+    }
+    catch {
+        return '';
+    }
+    finally {
+        if (timer !== undefined)
+            clearTimeout(timer);
+    }
+}
+/** `body` cut so header + body fits `room`; '' when nothing of it fits. */
+function fitBody(req, body) {
+    const headerTokens = req.header ? req.estimate(`${req.header}\n`) : 0;
+    let max = req.room - MESSAGE_OVERHEAD_TOKENS - headerTokens;
+    // The estimator need not be additive; shrink until the composed note really fits.
+    for (let tries = 0; tries < 16 && max > 0; tries++, max--) {
+        const fitted = fitText(body, max, req.estimate);
+        if (!fitted)
+            return '';
+        if (noteTokens(composeNote(req.header, fitted), req.estimate) <= req.room)
+            return fitted;
+    }
+    return '';
+}
+/** Build the note, or null when not even the elision marker fits `room`. */
+export async function buildNote(req) {
+    if (req.summarize) {
+        const summarize = req.summarize;
+        const summary = fitBody(req, await attempt(() => summarize(req.dropped), req.timeoutMs));
+        if (summary)
+            return { text: composeNote(req.header, summary), summarized: true, recalled: false };
+    }
+    if (req.recall && req.directive) {
+        const recall = req.recall;
+        const headerTokens = req.header ? req.estimate(`${req.header}\n`) : 0;
+        const budgetChars = charsForTokens(req.room - MESSAGE_OVERHEAD_TOKENS - headerTokens, req.estimate);
+        if (budgetChars > 0) {
+            const query = contentText(req.directive.content);
+            const block = fitBody(req, await attempt(() => recall(query, budgetChars), req.timeoutMs));
+            if (block)
+                return { text: composeNote(req.header, block), summarized: false, recalled: true };
+        }
+    }
+    const marker = composeNote(req.header, elisionMarker(req.dropped.length));
+    if (noteTokens(marker, req.estimate) <= req.room)
+        return { text: marker, summarized: false, recalled: false };
+    return null;
+}
+//# sourceMappingURL=note.js.map

package/dist/handoff/note.js.map

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

package/dist/handoff/pack.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `packHandoff` — fit a transcript into the NEXT model's window (PRD 34 §3.3).
+ *
+ * Shape of the result, mirroring Builderforce's `assembleCompacted`
+ * (brain-embedded/src/workingTranscript.ts):
+ *
+ *   system message(s) · ONE assistant note for the dropped middle · the latest user
+ *   directive re-injected verbatim (only when it fell in the middle) · the verbatim tail
+ *
+ * The tail is the longest run of whole units (see `segments.ts`) from the end that fits
+ * what is left after the system message(s), the directive and room for an elision marker.
+ * Whatever room the tail leaves is the note's: summary, else recall, else the marker.
+ * The result never exceeds the budget unless the system message(s) + directive alone do.
+ */
+import type { HandoffPack, HandoffPackInput } from './types.js';
+export declare function packHandoff(input: HandoffPackInput): Promise<HandoffPack>;
+//# sourceMappingURL=pack.d.ts.map

package/dist/handoff/pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack.d.ts","sourceRoot":"","sources":["../../src/handoff/pack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EAAkB,WAAW,EAAE,gBAAgB,EAAkB,MAAM,YAAY,CAAC;AA6DhG,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAqD/E"}

package/dist/handoff/pack.js

@@ -0,0 +1,110 @@
+/**
+ * `packHandoff` — fit a transcript into the NEXT model's window (PRD 34 §3.3).
+ *
+ * Shape of the result, mirroring Builderforce's `assembleCompacted`
+ * (brain-embedded/src/workingTranscript.ts):
+ *
+ *   system message(s) · ONE assistant note for the dropped middle · the latest user
+ *   directive re-injected verbatim (only when it fell in the middle) · the verbatim tail
+ *
+ * The tail is the longest run of whole units (see `segments.ts`) from the end that fits
+ * what is left after the system message(s), the directive and room for an elision marker.
+ * Whatever room the tail leaves is the note's: summary, else recall, else the marker.
+ * The result never exceeds the budget unless the system message(s) + directive alone do.
+ */
+import { defaultEstimateTokens, handoffBudget, messageTokens, tokensOf } from './budget.js';
+import { buildNote, composeNote, elisionMarker, handoffLine, noteTokens } from './note.js';
+import { segmentTranscript } from './segments.js';
+/** Index of the last `user` message, or -1. */
+function latestDirectiveIndex(convo) {
+    for (let i = convo.length - 1; i >= 0; i--)
+        if (convo[i].role === 'user')
+            return i;
+    return -1;
+}
+/**
+ * Longest suffix of whole segments that fits `room`, counting the directive's cost
+ * separately while it still sits before the suffix. Never leads with a `tool` result.
+ */
+function selectTail(convo, segs, directiveIdx, directiveTokens, room) {
+    let start = convo.length;
+    let tokens = 0;
+    let first = segs.length;
+    for (let s = segs.length - 1; s >= 0; s--) {
+        const seg = segs[s];
+        const directiveOutside = directiveIdx >= 0 && directiveIdx < seg.start;
+        if (tokens + seg.tokens + (directiveOutside ? directiveTokens : 0) > room)
+            break;
+        tokens += seg.tokens;
+        start = seg.start;
+        first = s;
+    }
+    // Only an orphan result at the very front can lead a unit with `tool`; drop it.
+    while (first < segs.length && convo[segs[first].start].role === 'tool') {
+        tokens -= segs[first].tokens;
+        first += 1;
+        start = first < segs.length ? segs[first].start : convo.length;
+    }
+    return { start, tokens };
+}
+function result(messages, dropped, estimate, extra = {}) {
+    return {
+        messages,
+        dropped,
+        summarized: extra.summarized ?? false,
+        recalled: extra.recalled ?? false,
+        estimatedTokens: tokensOf(messages, estimate),
+        fits: extra.fits ?? true,
+    };
+}
+export async function packHandoff(input) {
+    const estimate = input.estimateTokens ?? defaultEstimateTokens;
+    const budget = handoffBudget(input);
+    const all = input.messages;
+    // Under budget: hand the transcript over untouched.
+    if (tokensOf(all, estimate) <= budget)
+        return result(all.slice(), 0, estimate);
+    const system = all.filter((m) => m.role === 'system');
+    const convo = all.filter((m) => m.role !== 'system');
+    const systemTokens = tokensOf(system, estimate);
+    const directiveIdx = latestDirectiveIndex(convo);
+    const directive = directiveIdx >= 0 ? convo[directiveIdx] : undefined;
+    const directiveTokens = directive ? messageTokens(directive, estimate) : 0;
+    // The irreducible core does not fit: send it anyway and say so.
+    if (systemTokens + directiveTokens > budget) {
+        const core = directive ? [...system, directive] : [...system];
+        return result(core, convo.length - (directive ? 1 : 0), estimate, { fits: false });
+    }
+    // Reserve room for the smallest note (the marker, at its widest count) when it fits.
+    const header = handoffLine(input.from, input.to);
+    const minNote = noteTokens(composeNote(header, elisionMarker(convo.length)), estimate);
+    const noteFits = systemTokens + directiveTokens + minNote <= budget;
+    const room = budget - systemTokens - (noteFits ? minNote : 0);
+    const tail = selectTail(convo, segmentTranscript(convo, estimate), directiveIdx, directiveTokens, room);
+    const reinject = directive !== undefined && directiveIdx < tail.start;
+    const droppedMsgs = convo.slice(0, tail.start).filter((_, i) => !(reinject && i === directiveIdx));
+    const used = systemTokens + tail.tokens + (reinject ? directiveTokens : 0);
+    const note = droppedMsgs.length > 0
+        ? await buildNote({
+            header,
+            dropped: droppedMsgs,
+            directive,
+            room: budget - used,
+            estimate,
+            summarize: input.summarize,
+            recall: input.recall,
+            timeoutMs: input.timeoutMs,
+        })
+        : null;
+    const messages = [...system];
+    if (note)
+        messages.push({ role: 'assistant', content: note.text });
+    if (reinject && directive)
+        messages.push(directive);
+    messages.push(...convo.slice(tail.start));
+    return result(messages, droppedMsgs.length, estimate, {
+        summarized: note?.summarized ?? false,
+        recalled: note?.recalled ?? false,
+    });
+}
+//# sourceMappingURL=pack.js.map

package/dist/handoff/pack.js.map

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

package/dist/handoff/segments.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Atomic units of a transcript — the pieces the packer keeps or drops whole.
+ *
+ * An assistant message carrying `tool_calls` and the `tool` results that follow it form
+ * ONE unit: strict vendors reject a tool result whose call is missing, and a call whose
+ * results are missing. Every other message is a unit of its own. A stray `tool` result
+ * with no owning call joins the unit before it, so it can never lead a verbatim tail.
+ */
+import type { HandoffMessage, TokenEstimator } from './types.js';
+/** A contiguous, never-split run of messages: `messages = convo.slice(start, end)`. */
+export interface Segment {
+    start: number;
+    end: number;
+    tokens: number;
+}
+/** Split `convo` into atomic units, in order. */
+export declare function segmentTranscript(convo: readonly HandoffMessage[], estimate: TokenEstimator): Segment[];
+//# sourceMappingURL=segments.d.ts.map

package/dist/handoff/segments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"segments.d.ts","sourceRoot":"","sources":["../../src/handoff/segments.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjE,uFAAuF;AACvF,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,iDAAiD;AACjD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,EAAE,CAqBvG"}

package/dist/handoff/segments.js

@@ -0,0 +1,36 @@
+/**
+ * Atomic units of a transcript — the pieces the packer keeps or drops whole.
+ *
+ * An assistant message carrying `tool_calls` and the `tool` results that follow it form
+ * ONE unit: strict vendors reject a tool result whose call is missing, and a call whose
+ * results are missing. Every other message is a unit of its own. A stray `tool` result
+ * with no owning call joins the unit before it, so it can never lead a verbatim tail.
+ */
+import { hasToolCalls, messageTokens } from './budget.js';
+/** Split `convo` into atomic units, in order. */
+export function segmentTranscript(convo, estimate) {
+    const out = [];
+    let i = 0;
+    while (i < convo.length) {
+        const m = convo[i];
+        let end = i + 1;
+        if (m.role === 'assistant' && hasToolCalls(m)) {
+            while (end < convo.length && convo[end].role === 'tool')
+                end += 1;
+        }
+        let tokens = 0;
+        for (let k = i; k < end; k++)
+            tokens += messageTokens(convo[k], estimate);
+        const prev = out[out.length - 1];
+        if (m.role === 'tool' && prev) {
+            prev.end = end;
+            prev.tokens += tokens;
+        }
+        else {
+            out.push({ start: i, end, tokens });
+        }
+        i = end;
+    }
+    return out;
+}
+//# sourceMappingURL=segments.js.map

package/dist/handoff/segments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"segments.js","sourceRoot":"","sources":["../../src/handoff/segments.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAU1D,iDAAiD;AACjD,MAAM,UAAU,iBAAiB,CAAC,KAAgC,EAAE,QAAwB;IAC1F,MAAM,GAAG,GAAc,EAAE,CAAC;IAC1B,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QACxB,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACpB,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QAChB,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9C,OAAO,GAAG,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,GAAG,CAAE,CAAC,IAAI,KAAK,MAAM;gBAAE,GAAG,IAAI,CAAC,CAAC;QACrE,CAAC;QACD,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE;YAAE,MAAM,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,QAAQ,CAAC,CAAC;QAC3E,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACjC,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC;YAC9B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;YACf,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;QACtC,CAAC;QACD,CAAC,GAAG,GAAG,CAAC;IACV,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/handoff/types.d.ts

@@ -0,0 +1,59 @@
+/**
+ * The hand-off contract (PRD 34 §3.3) — the shapes a host passes in and gets back when
+ * a conversation moves from one model to another whose context window may be smaller.
+ * Pure data: no runtime imports, so the subpath stays Worker/browser/Node safe.
+ */
+/** One chat message in the OpenAI-style shape every Builderforce host already speaks. */
+export interface HandoffMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: unknown;
+    tool_calls?: unknown;
+    tool_call_id?: string;
+}
+/** What {@link packHandoff} packs, and the budget it packs into. */
+export interface HandoffPackInput {
+    messages: readonly HandoffMessage[];
+    /** The NEXT model's context window, in tokens. */
+    targetContextTokens: number;
+    /** Tokens held back for the next model's reply. */
+    reserveOutputTokens: number;
+    /** Tokens the advertised tool schemas cost. */
+    toolsTokens?: number;
+    /** Model refs, for the one-line hand-off note. */
+    from?: string;
+    to?: string;
+    /** Memory block for the latest directive, at most `budgetChars` long. */
+    recall?: (query: string, budgetChars: number) => Promise<string>;
+    /** Summary of the dropped middle. */
+    summarize?: (dropped: readonly HandoffMessage[]) => Promise<string>;
+    /** Token estimate for a text. Default: chars/4, rounded up. */
+    estimateTokens?: (text: string) => number;
+    /**
+     * Optional ceiling (ms) on each of `summarize` / `recall`. A call that outlives it is
+     * treated as a failure and packing falls through to the next note source. No ceiling
+     * when omitted.
+     */
+    timeoutMs?: number;
+}
+/** The packed transcript and how it was made. */
+export interface HandoffPack {
+    messages: HandoffMessage[];
+    /** Messages from the input that are in neither the verbatim tail nor re-injected. */
+    dropped: number;
+    /** The note carries the `summarize` result. */
+    summarized: boolean;
+    /** The note carries the `recall` result. */
+    recalled: boolean;
+    estimatedTokens: number;
+    /** False only when the system message(s) + the latest directive alone exceed the budget. */
+    fits: boolean;
+}
+/** The three numbers the usable budget is computed from. */
+export interface HandoffBudgetInput {
+    targetContextTokens: number;
+    reserveOutputTokens: number;
+    toolsTokens?: number;
+}
+/** A text → token-count estimator. */
+export type TokenEstimator = (text: string) => number;
+//# sourceMappingURL=types.d.ts.map

package/dist/handoff/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/handoff/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,yFAAyF;AACzF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,oEAAoE;AACpE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;IACpC,kDAAkD;IAClD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mDAAmD;IACnD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,yEAAyE;IACzE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACjE,qCAAqC;IACrC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACpE,+DAA+D;IAC/D,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC1C;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,iDAAiD;AACjD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,qFAAqF;IACrF,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,UAAU,EAAE,OAAO,CAAC;IACpB,4CAA4C;IAC5C,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,4FAA4F;IAC5F,IAAI,EAAE,OAAO,CAAC;CACf;AAED,4DAA4D;AAC5D,MAAM,WAAW,kBAAkB;IACjC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,sCAAsC;AACtC,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC"}

package/dist/handoff/types.js

@@ -0,0 +1,7 @@
+/**
+ * The hand-off contract (PRD 34 §3.3) — the shapes a host passes in and gets back when
+ * a conversation moves from one model to another whose context window may be smaller.
+ * Pure data: no runtime imports, so the subpath stays Worker/browser/Node safe.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/handoff/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/handoff/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/limbic/LimbicSession.d.ts

@@ -37,8 +37,8 @@ export interface LimbicSessionOptions {
      */
     personalityTraits?: PersonalityTraits;
     /**
-     * An explicit 8-dim resting setpoint (e.g. one already derived by the runtime's
-     * `deriveLimbicSetpoints`). Overrides {@link personalityTraits}. Clamped to bounds.
+     * An explicit 8-dim resting setpoint (e.g. one already derived with the
+     * engine's `limbicSetpoints`). Overrides {@link personalityTraits}. Clamped to bounds.
      */
     personalitySetpoint?: ArrayLike<number>;
 }