@tianshu-ai/tianshu 0.3.0

package/packages/server/dist/chat/agent-tool-adapter.js

@@ -0,0 +1,260 @@
+// Adapter: tianshu plugin `AgentTool` (sdk shape) → pi-agent-core `AgentTool`.
+//
+// Why this exists:
+//   * Plugin authors keep using the simpler tianshu shape:
+//       execute(args, ctx) → { ok, text, ... }
+//     which we don't want to break or re-architect across every
+//     plugin in this repo (files, microsandbox, workboard).
+//   * The agent loop uses pi-agent-core, whose tool contract is
+//     richer:
+//       execute(toolCallId, params, signal, onUpdate) → AgentToolResult
+//   * The adapter wraps each plugin tool into the pi shape: it
+//     forwards args, normalises return shapes via the same
+//     `normaliseToolResult` the chat handler already uses, and
+//     translates `ok=false` returns into AgentToolResult `isError`.
+//
+// One subtlety worth flagging: pi's contract says `execute()` should
+// THROW on failure rather than encode errors in the content array.
+// Our plugin tools, by long-standing convention, return
+// `{ ok: false, text: "..." }` instead of throwing. The adapter
+// converts that pattern into an AgentToolResult with the same text
+// content but does NOT throw — pi's `runAgentLoop` already supports
+// "soft failures" via the ToolResultMessage's `isError` flag, but
+// tianshu plugins want them to be visible to the LLM verbatim.
+// Tracked in workers.md §7.2.
+/**
+ * Normalise an executor's structured return value to `{ ok, text }`.
+ * Two shapes are accepted:
+ *
+ *   1. Fs-style: `{ ok: boolean, text: string, ...extras }` — used
+ *      as-is.
+ *   2. Anything else: JSON-encoded into `text`. `ok` is derived
+ *      from common hints (`ok`, `exit_code`, `state`) and defaults
+ *      to true when there's no clear signal.
+ *
+ *  Lives in the adapter file because it's the only consumer now
+ *  that the host's chat handler runs through pi-agent-core.
+ */
+export function normaliseToolResult(out) {
+    if (out &&
+        typeof out === "object" &&
+        typeof out.text === "string" &&
+        typeof out.ok === "boolean") {
+        const r = out;
+        return { ok: r.ok, text: r.text };
+    }
+    if (out && typeof out === "object") {
+        const r = out;
+        let ok = true;
+        if (typeof r.ok === "boolean")
+            ok = r.ok;
+        else if (typeof r.exit_code === "number")
+            ok = r.exit_code === 0;
+        else if (typeof r.state === "string")
+            ok = r.state !== "error" && r.state !== "failed";
+        return { ok, text: JSON.stringify(out) };
+    }
+    return { ok: true, text: String(out ?? "") };
+}
+export function adaptToolset(toolset) {
+    // Per-toolset truncation counter. The toolset is freshly built
+    // per agent loop run (chat handler / worker pool), so this map
+    // covers "this agent's lifetime" — the natural granularity
+    // for an escalation rule. Resetting between turns would let a
+    // model thrash forever: hit truncation once per turn, get the
+    // permissive message, repeat. Persisting across turns lets us
+    // catch "second time the same tool ate truncation" reliably.
+    const truncationCount = new Map();
+    const tools = toolset.schemas.map((schema) => {
+        const exec = toolset.executors[schema.name];
+        const piTool = {
+            ...schema,
+            // pi-agent-core requires a `label` (UI display); fall back to
+            // the schema name. Plugin-side schema doesn't carry one yet.
+            label: schema.name,
+            // Default execution mode "sequential" matches the legacy
+            // tianshu chat handler behaviour (one tool at a time). We can
+            // flip individual plugin tools to "parallel" later when their
+            // contract documents thread-safety.
+            executionMode: "sequential",
+            // pi-agent-core calls `prepareArguments` BEFORE schema
+            // validation. We use it to detect Anthropic stream
+            // truncation — a frequent failure mode where the
+            // assistant emits a tool_use block whose input_json never
+            // finishes streaming, so the framework receives `{}` (or a
+            // partial dict missing required fields). The default error
+            // message ("must have required property X") looks like a
+            // model mistake, so the model dutifully retries the tool
+            // call AND HITS THE SAME TRUNCATION. By throwing a more
+            // diagnostic error here — in pi-agent-core's prepare phase,
+            // which still gets converted into an immediate error tool
+            // result — we tell the model what actually happened so it
+            // changes strategy on the retry (often: re-issue the call
+            // earlier in the turn before context bloats).
+            prepareArguments: (raw) => {
+                const truncated = detectStreamTruncation(schema, raw);
+                if (truncated) {
+                    // Escalate on repeat. After the first truncation the
+                    // model already saw the standard hint ("re-issue first,
+                    // keep fields concise, use skeleton-then-fill"). If it
+                    // hits truncation a second time on the same tool inside
+                    // the same agent run, hinting harder rarely helps — the
+                    // model is stuck. Switch to a fatal-flavored message
+                    // that explicitly forbids the bad pattern and tells it
+                    // exactly which alternative tools to call.
+                    const prior = truncationCount.get(schema.name) ?? 0;
+                    truncationCount.set(schema.name, prior + 1);
+                    if (prior >= 1) {
+                        throw new Error(formatRepeatTruncationError(schema.name, prior + 1));
+                    }
+                    throw new Error(truncated);
+                }
+                return raw;
+            },
+            execute: async (_toolCallId, params, _signal) => {
+                const args = params && typeof params === "object"
+                    ? params
+                    : {};
+                if (!exec) {
+                    // Should be unreachable — schema came from the same map.
+                    return {
+                        content: [
+                            { type: "text", text: `unknown tool: ${schema.name}` },
+                        ],
+                        details: undefined,
+                    };
+                }
+                // Plugin tools are sync OR async; both are fine.
+                const raw = await Promise.resolve(exec(args));
+                const norm = normaliseToolResult(raw);
+                const result = {
+                    content: [{ type: "text", text: norm.text }],
+                    // Stash the raw tool result on `details` so future UI
+                    // bits (chat panel rendering) can introspect it without
+                    // re-parsing the text.
+                    details: raw,
+                };
+                if (!norm.ok) {
+                    // pi-agent-core has no boolean on AgentToolResult itself
+                    // — it routes "isError" via the afterToolCall hook or
+                    // via promise rejection. We piggyback on the surrounding
+                    // run's afterToolCall to flip isError when this happens
+                    // (caller wires that up).
+                    result.__ok = false;
+                }
+                return result;
+            },
+        };
+        return piTool;
+    });
+    return { tools, executors: toolset.executors };
+}
+/** Helper for the surrounding agent run: detect whether a finished
+ *  AgentToolResult came from a `{ ok:false }` plugin return, so
+ *  pi-agent's `afterToolCall` can mark it as an error to the LLM. */
+export function isAdapterError(result) {
+    return Boolean(result?.__ok === false);
+}
+/**
+ * Heuristic: did Anthropic / Bedrock truncate the tool_use input
+ * stream before the assistant finished serialising arguments?
+ *
+ * Returns a diagnostic message when truncation is the most likely
+ * explanation; the caller (prepareArguments hook) throws it so
+ * the model sees a clear "stream cut, retry differently" prompt
+ * instead of pi-ai's default schema error.
+ *
+ * Two signal cases — both confined to "the framework received
+ * suspiciously little JSON, AND the schema clearly expected more":
+ *
+ *   1. params is null / not an object → received nothing at all.
+ *   2. params is an object missing one or more required fields.
+ *      We list the missing ones; the model can usually tell from
+ *      the names which call it tried to make.
+ *
+ * If the model legitimately omitted a required field on its own
+ * (rare but possible — bad system prompt, distracted run), the
+ * message still helps it: "you didn't pass X" is true either
+ * way, only the "stream may have been truncated" hint is
+ * speculative. We word it accordingly.
+ */
+function detectStreamTruncation(schema, rawArgs) {
+    const required = extractRequiredKeys(schema);
+    if (required.length === 0)
+        return null;
+    if (rawArgs == null || typeof rawArgs !== "object") {
+        return formatTruncationError(schema.name, required, required);
+    }
+    const args = rawArgs;
+    const missing = required.filter((k) => !(k in args));
+    if (missing.length === 0)
+        return null;
+    // If MOST of the required fields are missing AND args has zero
+    // present keys, treat it as full truncation (the most common
+    // shape we've actually observed). Otherwise it's just a
+    // partial — still worth flagging, but with a slightly softer
+    // hint.
+    return formatTruncationError(schema.name, required, missing);
+}
+function extractRequiredKeys(schema) {
+    // pi-ai uses TypeBox JSON-schema-ish objects. The `required`
+    // field is a top-level array of strings. Defensive: the schema
+    // may not carry it (Type.Object infers required from non-Optional
+    // members at compile time and stamps the array onto the JSON
+    // schema, but plugin authors could in principle hand-craft a
+    // schema without one).
+    const params = schema.parameters;
+    const req = params?.required;
+    if (!Array.isArray(req))
+        return [];
+    return req.filter((k) => typeof k === "string");
+}
+function formatTruncationError(toolName, required, missing) {
+    const reqList = required.map((k) => `\`${k}\``).join(", ");
+    const missList = missing.map((k) => `\`${k}\``).join(", ");
+    const suspectsTruncation = missing.length === required.length;
+    const head = suspectsTruncation
+        ? `Tool call to \`${toolName}\` arrived with empty arguments — the model's tool_use input stream may have been truncated by the provider before parameters finished serialising.`
+        : `Tool call to \`${toolName}\` is missing required field${missing.length === 1 ? "" : "s"} ${missList}. This often means the provider truncated the tool_use input stream mid-write.`;
+    const requiredHint = `Required: ${reqList}.`;
+    const retryAdvice = "To retry: re-issue the tool call as the FIRST action in your next assistant turn (no preamble text), and keep `description` / `content` / similar long fields concise. If you keep hitting the same truncation, switch tactics — use the skeleton-then-fill pattern (write a short scaffold first, then fill sections via batch `edit_file`) instead of one giant call.";
+    return `${head} ${requiredHint} ${retryAdvice}`;
+}
+/**
+ * Second-time truncation on the same tool in the same agent run.
+ * The model has already seen the permissive hint and ignored it,
+ * so we make the failure mode explicit and prescribe one specific
+ * alternative — "don't call this tool again, use these instead".
+ *
+ * Tool-specific advice covers the two we actually see thrash:
+ *   - write_file / tenant_config_write → skeleton + edit_file
+ *   - everything else → generic "split the call into smaller chunks"
+ *
+ * The wording is intentionally direct ("STOP calling") because the
+ * permissive version above already failed; subtle is for first-
+ * time messages, not for the loop-breaker.
+ */
+function formatRepeatTruncationError(toolName, attempts) {
+    const head = `Tool call to \`${toolName}\` truncated again (attempt ${attempts}). ` +
+        "The first hint did not change the outcome, so the call shape " +
+        "itself is the problem.";
+    const isWriter = toolName === "write_file" || toolName === "tenant_config_write";
+    const prescription = isWriter
+        ? `STOP calling \`${toolName}\` with a large \`content\` payload. Instead:\n` +
+            `  1. Call \`${toolName}\` ONCE with a small skeleton (title, ` +
+            `headings, and \`<!-- TODO: section X -->\` placeholders only).\n` +
+            "  2. Use `edit_file` (or `tenant_config_edit`) with `edits[]` to " +
+            "replace each placeholder with its real content. The batch form " +
+            "of edit_file accepts multiple disjoint replacements in one call " +
+            "— plan two or three sections per edit_file call rather than one " +
+            "giant write.\n\n" +
+            "Read the `large-input-large-output` skill for the worked example. " +
+            "Do not attempt another `write_file` with the same content shape; " +
+            "the next attempt will fail the same way."
+        : `STOP retrying \`${toolName}\` with the same shape. Split the request ` +
+            "into smaller calls (fewer items, shorter strings) before calling it " +
+            "again. The provider's tool-use input stream cannot accept the size " +
+            "of payload you keep submitting.";
+    return `${head}\n\n${prescription}`;
+}
+//# sourceMappingURL=agent-tool-adapter.js.map

