@machina.ai/cell-cli 1.20.2-rc1 → 1.25.0-rc3

package/dist/src/ui/commands/skillsCommand.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type SlashCommand } from './types.js';
+export declare const skillsCommand: SlashCommand;

package/dist/src/ui/commands/skillsCommand.js

@@ -0,0 +1,235 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { CommandKind, } from './types.js';
+import { MessageType, } from '../types.js';
+import { SettingScope } from '../../config/settings.js';
+import { enableSkill, disableSkill } from '../../utils/skillSettings.js';
+import { renderSkillActionFeedback } from '../../utils/skillUtils.js';
+async function listAction(context, args) {
+    const subArgs = args.trim().split(/\s+/);
+    // Default to SHOWING descriptions. The user can hide them with 'nodesc'.
+    let useShowDescriptions = true;
+    let showAll = false;
+    for (const arg of subArgs) {
+        if (arg === 'nodesc' || arg === '--nodesc') {
+            useShowDescriptions = false;
+        }
+        else if (arg === 'all' || arg === '--all') {
+            showAll = true;
+        }
+    }
+    const skillManager = context.services.config?.getSkillManager();
+    if (!skillManager) {
+        context.ui.addItem({
+            type: MessageType.ERROR,
+            text: 'Could not retrieve skill manager.',
+        });
+        return;
+    }
+    const skills = showAll
+        ? skillManager.getAllSkills()
+        : skillManager.getAllSkills().filter((s) => !s.isBuiltin);
+    const skillsListItem = {
+        type: MessageType.SKILLS_LIST,
+        skills: skills.map((skill) => ({
+            name: skill.name,
+            description: skill.description,
+            disabled: skill.disabled,
+            location: skill.location,
+            body: skill.body,
+            isBuiltin: skill.isBuiltin,
+        })),
+        showDescriptions: useShowDescriptions,
+    };
+    context.ui.addItem(skillsListItem);
+}
+async function disableAction(context, args) {
+    const skillName = args.trim();
+    if (!skillName) {
+        context.ui.addItem({
+            type: MessageType.ERROR,
+            text: 'Please provide a skill name to disable.',
+        });
+        return;
+    }
+    const skillManager = context.services.config?.getSkillManager();
+    if (skillManager?.isAdminEnabled() === false) {
+        context.ui.addItem({
+            type: MessageType.ERROR,
+            text: 'Agent skills are disabled by your admin.',
+        }, Date.now());
+        return;
+    }
+    const skill = skillManager?.getSkill(skillName);
+    if (!skill) {
+        context.ui.addItem({
+            type: MessageType.ERROR,
+            text: `Skill "${skillName}" not found.`,
+        }, Date.now());
+        return;
+    }
+    const scope = context.services.settings.workspace.path
+        ? SettingScope.Workspace
+        : SettingScope.User;
+    const result = disableSkill(context.services.settings, skillName, scope);
+    let feedback = renderSkillActionFeedback(result, (label, path) => `${label} (${path})`);
+    if (result.status === 'success') {
+        feedback += ' Use "/skills reload" for it to take effect.';
+    }
+    context.ui.addItem({
+        type: MessageType.INFO,
+        text: feedback,
+    });
+}
+async function enableAction(context, args) {
+    const skillName = args.trim();
+    if (!skillName) {
+        context.ui.addItem({
+            type: MessageType.ERROR,
+            text: 'Please provide a skill name to enable.',
+        });
+        return;
+    }
+    const skillManager = context.services.config?.getSkillManager();
+    if (skillManager?.isAdminEnabled() === false) {
+        context.ui.addItem({
+            type: MessageType.ERROR,
+            text: 'Agent skills are disabled by your admin.',
+        }, Date.now());
+        return;
+    }
+    const result = enableSkill(context.services.settings, skillName);
+    let feedback = renderSkillActionFeedback(result, (label, path) => `${label} (${path})`);
+    if (result.status === 'success') {
+        feedback += ' Use "/skills reload" for it to take effect.';
+    }
+    context.ui.addItem({
+        type: MessageType.INFO,
+        text: feedback,
+    });
+}
+async function reloadAction(context) {
+    const config = context.services.config;
+    if (!config) {
+        context.ui.addItem({
+            type: MessageType.ERROR,
+            text: 'Could not retrieve configuration.',
+        });
+        return;
+    }
+    const skillManager = config.getSkillManager();
+    const beforeNames = new Set(skillManager.getSkills().map((s) => s.name));
+    const startTime = Date.now();
+    let pendingItemSet = false;
+    const pendingTimeout = setTimeout(() => {
+        context.ui.setPendingItem({
+            type: MessageType.INFO,
+            text: 'Reloading agent skills...',
+        });
+        pendingItemSet = true;
+    }, 100);
+    try {
+        await config.reloadSkills();
+        clearTimeout(pendingTimeout);
+        if (pendingItemSet) {
+            // If we showed the pending item, make sure it stays for at least 500ms
+            // total to avoid a "flicker" where it appears and immediately disappears.
+            const elapsed = Date.now() - startTime;
+            const minVisibleDuration = 500;
+            if (elapsed < minVisibleDuration) {
+                await new Promise((resolve) => setTimeout(resolve, minVisibleDuration - elapsed));
+            }
+            context.ui.setPendingItem(null);
+        }
+        const afterSkills = skillManager.getSkills();
+        const afterNames = new Set(afterSkills.map((s) => s.name));
+        const added = afterSkills.filter((s) => !beforeNames.has(s.name));
+        const removedCount = [...beforeNames].filter((name) => !afterNames.has(name)).length;
+        let successText = 'Agent skills reloaded successfully.';
+        const details = [];
+        if (added.length > 0) {
+            details.push(`${added.length} newly available skill${added.length > 1 ? 's' : ''}`);
+        }
+        if (removedCount > 0) {
+            details.push(`${removedCount} skill${removedCount > 1 ? 's' : ''} no longer available`);
+        }
+        if (details.length > 0) {
+            successText += ` ${details.join(' and ')}.`;
+        }
+        context.ui.addItem({
+            type: 'info',
+            text: successText,
+            icon: '✓ ',
+            color: 'green',
+        });
+    }
+    catch (error) {
+        clearTimeout(pendingTimeout);
+        if (pendingItemSet) {
+            context.ui.setPendingItem(null);
+        }
+        context.ui.addItem({
+            type: MessageType.ERROR,
+            text: `Failed to reload skills: ${error instanceof Error ? error.message : String(error)}`,
+        });
+    }
+}
+function disableCompletion(context, partialArg) {
+    const skillManager = context.services.config?.getSkillManager();
+    if (!skillManager) {
+        return [];
+    }
+    return skillManager
+        .getAllSkills()
+        .filter((s) => !s.disabled && s.name.startsWith(partialArg))
+        .map((s) => s.name);
+}
+function enableCompletion(context, partialArg) {
+    const skillManager = context.services.config?.getSkillManager();
+    if (!skillManager) {
+        return [];
+    }
+    return skillManager
+        .getAllSkills()
+        .filter((s) => s.disabled && s.name.startsWith(partialArg))
+        .map((s) => s.name);
+}
+export const skillsCommand = {
+    name: 'skills',
+    description: 'List, enable, disable, or reload Cell CLI agent skills. Usage: /skills [list | disable <name> | enable <name> | reload]',
+    kind: CommandKind.BUILT_IN,
+    autoExecute: false,
+    subCommands: [
+        {
+            name: 'list',
+            description: 'List available agent skills. Usage: /skills list [nodesc] [all]',
+            kind: CommandKind.BUILT_IN,
+            action: listAction,
+        },
+        {
+            name: 'disable',
+            description: 'Disable a skill by name. Usage: /skills disable <name>',
+            kind: CommandKind.BUILT_IN,
+            action: disableAction,
+            completion: disableCompletion,
+        },
+        {
+            name: 'enable',
+            description: 'Enable a disabled skill by name. Usage: /skills enable <name>',
+            kind: CommandKind.BUILT_IN,
+            action: enableAction,
+            completion: enableCompletion,
+        },
+        {
+            name: 'reload',
+            description: 'Reload the list of discovered skills. Usage: /skills reload',
+            kind: CommandKind.BUILT_IN,
+            action: reloadAction,
+        },
+    ],
+    action: listAction,
+};
+//# sourceMappingURL=skillsCommand.js.map

