@nervekit/orchestrator 0.1.0

package/dist/domains/conversations/entry.repository.js

@@ -0,0 +1,81 @@
+import { join } from "node:path";
+import { conversationEntrySchema, } from "@nervekit/shared";
+import { appendJsonLine, readJsonLines, } from "../../infrastructure/storage/index.js";
+export class EntryRepository {
+    storage;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    entriesPath(conversationId) {
+        return join(this.storage.paths.home, "conversations", conversationId, "entries.jsonl");
+    }
+    async loadForConversation(conversationId) {
+        const rawEntries = await readJsonLines(this.entriesPath(conversationId)).catch(() => []);
+        return rawEntries
+            .map((entry) => conversationEntrySchema.safeParse(entry))
+            .filter((result) => result.success)
+            .map((result) => result.data);
+    }
+    async append(entry) {
+        await appendJsonLine(this.entriesPath(entry.conversationId), entry, 0o600);
+    }
+    displayLinkedEntries(entries) {
+        const allIds = new Set(entries.map((entry) => entry.id));
+        let previousVisibleEntryId;
+        return entries.map((entry) => {
+            const parentEntryId = entry.parentEntryId;
+            const normalized = parentEntryId && !allIds.has(parentEntryId)
+                ? { ...entry, parentEntryId: previousVisibleEntryId }
+                : entry;
+            previousVisibleEntryId = normalized.id;
+            return normalized;
+        });
+    }
+    activeBranchEntries(entriesByConversationId, conversation) {
+        const entries = this.displayLinkedEntries(entriesByConversationId.get(conversation.id) ?? []);
+        return activeBranchFromEntries(entries, conversation.activeEntryId);
+    }
+    activeBranchEntryIds(entriesByConversationId, conversation) {
+        return this.activeBranchEntries(entriesByConversationId, conversation).map((entry) => entry.id);
+    }
+    getConversationTree(entriesByConversationId, conversation) {
+        const entries = this.displayLinkedEntries(entriesByConversationId.get(conversation.id) ?? []);
+        const children = new Map();
+        const rootEntryIds = [];
+        for (const entry of entries) {
+            if (entry.parentEntryId) {
+                const childEntryIds = children.get(entry.parentEntryId) ?? [];
+                childEntryIds.push(entry.id);
+                children.set(entry.parentEntryId, childEntryIds);
+            }
+            else {
+                rootEntryIds.push(entry.id);
+            }
+        }
+        return {
+            conversationId: conversation.id,
+            activeEntryId: conversation.activeEntryId,
+            rootEntryIds,
+            nodes: entries.map((entry) => ({
+                entry,
+                childEntryIds: children.get(entry.id) ?? [],
+            })),
+        };
+    }
+}
+export function activeBranchFromEntries(entries, activeEntryId) {
+    if (!activeEntryId)
+        return [];
+    const byId = new Map(entries.map((entry) => [entry.id, entry]));
+    const branch = [];
+    let cursor = activeEntryId;
+    while (cursor) {
+        const entry = byId.get(cursor);
+        if (!entry)
+            break;
+        branch.push(entry);
+        cursor = entry.parentEntryId;
+    }
+    return branch.reverse();
+}
+//# sourceMappingURL=entry.repository.js.map

package/dist/domains/conversations/entry.repository.js.map

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

package/dist/domains/conversations/harness-manager.d.ts

@@ -0,0 +1,29 @@
+import { type AgentMessage, JsonlConversationStorage } from "@nervekit/agent";
+import type { AgentRecord, ConversationEntry, ConversationRecord, ProjectRecord } from "@nervekit/shared";
+import type { ConversationRepository } from "./index.js";
+export declare class HarnessManager {
+    private readonly conversationRepository;
+    private readonly getConversation;
+    private readonly getProject;
+    constructor(conversationRepository: ConversationRepository, getConversation: (conversationId: string) => ConversationRecord, getProject: (projectId: string) => ProjectRecord);
+    openStorage(conversation: ConversationRecord, cwd: string): Promise<JsonlConversationStorage>;
+    createConversation(conversation: ConversationRecord, cwd: string): Promise<void>;
+    appendAgentMessage(agent: AgentRecord, message: AgentMessage): Promise<{
+        id: string;
+        timestamp: string;
+    }>;
+    appendAgentMessageWithId(agent: AgentRecord, id: string, message: AgentMessage, timestamp?: string): Promise<{
+        id: string;
+        timestamp: string;
+    }>;
+    appendHarnessMessageWithId(agent: AgentRecord, id: string, message: AgentMessage, timestamp?: string): Promise<{
+        id: string;
+        timestamp: string;
+    }>;
+    appendEntry(entry: ConversationEntry): Promise<void>;
+    appendSummaryEntry(agent: AgentRecord, entry: ConversationEntry, fromId: string): Promise<void>;
+    setLeaf(conversation: ConversationRecord, entryId: string | undefined): Promise<void>;
+    warnMirror(error: unknown): void;
+    conversationPath(conversationId: string): string;
+}
+//# sourceMappingURL=harness-manager.d.ts.map

