@pugi/cli 0.1.0-beta.2 → 0.1.0-beta.20

package/dist/core/agent-progress/schema.js

@@ -0,0 +1,144 @@
+/**
+ * Agent progress JSON schema — α7 live-progress sprint (2026-05-27).
+ *
+ * Long-running agents (spawned externally OR via `pugi /agent`) emit a
+ * single JSON document per agent to `~/.pugi/agent-progress/<id>.json`.
+ * `pugi jobs --watch` tails the directory via chokidar and re-renders
+ * an Ink TUI that mirrors the Claude Code `/compact` visual pattern
+ * (header with elapsed + token counter, unicode progress bar, milestone
+ * list with done/active/pending status icons).
+ *
+ * Schema is intentionally optimistic — every numeric field is clamped
+ * by the writer/reader so a malformed document degrades to a partial
+ * card instead of crashing the watcher. The `pendingCount` /
+ * `completedCount` fields are pre-computed by the agent for the
+ * "… +N pending, M completed" footer; the renderer never re-counts
+ * (the agent may have collapsed milestone history to save bytes).
+ */
+/**
+ * Validate an unknown payload as an `AgentProgress` document. Returns
+ * the typed value on success and a string error otherwise. We deliberately
+ * keep this hand-rolled (no zod) — every field is checked exactly once,
+ * the error message is human-readable, and zero runtime deps.
+ */
+export function validateAgentProgress(value) {
+    if (typeof value !== 'object' || value === null) {
+        return { ok: false, error: 'progress payload must be a JSON object' };
+    }
+    const raw = value;
+    const requiredString = (field) => {
+        const v = raw[field];
+        return typeof v === 'string' && v.length > 0 ? v : null;
+    };
+    const agentId = requiredString('agentId');
+    if (!agentId)
+        return { ok: false, error: 'agentId required (non-empty string)' };
+    if (!/^[a-zA-Z0-9_-]+$/.test(agentId)) {
+        return { ok: false, error: 'agentId must match [a-zA-Z0-9_-]+ (filename-safe)' };
+    }
+    const agentType = requiredString('agentType');
+    if (!agentType)
+        return { ok: false, error: 'agentType required (non-empty string)' };
+    const task = requiredString('task');
+    if (!task)
+        return { ok: false, error: 'task required (non-empty string)' };
+    const startedAt = requiredString('startedAt');
+    if (!startedAt)
+        return { ok: false, error: 'startedAt required (ISO string)' };
+    if (Number.isNaN(Date.parse(startedAt))) {
+        return { ok: false, error: 'startedAt must be a parseable ISO timestamp' };
+    }
+    const lastUpdate = requiredString('lastUpdate');
+    if (!lastUpdate)
+        return { ok: false, error: 'lastUpdate required (ISO string)' };
+    if (Number.isNaN(Date.parse(lastUpdate))) {
+        return { ok: false, error: 'lastUpdate must be a parseable ISO timestamp' };
+    }
+    const elapsedMs = raw.elapsedMs;
+    if (typeof elapsedMs !== 'number' || !Number.isFinite(elapsedMs) || elapsedMs < 0) {
+        return { ok: false, error: 'elapsedMs required (non-negative number)' };
+    }
+    const percentComplete = raw.percentComplete;
+    if (typeof percentComplete !== 'number' ||
+        !Number.isFinite(percentComplete)) {
+        return { ok: false, error: 'percentComplete required (number 0..100)' };
+    }
+    const clampedPercent = Math.max(0, Math.min(100, percentComplete));
+    const status = raw.status;
+    if (status !== 'running' && status !== 'completed' && status !== 'failed') {
+        return { ok: false, error: 'status must be running | completed | failed' };
+    }
+    const currentStep = raw.currentStep;
+    if (typeof currentStep !== 'number' || currentStep < 0) {
+        return { ok: false, error: 'currentStep required (non-negative number)' };
+    }
+    const totalSteps = raw.totalSteps;
+    if (typeof totalSteps !== 'number' || totalSteps < 0) {
+        return { ok: false, error: 'totalSteps required (non-negative number)' };
+    }
+    const stepDescription = typeof raw.stepDescription === 'string'
+        ? raw.stepDescription
+        : '';
+    const milestonesRaw = raw.milestones;
+    if (!Array.isArray(milestonesRaw)) {
+        return { ok: false, error: 'milestones required (array, may be empty)' };
+    }
+    const milestones = [];
+    for (let i = 0; i < milestonesRaw.length; i += 1) {
+        const m = milestonesRaw[i];
+        if (typeof m !== 'object' || m === null) {
+            return { ok: false, error: `milestones[${i}] must be an object` };
+        }
+        const mr = m;
+        const label = typeof mr.label === 'string' ? mr.label : '';
+        if (!label) {
+            return { ok: false, error: `milestones[${i}].label required` };
+        }
+        const mStatus = mr.status;
+        if (mStatus !== 'done' && mStatus !== 'active' && mStatus !== 'pending') {
+            return {
+                ok: false,
+                error: `milestones[${i}].status must be done | active | pending`,
+            };
+        }
+        const ts = typeof mr.ts === 'string' ? mr.ts : undefined;
+        milestones.push({ label, status: mStatus, ts });
+    }
+    const tokensUsed = typeof raw.tokensUsed === 'number' && Number.isFinite(raw.tokensUsed)
+        ? Math.max(0, raw.tokensUsed)
+        : undefined;
+    const pendingCount = typeof raw.pendingCount === 'number' && Number.isFinite(raw.pendingCount)
+        ? Math.max(0, Math.floor(raw.pendingCount))
+        : undefined;
+    const completedCount = typeof raw.completedCount === 'number' && Number.isFinite(raw.completedCount)
+        ? Math.max(0, Math.floor(raw.completedCount))
+        : undefined;
+    return {
+        ok: true,
+        value: {
+            agentId,
+            agentType,
+            task,
+            startedAt,
+            lastUpdate,
+            elapsedMs,
+            tokensUsed,
+            percentComplete: clampedPercent,
+            status,
+            currentStep,
+            totalSteps,
+            stepDescription,
+            milestones,
+            pendingCount,
+            completedCount,
+        },
+    };
+}
+/**
+ * Default directory the writer and watcher share. Lives under the
+ * project workspace by convention so worktree-isolated agents can emit
+ * progress without crossing tenant boundaries. Operators can override
+ * via `PUGI_AGENT_PROGRESS_DIR` env var.
+ */
+export const DEFAULT_AGENT_PROGRESS_DIRNAME = '.pugi/agent-progress';
+//# sourceMappingURL=schema.js.map

