turboflux 1.0.0

package/dist/core/contextPolicy.js

@@ -0,0 +1,39 @@
+export const CONTEXT_POLICY_PROFILES = {
+    normal: {
+        mode: 'normal',
+        targetRatio: 0.72,
+        keepRecentTurns: 10,
+        maxSegmentTokens: 16_000,
+        minTailTurns: 6,
+    },
+    qualityFirst: {
+        mode: 'qualityFirst',
+        targetRatio: 0.56,
+        keepRecentTurns: 14,
+        maxSegmentTokens: 24_000,
+        minTailTurns: 8,
+    },
+};
+export function resolveContextPolicyProfile(mode) {
+    return CONTEXT_POLICY_PROFILES[mode ?? 'normal'] ?? CONTEXT_POLICY_PROFILES.normal;
+}
+export const MAX_OUTPUT_TOKENS_FOR_COMPACTION = 20_000;
+export const NORMAL_AUTOCOMPACT_BUFFER_TOKENS = 13_000;
+export const QUALITY_AUTOCOMPACT_BUFFER_TOKENS = 28_000;
+export const WARNING_BUFFER_TOKENS = 20_000;
+export const MANUAL_COMPACT_BUFFER_TOKENS = 3_000;
+export function effectiveInputWindow(contextWindow, maxOutputTokens) {
+    const reservedOutput = Math.min(Math.max(0, maxOutputTokens || 0), MAX_OUTPUT_TOKENS_FOR_COMPACTION);
+    return Math.max(1_024, contextWindow - reservedOutput);
+}
+export function autoCompactThreshold(contextWindow, maxOutputTokens, mode) {
+    const effectiveWindow = effectiveInputWindow(contextWindow, maxOutputTokens);
+    const buffer = mode === 'qualityFirst'
+        ? Math.max(QUALITY_AUTOCOMPACT_BUFFER_TOKENS, Math.floor(effectiveWindow * 0.18))
+        : NORMAL_AUTOCOMPACT_BUFFER_TOKENS;
+    return Math.max(1_024, effectiveWindow - buffer);
+}
+export function blockingContextLimit(contextWindow, maxOutputTokens) {
+    return Math.max(1_024, effectiveInputWindow(contextWindow, maxOutputTokens) - MANUAL_COMPACT_BUFFER_TOKENS);
+}
+//# sourceMappingURL=contextPolicy.js.map

package/dist/core/contextPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextPolicy.js","sourceRoot":"","sources":["../../src/core/contextPolicy.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,MAAM,uBAAuB,GAAoD;IACtF,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,IAAI;QACjB,eAAe,EAAE,EAAE;QACnB,gBAAgB,EAAE,MAAM;QACxB,YAAY,EAAE,CAAC;KAChB;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,IAAI;QACjB,eAAe,EAAE,EAAE;QACnB,gBAAgB,EAAE,MAAM;QACxB,YAAY,EAAE,CAAC;KAChB;CACF,CAAA;AAED,MAAM,UAAU,2BAA2B,CAAC,IAAwB;IAClE,OAAO,uBAAuB,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,uBAAuB,CAAC,MAAM,CAAA;AACpF,CAAC;AAED,MAAM,CAAC,MAAM,gCAAgC,GAAG,MAAM,CAAA;AACtD,MAAM,CAAC,MAAM,gCAAgC,GAAG,MAAM,CAAA;AACtD,MAAM,CAAC,MAAM,iCAAiC,GAAG,MAAM,CAAA;AACvD,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAA;AAC3C,MAAM,CAAC,MAAM,4BAA4B,GAAG,KAAK,CAAA;AAEjD,MAAM,UAAU,oBAAoB,CAAC,aAAqB,EAAE,eAAuB;IACjF,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAC7B,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,eAAe,IAAI,CAAC,CAAC,EACjC,gCAAgC,CACjC,CAAA;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc,CAAC,CAAA;AACxD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,aAAqB,EAAE,eAAuB,EAAE,IAAwB;IAC3G,MAAM,eAAe,GAAG,oBAAoB,CAAC,aAAa,EAAE,eAAe,CAAC,CAAA;IAC5E,MAAM,MAAM,GAAG,IAAI,KAAK,cAAc;QACpC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,iCAAiC,EAAE,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;QACjF,CAAC,CAAC,gCAAgC,CAAA;IACpC,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAAC,CAAA;AAClD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,aAAqB,EAAE,eAAuB;IACjF,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,oBAAoB,CAAC,aAAa,EAAE,eAAe,CAAC,GAAG,4BAA4B,CAAC,CAAA;AAC7G,CAAC"}

