@machina.ai/cell-cli-core 1.41.1-rc2 → 1.45.1-rc2

package/dist/src/utils/atCommandUtils.test.js

@@ -0,0 +1,292 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import * as path from 'node:path';
+import * as fsPromises from 'node:fs/promises';
+import { resolveAtCommandPath } from './atCommandUtils.js';
+import {} from '../config/config.js';
+vi.mock('node:fs/promises');
+describe('atCommandUtils', () => {
+    let mockConfig;
+    let mockWorkspaceContext;
+    beforeEach(() => {
+        vi.resetAllMocks();
+        mockWorkspaceContext = {
+            getDirectories: vi.fn().mockReturnValue(['/mock/root']),
+            isPathReadable: vi.fn().mockReturnValue(true),
+        };
+        mockConfig = {
+            getTargetDir: vi.fn().mockReturnValue('/mock/root'),
+            getWorkspaceContext: vi.fn().mockReturnValue(mockWorkspaceContext),
+            validatePathAccess: vi.fn().mockReturnValue(null),
+        };
+    });
+    it('should resolve a valid path', async () => {
+        const mockStats = {
+            isDirectory: () => false,
+            isFile: () => true,
+        };
+        vi.mocked(fsPromises.stat).mockResolvedValue(mockStats);
+        const result = await resolveAtCommandPath('file.ts', mockConfig);
+        expect(result.status).toBe('resolved');
+        if (result.status === 'resolved') {
+            expect(result.resolved.absolutePath).toBe(path.resolve('/mock/root', 'file.ts'));
+            expect(result.resolved.relativePath).toBe('file.ts');
+        }
+    });
+    it('should resolve an absolute path', async () => {
+        const mockStats = {
+            isDirectory: () => false,
+            isFile: () => true,
+        };
+        vi.mocked(fsPromises.stat).mockResolvedValue(mockStats);
+        const absolutePath = path.resolve('/mock/root', 'src/index.ts');
+        const result = await resolveAtCommandPath(absolutePath, mockConfig);
+        expect(result.status).toBe('resolved');
+        if (result.status === 'resolved') {
+            expect(result.resolved.absolutePath).toBe(absolutePath);
+            expect(result.resolved.relativePath).toBe(path.join('src', 'index.ts'));
+        }
+    });
+    it('should handle multiple directories in workspace context', async () => {
+        mockWorkspaceContext['getDirectories'].mockReturnValue([
+            '/dir1',
+            '/dir2',
+        ]);
+        const mockStats = {
+            isDirectory: () => false,
+            isFile: () => true,
+        };
+        vi.mocked(fsPromises.stat).mockImplementation(async (p) => {
+            if (p === path.resolve('/dir2', 'file.txt')) {
+                return mockStats;
+            }
+            throw new Error('ENOENT');
+        });
+        const result = await resolveAtCommandPath('file.txt', mockConfig);
+        expect(result.status).toBe('resolved');
+        if (result.status === 'resolved') {
+            expect(result.resolved.absolutePath).toBe(path.resolve('/dir2', 'file.txt'));
+            expect(result.resolved.relativePath).toBe('file.txt');
+        }
+    });
+    it('should return invalid for invalid path (too long)', async () => {
+        const longPath = 'a'.repeat(5000);
+        const result = await resolveAtCommandPath(longPath, mockConfig);
+        expect(result.status).toBe('invalid');
+    });
+    it('should return invalid for path with log markers (and no valid subpath)', async () => {
+        const onDebug = vi.fn();
+        const result = await resolveAtCommandPath('FAIL AssertionError: expected true to be false', mockConfig, onDebug);
+        expect(result.status).toBe('invalid');
+        expect(onDebug).toHaveBeenCalledWith(expect.stringContaining('Skipping invalid path'));
+    });
+    it('should return not_found if path does not exist in any workspace directory', async () => {
+        vi.mocked(fsPromises.stat).mockRejectedValue(new Error('ENOENT'));
+        const result = await resolveAtCommandPath('nonexistent.ts', mockConfig);
+        expect(result.status).toBe('not_found');
+    });
+    it('should resolve directory paths correctly', async () => {
+        const mockStats = {
+            isDirectory: () => true,
+            isFile: () => false,
+        };
+        vi.mocked(fsPromises.stat).mockResolvedValue(mockStats);
+        const result = await resolveAtCommandPath('src', mockConfig);
+        expect(result.status).toBe('resolved');
+        if (result.status === 'resolved') {
+            expect(result.resolved.stats.isDirectory()).toBe(true);
+        }
+    });
+    it('should respect validatePathAccess for paths within root', async () => {
+        mockConfig['validatePathAccess'].mockReturnValue('Unauthorized access');
+        // Mock getTargetDir to match the resolved path so it's considered "within root"
+        mockConfig['getTargetDir'].mockReturnValue('/mock/root');
+        const result = await resolveAtCommandPath('secret.txt', mockConfig);
+        expect(result.status).toBe('unauthorized');
+    });
+    it('should return unauthorized for paths outside root', async () => {
+        mockConfig['validatePathAccess'].mockReturnValue('Outside workspace');
+        mockConfig['getTargetDir'].mockReturnValue('/mock/workspace');
+        const mockStats = {
+            isDirectory: () => false,
+            isFile: () => true,
+        };
+        vi.mocked(fsPromises.stat).mockResolvedValue(mockStats);
+        // Path resolve will use /mock/root as base from mockWorkspaceContext
+        const result = await resolveAtCommandPath('outside.txt', mockConfig);
+        expect(result.status).toBe('unauthorized');
+        if (result.status === 'unauthorized') {
+            expect(result.absolutePath).toBe(path.resolve('/mock/root', 'outside.txt'));
+        }
+    });
+    it('should not treat paths with shared prefixes as subpaths if not actually inside', async () => {
+        // /mock/root-backup/file.txt starts with /mock/root but is not inside it.
+        const dir = '/mock/root';
+        const otherPath = '/mock/root-backup/file.txt';
+        mockWorkspaceContext['getDirectories'].mockReturnValue([dir]);
+        const mockStats = {
+            isDirectory: () => false,
+            isFile: () => true,
+        };
+        vi.mocked(fsPromises.stat).mockResolvedValue(mockStats);
+        const result = await resolveAtCommandPath(otherPath, mockConfig);
+        expect(result.status).toBe('resolved');
+        if (result.status === 'resolved') {
+            expect(result.resolved.absolutePath).toBe(otherPath);
+            // It should NOT be relative to /mock/root because it's not actually inside it.
+            // path.relative('/mock/root', '/mock/root-backup/file.txt') -> '../root-backup/file.txt'
+            // Our fix should prevent this from being used as a relative path.
+            expect(result.resolved.relativePath).toBe(otherPath);
+        }
+    });
+    it('should resolve paths in deeply nested workspace directories', async () => {
+        const dir = path.join('/mock', 'root', 'nested', 'project');
+        const relFile = path.join('src', 'index.ts');
+        const absFile = path.join(dir, relFile);
+        mockWorkspaceContext['getDirectories'].mockReturnValue([dir]);
+        const mockStats = {
+            isDirectory: () => false,
+            isFile: () => true,
+        };
+        vi.mocked(fsPromises.stat).mockResolvedValue(mockStats);
+        const result = await resolveAtCommandPath(absFile, mockConfig);
+        expect(result.status).toBe('resolved');
+        if (result.status === 'resolved') {
+            expect(result.resolved.absolutePath).toBe(absFile);
+            expect(result.resolved.relativePath).toBe(relFile);
+        }
+    });
+    it('should extract and resolve a buried path from a log fragment', async () => {
+        const buriedFile = 'src/utils/math.ts';
+        const logFragment = `FAIL ${buriedFile}:42:1 (AssertionError)`;
+        const mockStats = {
+            isDirectory: () => false,
+            isFile: () => true,
+        };
+        vi.mocked(fsPromises.stat).mockImplementation(async (p) => {
+            if (p === path.resolve('/mock/root', buriedFile)) {
+                return mockStats;
+            }
+            throw new Error('ENOENT');
+        });
+        const result = await resolveAtCommandPath(logFragment, mockConfig);
+        expect(result.status).toBe('resolved');
+        if (result.status === 'resolved') {
+            expect(result.resolved.absolutePath).toBe(path.resolve('/mock/root', buriedFile));
+            expect(result.resolved.relativePath).toBe(buriedFile);
+        }
+    });
+    describe('Best-Effort Path Extraction (tryExtractPath)', () => {
+        const mockFile = 'src/index.ts';
+        const absMockFile = path.resolve('/mock/root', mockFile);
+        const mockStats = { isDirectory: () => false, isFile: () => true };
+        beforeEach(() => {
+            vi.mocked(fsPromises.stat).mockImplementation(async (p) => {
+                if (p === absMockFile)
+                    return mockStats;
+                throw new Error('ENOENT');
+            });
+        });
+        it('should extract path from "AssertionError: ..." format', async () => {
+            const result = await resolveAtCommandPath(`AssertionError: expected something but got something else at ${mockFile}:10:5`, mockConfig);
+            expect(result.status).toBe('resolved');
+            if (result.status === 'resolved') {
+                expect(result.resolved.absolutePath).toBe(absMockFile);
+            }
+        });
+        it('should extract path wrapped in parentheses', async () => {
+            const result = await resolveAtCommandPath(`FAIL (${mockFile})`, mockConfig);
+            expect(result.status).toBe('resolved');
+            if (result.status === 'resolved') {
+                expect(result.resolved.absolutePath).toBe(absMockFile);
+            }
+        });
+        it('should extract path wrapped in square brackets', async () => {
+            const result = await resolveAtCommandPath(`FAIL [${mockFile}]`, mockConfig);
+            expect(result.status).toBe('resolved');
+            if (result.status === 'resolved') {
+                expect(result.resolved.absolutePath).toBe(absMockFile);
+            }
+        });
+        it('should extract path from "✓" pass marker', async () => {
+            const result = await resolveAtCommandPath(`✓ ${mockFile}`, mockConfig);
+            expect(result.status).toBe('resolved');
+        });
+        it('should extract path from "×" fail marker', async () => {
+            const result = await resolveAtCommandPath(`× ${mockFile}`, mockConfig);
+            expect(result.status).toBe('resolved');
+        });
+        it('should handle multiple trailing punctuation marks like file.txt...', async () => {
+            const result = await resolveAtCommandPath(`FAIL ${mockFile}...`, mockConfig);
+            expect(result.status).toBe('resolved');
+            if (result.status === 'resolved') {
+                expect(result.resolved.absolutePath).toBe(absMockFile);
+            }
+        });
+        it('should handle nested wrappers like ("path/to/file.ts")', async () => {
+            const result = await resolveAtCommandPath(`FAIL ("${mockFile}")`, mockConfig);
+            expect(result.status).toBe('resolved');
+            if (result.status === 'resolved') {
+                expect(result.resolved.absolutePath).toBe(absMockFile);
+            }
+        });
+        it('should NOT strip traversal (..), but let central validation handle it', async () => {
+            const traversalPath = 'src/../../etc/passwd';
+            const absPath = path.resolve('/mock/root', traversalPath);
+            mockConfig['validatePathAccess'].mockImplementation((p) => {
+                if (p === absPath)
+                    return 'Outside workspace';
+                return null;
+            });
+            const result = await resolveAtCommandPath(`FAIL ${traversalPath}`, mockConfig);
+            // It should NOT be stripped. It should resolve to the absolute path and fail authorization.
+            expect(result.status).toBe('unauthorized');
+            if (result.status === 'unauthorized') {
+                expect(result.absolutePath).toBe(absPath);
+            }
+        });
+        it('should reject paths with null bytes via validatePath', async () => {
+            const nullBytePath = 'src/index.ts\0.exe';
+            const result = await resolveAtCommandPath(`FAIL ${nullBytePath}`, mockConfig);
+            // validatePath rejects strings with null bytes
+            expect(result.status).toBe('invalid');
+        });
+        it('should handle paths with slashes and extensions correctly', async () => {
+            const complexPath = 'packages/core/src/utils/deep.test.ts';
+            const absComplexPath = path.resolve('/mock/root', complexPath);
+            vi.mocked(fsPromises.stat).mockImplementation(async (p) => {
+                if (p === absComplexPath)
+                    return mockStats;
+                throw new Error('ENOENT');
+            });
+            const result = await resolveAtCommandPath(`FAIL ${complexPath}:123`, mockConfig);
+            expect(result.status).toBe('resolved');
+            if (result.status === 'resolved') {
+                expect(result.resolved.relativePath).toBe(complexPath);
+            }
+        });
+        it('should fail gracefully if no valid path can be extracted', async () => {
+            const result = await resolveAtCommandPath('FAIL some random text with no slashes or dots', mockConfig);
+            expect(result.status).toBe('invalid');
+        });
+        it('should return unauthorized if the extracted path is not authorized', async () => {
+            const secretFile = '/etc/passwd';
+            mockConfig['validatePathAccess'].mockImplementation((p) => p === secretFile ? 'Unauthorized' : null);
+            vi.mocked(fsPromises.stat).mockResolvedValue(mockStats);
+            const result = await resolveAtCommandPath(`FAIL ${secretFile}`, mockConfig);
+            // It should try to resolve /etc/passwd, identify it as unauthorized, and return that status.
+            expect(result.status).toBe('unauthorized');
+        });
+    });
+    it('should include reason in debug message for unauthorized paths', async () => {
+        const onDebug = vi.fn();
+        mockConfig['validatePathAccess'].mockReturnValue('FORBIDDEN_ZONE');
+        await resolveAtCommandPath('secret.txt', mockConfig, onDebug);
+        expect(onDebug).toHaveBeenCalledWith(expect.stringContaining('Reason: FORBIDDEN_ZONE'));
+    });
+});
+//# sourceMappingURL=atCommandUtils.test.js.map

