@anh3d0nic/qwen-code-termux-ice 21.0.1 → 21.2.0

package/core-dist/src/test-utils/config.js

@@ -0,0 +1,31 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Config } from '../config/config.js';
+/**
+ * Default parameters used for {@link FAKE_CONFIG}
+ */
+export const DEFAULT_CONFIG_PARAMETERS = {
+    usageStatisticsEnabled: true,
+    debugMode: false,
+    proxy: undefined,
+    model: 'qwen-9001-super-duper',
+    targetDir: '/',
+    cwd: '/',
+};
+/**
+ * Produces a config.  Default paramters are set to
+ * {@link DEFAULT_CONFIG_PARAMETERS}, optionally, fields can be specified to
+ * override those defaults.
+ */
+export function makeFakeConfig(config = {
+    ...DEFAULT_CONFIG_PARAMETERS,
+}) {
+    return new Config({
+        ...DEFAULT_CONFIG_PARAMETERS,
+        ...config,
+    });
+}
+//# sourceMappingURL=config.js.map

package/core-dist/src/test-utils/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/test-utils/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAqB;IACzD,sBAAsB,EAAE,IAAI;IAC5B,SAAS,EAAE,KAAK;IAChB,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,uBAAuB;IAC9B,SAAS,EAAE,GAAG;IACd,GAAG,EAAE,GAAG;CACT,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,SAAoC;IAClC,GAAG,yBAAyB;CAC7B;IAED,OAAO,IAAI,MAAM,CAAC;QAChB,GAAG,yBAAyB;QAC5B,GAAG,MAAM;KACV,CAAC,CAAC;AACL,CAAC"}

package/core-dist/src/test-utils/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from './mock-tool.js';

package/core-dist/src/test-utils/index.js

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from './mock-tool.js';
+//# sourceMappingURL=index.js.map

package/core-dist/src/test-utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/test-utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,gBAAgB,CAAC"}

package/core-dist/src/test-utils/mock-tool.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ModifiableDeclarativeTool, ModifyContext } from '../tools/modifiable-tool.js';
+import type { ToolCallConfirmationDetails, ToolInvocation, ToolResult } from '../tools/tools.js';
+import { BaseDeclarativeTool, BaseToolInvocation } from '../tools/tools.js';
+interface MockToolOptions {
+    name: string;
+    displayName?: string;
+    description?: string;
+    canUpdateOutput?: boolean;
+    isOutputMarkdown?: boolean;
+    shouldConfirmExecute?: (params: {
+        [key: string]: unknown;
+    }, signal: AbortSignal) => Promise<ToolCallConfirmationDetails | false>;
+    execute?: (params: {
+        [key: string]: unknown;
+    }, signal?: AbortSignal, updateOutput?: (output: string) => void) => Promise<ToolResult>;
+    params?: object;
+}
+/**
+ * A highly configurable mock tool for testing purposes.
+ */
+export declare class MockTool extends BaseDeclarativeTool<{
+    [key: string]: unknown;
+}, ToolResult> {
+    shouldConfirmExecute: (params: {
+        [key: string]: unknown;
+    }, signal: AbortSignal) => Promise<ToolCallConfirmationDetails | false>;
+    execute: (params: {
+        [key: string]: unknown;
+    }, signal?: AbortSignal, updateOutput?: (output: string) => void) => Promise<ToolResult>;
+    constructor(options: MockToolOptions);
+    protected createInvocation(params: {
+        [key: string]: unknown;
+    }): ToolInvocation<{
+        [key: string]: unknown;
+    }, ToolResult>;
+}
+export declare const MOCK_TOOL_SHOULD_CONFIRM_EXECUTE: () => Promise<{
+    type: "exec";
+    title: string;
+    command: string;
+    rootCommand: string;
+    onConfirm: () => Promise<void>;
+}>;
+export declare class MockModifiableToolInvocation extends BaseToolInvocation<Record<string, unknown>, ToolResult> {
+    private readonly tool;
+    constructor(tool: MockModifiableTool, params: Record<string, unknown>);
+    execute(_abortSignal: AbortSignal): Promise<ToolResult>;
+    shouldConfirmExecute(_abortSignal: AbortSignal): Promise<ToolCallConfirmationDetails | false>;
+    getDescription(): string;
+}
+/**
+ * Configurable mock modifiable tool for testing.
+ */
+export declare class MockModifiableTool extends BaseDeclarativeTool<Record<string, unknown>, ToolResult> implements ModifiableDeclarativeTool<Record<string, unknown>> {
+    executeFn: (params: Record<string, unknown>) => ToolResult | undefined;
+    shouldConfirm: boolean;
+    constructor(name?: string);
+    getModifyContext(_abortSignal: AbortSignal): ModifyContext<Record<string, unknown>>;
+    protected createInvocation(params: Record<string, unknown>): ToolInvocation<Record<string, unknown>, ToolResult>;
+}
+export {};

