@greppleai/grip 0.0.0-stage → 0.1.3

package/dist/core/compaction/compression-economics.js

@@ -0,0 +1,151 @@
+import { sessionEntryToContextMessages } from "../session/context.js";
+import { estimateTokens } from "./compaction.js";
+export const COMPRESSION_ECONOMICS_ENTRY_TYPE = "compression_economics";
+export const COMPRESSION_SAVINGS_SNAPSHOT_TYPE = "compression_savings_snapshot";
+function estimateRangeTokenCounts(entries, start, end) {
+    let source = 0;
+    let suffix = 0;
+    for (const [index, entry] of entries.entries()) {
+        for (const message of sessionEntryToContextMessages(entry)) {
+            const tokens = estimateTokens(message);
+            if (index >= start && index <= end)
+                source += tokens;
+            else if (index > end)
+                suffix += tokens;
+        }
+    }
+    return { source, suffix };
+}
+export function estimateCompressionEconomics(entries, startEntryId, endEntryId, model, summary, usingSubscription = false) {
+    const start = entries.findIndex((entry) => entry.id === startEntryId);
+    const end = entries.findIndex((entry) => entry.id === endEntryId);
+    if (start < 0 || end < start)
+        return undefined;
+    const { source: sourceTokens, suffix: suffixTokens } = estimateRangeTokenCounts(entries, start, end);
+    const summaryTokens = summary === undefined ? Math.ceil(sourceTokens / 4) : Math.ceil(summary.length / 4);
+    const removedTokens = Math.max(0, sourceTokens - summaryTokens);
+    const readRate = usingSubscription ? 0 : model.cost.cacheRead > 0 ? model.cost.cacheRead : model.cost.input;
+    // For automatic caching, a miss is ordinary input, not a separately reported cache write.
+    // Only the suffix after the changed range may lose its cached prefix; the earlier prefix is unchanged.
+    const oneTimeCost = !usingSubscription && model.cost.input > 0 && model.cost.output > 0
+        ? (summaryTokens * (model.cost.input + model.cost.output) +
+            suffixTokens * Math.max(0, model.cost.input - readRate)) /
+            1_000_000
+        : null;
+    const savingPerRequest = (removedTokens * readRate) / 1_000_000;
+    return {
+        provider: model.provider,
+        modelId: model.id,
+        sourceTokens,
+        summaryTokens,
+        removedTokens,
+        readRate,
+        oneTimeCost,
+        breakEvenRequests: oneTimeCost != null && savingPerRequest > 0 ? Math.ceil(oneTimeCost / savingPerRequest) : null,
+    };
+}
+function isEconomicsRecord(data) {
+    if (!data || typeof data !== "object")
+        return false;
+    const record = data;
+    return (record.version === 1 &&
+        typeof record.summaryEntryId === "string" &&
+        typeof record.provider === "string" &&
+        typeof record.modelId === "string" &&
+        typeof record.removedTokens === "number" &&
+        Number.isFinite(record.removedTokens) &&
+        record.removedTokens >= 0 &&
+        typeof record.readRate === "number" &&
+        Number.isFinite(record.readRate) &&
+        record.readRate >= 0 &&
+        (record.oneTimeCost === null || (typeof record.oneTimeCost === "number" && Number.isFinite(record.oneTimeCost))));
+}
+function isSavingsSnapshot(data) {
+    if (!data || typeof data !== "object")
+        return false;
+    const snapshot = data;
+    return (snapshot.version === 1 &&
+        Number.isFinite(snapshot.totalRemovedTokens) &&
+        Number.isFinite(snapshot.liveRemovedTokens) &&
+        Number.isFinite(snapshot.avoidedCost) &&
+        Number.isFinite(snapshot.oneTimeCost) &&
+        Number.isFinite(snapshot.pricedRequests) &&
+        Array.isArray(snapshot.activeSavings) &&
+        snapshot.activeSavings.every((saving) => !!saving &&
+            typeof saving === "object" &&
+            typeof saving.summaryEntryId === "string" &&
+            typeof saving.provider === "string" &&
+            typeof saving.modelId === "string" &&
+            Number.isFinite(saving.removedTokens) &&
+            Number.isFinite(saving.readRate)));
+}
+/** Approximate future requests to recover outstanding compression cost at two input-price scenarios. */
+export function estimateCompressionCatchUp(branch, model, usingSubscription) {
+    const state = createCompressionSavingsSnapshot(branch);
+    const remaining = Math.max(0, state.oneTimeCost - state.avoidedCost);
+    const tokens = state.activeSavings.reduce((total, saving) => total + (saving.provider === model.provider && saving.modelId === model.id ? saving.removedTokens : 0), 0);
+    if (usingSubscription || !remaining || !tokens)
+        return { cachedTurns: null, newInputTurns: null };
+    return {
+        cachedTurns: model.cost.cacheRead > 0 ? Math.ceil((remaining * 1_000_000) / (tokens * model.cost.cacheRead)) : null,
+        newInputTurns: model.cost.input > 0 ? Math.ceil((remaining * 1_000_000) / (tokens * model.cost.input)) : null,
+    };
+}
+/** Replay persisted estimates in branch order, without counting archived or replayed provider calls twice. */
+export function estimateCompressionSavings(branch) {
+    const { activeSavings: _activeSavings, version: _version, ...totals } = createCompressionSavingsSnapshot(branch);
+    return {
+        ...totals,
+        netAvoidedCost: Math.max(0, totals.avoidedCost - totals.oneTimeCost),
+        remainingToBreakEven: Math.max(0, totals.oneTimeCost - totals.avoidedCost),
+    };
+}
+function creditAssistantRequest(state, provider, modelId) {
+    let saved = 0;
+    for (const saving of state.activeSavings) {
+        if (provider === saving.provider && modelId === saving.modelId)
+            saved += (saving.removedTokens * saving.readRate) / 1_000_000;
+    }
+    if (saved > 0) {
+        state.pricedRequests++;
+        state.avoidedCost += saved;
+    }
+}
+function applyEconomicsRecord(state, data) {
+    if (!isEconomicsRecord(data))
+        return;
+    const { summaryEntryId, provider, modelId, removedTokens, readRate, oneTimeCost } = data;
+    state.totalRemovedTokens += removedTokens;
+    state.liveRemovedTokens += removedTokens;
+    state.oneTimeCost += oneTimeCost ?? 0;
+    state.activeSavings.push({ summaryEntryId, provider, modelId, removedTokens, readRate });
+}
+export function createCompressionSavingsSnapshot(branch) {
+    let state = {
+        version: 1,
+        totalRemovedTokens: 0,
+        liveRemovedTokens: 0,
+        avoidedCost: 0,
+        oneTimeCost: 0,
+        pricedRequests: 0,
+        activeSavings: [],
+    };
+    for (const entry of branch) {
+        if (entry.type === "compaction") {
+            state.liveRemovedTokens = 0;
+            state.activeSavings = [];
+        }
+        else if (entry.type === "custom" && entry.customType === COMPRESSION_SAVINGS_SNAPSHOT_TYPE) {
+            if (isSavingsSnapshot(entry.data))
+                state = { ...entry.data, activeSavings: [...entry.data.activeSavings] };
+        }
+        else if (entry.type === "custom" && entry.customType === COMPRESSION_ECONOMICS_ENTRY_TYPE) {
+            applyEconomicsRecord(state, entry.data);
+        }
+        else if (entry.type === "message" && entry.message.role === "assistant" && !entry.replayedFromId) {
+            creditAssistantRequest(state, entry.message.provider, entry.message.model);
+        }
+    }
+    return state;
+}
+//# sourceMappingURL=compression-economics.js.map