package/dist/core/credentialStore.d.ts

@@ -0,0 +1,8 @@
+export interface CredentialSnapshot {
+    apiKey?: string;
+    apiConfigs?: Record<string, string>;
+}
+export declare function loadCredentialSnapshot(): CredentialSnapshot;
+export declare function serializeCredentialSnapshot(snapshot: CredentialSnapshot): string;
+export declare function saveCredentialSnapshot(snapshot: CredentialSnapshot): void;
+export declare function getCredentialsFile(): string;

package/dist/core/credentialStore.js

@@ -0,0 +1,37 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { quarantineCorruptFileSync, writeFileAtomicSync } from './fileIO';
+const CREDENTIALS_FILE = join(process.env.TURBOFLUX_CONFIG_DIR || join(homedir(), '.turboflux'), 'credentials.json');
+export function loadCredentialSnapshot() {
+    if (!existsSync(CREDENTIALS_FILE))
+        return {};
+    try {
+        const parsed = JSON.parse(readFileSync(CREDENTIALS_FILE, 'utf-8'));
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+            throw new Error('Credentials must be a JSON object');
+        const raw = parsed;
+        const apiConfigs = raw.apiConfigs && typeof raw.apiConfigs === 'object' && !Array.isArray(raw.apiConfigs)
+            ? Object.fromEntries(Object.entries(raw.apiConfigs).filter((entry) => typeof entry[1] === 'string' && Boolean(entry[1])))
+            : undefined;
+        return {
+            apiKey: typeof raw.apiKey === 'string' && raw.apiKey ? raw.apiKey : undefined,
+            apiConfigs,
+        };
+    }
+    catch (error) {
+        const backupPath = quarantineCorruptFileSync(CREDENTIALS_FILE);
+        console.warn(`TurboFlux preserved an invalid credentials file at ${backupPath}: ${error instanceof Error ? error.message : String(error)}`);
+        return {};
+    }
+}
+export function serializeCredentialSnapshot(snapshot) {
+    return JSON.stringify(snapshot, null, 2);
+}
+export function saveCredentialSnapshot(snapshot) {
+    writeFileAtomicSync(CREDENTIALS_FILE, serializeCredentialSnapshot(snapshot), 0o600);
+}
+export function getCredentialsFile() {
+    return CREDENTIALS_FILE;
+}
+//# sourceMappingURL=credentialStore.js.map

package/dist/core/credentialStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentialStore.js","sourceRoot":"","sources":["../../src/core/credentialStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAOzE,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,EAAE,kBAAkB,CAAC,CAAA;AAEpH,MAAM,UAAU,sBAAsB;IACpC,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC;QAAE,OAAO,EAAE,CAAA;IAC5C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC,CAAA;QAClE,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;QACxH,MAAM,GAAG,GAAG,MAAiC,CAAA;QAC7C,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,IAAI,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;YACvG,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAA6B,EAAE,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACpJ,CAAC,CAAC,SAAS,CAAA;QACb,OAAO;YACL,MAAM,EAAE,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;YAC7E,UAAU;SACX,CAAA;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,UAAU,GAAG,yBAAyB,CAAC,gBAAgB,CAAC,CAAA;QAC9D,OAAO,CAAC,IAAI,CAAC,sDAAsD,UAAU,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QAC3I,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,QAA4B;IACtE,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;AAC1C,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAA4B;IACjE,mBAAmB,CAAC,gBAAgB,EAAE,2BAA2B,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAA;AACrF,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,gBAAgB,CAAA;AACzB,CAAC"}

package/dist/core/diffCompute.d.ts

