npm - @iaforged/context-code - Versions diffs - 1.3.5 → 1.3.6 - Mend

@iaforged/context-code 1.3.5 → 1.3.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1913) hide show

package/dist/src/core/tools/legacy/utils/uuid.js.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from './uuid.js';

package/dist/src/core/tools/legacy/utils/words.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../utils/words.js';

package/dist/src/core/tools/legacy/utils/worktree.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from './worktree.js';

package/dist/src/core/tools/legacy/utils/worktree.js.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from './worktree.js';

package/dist/src/core/tools/powerShellCliAdapter.js ADDED Viewed

@@ -0,0 +1,3 @@
+export * from './legacy/powerShellCliAdapter.impl.js';
+// Auto-completed re-exports
+export { getAllCommands, getPipelineSegments, getVariablesByScope, hasCommandNamed } from '../../utils/powershell/parser.js';

package/dist/src/core/usage/extraUsageCliAdapter.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from './legacy/extraUsageCliAdapter.impl.js';

package/dist/src/core/usage/extraUsageCore.js ADDED Viewed

@@ -0,0 +1,82 @@
+export async function runExtraUsageCore(deps) {
+    if (!deps.getHasVisitedExtraUsage()) {
+        deps.setHasVisitedExtraUsage();
+    }
+    deps.invalidateOverageCreditGrantCache();
+    const subscriptionType = deps.getSubscriptionType();
+    const isTeamOrEnterprise = subscriptionType === 'team' || subscriptionType === 'enterprise';
+    const hasBillingAccess = deps.hasClaudeAiBillingAccess();
+    if (!hasBillingAccess && isTeamOrEnterprise) {
+        let extraUsage;
+        try {
+            const utilization = await deps.fetchUtilization();
+            extraUsage = utilization?.extra_usage;
+        }
+        catch (error) {
+            deps.logError(error);
+        }
+        if (extraUsage?.is_enabled && extraUsage.monthly_limit === null) {
+            return {
+                type: 'message',
+                value: 'Your organization already has unlimited extra usage. No request needed.',
+            };
+        }
+        try {
+            const eligibility = await deps.checkAdminRequestEligibility('limit_increase');
+            if (eligibility?.is_allowed === false) {
+                return {
+                    type: 'message',
+                    value: 'Please contact your admin to manage extra usage settings.',
+                };
+            }
+        }
+        catch (error) {
+            deps.logError(error);
+        }
+        try {
+            const pendingOrDismissedRequests = await deps.getMyAdminRequests('limit_increase', ['pending', 'dismissed']);
+            if (pendingOrDismissedRequests && pendingOrDismissedRequests.length > 0) {
+                return {
+                    type: 'message',
+                    value: 'You have already submitted a request for extra usage to your admin.',
+                };
+            }
+        }
+        catch (error) {
+            deps.logError(error);
+        }
+        try {
+            await deps.createAdminRequest({
+                request_type: 'limit_increase',
+                details: null,
+            });
+            return {
+                type: 'message',
+                value: extraUsage?.is_enabled
+                    ? 'Request sent to your admin to increase extra usage.'
+                    : 'Request sent to your admin to enable extra usage.',
+            };
+        }
+        catch (error) {
+            deps.logError(error);
+        }
+        return {
+            type: 'message',
+            value: 'Please contact your admin to manage extra usage settings.',
+        };
+    }
+    const url = isTeamOrEnterprise
+        ? 'https://claude.ai/admin-settings/usage'
+        : 'https://claude.ai/settings/usage';
+    try {
+        const opened = await deps.openBrowser(url);
+        return { type: 'browser-opened', url, opened };
+    }
+    catch (error) {
+        deps.logError(error);
+        return {
+            type: 'message',
+            value: `Failed to open browser. Please visit ${url} to manage extra usage.`,
+        };
+    }
+}

package/dist/src/core/usage/extraUsageCore.smoke.js ADDED Viewed

