@enderfga/claw-orchestrator 7.2.0 → 7.4.0

package/dist/src/autoloop/planner-tools.js

@@ -10,9 +10,9 @@
  *   ```
  *
  * After each Planner turn, the dispatcher scans the reply for these blocks,
- * validates them, and translates them into runner-queue messages or direct
- * runner-state mutations. Multiple blocks per turn are allowed and processed
- * in order.
+ * validates the complete batch, and translates it into runner-queue messages
+ * or direct runner-state mutations. Multiple blocks per turn are allowed, but
+ * no effect is applied unless every block is valid.
  *
  * The naming is stable so a future MCP-based implementation can swap the
  * parser for real tool dispatch without changing any Planner-facing
@@ -47,9 +47,161 @@ export function parsePlannerReply(reply) {
     });
     return { calls, cleaned_reply: cleaned.trim(), parse_errors };
 }
+const PUSH_LEVELS = new Set(['info', 'warn', 'decision', 'error']);
+const PUSH_CHANNELS = new Set(['auto', 'wechat', 'webchat', 'both', 'email']);
+function optionalStringArray(value, field) {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value) || value.some((entry) => typeof entry !== 'string')) {
+        throw new Error(`${field} must be an array of strings`);
+    }
+    return value;
+}
+function prepareDirective(raw, tool) {
+    const goal = raw.goal;
+    if (typeof goal !== 'string' || !goal.trim())
+        throw new Error(`${tool} requires \`goal\``);
+    const maxAttempts = raw.max_attempts ?? 1;
+    if (typeof maxAttempts !== 'number' || !Number.isInteger(maxAttempts) || maxAttempts < 1) {
+        throw new Error(`${tool} max_attempts must be a positive integer`);
+    }
+    return {
+        goal,
+        constraints: optionalStringArray(raw.constraints, `${tool} constraints`),
+        success_criteria: optionalStringArray(raw.success_criteria, `${tool} success_criteria`),
+        max_attempts: maxAttempts,
+    };
+}
+function preparePlannerCall(call, iter) {
+    if (typeof call.args !== 'object' || call.args === null || Array.isArray(call.args)) {
+        throw new Error(`${call.tool} requires an object \`args\``);
+    }
+    switch (call.tool) {
+        case 'notify_user': {
+            const { level, summary, detail, channel } = call.args;
+            if (typeof summary !== 'string' || !summary.trim())
+                throw new Error('notify_user requires `summary`');
+            if (level !== undefined && (typeof level !== 'string' || !PUSH_LEVELS.has(level))) {
+                throw new Error('notify_user has invalid `level`');
+            }
+            if (detail !== undefined && typeof detail !== 'string')
+                throw new Error('notify_user `detail` must be a string');
+            if (channel !== undefined && (typeof channel !== 'string' || !PUSH_CHANNELS.has(channel))) {
+                throw new Error('notify_user has invalid `channel`');
+            }
+            return {
+                call,
+                message: Msg.pushUser(iter, {
+                    level: level ?? 'info',
+                    summary,
+                    detail,
+                    channel: channel ?? 'auto',
+                }),
+            };
+        }
+        case 'spawn_subagents': {
+            const raw = call.args;
+            if ('coder_custom_engine' in raw ||
+                'reviewer_custom_engine' in raw ||
+                'coderCustomEngine' in raw ||
+                'reviewerCustomEngine' in raw ||
+                'customEngine' in raw) {
+                throw new Error('spawn_subagents cannot include custom engine config; configure it at autoloop_start');
+            }
+            for (const field of ['coder_engine', 'reviewer_engine']) {
+                const value = raw[field];
+                if (value !== undefined && (typeof value !== 'string' || !ENGINE_TYPES.includes(value))) {
+                    throw new Error(`spawn_subagents ${field} has unknown engine '${String(value)}'`);
+                }
+            }
+            for (const field of ['coder_model', 'reviewer_model']) {
+                const value = raw[field];
+                if (value !== undefined && typeof value !== 'string') {
+                    throw new Error(`spawn_subagents ${field} must be a string`);
+                }
+            }
+            const args = {};
+            if (raw.coder_engine !== undefined)
+                args.coder_engine = raw.coder_engine;
+            if (raw.coder_model !== undefined)
+                args.coder_model = raw.coder_model;
+            if (raw.reviewer_engine !== undefined)
+                args.reviewer_engine = raw.reviewer_engine;
+            if (raw.reviewer_model !== undefined)
+                args.reviewer_model = raw.reviewer_model;
+            let message;
+            if (raw.initial_directive !== undefined) {
+                if (typeof raw.initial_directive !== 'object' ||
+                    raw.initial_directive === null ||
+                    Array.isArray(raw.initial_directive)) {
+                    throw new Error('spawn_subagents initial_directive must be an object');
+                }
+                const directive = prepareDirective(raw.initial_directive, 'spawn_subagents initial_directive');
+                args.initial_directive = directive;
+                message = Msg.directive(iter, directive);
+            }
+            return { call, message, spawnArgs: args };
+        }
+        case 'send_directive': {
+            const directive = prepareDirective(call.args, 'send_directive');
+            return { call, message: Msg.directive(iter, directive) };
+        }
+        case 'pause_loop': {
+            const reason = call.args.reason ?? 'planner-pause';
+            if (typeof reason !== 'string')
+                throw new Error('pause_loop `reason` must be a string');
+            return { call, message: Msg.pause(iter, { reason }) };
+        }
+        case 'resume_loop':
+            return { call, message: Msg.resume(iter) };
+        case 'terminate': {
+            const reason = call.args.reason ?? 'planner-terminate';
+            if (typeof reason !== 'string')
+                throw new Error('terminate `reason` must be a string');
+            return { call, message: Msg.terminate(iter, { reason }) };
+        }
+        case 'update_push_policy':
+            return { call, policyDelta: call.args };
+        case 'write_plan': {
+            const { content, commit_message } = call.args;
+            if (typeof content !== 'string' || !content.trim()) {
+                throw new Error('write_plan requires non-empty `content` (full plan.md body)');
+            }
+            if (commit_message !== undefined && typeof commit_message !== 'string') {
+                throw new Error('write_plan `commit_message` must be a string');
+            }
+            return {
+                call,
+                artifact: { file: 'plan.md', content, commitMessage: commit_message },
+            };
+        }
+        case 'write_goal': {
+            const { content, commit_message } = call.args;
+            if (typeof content !== 'string' || !content.trim()) {
+                throw new Error('write_goal requires non-empty `content` (full goal.json body)');
+            }
+            try {
+                JSON.parse(content);
+            }
+            catch (error) {
+                throw new Error(`write_goal content is not valid JSON: ${error.message}`);
+            }
+            if (commit_message !== undefined && typeof commit_message !== 'string') {
+                throw new Error('write_goal `commit_message` must be a string');
+            }
+            return {
+                call,
+                artifact: { file: 'goal.json', content, commitMessage: commit_message },
+            };
+        }
+        default:
+            throw new Error(`unknown planner tool: ${call.tool}`);
+    }
+}
 /**
- * Apply a batch of parsed tool calls in order. Returns any v2 envelopes that
- * the dispatcher should hand back to the runner so it can route them.
+ * Preflight a complete batch, materialize all artifact writes as one effect,
+ * then apply policy/spawn effects. Spawn is deliberately last, independent of
+ * block order, so roles never start against a partial artifact set.
  *
  * Note: notify_user / pause_loop / resume_loop / terminate / send_directive
  * become v2 messages and flow through the runner's normal queue (so policy,
@@ -57,134 +209,59 @@ export function parsePlannerReply(reply) {
  * push-policy mutation are direct side effects.
  */
 export async function applyPlannerToolCalls(calls, fx, iter) {
-    const emitted_messages = [];
     const errors = [];
+    const prepared = [];
     for (const call of calls) {
         try {
-            switch (call.tool) {
-                case 'notify_user': {
-                    const { level, summary, detail, channel } = call.args;
-                    if (!summary)
-                        throw new Error('notify_user requires `summary`');
-                    emitted_messages.push(Msg.pushUser(iter, {
-                        level: level ?? 'info',
-                        summary,
-                        detail,
-                        channel: channel ?? 'auto',
-                    }));
-                    break;
-                }
-                case 'spawn_subagents': {
-                    const raw = call.args;
-                    if ('coder_custom_engine' in raw ||
-                        'reviewer_custom_engine' in raw ||
-                        'coderCustomEngine' in raw ||
-                        'reviewerCustomEngine' in raw ||
-                        'customEngine' in raw) {
-                        throw new Error('spawn_subagents cannot include custom engine config; configure it at autoloop_start');
-                    }
-                    for (const field of ['coder_engine', 'reviewer_engine']) {
-                        const value = raw[field];
-                        if (value !== undefined && (typeof value !== 'string' || !ENGINE_TYPES.includes(value))) {
-                            throw new Error(`spawn_subagents ${field} has unknown engine '${String(value)}'`);
-                        }
-                    }
-                    for (const field of ['coder_model', 'reviewer_model']) {
-                        const value = raw[field];
-                        if (value !== undefined && typeof value !== 'string') {
-                            throw new Error(`spawn_subagents ${field} must be a string`);
-                        }
-                    }
-                    const args = {};
-                    if (raw.coder_engine !== undefined)
-                        args.coder_engine = raw.coder_engine;
-                    if (raw.coder_model !== undefined)
-                        args.coder_model = raw.coder_model;
-                    if (raw.reviewer_engine !== undefined)
-                        args.reviewer_engine = raw.reviewer_engine;
-                    if (raw.reviewer_model !== undefined)
-                        args.reviewer_model = raw.reviewer_model;
-                    if (raw.initial_directive !== undefined) {
-                        args.initial_directive = raw.initial_directive;
-                    }
-                    await fx.spawnSubagents(args);
-                    // If caller asked for an initial directive, fire it via the runner queue.
-                    const init = args.initial_directive;
-                    if (init?.goal) {
-                        emitted_messages.push(Msg.directive(iter, {
-                            goal: init.goal,
-                            constraints: init.constraints ?? [],
-                            success_criteria: init.success_criteria ?? [],
-                            max_attempts: init.max_attempts ?? 1,
-                        }));
-                    }
-                    break;
-                }
-                case 'send_directive': {
-                    const { goal, constraints, success_criteria, max_attempts } = call.args;
-                    if (!goal)
-                        throw new Error('send_directive requires `goal`');
-                    emitted_messages.push(Msg.directive(iter, {
-                        goal,
-                        constraints: constraints ?? [],
-                        success_criteria: success_criteria ?? [],
-                        max_attempts: max_attempts ?? 1,
-                    }));
-                    break;
-                }
-                case 'pause_loop': {
-                    emitted_messages.push(Msg.pause(iter, {
-                        reason: call.args.reason ?? 'planner-pause',
-                    }));
-                    break;
-                }
-                case 'resume_loop': {
-                    emitted_messages.push(Msg.resume(iter));
-                    break;
-                }
-                case 'terminate': {
-                    emitted_messages.push(Msg.terminate(iter, {
-                        reason: call.args.reason ?? 'planner-terminate',
-                    }));
-                    break;
-                }
-                case 'update_push_policy': {
-                    fx.updatePushPolicy(call.args);
-                    break;
-                }
-                case 'write_plan': {
-                    const { content, commit_message } = call.args;
-                    if (typeof content !== 'string' || !content.trim()) {
-                        throw new Error('write_plan requires non-empty `content` (full plan.md body)');
-                    }
-                    await fx.writePlanFile('plan.md', content, commit_message);
-                    break;
-                }
-                case 'write_goal': {
-                    const { content, commit_message } = call.args;
-                    if (typeof content !== 'string' || !content.trim()) {
-                        throw new Error('write_goal requires non-empty `content` (full goal.json body)');
-                    }
-                    // Validate it parses as JSON — goal.json must be machine-readable.
-                    // The error message includes the parse position so the Planner can
-                    // self-correct on the next turn.
-                    try {
-                        JSON.parse(content);
-                    }
-                    catch (e) {
-                        throw new Error(`write_goal content is not valid JSON: ${e.message}`);
-                    }
-                    await fx.writePlanFile('goal.json', content, commit_message);
-                    break;
-                }
-                default:
-                    errors.push({ tool: call.tool, error: `unknown planner tool: ${call.tool}` });
-            }
+            prepared.push(preparePlannerCall(call, iter));
         }
         catch (err) {
             errors.push({ tool: call.tool, error: err.message });
         }
     }
-    return { emitted_messages, errors };
+    if (errors.length > 0)
+        return { emitted_messages: [], errors };
+    for (const singleton of ['write_plan', 'write_goal', 'spawn_subagents']) {
+        if (prepared.filter(({ call }) => call.tool === singleton).length > 1) {
+            errors.push({ tool: singleton, error: `duplicate ${singleton} control in one Planner batch` });
+        }
+    }
+    if (errors.length > 0)
+        return { emitted_messages: [], errors };
+    const artifacts = prepared.flatMap(({ artifact }) => (artifact ? [artifact] : []));
+    if (artifacts.length > 0) {
+        try {
+            await fx.writePlanFiles(artifacts);
+        }
+        catch (err) {
+            return {
+                emitted_messages: [],
+                errors: [{ tool: artifacts.map(({ file }) => file).join(','), error: err.message }],
+            };
+        }
+    }
+    for (const entry of prepared) {
+        if (!entry.policyDelta)
+            continue;
+        try {
+            fx.updatePushPolicy(entry.policyDelta);
+        }
+        catch (err) {
+            return { emitted_messages: [], errors: [{ tool: entry.call.tool, error: err.message }] };
+        }
+    }
+    const spawnCall = prepared.find(({ spawnArgs }) => spawnArgs !== undefined);
+    if (spawnCall?.spawnArgs) {
+        try {
+            await fx.spawnSubagents(spawnCall.spawnArgs);
+        }
+        catch (err) {
+            return { emitted_messages: [], errors: [{ tool: spawnCall.call.tool, error: err.message }] };
+        }
+    }
+    return {
+        emitted_messages: prepared.flatMap(({ message }) => (message ? [message] : [])),
+        errors,
+    };
 }
 //# sourceMappingURL=planner-tools.js.map