package/dist/core/compaction/compression-economics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compression-economics.js","sourceRoot":"","sources":["../../../src/core/compaction/compression-economics.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Api, Model } from \"@greppleai/grip-ai\";\nimport { sessionEntryToContextMessages } from \"../session/context.ts\";\nimport type { SessionEntry } from \"../session/types.ts\";\nimport { estimateTokens } from \"./compaction.ts\";\n\nexport const COMPRESSION_ECONOMICS_ENTRY_TYPE = \"compression_economics\";\nexport const COMPRESSION_SAVINGS_SNAPSHOT_TYPE = \"compression_savings_snapshot\";\n\n/** Approximate context and catalog-price assumptions, not provider-reported savings. */\nexport interface CompressionEconomicsRecord {\n\tversion: 1;\n\tsummaryEntryId: string;\n\tprovider: string;\n\tmodelId: string;\n\tsourceTokens: number;\n\tsummaryTokens: number;\n\tremovedTokens: number;\n\treadRate: number;\n\toneTimeCost: number | null;\n\tbreakEvenRequests: number | null;\n}\n\ninterface CompressionRangeTokenCounts {\n\tsource: number;\n\tsuffix: number;\n}\n\nfunction estimateRangeTokenCounts(entries: SessionEntry[], start: number, end: number): CompressionRangeTokenCounts {\n\tlet source = 0;\n\tlet suffix = 0;\n\tfor (const [index, entry] of entries.entries()) {\n\t\tfor (const message of sessionEntryToContextMessages(entry)) {\n\t\t\tconst tokens = estimateTokens(message);\n\t\t\tif (index >= start && index <= end) source += tokens;\n\t\t\telse if (index > end) suffix += tokens;\n\t\t}\n\t}\n\treturn { source, suffix };\n}\n\nexport function estimateCompressionEconomics(\n\tentries: SessionEntry[],\n\tstartEntryId: string,\n\tendEntryId: string,\n\tmodel: Model<Api>,\n\tsummary?: string,\n\tusingSubscription = false,\n): Omit<CompressionEconomicsRecord, \"version\" | \"summaryEntryId\"> | undefined {\n\tconst start = entries.findIndex((entry) => entry.id === startEntryId);\n\tconst end = entries.findIndex((entry) => entry.id === endEntryId);\n\tif (start < 0 || end < start) return undefined;\n\tconst { source: sourceTokens, suffix: suffixTokens } = estimateRangeTokenCounts(entries, start, end);\n\tconst summaryTokens = summary === undefined ? Math.ceil(sourceTokens / 4) : Math.ceil(summary.length / 4);\n\tconst removedTokens = Math.max(0, sourceTokens - summaryTokens);\n\tconst readRate = usingSubscription ? 0 : model.cost.cacheRead > 0 ? model.cost.cacheRead : model.cost.input;\n\t// For automatic caching, a miss is ordinary input, not a separately reported cache write.\n\t// Only the suffix after the changed range may lose its cached prefix; the earlier prefix is unchanged.\n\tconst oneTimeCost =\n\t\t!usingSubscription && model.cost.input > 0 && model.cost.output > 0\n\t\t\t? (summaryTokens * (model.cost.input + model.cost.output) +\n\t\t\t\t\tsuffixTokens * Math.max(0, model.cost.input - readRate)) /\n\t\t\t\t1_000_000\n\t\t\t: null;\n\tconst savingPerRequest = (removedTokens * readRate) / 1_000_000;\n\treturn {\n\t\tprovider: model.provider,\n\t\tmodelId: model.id,\n\t\tsourceTokens,\n\t\tsummaryTokens,\n\t\tremovedTokens,\n\t\treadRate,\n\t\toneTimeCost,\n\t\tbreakEvenRequests: oneTimeCost != null && savingPerRequest > 0 ? Math.ceil(oneTimeCost / savingPerRequest) : null,\n\t};\n}\n\nfunction isEconomicsRecord(data: unknown): data is CompressionEconomicsRecord {\n\tif (!data || typeof data !== \"object\") return false;\n\tconst record = data as Partial<CompressionEconomicsRecord>;\n\treturn (\n\t\trecord.version === 1 &&\n\t\ttypeof record.summaryEntryId === \"string\" &&\n\t\ttypeof record.provider === \"string\" &&\n\t\ttypeof record.modelId === \"string\" &&\n\t\ttypeof record.removedTokens === \"number\" &&\n\t\tNumber.isFinite(record.removedTokens) &&\n\t\trecord.removedTokens >= 0 &&\n\t\ttypeof record.readRate === \"number\" &&\n\t\tNumber.isFinite(record.readRate) &&\n\t\trecord.readRate >= 0 &&\n\t\t(record.oneTimeCost === null || (typeof record.oneTimeCost === \"number\" && Number.isFinite(record.oneTimeCost)))\n\t);\n}\n\ninterface ActiveSaving {\n\tsummaryEntryId: string;\n\tprovider: string;\n\tmodelId: string;\n\tremovedTokens: number;\n\treadRate: number;\n}\n\n/** Captures accrued estimates before replacing their ledger entries on an archived branch. */\nexport interface CompressionSavingsSnapshot {\n\tversion: 1;\n\ttotalRemovedTokens: number;\n\tliveRemovedTokens: number;\n\tavoidedCost: number;\n\toneTimeCost: number;\n\tpricedRequests: number;\n\tactiveSavings: ActiveSaving[];\n}\n\nfunction isSavingsSnapshot(data: unknown): data is CompressionSavingsSnapshot {\n\tif (!data || typeof data !== \"object\") return false;\n\tconst snapshot = data as Partial<CompressionSavingsSnapshot>;\n\treturn (\n\t\tsnapshot.version === 1 &&\n\t\tNumber.isFinite(snapshot.totalRemovedTokens) &&\n\t\tNumber.isFinite(snapshot.liveRemovedTokens) &&\n\t\tNumber.isFinite(snapshot.avoidedCost) &&\n\t\tNumber.isFinite(snapshot.oneTimeCost) &&\n\t\tNumber.isFinite(snapshot.pricedRequests) &&\n\t\tArray.isArray(snapshot.activeSavings) &&\n\t\tsnapshot.activeSavings.every(\n\t\t\t(saving: unknown) =>\n\t\t\t\t!!saving &&\n\t\t\t\ttypeof saving === \"object\" &&\n\t\t\t\ttypeof (saving as ActiveSaving).summaryEntryId === \"string\" &&\n\t\t\t\ttypeof (saving as ActiveSaving).provider === \"string\" &&\n\t\t\t\ttypeof (saving as ActiveSaving).modelId === \"string\" &&\n\t\t\t\tNumber.isFinite((saving as ActiveSaving).removedTokens) &&\n\t\t\t\tNumber.isFinite((saving as ActiveSaving).readRate),\n\t\t)\n\t);\n}\n\nexport interface CompressionSavingsEstimate {\n\ttotalRemovedTokens: number;\n\tliveRemovedTokens: number;\n\tavoidedCost: number;\n\toneTimeCost: number;\n\tnetAvoidedCost: number;\n\tremainingToBreakEven: number;\n\tpricedRequests: number;\n}\nexport interface CompressionCatchUpEstimate {\n\tcachedTurns: number | null;\n\tnewInputTurns: number | null;\n}\n\n/** Approximate future requests to recover outstanding compression cost at two input-price scenarios. */\nexport function estimateCompressionCatchUp(\n\tbranch: SessionEntry[],\n\tmodel: Model<Api>,\n\tusingSubscription: boolean,\n): CompressionCatchUpEstimate {\n\tconst state = createCompressionSavingsSnapshot(branch);\n\tconst remaining = Math.max(0, state.oneTimeCost - state.avoidedCost);\n\tconst tokens = state.activeSavings.reduce(\n\t\t(total, saving) =>\n\t\t\ttotal + (saving.provider === model.provider && saving.modelId === model.id ? saving.removedTokens : 0),\n\t\t0,\n\t);\n\tif (usingSubscription || !remaining || !tokens) return { cachedTurns: null, newInputTurns: null };\n\treturn {\n\t\tcachedTurns:\n\t\t\tmodel.cost.cacheRead > 0 ? Math.ceil((remaining * 1_000_000) / (tokens * model.cost.cacheRead)) : null,\n\t\tnewInputTurns: model.cost.input > 0 ? Math.ceil((remaining * 1_000_000) / (tokens * model.cost.input)) : null,\n\t};\n}\n\n/** Replay persisted estimates in branch order, without counting archived or replayed provider calls twice. */\nexport function estimateCompressionSavings(branch: SessionEntry[]): CompressionSavingsEstimate {\n\tconst { activeSavings: _activeSavings, version: _version, ...totals } = createCompressionSavingsSnapshot(branch);\n\treturn {\n\t\t...totals,\n\t\tnetAvoidedCost: Math.max(0, totals.avoidedCost - totals.oneTimeCost),\n\t\tremainingToBreakEven: Math.max(0, totals.oneTimeCost - totals.avoidedCost),\n\t};\n}\n\nfunction creditAssistantRequest(state: CompressionSavingsSnapshot, provider: string, modelId: string): void {\n\tlet saved = 0;\n\tfor (const saving of state.activeSavings) {\n\t\tif (provider === saving.provider && modelId === saving.modelId)\n\t\t\tsaved += (saving.removedTokens * saving.readRate) / 1_000_000;\n\t}\n\tif (saved > 0) {\n\t\tstate.pricedRequests++;\n\t\tstate.avoidedCost += saved;\n\t}\n}\n\nfunction applyEconomicsRecord(state: CompressionSavingsSnapshot, data: unknown): void {\n\tif (!isEconomicsRecord(data)) return;\n\tconst { summaryEntryId, provider, modelId, removedTokens, readRate, oneTimeCost } = data;\n\tstate.totalRemovedTokens += removedTokens;\n\tstate.liveRemovedTokens += removedTokens;\n\tstate.oneTimeCost += oneTimeCost ?? 0;\n\tstate.activeSavings.push({ summaryEntryId, provider, modelId, removedTokens, readRate });\n}\n\nexport function createCompressionSavingsSnapshot(branch: SessionEntry[]): CompressionSavingsSnapshot {\n\tlet state: CompressionSavingsSnapshot = {\n\t\tversion: 1,\n\t\ttotalRemovedTokens: 0,\n\t\tliveRemovedTokens: 0,\n\t\tavoidedCost: 0,\n\t\toneTimeCost: 0,\n\t\tpricedRequests: 0,\n\t\tactiveSavings: [],\n\t};\n\tfor (const entry of branch) {\n\t\tif (entry.type === \"compaction\") {\n\t\t\tstate.liveRemovedTokens = 0;\n\t\t\tstate.activeSavings = [];\n\t\t} else if (entry.type === \"custom\" && entry.customType === COMPRESSION_SAVINGS_SNAPSHOT_TYPE) {\n\t\t\tif (isSavingsSnapshot(entry.data)) state = { ...entry.data, activeSavings: [...entry.data.activeSavings] };\n\t\t} else if (entry.type === \"custom\" && entry.customType === COMPRESSION_ECONOMICS_ENTRY_TYPE) {\n\t\t\tapplyEconomicsRecord(state, entry.data);\n\t\t} else if (entry.type === \"message\" && entry.message.role === \"assistant\" && !entry.replayedFromId) {\n\t\t\tcreditAssistantRequest(state, entry.message.provider, entry.message.model);\n\t\t}\n\t}\n\treturn state;\n}\n"]}

