@accomplish_ai/agent-core 0.0.0-pr-353-20260205225158

package/dist/utils/sanitize.js

@@ -0,0 +1,21 @@
+const DEFAULT_MAX_LENGTH = 8000;
+export function sanitizeString(input, fieldName, maxLength = DEFAULT_MAX_LENGTH) {
+    if (typeof input !== 'string') {
+        throw new Error(`${fieldName} must be a string`);
+    }
+    const trimmed = input.trim();
+    if (!trimmed) {
+        throw new Error(`${fieldName} is required`);
+    }
+    if (trimmed.length > maxLength) {
+        throw new Error(`${fieldName} exceeds maximum length of ${maxLength}`);
+    }
+    return trimmed;
+}
+export function sanitizeOptionalString(input, fieldName, maxLength = DEFAULT_MAX_LENGTH) {
+    if (input === null || input === undefined) {
+        return undefined;
+    }
+    return sanitizeString(input, fieldName, maxLength);
+}
+//# sourceMappingURL=sanitize.js.map

package/dist/utils/sanitize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.js","sourceRoot":"","sources":["../../src/utils/sanitize.ts"],"names":[],"mappings":"AAAA,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEhC,MAAM,UAAU,cAAc,CAC5B,KAAc,EACd,SAAiB,EACjB,SAAS,GAAG,kBAAkB;IAE9B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,mBAAmB,CAAC,CAAC;IACnD,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,cAAc,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,8BAA8B,SAAS,EAAE,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,KAAc,EACd,SAAiB,EACjB,SAAS,GAAG,kBAAkB;IAE9B,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AACrD,CAAC"}

package/dist/utils/shell.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Strips ANSI escape codes from a string.
+ * @param input - The string potentially containing ANSI escape codes
+ * @returns The string with all ANSI escape codes removed
+ */
+export declare function stripAnsi(input: string): string;
+/**
+ * Quotes an argument for safe use in shell commands.
+ * Handles platform-specific quoting requirements.
+ * @param arg - The argument to quote
+ * @returns The properly quoted argument
+ */
+export declare function quoteForShell(arg: string): string;
+/**
+ * Returns the appropriate shell for the current platform.
+ * @param isPackaged - Whether the app is running in packaged mode (optional)
+ * @returns The path to the shell executable
+ */
+export declare function getPlatformShell(isPackaged?: boolean): string;
+/**
+ * Returns the shell arguments needed to execute a command.
+ * @param command - The command to execute
+ * @returns Array of shell arguments
+ */
+export declare function getShellArgs(command: string): string[];
+//# sourceMappingURL=shell.d.ts.map

package/dist/utils/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../src/utils/shell.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAWjD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,CAY7D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAKtD"}

package/dist/utils/shell.js

