@zgsm/costrict-cli 0.0.1

package/dist/src/commands/hooks/migrate.test.js

@@ -0,0 +1,389 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach, afterEach, } from 'vitest';
+import * as fs from 'node:fs';
+import { loadSettings, SettingScope } from '../../config/settings.js';
+import { debugLogger } from '@google/gemini-cli-core';
+import { handleMigrateFromClaude } from './migrate.js';
+vi.mock('node:fs');
+vi.mock('../utils.js', () => ({
+    exitCli: vi.fn(),
+}));
+vi.mock('../../config/settings.js', async () => {
+    const actual = await vi.importActual('../../config/settings.js');
+    return {
+        ...actual,
+        loadSettings: vi.fn(),
+    };
+});
+const mockedLoadSettings = loadSettings;
+const mockedFs = vi.mocked(fs);
+describe('migrate command', () => {
+    let mockSetValue;
+    let debugLoggerLogSpy;
+    let debugLoggerErrorSpy;
+    let originalCwd;
+    beforeEach(() => {
+        vi.resetAllMocks();
+        mockSetValue = vi.fn();
+        debugLoggerLogSpy = vi
+            .spyOn(debugLogger, 'log')
+            .mockImplementation(() => { });
+        debugLoggerErrorSpy = vi
+            .spyOn(debugLogger, 'error')
+            .mockImplementation(() => { });
+        // Mock process.cwd()
+        originalCwd = process.cwd;
+        process.cwd = vi.fn(() => '/test/project');
+        mockedLoadSettings.mockReturnValue({
+            merged: {
+                hooks: {},
+            },
+            setValue: mockSetValue,
+            workspace: { path: '/test/project/.gemini' },
+        });
+    });
+    afterEach(() => {
+        process.cwd = originalCwd;
+        vi.restoreAllMocks();
+    });
+    it('should log error when no Claude settings files exist', async () => {
+        mockedFs.existsSync.mockReturnValue(false);
+        await handleMigrateFromClaude();
+        expect(debugLoggerErrorSpy).toHaveBeenCalledWith('No Claude Code settings found in .claude directory. Expected settings.json or settings.local.json');
+        expect(mockSetValue).not.toHaveBeenCalled();
+    });
+    it('should migrate hooks from settings.json when it exists', async () => {
+        const claudeSettings = {
+            hooks: {
+                PreToolUse: [
+                    {
+                        matcher: 'Edit',
+                        hooks: [
+                            {
+                                type: 'command',
+                                command: 'echo "Before Edit"',
+                                timeout: 30,
+                            },
+                        ],
+                    },
+                ],
+            },
+        };
+        mockedFs.existsSync.mockImplementation((path) => path.toString().endsWith('settings.json'));
+        mockedFs.readFileSync.mockReturnValue(JSON.stringify(claudeSettings));
+        await handleMigrateFromClaude();
+        expect(mockSetValue).toHaveBeenCalledWith(SettingScope.Workspace, 'hooks', expect.objectContaining({
+            BeforeTool: expect.arrayContaining([
+                expect.objectContaining({
+                    matcher: 'replace',
+                    hooks: expect.arrayContaining([
+                        expect.objectContaining({
+                            command: 'echo "Before Edit"',
+                            type: 'command',
+                            timeout: 30,
+                        }),
+                    ]),
+                }),
+            ]),
+        }));
+        expect(debugLoggerLogSpy).toHaveBeenCalledWith(expect.stringContaining('Found Claude Code settings'));
+        expect(debugLoggerLogSpy).toHaveBeenCalledWith(expect.stringContaining('Migrating 1 hook event'));
+        expect(debugLoggerLogSpy).toHaveBeenCalledWith('✓ Hooks successfully migrated to .gemini/settings.json');
+    });
+    it('should prefer settings.local.json over settings.json', async () => {
+        const localSettings = {
+            hooks: {
+                SessionStart: [
+                    {
+                        hooks: [
+                            {
+                                type: 'command',
+                                command: 'echo "Local session start"',
+                            },
+                        ],
+                    },
+                ],
+            },
+        };
+        mockedFs.existsSync.mockReturnValue(true);
+        mockedFs.readFileSync.mockReturnValue(JSON.stringify(localSettings));
+        await handleMigrateFromClaude();
+        expect(mockedFs.readFileSync).toHaveBeenCalledWith(expect.stringContaining('settings.local.json'), 'utf-8');
+        expect(mockSetValue).toHaveBeenCalledWith(SettingScope.Workspace, 'hooks', expect.objectContaining({
+            SessionStart: expect.any(Array),
+        }));
+    });
+    it('should migrate all supported event types', async () => {
+        const claudeSettings = {
+            hooks: {
+                PreToolUse: [{ hooks: [{ type: 'command', command: 'echo 1' }] }],
+                PostToolUse: [{ hooks: [{ type: 'command', command: 'echo 2' }] }],
+                UserPromptSubmit: [{ hooks: [{ type: 'command', command: 'echo 3' }] }],
+                Stop: [{ hooks: [{ type: 'command', command: 'echo 4' }] }],
+                SubAgentStop: [{ hooks: [{ type: 'command', command: 'echo 5' }] }],
+                SessionStart: [{ hooks: [{ type: 'command', command: 'echo 6' }] }],
+                SessionEnd: [{ hooks: [{ type: 'command', command: 'echo 7' }] }],
+                PreCompact: [{ hooks: [{ type: 'command', command: 'echo 8' }] }],
+                Notification: [{ hooks: [{ type: 'command', command: 'echo 9' }] }],
+            },
+        };
+        mockedFs.existsSync.mockReturnValue(true);
+        mockedFs.readFileSync.mockReturnValue(JSON.stringify(claudeSettings));
+        await handleMigrateFromClaude();
+        const migratedHooks = mockSetValue.mock.calls[0][2];
+        expect(migratedHooks).toHaveProperty('BeforeTool');
+        expect(migratedHooks).toHaveProperty('AfterTool');
+        expect(migratedHooks).toHaveProperty('BeforeAgent');
+        expect(migratedHooks).toHaveProperty('AfterAgent');
+        expect(migratedHooks).toHaveProperty('SessionStart');
+        expect(migratedHooks).toHaveProperty('SessionEnd');
+        expect(migratedHooks).toHaveProperty('PreCompress');
+        expect(migratedHooks).toHaveProperty('Notification');
+    });
+    it('should transform tool names in matchers', async () => {
+        const claudeSettings = {
+            hooks: {
+                PreToolUse: [
+                    {
+                        matcher: 'Edit|Bash|Read|Write|Glob|Grep',
+                        hooks: [{ type: 'command', command: 'echo "test"' }],
+                    },
+                ],
+            },
+        };
+        mockedFs.existsSync.mockReturnValue(true);
+        mockedFs.readFileSync.mockReturnValue(JSON.stringify(claudeSettings));
+        await handleMigrateFromClaude();
+        const migratedHooks = mockSetValue.mock.calls[0][2];
+        expect(migratedHooks.BeforeTool[0].matcher).toBe('replace|run_shell_command|read_file|write_file|glob|grep');
+    });
+    it('should replace $CLAUDE_PROJECT_DIR with $GEMINI_PROJECT_DIR', async () => {
+        const claudeSettings = {
+            hooks: {
+                PreToolUse: [
+                    {
+                        hooks: [
+                            {
+                                type: 'command',
+                                command: 'cd $CLAUDE_PROJECT_DIR && ls',
+                            },
+                        ],
+                    },
+                ],
+            },
+        };
+        mockedFs.existsSync.mockReturnValue(true);
+        mockedFs.readFileSync.mockReturnValue(JSON.stringify(claudeSettings));
+        await handleMigrateFromClaude();
+        const migratedHooks = mockSetValue.mock.calls[0][2];
+        expect(migratedHooks.BeforeTool[0].hooks[0].command).toBe('cd $GEMINI_PROJECT_DIR && ls');
+    });
+    it('should preserve sequential flag', async () => {
+        const claudeSettings = {
+            hooks: {
+                PreToolUse: [
+                    {
+                        sequential: true,
+                        hooks: [{ type: 'command', command: 'echo "test"' }],
+                    },
+                ],
+            },
+        };
+        mockedFs.existsSync.mockReturnValue(true);
+        mockedFs.readFileSync.mockReturnValue(JSON.stringify(claudeSettings));
+        await handleMigrateFromClaude();
+        const migratedHooks = mockSetValue.mock.calls[0][2];
+        expect(migratedHooks.BeforeTool[0].sequential).toBe(true);
+    });
+    it('should preserve timeout values', async () => {
+        const claudeSettings = {
+            hooks: {
+                PreToolUse: [
+                    {
+                        hooks: [
+                            {
+                                type: 'command',
+                                command: 'echo "test"',
+                                timeout: 60,
+                            },
+                        ],
+                    },
+                ],
+            },
+        };
+        mockedFs.existsSync.mockReturnValue(true);
+        mockedFs.readFileSync.mockReturnValue(JSON.stringify(claudeSettings));
+        await handleMigrateFromClaude();
+        const migratedHooks = mockSetValue.mock.calls[0][2];
+        expect(migratedHooks.BeforeTool[0].hooks[0].timeout).toBe(60);
+    });
+    it('should merge with existing Gemini hooks', async () => {
+        const claudeSettings = {
+            hooks: {
+                PreToolUse: [
+                    {
+                        hooks: [{ type: 'command', command: 'echo "claude"' }],
+                    },
+                ],
+            },
+        };
+        mockedLoadSettings.mockReturnValue({
+            merged: {
+                hooks: {
+                    AfterTool: [
+                        {
+                            hooks: [{ type: 'command', command: 'echo "existing"' }],
+                        },
+                    ],
+                },
+            },
+            setValue: mockSetValue,
+            workspace: { path: '/test/project/.gemini' },
+        });
+        mockedFs.existsSync.mockReturnValue(true);
+        mockedFs.readFileSync.mockReturnValue(JSON.stringify(claudeSettings));
+        await handleMigrateFromClaude();
+        const migratedHooks = mockSetValue.mock.calls[0][2];
+        expect(migratedHooks).toHaveProperty('BeforeTool');
+        expect(migratedHooks).toHaveProperty('AfterTool');
+        expect(migratedHooks.AfterTool[0].hooks[0].command).toBe('echo "existing"');
+        expect(migratedHooks.BeforeTool[0].hooks[0].command).toBe('echo "claude"');
+    });
+    it('should handle JSON with comments', async () => {
+        const claudeSettingsWithComments = `{
+      // This is a comment
+      "hooks": {
+        /* Block comment */
+        "PreToolUse": [
+          {
+            "hooks": [
+              {
+                "type": "command",
+                "command": "echo test" // Inline comment
+              }
+            ]
+          }
+        ]
+      }
+    }`;
+        mockedFs.existsSync.mockReturnValue(true);
+        mockedFs.readFileSync.mockReturnValue(claudeSettingsWithComments);
+        await handleMigrateFromClaude();
+        expect(mockSetValue).toHaveBeenCalledWith(SettingScope.Workspace, 'hooks', expect.objectContaining({
+            BeforeTool: expect.any(Array),
+        }));
+    });
+    it('should handle malformed JSON gracefully', async () => {
+        mockedFs.existsSync.mockReturnValue(true);
+        mockedFs.readFileSync.mockReturnValue('{ invalid json }');
+        await handleMigrateFromClaude();
+        expect(debugLoggerErrorSpy).toHaveBeenCalledWith(expect.stringContaining('Error reading'));
+        expect(mockSetValue).not.toHaveBeenCalled();
+    });
+    it('should log info when no hooks are found in Claude settings', async () => {
+        const claudeSettings = {
+            someOtherSetting: 'value',
+        };
+        mockedFs.existsSync.mockReturnValue(true);
+        mockedFs.readFileSync.mockReturnValue(JSON.stringify(claudeSettings));
+        await handleMigrateFromClaude();
+        expect(debugLoggerLogSpy).toHaveBeenCalledWith('No hooks found in Claude Code settings to migrate.');
+        expect(mockSetValue).not.toHaveBeenCalled();
+    });
+    it('should handle setValue errors gracefully', async () => {
+        const claudeSettings = {
+            hooks: {
+                PreToolUse: [
+                    {
+                        hooks: [{ type: 'command', command: 'echo "test"' }],
+                    },
+                ],
+            },
+        };
+        mockedFs.existsSync.mockReturnValue(true);
+        mockedFs.readFileSync.mockReturnValue(JSON.stringify(claudeSettings));
+        mockSetValue.mockImplementation(() => {
+            throw new Error('Failed to save');
+        });
+        await handleMigrateFromClaude();
+        expect(debugLoggerErrorSpy).toHaveBeenCalledWith('Error saving migrated hooks: Failed to save');
+    });
+    it('should handle hooks with matcher but no command', async () => {
+        const claudeSettings = {
+            hooks: {
+                PreToolUse: [
+                    {
+                        matcher: 'Edit',
+                        hooks: [
+                            {
+                                type: 'command',
+                            },
+                        ],
+                    },
+                ],
+            },
+        };
+        mockedFs.existsSync.mockReturnValue(true);
+        mockedFs.readFileSync.mockReturnValue(JSON.stringify(claudeSettings));
+        await handleMigrateFromClaude();
+        const migratedHooks = mockSetValue.mock.calls[0][2];
+        expect(migratedHooks.BeforeTool[0].matcher).toBe('replace');
+        expect(migratedHooks.BeforeTool[0].hooks[0].type).toBe('command');
+    });
+    it('should handle empty hooks array', async () => {
+        const claudeSettings = {
+            hooks: {
+                PreToolUse: [
+                    {
+                        hooks: [],
+                    },
+                ],
+            },
+        };
+        mockedFs.existsSync.mockReturnValue(true);
+        mockedFs.readFileSync.mockReturnValue(JSON.stringify(claudeSettings));
+        await handleMigrateFromClaude();
+        const migratedHooks = mockSetValue.mock.calls[0][2];
+        expect(migratedHooks.BeforeTool[0].hooks).toEqual([]);
+    });
+    it('should handle non-array event config gracefully', async () => {
+        const claudeSettings = {
+            hooks: {
+                PreToolUse: 'not an array',
+                PostToolUse: [
+                    {
+                        hooks: [{ type: 'command', command: 'echo "test"' }],
+                    },
+                ],
+            },
+        };
+        mockedFs.existsSync.mockReturnValue(true);
+        mockedFs.readFileSync.mockReturnValue(JSON.stringify(claudeSettings));
+        await handleMigrateFromClaude();
+        const migratedHooks = mockSetValue.mock.calls[0][2];
+        expect(migratedHooks).not.toHaveProperty('BeforeTool');
+        expect(migratedHooks).toHaveProperty('AfterTool');
+    });
+    it('should display migration instructions after successful migration', async () => {
+        const claudeSettings = {
+            hooks: {
+                PreToolUse: [
+                    {
+                        hooks: [{ type: 'command', command: 'echo "test"' }],
+                    },
+                ],
+            },
+        };
+        mockedFs.existsSync.mockReturnValue(true);
+        mockedFs.readFileSync.mockReturnValue(JSON.stringify(claudeSettings));
+        await handleMigrateFromClaude();
+        expect(debugLoggerLogSpy).toHaveBeenCalledWith('✓ Hooks successfully migrated to .gemini/settings.json');
+        expect(debugLoggerLogSpy).toHaveBeenCalledWith('\nMigration complete! Please review the migrated hooks in .gemini/settings.json');
+        expect(debugLoggerLogSpy).toHaveBeenCalledWith('Note: Set tools.enableHooks to true in your settings to enable the hook system.');
+    });
+});
+//# sourceMappingURL=migrate.test.js.map