package/dist/core/compaction/utils.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Shared utilities for compaction and branch summarization.
+ */
+import type { AgentMessage, FileOperationLists, FileOperations } from "@greppleai/grip-agent-core";
+export type { FileOperations } from "@greppleai/grip-agent-core";
+import type { Message } from "@greppleai/grip-ai";
+export declare function createFileOps(): FileOperations;
+export declare function extractFileOpsFromMessage(message: AgentMessage, fileOps: FileOperations): void;
+/**
+ * Compute final file lists from file operations.
+ * Returns readFiles (files only read, not modified) and modifiedFiles.
+ */
+export declare function computeFileLists(fileOps: FileOperations): FileOperationLists;
+/**
+ * Format file operations as XML tags for summary.
+ */
+export declare function formatFileOperations(readFiles: string[], modifiedFiles: string[]): string;
+/**
+ * Serialize LLM messages to text for summarization.
+ * This prevents the model from treating it as a conversation to continue.
+ * Call convertToLlm() first to handle custom message types.
+ *
+ * Tool results are truncated to keep the summarization request within
+ * reasonable token budgets. Full content is not needed for summarization.
+ */
+export declare function serializeConversation(messages: Message[]): string;
+export declare const SUMMARIZATION_SYSTEM_PROMPT = "You are a context summarization assistant. Your task is to read a conversation between a user and an AI coding assistant, then produce a structured summary following the exact format specified.\n\nDo NOT continue the conversation. Do NOT respond to any questions in the conversation. ONLY output the structured summary.";
+//# sourceMappingURL=utils.d.ts.map