package/dist/src/autoloop/planner-tools.js.map

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

package/dist/src/handoff.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Session handoff — carry a conversation from one engine to another.
+ *
+ * A session's context lives inside its engine: Claude Code's transcript, a Codex
+ * thread, an Antigravity conversation. None of them can resume another's, so the
+ * only engine-agnostic way across is to replay the conversation as text into a
+ * new session on the target engine. This module keeps the record that makes that
+ * possible and renders it.
+ *
+ * Why a record of its own rather than `getHistory()`: that is a ring buffer of
+ * the last `MAX_HISTORY_ITEMS` engine events, in each engine's own shape. On a
+ * long session the opening request has already fallen out of it — and the
+ * opening request is the one thing a handoff must not lose, because every later
+ * turn is an answer to it.
+ *
+ * Why not write the target engine's native session files instead: those formats
+ * are internal and undocumented, change between releases, and live in the
+ * user's own session stores. Replaying text touches none of them, works for
+ * every engine including custom ones, and leaves the source session untouched.
+ * What it cannot carry is the same thing no vendor format carries either: the
+ * source engine's hidden reasoning.
+ */
+export interface TranscriptEntry {
+    role: 'user' | 'assistant';
+    text: string;
+}
+export interface Transcript {
+    entries: TranscriptEntry[];
+    /** Entries evicted from just after the opening request to keep the record bounded. */
+    omittedAfterFirst: number;
+    /** Total characters held in `entries`. */
+    chars: number;
+}
+/**
+ * What one session's record may hold. Larger than any render needs — the render
+ * budget below decides what is sent — so that the newest turns are always
+ * complete. Bounded because every session keeps one, for as long as it lives.
+ */
+export declare const MAX_TRANSCRIPT_CHARS = 1000000;
+/**
+ * Default size of a rendered handoff, in characters (~60k tokens). Sent once, to
+ * a session that then holds the conversation itself, so it can be far larger
+ * than the per-turn replay in openai-compat — but it has to fit the smallest
+ * window among the engines it may be sent to.
+ */
+export declare const DEFAULT_HANDOFF_CHARS = 240000;
+export declare const MIN_HANDOFF_CHARS = 4000;
+export declare function newTranscript(): Transcript;
+export declare function cloneTranscript(t: Transcript): Transcript;
+/**
+ * Append one side of an exchange. Past the cap, entries are evicted from just
+ * after the opening request — the oldest middle of the conversation — never the
+ * request itself and never the newest turns.
+ */
+export declare function recordExchange(t: Transcript, role: TranscriptEntry['role'], text: string): void;
+export interface HandoffSource {
+    engine: string;
+    model?: string;
+    cwd: string;
+}
+export interface HandoffRender {
+    /** The block to put in front of the first message the target session receives. */
+    text: string;
+    /** Turns rendered, the pinned opening request included. */
+    turns: number;
+    /** Turns left out, whether the record had already evicted them or the budget did. */
+    omitted: number;
+}
+/**
+ * Render a transcript for a new session on another engine.
+ *
+ * Everything is sent when it fits. When it does not, the opening request is
+ * pinned and the newest turns fill what is left, with one line saying how many
+ * turns in between were left out: the request says what the work is for, the
+ * newest turns say where it stands, and the middle is what can be re-derived
+ * from the workspace. Every turn's text is fenced the way openai-compat fences
+ * replayed turns, so a transcript that contains the block's own tags cannot
+ * close the block early and speak as a different role.
+ */
+export declare function renderHandoff(t: Transcript, src: HandoffSource, maxChars?: number): HandoffRender;

