@zhixuan92/multi-model-agent 5.0.2 → 5.1.0

package/dist/cli/sync-skills.d.ts

@@ -0,0 +1,58 @@
+import { type Client } from '../skill-install/manifest.js';
+export declare const ExitCode: Readonly<{
+    SUCCESS: 0;
+    ERR_PARTIAL: 1;
+    ERR_FUTURE_MANIFEST: 2;
+    ERR_UNKNOWN_TARGET: 3;
+}>;
+export interface SyncSkillsDeps {
+    argv?: string[];
+    homeDir?: string;
+    /** Override skills root for testing. */
+    skillsRoot?: string;
+    /** Exit silently with code 0 if no manifest exists yet (postinstall). */
+    ifExists?: boolean;
+    /** Suppress normal stdout. Errors still go to stderr. */
+    silent?: boolean;
+    /** Swallow errors and exit 0 (postinstall). */
+    bestEffort?: boolean;
+    stdout?: (s: string) => boolean;
+    stderr?: (s: string) => boolean;
+}
+interface ParsedArgs {
+    targets: Client[] | null;
+    allTargets: boolean;
+    dryRun: boolean;
+    json: boolean;
+}
+export declare function parseArgs(argv: string[]): ParsedArgs;
+export declare function resolveTargets(explicit: Client[] | null, allTargets: boolean, homeDir: string): Client[];
+export interface SyncOutcome {
+    installed: Array<{
+        skill: string;
+        target: Client;
+        version: string;
+    }>;
+    updated: Array<{
+        skill: string;
+        target: Client;
+        from: string;
+        to: string;
+    }>;
+    removed: Array<{
+        skill: string;
+        target: Client;
+    }>;
+    upToDate: Array<{
+        skill: string;
+        target: Client;
+    }>;
+    errors: Array<{
+        skill: string;
+        target: Client;
+        reason: string;
+    }>;
+}
+export declare function runSyncSkills(deps?: SyncSkillsDeps): Promise<number>;
+export {};
+//# sourceMappingURL=sync-skills.d.ts.map

package/dist/cli/sync-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-skills.d.ts","sourceRoot":"","sources":["../../src/cli/sync-skills.ts"],"names":[],"mappings":"AA4BA,OAAO,EAOL,KAAK,MAAM,EAEZ,MAAM,8BAA8B,CAAC;AActC,eAAO,MAAM,QAAQ;;;;;EAKnB,CAAC;AAEH,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yDAAyD;IACzD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IAChC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;CACjC;AAED,UAAU,UAAU;IAClB,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAiBpD;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,EACzB,UAAU,EAAE,OAAO,EACnB,OAAO,EAAE,MAAM,GACd,MAAM,EAAE,CASV;AA2BD,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrE,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5E,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,QAAQ,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClE;AAED,wBAAsB,aAAa,CAAC,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyK9E"}

package/dist/cli/sync-skills.js