package/dist/core/compaction/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/core/compaction/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEnG,YAAY,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,KAAK,EAGX,OAAO,EAIP,MAAM,oBAAoB,CAAC;AAM5B,wBAAgB,aAAa,IAAI,cAAc,CAM9C;AA0BD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAI9F;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,kBAAkB,CAK5E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,MAAM,CAUzF;AA8DD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAgBjE;AAMD,eAAO,MAAM,2BAA2B,oUAEmF,CAAC","sourcesContent":["/**\n * Shared utilities for compaction and branch summarization.\n */\n\nimport type { AgentMessage, FileOperationLists, FileOperations } from \"@greppleai/grip-agent-core\";\n\nexport type { FileOperations } from \"@greppleai/grip-agent-core\";\n\nimport type {\n\tAssistantMessage,\n\tImageContent,\n\tMessage,\n\tTextContent,\n\tToolResultMessage,\n\tUserMessage,\n} from \"@greppleai/grip-ai\";\n\n// ============================================================================\n// File Operation Tracking\n// ============================================================================\n\nexport function createFileOps(): FileOperations {\n\treturn {\n\t\tread: new Set(),\n\t\twritten: new Set(),\n\t\tedited: new Set(),\n\t};\n}\n\n/**\n * Extract file operations from tool calls in an assistant message.\n */\nfunction recordToolCallFileOperation(block: unknown, fileOps: FileOperations): void {\n\tif (typeof block !== \"object\" || block === null) return;\n\tif (!(\"type\" in block) || block.type !== \"toolCall\") return;\n\tif (!(\"arguments\" in block) || !(\"name\" in block)) return;\n\tconst args = block.arguments as Record<string, unknown> | undefined;\n\tif (!args) return;\n\tconst path = typeof args.path === \"string\" ? args.path : undefined;\n\tif (!path) return;\n\tswitch (block.name) {\n\t\tcase \"read\":\n\t\t\tfileOps.read.add(path);\n\t\t\tbreak;\n\t\tcase \"write\":\n\t\t\tfileOps.written.add(path);\n\t\t\tbreak;\n\t\tcase \"edit\":\n\t\t\tfileOps.edited.add(path);\n\t\t\tbreak;\n\t}\n}\n\nexport function extractFileOpsFromMessage(message: AgentMessage, fileOps: FileOperations): void {\n\tif (message.role !== \"assistant\") return;\n\tif (!(\"content\" in message) || !Array.isArray(message.content)) return;\n\tfor (const block of message.content) recordToolCallFileOperation(block, fileOps);\n}\n\n/**\n * Compute final file lists from file operations.\n * Returns readFiles (files only read, not modified) and modifiedFiles.\n */\nexport function computeFileLists(fileOps: FileOperations): FileOperationLists {\n\tconst modified = new Set([...fileOps.edited, ...fileOps.written]);\n\tconst readOnly = [...fileOps.read].filter((f) => !modified.has(f)).sort();\n\tconst modifiedFiles = [...modified].sort();\n\treturn { readFiles: readOnly, modifiedFiles };\n}\n\n/**\n * Format file operations as XML tags for summary.\n */\nexport function formatFileOperations(readFiles: string[], modifiedFiles: string[]): string {\n\tconst sections: string[] = [];\n\tif (readFiles.length > 0) {\n\t\tsections.push(`<read-files>\\n${readFiles.join(\"\\n\")}\\n</read-files>`);\n\t}\n\tif (modifiedFiles.length > 0) {\n\t\tsections.push(`<modified-files>\\n${modifiedFiles.join(\"\\n\")}\\n</modified-files>`);\n\t}\n\tif (sections.length === 0) return \"\";\n\treturn `\\n\\n${sections.join(\"\\n\\n\")}`;\n}\n\n// ============================================================================\n// Message Serialization\n// ============================================================================\n\n/** Maximum characters for a tool result in serialized summaries. */\nconst TOOL_RESULT_MAX_CHARS = 2000;\n\n/**\n * Truncate text to a maximum character length for summarization.\n * Keeps the beginning and appends a truncation marker.\n */\nfunction truncateForSummary(text: string, maxChars: number): string {\n\tif (text.length <= maxChars) return text;\n\tconst truncatedChars = text.length - maxChars;\n\treturn `${text.slice(0, maxChars)}\\n\\n[... ${truncatedChars} more characters truncated]`;\n}\n\nfunction joinTextBlocks(content: readonly (TextContent | ImageContent)[]): string {\n\tlet text = \"\";\n\tfor (const block of content) {\n\t\tif (block.type === \"text\") text += block.text;\n\t}\n\treturn text;\n}\n\nfunction serializeUserMessage(message: UserMessage): string[] {\n\tconst content = typeof message.content === \"string\" ? message.content : joinTextBlocks(message.content);\n\treturn content ? [`[User]: ${content}`] : [];\n}\n\nfunction serializeAssistantMessage(message: AssistantMessage): string[] {\n\tconst textParts: string[] = [];\n\tconst thinkingParts: string[] = [];\n\tconst toolCalls: string[] = [];\n\tfor (const block of message.content) {\n\t\tif (block.type === \"text\") {\n\t\t\ttextParts.push(block.text);\n\t\t} else if (block.type === \"thinking\") {\n\t\t\tthinkingParts.push(block.thinking);\n\t\t} else if (block.type === \"toolCall\") {\n\t\t\tconst args = block.arguments as Record<string, unknown>;\n\t\t\tconst argsText = Object.entries(args)\n\t\t\t\t.map(([key, value]) => `${key}=${JSON.stringify(value)}`)\n\t\t\t\t.join(\", \");\n\t\t\ttoolCalls.push(`${block.name}(${argsText})`);\n\t\t}\n\t}\n\n\tconst parts: string[] = [];\n\tif (thinkingParts.length > 0) parts.push(`[Assistant thinking]: ${thinkingParts.join(\"\\n\")}`);\n\tif (textParts.length > 0) parts.push(`[Assistant]: ${textParts.join(\"\\n\")}`);\n\tif (toolCalls.length > 0) parts.push(`[Assistant tool calls]: ${toolCalls.join(\"; \")}`);\n\treturn parts;\n}\n\nfunction serializeToolResultMessage(message: ToolResultMessage): string[] {\n\tconst content = joinTextBlocks(message.content);\n\treturn content ? [`[Tool result]: ${truncateForSummary(content, TOOL_RESULT_MAX_CHARS)}`] : [];\n}\n\n/**\n * Serialize LLM messages to text for summarization.\n * This prevents the model from treating it as a conversation to continue.\n * Call convertToLlm() first to handle custom message types.\n *\n * Tool results are truncated to keep the summarization request within\n * reasonable token budgets. Full content is not needed for summarization.\n */\nexport function serializeConversation(messages: Message[]): string {\n\tconst parts: string[] = [];\n\tfor (const message of messages) {\n\t\tswitch (message.role) {\n\t\t\tcase \"user\":\n\t\t\t\tparts.push(...serializeUserMessage(message));\n\t\t\t\tbreak;\n\t\t\tcase \"assistant\":\n\t\t\t\tparts.push(...serializeAssistantMessage(message));\n\t\t\t\tbreak;\n\t\t\tcase \"toolResult\":\n\t\t\t\tparts.push(...serializeToolResultMessage(message));\n\t\t\t\tbreak;\n\t\t}\n\t}\n\treturn parts.join(\"\\n\\n\");\n}\n\n// ============================================================================\n// Summarization System Prompt\n// ============================================================================\n\nexport const SUMMARIZATION_SYSTEM_PROMPT = `You are a context summarization assistant. Your task is to read a conversation between a user and an AI coding assistant, then produce a structured summary following the exact format specified.\n\nDo NOT continue the conversation. Do NOT respond to any questions in the conversation. ONLY output the structured summary.`;\n"]}