package/dist/src/commands/hooks/migrate.test.js.map

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

package/dist/src/commands/hooks.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { CommandModule } from 'yargs';
+export declare const hooksCommand: CommandModule;

package/dist/src/commands/hooks.js

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { migrateCommand } from './hooks/migrate.js';
+import { initializeOutputListenersAndFlush } from '../gemini.js';
+export const hooksCommand = {
+    command: 'hooks <command>',
+    aliases: ['hook'],
+    describe: 'Manage Gemini CLI hooks.',
+    builder: (yargs) => yargs
+        .middleware(() => initializeOutputListenersAndFlush())
+        .command(migrateCommand)
+        .demandCommand(1, 'You need at least one command before continuing.')
+        .version(false),
+    handler: () => {
+        // This handler is not called when a subcommand is provided.
+        // Yargs will show the help menu.
+    },
+};
+//# sourceMappingURL=hooks.js.map

package/dist/src/commands/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../src/commands/hooks.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,iCAAiC,EAAE,MAAM,cAAc,CAAC;AAEjE,MAAM,CAAC,MAAM,YAAY,GAAkB;IACzC,OAAO,EAAE,iBAAiB;IAC1B,OAAO,EAAE,CAAC,MAAM,CAAC;IACjB,QAAQ,EAAE,0BAA0B;IACpC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CACjB,KAAK;SACF,UAAU,CAAC,GAAG,EAAE,CAAC,iCAAiC,EAAE,CAAC;SACrD,OAAO,CAAC,cAAc,CAAC;SACvB,aAAa,CAAC,CAAC,EAAE,kDAAkD,CAAC;SACpE,OAAO,CAAC,KAAK,CAAC;IACnB,OAAO,EAAE,GAAG,EAAE;QACZ,4DAA4D;QAC5D,iCAAiC;IACnC,CAAC;CACF,CAAC"}

