@roackb2/heddle 1.3.0 → 1.5.0

package/dist/src/core/approvals/remembered-rules/service.js

@@ -0,0 +1,200 @@
+import { classifyShellCommandPolicy, DEFAULT_MUTATE_RULES, } from '../../../core/tools/toolkits/shell-process/run-shell.js';
+/**
+ * Owns remembered approval rule semantics: target extraction, matching,
+ * normalization, rule creation, and user-facing descriptions.
+ */
+export class ProjectApprovalRules {
+    static normalizeCommand(command) {
+        return ProjectApprovalRules.canonicalizeVerificationCommand(command.trim().replace(/\s+/g, ' '));
+    }
+    static findMatching(args) {
+        const target = ProjectApprovalRules.extractTarget({
+            tool: args.tool,
+            input: args.input,
+        });
+        if (!target) {
+            return undefined;
+        }
+        return args.rules.find((rule) => {
+            if (rule.tool !== args.tool) {
+                return false;
+            }
+            if (rule.mode === 'tool') {
+                return true;
+            }
+            if (rule.mode === 'prefix') {
+                return target === rule.command || target.startsWith(`${rule.command} `);
+            }
+            return rule.command === target;
+        });
+    }
+    static createForCommand(command) {
+        return ProjectApprovalRules.createShellRule(ProjectApprovalRules.normalizeCommand(command));
+    }
+    static createForCall(call) {
+        if (call.tool === 'edit_file') {
+            return {
+                tool: 'edit_file',
+                mode: 'tool',
+                command: '*',
+                scope: 'workspace',
+                capability: 'file_edit',
+                createdAt: new Date().toISOString(),
+            };
+        }
+        if (call.tool === 'read_file' || call.tool === 'list_files') {
+            const target = ProjectApprovalRules.extractTarget({ tool: call.tool, input: call.input });
+            return target ? {
+                tool: call.tool,
+                mode: 'exact',
+                command: target,
+                scope: 'outside_workspace',
+                capability: 'file_inspection',
+                createdAt: new Date().toISOString(),
+            } : undefined;
+        }
+        if (call.tool !== 'run_shell_mutate') {
+            return undefined;
+        }
+        const target = ProjectApprovalRules.extractTarget({ tool: call.tool, input: call.input });
+        return target ? ProjectApprovalRules.createShellRule(target) : undefined;
+    }
+    static describe(rule) {
+        if (rule.tool === 'edit_file') {
+            return 'allow edit_file for this project';
+        }
+        if (rule.tool === 'read_file' || rule.tool === 'list_files') {
+            return `allow ${rule.tool} for this project`;
+        }
+        if (rule.mode === 'prefix') {
+            return `allow ${rule.command} command family for this project`;
+        }
+        return 'allow exact command';
+    }
+    static extractTarget(args) {
+        if (args.tool === 'run_shell_mutate') {
+            if (typeof args.input === 'string') {
+                return ProjectApprovalRules.normalizeCommand(args.input);
+            }
+            if (!args.input || typeof args.input !== 'object' || Array.isArray(args.input)) {
+                return undefined;
+            }
+            const command = args.input.command;
+            return typeof command === 'string' && command.trim() ? ProjectApprovalRules.normalizeCommand(command) : undefined;
+        }
+        if (args.tool === 'edit_file' || args.tool === 'read_file' || args.tool === 'list_files') {
+            if (typeof args.input === 'string') {
+                return ProjectApprovalRules.normalizePath(args.input);
+            }
+            if (!args.input || typeof args.input !== 'object' || Array.isArray(args.input)) {
+                return undefined;
+            }
+            const path = args.input.path;
+            return typeof path === 'string' && path.trim() ? ProjectApprovalRules.normalizePath(path) : undefined;
+        }
+        return undefined;
+    }
+    static normalizePath(path) {
+        const trimmed = path.trim();
+        if (trimmed === './' || trimmed === '.') {
+            return '.';
+        }
+        return trimmed.replace(/\/+$/, '') || '.';
+    }
+    static buildLegacyVerificationPrefix(command) {
+        const argv = command.split(' ').filter(Boolean);
+        if (argv[0] !== 'yarn') {
+            return undefined;
+        }
+        const subcommand = argv[1];
+        if (subcommand === 'test' || subcommand === 'build' || subcommand === 'lint' || subcommand === 'vitest') {
+            return `yarn ${subcommand}`;
+        }
+        return undefined;
+    }
+    static createShellRule(command) {
+        const policy = classifyShellCommandPolicy(command, {
+            toolName: 'run_shell_mutate',
+            rules: DEFAULT_MUTATE_RULES,
+            allowUnknown: true,
+        });
+        if (!('error' in policy) && ProjectApprovalRules.shouldUseVerificationPrefixApproval(command, policy.scope, policy.capability)) {
+            return {
+                tool: 'run_shell_mutate',
+                mode: 'prefix',
+                command: ProjectApprovalRules.buildVerificationPrefix(command),
+                scope: policy.scope,
+                capability: policy.capability,
+                createdAt: new Date().toISOString(),
+            };
+        }
+        if (!('error' in policy)) {
+            return {
+                tool: 'run_shell_mutate',
+                mode: 'exact',
+                command,
+                scope: policy.scope,
+                capability: policy.capability,
+                createdAt: new Date().toISOString(),
+            };
+        }
+        return {
+            tool: 'run_shell_mutate',
+            mode: 'exact',
+            command,
+            scope: 'workspace',
+            capability: 'unknown_workspace',
+            createdAt: new Date().toISOString(),
+        };
+    }
+    static shouldUseVerificationPrefixApproval(command, scope, capability) {
+        if (scope !== 'workspace' || capability !== 'verification') {
+            return false;
+        }
+        return ProjectApprovalRules.buildVerificationPrefix(command) !== command;
+    }
+    static buildVerificationPrefix(command) {
+        const argv = command.split(' ').filter(Boolean);
+        if (argv.length === 0) {
+            return command;
+        }
+        if (argv[0] === 'yarn' && typeof argv[1] === 'string' && !argv[1].startsWith('-')) {
+            return `${argv[0]} ${argv[1]}`;
+        }
+        if (argv[0] === 'vitest' && typeof argv[1] === 'string' && !argv[1].startsWith('-')) {
+            return `${argv[0]} ${argv[1]}`;
+        }
+        if (argv[0] === 'tsc') {
+            return 'tsc';
+        }
+        return command;
+    }
+    static canonicalizeVerificationCommand(command) {
+        const argv = command.split(' ').filter(Boolean);
+        if (argv.length === 0) {
+            return command;
+        }
+        if (argv[0] === 'npx' && typeof argv[1] === 'string') {
+            if (argv[1] === 'tsc') {
+                return ['tsc', ...argv.slice(2)].join(' ');
+            }
+            if (argv[1] === 'vitest') {
+                return ['vitest', ...argv.slice(2)].join(' ');
+            }
+            if (argv[1] === 'eslint') {
+                return ['eslint', ...argv.slice(2)].join(' ');
+            }
+        }
+        if (argv[0] === './node_modules/.bin/tsc' || argv[0] === 'node_modules/.bin/tsc') {
+            return ['tsc', ...argv.slice(1)].join(' ');
+        }
+        if (argv[0] === './node_modules/.bin/vitest' || argv[0] === 'node_modules/.bin/vitest') {
+            return ['vitest', ...argv.slice(1)].join(' ');
+        }
+        if (argv[0] === './node_modules/.bin/eslint' || argv[0] === 'node_modules/.bin/eslint') {
+            return ['eslint', ...argv.slice(1)].join(' ');
+        }
+        return command;
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/src/core/approvals/remembered-rules/service.js.map

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

package/dist/src/core/approvals/remembered-rules/types.d.ts

@@ -0,0 +1,12 @@
+import type { RunShellCapability, RunShellScope } from '../../../core/tools/toolkits/shell-process/run-shell.js';
+export type ApprovalMode = 'exact' | 'prefix' | 'tool';
+export type ApprovalRuleTool = 'run_shell_mutate' | 'edit_file' | 'read_file' | 'list_files';
+export type ProjectApprovalRule = {
+    tool: ApprovalRuleTool;
+    mode: ApprovalMode;
+    command: string;
+    scope: RunShellScope | 'workspace' | 'outside_workspace';
+    capability: RunShellCapability | 'file_edit' | 'file_inspection';
+    createdAt: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/core/approvals/remembered-rules/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/core/approvals/remembered-rules/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,kDAAkD,CAAC;AAE1G,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEvD,MAAM,MAAM,gBAAgB,GAAG,kBAAkB,GAAG,WAAW,GAAG,WAAW,GAAG,YAAY,CAAC;AAE7F,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,aAAa,GAAG,WAAW,GAAG,mBAAmB,CAAC;IACzD,UAAU,EAAE,kBAAkB,GAAG,WAAW,GAAG,iBAAiB,CAAC;IACjE,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC"}

package/dist/src/core/approvals/remembered-rules/types.js

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

package/dist/src/core/approvals/remembered-rules/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/core/approvals/remembered-rules/types.ts"],"names":[],"mappings":""}

package/dist/src/core/approvals/service.d.ts

@@ -0,0 +1,13 @@
+import type { EvaluateToolApprovalPoliciesArgs, ResolveToolApprovalArgs, ToolApprovalDecision, ToolApprovalPolicyDecision } from './types.js';
+/**
+ * Owns ordered approval-policy resolution for one tool call.
+ *
+ * Policies may allow, deny, request a human decision, or abstain. This service
+ * preserves that policy-chain behavior without owning host UI or remembered
+ * approval storage.
+ */
+export declare class ToolApprovalService {
+    static evaluate(args: EvaluateToolApprovalPoliciesArgs): Promise<ToolApprovalPolicyDecision | undefined>;
+    static resolve(args: ResolveToolApprovalArgs): Promise<ToolApprovalDecision>;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/src/core/approvals/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../src/core/approvals/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gCAAgC,EAChC,uBAAuB,EACvB,oBAAoB,EACpB,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AAEpB;;;;;;GAMG;AACH,qBAAa,mBAAmB;WACjB,QAAQ,CAAC,IAAI,EAAE,gCAAgC,GAAG,OAAO,CAAC,0BAA0B,GAAG,SAAS,CAAC;WAWjG,OAAO,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAiCnF"}

package/dist/src/core/approvals/service.js

@@ -0,0 +1,45 @@
+/**
+ * Owns ordered approval-policy resolution for one tool call.
+ *
+ * Policies may allow, deny, request a human decision, or abstain. This service
+ * preserves that policy-chain behavior without owning host UI or remembered
+ * approval storage.
+ */
+export class ToolApprovalService {
+    static async evaluate(args) {
+        for (const policy of args.policies) {
+            const decision = await policy(args.context);
+            if (decision) {
+                return decision;
+            }
+        }
+        return undefined;
+    }
+    static async resolve(args) {
+        let requestReason;
+        for (const policy of args.policies) {
+            const decision = await policy(args.context);
+            if (!decision) {
+                continue;
+            }
+            if (decision.type === 'deny') {
+                return { approved: false, reason: decision.reason };
+            }
+            if (decision.type === 'allow') {
+                return { approved: true, reason: decision.reason };
+            }
+            requestReason ??= decision.reason;
+        }
+        if (!requestReason) {
+            return { approved: true };
+        }
+        if (!args.requestHumanApproval) {
+            return {
+                approved: false,
+                reason: `No approval handler configured for ${args.context.call.tool}${requestReason ? `: ${requestReason}` : ''}`,
+            };
+        }
+        return args.requestHumanApproval(args.context, requestReason);
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/src/core/approvals/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../../../src/core/approvals/service.ts"],"names":[],"mappings":"AAOA;;;;;;GAMG;AACH,MAAM,OAAO,mBAAmB;IAC9B,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAsC;QAC1D,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC5C,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,QAAQ,CAAC;YAClB,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAA6B;QAChD,IAAI,aAAiC,CAAC;QAEtC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC5C,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,SAAS;YACX,CAAC;YAED,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC7B,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;YACtD,CAAC;YAED,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBAC9B,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;YACrD,CAAC;YAED,aAAa,KAAK,QAAQ,CAAC,MAAM,CAAC;QACpC,CAAC;QAED,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC5B,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC/B,OAAO;gBACL,QAAQ,EAAE,KAAK;gBACf,MAAM,EAAE,sCAAsC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,KAAK,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;aACnH,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAChE,CAAC;CACF"}

package/dist/src/core/approvals/types.d.ts

@@ -1,4 +1,4 @@
-import type { ToolCall, ToolDefinition } from '../types.js';
+import type { ToolCall, ToolDefinition } from '../../core/types.js';
 export type ToolApprovalDecision = {
     approved: boolean;
     reason?: string;
@@ -20,4 +20,27 @@ export type ToolApprovalPolicyContext = {
 };
 export type ToolApprovalPolicy = (context: ToolApprovalPolicyContext) => ToolApprovalPolicyDecision | undefined | Promise<ToolApprovalPolicyDecision | undefined>;
 export type ToolApprovalSurface = (context: ToolApprovalPolicyContext) => Promise<ToolApprovalDecision>;
+export type EvaluateToolApprovalPoliciesArgs = {
+    policies: ToolApprovalPolicy[];
+    context: ToolApprovalPolicyContext;
+};
+export type ResolveToolApprovalArgs = EvaluateToolApprovalPoliciesArgs & {
+    requestHumanApproval?: (context: ToolApprovalPolicyContext, reason?: string) => Promise<ToolApprovalDecision>;
+};
+export type PendingToolApprovalView = {
+    tool: string;
+    callId: string;
+    input: unknown;
+    requestedAt: string;
+};
+export type RequestPendingToolApprovalArgs = {
+    call: ToolCall;
+    tool: ToolDefinition;
+    createView?: (call: ToolCall, tool: ToolDefinition) => PendingToolApprovalView;
+    publish?: (view: PendingToolApprovalView, call: ToolCall, tool: ToolDefinition) => void;
+    storePending?: (pending: {
+        view: PendingToolApprovalView;
+        resolve: (decision: ToolApprovalDecision) => void;
+    }) => void;
+};
 //# sourceMappingURL=types.d.ts.map

package/dist/src/core/approvals/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/core/approvals/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE5D,MAAM,MAAM,oBAAoB,GAAG;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1E,MAAM,MAAM,0BAA0B,GAClC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,cAAc,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAC/B,OAAO,EAAE,yBAAyB,KAC/B,0BAA0B,GAAG,SAAS,GAAG,OAAO,CAAC,0BAA0B,GAAG,SAAS,CAAC,CAAC;AAE9F,MAAM,MAAM,mBAAmB,GAAG,CAChC,OAAO,EAAE,yBAAyB,KAC/B,OAAO,CAAC,oBAAoB,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/core/approvals/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEhE,MAAM,MAAM,oBAAoB,GAAG;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1E,MAAM,MAAM,0BAA0B,GAClC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,cAAc,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAC/B,OAAO,EAAE,yBAAyB,KAC/B,0BAA0B,GAAG,SAAS,GAAG,OAAO,CAAC,0BAA0B,GAAG,SAAS,CAAC,CAAC;AAE9F,MAAM,MAAM,mBAAmB,GAAG,CAChC,OAAO,EAAE,yBAAyB,KAC/B,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAEnC,MAAM,MAAM,gCAAgC,GAAG;IAC7C,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,OAAO,EAAE,yBAAyB,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,gCAAgC,GAAG;IACvE,oBAAoB,CAAC,EAAE,CAAC,OAAO,EAAE,yBAAyB,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAC/G,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,cAAc,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,KAAK,uBAAuB,CAAC;IAC/E,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;IACxF,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,uBAAuB,CAAC;QAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,oBAAoB,KAAK,IAAI,CAAA;KAAE,KAAK,IAAI,CAAC;CACxH,CAAC"}

package/dist/src/core/chat/engine/compaction/constants.d.ts

@@ -0,0 +1,15 @@
+export declare const DEFAULT_CONTEXT_WINDOW_ESTIMATE = 200000;
+export declare const MAX_HISTORY_RATIO = 0.6;
+export declare const MAX_RECENT_HISTORY_RATIO = 0.18;
+export declare const MIN_RECENT_HISTORY_TOKEN_BUDGET = 8000;
+export declare const MAX_RECENT_HISTORY_TOKEN_BUDGET = 120000;
+export declare const PREFERRED_RECENT_MESSAGES = 12;
+export declare const PREFERRED_FORCED_RECENT_MESSAGES = 3;
+export declare const MAX_ROLLING_SUMMARY_CHARS = 12000;
+export declare const MAX_SUMMARIZER_CONTEXT_RATIO = 0.12;
+export declare const MAX_SUMMARIZER_TRANSCRIPT_TOKENS = 32000;
+export declare const MAX_SUMMARIZER_TRANSCRIPT_CHARS = 96000;
+export declare const MAX_SUMMARIZER_MESSAGE_CHARS = 2000;
+export declare const MIN_SUMMARIZER_MESSAGE_CHARS = 80;
+export declare const COMPACTED_HISTORY_MARKER = "Heddle compacted earlier conversation history.";
+//# sourceMappingURL=constants.d.ts.map

package/dist/src/core/chat/engine/compaction/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../../src/core/chat/engine/compaction/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,+BAA+B,SAAU,CAAC;AACvD,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAC7C,eAAO,MAAM,+BAA+B,OAAQ,CAAC;AACrD,eAAO,MAAM,+BAA+B,SAAU,CAAC;AACvD,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAC5C,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAClD,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAChD,eAAO,MAAM,4BAA4B,OAAO,CAAC;AACjD,eAAO,MAAM,gCAAgC,QAAS,CAAC;AACvD,eAAO,MAAM,+BAA+B,QAAS,CAAC;AACtD,eAAO,MAAM,4BAA4B,OAAQ,CAAC;AAClD,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAC/C,eAAO,MAAM,wBAAwB,mDAAmD,CAAC"}

package/dist/src/core/chat/engine/compaction/constants.js

@@ -0,0 +1,15 @@
+export const DEFAULT_CONTEXT_WINDOW_ESTIMATE = 200_000;
+export const MAX_HISTORY_RATIO = 0.6;
+export const MAX_RECENT_HISTORY_RATIO = 0.18;
+export const MIN_RECENT_HISTORY_TOKEN_BUDGET = 8_000;
+export const MAX_RECENT_HISTORY_TOKEN_BUDGET = 120_000;
+export const PREFERRED_RECENT_MESSAGES = 12;
+export const PREFERRED_FORCED_RECENT_MESSAGES = 3;
+export const MAX_ROLLING_SUMMARY_CHARS = 12_000;
+export const MAX_SUMMARIZER_CONTEXT_RATIO = 0.12;
+export const MAX_SUMMARIZER_TRANSCRIPT_TOKENS = 32_000;
+export const MAX_SUMMARIZER_TRANSCRIPT_CHARS = 96_000;
+export const MAX_SUMMARIZER_MESSAGE_CHARS = 2_000;
+export const MIN_SUMMARIZER_MESSAGE_CHARS = 80;
+export const COMPACTED_HISTORY_MARKER = 'Heddle compacted earlier conversation history.';
+//# sourceMappingURL=constants.js.map

package/dist/src/core/chat/engine/compaction/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../../src/core/chat/engine/compaction/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,+BAA+B,GAAG,OAAO,CAAC;AACvD,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AACrC,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AAC7C,MAAM,CAAC,MAAM,+BAA+B,GAAG,KAAK,CAAC;AACrD,MAAM,CAAC,MAAM,+BAA+B,GAAG,OAAO,CAAC;AACvD,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAC;AAC5C,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC;AAClD,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC;AAChD,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,CAAC;AACjD,MAAM,CAAC,MAAM,gCAAgC,GAAG,MAAM,CAAC;AACvD,MAAM,CAAC,MAAM,+BAA+B,GAAG,MAAM,CAAC;AACtD,MAAM,CAAC,MAAM,4BAA4B,GAAG,KAAK,CAAC;AAClD,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,CAAC;AAC/C,MAAM,CAAC,MAAM,wBAAwB,GAAG,gDAAgD,CAAC"}

package/dist/src/core/chat/engine/compaction/context-builder.d.ts

@@ -0,0 +1,10 @@
+import type { ChatContextStats } from '../../../../core/chat/types.js';
+import type { BuildSessionCompactionRunningContextOptions, ConversationCompactionContextInput } from './types.js';
+/**
+ * Projects compaction-owned runtime state into persisted session context stats.
+ */
+export declare class ConversationCompactionContextBuilder {
+    static buildSessionRunning(options: BuildSessionCompactionRunningContextOptions): ChatContextStats;
+    static build(input: ConversationCompactionContextInput): ChatContextStats;
+}
+//# sourceMappingURL=context-builder.d.ts.map

package/dist/src/core/chat/engine/compaction/context-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-builder.d.ts","sourceRoot":"","sources":["../../../../../../src/core/chat/engine/compaction/context-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,KAAK,EACV,2CAA2C,EAC3C,kCAAkC,EACnC,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,qBAAa,oCAAoC;IAC/C,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,2CAA2C,GAAG,gBAAgB;IAmBlG,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,kCAAkC,GAAG,gBAAgB;CAuB1E"}

package/dist/src/core/chat/engine/compaction/context-builder.js

@@ -0,0 +1,47 @@
+import { ConversationCompactionTokenEstimator } from './token-estimator.js';
+/**
+ * Projects compaction-owned runtime state into persisted session context stats.
+ */
+export class ConversationCompactionContextBuilder {
+    static buildSessionRunning(options) {
+        const previous = options.session.context;
+        return {
+            ...previous,
+            estimatedHistoryTokens: ConversationCompactionTokenEstimator.estimateHistory(options.history ?? options.session.history),
+            request: previous?.request,
+            compaction: {
+                ...previous?.compaction,
+                status: 'running',
+                error: undefined,
+            },
+            archive: {
+                count: options.session.archives?.length ?? previous?.archive?.count,
+                currentSummaryPath: previous?.archive?.currentSummaryPath,
+                lastArchivePath: options.lastArchivePath ?? previous?.archive?.lastArchivePath,
+            },
+        };
+    }
+    static build(input) {
+        return {
+            estimatedHistoryTokens: ConversationCompactionTokenEstimator.estimateHistory(input.history),
+            request: {
+                ...input.request,
+                estimatedTokens: ConversationCompactionTokenEstimator.estimateRequest(input),
+            },
+            compaction: {
+                compactedMessages: input.completed?.compactedMessages && input.completed.compactedMessages > 0
+                    ? input.completed.compactedMessages
+                    : undefined,
+                compactedAt: input.completed?.compactedAt,
+                status: input.status?.state ?? 'idle',
+                error: input.status?.error,
+            },
+            archive: {
+                count: input.archive.archives.length || undefined,
+                currentSummaryPath: input.archive.currentSummaryPath,
+                lastArchivePath: input.completed?.lastArchivePath ?? input.archive.lastArchivePath,
+            },
+        };
+    }
+}
+//# sourceMappingURL=context-builder.js.map

package/dist/src/core/chat/engine/compaction/context-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-builder.js","sourceRoot":"","sources":["../../../../../../src/core/chat/engine/compaction/context-builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oCAAoC,EAAE,MAAM,sBAAsB,CAAC;AAM5E;;GAEG;AACH,MAAM,OAAO,oCAAoC;IAC/C,MAAM,CAAC,mBAAmB,CAAC,OAAoD;QAC7E,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;QACzC,OAAO;YACL,GAAG,QAAQ;YACX,sBAAsB,EAAE,oCAAoC,CAAC,eAAe,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;YACxH,OAAO,EAAE,QAAQ,EAAE,OAAO;YAC1B,UAAU,EAAE;gBACV,GAAG,QAAQ,EAAE,UAAU;gBACvB,MAAM,EAAE,SAAS;gBACjB,KAAK,EAAE,SAAS;aACjB;YACD,OAAO,EAAE;gBACP,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,QAAQ,EAAE,OAAO,EAAE,KAAK;gBACnE,kBAAkB,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB;gBACzD,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,QAAQ,EAAE,OAAO,EAAE,eAAe;aAC/E;SACF,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,KAAyC;QACpD,OAAO;YACL,sBAAsB,EAAE,oCAAoC,CAAC,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC;YAC3F,OAAO,EAAE;gBACP,GAAG,KAAK,CAAC,OAAO;gBAChB,eAAe,EAAE,oCAAoC,CAAC,eAAe,CAAC,KAAK,CAAC;aAC7E;YACD,UAAU,EAAE;gBACV,iBAAiB,EACf,KAAK,CAAC,SAAS,EAAE,iBAAiB,IAAI,KAAK,CAAC,SAAS,CAAC,iBAAiB,GAAG,CAAC;oBACzE,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,iBAAiB;oBACnC,CAAC,CAAC,SAAS;gBACf,WAAW,EAAE,KAAK,CAAC,SAAS,EAAE,WAAW;gBACzC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,MAAM;gBACrC,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK;aAC3B;YACD,OAAO,EAAE;gBACP,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,IAAI,SAAS;gBACjD,kBAAkB,EAAE,KAAK,CAAC,OAAO,CAAC,kBAAkB;gBACpD,eAAe,EAAE,KAAK,CAAC,SAAS,EAAE,eAAe,IAAI,KAAK,CAAC,OAAO,CAAC,eAAe;aACnF;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/src/core/chat/engine/compaction/index.d.ts

@@ -0,0 +1,3 @@
+export { ConversationCompactionService } from './service.js';
+export type { BuildSessionCompactionRunningContextOptions, ConversationCompactionArchiveState, ConversationCompactionCompletedArchive, ConversationCompactionContextInput, ConversationCompactionOptions, ConversationCompactionRequest, ConversationCompactionResult, ConversationCompactionRuntime, ConversationCompactionSummarizerOptions, ConversationCompactionStatus, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/chat/engine/compaction/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/core/chat/engine/compaction/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAC7D,YAAY,EACV,2CAA2C,EAC3C,kCAAkC,EAClC,sCAAsC,EACtC,kCAAkC,EAClC,6BAA6B,EAC7B,6BAA6B,EAC7B,4BAA4B,EAC5B,6BAA6B,EAC7B,uCAAuC,EACvC,4BAA4B,GAC7B,MAAM,YAAY,CAAC"}

package/dist/src/core/chat/engine/compaction/index.js

@@ -0,0 +1,2 @@
+export { ConversationCompactionService } from './service.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/chat/engine/compaction/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/core/chat/engine/compaction/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC"}

package/dist/src/core/chat/engine/compaction/service.d.ts

@@ -0,0 +1,21 @@
+import type { BuildSessionCompactionRunningContextOptions, ConversationCompactionOptions, ConversationCompactionResult } from './types.js';
+/**
+ * Main compaction service.
+ *
+ * Owns archive-backed conversation history compaction. Supporting classes in
+ * this folder own token estimates, split policy, summary message rendering,
+ * summarizer prompting, and persisted context projection.
+ */
+export declare class ConversationCompactionService {
+    static compact(options: ConversationCompactionOptions): Promise<ConversationCompactionResult>;
+    static estimateTokens(history: ConversationCompactionOptions['history']): number;
+    static isCompactedHistorySummary(message: ConversationCompactionOptions['history'][number]): boolean;
+    static buildSessionRunningContext(options: BuildSessionCompactionRunningContextOptions): import("../../../../core/chat/types.js").ChatContextStats;
+    private static buildUnchangedResult;
+    private static compactArchivedSlice;
+    private static buildArchiveRecord;
+    private static buildCompactedResult;
+    private static buildFailedResult;
+    private static createArchiveRepository;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/src/core/chat/engine/compaction/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../../../src/core/chat/engine/compaction/service.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACV,2CAA2C,EAE3C,6BAA6B,EAC7B,4BAA4B,EAC7B,MAAM,YAAY,CAAC;AAEpB;;;;;;GAMG;AACH,qBAAa,6BAA6B;WAC3B,OAAO,CAClB,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,4BAA4B,CAAC;IAyBxC,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,6BAA6B,CAAC,SAAS,CAAC,GAAG,MAAM;IAIhF,MAAM,CAAC,yBAAyB,CAAC,OAAO,EAAE,6BAA6B,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,GAAG,OAAO;IAIpG,MAAM,CAAC,0BAA0B,CAAC,OAAO,EAAE,2CAA2C;IAItF,OAAO,CAAC,MAAM,CAAC,oBAAoB;mBAmBd,oBAAoB;IAoFzC,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAmBjC,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAuBnC,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAqBhC,OAAO,CAAC,MAAM,CAAC,uBAAuB;CAMvC"}