package/packages/server/dist/chat/agent-tool-adapter.js.map

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

package/packages/server/dist/chat/compact.d.ts

@@ -0,0 +1,52 @@
+import type { Message } from "@earendil-works/pi-ai";
+import type { TenantContext } from "../core/index.js";
+import { type ResolvedModelInfo } from "../core/index.js";
+import type { ChatMessage, ChatSession } from "./messages.js";
+/** Trigger threshold: compact when estimated input ≥ this fraction
+ *  of the active model's context window. Per Yu's call (2026-06-05). */
+export declare const COMPACT_THRESHOLD = 0.5;
+export interface CompactPlan {
+    toSummarise: Message[];
+    keep: Message[];
+    /** Original ChatMessage rows for the kept tail (so we re-persist
+     *  the exact JSON when forking; round-tripping through pi-ai
+     *  shapes loses metadata like sibling `attachments`). */
+    keepRows: ChatMessage[];
+}
+/** Decide how many tail turns to keep verbatim and split the message
+ *  log accordingly. */
+export declare function planCompact(pi: Message[], rows: ChatMessage[]): CompactPlan;
+export interface CompactResult {
+    summary: string;
+    newSession: ChatSession;
+    oldSessionId: string;
+    summarisedCount: number;
+    keptCount: number;
+    durationMs: number;
+}
+export declare class CompactSkippedError extends Error {
+    readonly code: "COMPACT_SKIPPED";
+    constructor(reason: string);
+}
+/** Run a summarisation LLM call. Returns the plain text summary. */
+export declare function summarise(toSummarise: Message[], modelInfo: ResolvedModelInfo, signal?: AbortSignal): Promise<{
+    summary: string;
+    durationMs: number;
+}>;
+/**
+ * End-to-end compact: summarise → mark old → fork new → seed new.
+ */
+export declare function compactSession(args: {
+    ctx: TenantContext;
+    userId: string;
+    oldSession: ChatSession;
+    pi: Message[];
+    rows: ChatMessage[];
+    modelInfo: ResolvedModelInfo;
+    signal?: AbortSignal;
+}): Promise<CompactResult>;
+/** Build a plain-text transcript from pi-ai messages. Drops base64
+ *  image bytes (replaced with a marker) and clamps long tool-result
+ *  bodies so the summariser doesn't burn its own context on them. */
+export declare function buildTranscript(messages: Message[]): string;
+//# sourceMappingURL=compact.d.ts.map