package/dist/core/compaction/utils.js

@@ -0,0 +1,165 @@
+/**
+ * Shared utilities for compaction and branch summarization.
+ */
+// ============================================================================
+// File Operation Tracking
+// ============================================================================
+export function createFileOps() {
+    return {
+        read: new Set(),
+        written: new Set(),
+        edited: new Set(),
+    };
+}
+/**
+ * Extract file operations from tool calls in an assistant message.
+ */
+function recordToolCallFileOperation(block, fileOps) {
+    if (typeof block !== "object" || block === null)
+        return;
+    if (!("type" in block) || block.type !== "toolCall")
+        return;
+    if (!("arguments" in block) || !("name" in block))
+        return;
+    const args = block.arguments;
+    if (!args)
+        return;
+    const path = typeof args.path === "string" ? args.path : undefined;
+    if (!path)
+        return;
+    switch (block.name) {
+        case "read":
+            fileOps.read.add(path);
+            break;
+        case "write":
+            fileOps.written.add(path);
+            break;
+        case "edit":
+            fileOps.edited.add(path);
+            break;
+    }
+}
+export function extractFileOpsFromMessage(message, fileOps) {
+    if (message.role !== "assistant")
+        return;
+    if (!("content" in message) || !Array.isArray(message.content))
+        return;
+    for (const block of message.content)
+        recordToolCallFileOperation(block, fileOps);
+}
+/**
+ * Compute final file lists from file operations.
+ * Returns readFiles (files only read, not modified) and modifiedFiles.
+ */
+export function computeFileLists(fileOps) {
+    const modified = new Set([...fileOps.edited, ...fileOps.written]);
+    const readOnly = [...fileOps.read].filter((f) => !modified.has(f)).sort();
+    const modifiedFiles = [...modified].sort();
+    return { readFiles: readOnly, modifiedFiles };
+}
+/**
+ * Format file operations as XML tags for summary.
+ */
+export function formatFileOperations(readFiles, modifiedFiles) {
+    const sections = [];
+    if (readFiles.length > 0) {
+        sections.push(`<read-files>\n${readFiles.join("\n")}\n</read-files>`);
+    }
+    if (modifiedFiles.length > 0) {
+        sections.push(`<modified-files>\n${modifiedFiles.join("\n")}\n</modified-files>`);
+    }
+    if (sections.length === 0)
+        return "";
+    return `\n\n${sections.join("\n\n")}`;
+}
+// ============================================================================
+// Message Serialization
+// ============================================================================
+/** Maximum characters for a tool result in serialized summaries. */
+const TOOL_RESULT_MAX_CHARS = 2000;
+/**
+ * Truncate text to a maximum character length for summarization.
+ * Keeps the beginning and appends a truncation marker.
+ */
+function truncateForSummary(text, maxChars) {
+    if (text.length <= maxChars)
+        return text;
+    const truncatedChars = text.length - maxChars;
+    return `${text.slice(0, maxChars)}\n\n[... ${truncatedChars} more characters truncated]`;
+}
+function joinTextBlocks(content) {
+    let text = "";
+    for (const block of content) {
+        if (block.type === "text")
+            text += block.text;
+    }
+    return text;
+}
+function serializeUserMessage(message) {
+    const content = typeof message.content === "string" ? message.content : joinTextBlocks(message.content);
+    return content ? [`[User]: ${content}`] : [];
+}
+function serializeAssistantMessage(message) {
+    const textParts = [];
+    const thinkingParts = [];
+    const toolCalls = [];
+    for (const block of message.content) {
+        if (block.type === "text") {
+            textParts.push(block.text);
+        }
+        else if (block.type === "thinking") {
+            thinkingParts.push(block.thinking);
+        }
+        else if (block.type === "toolCall") {
+            const args = block.arguments;
+            const argsText = Object.entries(args)
+                .map(([key, value]) => `${key}=${JSON.stringify(value)}`)
+                .join(", ");
+            toolCalls.push(`${block.name}(${argsText})`);
+        }
+    }
+    const parts = [];
+    if (thinkingParts.length > 0)
+        parts.push(`[Assistant thinking]: ${thinkingParts.join("\n")}`);
+    if (textParts.length > 0)
+        parts.push(`[Assistant]: ${textParts.join("\n")}`);
+    if (toolCalls.length > 0)
+        parts.push(`[Assistant tool calls]: ${toolCalls.join("; ")}`);
+    return parts;
+}
+function serializeToolResultMessage(message) {
+    const content = joinTextBlocks(message.content);
+    return content ? [`[Tool result]: ${truncateForSummary(content, TOOL_RESULT_MAX_CHARS)}`] : [];
+}
+/**
+ * Serialize LLM messages to text for summarization.
+ * This prevents the model from treating it as a conversation to continue.
+ * Call convertToLlm() first to handle custom message types.
+ *
+ * Tool results are truncated to keep the summarization request within
+ * reasonable token budgets. Full content is not needed for summarization.
+ */
+export function serializeConversation(messages) {
+    const parts = [];
+    for (const message of messages) {
+        switch (message.role) {
+            case "user":
+                parts.push(...serializeUserMessage(message));
+                break;
+            case "assistant":
+                parts.push(...serializeAssistantMessage(message));
+                break;
+            case "toolResult":
+                parts.push(...serializeToolResultMessage(message));
+                break;
+        }
+    }
+    return parts.join("\n\n");
+}
+// ============================================================================
+// Summarization System Prompt
+// ============================================================================
+export const SUMMARIZATION_SYSTEM_PROMPT = `You are a context summarization assistant. Your task is to read a conversation between a user and an AI coding assistant, then produce a structured summary following the exact format specified.
+
+Do NOT continue the conversation. Do NOT respond to any questions in the conversation. ONLY output the structured summary.`;
+//# sourceMappingURL=utils.js.map

