@roackb2/heddle 0.0.37 → 1.0.0

package/dist/src/core/approvals/default-policies.js

@@ -0,0 +1,37 @@
+import { isAbsolute, relative, resolve } from 'node:path';
+export const toolRequiresApprovalPolicy = ({ tool }) => tool.requiresApproval ? { type: 'request', reason: `${tool.name} requires approval` } : undefined;
+export const outsideWorkspaceInspectionPolicy = ({ call, workspaceRoot }) => isOutsideWorkspaceInspectionCall(call, workspaceRoot) ?
+    { type: 'request', reason: `${call.tool} targets a path outside the workspace` }
+    : undefined;
+export function rememberedApprovalPolicy(args) {
+    return (context) => args.isApproved(context) ?
+        { type: 'allow', reason: args.reason ?? 'Approved by saved project rule' }
+        : undefined;
+}
+export const defaultToolApprovalPolicies = [
+    toolRequiresApprovalPolicy,
+    outsideWorkspaceInspectionPolicy,
+];
+export function isOutsideWorkspaceInspectionCall(contextOrCall, workspaceRoot = process.cwd()) {
+    const call = 'call' in contextOrCall ? contextOrCall.call : contextOrCall;
+    if (!['read_file', 'list_files', 'search_files', 'edit_file'].includes(call.tool)) {
+        return false;
+    }
+    const input = call.input;
+    if (!input || typeof input !== 'object' || Array.isArray(input)) {
+        return false;
+    }
+    const record = input;
+    const rawPath = typeof record.path === 'string'
+        ? record.path
+        : call.tool === 'search_files' ? '.'
+            : undefined;
+    if (!rawPath) {
+        return false;
+    }
+    const resolvedWorkspaceRoot = resolve(workspaceRoot);
+    const resolvedTarget = resolve(resolvedWorkspaceRoot, rawPath);
+    const relativeTarget = relative(resolvedWorkspaceRoot, resolvedTarget);
+    return relativeTarget.startsWith('..') || isAbsolute(relativeTarget);
+}
+//# sourceMappingURL=default-policies.js.map

package/dist/src/core/approvals/default-policies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-policies.js","sourceRoot":"","sources":["../../../../src/core/approvals/default-policies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAM1D,MAAM,CAAC,MAAM,0BAA0B,GAAuB,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CACzE,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAEpG,MAAM,CAAC,MAAM,gCAAgC,GAAuB,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,CAC9F,gCAAgC,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC;IACrD,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,uCAAuC,EAAE;IAClF,CAAC,CAAC,SAAS,CAAC;AAEd,MAAM,UAAU,wBAAwB,CAAC,IAGxC;IACC,OAAO,CAAC,OAAO,EAAE,EAAE,CACjB,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;QACxB,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,gCAAgC,EAAE;QAC5E,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,MAAM,2BAA2B,GAAyB;IAC/D,0BAA0B;IAC1B,gCAAgC;CACjC,CAAC;AAEF,MAAM,UAAU,gCAAgC,CAC9C,aAA4E,EAC5E,aAAa,GAAG,OAAO,CAAC,GAAG,EAAE;IAE7B,MAAM,IAAI,GAAG,MAAM,IAAI,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC;IAC1E,IAAI,CAAC,CAAC,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAClF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACzB,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,OAAO,GAAG,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;QAC7C,CAAC,CAAC,MAAM,CAAC,IAAI;QACb,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC,CAAC,GAAG;YACpC,CAAC,CAAC,SAAS,CAAC;IACd,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,qBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACrD,MAAM,cAAc,GAAG,OAAO,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC;IAC/D,MAAM,cAAc,GAAG,QAAQ,CAAC,qBAAqB,EAAE,cAAc,CAAC,CAAC;IACvE,OAAO,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,cAAc,CAAC,CAAC;AACvE,CAAC"}

package/dist/src/core/approvals/policy-chain.d.ts

@@ -0,0 +1,9 @@
+import type { ToolApprovalDecision, ToolApprovalPolicy, ToolApprovalPolicyContext, ToolApprovalPolicyDecision } from './types.js';
+export declare function evaluateToolApprovalPolicies(policies: ToolApprovalPolicy[], context: ToolApprovalPolicyContext): Promise<ToolApprovalPolicyDecision | undefined>;
+export type ResolveToolApprovalArgs = {
+    policies: ToolApprovalPolicy[];
+    context: ToolApprovalPolicyContext;
+    requestHumanApproval?: (context: ToolApprovalPolicyContext, reason?: string) => Promise<ToolApprovalDecision>;
+};
+export declare function resolveToolApproval(args: ResolveToolApprovalArgs): Promise<ToolApprovalDecision>;
+//# sourceMappingURL=policy-chain.d.ts.map