package/dist/domains/conversations/harness-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-manager.d.ts","sourceRoot":"","sources":["../../../src/domains/conversations/harness-manager.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,YAAY,EAEjB,wBAAwB,EAEzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACd,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,sBAAsB;IACvC,OAAO,CAAC,QAAQ,CAAC,eAAe;IAGhC,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAJV,sBAAsB,EAAE,sBAAsB,EAC9C,eAAe,EAAE,CAChC,cAAc,EAAE,MAAM,KACnB,kBAAkB,EACN,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,aAAa;IAG7D,WAAW,CACf,YAAY,EAAE,kBAAkB,EAChC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,wBAAwB,CAAC;IAQ9B,kBAAkB,CACtB,YAAY,EAAE,kBAAkB,EAChC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC;IAcV,kBAAkB,CACtB,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAavC,wBAAwB,CAC5B,KAAK,EAAE,WAAW,EAClB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,YAAY,EACrB,SAAS,SAA2B,GACnC,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAavC,0BAA0B,CAC9B,KAAK,EAAE,WAAW,EAClB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,YAAY,EACrB,SAAS,SAA2B,GACnC,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAiBvC,WAAW,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BpD,kBAAkB,CACtB,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IAoBV,OAAO,CACX,YAAY,EAAE,kBAAkB,EAChC,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,OAAO,CAAC,IAAI,CAAC;IAchB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAQhC,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM;CAGjD"}

package/dist/domains/conversations/harness-manager.js