@@ -0,0 +1,27 @@
+import { runExtraUsageCore } from './extraUsageCore.js';
+export async function runExtraUsageCoreSmoke() {
+    const result = await runExtraUsageCore({
+        getHasVisitedExtraUsage: () => false,
+        setHasVisitedExtraUsage: () => { },
+        invalidateOverageCreditGrantCache: () => { },
+        getSubscriptionType: () => 'pro',
+        hasClaudeAiBillingAccess: () => true,
+        fetchUtilization: async () => null,
+        checkAdminRequestEligibility: async () => ({ is_allowed: true }),
+        getMyAdminRequests: async () => [],
+        createAdminRequest: async () => { },
+        openBrowser: async () => true,
+        logError: () => { },
+    });
+    if (result.type !== 'browser-opened') {
+        throw new Error('expected browser-opened');
+    }
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+    runExtraUsageCoreSmoke()
+        .then(() => console.log('usage.extraUsageCore.smoke PASS'))
+        .catch(error => {
+        console.error('usage.extraUsageCore.smoke FAIL', error);
+        process.exitCode = 1;
+    });
+}

package/dist/src/core/usage/indexCliAdapter.js ADDED Viewed

@@ -0,0 +1,4 @@
+export * from './legacy/indexCliAdapter.impl.js';
+// Auto-completed re-exports
+export { isEnvTruthy } from '../../utils/envUtils.js';
+export { getIsNonInteractiveSession, getIsRemoteMode } from '../../bootstrap/state.js';

package/dist/src/core/usage/indexCore.js ADDED Viewed

@@ -0,0 +1,12 @@
+export function isExtraUsageAllowedCore(deps, env) {
+    if (deps.isEnvTruthy(env.DISABLE_EXTRA_USAGE_COMMAND)) {
+        return false;
+    }
+    return deps.isOverageProvisioningAllowed();
+}
+export function isExtraUsageInteractiveEnabledCore(deps, env) {
+    return isExtraUsageAllowedCore(deps, env) && !deps.getIsNonInteractiveSession();
+}
+export function isExtraUsageNonInteractiveEnabledCore(deps, env) {
+    return isExtraUsageAllowedCore(deps, env) && deps.getIsNonInteractiveSession();
+}

package/dist/src/core/usage/legacy/bootstrap/state.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../bootstrap/state.js';

package/dist/src/core/usage/legacy/deps.js ADDED Viewed

@@ -0,0 +1,11 @@
+import { getIsNonInteractiveSession } from '../../../bootstrap/state.js';
+import { checkAdminRequestEligibility, createAdminRequest, getMyAdminRequests, } from '../../../services/api/adminRequests.js';
+import { invalidateOverageCreditGrantCache } from '../../../services/api/overageCreditGrant.js';
+import { fetchUtilization } from '../../../services/api/usage.js';
+import { getSubscriptionType, isOverageProvisioningAllowed } from '../../../utils/auth.js';
+import { hasClaudeAiBillingAccess } from '../../../utils/billing.js';
+import { openBrowser } from '../../../utils/browser.js';
+import { isEnvTruthy } from '../../../utils/envUtils.js';
+import { getGlobalConfig, saveGlobalConfig } from '../../../utils/config.js';
+import { logError } from '../../../utils/log.js';
+export { checkAdminRequestEligibility, createAdminRequest, fetchUtilization, getGlobalConfig, getIsNonInteractiveSession, getMyAdminRequests, getSubscriptionType, hasClaudeAiBillingAccess, invalidateOverageCreditGrantCache, isEnvTruthy, isOverageProvisioningAllowed, logError, openBrowser, saveGlobalConfig, };

package/dist/src/core/usage/legacy/extraUsageCliAdapter.impl.js ADDED Viewed