package/dist/core/compaction/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/core/compaction/utils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Shared utilities for compaction and branch summarization.\n */\n\nimport type { AgentMessage, FileOperationLists, FileOperations } from \"@greppleai/grip-agent-core\";\n\nexport type { FileOperations } from \"@greppleai/grip-agent-core\";\n\nimport type {\n\tAssistantMessage,\n\tImageContent,\n\tMessage,\n\tTextContent,\n\tToolResultMessage,\n\tUserMessage,\n} from \"@greppleai/grip-ai\";\n\n// ============================================================================\n// File Operation Tracking\n// ============================================================================\n\nexport function createFileOps(): FileOperations {\n\treturn {\n\t\tread: new Set(),\n\t\twritten: new Set(),\n\t\tedited: new Set(),\n\t};\n}\n\n/**\n * Extract file operations from tool calls in an assistant message.\n */\nfunction recordToolCallFileOperation(block: unknown, fileOps: FileOperations): void {\n\tif (typeof block !== \"object\" || block === null) return;\n\tif (!(\"type\" in block) || block.type !== \"toolCall\") return;\n\tif (!(\"arguments\" in block) || !(\"name\" in block)) return;\n\tconst args = block.arguments as Record<string, unknown> | undefined;\n\tif (!args) return;\n\tconst path = typeof args.path === \"string\" ? args.path : undefined;\n\tif (!path) return;\n\tswitch (block.name) {\n\t\tcase \"read\":\n\t\t\tfileOps.read.add(path);\n\t\t\tbreak;\n\t\tcase \"write\":\n\t\t\tfileOps.written.add(path);\n\t\t\tbreak;\n\t\tcase \"edit\":\n\t\t\tfileOps.edited.add(path);\n\t\t\tbreak;\n\t}\n}\n\nexport function extractFileOpsFromMessage(message: AgentMessage, fileOps: FileOperations): void {\n\tif (message.role !== \"assistant\") return;\n\tif (!(\"content\" in message) || !Array.isArray(message.content)) return;\n\tfor (const block of message.content) recordToolCallFileOperation(block, fileOps);\n}\n\n/**\n * Compute final file lists from file operations.\n * Returns readFiles (files only read, not modified) and modifiedFiles.\n */\nexport function computeFileLists(fileOps: FileOperations): FileOperationLists {\n\tconst modified = new Set([...fileOps.edited, ...fileOps.written]);\n\tconst readOnly = [...fileOps.read].filter((f) => !modified.has(f)).sort();\n\tconst modifiedFiles = [...modified].sort();\n\treturn { readFiles: readOnly, modifiedFiles };\n}\n\n/**\n * Format file operations as XML tags for summary.\n */\nexport function formatFileOperations(readFiles: string[], modifiedFiles: string[]): string {\n\tconst sections: string[] = [];\n\tif (readFiles.length > 0) {\n\t\tsections.push(`<read-files>\\n${readFiles.join(\"\\n\")}\\n</read-files>`);\n\t}\n\tif (modifiedFiles.length > 0) {\n\t\tsections.push(`<modified-files>\\n${modifiedFiles.join(\"\\n\")}\\n</modified-files>`);\n\t}\n\tif (sections.length === 0) return \"\";\n\treturn `\\n\\n${sections.join(\"\\n\\n\")}`;\n}\n\n// ============================================================================\n// Message Serialization\n// ============================================================================\n\n/** Maximum characters for a tool result in serialized summaries. */\nconst TOOL_RESULT_MAX_CHARS = 2000;\n\n/**\n * Truncate text to a maximum character length for summarization.\n * Keeps the beginning and appends a truncation marker.\n */\nfunction truncateForSummary(text: string, maxChars: number): string {\n\tif (text.length <= maxChars) return text;\n\tconst truncatedChars = text.length - maxChars;\n\treturn `${text.slice(0, maxChars)}\\n\\n[... ${truncatedChars} more characters truncated]`;\n}\n\nfunction joinTextBlocks(content: readonly (TextContent | ImageContent)[]): string {\n\tlet text = \"\";\n\tfor (const block of content) {\n\t\tif (block.type === \"text\") text += block.text;\n\t}\n\treturn text;\n}\n\nfunction serializeUserMessage(message: UserMessage): string[] {\n\tconst content = typeof message.content === \"string\" ? message.content : joinTextBlocks(message.content);\n\treturn content ? [`[User]: ${content}`] : [];\n}\n\nfunction serializeAssistantMessage(message: AssistantMessage): string[] {\n\tconst textParts: string[] = [];\n\tconst thinkingParts: string[] = [];\n\tconst toolCalls: string[] = [];\n\tfor (const block of message.content) {\n\t\tif (block.type === \"text\") {\n\t\t\ttextParts.push(block.text);\n\t\t} else if (block.type === \"thinking\") {\n\t\t\tthinkingParts.push(block.thinking);\n\t\t} else if (block.type === \"toolCall\") {\n\t\t\tconst args = block.arguments as Record<string, unknown>;\n\t\t\tconst argsText = Object.entries(args)\n\t\t\t\t.map(([key, value]) => `${key}=${JSON.stringify(value)}`)\n\t\t\t\t.join(\", \");\n\t\t\ttoolCalls.push(`${block.name}(${argsText})`);\n\t\t}\n\t}\n\n\tconst parts: string[] = [];\n\tif (thinkingParts.length > 0) parts.push(`[Assistant thinking]: ${thinkingParts.join(\"\\n\")}`);\n\tif (textParts.length > 0) parts.push(`[Assistant]: ${textParts.join(\"\\n\")}`);\n\tif (toolCalls.length > 0) parts.push(`[Assistant tool calls]: ${toolCalls.join(\"; \")}`);\n\treturn parts;\n}\n\nfunction serializeToolResultMessage(message: ToolResultMessage): string[] {\n\tconst content = joinTextBlocks(message.content);\n\treturn content ? [`[Tool result]: ${truncateForSummary(content, TOOL_RESULT_MAX_CHARS)}`] : [];\n}\n\n/**\n * Serialize LLM messages to text for summarization.\n * This prevents the model from treating it as a conversation to continue.\n * Call convertToLlm() first to handle custom message types.\n *\n * Tool results are truncated to keep the summarization request within\n * reasonable token budgets. Full content is not needed for summarization.\n */\nexport function serializeConversation(messages: Message[]): string {\n\tconst parts: string[] = [];\n\tfor (const message of messages) {\n\t\tswitch (message.role) {\n\t\t\tcase \"user\":\n\t\t\t\tparts.push(...serializeUserMessage(message));\n\t\t\t\tbreak;\n\t\t\tcase \"assistant\":\n\t\t\t\tparts.push(...serializeAssistantMessage(message));\n\t\t\t\tbreak;\n\t\t\tcase \"toolResult\":\n\t\t\t\tparts.push(...serializeToolResultMessage(message));\n\t\t\t\tbreak;\n\t\t}\n\t}\n\treturn parts.join(\"\\n\\n\");\n}\n\n// ============================================================================\n// Summarization System Prompt\n// ============================================================================\n\nexport const SUMMARIZATION_SYSTEM_PROMPT = `You are a context summarization assistant. Your task is to read a conversation between a user and an AI coding assistant, then produce a structured summary following the exact format specified.\n\nDo NOT continue the conversation. Do NOT respond to any questions in the conversation. ONLY output the structured summary.`;\n"]}