package/packages/server/dist/chat/compact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compact.d.ts","sourceRoot":"","sources":["../../src/chat/compact.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAGV,OAAO,EAKR,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE9D;wEACwE;AACxE,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAuBrC,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,OAAO,EAAE,CAAC;IACvB,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB;;6DAEyD;IACzD,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED;uBACuB;AACvB,wBAAgB,WAAW,CACzB,EAAE,EAAE,OAAO,EAAE,EACb,IAAI,EAAE,WAAW,EAAE,GAClB,WAAW,CA2Bb;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,WAAW,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,EAAG,iBAAiB,CAAU;gBAC/B,MAAM,EAAE,MAAM;CAI3B;AAED,oEAAoE;AACpE,wBAAsB,SAAS,CAC7B,WAAW,EAAE,OAAO,EAAE,EACtB,SAAS,EAAE,iBAAiB,EAC5B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAmClD;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,GAAG,EAAE,aAAa,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,WAAW,CAAC;IACxB,EAAE,EAAE,OAAO,EAAE,CAAC;IACd,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,OAAO,CAAC,aAAa,CAAC,CA+DzB;AAiCD;;qEAEqE;AACrE,wBAAgB,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAkC3D"}

package/packages/server/dist/chat/compact.js

@@ -0,0 +1,248 @@
+// Conversation compaction.
+//
+// Two paths share the same LLM-summarisation core:
+//
+//   1. Auto-compact: kicked off before each turn when the projected
+//      input tokens exceed `contextWindow * COMPACT_THRESHOLD` of the
+//      active model.
+//   2. Manual `/compact` slash command from the user.
+//
+// In both cases we:
+//   1. Pick a tail of recent turns to keep verbatim.
+//   2. Hand everything older to the active LLM with the SUMMARY_PROMPT
+//      and let it produce one structured note.
+//   3. Mark the OLD session `status='compacted'`, stash the summary on
+//      `compacted_summary`.
+//   4. Fork a new session under the same user, `parent_id` pointing
+//      at the old one (per ADR-0001 §5: the chain is queryable, no
+//      messages get deleted).
+//   5. Seed the new session with a [history summary] user message and
+//      an "understood" assistant ack, then re-add the kept tail.
+//
+// The old session's messages stay on disk untouched. The chat hot
+// path uses `ensureActiveSession` which only returns the newly-forked
+// active session, so future LLM calls see only the shorter history.
+import { completeSimple } from "@earendil-works/pi-ai";
+import { randomUUID } from "node:crypto";
+import { buildModel, resolveApiKey, } from "../core/index.js";
+import { appendMessage } from "./messages.js";
+/** Trigger threshold: compact when estimated input ≥ this fraction
+ *  of the active model's context window. Per Yu's call (2026-06-05). */
+export const COMPACT_THRESHOLD = 0.5;
+/** Minimum number of messages to keep verbatim at the tail. */
+const KEEP_TAIL_MIN = 2;
+const SUMMARY_PROMPT = `You are a conversation-compaction assistant. Below is a chat history between a user and an AI agent (including tool calls). Produce a structured summary so a fresh agent can pick up seamlessly.
+
+Requirements:
+1. Address the next agent in the second person ("you previously …").
+2. **MUST preserve**:
+   - The user's core goals, constraints, preferences
+   - Decisions already made (technology choices, plans, parameters)
+   - Files and paths visited / created / modified (give exact paths)
+   - Key commands run and their salient results (do not paste full output)
+   - Open / in-progress tasks, todos
+   - Errors and pitfalls (so they aren't repeated)
+   - The most recent turn's specifics (what the user just said; what you were about to do)
+3. **You may drop**: greetings, repetition, verbose tool-mid-output, long file dumps, UI chrome
+4. Use Markdown headings, e.g. ## Goal / ## Decisions / ## Files / ## Progress / ## Caveats / ## Current State
+5. Output ONLY the summary itself (no preamble, no sign-off)
+6. Match the original conversation's language (Chinese conversation → Chinese summary, otherwise English)
+7. Aim for 600–1500 words. Shorter is better when the conversation is short.`;
+/** Decide how many tail turns to keep verbatim and split the message
+ *  log accordingly. */
+export function planCompact(pi, rows) {
+    if (pi.length !== rows.length) {
+        const n = Math.min(pi.length, rows.length);
+        pi = pi.slice(0, n);
+        rows = rows.slice(0, n);
+    }
+    if (pi.length <= KEEP_TAIL_MIN) {
+        return { toSummarise: [], keep: pi, keepRows: rows };
+    }
+    // Find the last user message; keep from there to the end. Falls
+    // back to KEEP_TAIL_MIN tail when no user message is in range.
+    let lastUser = -1;
+    for (let i = pi.length - 1; i >= 0; i--) {
+        if (pi[i].role === "user") {
+            lastUser = i;
+            break;
+        }
+    }
+    const fromIdx = lastUser >= 0
+        ? Math.min(lastUser, pi.length - KEEP_TAIL_MIN)
+        : pi.length - KEEP_TAIL_MIN;
+    return {
+        toSummarise: pi.slice(0, fromIdx),
+        keep: pi.slice(fromIdx),
+        keepRows: rows.slice(fromIdx),
+    };
+}
+export class CompactSkippedError extends Error {
+    code = "COMPACT_SKIPPED";
+    constructor(reason) {
+        super(reason);
+        this.name = "CompactSkippedError";
+    }
+}
+/** Run a summarisation LLM call. Returns the plain text summary. */
+export async function summarise(toSummarise, modelInfo, signal) {
+    const transcript = buildTranscript(toSummarise);
+    if (!transcript.trim()) {
+        return { summary: "(empty conversation)", durationMs: 0 };
+    }
+    const model = buildModel(modelInfo);
+    const apiKey = resolveApiKey(modelInfo);
+    const ctx = {
+        systemPrompt: SUMMARY_PROMPT,
+        messages: [
+            {
+                role: "user",
+                content: [
+                    {
+                        type: "text",
+                        text: `Please compact this conversation:\n\n${transcript}`,
+                    },
+                ],
+                timestamp: Date.now(),
+            },
+        ],
+    };
+    const t0 = Date.now();
+    const result = (await completeSimple(model, ctx, {
+        signal,
+        apiKey,
+    }));
+    const durationMs = Date.now() - t0;
+    const text = result.content
+        .filter((c) => c.type === "text")
+        .map((c) => c.text)
+        .join("\n")
+        .trim();
+    if (!text)
+        throw new Error("compaction summariser returned empty content");
+    return { summary: text, durationMs };
+}
+/**
+ * End-to-end compact: summarise → mark old → fork new → seed new.
+ */
+export async function compactSession(args) {
+    const { ctx, userId, oldSession, pi, rows, modelInfo, signal } = args;
+    const plan = planCompact(pi, rows);
+    if (plan.toSummarise.length === 0) {
+        throw new CompactSkippedError("nothing to summarise (≤ KEEP_TAIL_MIN messages)");
+    }
+    const { summary, durationMs } = await summarise(plan.toSummarise, modelInfo, signal);
+    // Mark the old session compacted + stash the summary for audit.
+    ctx.db
+        .prepare(`UPDATE sessions
+         SET status='compacted', compacted_summary=?, ended_at=?
+       WHERE id=?`)
+        .run(summary, Date.now(), oldSession.id);
+    // Fork a new active session under the same user, parent pointing
+    // at the old one.
+    const newSession = forkSession(ctx, userId, oldSession);
+    // Seed: history-summary user msg + ack assistant msg.
+    const seedTime = Date.now();
+    appendMessage(ctx, newSession, {
+        role: "user",
+        content: `[Conversation summary — generated at ${new Date(seedTime).toISOString()}]\n\n${summary}`,
+    });
+    appendMessage(ctx, newSession, {
+        role: "assistant",
+        content: "Understood — I have the prior context and will continue from where we left off.",
+    });
+    // Re-persist the kept tail rows. Copy the original `content` JSON
+    // verbatim so attachments / structured tool turns survive.
+    for (const r of plan.keepRows) {
+        const id = `msg_${randomUUID()}`;
+        ctx.db
+            .prepare(`INSERT INTO messages (id, session_id, role, content, created_at)
+         VALUES (?, ?, ?, ?, ?)`)
+            .run(id, newSession.id, r.role, r.content, Date.now());
+    }
+    return {
+        summary,
+        newSession,
+        oldSessionId: oldSession.id,
+        summarisedCount: plan.toSummarise.length,
+        keptCount: plan.keep.length,
+        durationMs,
+    };
+}
+function forkSession(ctx, userId, parent) {
+    const id = `session_${randomUUID()}`;
+    const now = Date.now();
+    ctx.db
+        .prepare(`INSERT INTO sessions (id, user_id, parent_id, status, kind, created_at)
+       VALUES (?, ?, ?, ?, ?, ?)`)
+        .run(id, userId, parent.id, "active", "user", now);
+    return {
+        id,
+        userId,
+        parentId: parent.id,
+        status: "active",
+        kind: "user",
+        title: null,
+        createdAt: now,
+    };
+}
+// ─── transcript helpers ───────────────────────────────────────────
+const MAX_TOOL_RESULT_CHARS = 600;
+/** Build a plain-text transcript from pi-ai messages. Drops base64
+ *  image bytes (replaced with a marker) and clamps long tool-result
+ *  bodies so the summariser doesn't burn its own context on them. */
+export function buildTranscript(messages) {
+    const lines = [];
+    for (const m of messages) {
+        if (m.role === "user") {
+            lines.push(`### USER\n${userMessageToText(m)}`);
+        }
+        else if (m.role === "assistant") {
+            const a = m;
+            const parts = [];
+            for (const c of a.content) {
+                if (c.type === "text" && c.text)
+                    parts.push(c.text);
+                else if (c.type === "toolCall") {
+                    const tc = c;
+                    const args = JSON.stringify(tc.arguments ?? {}).slice(0, 400);
+                    parts.push(`[tool:${tc.name} args=${args}]`);
+                }
+            }
+            if (parts.length > 0)
+                lines.push(`### ASSISTANT\n${parts.join("\n")}`);
+        }
+        else if (m.role === "toolResult") {
+            const tr = m;
+            const text = tr.content
+                .filter((c) => c.type === "text")
+                .map((c) => c.text)
+                .join("\n");
+            if (text) {
+                const trimmed = text.length > MAX_TOOL_RESULT_CHARS
+                    ? text.slice(0, MAX_TOOL_RESULT_CHARS) +
+                        `\n...(+${text.length - MAX_TOOL_RESULT_CHARS} chars)`
+                    : text;
+                lines.push(`### TOOL_RESULT (${tr.toolName})\n${trimmed}`);
+            }
+        }
+    }
+    return lines.join("\n\n");
+}
+function userMessageToText(u) {
+    if (typeof u.content === "string")
+        return u.content;
+    if (!Array.isArray(u.content))
+        return "";
+    const parts = [];
+    for (const c of u.content) {
+        const p = c;
+        if (p.type === "text" && p.text)
+            parts.push(p.text);
+        else if (p.type === "image") {
+            parts.push(`[image: ${p.name ?? p.path ?? "(no name)"}]`);
+        }
+    }
+    return parts.join("\n");
+}
+//# sourceMappingURL=compact.js.map