@@ -0,0 +1,16 @@
+import { checkAdminRequestEligibility, createAdminRequest, fetchUtilization, getGlobalConfig, getMyAdminRequests, getSubscriptionType, hasClaudeAiBillingAccess, invalidateOverageCreditGrantCache, logError, openBrowser, saveGlobalConfig, } from './deps.js';
+export const cliExtraUsageDeps = {
+    getHasVisitedExtraUsage: () => getGlobalConfig().hasVisitedExtraUsage === true,
+    setHasVisitedExtraUsage: () => {
+        saveGlobalConfig(prev => ({ ...prev, hasVisitedExtraUsage: true }));
+    },
+    invalidateOverageCreditGrantCache,
+    getSubscriptionType,
+    hasClaudeAiBillingAccess,
+    fetchUtilization,
+    checkAdminRequestEligibility,
+    getMyAdminRequests,
+    createAdminRequest,
+    openBrowser,
+    logError: error => logError(error),
+};

package/dist/src/core/usage/legacy/indexCliAdapter.impl.js ADDED Viewed

@@ -0,0 +1,6 @@
+import { getIsNonInteractiveSession, isEnvTruthy, isOverageProvisioningAllowed } from './deps.js';
+export const extraUsageIndexCliDeps = {
+    getIsNonInteractiveSession,
+    isOverageProvisioningAllowed,
+    isEnvTruthy,
+};

package/dist/src/core/usage/legacy/services/api/adminRequests.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/api/adminRequests.js';

package/dist/src/core/usage/legacy/services/api/overageCreditGrant.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/api/overageCreditGrant.js';

package/dist/src/core/usage/legacy/services/api/usage.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/api/usage.js';

package/dist/src/core/usage/legacy/utils/auth.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../utils/auth.js';

package/dist/src/core/usage/legacy/utils/billing.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../utils/billing.js';

package/dist/src/core/usage/legacy/utils/browser.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../utils/browser.js';

package/dist/src/core/usage/legacy/utils/config.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../utils/config.js';

package/dist/src/core/usage/legacy/utils/envUtils.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../utils/envUtils.js';

package/dist/src/core/usage/legacy/utils/log.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../utils/log.js';

package/dist/src/core/utils/legacy/bootstrap/state.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../bootstrap/state.js';

package/dist/src/core/utils/legacy/hooks/useCanUseTool.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../hooks/useCanUseTool.js';

package/dist/src/core/utils/legacy/hooks/useIdeSelection.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../hooks/useIdeSelection.js';

package/dist/src/core/utils/legacy/hooks/useTimeout.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../hooks/useTimeout.js';

package/dist/src/core/utils/legacy/services/MagicDocs/magicDocs.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/MagicDocs/magicDocs.js';

package/dist/src/core/utils/legacy/services/analytics/datadog.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/analytics/datadog.js';

package/dist/src/core/utils/legacy/services/analytics/firstPartyEventLogger.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/analytics/firstPartyEventLogger.js';

package/dist/src/core/utils/legacy/services/analytics/growthbook.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/analytics/growthbook.js';

package/dist/src/core/utils/legacy/services/analytics/index.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/analytics/index.js';

package/dist/src/core/utils/legacy/services/analytics/metadata.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/analytics/metadata.js';

package/dist/src/core/utils/legacy/services/analytics/sink.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/analytics/sink.js';

package/dist/src/core/utils/legacy/services/api/claude.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/api/claude.js';

package/dist/src/core/utils/legacy/services/api/client.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/api/client.js';

package/dist/src/core/utils/legacy/services/api/dumpPrompts.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/api/dumpPrompts.js';

package/dist/src/core/utils/legacy/services/api/errorUtils.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/api/errorUtils.js';

package/dist/src/core/utils/legacy/services/api/errors.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/api/errors.js';

package/dist/src/core/utils/legacy/services/api/logging.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/api/logging.js';

package/dist/src/core/utils/legacy/services/api/openai.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/api/openai.js';

package/dist/src/core/utils/legacy/services/api/withRetry.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/api/withRetry.js';

package/dist/src/core/utils/legacy/services/autoDream/autoDream.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/autoDream/autoDream.js';

package/dist/src/core/utils/legacy/services/compact/autoCompact.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/compact/autoCompact.js';

package/dist/src/core/utils/legacy/services/compact/snipCompact.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../services/compact/snipCompact.js';