package/dist/src/core/approvals/policy-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy-chain.d.ts","sourceRoot":"","sources":["../../../../src/core/approvals/policy-chain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EAClB,yBAAyB,EACzB,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AAEpB,wBAAsB,4BAA4B,CAChD,QAAQ,EAAE,kBAAkB,EAAE,EAC9B,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,0BAA0B,GAAG,SAAS,CAAC,CASjD;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,OAAO,EAAE,yBAAyB,CAAC;IACnC,oBAAoB,CAAC,EAAE,CAAC,OAAO,EAAE,yBAAyB,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAC/G,CAAC;AAEF,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAgCtG"}

package/dist/src/core/approvals/policy-chain.js

@@ -0,0 +1,36 @@
+export async function evaluateToolApprovalPolicies(policies, context) {
+    for (const policy of policies) {
+        const decision = await policy(context);
+        if (decision) {
+            return decision;
+        }
+    }
+    return undefined;
+}
+export async function resolveToolApproval(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=policy-chain.js.map

package/dist/src/core/approvals/policy-chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy-chain.js","sourceRoot":"","sources":["../../../../src/core/approvals/policy-chain.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,QAA8B,EAC9B,OAAkC;IAElC,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAQD,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAA6B;IACrE,IAAI,aAAiC,CAAC;IAEtC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,SAAS;QACX,CAAC;QAED,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC7B,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;QACtD,CAAC;QAED,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC9B,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;QACrD,CAAC;QAED,aAAa,KAAK,QAAQ,CAAC,MAAM,CAAC;IACpC,CAAC;IAED,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC5B,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC/B,OAAO;YACL,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,sCAAsC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,KAAK,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;SACnH,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;AAChE,CAAC"}

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

@@ -0,0 +1,21 @@
+import type { ToolCall } from '../types.js';
+import { type RunShellCapability, type RunShellScope } from '../tools/toolkits/shell-process/run-shell.js';
+type ApprovalMode = 'exact' | 'prefix' | 'tool';
+export type ProjectApprovalRule = {
+    tool: 'run_shell_mutate' | 'edit_file';
+    mode: ApprovalMode;
+    command: string;
+    scope: RunShellScope | 'workspace';
+    capability: RunShellCapability | 'file_edit';
+    createdAt: string;
+};
+export declare function loadProjectApprovalRules(filePath: string): ProjectApprovalRule[];
+export declare function saveProjectApprovalRules(filePath: string, rules: ProjectApprovalRule[]): void;
+export declare function normalizeApprovedCommand(command: string): string;
+export declare function findMatchingApprovalRule(rules: ProjectApprovalRule[], tool: string, input: unknown): ProjectApprovalRule | undefined;
+export declare function createProjectApprovalRule(command: string): ProjectApprovalRule;
+export declare function createProjectApprovalRuleForCall(call: ToolCall): ProjectApprovalRule | undefined;
+export declare function describeProjectApprovalRule(rule: ProjectApprovalRule): string;
+export declare function extractApprovalTarget(tool: string, input: unknown): string | undefined;
+export {};
+//# sourceMappingURL=remembered-rules.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"remembered-rules.d.ts","sourceRoot":"","sources":["../../../../src/core/approvals/remembered-rules.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,aAAa,EACnB,MAAM,8CAA8C,CAAC;AAEtD,KAAK,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEhD,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,kBAAkB,GAAG,WAAW,CAAC;IACvC,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,aAAa,GAAG,WAAW,CAAC;IACnC,UAAU,EAAE,kBAAkB,GAAG,WAAW,CAAC;IAC7C,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAoBhF;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,EAAE,QAGtF;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,mBAAmB,EAAE,EAC5B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,GACb,mBAAmB,GAAG,SAAS,CAqBjC;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAE9E;AAED,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,QAAQ,GAAG,mBAAmB,GAAG,SAAS,CAkBhG;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CAU7E;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CA4BtF"}

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

@@ -0,0 +1,257 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { classifyShellCommandPolicy, DEFAULT_MUTATE_RULES, } from '../tools/toolkits/shell-process/run-shell.js';
+export function loadProjectApprovalRules(filePath) {
+    try {
+        if (!existsSync(filePath)) {
+            return [];
+        }
+        const raw = readFileSync(filePath, 'utf8');
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed)) {
+            return [];
+        }
+        const rules = parsed.flatMap((value) => parseProjectApprovalRule(value));
+        return dedupeApprovalRules(rules);
+    }
+    catch (error) {
+        process.stderr.write(`Failed to load project approval rules from ${filePath}: ${error instanceof Error ? error.message : String(error)}\n`);
+        return [];
+    }
+}
+export function saveProjectApprovalRules(filePath, rules) {
+    mkdirSync(dirname(filePath), { recursive: true });
+    writeFileSync(filePath, `${JSON.stringify(rules, null, 2)}\n`);
+}
+export function normalizeApprovedCommand(command) {
+    return canonicalizeVerificationCommand(command.trim().replace(/\s+/g, ' '));
+}
+export function findMatchingApprovalRule(rules, tool, input) {
+    const target = extractApprovalTarget(tool, input);
+    if (!target) {
+        return undefined;
+    }
+    return rules.find((rule) => {
+        if (rule.tool !== 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;
+    });
+}
+export function createProjectApprovalRule(command) {
+    return createShellApprovalRule(normalizeApprovedCommand(command));
+}
+export function createProjectApprovalRuleForCall(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 !== 'run_shell_mutate') {
+        return undefined;
+    }
+    const target = extractApprovalTarget(call.tool, call.input);
+    return target ? createShellApprovalRule(target) : undefined;
+}
+export function describeProjectApprovalRule(rule) {
+    if (rule.tool === 'edit_file') {
+        return 'allow edit_file for this project';
+    }
+    if (rule.mode === 'prefix') {
+        return `allow ${rule.command} command family for this project`;
+    }
+    return `allow exact command ${rule.command} for this project`;
+}
+export function extractApprovalTarget(tool, input) {
+    if (tool === 'run_shell_mutate') {
+        if (typeof input === 'string') {
+            return normalizeApprovedCommand(input);
+        }
+        if (!input || typeof input !== 'object' || Array.isArray(input)) {
+            return undefined;
+        }
+        const command = input.command;
+        return typeof command === 'string' && command.trim() ? normalizeApprovedCommand(command) : undefined;
+    }
+    if (tool === 'edit_file') {
+        if (typeof input === 'string') {
+            return normalizeApprovalPath(input);
+        }
+        if (!input || typeof input !== 'object' || Array.isArray(input)) {
+            return undefined;
+        }
+        const path = input.path;
+        return typeof path === 'string' && path.trim() ? normalizeApprovalPath(path) : undefined;
+    }
+    return undefined;
+}
+function createShellApprovalRule(command) {
+    const policy = classifyShellCommandPolicy(command, {
+        toolName: 'run_shell_mutate',
+        rules: DEFAULT_MUTATE_RULES,
+        allowUnknown: true,
+    });
+    if (!('error' in policy) && shouldUseVerificationPrefixApproval(command, policy.scope, policy.capability)) {
+        return {
+            tool: 'run_shell_mutate',
+            mode: 'prefix',
+            command: 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(),
+    };
+}
+function shouldUseVerificationPrefixApproval(command, scope, capability) {
+    if (scope !== 'workspace' || capability !== 'verification') {
+        return false;
+    }
+    return buildVerificationPrefix(command) !== command;
+}
+function 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;
+}
+function 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;
+}
+function normalizeApprovalPath(path) {
+    const trimmed = path.trim();
+    if (trimmed === './' || trimmed === '.') {
+        return '.';
+    }
+    return trimmed.replace(/\/+$/, '') || '.';
+}
+function 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;
+}
+function parseProjectApprovalRule(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return [];
+    }
+    const candidate = value;
+    if (candidate.tool === 'run_shell_mutate' && typeof candidate.command === 'string' && typeof candidate.createdAt === 'string') {
+        if (candidate.mode === 'exact' || candidate.mode === 'prefix') {
+            return [{
+                    tool: 'run_shell_mutate',
+                    mode: candidate.mode,
+                    command: normalizeApprovedCommand(candidate.command),
+                    scope: candidate.scope === 'external' ? 'external' : candidate.scope === 'inspect' ? 'inspect' : 'workspace',
+                    capability: typeof candidate.capability === 'string' ? candidate.capability : 'unknown_workspace',
+                    createdAt: candidate.createdAt,
+                }];
+        }
+        const normalizedCommand = normalizeApprovedCommand(candidate.command);
+        const legacyVerificationPrefix = buildLegacyVerificationPrefix(normalizedCommand);
+        if (legacyVerificationPrefix) {
+            return [{
+                    tool: 'run_shell_mutate',
+                    mode: 'prefix',
+                    command: legacyVerificationPrefix,
+                    scope: 'workspace',
+                    capability: 'verification',
+                    createdAt: candidate.createdAt,
+                }];
+        }
+        const migrated = createShellApprovalRule(normalizedCommand);
+        return [{ ...migrated, createdAt: candidate.createdAt }];
+    }
+    if (candidate.tool === 'edit_file' && typeof candidate.createdAt === 'string') {
+        if (candidate.mode === 'tool') {
+            return [{
+                    tool: 'edit_file',
+                    mode: 'tool',
+                    command: '*',
+                    scope: 'workspace',
+                    capability: 'file_edit',
+                    createdAt: candidate.createdAt,
+                }];
+        }
+    }
+    return [];
+}
+function dedupeApprovalRules(rules) {
+    const seen = new Set();
+    return rules.filter((rule) => {
+        const key = `${rule.tool}:${rule.mode}:${rule.command}`;
+        if (seen.has(key)) {
+            return false;
+        }
+        seen.add(key);
+        return true;
+    });
+}
+//# sourceMappingURL=remembered-rules.js.map

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

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

