@zhixuan92/multi-model-agent 3.0.0

package/dist/cli/install-skill.d.ts

@@ -0,0 +1,158 @@
+import type { Client } from '../install/manifest.js';
+export type { Client } from '../install/manifest.js';
+export { ALL_CLIENTS, detectClients } from '../install/manifest.js';
+export declare const SUPPORTED_SKILLS: readonly ["multi-model-agent", "mma-delegate", "mma-audit", "mma-review", "mma-verify", "mma-debug", "mma-execute-plan", "mma-retry", "mma-context-blocks", "mma-clarifications"];
+/** Thrown when a passed `--target` value is not a known client. */
+export declare class UnknownTargetError extends Error {
+    readonly code: "unknown_target";
+    constructor(target: string, valid: readonly Client[]);
+}
+/** Thrown when a skill's SKILL.md cannot be read from the bundled skills directory. */
+export declare class SkillNotFoundError extends Error {
+    readonly code: "skill_not_found";
+    constructor(skillName: string, checkedPath: string);
+}
+/**
+ * Return the absolute path to the skills root directory.
+ *
+ * The skills root is the directory containing per-skill sub-directories
+ * (e.g. `<root>/mma-delegate/SKILL.md`).  In production this resolves to
+ * `packages/server/src/skills/`.  During tests the caller can pass a custom
+ * `skillsRoot` to read from a temp fixture instead.
+ */
+export declare function getSkillsRoot(skillsRoot?: string): string;
+/**
+ * Read the content of a skill's SKILL.md file.
+ * Returns null if the file does not exist.
+ * Propagates permission errors and other I/O problems so callers can
+ * distinguish "skill not found" from "can't access skill".
+ */
+export declare function readSkillContent(skillName: string, skillsRoot?: string): string | null;
+/**
+ * Write a skill's SKILL.md content to the target client's skill directory.
+ * Dispatches to the appropriate writer based on `target`.
+ *
+ * @param skillName  The skill name (used in paths and warnings).
+ * @param content    Raw SKILL.md content (may contain @include directives).
+ * @param target     The AI client to install the skill for.
+ * @param homeDir    Home directory (replaces os.homedir()).
+ * @param skillsRoot Root of the skills directory (for @include resolution).
+ * @param version    Skill version string (used by Gemini extension manifest).
+ * @param cwd        Current working directory (used by Cursor; defaults to process.cwd()).
+ * @param force      If true, overwrite existing Cursor file without warning.
+ */
+export declare function writeSkillToClient(skillName: string, content: string, target: Client, homeDir: string, skillsRoot: string, version?: string, cwd?: string, force?: boolean): void;
+/**
+ * Remove a skill's files from the target client's skill directory.
+ * Dispatches to the appropriate remover based on `target`.
+ *
+ * @param skillName  The skill name (used for claude-code path resolution).
+ * @param target     The AI client to uninstall the skill from.
+ * @param homeDir    Home directory (replaces os.homedir()).
+ * @param cwd        Current working directory (used by Cursor; defaults to process.cwd()).
+ */
+export declare function removeSkillFromClient(skillName: string, target: Client, homeDir: string, cwd?: string): void;
+export interface InstallResult {
+    skill: string;
+    action: 'installed' | 'uninstalled';
+    /** Targets for which the operation succeeded. */
+    targets: Client[];
+    /** Targets that were skipped (dry-run, unknown, or not applicable). */
+    skipped: Client[];
+    /** Files would be written but were not (dry-run mode). */
+    dryRun: boolean;
+}
+/**
+ * Return codes for `main()`.
+ * Exported so callers (e.g. the CLI dispatcher in cli/index.ts) can pass the
+ * code to `exit()` without calling `process.exit()` directly.
+ */
+export declare const ExitCode: Readonly<{
+    SUCCESS: 0;
+    ERR_INVALID_ARGS: 1;
+    ERR_SKILL_NOT_FOUND: 2;
+    ERR_UNKNOWN_SKILL: 3;
+    ERR_NO_TARGETS: 4;
+    ERR_WRITER_NOT_IMPLEMENTED: 5;
+    ERR_UNKNOWN_TARGET: 7;
+    ERR_UNKNOWN: 8;
+}>;
+/**
+ * Install a skill to the specified client targets.
+ * - dryRun=true: checks skill existence; does NOT write files or update manifest.
+ * - dryRun=false: writes files via the per-client writers.
+ */
+export declare function doInstall(skillName: string, targets: Client[], opts: {
+    dryRun: boolean;
+    homeDir: string;
+    skillsRoot?: string;
+    version?: string;
+    cwd?: string;
+    force?: boolean;
+}): InstallResult;
+/**
+ * Uninstall a skill from the specified client targets.
+ * - dryRun=true: resolves targets; does NOT remove files or update manifest.
+ * - dryRun=false: removes files via the per-client removers.
+ */
+export declare function doUninstall(skillName: string, targets: Client[], opts: {
+    dryRun: boolean;
+    homeDir: string;
+    cwd?: string;
+}): InstallResult;
+export interface ParsedArgs {
+    skill: string | null;
+    /** Explicit --config path, or null if not specified. */
+    configPath: string | null;
+    uninstall: boolean;
+    dryRun: boolean;
+    json: boolean;
+    targets: Client[] | null;
+    allTargets: boolean;
+}
+/**
+ * Parse CLI arguments for `install-skill`.
+ *
+ * NOTE: `stopEarly` is deliberately NOT set on minimist.  `stopEarly: true`
+ * causes options after the first positional argument to be treated as positional
+ * tail, which would misparse a call like:
+ *     mmagent install-skill mma-delegate --json
+ * (--json would be captured in `_` instead of setting the `json` flag).
+ * Instead we let minimist consume all arguments normally.
+ */
+export declare function parseArgs(argv: string[]): ParsedArgs;
+/**
+ * Resolve the target client list.
+ * Priority:
+ *   1. explicit `--target` arguments (validated against known clients)
+ *   2. `--all-targets` → all four known clients
+ *   3. auto-detect based on `homeDir`
+ *
+ * Explicit targets are de-duplicated while preserving order of first occurrence.
+ *
+ * @throws UnknownTargetError if an explicit target is not a known client.
+ */
+export declare function resolveTargets(explicitTargets: Client[] | null, allTargets: boolean, homeDir: string): Client[];
+export interface MainDeps {
+    /** Override argv (defaults to process.argv.slice(2)). */
+    argv?: string[];
+    /** Home directory (defaults to os.homedir()). */
+    homeDir?: string;
+    /** Package version string for manifest entries (defaults to '0.0.0'). */
+    version?: string;
+    /** Override skills root for testing. */
+    skillsRoot?: string;
+    /** Injectable stdout writer. */
+    stdout?: (s: string) => boolean;
+    /** Injectable stderr writer. */
+    stderr?: (s: string) => boolean;
+}
+/**
+ * Main entry point for `mmagent install-skill`.
+ *
+ * Returns an exit code (one of `ExitCode.*`) instead of calling `process.exit()`
+ * directly, so the CLI dispatcher in `cli/index.ts` can control the exit
+ * decision and make the function fully unit-testable.
+ */
+export declare function main(deps?: MainDeps): Promise<number>;
+//# sourceMappingURL=install-skill.d.ts.map