package/dist/src/core/utils/legacy/services/compact/snipProjection.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../services/compact/snipProjection.js';

package/dist/src/core/utils/legacy/services/contextCollapse/persist.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../services/contextCollapse/persist.js';

package/dist/src/core/utils/legacy/services/diagnosticTracking.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../services/diagnosticTracking.js';

package/dist/src/core/utils/legacy/services/extractMemories/extractMemories.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/extractMemories/extractMemories.js';

package/dist/src/core/utils/legacy/services/lsp/LSPDiagnosticRegistry.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/lsp/LSPDiagnosticRegistry.js';

package/dist/src/core/utils/legacy/services/lsp/manager.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/lsp/manager.js';

package/dist/src/core/utils/legacy/services/lsp/types.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/lsp/types.js';

package/dist/src/core/utils/legacy/services/mcp/client.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/mcp/client.js';

package/dist/src/core/utils/legacy/services/mcp/envExpansion.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/mcp/envExpansion.js';

package/dist/src/core/utils/legacy/services/mcp/mcpStringUtils.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/mcp/mcpStringUtils.js';

package/dist/src/core/utils/legacy/services/mcp/normalization.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/mcp/normalization.js';

package/dist/src/core/utils/legacy/services/mcp/types.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/mcp/types.js';

package/dist/src/core/utils/legacy/services/mcp/utils.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/mcp/utils.js';

package/dist/src/core/utils/legacy/services/oauth/types.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/oauth/types.js';

package/dist/src/core/utils/legacy/services/plugins/PluginInstallationManager.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/plugins/PluginInstallationManager.js';

package/dist/src/core/utils/legacy/services/plugins/pluginOperations.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/plugins/pluginOperations.js';

package/dist/src/core/utils/legacy/services/remoteManagedSettings/syncCache.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/remoteManagedSettings/syncCache.js';

package/dist/src/core/utils/legacy/services/sessionTranscript/sessionTranscript.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../services/sessionTranscript/sessionTranscript.js';

package/dist/src/core/utils/legacy/services/skillSearch/featureCheck.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../services/skillSearch/featureCheck.js';

package/dist/src/core/utils/legacy/services/skillSearch/prefetch.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../services/skillSearch/prefetch.js';

package/dist/src/core/utils/legacy/services/skillSearch/signals.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../services/skillSearch/signals.js';

package/dist/src/core/utils/legacy/services/teamMemorySync/watcher.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/teamMemorySync/watcher.js';

package/dist/src/core/utils/legacy/services/tokenEstimation.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../services/tokenEstimation.js';

package/dist/src/core/utils/legacy/services/tools/toolOrchestration.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/tools/toolOrchestration.js';

package/dist/src/core/utils/legacy/state/AppState.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../state/AppState.js';

package/dist/src/core/utils/legacy/state/AppStateStore.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../state/AppStateStore.js';

package/dist/src/core/utils/legacy/state/selectors.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../state/selectors.js';

package/dist/src/core/utils/legacy/tasks/InProcessTeammateTask/types.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../tasks/InProcessTeammateTask/types.js';

package/dist/src/core/utils/legacy/tasks/LocalAgentTask/LocalAgentTask.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../tasks/LocalAgentTask/LocalAgentTask.js';

package/dist/src/core/utils/legacy/tasks/LocalShellTask/LocalShellTask.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../tasks/LocalShellTask/LocalShellTask.js';

package/dist/src/core/utils/legacy/utils/format.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../utils/format.js';

package/dist/src/core/voice/cliAdapter.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from './legacy/cliAdapter.impl.js';

package/dist/src/core/voice/legacy/cliAdapter.impl.js ADDED Viewed