package/packages/server/dist/chat/compact.js.map

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

package/packages/server/dist/chat/dump-system-prompt.d.ts

@@ -0,0 +1,17 @@
+import type { TenantContext } from "../core/index.js";
+export interface DumpSystemPromptArgs {
+    ctx: TenantContext;
+    /** "main" for the chat handler, or "worker:<slug>" for a worker
+     *  agent. Used in the filename so concurrent agents don't
+     *  trample each other. */
+    role: string;
+    userId: string;
+    systemPrompt: string;
+}
+/** Returns true iff the dump is enabled in this tenant's resolved
+ *  config. Cheap to call per-turn. */
+export declare function dumpSystemPromptEnabled(ctx: TenantContext): boolean;
+/** Overwrite the dump file for this (tenant, role, user). Best
+ *  effort — never throws. */
+export declare function dumpSystemPrompt(args: DumpSystemPromptArgs): void;
+//# sourceMappingURL=dump-system-prompt.d.ts.map

package/packages/server/dist/chat/dump-system-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dump-system-prompt.d.ts","sourceRoot":"","sources":["../../src/chat/dump-system-prompt.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,aAAa,CAAC;IACnB;;8BAE0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;sCACsC;AACtC,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAEnE;AAED;6BAC6B;AAC7B,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI,CA6BjE"}