package/dist/core/defaults.d.ts

@@ -0,0 +1,3 @@
+import type { ThinkingLevel } from "@greppleai/grip-agent-core";
+export declare const DEFAULT_THINKING_LEVEL: ThinkingLevel;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/core/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/core/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE,eAAO,MAAM,sBAAsB,EAAE,aAAwB,CAAC","sourcesContent":["import type { ThinkingLevel } from \"@greppleai/grip-agent-core\";\n\nexport const DEFAULT_THINKING_LEVEL: ThinkingLevel = \"medium\";\n"]}

package/dist/core/defaults.js

@@ -0,0 +1,2 @@
+export const DEFAULT_THINKING_LEVEL = "medium";
+//# sourceMappingURL=defaults.js.map

package/dist/core/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/core/defaults.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,sBAAsB,GAAkB,QAAQ,CAAC","sourcesContent":["import type { ThinkingLevel } from \"@greppleai/grip-agent-core\";\n\nexport const DEFAULT_THINKING_LEVEL: ThinkingLevel = \"medium\";\n"]}

package/dist/core/diagnostics.d.ts

@@ -0,0 +1,18 @@
+type ResourceCollisionCategory = "extension" | "skill" | "rule" | "prompt" | "theme";
+type ResourceDiagnosticCategory = "warning" | "error" | "collision";
+export interface ResourceCollision {
+    resourceType: ResourceCollisionCategory;
+    name: string;
+    winnerPath: string;
+    loserPath: string;
+    winnerSource?: string;
+    loserSource?: string;
+}
+export interface ResourceDiagnostic {
+    type: ResourceDiagnosticCategory;
+    message: string;
+    path?: string;
+    collision?: ResourceCollision;
+}
+export {};
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/core/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/core/diagnostics.ts"],"names":[],"mappings":"AAAA,KAAK,yBAAyB,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AACrF,KAAK,0BAA0B,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;AAEpE,MAAM,WAAW,iBAAiB;IACjC,YAAY,EAAE,yBAAyB,CAAC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,0BAA0B,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC9B","sourcesContent":["type ResourceCollisionCategory = \"extension\" | \"skill\" | \"rule\" | \"prompt\" | \"theme\";\ntype ResourceDiagnosticCategory = \"warning\" | \"error\" | \"collision\";\n\nexport interface ResourceCollision {\n\tresourceType: ResourceCollisionCategory;\n\tname: string; // skill/rule name, command/tool/flag name, prompt name, theme name\n\twinnerPath: string;\n\tloserPath: string;\n\twinnerSource?: string; // e.g., \"npm:foo\", \"git:...\", \"local\"\n\tloserSource?: string;\n}\n\nexport interface ResourceDiagnostic {\n\ttype: ResourceDiagnosticCategory;\n\tmessage: string;\n\tpath?: string;\n\tcollision?: ResourceCollision;\n}\n"]}

package/dist/core/diagnostics.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=diagnostics.js.map

package/dist/core/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/core/diagnostics.ts"],"names":[],"mappings":"","sourcesContent":["type ResourceCollisionCategory = \"extension\" | \"skill\" | \"rule\" | \"prompt\" | \"theme\";\ntype ResourceDiagnosticCategory = \"warning\" | \"error\" | \"collision\";\n\nexport interface ResourceCollision {\n\tresourceType: ResourceCollisionCategory;\n\tname: string; // skill/rule name, command/tool/flag name, prompt name, theme name\n\twinnerPath: string;\n\tloserPath: string;\n\twinnerSource?: string; // e.g., \"npm:foo\", \"git:...\", \"local\"\n\tloserSource?: string;\n}\n\nexport interface ResourceDiagnostic {\n\ttype: ResourceDiagnosticCategory;\n\tmessage: string;\n\tpath?: string;\n\tcollision?: ResourceCollision;\n}\n"]}

package/dist/core/event-bus.d.ts

@@ -0,0 +1,9 @@
+export interface EventBus {
+    emit(channel: string, data: unknown): void;
+    on(channel: string, handler: (data: unknown) => void): () => void;
+}
+export interface EventBusController extends EventBus {
+    clear(): void;
+}
+export declare function createEventBus(): EventBusController;
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/core/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/core/event-bus.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,QAAQ;IACxB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3C,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAClE;AAED,MAAM,WAAW,kBAAmB,SAAQ,QAAQ;IACnD,KAAK,IAAI,IAAI,CAAC;CACd;AAED,wBAAgB,cAAc,IAAI,kBAAkB,CAqBnD","sourcesContent":["import { EventEmitter } from \"node:events\";\n\nexport interface EventBus {\n\temit(channel: string, data: unknown): void;\n\ton(channel: string, handler: (data: unknown) => void): () => void;\n}\n\nexport interface EventBusController extends EventBus {\n\tclear(): void;\n}\n\nexport function createEventBus(): EventBusController {\n\tconst emitter = new EventEmitter();\n\treturn {\n\t\temit: (channel, data) => {\n\t\t\temitter.emit(channel, data);\n\t\t},\n\t\ton: (channel, handler) => {\n\t\t\tconst safeHandler = async (data: unknown) => {\n\t\t\t\ttry {\n\t\t\t\t\tawait handler(data);\n\t\t\t\t} catch (err) {\n\t\t\t\t\tconsole.error(`Event handler error (${channel}):`, err);\n\t\t\t\t}\n\t\t\t};\n\t\t\temitter.on(channel, safeHandler);\n\t\t\treturn () => emitter.off(channel, safeHandler);\n\t\t},\n\t\tclear: () => {\n\t\t\temitter.removeAllListeners();\n\t\t},\n\t};\n}\n"]}

package/dist/core/event-bus.js

@@ -0,0 +1,25 @@
+import { EventEmitter } from "node:events";
+export function createEventBus() {
+    const emitter = new EventEmitter();
+    return {
+        emit: (channel, data) => {
+            emitter.emit(channel, data);
+        },
+        on: (channel, handler) => {
+            const safeHandler = async (data) => {
+                try {
+                    await handler(data);
+                }
+                catch (err) {
+                    console.error(`Event handler error (${channel}):`, err);
+                }
+            };
+            emitter.on(channel, safeHandler);
+            return () => emitter.off(channel, safeHandler);
+        },
+        clear: () => {
+            emitter.removeAllListeners();
+        },
+    };
+}
+//# sourceMappingURL=event-bus.js.map