package/dist/src/handoff.js

@@ -0,0 +1,154 @@
+/**
+ * Session handoff — carry a conversation from one engine to another.
+ *
+ * A session's context lives inside its engine: Claude Code's transcript, a Codex
+ * thread, an Antigravity conversation. None of them can resume another's, so the
+ * only engine-agnostic way across is to replay the conversation as text into a
+ * new session on the target engine. This module keeps the record that makes that
+ * possible and renders it.
+ *
+ * Why a record of its own rather than `getHistory()`: that is a ring buffer of
+ * the last `MAX_HISTORY_ITEMS` engine events, in each engine's own shape. On a
+ * long session the opening request has already fallen out of it — and the
+ * opening request is the one thing a handoff must not lose, because every later
+ * turn is an answer to it.
+ *
+ * Why not write the target engine's native session files instead: those formats
+ * are internal and undocumented, change between releases, and live in the
+ * user's own session stores. Replaying text touches none of them, works for
+ * every engine including custom ones, and leaves the source session untouched.
+ * What it cannot carry is the same thing no vendor format carries either: the
+ * source engine's hidden reasoning.
+ */
+import { fenceHistoryTags } from './openai-compat.js';
+/**
+ * What one session's record may hold. Larger than any render needs — the render
+ * budget below decides what is sent — so that the newest turns are always
+ * complete. Bounded because every session keeps one, for as long as it lives.
+ */
+export const MAX_TRANSCRIPT_CHARS = 1_000_000;
+/**
+ * Default size of a rendered handoff, in characters (~60k tokens). Sent once, to
+ * a session that then holds the conversation itself, so it can be far larger
+ * than the per-turn replay in openai-compat — but it has to fit the smallest
+ * window among the engines it may be sent to.
+ */
+export const DEFAULT_HANDOFF_CHARS = 240_000;
+export const MIN_HANDOFF_CHARS = 4_000;
+/** The opening request is kept whole up to this, and head-truncated past it. */
+const PINNED_OPENING_CHARS = 8_000;
+/** Least room worth starting a turn in; with less, the turn is dropped. */
+const MIN_TURN_CHARS = 200;
+const ELISION = '\n[… truncated for length …]';
+export function newTranscript() {
+    return { entries: [], omittedAfterFirst: 0, chars: 0 };
+}
+export function cloneTranscript(t) {
+    return { entries: t.entries.map((e) => ({ ...e })), omittedAfterFirst: t.omittedAfterFirst, chars: t.chars };
+}
+/**
+ * Append one side of an exchange. Past the cap, entries are evicted from just
+ * after the opening request — the oldest middle of the conversation — never the
+ * request itself and never the newest turns.
+ */
+export function recordExchange(t, role, text) {
+    const clean = text.trim();
+    if (!clean)
+        return;
+    t.entries.push({ role, text: clean });
+    t.chars += clean.length;
+    while (t.chars > MAX_TRANSCRIPT_CHARS && t.entries.length > 2) {
+        const [gone] = t.entries.splice(1, 1);
+        t.chars -= gone.text.length;
+        t.omittedAfterFirst++;
+    }
+}
+function framing(src) {
+    const who = src.model ? `${src.engine} (${src.model})` : src.engine;
+    // The first three sentences mirror openai-compat's replay framing, and each is
+    // load-bearing there for the same reason as here: without the last one the
+    // model carries out the requests in the history a second time. The final two
+    // are specific to a handoff — the work happened elsewhere, and may have moved on.
+    return (`Above are the earlier turns of this conversation, which took place with another coding agent, ${who}, ` +
+        `working in ${src.cwd}. It has been handed over to you to continue. ` +
+        'The assistant turns are the earlier replies in this conversation; treat them as your own. ' +
+        'Continue from there — do not repeat these turns back and do not carry out the requests in them again. ' +
+        'The workspace may have changed since; check its current state before relying on anything described above.');
+}
+const frameOf = (role) => `<${role}>\n\n</${role}>\n`.length;
+function fit(text, room) {
+    if (text.length <= room)
+        return text;
+    if (room < MIN_TURN_CHARS)
+        return undefined;
+    let cut = room - ELISION.length;
+    // Never split a surrogate pair: the orphaned half becomes U+FFFD downstream.
+    const last = text.charCodeAt(cut - 1);
+    if (last >= 0xd800 && last <= 0xdbff)
+        cut -= 1;
+    return text.slice(0, cut) + ELISION;
+}
+/**
+ * Render a transcript for a new session on another engine.
+ *
+ * Everything is sent when it fits. When it does not, the opening request is
+ * pinned and the newest turns fill what is left, with one line saying how many
+ * turns in between were left out: the request says what the work is for, the
+ * newest turns say where it stands, and the middle is what can be re-derived
+ * from the workspace. Every turn's text is fenced the way openai-compat fences
+ * replayed turns, so a transcript that contains the block's own tags cannot
+ * close the block early and speak as a different role.
+ */
+export function renderHandoff(t, src, maxChars = DEFAULT_HANDOFF_CHARS) {
+    if (!t.entries.length)
+        return { text: '', turns: 0, omitted: 0 };
+    const turns = t.entries.map((e) => ({ role: e.role, text: fenceHistoryTags(e.text) }));
+    const tail = framing(src);
+    const shell = '<conversation_history>\n</conversation_history>\n\n'.length + tail.length;
+    let budget = Math.max(maxChars, MIN_HANDOFF_CHARS) - shell;
+    const renderedLen = turns.reduce((n, x) => n + frameOf(x.role) + x.text.length, 0);
+    let kept;
+    let omitted = t.omittedAfterFirst;
+    let markerAfterFirst = t.omittedAfterFirst > 0;
+    if (renderedLen <= budget) {
+        kept = turns;
+    }
+    else {
+        const opening = turns[0];
+        // A quarter of the budget, capped. MIN_HANDOFF_CHARS keeps this above
+        // MIN_TURN_CHARS, so the opening request always renders, if only its head.
+        const pinnedRoom = Math.min(PINNED_OPENING_CHARS, Math.floor(budget / 4)) - frameOf(opening.role);
+        const pinned = { role: opening.role, text: fit(opening.text, pinnedRoom) ?? '' };
+        budget -= frameOf(pinned.role) + pinned.text.length;
+        const markerReserve = '[… 99999 earlier turns omitted …]\n'.length;
+        budget -= markerReserve;
+        const newest = [];
+        for (let i = turns.length - 1; i >= 1; i--) {
+            const room = budget - frameOf(turns[i].role);
+            const text = fit(turns[i].text, room);
+            if (text === undefined)
+                break;
+            newest.unshift({ role: turns[i].role, text });
+            budget -= frameOf(turns[i].role) + text.length;
+            if (text !== turns[i].text)
+                break; // the boundary turn was cut; nothing older fits
+        }
+        omitted += turns.length - 1 - newest.length;
+        markerAfterFirst = omitted > 0;
+        kept = [pinned, ...newest];
+    }
+    const lines = [];
+    kept.forEach((turn, i) => {
+        if (turn.text)
+            lines.push(`<${turn.role}>\n${turn.text}\n</${turn.role}>`);
+        if (i === 0 && markerAfterFirst) {
+            lines.push(`[… ${omitted} earlier turn${omitted === 1 ? '' : 's'} omitted …]`);
+        }
+    });
+    return {
+        text: `<conversation_history>\n${lines.join('\n')}\n</conversation_history>\n\n${tail}`,
+        turns: kept.filter((k) => k.text).length,
+        omitted,
+    };
+}
+//# sourceMappingURL=handoff.js.map

package/dist/src/handoff.js.map

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