@@ -0,0 +1,31 @@
+export declare const MAX_DIFF_INPUT_BYTES: number;
+export declare const DEFAULT_UNIFIED_DIFF_CONTEXT_LINES = 3;
+export type DiffLineKind = 'context' | 'add' | 'remove';
+export interface DiffLine {
+    kind: DiffLineKind;
+    text: string;
+    oldLine?: number;
+    newLine?: number;
+}
+export interface DiffHunk {
+    oldStart: number;
+    oldLines: number;
+    newStart: number;
+    newLines: number;
+    lines: DiffLine[];
+}
+export interface DiffStats {
+    added: number;
+    removed: number;
+    hunkCount: number;
+}
+export interface HunkLineSpan {
+    startLine: number;
+    endLine: number;
+    kind: 'add' | 'remove' | 'change';
+}
+export declare function canComputeDiff(before: string | null | undefined, after: string | null | undefined): boolean;
+export declare function computeHunks(before: string, after: string, context?: number): DiffHunk[];
+export declare function summarizeHunks(hunks: DiffHunk[]): DiffStats;
+export declare function hunksToCurrentSpans(hunks: DiffHunk[]): HunkLineSpan[];
+export declare function classifyOperation(stats: DiffStats): 'add' | 'remove' | 'change' | 'noop';

package/dist/core/diffCompute.js

@@ -0,0 +1,116 @@
+import { structuredPatch } from 'diff';
+export const MAX_DIFF_INPUT_BYTES = 256 * 1024;
+export const DEFAULT_UNIFIED_DIFF_CONTEXT_LINES = 3;
+export function canComputeDiff(before, after) {
+    if (typeof before !== 'string' || typeof after !== 'string')
+        return false;
+    if (before.length > MAX_DIFF_INPUT_BYTES)
+        return false;
+    if (after.length > MAX_DIFF_INPUT_BYTES)
+        return false;
+    return true;
+}
+export function computeHunks(before, after, context = DEFAULT_UNIFIED_DIFF_CONTEXT_LINES) {
+    if (before === after)
+        return [];
+    const patch = structuredPatch('a', 'b', before, after, '', '', { context });
+    return patch.hunks.map(toHunk);
+}
+function toHunk(h) {
+    let oldCursor = h.oldStart;
+    let newCursor = h.newStart;
+    const lines = [];
+    for (const raw of h.lines) {
+        const tag = raw[0];
+        const text = raw.slice(1);
+        if (tag === '+') {
+            lines.push({ kind: 'add', text, newLine: newCursor });
+            newCursor += 1;
+        }
+        else if (tag === '-') {
+            lines.push({ kind: 'remove', text, oldLine: oldCursor });
+            oldCursor += 1;
+        }
+        else if (tag === '\\') {
+            continue;
+        }
+        else {
+            lines.push({ kind: 'context', text, oldLine: oldCursor, newLine: newCursor });
+            oldCursor += 1;
+            newCursor += 1;
+        }
+    }
+    return {
+        oldStart: h.oldStart,
+        oldLines: h.oldLines,
+        newStart: h.newStart,
+        newLines: h.newLines,
+        lines,
+    };
+}
+export function summarizeHunks(hunks) {
+    let added = 0;
+    let removed = 0;
+    for (const h of hunks) {
+        for (const line of h.lines) {
+            if (line.kind === 'add')
+                added += 1;
+            else if (line.kind === 'remove')
+                removed += 1;
+        }
+    }
+    return { added, removed, hunkCount: hunks.length };
+}
+export function hunksToCurrentSpans(hunks) {
+    const spans = [];
+    for (const h of hunks) {
+        let runStart = null;
+        let runEnd = null;
+        let runHasRemove = false;
+        let hunkHadAnyAdd = false;
+        let hunkHadAnyRemove = false;
+        const flushRun = () => {
+            if (runStart != null && runEnd != null) {
+                spans.push({
+                    startLine: runStart,
+                    endLine: runEnd,
+                    kind: runHasRemove ? 'change' : 'add',
+                });
+            }
+            runStart = null;
+            runEnd = null;
+            runHasRemove = false;
+        };
+        for (const line of h.lines) {
+            if (line.kind === 'add' && line.newLine != null) {
+                if (runStart == null)
+                    runStart = line.newLine;
+                runEnd = line.newLine;
+                hunkHadAnyAdd = true;
+            }
+            else if (line.kind === 'remove') {
+                runHasRemove = true;
+                hunkHadAnyRemove = true;
+            }
+            else {
+                flushRun();
+            }
+        }
+        flushRun();
+        if (!hunkHadAnyAdd && hunkHadAnyRemove) {
+            const anchor = Math.max(1, h.newStart);
+            spans.push({ startLine: anchor, endLine: anchor, kind: 'remove' });
+        }
+    }
+    return spans;
+}
+export function classifyOperation(stats) {
+    if (stats.added === 0 && stats.removed === 0)
+        return 'noop';
+    if (stats.added > 0 && stats.removed === 0)
+        return 'add';
+    if (stats.removed > 0 && stats.added === 0)
+        return 'remove';
+    return 'change';
+}
+//# sourceMappingURL=diffCompute.js.map