package/dist/cli/install-skill.d.ts.map

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

package/dist/cli/install-skill.js

@@ -0,0 +1,425 @@
+/**
+ * `mmagent install-skill` CLI command.
+ *
+ * Syntax:
+ *   mmagent install-skill [--uninstall] [--dry-run] [--json]
+ *                        [--target=claude-code|gemini|codex|cursor]
+ *                        [--all-targets] [skill-name]
+ *
+ * Skills are sourced from packages/server/src/skills/<skill-name>/SKILL.md.
+ * install-skill copies the SKILL.md to the appropriate per-client location
+ * and records the installation in the manifest (~/.multi-model/install-manifest.json).
+ *
+ * Task 9.4 scope: CLI scaffolding, manifest read/append-entry/remove-entry,
+ * auto-detection scaffolding, dry-run mode.
+ * Tasks 9.5–9.8: Individual client writers.
+ * Task 9.9: Uninstall wires all removers.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { fileURLToPath } from 'node:url';
+import minimist from 'minimist';
+import * as manifest from '../install/manifest.js';
+import { ALL_CLIENTS, detectClients } from '../install/manifest.js';
+import { installClaudeCode, uninstallClaudeCode } from '../install/claude-code.js';
+import { installGeminiCli, uninstallGeminiCli } from '../install/gemini-cli.js';
+import { installCodexCli, uninstallCodexCli } from '../install/codex-cli.js';
+import { installCursor, uninstallCursor } from '../install/cursor.js';
+export { ALL_CLIENTS, detectClients } from '../install/manifest.js';
+export const SUPPORTED_SKILLS = [
+    'multi-model-agent',
+    'mma-delegate',
+    'mma-audit',
+    'mma-review',
+    'mma-verify',
+    'mma-debug',
+    'mma-execute-plan',
+    'mma-retry',
+    'mma-context-blocks',
+    'mma-clarifications',
+];
+// ─── Custom errors ────────────────────────────────────────────────────────────
+/** Thrown when a passed `--target` value is not a known client. */
+export class UnknownTargetError extends Error {
+    code = 'unknown_target';
+    constructor(target, valid) {
+        super(`Unknown target: ${target}. Valid: ${valid.join(', ')}`);
+    }
+}
+/** Thrown when a skill's SKILL.md cannot be read from the bundled skills directory. */
+export class SkillNotFoundError extends Error {
+    code = 'skill_not_found';
+    constructor(skillName, checkedPath) {
+        super(`Skill '${skillName}' not found. ` +
+            `Checked: ${checkedPath}. ` +
+            `Available skills: ${SUPPORTED_SKILLS.join(', ')}`);
+    }
+}
+// ─── Skills root ────────────────────────────────────────────────────────────
+/** Resolved path to the bundled skills directory. Can be overridden for testing. */
+const DEFAULT_SKILLS_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', 'skills');
+/**
+ * Return the absolute path to the skills root directory.
+ *
+ * The skills root is the directory containing per-skill sub-directories
+ * (e.g. `<root>/mma-delegate/SKILL.md`).  In production this resolves to
+ * `packages/server/src/skills/`.  During tests the caller can pass a custom
+ * `skillsRoot` to read from a temp fixture instead.
+ */
+export function getSkillsRoot(skillsRoot) {
+    return skillsRoot ?? DEFAULT_SKILLS_ROOT;
+}
+/**
+ * Read the content of a skill's SKILL.md file.
+ * Returns null if the file does not exist.
+ * Propagates permission errors and other I/O problems so callers can
+ * distinguish "skill not found" from "can't access skill".
+ */
+export function readSkillContent(skillName, skillsRoot) {
+    const skillFile = path.join(getSkillsRoot(skillsRoot), skillName, 'SKILL.md');
+    try {
+        return fs.readFileSync(skillFile, 'utf-8');
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return null;
+        throw err;
+    }
+}
+// ─── Per-client writer/remover dispatch ───────────────────────────────────────
+/**
+ * Write a skill's SKILL.md content to the target client's skill directory.
+ * Dispatches to the appropriate writer based on `target`.
+ *
+ * @param skillName  The skill name (used in paths and warnings).
+ * @param content    Raw SKILL.md content (may contain @include directives).
+ * @param target     The AI client to install the skill for.
+ * @param homeDir    Home directory (replaces os.homedir()).
+ * @param skillsRoot Root of the skills directory (for @include resolution).
+ * @param version    Skill version string (used by Gemini extension manifest).
+ * @param cwd        Current working directory (used by Cursor; defaults to process.cwd()).
+ * @param force      If true, overwrite existing Cursor file without warning.
+ */
+export function writeSkillToClient(skillName, content, target, homeDir, skillsRoot, version = '0.0.0', cwd = process.cwd(), force = false) {
+    switch (target) {
+        case 'claude-code':
+            installClaudeCode({ skillName, content, homeDir, skillsRoot });
+            break;
+        case 'gemini':
+            installGeminiCli({ skillName, content, skillVersion: version, homeDir, skillsRoot });
+            break;
+        case 'codex':
+            installCodexCli({ skillName, content, homeDir, skillsRoot });
+            break;
+        case 'cursor':
+            installCursor({ content, cwd, homeDir, skillsRoot, force });
+            break;
+        default: {
+            const _exhaustive = target;
+            throw new Error(`install-skill: unknown target: ${_exhaustive}`);
+        }
+    }
+}
+/**
+ * Remove a skill's files from the target client's skill directory.
+ * Dispatches to the appropriate remover based on `target`.
+ *
+ * @param skillName  The skill name (used for claude-code path resolution).
+ * @param target     The AI client to uninstall the skill from.
+ * @param homeDir    Home directory (replaces os.homedir()).
+ * @param cwd        Current working directory (used by Cursor; defaults to process.cwd()).
+ */
+export function removeSkillFromClient(skillName, target, homeDir, cwd = process.cwd()) {
+    switch (target) {
+        case 'claude-code':
+            uninstallClaudeCode(skillName, homeDir);
+            break;
+        case 'gemini':
+            uninstallGeminiCli(homeDir);
+            break;
+        case 'codex':
+            uninstallCodexCli(homeDir);
+            break;
+        case 'cursor':
+            uninstallCursor(cwd);
+            break;
+        default: {
+            const _exhaustive = target;
+            throw new Error(`install-skill: unknown target: ${_exhaustive}`);
+        }
+    }
+}
+/**
+ * Return codes for `main()`.
+ * Exported so callers (e.g. the CLI dispatcher in cli/index.ts) can pass the
+ * code to `exit()` without calling `process.exit()` directly.
+ */
+export const ExitCode = Object.freeze({
+    SUCCESS: 0,
+    ERR_INVALID_ARGS: 1,
+    ERR_SKILL_NOT_FOUND: 2,
+    ERR_UNKNOWN_SKILL: 3,
+    ERR_NO_TARGETS: 4,
+    ERR_WRITER_NOT_IMPLEMENTED: 5,
+    ERR_UNKNOWN_TARGET: 7,
+    ERR_UNKNOWN: 8,
+});
+// ─── Core logic ─────────────────────────────────────────────────────────────
+/**
+ * Install a skill to the specified client targets.
+ * - dryRun=true: checks skill existence; does NOT write files or update manifest.
+ * - dryRun=false: writes files via the per-client writers.
+ */
+export function doInstall(skillName, targets, opts) {
+    const checkedPath = path.join(getSkillsRoot(opts.skillsRoot), skillName, 'SKILL.md');
+    const content = readSkillContent(skillName, opts.skillsRoot);
+    if (!content) {
+        throw new SkillNotFoundError(skillName, checkedPath);
+    }
+    const skillsRoot = getSkillsRoot(opts.skillsRoot);
+    const version = opts.version ?? '0.0.0';
+    const cwd = opts.cwd ?? process.cwd();
+    const installed = [];
+    const skipped = [];
+    for (const target of targets) {
+        if (opts.dryRun) {
+            // In dry-run: record target as skipped (would write), not installed
+            skipped.push(target);
+        }
+        else {
+            writeSkillToClient(skillName, content, target, opts.homeDir, skillsRoot, version, cwd, opts.force);
+            installed.push(target);
+        }
+    }
+    return { skill: skillName, action: 'installed', targets: installed, skipped, dryRun: opts.dryRun };
+}
+/**
+ * Uninstall a skill from the specified client targets.
+ * - dryRun=true: resolves targets; does NOT remove files or update manifest.
+ * - dryRun=false: removes files via the per-client removers.
+ */
+export function doUninstall(skillName, targets, opts) {
+    const cwd = opts.cwd ?? process.cwd();
+    const installed = [];
+    const skipped = [];
+    for (const target of targets) {
+        if (opts.dryRun) {
+            skipped.push(target);
+        }
+        else {
+            removeSkillFromClient(skillName, target, opts.homeDir, cwd);
+            installed.push(target);
+        }
+    }
+    return { skill: skillName, action: 'uninstalled', targets: installed, skipped, dryRun: opts.dryRun };
+}
+/**
+ * Parse CLI arguments for `install-skill`.
+ *
+ * NOTE: `stopEarly` is deliberately NOT set on minimist.  `stopEarly: true`
+ * causes options after the first positional argument to be treated as positional
+ * tail, which would misparse a call like:
+ *     mmagent install-skill mma-delegate --json
+ * (--json would be captured in `_` instead of setting the `json` flag).
+ * Instead we let minimist consume all arguments normally.
+ */
+export function parseArgs(argv) {
+    const args = minimist(argv, {
+        string: ['target', 'skill', 'config'],
+        boolean: ['uninstall', 'dry-run', 'json', 'all-targets'],
+        alias: {
+            u: 'uninstall',
+            j: 'json',
+            t: 'target',
+            c: 'config',
+        },
+        // stopEarly is NOT set — see note above.
+    });
+    const skill = args._[0] ?? null;
+    const configPath = typeof args['config'] === 'string' && args['config'].length > 0
+        ? args['config']
+        : null;
+    const uninstall = args['uninstall'] === true;
+    const dryRun = args['dry-run'] === true;
+    const json = args['json'] === true;
+    const allTargets = args['all-targets'] === true;
+    let targets = null;
+    if (args.target) {
+        const t = Array.isArray(args.target) ? args.target : [args.target];
+        targets = t.map((s) => s);
+    }
+    return { skill, configPath, uninstall, dryRun, json, targets, allTargets };
+}
+/**
+ * Resolve the target client list.
+ * Priority:
+ *   1. explicit `--target` arguments (validated against known clients)
+ *   2. `--all-targets` → all four known clients
+ *   3. auto-detect based on `homeDir`
+ *
+ * Explicit targets are de-duplicated while preserving order of first occurrence.
+ *
+ * @throws UnknownTargetError if an explicit target is not a known client.
+ */
+export function resolveTargets(explicitTargets, allTargets, homeDir) {
+    if (allTargets)
+        return [...ALL_CLIENTS];
+    if (explicitTargets !== null) {
+        const seen = new Set();
+        const deduped = [];
+        for (const t of explicitTargets) {
+            if (!ALL_CLIENTS.includes(t)) {
+                throw new UnknownTargetError(t, ALL_CLIENTS);
+            }
+            if (!seen.has(t)) {
+                seen.add(t);
+                deduped.push(t);
+            }
+        }
+        return deduped;
+    }
+    return detectClients(homeDir);
+}
+// ─── Output helpers ─────────────────────────────────────────────────────────
+/**
+ * Print an error message.
+ * Both branches write through the injectable `stderr` writer for testability.
+ */
+function printError(stderr, json, code, message, stdout) {
+    if (json) {
+        // JSON error output goes to stdout so callers can parse it
+        const out = stdout ?? process.stdout.write.bind(process.stdout);
+        out(JSON.stringify({ error: code, message }) + '\n');
+    }
+    else {
+        stderr(message + '\n');
+    }
+}
+/**
+ * Print a success result.
+ * All output goes through the injectable `stdout` writer for testability.
+ */
+function printResult(stdout, result, json, manifestUpdated) {
+    if (json) {
+        stdout(JSON.stringify(result) + '\n');
+    }
+    else {
+        const verb = result.action === 'installed' ? 'Installed' : 'Uninstalled';
+        const targetStr = result.targets.length > 0 ? ` → ${result.targets.join(', ')}` : '';
+        const skippedStr = result.skipped.length > 0 ? ` (dry-run: ${result.skipped.join(', ')})` : '';
+        let line = `${verb} '${result.skill}'${targetStr}${skippedStr}\n`;
+        if (manifestUpdated) {
+            line += 'Manifest updated.\n';
+        }
+        stdout(line);
+    }
+}
+/**
+ * Main entry point for `mmagent install-skill`.
+ *
+ * Returns an exit code (one of `ExitCode.*`) instead of calling `process.exit()`
+ * directly, so the CLI dispatcher in `cli/index.ts` can control the exit
+ * decision and make the function fully unit-testable.
+ */
+export async function main(deps = {}) {
+    const argv = deps.argv ?? process.argv.slice(2);
+    const homeDir = deps.homeDir ?? os.homedir();
+    const version = deps.version ?? '0.0.0';
+    const stdout = deps.stdout ?? process.stdout.write.bind(process.stdout);
+    const stderr = deps.stderr ?? process.stderr.write.bind(process.stderr);
+    const { skill, uninstall, dryRun, json, targets: explicitTargets, allTargets } = parseArgs(argv);
+    // ── 1. Validate skill name ──────────────────────────────────────────────────
+    if (!skill) {
+        const msg = 'Usage: mmagent install-skill [--uninstall] [--dry-run] [--json] [--target=<client>] [--all-targets] <skill-name>\n' +
+            'Skills: ' + SUPPORTED_SKILLS.join(', ');
+        printError(stderr, json, 'missing_skill_name', msg, stdout);
+        return ExitCode.ERR_INVALID_ARGS;
+    }
+    if (!SUPPORTED_SKILLS.includes(skill)) {
+        const msg = `Unknown skill '${skill}'. Available: ${SUPPORTED_SKILLS.join(', ')}`;
+        printError(stderr, json, 'unknown_skill', msg, stdout);
+        return ExitCode.ERR_UNKNOWN_SKILL;
+    }
+    // ── 2. Resolve targets (may throw UnknownTargetError) ──────────────────────
+    let resolvedTargets;
+    try {
+        resolvedTargets = resolveTargets(explicitTargets, allTargets, homeDir);
+    }
+    catch (err) {
+        if (err instanceof UnknownTargetError) {
+            printError(stderr, json, err.code, err.message, stdout);
+            return ExitCode.ERR_UNKNOWN_TARGET;
+        }
+        throw err;
+    }
+    // ── 3. Check that at least one target is available ─────────────────────────
+    if (resolvedTargets.length === 0) {
+        if (json) {
+            stdout(JSON.stringify({ skill, action: uninstall ? 'uninstalled' : 'installed', targets: [], skipped: [] }) + '\n');
+        }
+        else {
+            stdout('No clients detected. Use --target or --all-targets to specify targets.\n');
+        }
+        return ExitCode.ERR_NO_TARGETS;
+    }
+    // ── 4. Run install/uninstall ──────────────────────────────────────────────
+    const opts = { dryRun, homeDir, version, skillsRoot: deps.skillsRoot };
+    let result;
+    try {
+        result = uninstall
+            ? doUninstall(skill, resolvedTargets, opts)
+            : doInstall(skill, resolvedTargets, opts);
+    }
+    catch (err) {
+        if (err instanceof SkillNotFoundError) {
+            printError(stderr, json, err.code, err.message, stdout);
+            return ExitCode.ERR_SKILL_NOT_FOUND;
+        }
+        const msg = err instanceof Error ? err.message : String(err);
+        if (msg.includes('client writers are not yet implemented') ||
+            msg.includes('client removers are not yet implemented')) {
+            printError(stderr, json, 'writer_not_implemented', msg, stdout);
+            return ExitCode.ERR_WRITER_NOT_IMPLEMENTED;
+        }
+        printError(stderr, json, 'unknown', msg, stdout);
+        return ExitCode.ERR_UNKNOWN;
+    }
+    // ── 5. Update manifest (only when not in dry-run mode) ─────────────────────
+    let manifestUpdated = false;
+    if (!dryRun) {
+        if (uninstall) {
+            manifest.removeEntry(skill, resolvedTargets, homeDir);
+        }
+        else {
+            manifest.appendEntry(skill, version, resolvedTargets, homeDir);
+        }
+        manifestUpdated = true;
+    }
+    printResult(stdout, result, json, manifestUpdated);
+    return ExitCode.SUCCESS;
+}
+// ── Bootstrap ──────────────────────────────────────────────────────────────
+/**
+ * Robust main-module detection (matching the pattern used in cli/index.ts).
+ * Tests import main() directly and pass MainDeps; this function only gates
+ * the direct-execution bootstrap so the CLI binary can call main().
+ */
+function isMain() {
+    try {
+        const argv1 = process.argv[1];
+        if (!argv1)
+            return false;
+        const thisFile = import.meta.url.startsWith('file://')
+            ? fileURLToPath(import.meta.url)
+            : path.resolve(import.meta.url);
+        return path.resolve(argv1) === thisFile;
+    }
+    catch {
+        return false;
+    }
+}
+if (isMain()) {
+    main().then((code) => process.exit(code));
+}
+//# sourceMappingURL=install-skill.js.map

package/dist/cli/install-skill.js.map

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

package/dist/cli/print-token.d.ts

@@ -0,0 +1,18 @@
+export interface PrintTokenDeps {
+    /** Home directory (defaults to os.homedir()). */
+    homeDir?: string;
+    /** Token file path (already expanded). Overrides config discovery. */
+    tokenFile?: string;
+    /** Environment variable accessor. Defaults to process.env. */
+    env?: Record<string, string | undefined>;
+    /** Write to stdout. Defaults to process.stdout.write. */
+    stdout?: (s: string) => boolean;
+    /** Write to stderr. Defaults to process.stderr.write. */
+    stderr?: (s: string) => boolean;
+}
+/**
+ * Read the bearer token and print it to stdout.
+ * Returns 0 on success, 1 on error.
+ */
+export declare function printToken(deps?: PrintTokenDeps): number;
+//# sourceMappingURL=print-token.d.ts.map

package/dist/cli/print-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"print-token.d.ts","sourceRoot":"","sources":["../../src/cli/print-token.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,yDAAyD;IACzD,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IAChC,yDAAyD;IACzD,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;CACjC;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,GAAE,cAAmB,GAAG,MAAM,CAsC5D"}