package/dist/core/agent-progress/writer.js

@@ -0,0 +1,101 @@
+/**
+ * Agent progress writer — atomic file ops so the chokidar watcher
+ * never reads a half-written JSON document.
+ *
+ * Pattern (POSIX-portable):
+ *   1. Build the canonical JSON body.
+ *   2. Write to `<dir>/<agentId>.json.tmp-<pid>-<seq>`.
+ *   3. Rename (atomic on the same filesystem) to `<dir>/<agentId>.json`.
+ *   4. Cleanup is a no-op on success; on failure the caller bubbles the
+ *      error and the .tmp file is removed best-effort.
+ *
+ * The auto-cleanup of completed entries lives in `cleanup.ts` (commit 4);
+ * the writer here is the minimal surface the agent prompt boilerplate
+ * needs to copy + paste.
+ */
+import { existsSync, mkdirSync, renameSync, rmSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+import { DEFAULT_AGENT_PROGRESS_DIRNAME, validateAgentProgress, } from './schema.js';
+let writeSequence = 0;
+/**
+ * Resolve the effective progress directory. Public so the watcher can
+ * share the same resolution rules without duplicating env-var logic.
+ */
+export function resolveProgressDir(override) {
+    const candidate = override
+        ?? process.env.PUGI_AGENT_PROGRESS_DIR
+        ?? join(process.cwd(), DEFAULT_AGENT_PROGRESS_DIRNAME);
+    if (candidate.startsWith('~/')) {
+        return join(homedir(), candidate.slice(2));
+    }
+    return resolve(candidate);
+}
+/**
+ * Write a progress document atomically.
+ *
+ * Throws on validation failure so the caller is loud about a schema
+ * regression. File-system errors propagate untouched.
+ */
+export function writeProgress(progress, options = {}) {
+    const validation = validateAgentProgress(progress);
+    if (!validation.ok) {
+        throw new Error(`invalid agent-progress payload: ${validation.error}`);
+    }
+    const dir = resolveProgressDir(options.dir);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    const finalPath = join(dir, `${progress.agentId}.json`);
+    writeSequence += 1;
+    const tmpPath = `${finalPath}.tmp-${process.pid}-${writeSequence}`;
+    const body = `${JSON.stringify(progress, null, 2)}\n`;
+    try {
+        // mkdirSync above may have created `dir`, but a parallel agent could
+        // delete it between the existsSync and writeFile — ensure the parent
+        // of the tmp file exists right before the write.
+        const parent = dirname(tmpPath);
+        if (!existsSync(parent)) {
+            mkdirSync(parent, { recursive: true });
+        }
+        writeFileSync(tmpPath, body, 'utf8');
+        renameSync(tmpPath, finalPath);
+    }
+    catch (err) {
+        try {
+            rmSync(tmpPath, { force: true });
+        }
+        catch {
+            // best-effort cleanup; surface the original error
+        }
+        throw err;
+    }
+    return { path: finalPath };
+}
+/**
+ * Build a fresh progress document with sensible defaults. Mostly a
+ * convenience for tests + the agent prompt boilerplate — the writer
+ * does NOT call this implicitly because agents have richer context
+ * about their own milestone state.
+ */
+export function makeInitialProgress(input) {
+    const now = input.now ?? Date.now;
+    const iso = new Date(now()).toISOString();
+    return {
+        agentId: input.agentId,
+        agentType: input.agentType,
+        task: input.task,
+        startedAt: iso,
+        lastUpdate: iso,
+        elapsedMs: 0,
+        percentComplete: 0,
+        status: 'running',
+        currentStep: 0,
+        totalSteps: Math.max(0, Math.floor(input.totalSteps)),
+        stepDescription: '',
+        milestones: input.milestones ?? [],
+        pendingCount: input.milestones?.filter((m) => m.status === 'pending').length,
+        completedCount: input.milestones?.filter((m) => m.status === 'done').length,
+    };
+}
+//# sourceMappingURL=writer.js.map

package/dist/core/compact/auto-trigger.js

@@ -0,0 +1,96 @@
+/**
+ * Auto-compact threshold gate.
+ *
+ * Decides whether the conversation buffer has crossed the threshold
+ * percent of the active model's context window. The check runs after
+ * every operator/persona turn before the NEXT operator input lands so
+ * the compaction completes BEFORE the model would have rejected the
+ * request with a context-overflow error.
+ *
+ * Design choices:
+ *
+ *   - Pure function. The caller passes (tokenCount, windowSize, env).
+ *     The gate returns a verdict; the session module owns the side
+ *     effect of invoking the summariser. Pure-function shape keeps the
+ *     spec exhaustive and the call site readable.
+ *
+ *   - Hysteresis: once a compaction lands, the marker resets the
+ *     baseline token count to "summary + tail" — the gate looks at the
+ *     POST-marker tokens only. This is enforced upstream by the caller
+ *     passing the post-marker count; the gate itself has no memory.
+ *
+ *   - Two env knobs:
+ *       PUGI_AUTOCOMPACT_DISABLED=1  — kill switch
+ *       PUGI_AUTOCOMPACT_THRESHOLD=N — float in (0, 1] (default 0.75)
+ *     Anything outside (0, 1] is rejected and the gate falls back to
+ *     the default. Bad input never crashes the REPL.
+ */
+/** Default trip point as a fraction of the context window. */
+export const DEFAULT_THRESHOLD = 0.75;
+/**
+ * Decide whether to fire `/compact` automatically. Pure; safe to call
+ * after every turn.
+ */
+export function evaluateAutoCompact(input) {
+    const env = input.env ?? process.env;
+    const threshold = resolveThreshold(env);
+    if (input.windowSize <= 0 || !Number.isFinite(input.windowSize)) {
+        return {
+            kind: 'skip',
+            reason: 'invalid-window',
+            tokenCount: input.tokenCount,
+            windowSize: input.windowSize,
+            threshold,
+            pressure: 0,
+        };
+    }
+    if (env['PUGI_AUTOCOMPACT_DISABLED'] === '1') {
+        return {
+            kind: 'skip',
+            reason: 'disabled',
+            tokenCount: input.tokenCount,
+            windowSize: input.windowSize,
+            threshold,
+            pressure: roundPressure(input.tokenCount / input.windowSize),
+        };
+    }
+    const pressure = roundPressure(input.tokenCount / input.windowSize);
+    if (pressure >= threshold) {
+        return {
+            kind: 'fire',
+            tokenCount: input.tokenCount,
+            windowSize: input.windowSize,
+            threshold,
+            pressure,
+        };
+    }
+    return {
+        kind: 'skip',
+        reason: 'below-threshold',
+        tokenCount: input.tokenCount,
+        windowSize: input.windowSize,
+        threshold,
+        pressure,
+    };
+}
+/**
+ * Resolve the threshold from env, clamping to the (0, 1] open-closed
+ * interval. Bad input silently falls back to DEFAULT_THRESHOLD so the
+ * REPL never crashes on a malformed environment variable.
+ */
+function resolveThreshold(env) {
+    const raw = env['PUGI_AUTOCOMPACT_THRESHOLD'];
+    if (!raw)
+        return DEFAULT_THRESHOLD;
+    const parsed = Number.parseFloat(raw);
+    if (!Number.isFinite(parsed) || parsed <= 0 || parsed > 1) {
+        return DEFAULT_THRESHOLD;
+    }
+    return parsed;
+}
+function roundPressure(raw) {
+    if (!Number.isFinite(raw) || raw < 0)
+        return 0;
+    return Math.round(raw * 1000) / 1000;
+}
+//# sourceMappingURL=auto-trigger.js.map

package/dist/core/compact/buffer-rewriter.js

@@ -0,0 +1,115 @@
+/**
+ * Type guard: discriminate a SessionEvent against the `compaction`
+ * kind. Used by replay code so the boundary marker drives a different
+ * code path than `user`/`persona`/`system` transcript rows.
+ */
+export function isCompactBoundary(event) {
+    if (event.kind !== 'compaction')
+        return false;
+    const p = event.payload;
+    if (p === null || typeof p !== 'object')
+        return false;
+    if (p.version !== 1)
+        return false;
+    if (p.trigger !== 'manual' && p.trigger !== 'auto')
+        return false;
+    if (typeof p.summary !== 'string' || p.summary.length === 0)
+        return false;
+    if (typeof p.summaryTokenCount !== 'number')
+        return false;
+    if (typeof p.summaryTurnsBefore !== 'number')
+        return false;
+    if (typeof p.keptTailTurns !== 'number')
+        return false;
+    if (typeof p.coversUntilOffset !== 'number')
+        return false;
+    return true;
+}
+/**
+ * Append one `compaction` boundary marker to the SessionStore. Returns
+ * the SessionEvent we wrote so the caller can echo it into the in-
+ * memory transcript without a re-read. Throws on store error so the
+ * caller surfaces the failure inline.
+ */
+export async function appendCompactBoundary(input) {
+    const ts = (input.now ?? (() => Date.now()))();
+    const payload = {
+        version: 1,
+        trigger: input.trigger,
+        summary: input.summary,
+        summaryTokenCount: input.summaryTokenCount,
+        summaryTurnsBefore: input.summaryTurnsBefore,
+        keptTailTurns: input.keptTailTurns,
+        coversUntilOffset: input.coversUntilOffset,
+    };
+    const event = {
+        t: ts,
+        kind: 'compaction',
+        payload,
+    };
+    await input.store.appendEvent(event);
+    return event;
+}
+/**
+ * Apply replay masking to a chronological event list. Given the full
+ * ordered events.jsonl content, return only the events the caller
+ * should render: every event AFTER the latest `compaction` boundary,
+ * plus the boundary itself (so the renderer can show the banner +
+ * summary), and the K kept-tail events that landed BEFORE the boundary
+ * but were preserved per the marker's `keptTailTurns`.
+ *
+ * Mask logic:
+ *   1. Walk events. Find the LATEST boundary by offset.
+ *   2. Index 0 .. coversUntilOffset-1 are masked, EXCEPT the last
+ *      `keptTailTurns` of that range (which are the verbatim tail).
+ *   3. The boundary event itself + everything after it stays.
+ *
+ * Why we expose this here (and not in session.ts): keeping the mask
+ * logic next to the writer means the wire format is owned by one
+ * module. session.ts depends on this; this depends on nothing in
+ * session.ts. Unidirectional.
+ */
+export function applyCompactMask(events) {
+    // Find latest compaction event.
+    let latestIdx = -1;
+    let latestPayload = null;
+    for (let i = events.length - 1; i >= 0; i -= 1) {
+        const ev = events[i];
+        if (isCompactBoundary(ev)) {
+            latestIdx = i;
+            latestPayload = ev.payload;
+            break;
+        }
+    }
+    if (latestIdx === -1 || latestPayload === null) {
+        return events;
+    }
+    // `coversUntilOffset` is the count of events that existed in the
+    // store immediately before the marker append. Events 0 ..
+    // coversUntilOffset-1 are summarised; events keptTailTurns of them
+    // are surfaced anyway as the verbatim tail.
+    const cap = Math.max(0, Math.min(latestPayload.coversUntilOffset, latestIdx));
+    const tailKeepCount = Math.max(0, Math.min(latestPayload.keptTailTurns, cap));
+    // Take the LAST tailKeepCount events from the masked range, but only
+    // those that represent renderable turns (user/persona/system).
+    // Boundary markers and tool stream events are NOT counted as turns
+    // for the tail-keep window — using them would let the keptTailTurns
+    // budget be consumed by infra events and the operator would lose
+    // the last K real turns. The spec is about "last K human-visible
+    // turns", not "last K events".
+    const tailSlice = [];
+    for (let i = cap - 1; i >= 0 && tailSlice.length < tailKeepCount; i -= 1) {
+        const ev = events[i];
+        if (ev.kind === 'user' || ev.kind === 'persona' || ev.kind === 'system') {
+            tailSlice.push(ev);
+        }
+    }
+    tailSlice.reverse();
+    // After the marker: everything that landed AFTER the boundary
+    // append. These are post-compaction events the user has not yet
+    // seen folded into a summary; they pass through verbatim.
+    const afterMarker = events.slice(latestIdx + 1);
+    const markerEvent = events[latestIdx];
+    return [...tailSlice, markerEvent, ...afterMarker];
+}
+//# sourceMappingURL=buffer-rewriter.js.map

package/dist/core/compact/summarizer.js

@@ -0,0 +1,196 @@
+import { estimateTokens } from './token-counter.js';
+/**
+ * System prompt for the summarizer. Six closed sections + brand
+ * voice clamp + "no tool calls" sentinel. The headings are stable
+ * markdown so a downstream renderer can split + reformat without
+ * re-parsing the model output.
+ *
+ * Why the explicit `If a section has no content` rule: empty sections
+ * cost zero tokens but their absence is meaningful — the second model
+ * reading the memo learns "no decisions were made yet" from the empty
+ * `## Decisions` header. Without the rule we observed models silently
+ * dropping empty sections and the reader could not distinguish "no
+ * decisions" from "summarizer forgot the section".
+ */
+const SUMMARIZE_SYSTEM_PROMPT = [
+    'You are the Pugi conversation summarizer. Compress the supplied',
+    'transcript into a six-section memo. Operator picks the work back up',
+    'from this memo — accuracy and completeness matter more than brevity.',
+    '',
+    'OUTPUT FORMAT (verbatim section headings, in this order):',
+    '',
+    "## Intent",
+    '(What the operator is trying to accomplish, in one paragraph.)',
+    '',
+    "## Decisions",
+    '(Bullet list of decisions made + the reasoning. Empty section means',
+    'no decisions yet — render the heading anyway.)',
+    '',
+    "## Files",
+    '(Bullet list of file paths touched, with one-line "why".)',
+    '',
+    "## Errors",
+    '(Bullet list of errors encountered + how each was resolved. Empty',
+    'means no errors — still render the heading.)',
+    '',
+    "## Tools",
+    '(Bullet list of notable tool calls and their outcomes. Group similar',
+    'calls; the goal is to surface meaningful state changes, not log',
+    'every Read.)',
+    '',
+    "## Next",
+    '(One paragraph: the immediate next planned action.)',
+    '',
+    'RULES:',
+    '- Do not invent state. Only summarise what is in the transcript.',
+    '- Preserve file paths verbatim.',
+    '- Do not call any tools (you have none).',
+    '- Do not address the operator. Write in third person.',
+    '- No emoji. No em dashes.',
+].join('\n');
+/**
+ * Convert a slice of session events into the user message body the
+ * summarizer ingests. We keep the format simple: one event per line,
+ * prefixed with the kind, so the model can see role boundaries. Tool
+ * outputs are length-capped at 4 KB each so a single 200 KB grep result
+ * does not blow the summarizer's own context budget.
+ */
+const TOOL_PAYLOAD_CAP_BYTES = 4096;
+export function renderEventsForSummary(events) {
+    const lines = [];
+    for (const event of events) {
+        const rendered = renderOneEvent(event);
+        if (rendered !== null)
+            lines.push(rendered);
+    }
+    return lines.join('\n');
+}
+function renderOneEvent(event) {
+    const payload = (event.payload ?? null);
+    switch (event.kind) {
+        case 'user': {
+            const text = stringField(payload, 'brief') ?? stringField(payload, 'text') ?? '';
+            if (text.length === 0)
+                return null;
+            return `[operator] ${text}`;
+        }
+        case 'persona': {
+            const text = stringField(payload, 'text') ?? '';
+            if (text.length === 0)
+                return null;
+            const slug = stringField(payload, 'personaSlug') ?? 'persona';
+            return `[${slug}] ${text}`;
+        }
+        case 'system': {
+            const text = stringField(payload, 'text') ?? '';
+            if (text.length === 0)
+                return null;
+            return `[system] ${text}`;
+        }
+        case 'tool.start': {
+            const toolName = stringField(payload, 'toolName') ?? 'unknown';
+            const args = stringField(payload, 'args') ?? '';
+            return `[tool.start ${toolName}] ${truncate(args, TOOL_PAYLOAD_CAP_BYTES)}`;
+        }
+        case 'tool.result': {
+            const toolName = stringField(payload, 'toolName') ?? 'unknown';
+            const result = stringField(payload, 'result') ?? '';
+            return `[tool.result ${toolName}] ${truncate(result, TOOL_PAYLOAD_CAP_BYTES)}`;
+        }
+        case 'agent.spawned': {
+            const slug = stringField(payload, 'personaSlug') ?? 'unknown';
+            return `[agent.spawned ${slug}]`;
+        }
+        case 'agent.completed': {
+            const slug = stringField(payload, 'personaSlug') ?? 'unknown';
+            return `[agent.completed ${slug}]`;
+        }
+        case 'compaction': {
+            // Pre-existing compact marker — its `summary` payload IS the
+            // condensed form of older history. We pass it through verbatim so
+            // the summarizer treats it as already-summarised state and folds
+            // it into the new memo (rather than re-summarising garbage).
+            const summary = stringField(payload, 'summary') ?? '';
+            if (summary.length === 0)
+                return null;
+            return `[prior compaction]\n${summary}`;
+        }
+        default: {
+            // Forward-compat: unknown kinds get a structural fingerprint so
+            // the summarizer can still represent them.
+            const exhaustive = event.kind;
+            void exhaustive;
+            return null;
+        }
+    }
+}
+function stringField(payload, key) {
+    if (!payload)
+        return undefined;
+    const value = payload[key];
+    return typeof value === 'string' ? value : undefined;
+}
+function truncate(s, capBytes) {
+    if (Buffer.byteLength(s, 'utf8') <= capBytes)
+        return s;
+    // Naive cut on UTF-16 chars — good enough for the summarizer; we
+    // append a marker so the model knows content was elided.
+    return `${s.slice(0, Math.floor(capBytes / 2))}\n... [truncated]`;
+}
+/**
+ * Run one summarisation round. Throws on transport error (the caller
+ * surfaces a one-line message to the operator and aborts the compact).
+ * Returns the structured result on success.
+ */
+export async function summarizeEvents(input) {
+    if (input.events.length === 0) {
+        throw new SummarizerError('refusing-to-summarize-empty-slice', 'No events to summarize.');
+    }
+    const userBody = renderEventsForSummary(input.events);
+    if (userBody.length === 0) {
+        throw new SummarizerError('refusing-to-summarize-empty-slice', 'All events rendered as empty.');
+    }
+    const messages = [
+        { role: 'system', content: SUMMARIZE_SYSTEM_PROMPT },
+        { role: 'user', content: userBody },
+    ];
+    const response = await input.client.send(messages, [], {
+        personaSlug: input.personaSlug,
+        tag: { tag: 'summarize' },
+        maxTokens: 2048,
+        temperature: 0.1,
+        ...(input.model !== undefined ? { model: input.model } : {}),
+        ...(input.signal !== undefined ? { signal: input.signal } : {}),
+    });
+    if (response.stop === 'error') {
+        throw new SummarizerError(response.code, `Summarizer transport failed: ${response.message}`);
+    }
+    if (response.stop === 'tool_use') {
+        // Sanity guard. We pass tools: [] so the model should not be able
+        // to invoke any; if Anvil's prompt template ever leaks tool defs
+        // we want a hard failure rather than a silent dropped summary.
+        throw new SummarizerError('unexpected-tool-call', 'Summarizer returned tool_use despite tools: []. Treating as failure.');
+    }
+    const summary = response.content.trim();
+    if (summary.length === 0) {
+        throw new SummarizerError('empty-summary', 'Summarizer returned an empty body.');
+    }
+    return {
+        summary,
+        tokensSummarised: estimateTokens(userBody),
+        eventsSummarised: input.events.length,
+    };
+}
+/**
+ * Error class so the caller can branch on `error instanceof
+ * SummarizerError` and surface `error.code` to the operator.
+ */
+export class SummarizerError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'SummarizerError';
+        this.code = code;
+    }
+}
+//# sourceMappingURL=summarizer.js.map