package/dist/src/utils/atCommandUtils.test.js.map

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

package/dist/src/utils/channel.d.ts

@@ -8,11 +8,19 @@ export declare enum ReleaseChannel {
     PREVIEW = "preview",
     STABLE = "stable"
 }
+/**
+ * Stability ranking for release channels. Higher number means more stable.
+ */
+export declare const RELEASE_CHANNEL_STABILITY: Record<ReleaseChannel, number>;
 /**
  * Clears the cache for testing purposes.
  * @private
  */
 export declare function _clearCache(): void;
+/**
+ * Determines the release channel for a given version string.
+ */
+export declare function getChannelFromVersion(version: string): ReleaseChannel;
 export declare function getReleaseChannel(cwd: string): Promise<ReleaseChannel>;
 export declare function isNightly(cwd: string): Promise<boolean>;
 export declare function isPreview(cwd: string): Promise<boolean>;

package/dist/src/utils/channel.js

@@ -10,6 +10,14 @@ export var ReleaseChannel;
     ReleaseChannel["PREVIEW"] = "preview";
     ReleaseChannel["STABLE"] = "stable";
 })(ReleaseChannel || (ReleaseChannel = {}));
+/**
+ * Stability ranking for release channels. Higher number means more stable.
+ */
+export const RELEASE_CHANNEL_STABILITY = {
+    [ReleaseChannel.NIGHTLY]: 0,
+    [ReleaseChannel.PREVIEW]: 1,
+    [ReleaseChannel.STABLE]: 2,
+};
 const cache = new Map();
 /**
  * Clears the cache for testing purposes.
@@ -18,22 +26,25 @@ const cache = new Map();
 export function _clearCache() {
     cache.clear();
 }
+/**
+ * Determines the release channel for a given version string.
+ */
+export function getChannelFromVersion(version) {
+    if (!version || version.includes('nightly')) {
+        return ReleaseChannel.NIGHTLY;
+    }
+    if (version.includes('preview')) {
+        return ReleaseChannel.PREVIEW;
+    }
+    return ReleaseChannel.STABLE;
+}
 export async function getReleaseChannel(cwd) {
     if (cache.has(cwd)) {
         return cache.get(cwd);
     }
     const packageJson = await getPackageJson(cwd);
     const version = packageJson?.version ?? '';
-    let channel;
-    if (version.includes('nightly') || version === '') {
-        channel = ReleaseChannel.NIGHTLY;
-    }
-    else if (version.includes('preview')) {
-        channel = ReleaseChannel.PREVIEW;
-    }
-    else {
-        channel = ReleaseChannel.STABLE;
-    }
+    const channel = getChannelFromVersion(version);
     cache.set(cwd, channel);
     return channel;
 }