package/dist/src/core/{chat/tool-approval-host.d.ts → approvals/surface.d.ts}

@@ -1,8 +1,5 @@
-import type { ToolCall, ToolDefinition } from '../../index.js';
-export type ToolApprovalDecision = {
-    approved: boolean;
-    reason?: string;
-};
+import type { ToolCall, ToolDefinition } from '../types.js';
+import type { ToolApprovalDecision, ToolApprovalPolicy, ToolApprovalSurface } from './types.js';
 export type PendingToolApprovalView = {
     tool: string;
     callId: string;
@@ -19,4 +16,5 @@ export declare function requestToolApproval(args: {
         resolve: (decision: ToolApprovalDecision) => void;
     }) => void;
 }): Promise<ToolApprovalDecision>;
-//# sourceMappingURL=tool-approval-host.d.ts.map
+export declare function humanApprovalPolicy(surface: ToolApprovalSurface): ToolApprovalPolicy;
+//# sourceMappingURL=surface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"surface.d.ts","sourceRoot":"","sources":["../../../../src/core/approvals/surface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB,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,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,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,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAchC;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB,CAOpF"}

package/dist/src/core/{chat/tool-approval-host.js → approvals/surface.js}

@@ -11,4 +11,12 @@ export function requestToolApproval(args) {
         args.publish?.(view, args.call, args.tool);
     });
 }