@@ -0,0 +1,266 @@
+/**
+ * sync-skills.ts — `mmagent sync-skills` subcommand.
+ *
+ * Single command for skill management: idempotent upsert of every shipped
+ * skill into every detected (or specified) client. Compares canonical
+ * SUPPORTED_SKILLS against on-disk SKILL.md and the install manifest, and:
+ *   - installs skills not present on disk
+ *   - overwrites skills whose installed version differs from canonical
+ *   - removes skills no longer in SUPPORTED_SKILLS (orphan cleanup)
+ *   - rewrites the install manifest to reflect post-sync state
+ *
+ * Replaces install-skill + update-skills as of 4.0.2.
+ *
+ * Usage:
+ *   mmagent sync-skills [--target=<client>] [--all-targets] [--dry-run] [--json]
+ *                       [--silent] [--best-effort] [--if-exists]
+ *
+ * Exit codes:
+ *   0 — success (or no clients detected)
+ *   1 — one or more skills failed to write/remove
+ *   2 — manifest was written by a newer mmagent (FutureManifestError)
+ *   3 — explicit --target was not a known client
+ */
+import * as os from 'node:os';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import minimist from 'minimist';
+import matter from 'gray-matter';
+import { ALL_CLIENTS, detectClients, listEntries, appendEntry, removeEntry, FutureManifestError, } from '../skill-install/manifest.js';
+import { SUPPORTED_SKILLS, readSkillContent, getSkillsRoot, } from '../skill-install/discover.js';
+import { writeSkillToClient, removeSkillFromClient, resolveClientInstallDir, UnknownTargetError, } from '../skill-install/skill-installer-common.js';
+import { disabledTargets } from '../skill-install/disabled-state.js';
+export const ExitCode = Object.freeze({
+    SUCCESS: 0,
+    ERR_PARTIAL: 1,
+    ERR_FUTURE_MANIFEST: 2,
+    ERR_UNKNOWN_TARGET: 3,
+});
+export function parseArgs(argv) {
+    const args = minimist(argv, {
+        string: ['target'],
+        boolean: ['dry-run', 'json', 'all-targets'],
+        alias: { t: 'target', j: 'json' },
+    });
+    let targets = null;
+    if (args.target) {
+        const t = Array.isArray(args.target) ? args.target : [args.target];
+        targets = t.map((s) => s);
+    }
+    return {
+        targets,
+        allTargets: args['all-targets'] === true,
+        dryRun: args['dry-run'] === true,
+        json: args['json'] === true,
+    };
+}
+export function resolveTargets(explicit, allTargets, homeDir) {
+    if (allTargets)
+        return [...ALL_CLIENTS];
+    if (explicit !== null) {
+        for (const t of explicit) {
+            if (!ALL_CLIENTS.includes(t))
+                throw new UnknownTargetError(t, ALL_CLIENTS);
+        }
+        return Array.from(new Set(explicit));
+    }
+    return detectClients(homeDir);
+}
+function versionFromContent(content) {
+    try {
+        const parsed = matter(content);
+        const v = parsed.data['version'];
+        return typeof v === 'string' && v.length > 0 ? v : 'unknown';
+    }
+    catch {
+        return 'unknown';
+    }
+}
+function manifestPresent(homeDir) {
+    return fs.existsSync(path.join(homeDir, '.multi-model', 'install-manifest.json'));
+}
+function readInstalledVersion(skillName, target, homeDir) {
+    const dir = resolveClientInstallDir(target, homeDir);
+    if (!dir)
+        return null;
+    const skillFile = path.join(dir, skillName, 'SKILL.md');
+    try {
+        return versionFromContent(fs.readFileSync(skillFile, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+export async function runSyncSkills(deps = {}) {
+    const argv = deps.argv ?? process.argv.slice(2);
+    const homeDir = deps.homeDir ?? os.homedir();
+    const skillsRoot = getSkillsRoot(deps.skillsRoot);
+    const stdout = deps.stdout ?? process.stdout.write.bind(process.stdout);
+    const stderr = deps.stderr ?? process.stderr.write.bind(process.stderr);
+    const silent = deps.silent ?? false;
+    const bestEffort = deps.bestEffort ?? false;
+    const log = silent ? (_) => true : stdout;
+    if (deps.ifExists && !manifestPresent(homeDir))
+        return ExitCode.SUCCESS;
+    const parsed = parseArgs(argv);
+    let targets;
+    try {
+        targets = resolveTargets(parsed.targets, parsed.allTargets, homeDir);
+    }
+    catch (err) {
+        if (err instanceof UnknownTargetError) {
+            stderr(`mmagent sync-skills: ${err.message}\n`);
+            return bestEffort ? 0 : ExitCode.ERR_UNKNOWN_TARGET;
+        }
+        throw err;
+    }
+    // Honor the disable sentinel: drop any client the user turned off via
+    // `mmagent disable`. This is what makes disable sticky — the npm postinstall
+    // hook shells out to this command, so without the filter every upgrade would
+    // silently reinstall skills the user deliberately removed. `mmagent enable`
+    // clears the sentinel before it calls back in here.
+    const disabled = disabledTargets(homeDir);
+    if (disabled.length > 0) {
+        const active = targets.filter((t) => !disabled.includes(t));
+        if (active.length === 0) {
+            if (parsed.json) {
+                stdout(JSON.stringify({ targets: [], outcome: 'skills-disabled', disabled }) + '\n');
+            }
+            else {
+                log(`MMA skills are disabled for ${disabled.join(', ')}. ` +
+                    `Run \`mmagent enable\` to restore. Skipping sync.\n`);
+            }
+            return ExitCode.SUCCESS;
+        }
+        targets = active;
+    }
+    if (targets.length === 0) {
+        if (parsed.json) {
+            stdout(JSON.stringify({ targets: [], outcome: 'no-clients-detected' }) + '\n');
+        }
+        else {
+            log('No clients detected. Use --target=<client> or --all-targets.\n');
+        }
+        return ExitCode.SUCCESS;
+    }
+    let manifestEntries;
+    try {
+        manifestEntries = listEntries(homeDir);
+    }
+    catch (err) {
+        if (err instanceof FutureManifestError) {
+            stderr(`mmagent sync-skills: ${err.message}\n`);
+            return bestEffort ? 0 : ExitCode.ERR_FUTURE_MANIFEST;
+        }
+        if (bestEffort)
+            return 0;
+        throw err;
+    }
+    const outcome = {
+        installed: [],
+        updated: [],
+        removed: [],
+        upToDate: [],
+        errors: [],
+    };
+    // Pass 1: orphan removal — drop skills that disappeared from the bundle.
+    for (const entry of manifestEntries) {
+        if (SUPPORTED_SKILLS.includes(entry.name))
+            continue;
+        for (const target of entry.targets) {
+            if (parsed.dryRun) {
+                outcome.removed.push({ skill: entry.name, target });
+                continue;
+            }
+            try {
+                removeSkillFromClient(entry.name, target, homeDir);
+                outcome.removed.push({ skill: entry.name, target });
+            }
+            catch (err) {
+                outcome.errors.push({
+                    skill: entry.name,
+                    target,
+                    reason: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+        if (!parsed.dryRun)
+            removeEntry(entry.name, [], homeDir);
+    }
+    // Pass 2: upsert canonical skills × resolved targets.
+    for (const skillName of SUPPORTED_SKILLS) {
+        const content = readSkillContent(skillName, skillsRoot);
+        if (content === null) {
+            outcome.errors.push({
+                skill: skillName,
+                target: targets[0],
+                reason: `Bundled SKILL.md not found at ${path.join(skillsRoot, skillName, 'SKILL.md')}`,
+            });
+            continue;
+        }
+        const canonicalVersion = versionFromContent(content);
+        for (const target of targets) {
+            const installedVersion = readInstalledVersion(skillName, target, homeDir);
+            const action = installedVersion === null
+                ? 'install'
+                : installedVersion !== canonicalVersion
+                    ? 'update'
+                    : 'up-to-date';
+            if (action === 'up-to-date') {
+                outcome.upToDate.push({ skill: skillName, target });
+                continue;
+            }
+            if (parsed.dryRun) {
+                if (action === 'install') {
+                    outcome.installed.push({ skill: skillName, target, version: canonicalVersion });
+                }
+                else {
+                    outcome.updated.push({ skill: skillName, target, from: installedVersion, to: canonicalVersion });
+                }
+                continue;
+            }
+            try {
+                writeSkillToClient(skillName, content, target, homeDir, skillsRoot, canonicalVersion);
+                appendEntry(skillName, canonicalVersion, [target], homeDir);
+                if (action === 'install') {
+                    outcome.installed.push({ skill: skillName, target, version: canonicalVersion });
+                }
+                else {
+                    outcome.updated.push({ skill: skillName, target, from: installedVersion, to: canonicalVersion });
+                }
+            }
+            catch (err) {
+                outcome.errors.push({
+                    skill: skillName,
+                    target,
+                    reason: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+    }
+    if (parsed.json) {
+        stdout(JSON.stringify({ dryRun: parsed.dryRun, targets, outcome }) + '\n');
+    }
+    else {
+        const verb = parsed.dryRun ? 'Would sync' : 'Synced';
+        const parts = [];
+        if (outcome.installed.length > 0)
+            parts.push(`${outcome.installed.length} installed`);
+        if (outcome.updated.length > 0)
+            parts.push(`${outcome.updated.length} updated`);
+        if (outcome.removed.length > 0)
+            parts.push(`${outcome.removed.length} orphan removed`);
+        if (outcome.upToDate.length > 0)
+            parts.push(`${outcome.upToDate.length} up-to-date`);
+        if (outcome.errors.length > 0)
+            parts.push(`${outcome.errors.length} errors`);
+        const summary = parts.length > 0 ? parts.join(', ') : 'nothing to do';
+        log(`${verb} ${SUPPORTED_SKILLS.length} skill(s) → ${targets.join(', ')} (${summary}).\n`);
+        for (const e of outcome.errors)
+            stderr(`error: ${e.skill} → ${e.target}: ${e.reason}\n`);
+    }
+    if (outcome.errors.length > 0)
+        return bestEffort ? 0 : ExitCode.ERR_PARTIAL;
+    return ExitCode.SUCCESS;
+}
+//# sourceMappingURL=sync-skills.js.map

package/dist/cli/sync-skills.js.map

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

package/dist/cli/telemetry.d.ts

@@ -0,0 +1,10 @@
+export interface TelemetryDeps {
+    subcommand: 'status' | 'enable' | 'disable' | 'reset-id' | 'dump-queue';
+    homeDir: string;
+    /** Write to stdout. */
+    stdout?: (s: string) => boolean;
+    /** Write to stderr. */
+    stderr?: (s: string) => boolean;
+}
+export declare function runTelemetry(deps: TelemetryDeps): Promise<number>;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/cli/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/cli/telemetry.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,CAAC;IACxE,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IAChC,uBAAuB;IACvB,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;CACjC;AAyJD,wBAAsB,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAavE"}

package/dist/cli/telemetry.js

@@ -0,0 +1,161 @@
+/**
+ * telemetry.ts — `mmagent telemetry` subcommands.
+ *
+ * Usage:
+ *   mmagent telemetry status
+ *   mmagent telemetry enable
+ *   mmagent telemetry disable
+ *   mmagent telemetry reset-id
+ *   mmagent telemetry dump-queue
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync, unlinkSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { decide } from '../telemetry/consent.js';
+import { deleteInstallId } from '../telemetry/install-id.js';
+import { bumpGeneration } from '../telemetry/generation.js';
+import { Queue } from '../telemetry/queue.js';
+/**
+ * Read the raw MMAGENT_TELEMETRY env value (not the parsed decision).
+ */
+function readRawEnv() {
+    return process.env.MMAGENT_TELEMETRY;
+}
+/**
+ * Read the existing config.json as a parsed object, or null if it doesn't exist.
+ */
+function readConfigObj(homeDir) {
+    const cfgPath = join(homeDir, 'config.json');
+    if (!existsSync(cfgPath))
+        return null;
+    try {
+        return JSON.parse(readFileSync(cfgPath, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write config.json, ensuring parent directory exists.
+ */
+function writeConfigObj(homeDir, obj) {
+    const cfgPath = join(homeDir, 'config.json');
+    const parent = dirname(cfgPath);
+    if (!existsSync(parent))
+        mkdirSync(parent, { recursive: true });
+    writeFileSync(cfgPath, JSON.stringify(obj, null, 2) + '\n', { mode: 0o600 });
+}
+async function revokeIdentity(homeDir) {
+    await bumpGeneration(homeDir);
+    const queuePath = join(homeDir, 'telemetry-queue.ndjson');
+    if (existsSync(queuePath))
+        unlinkSync(queuePath);
+}
+// ─── status ──────────────────────────────────────────────────────────────────
+async function runStatus(deps) {
+    const stdout = deps.stdout ?? process.stdout.write.bind(process.stdout);
+    const d = decide(deps.homeDir);
+    const envRaw = readRawEnv();
+    const lines = [];
+    lines.push(`Telemetry: ${d.enabled ? 'enabled' : 'disabled'}`);
+    lines.push(`Source:    ${d.source}`);
+    if (d.source === 'env_invalid') {
+        lines.push(`Warning:   MMAGENT_TELEMETRY="${envRaw ?? ''}" is not a recognized value (use 1/true/on/yes or 0/false/off/no)`);
+    }
+    // Surface set-but-empty env distinction
+    if (envRaw !== undefined && envRaw.trim().length === 0) {
+        lines.push(`Note:      MMAGENT_TELEMETRY is set to '' (no effect — falls through to ${d.source})`);
+    }
+    stdout(lines.join('\n') + '\n');
+    return 0;
+}
+// ─── enable ──────────────────────────────────────────────────────────────────
+async function runEnable(deps) {
+    const stdout = deps.stdout ?? process.stdout.write.bind(process.stdout);
+    const stderr = deps.stderr ?? process.stderr.write.bind(process.stderr);
+    let cfg = readConfigObj(deps.homeDir) ?? {};
+    // Remove bare top-level `enabled` if present — canonical shape is `telemetry.enabled`
+    if (typeof cfg.enabled === 'boolean') {
+        delete cfg.enabled;
+    }
+    const telemetry = (cfg.telemetry ?? {});
+    telemetry.enabled = true;
+    delete telemetry.consentSchemaVersion;
+    cfg.telemetry = telemetry;
+    try {
+        writeConfigObj(deps.homeDir, cfg);
+        stdout('Telemetry enabled (config.telemetry.enabled = true)\n');
+        return 0;
+    }
+    catch (err) {
+        stderr(`mmagent telemetry enable: ${err instanceof Error ? err.message : String(err)}\n`);
+        return 1;
+    }
+}
+// ─── disable ──────────────────────────────────────────────────────────────────
+async function runDisable(deps) {
+    const stdout = deps.stdout ?? process.stdout.write.bind(process.stdout);
+    const stderr = deps.stderr ?? process.stderr.write.bind(process.stderr);
+    let cfg = readConfigObj(deps.homeDir) ?? {};
+    if (typeof cfg.enabled === 'boolean') {
+        delete cfg.enabled;
+    }
+    const telemetry = (cfg.telemetry ?? {});
+    telemetry.enabled = false;
+    cfg.telemetry = telemetry;
+    try {
+        writeConfigObj(deps.homeDir, cfg);
+        await revokeIdentity(deps.homeDir);
+        stdout('Telemetry disabled (config.telemetry.enabled = false, identity revoked)\n');
+        return 0;
+    }
+    catch (err) {
+        stderr(`mmagent telemetry disable: ${err instanceof Error ? err.message : String(err)}\n`);
+        return 1;
+    }
+}
+// ─── reset-id ─────────────────────────────────────────────────────────────────
+async function runResetId(deps) {
+    const stdout = deps.stdout ?? process.stdout.write.bind(process.stdout);
+    const stderr = deps.stderr ?? process.stderr.write.bind(process.stderr);
+    try {
+        await revokeIdentity(deps.homeDir);
+        deleteInstallId(deps.homeDir);
+        stdout('Identity reset (generation bumped, queue deleted, install-id deleted)\n');
+        return 0;
+    }
+    catch (err) {
+        stderr(`mmagent telemetry reset-id: ${err instanceof Error ? err.message : String(err)}\n`);
+        return 1;
+    }
+}
+// ─── dump-queue ───────────────────────────────────────────────────────────────
+async function runDumpQueue(deps) {
+    const stdout = deps.stdout ?? process.stdout.write.bind(process.stdout);
+    const stderr = deps.stderr ?? process.stderr.write.bind(process.stderr);
+    try {
+        const queue = new Queue(deps.homeDir);
+        const batch = await queue.readBatch();
+        stdout(JSON.stringify(batch.records, null, 2) + '\n');
+        return 0;
+    }
+    catch (err) {
+        stderr(`mmagent telemetry dump-queue: ${err instanceof Error ? err.message : String(err)}\n`);
+        return 1;
+    }
+}
+// ─── dispatch ─────────────────────────────────────────────────────────────────
+export async function runTelemetry(deps) {
+    switch (deps.subcommand) {
+        case 'status': return runStatus(deps);
+        case 'enable': return runEnable(deps);
+        case 'disable': return runDisable(deps);
+        case 'reset-id': return runResetId(deps);
+        case 'dump-queue': return runDumpQueue(deps);
+        default: {
+            const stderr = deps.stderr ?? process.stderr.write.bind(process.stderr);
+            stderr(`mmagent telemetry: unknown subcommand '${deps.subcommand}'\n`);
+            return 1;
+        }
+    }
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/cli/telemetry.js.map

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

package/dist/cli/toggle.d.ts

@@ -0,0 +1,26 @@
+export declare const ToggleExitCode: Readonly<{
+    SUCCESS: 0;
+    ERR_PARTIAL: 1;
+    ERR_UNKNOWN_TARGET: 3;
+}>;
+export interface ToggleDeps {
+    argv?: string[];
+    homeDir?: string;
+    /** Override skills root — threaded into runSyncSkills for `enable` in tests. */
+    skillsRoot?: string;
+    /** Recorded in the sentinel for diagnostics; defaults to 'unknown'. */
+    cliVersion?: string;
+    stdout?: (s: string) => boolean;
+    stderr?: (s: string) => boolean;
+}
+/**
+ * `mmagent disable` — remove all MMA skills from the resolved clients and
+ * record the sticky sentinel.
+ */
+export declare function runDisable(deps?: ToggleDeps): Promise<number>;
+/**
+ * `mmagent enable` — clear the sentinel for the resolved clients, then
+ * delegate to sync-skills' idempotent upsert to reinstall the skills.
+ */
+export declare function runEnable(deps?: ToggleDeps): Promise<number>;
+//# sourceMappingURL=toggle.d.ts.map

package/dist/cli/toggle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggle.d.ts","sourceRoot":"","sources":["../../src/cli/toggle.ts"],"names":[],"mappings":"AAqCA,eAAO,MAAM,cAAc;;;;EAIzB,CAAC;AAEH,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IAChC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;CACjC;AA4BD;;;GAGG;AACH,wBAAsB,UAAU,CAAC,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAyEvE;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAqDtE"}