package/core-dist/src/test-utils/mock-tool.js

@@ -0,0 +1,121 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseDeclarativeTool, BaseToolInvocation, Kind, } from '../tools/tools.js';
+class MockToolInvocation extends BaseToolInvocation {
+    tool;
+    constructor(tool, params) {
+        super(params);
+        this.tool = tool;
+    }
+    execute(signal, updateOutput) {
+        if (updateOutput) {
+            return this.tool.execute(this.params, signal, updateOutput);
+        }
+        else {
+            return this.tool.execute(this.params);
+        }
+    }
+    shouldConfirmExecute(abortSignal) {
+        return this.tool.shouldConfirmExecute(this.params, abortSignal);
+    }
+    getDescription() {
+        return `A mock tool invocation for ${this.tool.name}`;
+    }
+}
+/**
+ * A highly configurable mock tool for testing purposes.
+ */
+export class MockTool extends BaseDeclarativeTool {
+    shouldConfirmExecute;
+    execute;
+    constructor(options) {
+        super(options.name, options.displayName ?? options.name, options.description ?? options.name, Kind.Other, options.params, options.isOutputMarkdown ?? false, options.canUpdateOutput ?? false);
+        if (options.shouldConfirmExecute) {
+            this.shouldConfirmExecute = options.shouldConfirmExecute;
+        }
+        else {
+            this.shouldConfirmExecute = () => Promise.resolve(false);
+        }
+        if (options.execute) {
+            this.execute = options.execute;
+        }
+        else {
+            this.execute = () => Promise.resolve({
+                llmContent: `Tool ${this.name} executed successfully.`,
+                returnDisplay: `Tool ${this.name} executed successfully.`,
+            });
+        }
+    }
+    createInvocation(params) {
+        return new MockToolInvocation(this, params);
+    }
+}
+export const MOCK_TOOL_SHOULD_CONFIRM_EXECUTE = () => Promise.resolve({
+    type: 'exec',
+    title: 'Confirm mockTool',
+    command: 'mockTool',
+    rootCommand: 'mockTool',
+    onConfirm: async () => { },
+});
+export class MockModifiableToolInvocation extends BaseToolInvocation {
+    tool;
+    constructor(tool, params) {
+        super(params);
+        this.tool = tool;
+    }
+    async execute(_abortSignal) {
+        const result = this.tool.executeFn(this.params);
+        return (result ?? {
+            llmContent: `Tool ${this.tool.name} executed successfully.`,
+            returnDisplay: `Tool ${this.tool.name} executed successfully.`,
+        });
+    }
+    async shouldConfirmExecute(_abortSignal) {
+        if (this.tool.shouldConfirm) {
+            return {
+                type: 'edit',
+                title: 'Confirm Mock Tool',
+                fileName: 'test.txt',
+                filePath: 'test.txt',
+                fileDiff: 'diff',
+                originalContent: 'originalContent',
+                newContent: 'newContent',
+                onConfirm: async () => { },
+            };
+        }
+        return false;
+    }
+    getDescription() {
+        return `A mock modifiable tool invocation for ${this.tool.name}`;
+    }
+}
+/**
+ * Configurable mock modifiable tool for testing.
+ */
+export class MockModifiableTool extends BaseDeclarativeTool {
+    // Should be overrided in test file. Functionality will be updated in follow
+    // up PR which has MockModifiableTool expect MockTool
+    executeFn = () => undefined;
+    shouldConfirm = true;
+    constructor(name = 'mockModifiableTool') {
+        super(name, name, 'A mock modifiable tool for testing.', Kind.Other, {
+            type: 'object',
+            properties: { param: { type: 'string' } },
+        });
+    }
+    getModifyContext(_abortSignal) {
+        return {
+            getFilePath: () => 'test.txt',
+            getCurrentContent: async () => 'old content',
+            getProposedContent: async () => 'new content',
+            createUpdatedParams: (_oldContent, modifiedProposedContent, _originalParams) => ({ newContent: modifiedProposedContent }),
+        };
+    }
+    createInvocation(params) {
+        return new MockModifiableToolInvocation(this, params);
+    }
+}
+//# sourceMappingURL=mock-tool.js.map

package/core-dist/src/test-utils/mock-tool.js.map

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