@@ -0,0 +1,60 @@
+import * as fs from 'fs';
+/**
+ * Strips ANSI escape codes from a string.
+ * @param input - The string potentially containing ANSI escape codes
+ * @returns The string with all ANSI escape codes removed
+ */
+export function stripAnsi(input) {
+    return input.replace(/\x1B\[[0-9;]*[a-zA-Z]/g, '');
+}
+/**
+ * Quotes an argument for safe use in shell commands.
+ * Handles platform-specific quoting requirements.
+ * @param arg - The argument to quote
+ * @returns The properly quoted argument
+ */
+export function quoteForShell(arg) {
+    if (process.platform === 'win32') {
+        if (arg.includes(' ') || arg.includes('"')) {
+            return `"${arg.replace(/"/g, '\\"')}"`;
+        }
+        return arg;
+    }
+    if (arg.includes("'") || arg.includes(' ') || arg.includes('"')) {
+        return `'${arg.replace(/'/g, "'\\''")}'`;
+    }
+    return arg;
+}
+/**
+ * Returns the appropriate shell for the current platform.
+ * @param isPackaged - Whether the app is running in packaged mode (optional)
+ * @returns The path to the shell executable
+ */
+export function getPlatformShell(isPackaged) {
+    if (process.platform === 'win32') {
+        return 'powershell.exe';
+    }
+    if (isPackaged && process.platform === 'darwin') {
+        return '/bin/sh';
+    }
+    const userShell = process.env.SHELL;
+    if (userShell)
+        return userShell;
+    if (fs.existsSync('/bin/bash'))
+        return '/bin/bash';
+    if (fs.existsSync('/bin/zsh'))
+        return '/bin/zsh';
+    return '/bin/sh';
+}
+/**
+ * Returns the shell arguments needed to execute a command.
+ * @param command - The command to execute
+ * @returns Array of shell arguments
+ */
+export function getShellArgs(command) {
+    if (process.platform === 'win32') {
+        return ['-NoProfile', '-Command', command];
+    }
+    return ['-c', command];
+}
+//# sourceMappingURL=shell.js.map

package/dist/utils/shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.js","sourceRoot":"","sources":["../../src/utils/shell.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,KAAK,CAAC,OAAO,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAC;AACrD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3C,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC;QACzC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAChE,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC;IAC3C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAoB;IACnD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IACD,IAAI,UAAU,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;IACpC,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAChC,IAAI,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,WAAW,CAAC;IACnD,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,UAAU,CAAC;IACjD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,OAAO,CAAC,YAAY,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACzB,CAAC"}

package/dist/utils/system-path.d.ts

@@ -0,0 +1,3 @@
+export declare function getExtendedNodePath(basePath?: string): string;
+export declare function findCommandInPath(command: string, searchPath: string): string | null;
+//# sourceMappingURL=system-path.d.ts.map

package/dist/utils/system-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-path.d.ts","sourceRoot":"","sources":["../../src/utils/system-path.ts"],"names":[],"mappings":"AAiGA,wBAAgB,mBAAmB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAgC7D;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA2BpF"}

package/dist/utils/system-path.js

@@ -0,0 +1,142 @@
+import { execSync } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+function getNvmNodePaths() {
+    const home = process.env.HOME || '';
+    const nvmVersionsDir = path.join(home, '.nvm', 'versions', 'node');
+    if (!fs.existsSync(nvmVersionsDir)) {
+        return [];
+    }
+    try {
+        const versions = fs.readdirSync(nvmVersionsDir)
+            .filter(name => name.startsWith('v'))
+            .sort((a, b) => {
+            const parseVersion = (v) => {
+                const parts = v.replace('v', '').split('.').map(Number);
+                return parts[0] * 10000 + (parts[1] || 0) * 100 + (parts[2] || 0);
+            };
+            return parseVersion(b) - parseVersion(a);
+        });
+        return versions.map(v => path.join(nvmVersionsDir, v, 'bin'));
+    }
+    catch {
+        return [];
+    }
+}
+function getFnmNodePaths() {
+    const home = process.env.HOME || '';
+    const fnmVersionsDir = path.join(home, '.fnm', 'node-versions');
+    if (!fs.existsSync(fnmVersionsDir)) {
+        return [];
+    }
+    try {
+        const versions = fs.readdirSync(fnmVersionsDir)
+            .filter(name => name.startsWith('v'))
+            .sort((a, b) => {
+            const parseVersion = (v) => {
+                const parts = v.replace('v', '').split('.').map(Number);
+                return parts[0] * 10000 + (parts[1] || 0) * 100 + (parts[2] || 0);
+            };
+            return parseVersion(b) - parseVersion(a);
+        });
+        return versions.map(v => path.join(fnmVersionsDir, v, 'installation', 'bin'));
+    }
+    catch {
+        return [];
+    }
+}
+function getCommonNodePaths() {
+    const home = process.env.HOME || '';
+    const nvmPaths = getNvmNodePaths();
+    const fnmPaths = getFnmNodePaths();
+    return [
+        ...nvmPaths,
+        ...fnmPaths,
+        '/opt/homebrew/bin',
+        '/usr/local/bin',
+        `${home}/.nvm/current/bin`,
+        `${home}/.volta/bin`,
+        `${home}/.asdf/shims`,
+        `${home}/.fnm/current/bin`,
+        `${home}/.nodenv/shims`,
+        '/usr/local/opt/node/bin',
+        '/opt/local/bin',
+        `${home}/.local/bin`,
+    ].filter(p => p && !p.includes('undefined'));
+}
+function getSystemPathFromPathHelper() {
+    if (process.platform !== 'darwin') {
+        return null;
+    }
+    try {
+        const output = execSync('/usr/libexec/path_helper -s', {
+            encoding: 'utf-8',
+            timeout: 5000,
+        });
+        const match = output.match(/PATH="([^"]+)"/);
+        if (match && match[1]) {
+            return match[1];
+        }
+    }
+    catch (err) {
+        console.warn('[SystemPath] path_helper failed:', err);
+    }
+    return null;
+}
+export function getExtendedNodePath(basePath) {
+    const base = basePath || process.env.PATH || '';
+    if (process.platform !== 'darwin') {
+        return base;
+    }
+    const nodePaths = getCommonNodePaths();
+    const systemPath = getSystemPathFromPathHelper();
+    const pathParts = [];
+    for (const p of nodePaths) {
+        if (fs.existsSync(p) && !pathParts.includes(p)) {
+            pathParts.push(p);
+        }
+    }
+    if (systemPath) {
+        for (const p of systemPath.split(':')) {
+            if (p && !pathParts.includes(p)) {
+                pathParts.push(p);
+            }
+        }
+    }
+    for (const p of base.split(':')) {
+        if (p && !pathParts.includes(p)) {
+            pathParts.push(p);
+        }
+    }
+    return pathParts.join(':');
+}
+export function findCommandInPath(command, searchPath) {
+    const delimiter = process.platform === 'win32' ? ';' : ':';
+    for (const dir of searchPath.split(delimiter)) {
+        if (!dir)
+            continue;
+        const fullPath = path.join(dir, command);
+        try {
+            if (fs.existsSync(fullPath)) {
+                const stats = fs.statSync(fullPath);
+                if (stats.isFile()) {
+                    if (process.platform !== 'win32') {
+                        try {
+                            fs.accessSync(fullPath, fs.constants.X_OK);
+                            return fullPath;
+                        }
+                        catch {
+                        }
+                    }
+                    else {
+                        return fullPath;
+                    }
+                }
+            }
+        }
+        catch {
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=system-path.js.map

package/dist/utils/system-path.js.map

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

package/dist/utils/task-status.d.ts

@@ -0,0 +1,7 @@
+import type { TaskStatus, TaskResult } from '../common/types/task.js';
+/**
+ * Maps a TaskResult status to a TaskStatus.
+ * Used when a task completes to determine the final task status.
+ */
+export declare function mapResultToStatus(result: TaskResult): TaskStatus;
+//# sourceMappingURL=task-status.d.ts.map

package/dist/utils/task-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-status.d.ts","sourceRoot":"","sources":["../../src/utils/task-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAEtE;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAIhE"}

package/dist/utils/task-status.js

@@ -0,0 +1,12 @@
+/**
+ * Maps a TaskResult status to a TaskStatus.
+ * Used when a task completes to determine the final task status.
+ */
+export function mapResultToStatus(result) {
+    if (result.status === 'success')
+        return 'completed';
+    if (result.status === 'interrupted')
+        return 'interrupted';
+    return 'failed';
+}
+//# sourceMappingURL=task-status.js.map

package/dist/utils/task-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-status.js","sourceRoot":"","sources":["../../src/utils/task-status.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAkB;IAClD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC;IACpD,IAAI,MAAM,CAAC,MAAM,KAAK,aAAa;QAAE,OAAO,aAAa,CAAC;IAC1D,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/utils/task-validation.d.ts

@@ -0,0 +1,10 @@
+import type { TaskConfig } from '../common/types/task.js';
+/**
+ * Validates and sanitizes a TaskConfig object.
+ * Ensures all fields are properly typed, trimmed, and within length limits.
+ *
+ * @param config - The task configuration to validate
+ * @returns A sanitized TaskConfig with all fields validated
+ */
+export declare function validateTaskConfig(config: TaskConfig): TaskConfig;
+//# sourceMappingURL=task-validation.d.ts.map

package/dist/utils/task-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-validation.d.ts","sourceRoot":"","sources":["../../src/utils/task-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAG1D;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CA8BjE"}

package/dist/utils/task-validation.js

@@ -0,0 +1,35 @@
+import { sanitizeString } from './sanitize.js';
+/**
+ * Validates and sanitizes a TaskConfig object.
+ * Ensures all fields are properly typed, trimmed, and within length limits.
+ *
+ * @param config - The task configuration to validate
+ * @returns A sanitized TaskConfig with all fields validated
+ */
+export function validateTaskConfig(config) {
+    const prompt = sanitizeString(config.prompt, 'prompt');
+    const validated = { prompt };
+    if (config.taskId) {
+        validated.taskId = sanitizeString(config.taskId, 'taskId', 128);
+    }
+    if (config.sessionId) {
+        validated.sessionId = sanitizeString(config.sessionId, 'sessionId', 128);
+    }
+    if (config.workingDirectory) {
+        validated.workingDirectory = sanitizeString(config.workingDirectory, 'workingDirectory', 1024);
+    }
+    if (Array.isArray(config.allowedTools)) {
+        validated.allowedTools = config.allowedTools
+            .filter((tool) => typeof tool === 'string')
+            .map((tool) => sanitizeString(tool, 'allowedTools', 64))
+            .slice(0, 20);
+    }
+    if (config.systemPromptAppend) {
+        validated.systemPromptAppend = sanitizeString(config.systemPromptAppend, 'systemPromptAppend');
+    }
+    if (config.outputSchema && typeof config.outputSchema === 'object') {
+        validated.outputSchema = config.outputSchema;
+    }
+    return validated;
+}
+//# sourceMappingURL=task-validation.js.map

package/dist/utils/task-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-validation.js","sourceRoot":"","sources":["../../src/utils/task-validation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAkB;IACnD,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACvD,MAAM,SAAS,GAAe,EAAE,MAAM,EAAE,CAAC;IAEzC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,SAAS,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,SAAS,CAAC,SAAS,GAAG,cAAc,CAAC,MAAM,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC5B,SAAS,CAAC,gBAAgB,GAAG,cAAc,CAAC,MAAM,CAAC,gBAAgB,EAAE,kBAAkB,EAAE,IAAI,CAAC,CAAC;IACjG,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QACvC,SAAS,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY;aACzC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC;aAC1D,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC;aACvD,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,MAAM,CAAC,kBAAkB,EAAE,CAAC;QAC9B,SAAS,CAAC,kBAAkB,GAAG,cAAc,CAC3C,MAAM,CAAC,kBAAkB,EACzB,oBAAoB,CACrB,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,YAAY,IAAI,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;QACnE,SAAS,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;IAC/C,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/utils/url.d.ts

@@ -0,0 +1,3 @@
+export declare function validateHttpUrl(urlString: string, fieldName?: string): URL;
+export declare function normalizeBaseUrl(baseUrl: string): string;
+//# sourceMappingURL=url.d.ts.map

package/dist/utils/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,SAAQ,GAAG,GAAG,CAazE;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/dist/utils/url.js

@@ -0,0 +1,19 @@
+export function validateHttpUrl(urlString, fieldName = 'URL') {
+    try {
+        const parsed = new URL(urlString);
+        if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
+            throw new Error(`${fieldName} must use http or https protocol`);
+        }
+        return parsed;
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.includes('protocol')) {
+            throw error;
+        }
+        throw new Error(`${fieldName} is not a valid URL`);
+    }
+}
+export function normalizeBaseUrl(baseUrl) {
+    return baseUrl.replace(/\/+$/, '');
+}
+//# sourceMappingURL=url.js.map

package/dist/utils/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe,CAAC,SAAiB,EAAE,SAAS,GAAG,KAAK;IAClE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;QAClC,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAChE,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,kCAAkC,CAAC,CAAC;QAClE,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACjE,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,qBAAqB,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACrC,CAAC"}

package/mcp-tools/ask-user-question/SKILL.md

@@ -0,0 +1,133 @@
+---
+name: ask-user-question
+description: Ask users questions via the UI. Use when you need clarification, user preferences, or confirmation before proceeding. The user CANNOT see CLI output - this tool is the ONLY way to communicate with them.
+---
+
+# Ask User Question
+
+Use this MCP tool to ask users questions and get their responses. This is the **ONLY** way to communicate with the user - they cannot see CLI/terminal output.
+
+## Critical Rule
+
+The user **CANNOT** see your text output or CLI prompts!
+
+If you write "Let me ask you..." and then just output text - **THE USER WILL NOT SEE IT**.
+You MUST call this tool to display a modal in the UI.
+
+## When to Use
+
+- Clarifying questions before starting ambiguous tasks
+- Asking user preferences (e.g., "How would you like files organized?")
+- Confirming actions before executing (especially destructive/irreversible ones)
+- Getting approval for sensitive actions (financial, messaging, deletion, etc.)
+- Any situation where you need user input to proceed
+
+## Parameters
+
+```json
+{
+  "questions": [{
+    "question": "Your question to the user",
+    "header": "Short label (max 12 chars)",
+    "options": [
+      { "label": "Option 1", "description": "What this does" },
+      { "label": "Option 2", "description": "What this does" }
+    ],
+    "multiSelect": false
+  }]
+}
+```
+
+- `question` (required): The question text to display
+- `header` (optional): Short category label, shown as modal title (max 12 chars)
+- `options` (optional): Array of selectable choices (2-4 recommended)
+- `multiSelect` (optional): Allow selecting multiple options (default: false)
+
+**Custom text input:** To allow users to type their own response, include an option with label "Other" (case-insensitive). When selected, the UI shows a text input field.
+
+```json
+{ "label": "Other", "description": "Type your own response" }
+```
+
+**Important:** When "Other" is selected, the response will be `User responded: [their text]` instead of `User selected: Other`. You must wait for and handle this text response - do NOT proceed as if they selected a predefined option.
+
+## Examples
+
+### Asking about organization preferences
+
+```
+AskUserQuestion({
+  "questions": [{
+    "question": "How would you like to organize your Downloads folder?",
+    "header": "Organize",
+    "options": [
+      { "label": "By file type", "description": "Group into Documents, Images, Videos, etc." },
+      { "label": "By date", "description": "Group by month/year" },
+      { "label": "By project", "description": "You'll help me name project folders" }
+    ]
+  }]
+})
+```
+
+### Confirming a destructive action
+
+```
+AskUserQuestion({
+  "questions": [{
+    "question": "Delete these 15 duplicate files?",
+    "header": "Confirm",
+    "options": [
+      { "label": "Delete all", "description": "Remove all 15 duplicates" },
+      { "label": "Review first", "description": "Show me the list before deleting" },
+      { "label": "Cancel", "description": "Don't delete anything" }
+    ]
+  }]
+})
+```
+
+### Simple yes/no confirmation
+
+```
+AskUserQuestion({
+  "questions": [{
+    "question": "Should I proceed with sending this email?",
+    "header": "Send email",
+    "options": [
+      { "label": "Send", "description": "Send the email now" },
+      { "label": "Cancel", "description": "Don't send" }
+    ]
+  }]
+})
+```
+
+## Response Format
+
+The tool returns the user's selection:
+- `User selected: By file type` - Single selection
+- `User selected: Option A, Option B` - Multiple selections (if multiSelect: true)
+- `User responded: [custom text]` - If user typed a custom response
+- `User declined to answer the question.` - If user dismissed the modal
+
+## Wrong vs Correct
+
+**WRONG** (user won't see this):
+```
+I'll help organize your files. How would you like them organized?
+- By type
+- By date
+- By project
+```
+
+**CORRECT** (user will see a modal):
+```
+AskUserQuestion({
+  "questions": [{
+    "question": "How would you like your files organized?",
+    "options": [
+      { "label": "By type" },
+      { "label": "By date" },
+      { "label": "By project" }
+    ]
+  }]
+})
+```