@@ -0,0 +1,41 @@
+import { normalizeLanguageForSTT } from '../../../hooks/useVoice.js';
+import { getShortcutDisplay } from '../../../keybindings/shortcutFormat.js';
+import { logEvent } from '../../../services/analytics/index.js';
+import { checkLocalDictationConfiguration, getLocalDictationStatus, installLocalDictation, } from '../../../services/localDictation.js';
+import { getGlobalConfig, saveGlobalConfig } from '../../../utils/config.js';
+import { settingsChangeDetector } from '../../../utils/settings/changeDetector.js';
+import { getInitialSettings, updateSettingsForSource, } from '../../../utils/settings/settings.js';
+import { isVoiceModeEnabled } from '../../../voice/voiceModeEnabled.js';
+export async function createVoiceCoreDeps() {
+    const voiceModule = await import('../../../services/voice.js');
+    return {
+        isVoiceModeEnabled,
+        getStatus: getLocalDictationStatus,
+        install: installLocalDictation,
+        getInitialSettings,
+        updateSettingsVoiceEnabled: enabled => updateSettingsForSource('userSettings', { voiceEnabled: enabled }),
+        notifySettingsChanged: () => settingsChangeDetector.notifyChange('userSettings'),
+        logToggleEvent: enabled => logEvent('tengu_voice_toggled', { enabled }),
+        checkLocalDictationConfiguration,
+        checkRecordingAvailability: voiceModule.checkRecordingAvailability,
+        checkVoiceDependencies: voiceModule.checkVoiceDependencies,
+        requestMicrophonePermission: voiceModule.requestMicrophonePermission,
+        getPlatform: () => process.platform,
+        getShortcutDisplay: () => getShortcutDisplay('voice:pushToTalk', 'Chat', 'Space'),
+        normalizeLanguageForSTT,
+        getVoiceHintState: () => {
+            const cfg = getGlobalConfig();
+            return {
+                shownCount: cfg.voiceLangHintShownCount,
+                lastLanguage: cfg.voiceLangHintLastLanguage,
+            };
+        },
+        saveVoiceHintState: next => {
+            saveGlobalConfig(prev => ({
+                ...prev,
+                voiceLangHintShownCount: next.shownCount,
+                voiceLangHintLastLanguage: next.lastLanguage,
+            }));
+        },
+    };
+}

package/dist/src/core/voice/legacy/services/analytics/growthbook.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/analytics/growthbook.js';

package/dist/src/core/voice/legacy/services/analytics/growthbook.js.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from '../../../../../services/analytics/growthbook.js';

package/dist/src/core/voice/runtime.js ADDED Viewed