package/dist/core/diffCompute.js.map

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

package/dist/core/editHelpers.d.ts

@@ -0,0 +1,8 @@
+export declare function stripLineNumberPrefix(value: string | undefined): string;
+export type EditStepResult = {
+    content: string;
+    replacements: number;
+} | {
+    error: string;
+};
+export declare function applyEdit(source: string, oldContent: string, newContent: string, replaceAll: boolean, pathLabel: string): EditStepResult;

package/dist/core/editHelpers.js

@@ -0,0 +1,35 @@
+const LINE_NUMBER_ARROW = '\u2192';
+const LINE_NUMBER_PREFIX_RE = new RegExp(`^[ \\t]*\\d+${LINE_NUMBER_ARROW}`);
+export function stripLineNumberPrefix(value) {
+    if (typeof value !== 'string' || !value)
+        return value ?? '';
+    if (!value.includes(LINE_NUMBER_ARROW))
+        return value;
+    const lines = value.split('\n');
+    const nonEmpty = lines.filter(l => l.trim().length > 0);
+    if (nonEmpty.length === 0)
+        return value;
+    if (!nonEmpty.every(l => LINE_NUMBER_PREFIX_RE.test(l)))
+        return value;
+    return lines.map(l => l.replace(LINE_NUMBER_PREFIX_RE, '')).join('\n');
+}
+export function applyEdit(source, oldContent, newContent, replaceAll, pathLabel) {
+    if (typeof oldContent !== 'string' || oldContent.length === 0) {
+        return { error: `old_string cannot be empty (${pathLabel})` };
+    }
+    if (oldContent === newContent) {
+        return { error: `old_string and new_string are identical - no-op edit not allowed (${pathLabel})` };
+    }
+    const occurrenceCount = source.split(oldContent).length - 1;
+    if (occurrenceCount === 0) {
+        return { error: `old_string not found in ${pathLabel}. Match must be exact (indentation + whitespace).` };
+    }
+    if (occurrenceCount > 1 && !replaceAll) {
+        return { error: `found ${occurrenceCount} occurrences of old_string in ${pathLabel}. Either add more surrounding context to make the match unique, or pass replace_all=true.` };
+    }
+    if (replaceAll) {
+        return { content: source.split(oldContent).join(newContent), replacements: occurrenceCount };
+    }
+    return { content: source.replace(oldContent, newContent), replacements: 1 };
+}
+//# sourceMappingURL=editHelpers.js.map

package/dist/core/editHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editHelpers.js","sourceRoot":"","sources":["../../src/core/editHelpers.ts"],"names":[],"mappings":"AASA,MAAM,iBAAiB,GAAG,QAAQ,CAAA;AAClC,MAAM,qBAAqB,GAAG,IAAI,MAAM,CAAC,eAAe,iBAAiB,EAAE,CAAC,CAAA;AAY5E,MAAM,UAAU,qBAAqB,CAAC,KAAyB;IAC7D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,IAAI,EAAE,CAAA;IAC3D,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAAE,OAAO,KAAK,CAAA;IACpD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC/B,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACvD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IACvC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAA;IACrE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACxE,CAAC;AAaD,MAAM,UAAU,SAAS,CACvB,MAAc,EACd,UAAkB,EAClB,UAAkB,EAClB,UAAmB,EACnB,SAAiB;IAEjB,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9D,OAAO,EAAE,KAAK,EAAE,+BAA+B,SAAS,GAAG,EAAE,CAAA;IAC/D,CAAC;IACD,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;QAC9B,OAAO,EAAE,KAAK,EAAE,qEAAqE,SAAS,GAAG,EAAE,CAAA;IACrG,CAAC;IACD,MAAM,eAAe,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,CAAA;IAC3D,IAAI,eAAe,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,KAAK,EAAE,2BAA2B,SAAS,mDAAmD,EAAE,CAAA;IAC3G,CAAC;IACD,IAAI,eAAe,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QACvC,OAAO,EAAE,KAAK,EAAE,SAAS,eAAe,iCAAiC,SAAS,2FAA2F,EAAE,CAAA;IACjL,CAAC;IACD,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,YAAY,EAAE,eAAe,EAAE,CAAA;IAC9F,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAA;AAC7E,CAAC"}

