@lossless-claude/lcm 0.2.0

package/dist/src/expansion.js

@@ -0,0 +1,268 @@
+import { Type } from "@sinclair/typebox";
+// ── Helpers ──────────────────────────────────────────────────────────────────
+const SNIPPET_MAX_CHARS = 200;
+/** Truncate content to a short snippet for display. */
+function truncateSnippet(content, maxChars = SNIPPET_MAX_CHARS) {
+    if (content.length <= maxChars) {
+        return content;
+    }
+    return content.slice(0, maxChars) + "...";
+}
+/**
+ * Resolve the effective expansion token cap by applying a configured default
+ * and an explicit upper bound.
+ */
+export function resolveExpansionTokenCap(input) {
+    const maxExpandTokens = Math.max(1, Math.trunc(input.maxExpandTokens));
+    const requestedTokenCap = input.requestedTokenCap;
+    if (typeof requestedTokenCap !== "number" || !Number.isFinite(requestedTokenCap)) {
+        return maxExpandTokens;
+    }
+    return Math.min(Math.max(1, Math.trunc(requestedTokenCap)), maxExpandTokens);
+}
+/**
+ * Convert a single RetrievalEngine.expand() result into the ExpansionResult
+ * entry format, truncating content to short snippets.
+ */
+function toExpansionEntry(summaryId, raw) {
+    return {
+        summaryId,
+        children: raw.children.map((c) => ({
+            summaryId: c.summaryId,
+            kind: c.kind,
+            snippet: truncateSnippet(c.content),
+            tokenCount: c.tokenCount,
+        })),
+        messages: raw.messages.map((m) => ({
+            messageId: m.messageId,
+            role: m.role,
+            snippet: truncateSnippet(m.content),
+            tokenCount: m.tokenCount,
+        })),
+    };
+}
+/** Collect all referenced summary IDs from an expansion entry. */
+function collectCitedIds(entry) {
+    const ids = [entry.summaryId];
+    for (const child of entry.children) {
+        ids.push(child.summaryId);
+    }
+    return ids;
+}
+// ── ExpansionOrchestrator ────────────────────────────────────────────────────
+export class ExpansionOrchestrator {
+    retrieval;
+    constructor(retrieval) {
+        this.retrieval = retrieval;
+    }
+    /**
+     * Expand each summary ID using the RetrievalEngine, collecting results and
+     * enforcing a global token cap across all expansions.
+     */
+    async expand(request) {
+        const maxDepth = request.maxDepth ?? 3;
+        const tokenCap = request.tokenCap ?? Infinity;
+        const includeMessages = request.includeMessages ?? false;
+        const result = {
+            expansions: [],
+            citedIds: [],
+            totalTokens: 0,
+            truncated: false,
+        };
+        const citedSet = new Set();
+        for (const summaryId of request.summaryIds) {
+            if (result.truncated) {
+                break;
+            }
+            // Calculate remaining budget for this expansion
+            const remainingBudget = tokenCap - result.totalTokens;
+            if (remainingBudget <= 0) {
+                result.truncated = true;
+                break;
+            }
+            const raw = await this.retrieval.expand({
+                summaryId,
+                depth: maxDepth,
+                includeMessages,
+                tokenCap: remainingBudget,
+            });
+            const entry = toExpansionEntry(summaryId, raw);
+            result.expansions.push(entry);
+            result.totalTokens += raw.estimatedTokens;
+            // Track cited IDs
+            for (const id of collectCitedIds(entry)) {
+                citedSet.add(id);
+            }
+            if (raw.truncated) {
+                result.truncated = true;
+            }
+        }
+        result.citedIds = [...citedSet];
+        return result;
+    }
+    /**
+     * Convenience method: grep for matching summaries, then expand the top results.
+     * Combines the routing pass (grep) with the deep expansion pass.
+     */
+    async describeAndExpand(input) {
+        const grepResult = await this.retrieval.grep({
+            query: input.query,
+            mode: input.mode,
+            scope: "summaries",
+            conversationId: input.conversationId,
+        });
+        const summaryIds = [...grepResult.summaries]
+            .sort((a, b) => {
+            const recencyDelta = b.createdAt.getTime() - a.createdAt.getTime();
+            if (recencyDelta !== 0) {
+                return recencyDelta;
+            }
+            const aRank = a.rank ?? Number.POSITIVE_INFINITY;
+            const bRank = b.rank ?? Number.POSITIVE_INFINITY;
+            return aRank - bRank;
+        })
+            .map((s) => s.summaryId);
+        if (summaryIds.length === 0) {
+            return {
+                expansions: [],
+                citedIds: [],
+                totalTokens: 0,
+                truncated: false,
+            };
+        }
+        return this.expand({
+            summaryIds,
+            maxDepth: input.maxDepth,
+            tokenCap: input.tokenCap,
+            includeMessages: false,
+            conversationId: input.conversationId ?? 0,
+        });
+    }
+}
+// ── Distill for subagent ─────────────────────────────────────────────────────
+/**
+ * Format an ExpansionResult into a compact text payload suitable for passing
+ * to a subagent or returning to the main agent.
+ */
+export function distillForSubagent(result) {
+    const lines = [];
+    lines.push(`## Expansion Results (${result.expansions.length} summaries, ${result.totalTokens} total tokens)`);
+    lines.push("");
+    for (const entry of result.expansions) {
+        // Determine kind from children presence: if it has children it was a condensed node
+        const kind = entry.children.length > 0 ? "condensed" : "leaf";
+        const tokenSum = entry.children.reduce((sum, c) => sum + c.tokenCount, 0) +
+            entry.messages.reduce((sum, m) => sum + m.tokenCount, 0);
+        lines.push(`### ${entry.summaryId} (${kind}, ${tokenSum} tokens)`);
+        if (entry.children.length > 0) {
+            lines.push(`Children: ${entry.children.map((c) => c.summaryId).join(", ")}`);
+        }
+        if (entry.messages.length > 0) {
+            const msgParts = entry.messages.map((m) => `msg#${m.messageId} (${m.role}, ${m.tokenCount} tokens)`);
+            lines.push(`Messages: ${msgParts.join(", ")}`);
+        }
+        // Show a snippet for children that have content
+        for (const child of entry.children) {
+            if (child.snippet) {
+                lines.push(`[Snippet: ${truncateSnippet(child.snippet)}]`);
+                break; // Only show one snippet per entry to keep it compact
+            }
+        }
+        lines.push("");
+    }
+    if (result.citedIds.length > 0) {
+        lines.push(`Cited IDs for follow-up: ${result.citedIds.join(", ")}`);
+    }
+    lines.push(`[Truncated: ${result.truncated ? "yes" : "no"}]`);
+    return lines.join("\n");
+}
+// ── Tool definition ──────────────────────────────────────────────────────────
+const LcmExpansionSchema = Type.Object({
+    summaryIds: Type.Optional(Type.Array(Type.String(), {
+        description: "Summary IDs to expand (e.g. sum_abc123). Required if query is not provided.",
+    })),
+    query: Type.Optional(Type.String({
+        description: "Text query to grep for matching summaries before expanding. " +
+            "If provided, summaryIds is ignored and the top grep results are expanded instead.",
+    })),
+    maxDepth: Type.Optional(Type.Number({
+        description: "Max traversal depth per summary (default: 3).",
+        minimum: 1,
+        maximum: 10,
+    })),
+    tokenCap: Type.Optional(Type.Number({
+        description: "Max tokens across the entire expansion result.",
+        minimum: 1,
+    })),
+    includeMessages: Type.Optional(Type.Boolean({
+        description: "Whether to include raw source messages at leaf level (default: false).",
+    })),
+});
+/**
+ * Build a tool definition object for LCM expansion that can be registered as
+ * an agent tool. Follows the pattern used in `src/agents/tools/`.
+ *
+ * Requires an already-initialised ExpansionOrchestrator and an LcmConfig
+ * (for the default tokenCap).
+ */
+export function buildExpansionToolDefinition(options) {
+    const { orchestrator, config, conversationId } = options;
+    return {
+        name: "lcm_expand",
+        description: "Expand compacted conversation summaries from LCM (Lossless Context Management). " +
+            "Traverses the summary DAG to retrieve children and source messages. " +
+            "Use this to drill into previously-compacted context when you need detail " +
+            "that was summarised away. Returns a compact text payload with cited IDs for follow-up.",
+        parameters: LcmExpansionSchema,
+        execute: async (_toolCallId, params) => {
+            const summaryIds = params.summaryIds;
+            const query = typeof params.query === "string" ? params.query.trim() : undefined;
+            const maxDepth = typeof params.maxDepth === "number" ? Math.trunc(params.maxDepth) : undefined;
+            const requestedTokenCap = typeof params.tokenCap === "number" ? Math.trunc(params.tokenCap) : undefined;
+            const tokenCap = resolveExpansionTokenCap({
+                requestedTokenCap,
+                maxExpandTokens: config.maxExpandTokens,
+            });
+            const includeMessages = typeof params.includeMessages === "boolean" ? params.includeMessages : false;
+            let result;
+            if (query) {
+                // Grep-first path: find summaries matching the query, then expand
+                result = await orchestrator.describeAndExpand({
+                    query,
+                    mode: "full_text",
+                    conversationId,
+                    maxDepth,
+                    tokenCap,
+                });
+            }
+            else if (summaryIds && summaryIds.length > 0) {
+                // Direct expansion of specific summary IDs
+                result = await orchestrator.expand({
+                    summaryIds,
+                    maxDepth,
+                    tokenCap,
+                    includeMessages,
+                    conversationId,
+                });
+            }
+            else {
+                const text = "Error: either summaryIds or query must be provided.";
+                return {
+                    content: [{ type: "text", text }],
+                    details: { error: text },
+                };
+            }
+            const distilled = distillForSubagent(result);
+            return {
+                content: [{ type: "text", text: distilled }],
+                details: {
+                    expansionCount: result.expansions.length,
+                    citedIds: result.citedIds,
+                    totalTokens: result.totalTokens,
+                    truncated: result.truncated,
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=expansion.js.map

package/dist/src/expansion.js.map

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

package/dist/src/hooks/auto-heal.d.ts

@@ -0,0 +1,12 @@
+export interface AutoHealDeps {
+    readFileSync: (path: string, encoding: string) => string;
+    writeFileSync: (path: string, data: string) => void;
+    existsSync: (path: string) => boolean;
+    mkdirSync: (path: string, opts?: {
+        recursive: boolean;
+    }) => void;
+    appendFileSync: (path: string, data: string) => void;
+    settingsPath: string;
+    logPath: string;
+}
+export declare function validateAndFixHooks(deps?: AutoHealDeps): void;

package/dist/src/hooks/auto-heal.js

@@ -0,0 +1,49 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync, appendFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, dirname } from "node:path";
+import { REQUIRED_HOOKS, mergeClaudeSettings } from "../../installer/install.js";
+function defaultDeps() {
+    return {
+        readFileSync: (p, enc) => readFileSync(p, enc),
+        writeFileSync,
+        existsSync,
+        mkdirSync,
+        appendFileSync,
+        settingsPath: join(homedir(), ".claude", "settings.json"),
+        logPath: join(homedir(), ".lossless-claude", "auto-heal.log"),
+    };
+}
+function hasHookCommand(entries, command) {
+    return entries.some((entry) => Array.isArray(entry.hooks) && entry.hooks.some((h) => h.command === command));
+}
+export function validateAndFixHooks(deps = defaultDeps()) {
+    try {
+        if (!deps.existsSync(deps.settingsPath))
+            return;
+        const settings = JSON.parse(deps.readFileSync(deps.settingsPath, "utf-8"));
+        // Hooks are owned by plugin.json — if they leaked into settings.json
+        // (from old installer or manual edits), remove them to prevent double-firing.
+        const hooks = settings.hooks ?? {};
+        const hasDuplicates = REQUIRED_HOOKS.some(({ event, command }) => {
+            const entries = hooks[event];
+            return Array.isArray(entries) && hasHookCommand(entries, command);
+        });
+        if (!hasDuplicates)
+            return;
+        // Clean up: remove lcm hooks from settings.json (MCP config is preserved)
+        const merged = mergeClaudeSettings(settings);
+        deps.mkdirSync(dirname(deps.settingsPath), { recursive: true });
+        deps.writeFileSync(deps.settingsPath, JSON.stringify(merged, null, 2));
+    }
+    catch (err) {
+        try {
+            deps.mkdirSync(dirname(deps.logPath), { recursive: true });
+            const msg = `[${new Date().toISOString()}] auto-heal error: ${err instanceof Error ? err.message : String(err)}\n`;
+            deps.appendFileSync(deps.logPath, msg);
+        }
+        catch {
+            // Last resort: silently fail
+        }
+    }
+}
+//# sourceMappingURL=auto-heal.js.map

package/dist/src/hooks/auto-heal.js.map

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

package/dist/src/hooks/compact.d.ts

@@ -0,0 +1,5 @@
+import type { DaemonClient } from "../daemon/client.js";
+export declare function handlePreCompact(stdin: string, client: DaemonClient, port?: number): Promise<{
+    exitCode: number;
+    stdout: string;
+}>;

package/dist/src/hooks/compact.js

@@ -0,0 +1,22 @@
+import { ensureDaemon } from "../daemon/lifecycle.js";
+import { join } from "node:path";
+import { homedir } from "node:os";
+export async function handlePreCompact(stdin, client, port) {
+    const daemonPort = port ?? 3737;
+    const pidFilePath = join(homedir(), ".lossless-claude", "daemon.pid");
+    const { connected } = await ensureDaemon({ port: daemonPort, pidFilePath, spawnTimeoutMs: 5000 });
+    if (!connected)
+        return { exitCode: 0, stdout: "" };
+    try {
+        const input = JSON.parse(stdin || "{}");
+        const result = await client.post("/compact", {
+            ...input,
+            client: "claude",
+        });
+        return { exitCode: 2, stdout: result.summary || "" };
+    }
+    catch {
+        return { exitCode: 0, stdout: "" };
+    }
+}
+//# sourceMappingURL=compact.js.map

package/dist/src/hooks/compact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compact.js","sourceRoot":"","sources":["../../../src/hooks/compact.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAa,EAAE,MAAoB,EAAE,IAAa;IACvF,MAAM,UAAU,GAAG,IAAI,IAAI,IAAI,CAAC;IAChC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,kBAAkB,EAAE,YAAY,CAAC,CAAC;IACtE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,YAAY,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;IAClG,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAEnD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAsB,UAAU,EAAE;YAChE,GAAG,KAAK;YACR,MAAM,EAAE,QAAQ;SACjB,CAAC,CAAC;QACH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACrC,CAAC;AACH,CAAC"}

package/dist/src/hooks/dispatch.d.ts

@@ -0,0 +1,7 @@
+export declare const HOOK_COMMANDS: readonly ["compact", "restore", "session-end", "user-prompt"];
+export type HookCommand = typeof HOOK_COMMANDS[number];
+export declare function isHookCommand(cmd: string): cmd is HookCommand;
+export declare function dispatchHook(command: HookCommand, stdinText: string): Promise<{
+    exitCode: number;
+    stdout: string;
+}>;

package/dist/src/hooks/dispatch.js

@@ -0,0 +1,36 @@
+import { validateAndFixHooks } from "./auto-heal.js";
+export const HOOK_COMMANDS = ["compact", "restore", "session-end", "user-prompt"];
+export function isHookCommand(cmd) {
+    return HOOK_COMMANDS.includes(cmd);
+}
+export async function dispatchHook(command, stdinText) {
+    validateAndFixHooks();
+    const { DaemonClient } = await import("../daemon/client.js");
+    const { loadDaemonConfig } = await import("../daemon/config.js");
+    const { join } = await import("node:path");
+    const { homedir } = await import("node:os");
+    const config = loadDaemonConfig(join(homedir(), ".lossless-claude", "config.json"));
+    const port = config.daemon?.port ?? 3737;
+    const client = new DaemonClient(`http://127.0.0.1:${port}`);
+    switch (command) {
+        case "compact": {
+            const { handlePreCompact } = await import("./compact.js");
+            return handlePreCompact(stdinText, client, port);
+        }
+        case "restore": {
+            const { handleSessionStart } = await import("./restore.js");
+            return handleSessionStart(stdinText, client, port);
+        }
+        case "session-end": {
+            const { handleSessionEnd } = await import("./session-end.js");
+            return handleSessionEnd(stdinText, client, port);
+        }
+        case "user-prompt": {
+            const { handleUserPromptSubmit } = await import("./user-prompt.js");
+            return handleUserPromptSubmit(stdinText, client, port);
+        }
+        default:
+            throw new Error(`Unknown hook command: ${command}`);
+    }
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/src/hooks/dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../../../src/hooks/dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,CAAU,CAAC;AAG3F,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAQ,aAAmC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAoB,EACpB,SAAiB;IAEjB,mBAAmB,EAAE,CAAC;IAEtB,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAC7D,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;IACjE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;IAC3C,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,kBAAkB,EAAE,aAAa,CAAC,CAAC,CAAC;IACpF,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,IAAI,IAAI,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC;IAE5D,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;YAC1D,OAAO,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QACnD,CAAC;QACD,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;YAC5D,OAAO,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QACrD,CAAC;QACD,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;YAC9D,OAAO,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QACnD,CAAC;QACD,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,EAAE,sBAAsB,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;YACpE,OAAO,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QACzD,CAAC;QACD;YACE,MAAM,IAAI,KAAK,CAAC,yBAAyB,OAAO,EAAE,CAAC,CAAC;IACxD,CAAC;AACH,CAAC"}

package/dist/src/hooks/probe-precompact.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/src/hooks/probe-precompact.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+// src/hooks/probe-precompact.ts
+// Probe hook: dumps PreCompact stdin to ~/.lossless-claude/precompact-probe.json
+// Install temporarily in ~/.claude/settings.json to verify hook input schema
+import { writeFileSync, mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+const chunks = [];
+process.stdin.on("data", (c) => chunks.push(c));
+process.stdin.on("end", () => {
+    const raw = Buffer.concat(chunks).toString("utf-8");
+    const dir = join(homedir(), ".lossless-claude");
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(join(dir, "precompact-probe.json"), raw);
+    process.exit(0); // exit 0 = allow native compaction
+});
+//# sourceMappingURL=probe-precompact.js.map

package/dist/src/hooks/probe-precompact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe-precompact.js","sourceRoot":"","sources":["../../../src/hooks/probe-precompact.ts"],"names":[],"mappings":";AACA,gCAAgC;AAChC,iFAAiF;AACjF,6EAA6E;AAC7E,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,MAAM,GAAa,EAAE,CAAC;AAC5B,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACxD,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;IAC3B,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,kBAAkB,CAAC,CAAC;IAChD,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,uBAAuB,CAAC,EAAE,GAAG,CAAC,CAAC;IACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,mCAAmC;AACtD,CAAC,CAAC,CAAC"}

package/dist/src/hooks/probe-sessionstart.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/src/hooks/probe-sessionstart.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+// src/hooks/probe-sessionstart.ts
+// Probe hook: appends SessionStart stdin to ~/.lossless-claude/sessionstart-probe.jsonl
+// Install temporarily to verify source field values (especially "compact")
+import { appendFileSync, mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+const chunks = [];
+process.stdin.on("data", (c) => chunks.push(c));
+process.stdin.on("end", () => {
+    const raw = Buffer.concat(chunks).toString("utf-8");
+    const dir = join(homedir(), ".lossless-claude");
+    mkdirSync(dir, { recursive: true });
+    const entry = `${new Date().toISOString()} ${raw}\n`;
+    appendFileSync(join(dir, "sessionstart-probe.jsonl"), entry);
+    process.exit(0);
+});
+//# sourceMappingURL=probe-sessionstart.js.map

package/dist/src/hooks/probe-sessionstart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe-sessionstart.js","sourceRoot":"","sources":["../../../src/hooks/probe-sessionstart.ts"],"names":[],"mappings":";AACA,kCAAkC;AAClC,wFAAwF;AACxF,2EAA2E;AAC3E,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,MAAM,GAAa,EAAE,CAAC;AAC5B,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACxD,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;IAC3B,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,kBAAkB,CAAC,CAAC;IAChD,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACrD,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,0BAA0B,CAAC,EAAE,KAAK,CAAC,CAAC;IAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/src/hooks/restore.d.ts

@@ -0,0 +1,5 @@
+import type { DaemonClient } from "../daemon/client.js";
+export declare function handleSessionStart(stdin: string, client: DaemonClient, port?: number): Promise<{
+    exitCode: number;
+    stdout: string;
+}>;

package/dist/src/hooks/restore.js

@@ -0,0 +1,19 @@
+import { ensureDaemon } from "../daemon/lifecycle.js";
+import { join } from "node:path";
+import { homedir } from "node:os";
+export async function handleSessionStart(stdin, client, port) {
+    const daemonPort = port ?? 3737;
+    const pidFilePath = join(homedir(), ".lossless-claude", "daemon.pid");
+    const { connected } = await ensureDaemon({ port: daemonPort, pidFilePath, spawnTimeoutMs: 5000 });
+    if (!connected)
+        return { exitCode: 0, stdout: "" };
+    try {
+        const input = JSON.parse(stdin || "{}");
+        const result = await client.post("/restore", input);
+        return { exitCode: 0, stdout: result.context || "" };
+    }
+    catch {
+        return { exitCode: 0, stdout: "" };
+    }
+}
+//# sourceMappingURL=restore.js.map

package/dist/src/hooks/restore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore.js","sourceRoot":"","sources":["../../../src/hooks/restore.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,KAAa,EAAE,MAAoB,EAAE,IAAa;IACzF,MAAM,UAAU,GAAG,IAAI,IAAI,IAAI,CAAC;IAChC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,kBAAkB,EAAE,YAAY,CAAC,CAAC;IACtE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,YAAY,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;IAClG,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAEnD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAsB,UAAU,EAAE,KAAK,CAAC,CAAC;QACzE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACrC,CAAC;AACH,CAAC"}

package/dist/src/hooks/session-end.d.ts

@@ -0,0 +1,16 @@
+import type { DaemonClient } from "../daemon/client.js";
+/**
+ * Fire a compact request to the daemon without blocking the hook process.
+ *
+ * Uses a raw http.request with socket.unref() so the Node.js event loop
+ * does not wait for a response — the process exits as soon as the request
+ * is sent. The daemon receives and processes the request independently.
+ *
+ * This is intentionally separate from DaemonClient.post() (which uses fetch
+ * and keeps the event loop alive until a response is received).
+ */
+export declare function fireCompactRequest(port: number, body: Record<string, unknown>): void;
+export declare function handleSessionEnd(stdin: string, client: DaemonClient, port?: number): Promise<{
+    exitCode: number;
+    stdout: string;
+}>;

package/dist/src/hooks/session-end.js

@@ -0,0 +1,73 @@
+import { ensureDaemon } from "../daemon/lifecycle.js";
+import { loadDaemonConfig } from "../daemon/config.js";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { request } from "node:http";
+import { Buffer } from "node:buffer";
+/**
+ * Fire a compact request to the daemon without blocking the hook process.
+ *
+ * Uses a raw http.request with socket.unref() so the Node.js event loop
+ * does not wait for a response — the process exits as soon as the request
+ * is sent. The daemon receives and processes the request independently.
+ *
+ * This is intentionally separate from DaemonClient.post() (which uses fetch
+ * and keeps the event loop alive until a response is received).
+ */
+export function fireCompactRequest(port, body) {
+    const json = JSON.stringify(body);
+    const req = request({
+        hostname: "127.0.0.1",
+        port,
+        path: "/compact",
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "Content-Length": Buffer.byteLength(json),
+        },
+    });
+    req.on("socket", (socket) => {
+        // Defer unref until after the request body is flushed so the /compact
+        // request reliably reaches the daemon before the process is allowed to exit.
+        req.on("finish", () => socket.unref());
+    });
+    req.on("error", () => { }); // non-fatal
+    req.write(json);
+    req.end();
+}
+export async function handleSessionEnd(stdin, client, port) {
+    const daemonPort = port ?? 3737;
+    const pidFilePath = join(homedir(), ".lossless-claude", "daemon.pid");
+    const { connected } = await ensureDaemon({
+        port: daemonPort,
+        pidFilePath,
+        spawnTimeoutMs: 5000,
+    });
+    if (!connected)
+        return { exitCode: 0, stdout: "" };
+    try {
+        const input = JSON.parse(stdin || "{}");
+        const ingestResult = await client.post("/ingest", input);
+        // Auto-compact if conversation exceeds threshold
+        const configPath = join(homedir(), ".lossless-claude", "config.json");
+        const config = loadDaemonConfig(configPath);
+        const threshold = config.compaction.autoCompactMinTokens;
+        if (threshold > 0 &&
+            typeof ingestResult.totalTokens === "number" &&
+            ingestResult.totalTokens >= threshold) {
+            // Fire-and-forget via unreffed http.request — does not block the event loop.
+            // The daemon receives and compacts independently after the hook process exits.
+            fireCompactRequest(daemonPort, {
+                session_id: input.session_id,
+                cwd: input.cwd,
+                skip_ingest: true,
+                client: "claude",
+            });
+        }
+        return { exitCode: 0, stdout: "" };
+    }
+    catch {
+        return { exitCode: 0, stdout: "" };
+    }
+}
+//# sourceMappingURL=session-end.js.map

package/dist/src/hooks/session-end.js.map

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

package/dist/src/hooks/user-prompt.d.ts

@@ -0,0 +1,5 @@
+import type { DaemonClient } from "../daemon/client.js";
+export declare function handleUserPromptSubmit(stdin: string, client: DaemonClient, port?: number): Promise<{
+    exitCode: number;
+    stdout: string;
+}>;