@@ -0,0 +1,151 @@
+const LANG_HINT_MAX_SHOWS = 2;
+export function parseVoiceArgs(args) {
+    const tokens = args.trim().split(/\s+/).filter(Boolean);
+    if (tokens.length === 0) {
+        return { action: 'toggle' };
+    }
+    const [command, ...rest] = tokens;
+    switch (command.toLowerCase()) {
+        case 'install':
+        case 'instalar':
+            return { action: 'install', value: rest.join(' ').trim() || undefined };
+        case 'status':
+        case 'estado':
+            return { action: 'status' };
+        case 'help':
+        case 'ayuda':
+            return { action: 'help' };
+        default:
+            return { action: 'help' };
+    }
+}
+export function getVoiceUsageText() {
+    return [
+        'Uso de /dictar:',
+        '/dictar',
+        '/dictar install [modelo]',
+        '/dictar status',
+        '',
+        'Modelo por defecto: base (multidioma).',
+        'Ejemplos:',
+        '- /dictar install',
+        '- /dictar install base',
+    ].join('\n');
+}
+function getMicrophoneGuidance(platform) {
+    if (platform === 'win32')
+        return 'Configuracion > Privacidad > Microfono';
+    if (platform === 'linux')
+        return 'la configuracion de audio del sistema';
+    return 'System Settings > Privacy & Security > Microphone';
+}
+export async function runVoiceCommandCore(args, deps) {
+    if (!deps.isVoiceModeEnabled()) {
+        return { type: 'text', value: 'El modo de dictado no esta disponible.' };
+    }
+    const parsed = parseVoiceArgs(args);
+    if (parsed.action === 'help') {
+        return { type: 'text', value: getVoiceUsageText() };
+    }
+    if (parsed.action === 'status') {
+        return { type: 'text', value: await deps.getStatus() };
+    }
+    if (parsed.action === 'install') {
+        try {
+            const result = await deps.install(parsed.value);
+            return {
+                type: 'text',
+                value: `Instalacion completada.\n` +
+                    `Backend: ${result.executablePath}\n` +
+                    `Modelo: ${result.modelPath}\n` +
+                    `Release: ${result.releaseTag}\n\n` +
+                    `Ahora ejecuta /dictar para activarlo.`,
+            };
+        }
+        catch (error) {
+            return {
+                type: 'text',
+                value: `No se pudo instalar el backend de dictado.\n` +
+                    `${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    }
+    const currentSettings = deps.getInitialSettings();
+    const isCurrentlyEnabled = currentSettings.voiceEnabled === true;
+    if (isCurrentlyEnabled) {
+        const result = deps.updateSettingsVoiceEnabled(false);
+        if (result.error) {
+            return {
+                type: 'text',
+                value: 'No se pudo actualizar la configuracion. Revisa tu archivo de settings.',
+            };
+        }
+        deps.notifySettingsChanged();
+        deps.logToggleEvent(false);
+        return { type: 'text', value: 'Modo de dictado desactivado.' };
+    }
+    const dictation = await deps.checkLocalDictationConfiguration();
+    if (!dictation.available) {
+        return {
+            type: 'text',
+            value: dictation.error ?? 'El dictado local no esta configurado.',
+        };
+    }
+    const recording = await deps.checkRecordingAvailability();
+    if (!recording.available) {
+        return {
+            type: 'text',
+            value: recording.reason ??
+                'El modo de dictado no esta disponible en este entorno.',
+        };
+    }
+    const voiceDeps = await deps.checkVoiceDependencies();
+    if (!voiceDeps.available) {
+        const hint = voiceDeps.installCommand
+            ? `\nInstala las herramientas de audio con: ${voiceDeps.installCommand}`
+            : '\nInstala manualmente las herramientas de grabacion de audio.';
+        return {
+            type: 'text',
+            value: `No se encontro una herramienta de grabacion de audio.${hint}`,
+        };
+    }
+    if (!(await deps.requestMicrophonePermission())) {
+        const guidance = getMicrophoneGuidance(deps.getPlatform());
+        return {
+            type: 'text',
+            value: `El acceso al microfono esta denegado. Habilitalo en ${guidance} y luego ejecuta /dictar otra vez.`,
+        };
+    }
+    const enableResult = deps.updateSettingsVoiceEnabled(true);
+    if (enableResult.error) {
+        return {
+            type: 'text',
+            value: 'No se pudo actualizar la configuracion. Revisa tu archivo de settings.',
+        };
+    }
+    deps.notifySettingsChanged();
+    deps.logToggleEvent(true);
+    const key = deps.getShortcutDisplay();
+    const stt = deps.normalizeLanguageForSTT(currentSettings.language);
+    const cfg = deps.getVoiceHintState();
+    const langChanged = cfg.lastLanguage !== stt.code;
+    const priorCount = langChanged ? 0 : (cfg.shownCount ?? 0);
+    const showHint = priorCount < LANG_HINT_MAX_SHOWS;
+    let langNote = '';
+    if (stt.fellBackFrom) {
+        langNote = ` Nota: "${stt.fellBackFrom}" no esta soportado por el backend local; se usara deteccion automatica.`;
+    }
+    else if (showHint) {
+        langNote = ` Idioma de dictado: ${stt.code} (/config para cambiarlo).`;
+    }
+    if (langChanged || showHint) {
+        deps.saveVoiceHintState({
+            shownCount: priorCount + (showHint ? 1 : 0),
+            lastLanguage: stt.code,
+        });
+    }
+    return {
+        type: 'text',
+        value: `Modo de dictado activado. Manten ${key} presionado para grabar.${langNote}`,
+    };
+}