package/dist/core/event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../../src/core/event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAW3C,MAAM,UAAU,cAAc,GAAuB;IACpD,MAAM,OAAO,GAAG,IAAI,YAAY,EAAE,CAAC;IACnC,OAAO;QACN,IAAI,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAAA,CAC5B;QACD,EAAE,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC;YACzB,MAAM,WAAW,GAAG,KAAK,EAAE,IAAa,EAAE,EAAE,CAAC;gBAC5C,IAAI,CAAC;oBACJ,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;gBACrB,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACd,OAAO,CAAC,KAAK,CAAC,wBAAwB,OAAO,IAAI,EAAE,GAAG,CAAC,CAAC;gBACzD,CAAC;YAAA,CACD,CAAC;YACF,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YACjC,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAAA,CAC/C;QACD,KAAK,EAAE,GAAG,EAAE,CAAC;YACZ,OAAO,CAAC,kBAAkB,EAAE,CAAC;QAAA,CAC7B;KACD,CAAC;AAAA,CACF","sourcesContent":["import { EventEmitter } from \"node:events\";\n\nexport interface EventBus {\n\temit(channel: string, data: unknown): void;\n\ton(channel: string, handler: (data: unknown) => void): () => void;\n}\n\nexport interface EventBusController extends EventBus {\n\tclear(): void;\n}\n\nexport function createEventBus(): EventBusController {\n\tconst emitter = new EventEmitter();\n\treturn {\n\t\temit: (channel, data) => {\n\t\t\temitter.emit(channel, data);\n\t\t},\n\t\ton: (channel, handler) => {\n\t\t\tconst safeHandler = async (data: unknown) => {\n\t\t\t\ttry {\n\t\t\t\t\tawait handler(data);\n\t\t\t\t} catch (err) {\n\t\t\t\t\tconsole.error(`Event handler error (${channel}):`, err);\n\t\t\t\t}\n\t\t\t};\n\t\t\temitter.on(channel, safeHandler);\n\t\t\treturn () => emitter.off(channel, safeHandler);\n\t\t},\n\t\tclear: () => {\n\t\t\temitter.removeAllListeners();\n\t\t},\n\t};\n}\n"]}

package/dist/core/exec.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Shared command execution utilities for extensions and custom tools.
+ */
+/**
+ * Options for executing shell commands.
+ */
+export interface ExecOptions {
+    /** AbortSignal to cancel the command */
+    signal?: AbortSignal;
+    /** Timeout in milliseconds */
+    timeout?: number;
+    /** Working directory */
+    cwd?: string;
+}
+/**
+ * Result of executing a shell command.
+ */
+export interface ExecResult {
+    stdout: string;
+    stderr: string;
+    code: number;
+    killed: boolean;
+}
+/**
+ * Execute a shell command and return stdout/stderr/code.
+ * Supports timeout and abort signal.
+ */
+export declare function execCommand(command: string, args: string[], cwd: string, options?: ExecOptions): Promise<ExecResult>;
+//# sourceMappingURL=exec.d.ts.map

package/dist/core/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/core/exec.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,wCAAwC;IACxC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAChC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAoErB","sourcesContent":["/**\n * Shared command execution utilities for extensions and custom tools.\n */\n\nimport { spawn } from \"node:child_process\";\nimport { waitForChildProcess } from \"../utils/child-process.ts\";\n\n/**\n * Options for executing shell commands.\n */\nexport interface ExecOptions {\n\t/** AbortSignal to cancel the command */\n\tsignal?: AbortSignal;\n\t/** Timeout in milliseconds */\n\ttimeout?: number;\n\t/** Working directory */\n\tcwd?: string;\n}\n\n/**\n * Result of executing a shell command.\n */\nexport interface ExecResult {\n\tstdout: string;\n\tstderr: string;\n\tcode: number;\n\tkilled: boolean;\n}\n\n/**\n * Execute a shell command and return stdout/stderr/code.\n * Supports timeout and abort signal.\n */\nexport async function execCommand(\n\tcommand: string,\n\targs: string[],\n\tcwd: string,\n\toptions?: ExecOptions,\n): Promise<ExecResult> {\n\treturn new Promise((resolve) => {\n\t\tconst proc = spawn(command, args, {\n\t\t\tcwd,\n\t\t\tshell: false,\n\t\t\tstdio: [\"ignore\", \"pipe\", \"pipe\"],\n\t\t});\n\n\t\tlet stdout = \"\";\n\t\tlet stderr = \"\";\n\t\tlet killed = false;\n\t\tlet timeoutId: NodeJS.Timeout | undefined;\n\n\t\tconst killProcess = () => {\n\t\t\tif (!killed) {\n\t\t\t\tkilled = true;\n\t\t\t\tproc.kill(\"SIGTERM\");\n\t\t\t\t// Force kill after 5 seconds if SIGTERM doesn't work\n\t\t\t\tsetTimeout(() => {\n\t\t\t\t\tif (!proc.killed) {\n\t\t\t\t\t\tproc.kill(\"SIGKILL\");\n\t\t\t\t\t}\n\t\t\t\t}, 5000);\n\t\t\t}\n\t\t};\n\n\t\t// Handle abort signal\n\t\tif (options?.signal) {\n\t\t\tif (options.signal.aborted) {\n\t\t\t\tkillProcess();\n\t\t\t} else {\n\t\t\t\toptions.signal.addEventListener(\"abort\", killProcess, { once: true });\n\t\t\t}\n\t\t}\n\n\t\t// Handle timeout\n\t\tif (options?.timeout && options.timeout > 0) {\n\t\t\ttimeoutId = setTimeout(() => {\n\t\t\t\tkillProcess();\n\t\t\t}, options.timeout);\n\t\t}\n\n\t\tproc.stdout?.on(\"data\", (data) => {\n\t\t\tstdout += data.toString();\n\t\t});\n\n\t\tproc.stderr?.on(\"data\", (data) => {\n\t\t\tstderr += data.toString();\n\t\t});\n\n\t\t// Wait for process termination without hanging on inherited stdio handles\n\t\t// held open by detached descendants.\n\t\twaitForChildProcess(proc)\n\t\t\t.then((code) => {\n\t\t\t\tif (timeoutId) clearTimeout(timeoutId);\n\t\t\t\tif (options?.signal) {\n\t\t\t\t\toptions.signal.removeEventListener(\"abort\", killProcess);\n\t\t\t\t}\n\t\t\t\tresolve({ stdout, stderr, code: code ?? 0, killed });\n\t\t\t})\n\t\t\t.catch((_err) => {\n\t\t\t\tif (timeoutId) clearTimeout(timeoutId);\n\t\t\t\tif (options?.signal) {\n\t\t\t\t\toptions.signal.removeEventListener(\"abort\", killProcess);\n\t\t\t\t}\n\t\t\t\tresolve({ stdout, stderr, code: 1, killed });\n\t\t\t});\n\t});\n}\n"]}