package/dist/src/ui/commands/skillsCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillsCommand.js","sourceRoot":"","sources":["../../../../src/ui/commands/skillsCommand.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAIL,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,WAAW,GAGZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,KAAK,UAAU,UAAU,CACvB,OAAuB,EACvB,IAAY;IAEZ,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEzC,yEAAyE;IACzE,IAAI,mBAAmB,GAAG,IAAI,CAAC;IAC/B,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;YAC3C,mBAAmB,GAAG,KAAK,CAAC;QAC9B,CAAC;aAAM,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;YAC5C,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC;IAChE,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC;YACjB,IAAI,EAAE,WAAW,CAAC,KAAK;YACvB,IAAI,EAAE,mCAAmC;SAC1C,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,OAAO;QACpB,CAAC,CAAC,YAAY,CAAC,YAAY,EAAE;QAC7B,CAAC,CAAC,YAAY,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAE5D,MAAM,cAAc,GAA0B;QAC5C,IAAI,EAAE,WAAW,CAAC,WAAW;QAC7B,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC7B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,CAAC,CAAC;QACH,gBAAgB,EAAE,mBAAmB;KACtC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;AACrC,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,OAAuB,EACvB,IAAY;IAEZ,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC;YACjB,IAAI,EAAE,WAAW,CAAC,KAAK;YACvB,IAAI,EAAE,yCAAyC;SAChD,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IACD,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC;IAChE,IAAI,YAAY,EAAE,cAAc,EAAE,KAAK,KAAK,EAAE,CAAC;QAC7C,OAAO,CAAC,EAAE,CAAC,OAAO,CAChB;YACE,IAAI,EAAE,WAAW,CAAC,KAAK;YACvB,IAAI,EAAE,0CAA0C;SACjD,EACD,IAAI,CAAC,GAAG,EAAE,CACX,CAAC;QACF,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAG,YAAY,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAChD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,EAAE,CAAC,OAAO,CAChB;YACE,IAAI,EAAE,WAAW,CAAC,KAAK;YACvB,IAAI,EAAE,UAAU,SAAS,cAAc;SACxC,EACD,IAAI,CAAC,GAAG,EAAE,CACX,CAAC;QACF,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI;QACpD,CAAC,CAAC,YAAY,CAAC,SAAS;QACxB,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC;IAEtB,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IAEzE,IAAI,QAAQ,GAAG,yBAAyB,CACtC,MAAM,EACN,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,KAAK,KAAK,IAAI,GAAG,CACtC,CAAC;IACF,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,QAAQ,IAAI,8CAA8C,CAAC;IAC7D,CAAC;IAED,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC;QACjB,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,IAAI,EAAE,QAAQ;KACf,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,OAAuB,EACvB,IAAY;IAEZ,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC;YACjB,IAAI,EAAE,WAAW,CAAC,KAAK;YACvB,IAAI,EAAE,wCAAwC;SAC/C,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC;IAChE,IAAI,YAAY,EAAE,cAAc,EAAE,KAAK,KAAK,EAAE,CAAC;QAC7C,OAAO,CAAC,EAAE,CAAC,OAAO,CAChB;YACE,IAAI,EAAE,WAAW,CAAC,KAAK;YACvB,IAAI,EAAE,0CAA0C;SACjD,EACD,IAAI,CAAC,GAAG,EAAE,CACX,CAAC;QACF,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAEjE,IAAI,QAAQ,GAAG,yBAAyB,CACtC,MAAM,EACN,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,KAAK,KAAK,IAAI,GAAG,CACtC,CAAC;IACF,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,QAAQ,IAAI,8CAA8C,CAAC;IAC7D,CAAC;IAED,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC;QACjB,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,IAAI,EAAE,QAAQ;KACf,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,OAAuB;IAEvB,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IACvC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC;YACjB,IAAI,EAAE,WAAW,CAAC,KAAK;YACvB,IAAI,EAAE,mCAAmC;SAC1C,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC;IAC9C,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAEzE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,IAAI,cAAc,GAAG,KAAK,CAAC;IAC3B,MAAM,cAAc,GAAG,UAAU,CAAC,GAAG,EAAE;QACrC,OAAO,CAAC,EAAE,CAAC,cAAc,CAAC;YACxB,IAAI,EAAE,WAAW,CAAC,IAAI;YACtB,IAAI,EAAE,2BAA2B;SAClC,CAAC,CAAC;QACH,cAAc,GAAG,IAAI,CAAC;IACxB,CAAC,EAAE,GAAG,CAAC,CAAC;IAER,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,YAAY,EAAE,CAAC;QAE5B,YAAY,CAAC,cAAc,CAAC,CAAC;QAC7B,IAAI,cAAc,EAAE,CAAC;YACnB,uEAAuE;YACvE,0EAA0E;YAC1E,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YACvC,MAAM,kBAAkB,GAAG,GAAG,CAAC;YAC/B,IAAI,OAAO,GAAG,kBAAkB,EAAE,CAAC;gBACjC,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAC5B,UAAU,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAClD,CAAC;YACJ,CAAC;YACD,OAAO,CAAC,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;QAED,MAAM,WAAW,GAAG,YAAY,CAAC,SAAS,EAAE,CAAC;QAC7C,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAE3D,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAClE,MAAM,YAAY,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC,MAAM,CAC1C,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAChC,CAAC,MAAM,CAAC;QAET,IAAI,WAAW,GAAG,qCAAqC,CAAC;QACxD,MAAM,OAAO,GAAa,EAAE,CAAC;QAE7B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CACV,GAAG,KAAK,CAAC,MAAM,yBAAyB,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACtE,CAAC;QACJ,CAAC;QACD,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CACV,GAAG,YAAY,SAAS,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,sBAAsB,CAC1E,CAAC;QACJ,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,WAAW,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;QAC9C,CAAC;QAED,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC;YACjB,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,OAAO;SACI,CAAC,CAAC;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,YAAY,CAAC,cAAc,CAAC,CAAC;QAC7B,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO,CAAC,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC;YACjB,IAAI,EAAE,WAAW,CAAC,KAAK;YACvB,IAAI,EAAE,4BAA4B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;SAC3F,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CACxB,OAAuB,EACvB,UAAkB;IAElB,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC;IAChE,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,YAAY;SAChB,YAAY,EAAE;SACd,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;SAC3D,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED,SAAS,gBAAgB,CACvB,OAAuB,EACvB,UAAkB;IAElB,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC;IAChE,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,YAAY;SAChB,YAAY,EAAE;SACd,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;SAC1D,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAiB;IACzC,IAAI,EAAE,QAAQ;IACd,WAAW,EACT,yHAAyH;IAC3H,IAAI,EAAE,WAAW,CAAC,QAAQ;IAC1B,WAAW,EAAE,KAAK;IAClB,WAAW,EAAE;QACX;YACE,IAAI,EAAE,MAAM;YACZ,WAAW,EACT,iEAAiE;YACnE,IAAI,EAAE,WAAW,CAAC,QAAQ;YAC1B,MAAM,EAAE,UAAU;SACnB;QACD;YACE,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,wDAAwD;YACrE,IAAI,EAAE,WAAW,CAAC,QAAQ;YAC1B,MAAM,EAAE,aAAa;YACrB,UAAU,EAAE,iBAAiB;SAC9B;QACD;YACE,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,+DAA+D;YACjE,IAAI,EAAE,WAAW,CAAC,QAAQ;YAC1B,MAAM,EAAE,YAAY;YACpB,UAAU,EAAE,gBAAgB;SAC7B;QACD;YACE,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,6DAA6D;YAC/D,IAAI,EAAE,WAAW,CAAC,QAAQ;YAC1B,MAAM,EAAE,YAAY;SACrB;KACF;IACD,MAAM,EAAE,UAAU;CACnB,CAAC"}