package/core-dist/src/test-utils/mockWorkspaceContext.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { WorkspaceContext } from '../utils/workspaceContext.js';
+/**
+ * Creates a mock WorkspaceContext for testing
+ * @param rootDir The root directory to use for the mock
+ * @param additionalDirs Optional additional directories to include in the workspace
+ * @returns A mock WorkspaceContext instance
+ */
+export declare function createMockWorkspaceContext(rootDir: string, additionalDirs?: string[]): WorkspaceContext;

package/core-dist/src/test-utils/mockWorkspaceContext.js

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { vi } from 'vitest';
+/**
+ * Creates a mock WorkspaceContext for testing
+ * @param rootDir The root directory to use for the mock
+ * @param additionalDirs Optional additional directories to include in the workspace
+ * @returns A mock WorkspaceContext instance
+ */
+export function createMockWorkspaceContext(rootDir, additionalDirs = []) {
+    const allDirs = [rootDir, ...additionalDirs];
+    const mockWorkspaceContext = {
+        addDirectory: vi.fn(),
+        getDirectories: vi.fn().mockReturnValue(allDirs),
+        isPathWithinWorkspace: vi
+            .fn()
+            .mockImplementation((path) => allDirs.some((dir) => path.startsWith(dir))),
+    };
+    return mockWorkspaceContext;
+}
+//# sourceMappingURL=mockWorkspaceContext.js.map

package/core-dist/src/test-utils/mockWorkspaceContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mockWorkspaceContext.js","sourceRoot":"","sources":["../../../src/test-utils/mockWorkspaceContext.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAG5B;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAAe,EACf,iBAA2B,EAAE;IAE7B,MAAM,OAAO,GAAG,CAAC,OAAO,EAAE,GAAG,cAAc,CAAC,CAAC;IAE7C,MAAM,oBAAoB,GAAG;QAC3B,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE;QACrB,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,OAAO,CAAC;QAChD,qBAAqB,EAAE,EAAE;aACtB,EAAE,EAAE;aACJ,kBAAkB,CAAC,CAAC,IAAY,EAAE,EAAE,CACnC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAC5C;KAC2B,CAAC;IAEjC,OAAO,oBAAoB,CAAC;AAC9B,CAAC"}

package/core-dist/src/tools/askUserQuestion.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ToolAskUserQuestionConfirmationDetails, ToolResult } from './tools.js';
+import { BaseDeclarativeTool, BaseToolInvocation } from './tools.js';
+import type { Config } from '../config/config.js';
+export interface QuestionOption {
+    label: string;
+    description: string;
+}
+export interface Question {
+    question: string;
+    header: string;
+    options: QuestionOption[];
+    multiSelect: boolean;
+}
+export interface AskUserQuestionParams {
+    questions: Question[];
+    metadata?: {
+        source?: string;
+    };
+}
+declare class AskUserQuestionToolInvocation extends BaseToolInvocation<AskUserQuestionParams, ToolResult> {
+    private readonly _config;
+    private userAnswers;
+    private wasAnswered;
+    constructor(_config: Config, params: AskUserQuestionParams);
+    getDescription(): string;
+    shouldConfirmExecute(_abortSignal: AbortSignal): Promise<ToolAskUserQuestionConfirmationDetails | false>;
+    execute(_signal: AbortSignal): Promise<ToolResult>;
+}
+export declare class AskUserQuestionTool extends BaseDeclarativeTool<AskUserQuestionParams, ToolResult> {
+    private readonly config;
+    static readonly Name: string;
+    constructor(config: Config);
+    validateToolParams(params: AskUserQuestionParams): string | null;
+    protected createInvocation(params: AskUserQuestionParams): AskUserQuestionToolInvocation;
+}
+export {};

package/core-dist/src/tools/askUserQuestion.js