@@ -0,0 +1,129 @@
+import { Conversation, JsonlConversationStorage, NodeExecutionEnv, } from "@nervekit/agent";
+import { pathExists } from "../../infrastructure/storage/index.js";
+export class HarnessManager {
+    conversationRepository;
+    getConversation;
+    getProject;
+    constructor(conversationRepository, getConversation, getProject) {
+        this.conversationRepository = conversationRepository;
+        this.getConversation = getConversation;
+        this.getProject = getProject;
+    }
+    async openStorage(conversation, cwd) {
+        await this.createConversation(conversation, cwd);
+        return JsonlConversationStorage.open(new NodeExecutionEnv({ cwd }), this.conversationPath(conversation.id));
+    }
+    async createConversation(conversation, cwd) {
+        try {
+            const path = this.conversationPath(conversation.id);
+            if (await pathExists(path))
+                return;
+            const env = new NodeExecutionEnv({ cwd });
+            await JsonlConversationStorage.create(env, path, {
+                cwd,
+                conversationId: conversation.id,
+            });
+        }
+        catch (error) {
+            this.warnMirror(error);
+        }
+    }
+    async appendAgentMessage(agent, message) {
+        const conversation = this.getConversation(agent.conversationId);
+        const project = this.getProject(conversation.projectId);
+        const storage = await this.openStorage(conversation, project.dir);
+        const harnessConversation = new Conversation(storage);
+        const id = await harnessConversation.appendMessage(message);
+        const entry = await storage.getEntry(id);
+        return {
+            id,
+            timestamp: entry?.timestamp ?? new Date().toISOString(),
+        };
+    }
+    async appendAgentMessageWithId(agent, id, message, timestamp = new Date().toISOString()) {
+        const conversation = this.getConversation(agent.conversationId);
+        const project = this.getProject(conversation.projectId);
+        const storage = await this.openStorage(conversation, project.dir);
+        const harnessConversation = new Conversation(storage);
+        await harnessConversation.appendMessageWithId(id, message, timestamp);
+        const entry = await storage.getEntry(id);
+        return {
+            id,
+            timestamp: entry?.timestamp ?? timestamp,
+        };
+    }
+    async appendHarnessMessageWithId(agent, id, message, timestamp = new Date().toISOString()) {
+        const conversation = this.getConversation(agent.conversationId);
+        const project = this.getProject(conversation.projectId);
+        const storage = await this.openStorage(conversation, project.dir);
+        const harnessConversation = new Conversation(storage);
+        await harnessConversation.appendHarnessMessageWithId(id, message, timestamp);
+        const entry = await storage.getEntry(id);
+        return {
+            id,
+            timestamp: entry?.timestamp ?? timestamp,
+        };
+    }
+    async appendEntry(entry) {
+        if (entry.role === "system")
+            return;
+        try {
+            const conversation = this.getConversation(entry.conversationId);
+            const project = this.getProject(conversation.projectId);
+            await this.createConversation(conversation, project.dir);
+            const storage = await JsonlConversationStorage.open(new NodeExecutionEnv({ cwd: project.dir }), this.conversationPath(conversation.id));
+            await storage.appendEntry({
+                type: "message",
+                id: entry.id,
+                parentId: entry.parentEntryId ?? null,
+                timestamp: entry.createdAt,
+                message: {
+                    role: entry.role,
+                    content: entry.text,
+                    timestamp: new Date(entry.createdAt).getTime(),
+                },
+            });
+        }
+        catch (error) {
+            this.warnMirror(error);
+        }
+    }
+    async appendSummaryEntry(agent, entry, fromId) {
+        try {
+            const conversation = this.getConversation(entry.conversationId);
+            const project = this.getProject(conversation.projectId);
+            const storage = await this.openStorage(conversation, project.dir);
+            await storage.appendEntry({
+                type: "branch_summary",
+                id: entry.id,
+                parentId: entry.parentEntryId ?? null,
+                timestamp: entry.createdAt,
+                fromId,
+                summary: entry.summary ?? entry.text,
+                details: { sourceDetails: entry.details, agentId: agent.id },
+                fromHook: true,
+            });
+        }
+        catch (error) {
+            this.warnMirror(error);
+        }
+    }
+    async setLeaf(conversation, entryId) {
+        try {
+            const project = this.getProject(conversation.projectId);
+            await this.createConversation(conversation, project.dir);
+            const storage = await JsonlConversationStorage.open(new NodeExecutionEnv({ cwd: project.dir }), this.conversationPath(conversation.id));
+            await storage.setLeafId(entryId ?? null);
+        }
+        catch (error) {
+            this.warnMirror(error);
+        }
+    }
+    warnMirror(error) {
+        process.emitWarning(`Failed to update harness JSONL conversation mirror: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    conversationPath(conversationId) {
+        return this.conversationRepository.harnessPath(conversationId);
+    }
+}
+//# sourceMappingURL=harness-manager.js.map

package/dist/domains/conversations/harness-manager.js.map

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

package/dist/domains/conversations/index.d.ts

@@ -0,0 +1,5 @@
+export { ConversationRepository } from "./conversation.repository.js";
+export { ConversationLifecycleService } from "./conversation-lifecycle.service.js";
+export { ConversationQueryService } from "./conversation-query.service.js";
+export { EntryRepository } from "./entry.repository.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/domains/conversations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/domains/conversations/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AACnF,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/domains/conversations/index.js

@@ -0,0 +1,5 @@
+export { ConversationRepository } from "./conversation.repository.js";
+export { ConversationLifecycleService } from "./conversation-lifecycle.service.js";
+export { ConversationQueryService } from "./conversation-query.service.js";
+export { EntryRepository } from "./entry.repository.js";
+//# sourceMappingURL=index.js.map

package/dist/domains/conversations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/domains/conversations/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AACnF,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/domains/conversations/operations/compaction-service.d.ts

@@ -0,0 +1,63 @@
+import { type AgentMessage } from "@nervekit/agent";
+import type { CompactConversationRequest, ConversationCompactionReason, ConversationEntry, ConversationRecord, ProjectRecord } from "@nervekit/shared";
+import type { EventBus } from "../../../infrastructure/events/index.js";
+import type { HarnessManager } from "../harness-manager.js";
+export interface AppendConversationEntryInput {
+    id?: string;
+    conversationId: string;
+    agentId?: string;
+    runId?: string;
+    parentEntryId?: string | null;
+    role: ConversationEntry["role"];
+    kind?: ConversationEntry["kind"];
+    text: string;
+    summary?: string;
+    tokensBefore?: number;
+    firstKeptEntryId?: string;
+    fromEntryId?: string;
+    details?: unknown;
+    createdAt?: string;
+}
+export type AppendConversationEntry = (input: AppendConversationEntryInput, options?: {
+    mirrorToHarness?: boolean;
+}) => Promise<ConversationEntry>;
+/**
+ * Optional LLM summarizer. Returns continuation-focused summary text, or
+ * `undefined` to fall back to the local extractive summary (e.g. when model or
+ * auth is unavailable).
+ */
+export type CompactionSummarizer = (input: {
+    conversationId: string;
+    agentId?: string;
+    messages: AgentMessage[];
+    previousSummary?: string;
+    instructions?: string;
+    signal?: AbortSignal;
+}) => Promise<string | undefined>;
+export interface CompactConversationOptions {
+    reason?: ConversationCompactionReason;
+    agentId?: string;
+    runId?: string;
+    contextWindow?: number;
+    contextTokens?: number;
+    thresholdTokens?: number;
+    triggerReserveTokens?: number;
+    keepRecentTokens?: number;
+    failedEntryId?: string;
+}
+export declare class CompactionService {
+    private readonly getConversation;
+    private readonly getProject;
+    private readonly appendEntry;
+    private readonly harnessManager;
+    private readonly rebuildConversations;
+    private readonly events;
+    private readonly summarize?;
+    constructor(getConversation: (conversationId: string) => ConversationRecord, getProject: (projectId: string) => ProjectRecord, appendEntry: AppendConversationEntry, harnessManager: HarnessManager, rebuildConversations: () => Promise<void>, events: EventBus, summarize?: CompactionSummarizer | undefined);
+    compactConversation(conversationId: string, request?: CompactConversationRequest, options?: CompactConversationOptions): Promise<{
+        conversation: ConversationRecord;
+        entry: ConversationEntry;
+    }>;
+    private summarizeWithFallback;
+}
+//# sourceMappingURL=compaction-service.d.ts.map

package/dist/domains/conversations/operations/compaction-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction-service.d.ts","sourceRoot":"","sources":["../../../../src/domains/conversations/operations/compaction-service.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EAOlB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EACV,0BAA0B,EAC1B,4BAA4B,EAC5B,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACd,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,MAAM,WAAW,4BAA4B;IAC3C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,uBAAuB,GAAG,CACpC,KAAK,EAAE,4BAA4B,EACnC,OAAO,CAAC,EAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE,KACpC,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAEhC;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE;IACzC,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;AAElC,MAAM,WAAW,0BAA0B;IACzC,MAAM,CAAC,EAAE,4BAA4B,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAMD,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAGhC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;gBARV,eAAe,EAAE,CAChC,cAAc,EAAE,MAAM,KACnB,kBAAkB,EACN,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,aAAa,EAChD,WAAW,EAAE,uBAAuB,EACpC,cAAc,EAAE,cAAc,EAC9B,oBAAoB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EACzC,MAAM,EAAE,QAAQ,EAChB,SAAS,CAAC,EAAE,oBAAoB,YAAA;IAG7C,mBAAmB,CACvB,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE,0BAA+B,EACxC,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC;QAAE,YAAY,EAAE,kBAAkB,CAAC;QAAC,KAAK,EAAE,iBAAiB,CAAA;KAAE,CAAC;YAsL5D,qBAAqB;CAqBpC"}

package/dist/domains/conversations/operations/compaction-service.js

@@ -0,0 +1,200 @@
+import { buildConversationContext, createCompactionSummaryMessage, DEFAULT_COMPACTION_SETTINGS, estimateTokens, prepareCompaction, } from "@nervekit/agent";
+import { HttpError } from "../../../http/errors.js";
+import { buildExtractiveSummary } from "./summary.js";
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+export class CompactionService {
+    getConversation;
+    getProject;
+    appendEntry;
+    harnessManager;
+    rebuildConversations;
+    events;
+    summarize;
+    constructor(getConversation, getProject, appendEntry, harnessManager, rebuildConversations, events, summarize) {
+        this.getConversation = getConversation;
+        this.getProject = getProject;
+        this.appendEntry = appendEntry;
+        this.harnessManager = harnessManager;
+        this.rebuildConversations = rebuildConversations;
+        this.events = events;
+        this.summarize = summarize;
+    }
+    async compactConversation(conversationId, request = {}, options = {}) {
+        const reason = options.reason ?? "manual";
+        const conversation = this.getConversation(conversationId);
+        const project = this.getProject(conversation.projectId);
+        const storage = await this.harnessManager.openStorage(conversation, project.dir);
+        const branch = await storage.getPathToRoot(await storage.getLeafId());
+        const branchLeafId = branch.at(-1)?.id ?? null;
+        const settings = {
+            ...DEFAULT_COMPACTION_SETTINGS,
+            reserveTokens: DEFAULT_COMPACTION_SETTINGS.reserveTokens,
+            keepRecentTokens: request.keepRecentTokens ??
+                (options.keepRecentTokens && options.keepRecentTokens > 0
+                    ? options.keepRecentTokens
+                    : DEFAULT_COMPACTION_SETTINGS.keepRecentTokens),
+        };
+        const prepared = prepareCompaction(branch, settings);
+        if (!prepared.ok) {
+            throw new HttpError(400, "COMPACTION_FAILED", prepared.error.message);
+        }
+        if (!prepared.value) {
+            throw new HttpError(409, "NOTHING_TO_COMPACT", "Nothing to compact.");
+        }
+        const preparation = prepared.value;
+        let firstKeptEntryId = preparation.firstKeptEntryId;
+        let messagesToSummarize = [
+            ...preparation.messagesToSummarize,
+            ...preparation.turnPrefixMessages,
+        ];
+        if (messagesToSummarize.length === 0) {
+            const messageEntries = branch.filter((entry) => entry.type === "message");
+            const fallbackKept = messageEntries.at(-1);
+            messagesToSummarize = messageEntries
+                .slice(0, -1)
+                .map((entry) => entry.message);
+            if (fallbackKept)
+                firstKeptEntryId = fallbackKept.id;
+        }
+        if (messagesToSummarize.length === 0) {
+            throw new HttpError(409, "NOTHING_TO_COMPACT", "No prior messages to compact.");
+        }
+        const startedAt = new Date().toISOString();
+        let started = false;
+        try {
+            await this.events.publish("conversation.compaction.started", {
+                conversationId,
+                agentId: options.agentId,
+                runId: options.runId,
+                reason,
+                startedAt,
+                contextWindow: options.contextWindow,
+                contextTokens: options.contextTokens ?? preparation.tokensBefore,
+                thresholdTokens: options.thresholdTokens,
+                triggerReserveTokens: options.triggerReserveTokens,
+                keepRecentTokens: settings.keepRecentTokens,
+                failedEntryId: options.failedEntryId,
+            }, { durability: "transient" });
+            started = true;
+            const summary = (await this.summarizeWithFallback(conversationId, options.agentId, messagesToSummarize, preparation.previousSummary, request.instructions)) ||
+                buildExtractiveSummary({
+                    title: "Context checkpoint",
+                    messages: messagesToSummarize,
+                    previousSummary: preparation.previousSummary,
+                    instructions: request.instructions,
+                });
+            const tokensAfter = estimatePostCompactionTokens(branch, firstKeptEntryId, summary, preparation.tokensBefore);
+            const freedTokens = Math.max(0, preparation.tokensBefore - tokensAfter);
+            const fileOps = {
+                read: [...preparation.fileOps.read].sort(),
+                written: [...preparation.fileOps.written].sort(),
+                edited: [...preparation.fileOps.edited].sort(),
+            };
+            const details = {
+                generatedBy: "orchestrator-extractive",
+                compactedMessages: messagesToSummarize.length,
+                splitTurn: preparation.isSplitTurn,
+                tokensAfter,
+                freedTokens,
+                reason,
+                policy: {
+                    contextWindow: options.contextWindow,
+                    thresholdTokens: options.thresholdTokens,
+                    triggerReserveTokens: options.triggerReserveTokens,
+                    keepRecentTokens: settings.keepRecentTokens,
+                },
+                fileOps,
+                readFiles: fileOps.read,
+                modifiedFiles: Array.from(new Set([...fileOps.written, ...fileOps.edited])).sort(),
+            };
+            const entry = await this.appendEntry({
+                conversationId,
+                agentId: options.agentId,
+                runId: options.runId,
+                parentEntryId: branchLeafId,
+                role: "system",
+                kind: "compaction",
+                text: summary,
+                summary,
+                tokensBefore: preparation.tokensBefore,
+                firstKeptEntryId,
+                details,
+            }, { mirrorToHarness: false });
+            await storage.appendEntry({
+                type: "compaction",
+                id: entry.id,
+                parentId: entry.parentEntryId ?? null,
+                timestamp: entry.createdAt,
+                summary,
+                firstKeptEntryId,
+                tokensBefore: preparation.tokensBefore,
+                details,
+            });
+            await this.rebuildConversations();
+            await this.events.publish("conversation.compacted", {
+                conversationId,
+                entry,
+                tokensBefore: preparation.tokensBefore,
+                firstKeptEntryId,
+                reason,
+                agentId: options.agentId,
+                runId: options.runId,
+                contextWindow: options.contextWindow,
+                thresholdTokens: options.thresholdTokens,
+                keepRecentTokens: settings.keepRecentTokens,
+                tokensAfter,
+                freedTokens,
+            });
+            return { conversation: this.getConversation(conversationId), entry };
+        }
+        catch (error) {
+            if (started) {
+                await this.events
+                    .publish("conversation.compaction.failed", {
+                    conversationId,
+                    agentId: options.agentId,
+                    runId: options.runId,
+                    reason,
+                    failedAt: new Date().toISOString(),
+                    message: errorMessage(error),
+                    failedEntryId: options.failedEntryId,
+                }, { durability: "transient" })
+                    .catch(() => undefined);
+            }
+            throw error;
+        }
+    }
+    async summarizeWithFallback(conversationId, agentId, messages, previousSummary, instructions) {
+        if (!this.summarize)
+            return undefined;
+        try {
+            const summary = await this.summarize({
+                conversationId,
+                agentId,
+                messages,
+                previousSummary,
+                instructions,
+            });
+            return summary?.trim() ? summary : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+}
+/**
+ * Estimate the context-token size of the conversation after compaction: the
+ * generated summary plus the retained recent messages. Uses a character-based
+ * estimate (not provider usage) because retained assistant usage still reflects
+ * the pre-compaction context size.
+ */
+function estimatePostCompactionTokens(branch, firstKeptEntryId, summary, tokensBefore) {
+    const keptIndex = branch.findIndex((entry) => entry.id === firstKeptEntryId);
+    const keptEntries = keptIndex >= 0 ? branch.slice(keptIndex) : [];
+    const keptMessages = buildConversationContext(keptEntries).messages;
+    const summaryMessage = createCompactionSummaryMessage(summary, tokensBefore, new Date().toISOString());
+    return [summaryMessage, ...keptMessages].reduce((sum, message) => sum + estimateTokens(message), 0);
+}
+//# sourceMappingURL=compaction-service.js.map

package/dist/domains/conversations/operations/compaction-service.js.map

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

package/dist/domains/conversations/operations/export-service.d.ts

@@ -0,0 +1,22 @@
+import { type AgentRecord, type ConversationEntry, type ConversationRecord, type ProjectRecord } from "@nervekit/shared";
+export interface ExportedConversationBundle {
+    format: "nerve.conversation.v1";
+    exportedAt: string;
+    project: ProjectRecord;
+    conversation: ConversationRecord;
+    agents: AgentRecord[];
+    entries: ConversationEntry[];
+}
+export declare class ExportService {
+    private readonly getConversation;
+    private readonly getProject;
+    private readonly listAgents;
+    private readonly entriesByConversationId;
+    constructor(getConversation: (conversationId: string) => ConversationRecord, getProject: (projectId: string) => ProjectRecord, listAgents: () => AgentRecord[], entriesByConversationId: Map<string, ConversationEntry[]>);
+    exportConversation(conversationId: string): ExportedConversationBundle;
+    exportConversationMarkdown(conversationId: string): string;
+    exportConversationHtml(conversationId: string): string;
+}
+export declare function conversationExportMarkdown(conversation: ConversationRecord, entries: ConversationEntry[]): string;
+export declare function conversationExportHtml(conversation: ConversationRecord, entries: ConversationEntry[]): string;
+//# sourceMappingURL=export-service.d.ts.map

package/dist/domains/conversations/operations/export-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-service.d.ts","sourceRoot":"","sources":["../../../../src/domains/conversations/operations/export-service.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EAEvB,KAAK,aAAa,EACnB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,uBAAuB,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,aAAa,CAAC;IACvB,YAAY,EAAE,kBAAkB,CAAC;IACjC,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED,qBAAa,aAAa;IAEtB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAGhC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,uBAAuB;gBALvB,eAAe,EAAE,CAChC,cAAc,EAAE,MAAM,KACnB,kBAAkB,EACN,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,aAAa,EAChD,UAAU,EAAE,MAAM,WAAW,EAAE,EAC/B,uBAAuB,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAG5E,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,0BAA0B;IAgBtE,0BAA0B,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM;IAK1D,sBAAsB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM;CAIvD;AAED,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,kBAAkB,EAChC,OAAO,EAAE,iBAAiB,EAAE,GAC3B,MAAM,CAkBR;AAED,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,kBAAkB,EAChC,OAAO,EAAE,iBAAiB,EAAE,GAC3B,MAAM,CA0BR"}