package/dist/src/commands/mcp/add.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { CommandModule } from 'yargs';
+export declare const addCommand: CommandModule;

package/dist/src/commands/mcp/add.js

@@ -0,0 +1,178 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { loadSettings, SettingScope } from '../../config/settings.js';
+import { debugLogger } from '@google/gemini-cli-core';
+import { exitCli } from '../utils.js';
+async function addMcpServer(name, commandOrUrl, args, options) {
+    const { scope, transport, env, header, timeout, trust, description, includeTools, excludeTools, } = options;
+    const settings = loadSettings(process.cwd());
+    const inHome = settings.workspace.path === settings.user.path;
+    if (scope === 'project' && inHome) {
+        debugLogger.error('Error: Please use --scope user to edit settings in the home directory.');
+        process.exit(1);
+    }
+    const settingsScope = scope === 'user' ? SettingScope.User : SettingScope.Workspace;
+    let newServer = {};
+    const headers = header?.reduce((acc, curr) => {
+        const [key, ...valueParts] = curr.split(':');
+        const value = valueParts.join(':').trim();
+        if (key.trim() && value) {
+            acc[key.trim()] = value;
+        }
+        return acc;
+    }, {});
+    switch (transport) {
+        case 'sse':
+            newServer = {
+                url: commandOrUrl,
+                type: 'sse',
+                headers,
+                timeout,
+                trust,
+                description,
+                includeTools,
+                excludeTools,
+            };
+            break;
+        case 'http':
+            newServer = {
+                url: commandOrUrl,
+                type: 'http',
+                headers,
+                timeout,
+                trust,
+                description,
+                includeTools,
+                excludeTools,
+            };
+            break;
+        case 'stdio':
+        default:
+            newServer = {
+                command: commandOrUrl,
+                args: args?.map(String),
+                env: env?.reduce((acc, curr) => {
+                    const [key, value] = curr.split('=');
+                    if (key && value) {
+                        acc[key] = value;
+                    }
+                    return acc;
+                }, {}),
+                timeout,
+                trust,
+                description,
+                includeTools,
+                excludeTools,
+            };
+            break;
+    }
+    const existingSettings = settings.forScope(settingsScope).settings;
+    const mcpServers = existingSettings.mcpServers || {};
+    const isExistingServer = !!mcpServers[name];
+    if (isExistingServer) {
+        debugLogger.log(`MCP server "${name}" is already configured within ${scope} settings.`);
+    }
+    mcpServers[name] = newServer;
+    settings.setValue(settingsScope, 'mcpServers', mcpServers);
+    if (isExistingServer) {
+        debugLogger.log(`MCP server "${name}" updated in ${scope} settings.`);
+    }
+    else {
+        debugLogger.log(`MCP server "${name}" added to ${scope} settings. (${transport})`);
+    }
+}
+export const addCommand = {
+    command: 'add <name> <commandOrUrl> [args...]',
+    describe: 'Add a server',
+    builder: (yargs) => yargs
+        .usage('Usage: gemini mcp add [options] <name> <commandOrUrl> [args...]')
+        .parserConfiguration({
+        'unknown-options-as-args': true, // Pass unknown options as server args
+        'populate--': true, // Populate server args after -- separator
+    })
+        .positional('name', {
+        describe: 'Name of the server',
+        type: 'string',
+        demandOption: true,
+    })
+        .positional('commandOrUrl', {
+        describe: 'Command (stdio) or URL (sse, http)',
+        type: 'string',
+        demandOption: true,
+    })
+        .option('scope', {
+        alias: 's',
+        describe: 'Configuration scope (user or project)',
+        type: 'string',
+        default: 'project',
+        choices: ['user', 'project'],
+    })
+        .option('transport', {
+        alias: ['t', 'type'],
+        describe: 'Transport type (stdio, sse, http)',
+        type: 'string',
+        default: 'stdio',
+        choices: ['stdio', 'sse', 'http'],
+    })
+        .option('env', {
+        alias: 'e',
+        describe: 'Set environment variables (e.g. -e KEY=value)',
+        type: 'array',
+        string: true,
+        nargs: 1,
+    })
+        .option('header', {
+        alias: 'H',
+        describe: 'Set HTTP headers for SSE and HTTP transports (e.g. -H "X-Api-Key: abc123" -H "Authorization: Bearer abc123")',
+        type: 'array',
+        string: true,
+        nargs: 1,
+    })
+        .option('timeout', {
+        describe: 'Set connection timeout in milliseconds',
+        type: 'number',
+    })
+        .option('trust', {
+        describe: 'Trust the server (bypass all tool call confirmation prompts)',
+        type: 'boolean',
+    })
+        .option('description', {
+        describe: 'Set the description for the server',
+        type: 'string',
+    })
+        .option('include-tools', {
+        describe: 'A comma-separated list of tools to include',
+        type: 'array',
+        string: true,
+    })
+        .option('exclude-tools', {
+        describe: 'A comma-separated list of tools to exclude',
+        type: 'array',
+        string: true,
+    })
+        .middleware((argv) => {
+        // Handle -- separator args as server args if present
+        if (argv['--']) {
+            const existingArgs = argv['args'] || [];
+            argv['args'] = [...existingArgs, ...argv['--']];
+        }
+    }),
+    handler: async (argv) => {
+        await addMcpServer(argv['name'], argv['commandOrUrl'], argv['args'], {
+            scope: argv['scope'],
+            transport: argv['transport'],
+            env: argv['env'],
+            header: argv['header'],
+            timeout: argv['timeout'],
+            trust: argv['trust'],
+            description: argv['description'],
+            includeTools: argv['includeTools'],
+            excludeTools: argv['excludeTools'],
+        });
+        await exitCli();
+    },
+};
+//# sourceMappingURL=add.js.map

package/dist/src/commands/mcp/add.js.map

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

package/dist/src/commands/mcp/add.test.d.ts

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