package/dist/src/utils/channel.js.map

@@ -1 +1 @@
-{"version":3,"file":"channel.js","sourceRoot":"","sources":["../../../src/utils/channel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,CAAN,IAAY,cAIX;AAJD,WAAY,cAAc;IACxB,qCAAmB,CAAA;IACnB,qCAAmB,CAAA;IACnB,mCAAiB,CAAA;AACnB,CAAC,EAJW,cAAc,KAAd,cAAc,QAIzB;AAED,MAAM,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;AAEhD;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAW;IACjD,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACnB,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;IACzB,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,WAAW,EAAE,OAAO,IAAI,EAAE,CAAC;IAE3C,IAAI,OAAuB,CAAC;IAC5B,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QAClD,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC;IACnC,CAAC;SAAM,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACvC,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC;IACnC,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC;IAClC,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACxB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW;IACzC,OAAO,CAAC,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC,KAAK,cAAc,CAAC,OAAO,CAAC;AACnE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW;IACzC,OAAO,CAAC,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC,KAAK,cAAc,CAAC,OAAO,CAAC;AACnE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAW;IACxC,OAAO,CAAC,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC,KAAK,cAAc,CAAC,MAAM,CAAC;AAClE,CAAC"}
+{"version":3,"file":"channel.js","sourceRoot":"","sources":["../../../src/utils/channel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,CAAN,IAAY,cAIX;AAJD,WAAY,cAAc;IACxB,qCAAmB,CAAA;IACnB,qCAAmB,CAAA;IACnB,mCAAiB,CAAA;AACnB,CAAC,EAJW,cAAc,KAAd,cAAc,QAIzB;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAmC;IACvE,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;IAC3B,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;IAC3B,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;CAC3B,CAAC;AAEF,MAAM,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;AAEhD;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5C,OAAO,cAAc,CAAC,OAAO,CAAC;IAChC,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAChC,OAAO,cAAc,CAAC,OAAO,CAAC;IAChC,CAAC;IACD,OAAO,cAAc,CAAC,MAAM,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAW;IACjD,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACnB,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;IACzB,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,WAAW,EAAE,OAAO,IAAI,EAAE,CAAC;IAE3C,MAAM,OAAO,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/C,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACxB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW;IACzC,OAAO,CAAC,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC,KAAK,cAAc,CAAC,OAAO,CAAC;AACnE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW;IACzC,OAAO,CAAC,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC,KAAK,cAAc,CAAC,OAAO,CAAC;AACnE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAW;IACxC,OAAO,CAAC,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC,KAAK,cAAc,CAAC,MAAM,CAAC;AAClE,CAAC"}

package/dist/src/utils/cryptoUtils.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Derives a stable, deterministic ID from a list of source IDs.
+ * Used for synthetic turns like summaries to ensure that re-summarizing the same
+ * content produces a consistent identity.
+ */
+export declare function deriveStableId(sourceIds: string[]): string;

package/dist/src/utils/cryptoUtils.js

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { createHash } from 'node:crypto';
+/**
+ * Derives a stable, deterministic ID from a list of source IDs.
+ * Used for synthetic turns like summaries to ensure that re-summarizing the same
+ * content produces a consistent identity.
+ */
+export function deriveStableId(sourceIds) {
+    const sortedIds = [...sourceIds].sort();
+    return createHash('sha256')
+        .update(sortedIds.join('|'))
+        .digest('hex')
+        .slice(0, 32);
+}
+//# sourceMappingURL=cryptoUtils.js.map

package/dist/src/utils/cryptoUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cryptoUtils.js","sourceRoot":"","sources":["../../../src/utils/cryptoUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,SAAmB;IAChD,MAAM,SAAS,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,OAAO,UAAU,CAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;SAC3B,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC"}

package/dist/src/utils/cryptoUtils.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/utils/cryptoUtils.test.js

@@ -0,0 +1,31 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { deriveStableId } from './cryptoUtils.js';
+describe('cryptoUtils', () => {
+    describe('deriveStableId', () => {
+        it('should be deterministic regardless of input order', () => {
+            const id1 = deriveStableId(['a', 'b', 'c']);
+            const id2 = deriveStableId(['c', 'b', 'a']);
+            expect(id1).toBe(id2);
+            expect(id1).toMatch(/^[0-9a-f]{32}$/);
+        });
+        it('should produce different IDs for different inputs', () => {
+            const id1 = deriveStableId(['a', 'b', 'c']);
+            const id2 = deriveStableId(['a', 'b', 'd']);
+            expect(id1).not.toBe(id2);
+        });
+        it('should handle single inputs', () => {
+            const id = deriveStableId(['only-one']);
+            expect(id).toMatch(/^[0-9a-f]{32}$/);
+        });
+        it('should be consistent across calls with same data', () => {
+            const input = ['id-123', 'id-456'];
+            expect(deriveStableId(input)).toBe(deriveStableId(input));
+        });
+    });
+});
+//# sourceMappingURL=cryptoUtils.test.js.map

package/dist/src/utils/cryptoUtils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cryptoUtils.test.js","sourceRoot":"","sources":["../../../src/utils/cryptoUtils.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;YAC3D,MAAM,GAAG,GAAG,cAAc,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;YAC5C,MAAM,GAAG,GAAG,cAAc,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;YAC5C,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACtB,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;YAC3D,MAAM,GAAG,GAAG,cAAc,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;YAC5C,MAAM,GAAG,GAAG,cAAc,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;YAC5C,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;YACrC,MAAM,EAAE,GAAG,cAAc,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;YACxC,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;YAC1D,MAAM,KAAK,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACnC,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/utils/editor.d.ts

@@ -3,9 +3,10 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-declare const GUI_EDITORS: readonly ["vscode", "vscodium", "windsurf", "cursor", "zed", "antigravity"];
-declare const TERMINAL_EDITORS: readonly ["vim", "neovim", "emacs", "hx"];
-declare const EDITORS: readonly ["vscode", "vscodium", "windsurf", "cursor", "zed", "antigravity", "vim", "neovim", "emacs", "hx"];
+declare const GUI_EDITORS: readonly ["vscode", "vscodium", "windsurf", "cursor", "zed", "antigravity", "sublimetext", "lapce", "nova", "bbedit"];
+declare const TERMINAL_EDITORS: readonly ["vim", "neovim", "emacs", "hx", "emacsclient", "micro"];
+declare const EDITORS: readonly ["vscode", "vscodium", "windsurf", "cursor", "zed", "antigravity", "sublimetext", "lapce", "nova", "bbedit", "vim", "neovim", "emacs", "hx", "emacsclient", "micro"];
+export declare const ALL_EDITORS: readonly string[];
 export declare const NO_EDITOR_AVAILABLE_ERROR = "No external editor is available. Please run /editor to configure one.";
 export declare const DEFAULT_GUI_EDITOR: GuiEditorType;
 export type GuiEditorType = (typeof GUI_EDITORS)[number];
@@ -15,6 +16,11 @@ export declare function isGuiEditor(editor: EditorType): editor is GuiEditorType
 export declare function isTerminalEditor(editor: EditorType): editor is TerminalEditorType;
 export declare const EDITOR_DISPLAY_NAMES: Record<EditorType, string>;
 export declare function getEditorDisplayName(editor: EditorType): string;
+export declare const EDITOR_OPTIONS: ReadonlyArray<{
+    value: EditorType;
+    label: string;
+}>;
+export declare function isValidEditorType(editor: string): editor is EditorType;
 interface DiffCommand {
     command: string;
     args: string[];
@@ -22,6 +28,26 @@ interface DiffCommand {
 export declare function hasValidEditorCommand(editor: EditorType): boolean;
 export declare function hasValidEditorCommandAsync(editor: EditorType): Promise<boolean>;
 export declare function getEditorCommand(editor: EditorType): string;
+/**
+ * Given a command name (e.g. "cursor", "code", "code.cmd"), returns the
+ * EditorType that uses that command, or undefined if no match is found.
+ *
+ * This intentionally checks command names across all platforms (both `default`
+ * and `win32` lists) so that, for example, `$EDITOR=code` is recognized as
+ * vscode on Windows and `$EDITOR=code.cmd` is recognized as vscode on macOS.
+ */
+export declare function resolveEditorTypeFromCommand(command: string): EditorType | undefined;
+/**
+ * Returns the flag used to make a GUI editor block until the file is closed.
+ */
+export declare function getEditorWaitFlag(editor: EditorType): string;
+/**
+ * Returns any extra arguments that must be passed to the editor executable
+ * (in addition to the file path and any wait flag).
+ */
+export declare function getEditorExtraArgs(editor: EditorType, options?: {
+    newWindow?: boolean;
+}): string[];
 export declare function allowEditorTypeInSandbox(editor: EditorType): boolean;
 /**
  * Check if the editor is valid and can be used.