@@ -0,0 +1,247 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseDeclarativeTool, BaseToolInvocation, Kind, ToolConfirmationOutcome, } from './tools.js';
+import { ToolDisplayNames, ToolNames } from './tool-names.js';
+import { createDebugLogger } from '../utils/debugLogger.js';
+import { InputFormat } from '../output/types.js';
+const debugLogger = createDebugLogger('ASK_USER_QUESTION');
+const askUserQuestionToolDescription = `Use this tool when you need to ask the user questions during execution. This allows you to:
+1. Gather user preferences or requirements
+2. Clarify ambiguous instructions
+3. Get decisions on implementation choices as you work
+4. Offer choices to the user about what direction to take.
+
+Usage notes:
+- Users will always be able to select "Other" to provide custom text input
+- Use multiSelect: true to allow multiple answers to be selected for a question
+- If you recommend a specific option, make that the first option in the list and add "(Recommended)" at the end of the label
+
+Plan mode note: In plan mode, use this tool to clarify requirements or choose between approaches BEFORE finalizing your plan. Do NOT use this tool to ask "Is this plan ready?" or "Should I proceed?" - use ExitPlanMode for plan approval.
+`;
+const askUserQuestionToolSchemaData = {
+    name: 'ask_user_question',
+    description: askUserQuestionToolDescription,
+    parametersJsonSchema: {
+        $schema: 'https://json-schema.org/draft/2020-12/schema',
+        type: 'object',
+        properties: {
+            questions: {
+                description: 'Questions to ask the user (1-4 questions)',
+                minItems: 1,
+                maxItems: 4,
+                type: 'array',
+                items: {
+                    type: 'object',
+                    properties: {
+                        question: {
+                            description: 'The complete question to ask the user. Should be clear, specific, and end with a question mark. Example: "Which library should we use for date formatting?" If multiSelect is true, phrase it accordingly, e.g. "Which features do you want to enable?"',
+                            type: 'string',
+                        },
+                        header: {
+                            description: 'Very short label displayed as a chip/tag (max 12 chars). Examples: "Auth method", "Library", "Approach".',
+                            type: 'string',
+                        },
+                        options: {
+                            description: "The available choices for this question. Must have 2-4 options. Each option should be a distinct, mutually exclusive choice (unless multiSelect is enabled). There should be no 'Other' option, that will be provided automatically.",
+                            minItems: 2,
+                            maxItems: 4,
+                            type: 'array',
+                            items: {
+                                type: 'object',
+                                properties: {
+                                    label: {
+                                        description: 'The display text for this option that the user will see and select. Should be concise (1-5 words) and clearly describe the choice.',
+                                        type: 'string',
+                                    },
+                                    description: {
+                                        description: 'Explanation of what this option means or what will happen if chosen. Useful for providing context about trade-offs or implications.',
+                                        type: 'string',
+                                    },
+                                },
+                                required: ['label', 'description'],
+                                additionalProperties: false,
+                            },
+                        },
+                        multiSelect: {
+                            description: 'Set to true to allow the user to select multiple options instead of just one. Use when choices are not mutually exclusive.',
+                            default: false,
+                            type: 'boolean',
+                        },
+                    },
+                    required: ['question', 'header', 'options', 'multiSelect'],
+                    additionalProperties: false,
+                },
+            },
+            metadata: {
+                description: 'Optional metadata for tracking and analytics purposes. Not displayed to user.',
+                type: 'object',
+                properties: {
+                    source: {
+                        description: 'Optional identifier for the source of this question (e.g., "remember" for /remember command). Used for analytics tracking.',
+                        type: 'string',
+                    },
+                },
+                additionalProperties: false,
+            },
+        },
+        required: ['questions'],
+        additionalProperties: false,
+    },
+};
+class AskUserQuestionToolInvocation extends BaseToolInvocation {
+    _config;
+    userAnswers = {};
+    wasAnswered = false;
+    constructor(_config, params) {
+        super(params);
+        this._config = _config;
+    }
+    getDescription() {
+        const questionCount = this.params.questions.length;
+        return `Ask user ${questionCount} question${questionCount > 1 ? 's' : ''}`;
+    }
+    async shouldConfirmExecute(_abortSignal) {
+        // Check if we're in a mode that supports user interaction
+        // ACP mode (VSCode extension, etc.) uses non-interactive mode but can still collect user input
+        const isAcpMode = this._config.getExperimentalZedIntegration() ||
+            this._config.getInputFormat() === InputFormat.STREAM_JSON;
+        if (!this._config.isInteractive() && !isAcpMode) {
+            // In non-interactive mode without ACP support, we cannot collect user input
+            return false;
+        }
+        const details = {
+            type: 'ask_user_question',
+            title: 'Please answer the following question(s):',
+            questions: this.params.questions,
+            metadata: this.params.metadata,
+            onConfirm: async (outcome, payload) => {
+                switch (outcome) {
+                    case ToolConfirmationOutcome.ProceedOnce:
+                    case ToolConfirmationOutcome.ProceedAlways:
+                        this.wasAnswered = true;
+                        this.userAnswers = payload?.answers ?? {};
+                        break;
+                    case ToolConfirmationOutcome.Cancel:
+                        this.wasAnswered = false;
+                        break;
+                    default:
+                        this.wasAnswered = true;
+                        this.userAnswers = payload?.answers ?? {};
+                        break;
+                }
+            },
+        };
+        return details;
+    }
+    async execute(_signal) {
+        try {
+            // Check if we're in a mode that supports user interaction
+            // ACP mode (VSCode extension, etc.) uses non-interactive mode but can still collect user input
+            const isAcpMode = this._config.getExperimentalZedIntegration() ||
+                this._config.getInputFormat() === InputFormat.STREAM_JSON;
+            // In non-interactive mode without ACP support, we cannot collect user input
+            if (!this._config.isInteractive() && !isAcpMode) {
+                const errorMessage = 'Cannot ask user questions in non-interactive mode without ACP support. Please run in interactive mode or enable ACP mode to use this tool.';
+                return {
+                    llmContent: errorMessage,
+                    returnDisplay: errorMessage,
+                };
+            }
+            if (!this.wasAnswered) {
+                const cancellationMessage = 'User declined to answer the questions.';
+                return {
+                    llmContent: cancellationMessage,
+                    returnDisplay: cancellationMessage,
+                };
+            }
+            // Format the answers for LLM consumption
+            const answersContent = Object.entries(this.userAnswers)
+                .map(([key, value]) => {
+                const questionIndex = parseInt(key, 10);
+                const question = this.params.questions[questionIndex];
+                return `**${question?.header || `Question ${questionIndex + 1}`}**: ${value}`;
+            })
+                .join('\n');
+            const llmMessage = `User has provided the following answers:\n\n${answersContent}`;
+            const displayMessage = `User has provided the following answers:\n\n${answersContent}`;
+            return {
+                llmContent: llmMessage,
+                returnDisplay: displayMessage,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            debugLogger.error(`[AskUserQuestionTool] Error executing ask_user_question: ${errorMessage}`);
+            const errorLlmContent = `Failed to process user answers: ${errorMessage}`;
+            return {
+                llmContent: errorLlmContent,
+                returnDisplay: `Error processing answers: ${errorMessage}`,
+            };
+        }
+    }
+}
+export class AskUserQuestionTool extends BaseDeclarativeTool {
+    config;
+    static Name = ToolNames.ASK_USER_QUESTION;
+    constructor(config) {
+        super(AskUserQuestionTool.Name, ToolDisplayNames.ASK_USER_QUESTION, askUserQuestionToolDescription, Kind.Think, askUserQuestionToolSchemaData.parametersJsonSchema);
+        this.config = config;
+    }
+    validateToolParams(params) {
+        // Validate questions array
+        if (!Array.isArray(params.questions)) {
+            return 'Parameter "questions" must be an array.';
+        }
+        if (params.questions.length < 1 || params.questions.length > 4) {
+            return 'Parameter "questions" must contain between 1 and 4 questions.';
+        }
+        // Validate individual questions
+        for (let i = 0; i < params.questions.length; i++) {
+            const question = params.questions[i];
+            if (!question.question ||
+                typeof question.question !== 'string' ||
+                question.question.trim() === '') {
+                return `Question ${i + 1}: "question" must be a non-empty string.`;
+            }
+            if (!question.header ||
+                typeof question.header !== 'string' ||
+                question.header.trim() === '') {
+                return `Question ${i + 1}: "header" must be a non-empty string.`;
+            }
+            if (question.header.length > 12) {
+                return `Question ${i + 1}: "header" must be 12 characters or less.`;
+            }
+            if (!Array.isArray(question.options)) {
+                return `Question ${i + 1}: "options" must be an array.`;
+            }
+            if (question.options.length < 2 || question.options.length > 4) {
+                return `Question ${i + 1}: "options" must contain between 2 and 4 options.`;
+            }
+            // Validate options
+            for (let j = 0; j < question.options.length; j++) {
+                const option = question.options[j];
+                if (!option.label ||
+                    typeof option.label !== 'string' ||
+                    option.label.trim() === '') {
+                    return `Question ${i + 1}, Option ${j + 1}: "label" must be a non-empty string.`;
+                }
+                if (!option.description ||
+                    typeof option.description !== 'string' ||
+                    option.description.trim() === '') {
+                    return `Question ${i + 1}, Option ${j + 1}: "description" must be a non-empty string.`;
+                }
+            }
+            if (typeof question.multiSelect !== 'boolean') {
+                return `Question ${i + 1}: "multiSelect" must be a boolean.`;
+            }
+        }
+        return null;
+    }
+    createInvocation(params) {
+        return new AskUserQuestionToolInvocation(this.config, params);
+    }
+}
+//# sourceMappingURL=askUserQuestion.js.map

package/core-dist/src/tools/askUserQuestion.js.map

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

package/core-dist/src/tools/askUserQuestion.test.d.ts

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