package/dist/core/fileIO.d.ts

@@ -0,0 +1,12 @@
+export interface AtomicFileWrite {
+    filePath: string;
+    content: string;
+    mode?: number;
+}
+export declare function hashText(content: string): string;
+export declare function writeFileAtomicSync(filePath: string, content: string, mode?: number): void;
+export declare function recoverFilesAtomicSync(transactionPath: string): void;
+export declare function writeFilesAtomicSync(files: AtomicFileWrite[], transactionPath: string): void;
+export declare function withFileLockSync<T>(lockPath: string, callback: () => T, timeoutMs?: number): T;
+export declare function quarantineCorruptFileSync(filePath: string): string;
+export declare function writeFileAtomic(filePath: string, content: string): Promise<void>;

package/dist/core/fileIO.js

@@ -0,0 +1,199 @@
+import { createHash, randomBytes } from 'node:crypto';
+import { chmodSync, closeSync, existsSync, fsyncSync, openSync, promises as fsPromises, readFileSync, renameSync, rmSync, statSync, writeFileSync, } from 'node:fs';
+import { basename, dirname, join } from 'node:path';
+import { spawnSync } from 'node:child_process';
+export function hashText(content) {
+    return createHash('sha256').update(content, 'utf-8').digest('hex');
+}
+function syncDirectory(directory) {
+    if (process.platform === 'win32')
+        return;
+    const descriptor = openSync(directory, 'r');
+    try {
+        fsyncSync(descriptor);
+    }
+    finally {
+        closeSync(descriptor);
+    }
+}
+function secureFile(filePath, mode) {
+    if (mode === undefined)
+        return;
+    if (process.platform === 'win32' && process.env.USERNAME) {
+        const result = spawnSync('icacls.exe', [filePath, '/inheritance:r', '/grant:r', `${process.env.USERNAME}:F`], {
+            windowsHide: true,
+            stdio: 'ignore',
+        });
+        if (result.error || result.status !== 0) {
+            throw result.error ?? new Error(`icacls exited with status ${result.status}`);
+        }
+        return;
+    }
+    chmodSync(filePath, mode);
+}
+function stageFileSync(filePath, content, mode) {
+    const directory = dirname(filePath);
+    const tempPath = join(directory, `.${basename(filePath)}.${process.pid}.${randomBytes(6).toString('hex')}.tmp`);
+    const existingMode = existsSync(filePath) ? statSync(filePath).mode : undefined;
+    let descriptor;
+    let completed = false;
+    try {
+        descriptor = openSync(tempPath, 'wx', mode ?? existingMode);
+        writeFileSync(descriptor, content, 'utf-8');
+        fsyncSync(descriptor);
+        closeSync(descriptor);
+        descriptor = undefined;
+        secureFile(tempPath, mode);
+        completed = true;
+        return tempPath;
+    }
+    finally {
+        if (descriptor !== undefined)
+            closeSync(descriptor);
+        if (!completed && existsSync(tempPath))
+            rmSync(tempPath, { force: true });
+    }
+}
+export function writeFileAtomicSync(filePath, content, mode) {
+    const directory = dirname(filePath);
+    let tempPath;
+    try {
+        tempPath = stageFileSync(filePath, content, mode);
+        renameSync(tempPath, filePath);
+        tempPath = undefined;
+        syncDirectory(directory);
+    }
+    finally {
+        if (tempPath && existsSync(tempPath))
+            rmSync(tempPath, { force: true });
+    }
+}
+export function recoverFilesAtomicSync(transactionPath) {
+    if (!existsSync(transactionPath))
+        return;
+    const directory = dirname(transactionPath);
+    const parsed = JSON.parse(readFileSync(transactionPath, 'utf-8'));
+    if (parsed.version !== 1 || !Array.isArray(parsed.files)) {
+        throw new Error(`Invalid file transaction: ${transactionPath}`);
+    }
+    for (const entry of parsed.files) {
+        if (dirname(entry.filePath) !== directory || dirname(entry.tempPath) !== directory) {
+            throw new Error(`File transaction escapes its directory: ${transactionPath}`);
+        }
+        if (existsSync(entry.tempPath))
+            renameSync(entry.tempPath, entry.filePath);
+        if (!existsSync(entry.filePath) || hashText(readFileSync(entry.filePath, 'utf-8')) !== entry.hash) {
+            throw new Error(`File transaction could not recover ${entry.filePath}`);
+        }
+    }
+    rmSync(transactionPath, { force: true });
+    syncDirectory(directory);
+}
+export function writeFilesAtomicSync(files, transactionPath) {
+    if (files.length === 0)
+        return;
+    const directory = dirname(transactionPath);
+    if (files.some(file => dirname(file.filePath) !== directory)) {
+        throw new Error('Atomic file transactions must stay within one directory');
+    }
+    recoverFilesAtomicSync(transactionPath);
+    const staged = [];
+    let prepared = false;
+    try {
+        for (const file of files) {
+            staged.push({
+                filePath: file.filePath,
+                tempPath: stageFileSync(file.filePath, file.content, file.mode),
+                hash: hashText(file.content),
+            });
+        }
+        const transaction = { version: 1, files: staged };
+        writeFileAtomicSync(transactionPath, JSON.stringify(transaction, null, 2), 0o600);
+        prepared = true;
+        recoverFilesAtomicSync(transactionPath);
+    }
+    finally {
+        if (!prepared) {
+            for (const entry of staged) {
+                if (existsSync(entry.tempPath))
+                    rmSync(entry.tempPath, { force: true });
+            }
+        }
+    }
+}
+export function withFileLockSync(lockPath, callback, timeoutMs = 5_000) {
+    const startedAt = Date.now();
+    let descriptor;
+    while (descriptor === undefined) {
+        try {
+            const candidate = openSync(lockPath, 'wx', 0o600);
+            try {
+                writeFileSync(candidate, JSON.stringify({ pid: process.pid, createdAt: new Date().toISOString() }), 'utf-8');
+                fsyncSync(candidate);
+                descriptor = candidate;
+            }
+            catch (error) {
+                closeSync(candidate);
+                rmSync(lockPath, { force: true });
+                throw error;
+            }
+        }
+        catch (error) {
+            const code = error && typeof error === 'object' && 'code' in error ? String(error.code) : '';
+            if (code !== 'EEXIST')
+                throw error;
+            if (existsSync(lockPath) && Date.now() - statSync(lockPath).mtimeMs > 30_000) {
+                rmSync(lockPath, { force: true });
+                continue;
+            }
+            if (Date.now() - startedAt >= timeoutMs)
+                throw new Error(`Timed out waiting for file lock: ${lockPath}`);
+            Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 25);
+        }
+    }
+    try {
+        return callback();
+    }
+    finally {
+        closeSync(descriptor);
+        rmSync(lockPath, { force: true });
+    }
+}
+export function quarantineCorruptFileSync(filePath) {
+    const backupPath = `${filePath}.corrupt-${new Date().toISOString().replace(/[:.]/g, '-')}-${randomBytes(3).toString('hex')}.bak`;
+    renameSync(filePath, backupPath);
+    return backupPath;
+}
+export async function writeFileAtomic(filePath, content) {
+    const directory = dirname(filePath);
+    const tempPath = join(directory, `.${basename(filePath)}.${process.pid}.${randomBytes(6).toString('hex')}.tmp`);
+    let handle;
+    try {
+        handle = await fsPromises.open(tempPath, 'wx');
+        await handle.writeFile(content, 'utf-8');
+        await handle.sync();
+        await handle.close();
+        handle = undefined;
+        await fsPromises.rename(tempPath, filePath);
+        if (process.platform !== 'win32') {
+            const directoryHandle = await fsPromises.open(directory, 'r');
+            try {
+                await directoryHandle.sync();
+            }
+            finally {
+                await directoryHandle.close();
+            }
+        }
+    }
+    finally {
+        try {
+            await handle?.close();
+        }
+        catch { }
+        try {
+            await fsPromises.unlink(tempPath);
+        }
+        catch { }
+    }
+}
+//# sourceMappingURL=fileIO.js.map