package/dist/src/ui/commands/skillsCommand.test.d.ts

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

package/dist/src/ui/commands/skillsCommand.test.js

@@ -0,0 +1,405 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { skillsCommand } from './skillsCommand.js';
+import { MessageType } from '../types.js';
+import { createMockCommandContext } from '../../test-utils/mockCommandContext.js';
+import { SettingScope } from '../../config/settings.js';
+vi.mock('../../config/settings.js', async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        isLoadableSettingScope: vi.fn((s) => s === 'User' || s === 'Workspace'),
+    };
+});
+describe('skillsCommand', () => {
+    let context;
+    beforeEach(() => {
+        vi.useFakeTimers();
+        const skills = [
+            {
+                name: 'skill1',
+                description: 'desc1',
+                location: '/loc1',
+                body: 'body1',
+            },
+            {
+                name: 'skill2',
+                description: 'desc2',
+                location: '/loc2',
+                body: 'body2',
+            },
+        ];
+        context = createMockCommandContext({
+            services: {
+                config: {
+                    getSkillManager: vi.fn().mockReturnValue({
+                        getAllSkills: vi.fn().mockReturnValue(skills),
+                        getSkills: vi.fn().mockReturnValue(skills),
+                        isAdminEnabled: vi.fn().mockReturnValue(true),
+                        getSkill: vi
+                            .fn()
+                            .mockImplementation((name) => skills.find((s) => s.name === name) ?? null),
+                    }),
+                },
+                settings: {
+                    merged: { skills: { disabled: [] } },
+                    workspace: { path: '/workspace' },
+                    setValue: vi.fn(),
+                },
+            },
+        });
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+        vi.restoreAllMocks();
+    });
+    it('should add a SKILLS_LIST item to UI with descriptions by default', async () => {
+        await skillsCommand.action(context, '');
+        expect(context.ui.addItem).toHaveBeenCalledWith(expect.objectContaining({
+            type: MessageType.SKILLS_LIST,
+            skills: [
+                {
+                    name: 'skill1',
+                    description: 'desc1',
+                    disabled: undefined,
+                    location: '/loc1',
+                    body: 'body1',
+                },
+                {
+                    name: 'skill2',
+                    description: 'desc2',
+                    disabled: undefined,
+                    location: '/loc2',
+                    body: 'body2',
+                },
+            ],
+            showDescriptions: true,
+        }));
+    });
+    it('should list skills when "list" subcommand is used', async () => {
+        const listCmd = skillsCommand.subCommands.find((s) => s.name === 'list');
+        await listCmd.action(context, '');
+        expect(context.ui.addItem).toHaveBeenCalledWith(expect.objectContaining({
+            type: MessageType.SKILLS_LIST,
+            skills: [
+                {
+                    name: 'skill1',
+                    description: 'desc1',
+                    disabled: undefined,
+                    location: '/loc1',
+                    body: 'body1',
+                },
+                {
+                    name: 'skill2',
+                    description: 'desc2',
+                    disabled: undefined,
+                    location: '/loc2',
+                    body: 'body2',
+                },
+            ],
+            showDescriptions: true,
+        }));
+    });
+    it('should disable descriptions if "nodesc" arg is provided to list', async () => {
+        const listCmd = skillsCommand.subCommands.find((s) => s.name === 'list');
+        await listCmd.action(context, 'nodesc');
+        expect(context.ui.addItem).toHaveBeenCalledWith(expect.objectContaining({
+            showDescriptions: false,
+        }));
+    });
+    it('should filter built-in skills by default and show them with "all"', async () => {
+        const skillManager = context.services.config.getSkillManager();
+        const mockSkills = [
+            {
+                name: 'regular',
+                description: 'desc1',
+                location: '/loc1',
+                body: 'body1',
+            },
+            {
+                name: 'builtin',
+                description: 'desc2',
+                location: '/loc2',
+                body: 'body2',
+                isBuiltin: true,
+            },
+        ];
+        vi.mocked(skillManager.getAllSkills).mockReturnValue(mockSkills);
+        const listCmd = skillsCommand.subCommands.find((s) => s.name === 'list');
+        // By default, only regular skills
+        await listCmd.action(context, '');
+        let lastCall = vi
+            .mocked(context.ui.addItem)
+            .mock.calls.at(-1)[0];
+        expect(lastCall.skills).toHaveLength(1);
+        expect(lastCall.skills[0].name).toBe('regular');
+        // With "all", show both
+        await listCmd.action(context, 'all');
+        lastCall = vi
+            .mocked(context.ui.addItem)
+            .mock.calls.at(-1)[0];
+        expect(lastCall.skills).toHaveLength(2);
+        expect(lastCall.skills.map((s) => s.name)).toContain('builtin');
+        // With "--all", show both
+        await listCmd.action(context, '--all');
+        lastCall = vi
+            .mocked(context.ui.addItem)
+            .mock.calls.at(-1)[0];
+        expect(lastCall.skills).toHaveLength(2);
+    });
+    describe('disable/enable', () => {
+        beforeEach(() => {
+            context.services.settings.merged.skills = { disabled: [] };
+            context.services.settings.workspace = {
+                path: '/workspace',
+            };
+            const settings = context.services.settings;
+            settings.forScope = vi.fn((scope) => {
+                if (scope === SettingScope.User)
+                    return settings.user;
+                if (scope === SettingScope.Workspace)
+                    return settings.workspace;
+                return { settings: {}, path: '' };
+            });
+            settings.user = {
+                settings: {},
+                path: '/user/settings.json',
+            };
+            settings.workspace = {
+                settings: {},
+                path: '/workspace',
+            };
+        });
+        it('should disable a skill', async () => {
+            const disableCmd = skillsCommand.subCommands.find((s) => s.name === 'disable');
+            await disableCmd.action(context, 'skill1');
+            expect(context.services.settings.setValue).toHaveBeenCalledWith(SettingScope.Workspace, 'skills.disabled', ['skill1']);
+            expect(context.ui.addItem).toHaveBeenCalledWith(expect.objectContaining({
+                type: MessageType.INFO,
+                text: 'Skill "skill1" disabled by adding it to the disabled list in project (/workspace) settings. Use "/skills reload" for it to take effect.',
+            }));
+        });
+        it('should enable a skill', async () => {
+            const enableCmd = skillsCommand.subCommands.find((s) => s.name === 'enable');
+            context.services.settings.merged.skills = { disabled: ['skill1'] };
+            context.services.settings.workspace.settings = {
+                skills: { disabled: ['skill1'] },
+            };
+            await enableCmd.action(context, 'skill1');
+            expect(context.services.settings.setValue).toHaveBeenCalledWith(SettingScope.Workspace, 'skills.disabled', []);
+            expect(context.ui.addItem).toHaveBeenCalledWith(expect.objectContaining({
+                type: MessageType.INFO,
+                text: 'Skill "skill1" enabled by removing it from the disabled list in project (/workspace) and user (/user/settings.json) settings. Use "/skills reload" for it to take effect.',
+            }));
+        });
+        it('should enable a skill across multiple scopes', async () => {
+            const enableCmd = skillsCommand.subCommands.find((s) => s.name === 'enable');
+            context.services.settings.user.settings = {
+                skills: { disabled: ['skill1'] },
+            };
+            context.services.settings.workspace.settings = {
+                skills: { disabled: ['skill1'] },
+            };
+            await enableCmd.action(context, 'skill1');
+            expect(context.services.settings.setValue).toHaveBeenCalledWith(SettingScope.User, 'skills.disabled', []);
+            expect(context.services.settings.setValue).toHaveBeenCalledWith(SettingScope.Workspace, 'skills.disabled', []);
+            expect(context.ui.addItem).toHaveBeenCalledWith(expect.objectContaining({
+                type: MessageType.INFO,
+                text: 'Skill "skill1" enabled by removing it from the disabled list in project (/workspace) and user (/user/settings.json) settings. Use "/skills reload" for it to take effect.',
+            }));
+        });
+        it('should show error if skill not found during disable', async () => {
+            const disableCmd = skillsCommand.subCommands.find((s) => s.name === 'disable');
+            await disableCmd.action(context, 'non-existent');
+            expect(context.ui.addItem).toHaveBeenCalledWith(expect.objectContaining({
+                type: MessageType.ERROR,
+                text: 'Skill "non-existent" not found.',
+            }), expect.any(Number));
+        });
+        it('should show error if skills are disabled by admin during disable', async () => {
+            const skillManager = context.services.config.getSkillManager();
+            vi.mocked(skillManager.isAdminEnabled).mockReturnValue(false);
+            const disableCmd = skillsCommand.subCommands.find((s) => s.name === 'disable');
+            await disableCmd.action(context, 'skill1');
+            expect(context.ui.addItem).toHaveBeenCalledWith(expect.objectContaining({
+                type: MessageType.ERROR,
+                text: 'Agent skills are disabled by your admin.',
+            }), expect.any(Number));
+        });
+        it('should show error if skills are disabled by admin during enable', async () => {
+            const skillManager = context.services.config.getSkillManager();
+            vi.mocked(skillManager.isAdminEnabled).mockReturnValue(false);
+            const enableCmd = skillsCommand.subCommands.find((s) => s.name === 'enable');
+            await enableCmd.action(context, 'skill1');
+            expect(context.ui.addItem).toHaveBeenCalledWith(expect.objectContaining({
+                type: MessageType.ERROR,
+                text: 'Agent skills are disabled by your admin.',
+            }), expect.any(Number));
+        });
+    });
+    describe('reload', () => {
+        it('should reload skills successfully and show success message', async () => {
+            const reloadCmd = skillsCommand.subCommands.find((s) => s.name === 'reload');
+            // Make reload take some time so timer can fire
+            const reloadSkillsMock = vi.fn().mockImplementation(async () => {
+                await new Promise((resolve) => setTimeout(resolve, 200));
+            });
+            // @ts-expect-error Mocking reloadSkills
+            context.services.config.reloadSkills = reloadSkillsMock;
+            const actionPromise = reloadCmd.action(context, '');
+            // Initially, no pending item (flicker prevention)
+            expect(context.ui.setPendingItem).not.toHaveBeenCalled();
+            // Fast forward 100ms to trigger the pending item
+            await vi.advanceTimersByTimeAsync(100);
+            expect(context.ui.setPendingItem).toHaveBeenCalledWith(expect.objectContaining({
+                type: MessageType.INFO,
+                text: 'Reloading agent skills...',
+            }));
+            // Fast forward another 100ms (reload complete), but pending item should stay
+            await vi.advanceTimersByTimeAsync(100);
+            expect(context.ui.setPendingItem).not.toHaveBeenCalledWith(null);
+            // Fast forward to reach 500ms total
+            await vi.advanceTimersByTimeAsync(300);
+            await actionPromise;
+            expect(reloadSkillsMock).toHaveBeenCalled();
+            expect(context.ui.setPendingItem).toHaveBeenCalledWith(null);
+            expect(context.ui.addItem).toHaveBeenCalledWith(expect.objectContaining({
+                type: MessageType.INFO,
+                text: 'Agent skills reloaded successfully.',
+            }));
+        });
+        it('should show new skills count after reload', async () => {
+            const reloadCmd = skillsCommand.subCommands.find((s) => s.name === 'reload');
+            const reloadSkillsMock = vi.fn().mockImplementation(async () => {
+                const skillManager = context.services.config.getSkillManager();
+                vi.mocked(skillManager.getSkills).mockReturnValue([
+                    { name: 'skill1' },
+                    { name: 'skill2' },
+                    { name: 'skill3' },
+                ]);
+            });
+            // @ts-expect-error Mocking reloadSkills
+            context.services.config.reloadSkills = reloadSkillsMock;
+            await reloadCmd.action(context, '');
+            expect(context.ui.addItem).toHaveBeenCalledWith(expect.objectContaining({
+                type: MessageType.INFO,
+                text: 'Agent skills reloaded successfully. 1 newly available skill.',
+            }));
+        });
+        it('should show removed skills count after reload', async () => {
+            const reloadCmd = skillsCommand.subCommands.find((s) => s.name === 'reload');
+            const reloadSkillsMock = vi.fn().mockImplementation(async () => {
+                const skillManager = context.services.config.getSkillManager();
+                vi.mocked(skillManager.getSkills).mockReturnValue([
+                    { name: 'skill1' },
+                ]);
+            });
+            // @ts-expect-error Mocking reloadSkills
+            context.services.config.reloadSkills = reloadSkillsMock;
+            await reloadCmd.action(context, '');
+            expect(context.ui.addItem).toHaveBeenCalledWith(expect.objectContaining({
+                type: MessageType.INFO,
+                text: 'Agent skills reloaded successfully. 1 skill no longer available.',
+            }));
+        });
+        it('should show both added and removed skills count after reload', async () => {
+            const reloadCmd = skillsCommand.subCommands.find((s) => s.name === 'reload');
+            const reloadSkillsMock = vi.fn().mockImplementation(async () => {
+                const skillManager = context.services.config.getSkillManager();
+                vi.mocked(skillManager.getSkills).mockReturnValue([
+                    { name: 'skill2' }, // skill1 removed, skill3 added
+                    { name: 'skill3' },
+                ]);
+            });
+            // @ts-expect-error Mocking reloadSkills
+            context.services.config.reloadSkills = reloadSkillsMock;
+            await reloadCmd.action(context, '');
+            expect(context.ui.addItem).toHaveBeenCalledWith(expect.objectContaining({
+                type: MessageType.INFO,
+                text: 'Agent skills reloaded successfully. 1 newly available skill and 1 skill no longer available.',
+            }));
+        });
+        it('should show error if configuration is missing', async () => {
+            const reloadCmd = skillsCommand.subCommands.find((s) => s.name === 'reload');
+            context.services.config = null;
+            await reloadCmd.action(context, '');
+            expect(context.ui.addItem).toHaveBeenCalledWith(expect.objectContaining({
+                type: MessageType.ERROR,
+                text: 'Could not retrieve configuration.',
+            }));
+        });
+        it('should show error if reload fails', async () => {
+            const reloadCmd = skillsCommand.subCommands.find((s) => s.name === 'reload');
+            const error = new Error('Reload failed');
+            const reloadSkillsMock = vi.fn().mockImplementation(async () => {
+                await new Promise((_, reject) => setTimeout(() => reject(error), 200));
+            });
+            // @ts-expect-error Mocking reloadSkills
+            context.services.config.reloadSkills = reloadSkillsMock;
+            const actionPromise = reloadCmd.action(context, '');
+            await vi.advanceTimersByTimeAsync(100);
+            await vi.advanceTimersByTimeAsync(400);
+            await actionPromise;
+            expect(context.ui.setPendingItem).toHaveBeenCalledWith(null);
+            expect(context.ui.addItem).toHaveBeenCalledWith(expect.objectContaining({
+                type: MessageType.ERROR,
+                text: 'Failed to reload skills: Reload failed',
+            }));
+        });
+    });
+    describe('completions', () => {
+        it('should provide completions for disable (only enabled skills)', async () => {
+            const disableCmd = skillsCommand.subCommands.find((s) => s.name === 'disable');
+            const skillManager = context.services.config.getSkillManager();
+            const mockSkills = [
+                {
+                    name: 'skill1',
+                    description: 'desc1',
+                    disabled: false,
+                    location: '/loc1',
+                    body: 'body1',
+                },
+                {
+                    name: 'skill2',
+                    description: 'desc2',
+                    disabled: true,
+                    location: '/loc2',
+                    body: 'body2',
+                },
+            ];
+            vi.mocked(skillManager.getAllSkills).mockReturnValue(mockSkills);
+            vi.mocked(skillManager.getSkill).mockImplementation((name) => mockSkills.find((s) => s.name === name) ?? null);
+            const completions = await disableCmd.completion(context, 'sk');
+            expect(completions).toEqual(['skill1']);
+        });
+        it('should provide completions for enable (only disabled skills)', async () => {
+            const enableCmd = skillsCommand.subCommands.find((s) => s.name === 'enable');
+            const skillManager = context.services.config.getSkillManager();
+            const mockSkills = [
+                {
+                    name: 'skill1',
+                    description: 'desc1',
+                    disabled: false,
+                    location: '/loc1',
+                    body: 'body1',
+                },
+                {
+                    name: 'skill2',
+                    description: 'desc2',
+                    disabled: true,
+                    location: '/loc2',
+                    body: 'body2',
+                },
+            ];
+            vi.mocked(skillManager.getAllSkills).mockReturnValue(mockSkills);
+            vi.mocked(skillManager.getSkill).mockImplementation((name) => mockSkills.find((s) => s.name === name) ?? null);
+            const completions = await enableCmd.completion(context, 'sk');
+            expect(completions).toEqual(['skill2']);
+        });
+    });
+});
+//# sourceMappingURL=skillsCommand.test.js.map