-//# sourceMappingURL=tool-approval-host.js.map
+export function humanApprovalPolicy(surface) {
+    return async (context) => {
+        const decision = await surface(context);
+        return decision.approved ?
+            { type: 'allow', reason: decision.reason }
+            : { type: 'deny', reason: decision.reason };
+    };
+}
+//# sourceMappingURL=surface.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"surface.js","sourceRoot":"","sources":["../../../../src/core/approvals/surface.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,mBAAmB,CAAC,IAMnC;IACC,MAAM,IAAI,GACR,IAAI,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC;WACpC;YACD,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;YACpB,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;YACpB,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK;YACtB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC,CAAC;IAEJ,OAAO,IAAI,OAAO,CAAuB,CAAC,OAAO,EAAE,EAAE;QACnD,IAAI,CAAC,YAAY,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAA4B;IAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE;QACvB,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;QACxC,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACtB,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE;YAC5C,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;IAChD,CAAC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,23 @@
+import type { ToolCall, ToolDefinition } from '../types.js';
+export type ToolApprovalDecision = {
+    approved: boolean;
+    reason?: string;
+};
+export type ToolApprovalPolicyDecision = {
+    type: 'allow';
+    reason?: string;
+} | {
+    type: 'deny';
+    reason?: string;
+} | {
+    type: 'request';
+    reason?: string;
+};
+export type ToolApprovalPolicyContext = {
+    call: ToolCall;
+    tool: ToolDefinition;
+    workspaceRoot?: string;
+};
+export type ToolApprovalPolicy = (context: ToolApprovalPolicyContext) => ToolApprovalPolicyDecision | undefined | Promise<ToolApprovalPolicyDecision | undefined>;
+export type ToolApprovalSurface = (context: ToolApprovalPolicyContext) => Promise<ToolApprovalDecision>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +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"}

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

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

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

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