package/dist/core/fileIO.js.map

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

package/dist/core/gitService.d.ts

@@ -0,0 +1,83 @@
+import type { ToolExecutor } from '../tools/executor';
+export type GitDiffScope = 'working' | 'staged' | 'all';
+export interface GitFileState {
+    path: string;
+    originalPath?: string;
+    indexStatus: string;
+    worktreeStatus: string;
+    staged: boolean;
+    unstaged: boolean;
+    untracked: boolean;
+    conflicted: boolean;
+}
+export interface GitCommitSummary {
+    hash: string;
+    shortHash: string;
+    author: string;
+    authoredAt: string;
+    subject: string;
+}
+export interface GitSnapshot {
+    branch: string;
+    head: string | null;
+    upstream: string | null;
+    ahead: number;
+    behind: number;
+    detached: boolean;
+    clean: boolean;
+    files: GitFileState[];
+    stagedCount: number;
+    unstagedCount: number;
+    untrackedCount: number;
+    conflictedCount: number;
+    recentCommits: GitCommitSummary[];
+}
+export type GitIntegrationPhase = 'detecting' | 'ready' | 'syncing' | 'error' | 'unavailable' | 'disabled';
+export interface GitOperationState {
+    name: string;
+    status: 'running' | 'success' | 'error';
+    message?: string;
+    hash?: string;
+    updatedAt: number;
+}
+export interface GitIntegrationState {
+    enabled: boolean;
+    phase: GitIntegrationPhase;
+    snapshot: GitSnapshot | null;
+    error?: string;
+    operation?: GitOperationState;
+    updatedAt: number;
+}
+export interface GitOperationResult {
+    ok: boolean;
+    output?: string;
+    hash?: string;
+    nothingToCommit?: boolean;
+    error?: string;
+}
+export declare function parseGitStatusPorcelainV2(output: string): Omit<GitSnapshot, 'recentCommits'>;
+export declare function parseGitLog(output: string): GitCommitSummary[];
+export declare function detectGitRepo(workspacePath: string, executor: ToolExecutor): Promise<boolean>;
+export declare function fetchGitSnapshot(workspacePath: string, executor: ToolExecutor): Promise<GitSnapshot | null>;
+export declare function formatGitSnapshotForPrompt(snapshot: GitSnapshot): string;
+export declare function formatGitSnapshotForTool(snapshot: GitSnapshot): string;
+export declare function fetchGitDiff(workspacePath: string, executor: ToolExecutor, scope?: GitDiffScope, filePath?: string, contextLines?: number): Promise<GitOperationResult>;
+export declare function fetchGitLog(workspacePath: string, executor: ToolExecutor, limit?: number, filePath?: string): Promise<GitOperationResult>;
+export declare function fetchGitShow(workspacePath: string, executor: ToolExecutor, revision: string, filePath?: string): Promise<GitOperationResult>;
+export declare function gitStagePaths(workspacePath: string, filePaths: string[], executor: ToolExecutor): Promise<GitOperationResult>;
+export declare function gitCommitPaths(workspacePath: string, message: string, filePaths: string[], executor: ToolExecutor): Promise<GitOperationResult>;
+export declare function gitCommit(workspacePath: string, message: string, executor: ToolExecutor, filePaths?: string[]): Promise<GitOperationResult>;
+export declare function gitRestorePaths(workspacePath: string, filePaths: string[], executor: ToolExecutor, source?: string): Promise<GitOperationResult>;
+export declare function gitRevertCommit(workspacePath: string, revision: string, executor: ToolExecutor): Promise<GitOperationResult>;
+export declare function gitCreateBranch(workspacePath: string, name: string, executor: ToolExecutor, startPoint?: string): Promise<GitOperationResult>;
+export declare function gitSwitchBranch(workspacePath: string, name: string, executor: ToolExecutor): Promise<GitOperationResult>;
+export declare function gitStash(workspacePath: string, action: 'list' | 'push' | 'apply' | 'pop', executor: ToolExecutor, options?: {
+    message?: string;
+    includeUntracked?: boolean;
+    stash?: string;
+}): Promise<GitOperationResult>;
+export declare function gitPush(workspacePath: string, executor: ToolExecutor, options?: {
+    remote?: string;
+    branch?: string;
+    setUpstream?: boolean;
+}): Promise<GitOperationResult>;