package/dist/src/core/chat/engine/config.d.ts

@@ -0,0 +1,22 @@
+import type { ToolApprovalPolicy } from '../../approvals/types.js';
+import type { TraceSummarizerRegistry } from '../../observability/trace-summarizers.js';
+import type { ConversationEngineConfig } from './types.js';
+export type NormalizedConversationEngineConfig = {
+    workspaceRoot: string;
+    stateRoot: string;
+    model: string;
+    apiKey?: string;
+    preferApiKey?: boolean;
+    credentialStorePath?: string;
+    systemContext?: string;
+    memoryMaintenanceMode: 'none' | 'background' | 'inline';
+    traceSummarizerRegistry?: TraceSummarizerRegistry;
+    approvalPolicies?: ToolApprovalPolicy[];
+    sessionStoragePath: string;
+    memoryDir: string;
+    traceDir: string;
+    workspaceId?: string;
+    apiKeyPresent: boolean;
+};
+export declare function normalizeConversationEngineConfig(config: ConversationEngineConfig): NormalizedConversationEngineConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/src/core/chat/engine/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../../src/core/chat/engine/config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AACxF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE3D,MAAM,MAAM,kCAAkC,GAAG;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,MAAM,GAAG,YAAY,GAAG,QAAQ,CAAC;IACxD,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;IAClD,gBAAgB,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACxC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,wBAAwB,GAAG,kCAAkC,CAyBtH"}

package/dist/src/core/chat/engine/config.js

@@ -0,0 +1,27 @@
+import { join, resolve } from 'node:path';
+export function normalizeConversationEngineConfig(config) {
+    const workspaceRoot = resolve(config.workspaceRoot);
+    const stateRoot = resolve(config.stateRoot);
+    const sessionStoragePath = resolve(config.sessionStoragePath ?? join(stateRoot, 'chat-sessions.catalog.json'));
+    const memoryDir = resolve(config.memoryDir ?? join(stateRoot, 'memory'));
+    const traceDir = resolve(join(stateRoot, 'traces'));
+    const credentialStorePath = config.credentialStorePath ? resolve(config.credentialStorePath) : undefined;
+    return {
+        workspaceRoot,
+        stateRoot,
+        model: config.model,
+        apiKey: config.apiKey,
+        preferApiKey: config.preferApiKey,
+        credentialStorePath,
+        systemContext: config.systemContext,
+        memoryMaintenanceMode: config.memoryMaintenanceMode ?? 'background',
+        traceSummarizerRegistry: config.traceSummarizerRegistry,
+        approvalPolicies: config.approvalPolicies,
+        sessionStoragePath,
+        memoryDir,
+        traceDir,
+        workspaceId: config.workspaceId,
+        apiKeyPresent: config.apiKeyPresent ?? Boolean(config.apiKey),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/src/core/chat/engine/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../../src/core/chat/engine/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuB1C,MAAM,UAAU,iCAAiC,CAAC,MAAgC;IAChF,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,kBAAkB,IAAI,IAAI,CAAC,SAAS,EAAE,4BAA4B,CAAC,CAAC,CAAC;IAC/G,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;IACzE,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;IACpD,MAAM,mBAAmB,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEzG,OAAO;QACL,aAAa;QACb,SAAS;QACT,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,mBAAmB;QACnB,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,qBAAqB,EAAE,MAAM,CAAC,qBAAqB,IAAI,YAAY;QACnE,uBAAuB,EAAE,MAAM,CAAC,uBAAuB;QACvD,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,kBAAkB;QAClB,SAAS;QACT,QAAQ;QACR,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;KAC9D,CAAC;AACJ,CAAC"}

package/dist/src/core/chat/engine/conversation-engine.d.ts

@@ -0,0 +1,3 @@
+import type { ConversationEngine, ConversationEngineConfig } from './types.js';
+export declare function createConversationEngine(config: ConversationEngineConfig): ConversationEngine;
+//# sourceMappingURL=conversation-engine.d.ts.map

package/dist/src/core/chat/engine/conversation-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-engine.d.ts","sourceRoot":"","sources":["../../../../../src/core/chat/engine/conversation-engine.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE/E,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,wBAAwB,GAAG,kBAAkB,CAW7F"}

package/dist/src/core/chat/engine/conversation-engine.js

@@ -0,0 +1,15 @@
+import { normalizeConversationEngineConfig } from './config.js';
+import { createConversationSessionService } from './sessions/service.js';
+import { createConversationTurnService } from './turns/service.js';
+export function createConversationEngine(config) {
+    const normalizedConfig = normalizeConversationEngineConfig(config);
+    return {
+        sessions: createConversationSessionService({
+            config: normalizedConfig,
+        }),
+        turns: createConversationTurnService({
+            config: normalizedConfig,
+        }),
+    };
+}
+//# sourceMappingURL=conversation-engine.js.map

package/dist/src/core/chat/engine/conversation-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-engine.js","sourceRoot":"","sources":["../../../../../src/core/chat/engine/conversation-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iCAAiC,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,gCAAgC,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AAGnE,MAAM,UAAU,wBAAwB,CAAC,MAAgC;IACvE,MAAM,gBAAgB,GAAG,iCAAiC,CAAC,MAAM,CAAC,CAAC;IAEnE,OAAO;QACL,QAAQ,EAAE,gCAAgC,CAAC;YACzC,MAAM,EAAE,gBAAgB;SACzB,CAAC;QACF,KAAK,EAAE,6BAA6B,CAAC;YACnC,MAAM,EAAE,gBAAgB;SACzB,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/src/core/chat/{compaction.d.ts → engine/history/compaction.d.ts}

@@ -1,6 +1,6 @@
-import type { ChatMessage, LlmAdapter, LlmUsage } from '../llm/types.js';
-import { type ProviderCredentialSource } from '../runtime/api-keys.js';
-import type { ChatArchiveRecord, ChatContextStats } from './types.js';
+import type { ChatMessage, LlmAdapter, LlmUsage } from '../../../llm/types.js';
+import { type ProviderCredentialSource } from '../../../runtime/api-keys.js';
+import type { ChatArchiveRecord, ChatContextStats } from '../../types.js';
 export type CompactionSummarizerOptions = {
     provider?: 'openai' | 'anthropic' | 'active';
     model?: string;

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

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../../../../../src/core/chat/engine/history/compaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE/E,OAAO,EAAiG,KAAK,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAO5K,OAAO,KAAK,EAAuB,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AA2B/F,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,UAAU,CAAC;IACjB,gBAAgB,CAAC,EAAE,wBAAwB,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,oCAAoC,GAAG;IACjD,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,2BAA2B,CAAC;IACzC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAC7I,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B,CAAC;AAEF,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,oCAAoC,GAC5C,OAAO,CAAC,wBAAwB,CAAC,CAsJnC;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG;IAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IAAC,OAAO,EAAE,gBAAgB,CAAA;CAAE,CAwCxD;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAExE;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAEvE;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE;IACrD,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,gBAAgB,CAUnB"}

package/dist/src/core/chat/{compaction.js → engine/history/compaction.js}

@@ -1,8 +1,8 @@
-import { createLlmAdapter, inferProviderFromModel } from '../llm/factory.js';
-import { hasProviderCredentialForModel, resolveApiKeyForModel, resolveProviderCredentialSourceForModel } from '../runtime/api-keys.js';
-import { estimateBuiltInContextWindow } from '../llm/openai-models.js';
-import { credentialModeFromSource, resolveSystemSelectedModel, } from '../llm/model-policy.js';
-import { createArchiveId, deriveChatArchivePaths, loadChatArchiveManifest, readArchiveSummaryMarkdown, saveChatArchiveManifest, updateChatArchiveManifest, writeArchivedMessagesJsonl, writeArchiveSummaryMarkdown, } from './archive.js';
+import { createLlmAdapter, inferProviderFromModel } from '../../../llm/factory.js';
+import { hasProviderCredentialForModel, resolveApiKeyForModel, resolveProviderCredentialSourceForModel } from '../../../runtime/api-keys.js';
+import { estimateBuiltInContextWindow } from '../../../llm/openai-models.js';
+import { credentialModeFromSource, resolveSystemSelectedModel, } from '../../../llm/model-policy.js';
+import { createArchiveId, deriveChatArchivePaths, loadChatArchiveManifest, readArchiveSummaryMarkdown, saveChatArchiveManifest, updateChatArchiveManifest, writeArchivedMessagesJsonl, writeArchiveSummaryMarkdown, } from '../sessions/archive.js';
 const DEFAULT_CONTEXT_WINDOW_ESTIMATE = 200_000;
 const MAX_HISTORY_RATIO = 0.6;
 const MAX_RECENT_HISTORY_RATIO = 0.18;