@doist/twist-cli 2.21.1 → 2.21.2

package/dist/lib/skills/content.js

@@ -0,0 +1,286 @@
+export const SKILL_NAME = 'twist-cli';
+export const SKILL_DESCRIPTION = 'Twist messaging CLI for team communication';
+export const SKILL_CONTENT = `# Twist CLI (tw)
+
+Access Twist messaging via the \`tw\` CLI. Use when the user asks about their Twist workspaces, threads, messages, or wants to interact with Twist in any way.
+
+## Setup
+
+\`\`\`bash
+tw auth login                    # OAuth login (opens browser, read-write)
+tw auth login --read-only        # OAuth login with read-only scope
+tw auth token                    # Save API token manually (prompts securely; scope unknown, assumed write-capable)
+tw auth status                   # Verify authentication + show mode
+tw auth status --json            # JSON output: { id, email, name }
+tw auth logout                   # Remove saved token and auth metadata
+tw workspaces                    # List available workspaces
+tw workspace use <ref>           # Set current workspace
+tw completion install            # Install shell completions
+tw update                        # Update CLI to latest version
+tw changelog                     # Show recent changelog entries
+\`\`\`
+
+Stored auth uses the system credential manager when available. If secure storage is unavailable, \`tw\` warns and falls back to \`~/.config/twist-cli/config.json\`. \`TWIST_API_TOKEN\` always takes priority over the stored token, and legacy plaintext config tokens are migrated automatically when secure storage is available.
+
+In read-only mode (\`tw auth login --read-only\`), commands that modify Twist data (reply, archive, react, delete, etc.) are blocked by the CLI. Externally provided tokens (\`TWIST_API_TOKEN\` or \`tw auth token\`) are treated as unknown scope and assumed write-capable.
+
+## View by URL
+
+\`\`\`bash
+tw view <url>                    # View any Twist entity by URL
+\`\`\`
+
+Routes automatically based on URL structure:
+- Message URL → \`tw msg view\`
+- Conversation URL → \`tw conversation view\`
+- Thread+comment URL → \`tw thread view\` (comment ID extracted from URL)
+- Thread URL → \`tw thread view\`
+
+All target command flags pass through (e.g. \`--json\`, \`--raw\`, \`--full\`).
+
+## Inbox
+
+\`\`\`bash
+tw inbox                         # Show inbox threads
+tw inbox --unread                # Only unread threads
+tw inbox --channel <filter>      # Filter by channel name (fuzzy)
+tw inbox --since <date>          # Filter by date (ISO format)
+tw inbox --limit <n>             # Max items (default: 50)
+\`\`\`
+
+## Threads
+
+\`\`\`bash
+tw thread <thread-ref>           # View thread (shorthand for view)
+tw thread view <thread-ref>      # View thread with comments
+tw thread view <ref> --comment <id> # View a specific comment
+tw thread view <url-with-/c/id>  # Comment ID extracted from URL
+tw thread view <ref> --unread    # Show only unread comments
+tw thread view <ref> --context 3 # Include 3 read comments before unread
+tw thread view <ref> --limit 20  # Limit number of comments
+tw thread view <ref> --since <date> # Comments newer than date
+tw thread view <ref> --raw       # Show raw markdown
+tw thread create <channel-ref> "Title" "content"    # Create a new thread
+tw thread create <channel-ref> "Title" "content" --json       # Create and return as JSON
+tw thread create <channel-ref> "Title" "content" --json --full # Include all thread fields
+tw thread create <channel-ref> "Title" "content" --notify 123,456  # Notify specific users
+tw thread create <channel-ref> "Title" "content" --dry-run  # Preview without posting
+tw thread reply <ref> "content"  # Post a comment (notifies EVERYONE_IN_THREAD by default)
+tw thread reply <ref> "content" --notify EVERYONE  # Notify all workspace members
+tw thread reply <ref> "content" --notify 123,id:456   # Notify specific user IDs
+tw thread reply <ref> "content" --json  # Post and return comment as JSON
+tw thread reply <ref> "content" --json --full  # Include all comment fields
+tw thread reply <ref> "content" --close       # Reply and close the thread
+tw thread reply <ref> "content" --reopen      # Reply and reopen a closed thread
+tw thread done <ref>             # Archive thread (mark done)
+tw thread done <ref> --json      # Archive and return status as JSON
+tw thread mute <ref>             # Mute thread for 60 minutes (default)
+tw thread mute <ref> --minutes 480  # Mute for custom duration
+tw thread mute <ref> --json      # Mute and return { id, mutedUntil } as JSON
+tw thread mute <ref> --json --full  # Mute and return full thread as JSON
+tw thread unmute <ref>           # Unmute a muted thread
+tw thread unmute <ref> --json    # Unmute and return { id, mutedUntil } as JSON
+\`\`\`
+
+Default \`--notify\` for reply is EVERYONE_IN_THREAD, which may notify more people than intended. Before posting, confirm with the user whether specific people should be notified instead (via \`--notify <user-ids>\`). Options: EVERYONE, EVERYONE_IN_THREAD, or comma-separated user ID refs.
+
+## Thread Comments
+
+\`\`\`bash
+tw comment <comment-ref>                       # View a comment (shorthand for view)
+tw comment view <comment-ref>                  # View a single thread comment
+tw comment view <comment-ref> --raw            # Show raw markdown
+tw comment view <comment-ref> --json           # Output as JSON
+tw comment view <comment-ref> --json --full    # Include all fields in JSON output
+tw comment update <comment-ref> "new content"  # Update a thread comment
+tw comment update <comment-ref> "content" --json  # Update and return updated comment as JSON
+tw comment update <comment-ref> "content" --json --full  # Include all comment fields
+tw comment delete <comment-ref>                # Delete a thread comment
+tw comment delete <comment-ref> --json         # Delete and return status as JSON
+\`\`\`
+
+## Conversations (DMs/Groups)
+
+\`\`\`bash
+tw conversation unread                    # List unread conversations
+tw conversation <conversation-ref>        # View conversation (shorthand for view)
+tw conversation view <conversation-ref>   # View conversation messages
+tw conversation with <user-ref>           # Find your 1:1 DM with a user
+tw conversation with <user-ref> --snippet # Include the latest message preview
+tw conversation with <user-ref> --include-groups # List any conversations with that user
+tw conversation reply <ref> "content"     # Send a message
+tw conversation reply <ref> "content" --json  # Send and return message as JSON
+tw conversation reply <ref> "content" --json --full  # Include all message fields
+tw conversation done <ref>                # Archive conversation
+tw conversation done <ref> --json         # Archive and return status as JSON
+tw conversation mute <ref>               # Mute conversation for 60 minutes (default)
+tw conversation mute <ref> --minutes 480 # Mute for custom duration
+tw conversation mute <ref> --json        # Mute and return { id, mutedUntil } as JSON
+tw conversation mute <ref> --json --full # Mute and return full conversation as JSON
+tw conversation unmute <ref>             # Unmute a muted conversation
+tw conversation unmute <ref> --json      # Unmute and return { id, mutedUntil } as JSON
+\`\`\`
+
+Alias: \`tw convo\` works the same as \`tw conversation\`.
+
+## Conversation Messages
+
+\`\`\`bash
+tw msg <message-ref>             # View a message (shorthand for view)
+tw msg view <message-ref>        # View a single conversation message
+tw msg update <ref> "content"    # Edit a conversation message
+tw msg update <ref> "content" --json  # Edit and return updated message as JSON
+tw msg update <ref> "content" --json --full  # Include all message fields
+tw msg delete <ref>              # Delete a conversation message
+tw msg delete <ref> --json       # Delete and return status as JSON
+\`\`\`
+
+Alias: \`tw message\` works the same as \`tw msg\`.
+
+## Search
+
+\`\`\`bash
+tw search "query"                # Search content
+tw search "query" --type threads # Filter: threads, messages, or all
+tw search "query" --author <ref> # Filter by author
+tw search "query" --to <ref>     # Messages sent to user
+tw search "query" --title-only   # Search thread titles only
+tw search "query" --mention-me   # Results mentioning current user
+tw search "query" --conversation <refs> # Limit to conversations (comma-separated refs)
+tw search "query" --since <date> # Content from date
+tw search "query" --until <date> # Content until date
+tw search "query" --channel <refs> # Filter by channel refs (comma-separated)
+tw search "query" --limit <n>    # Max results (default: 50)
+tw search "query" --cursor <cur> # Pagination cursor
+\`\`\`
+
+## Users & Channels
+
+\`\`\`bash
+tw user                          # Show current user info
+tw users                         # List workspace users
+tw users --search <text>         # Filter by name/email
+tw channels                      # List workspace channels
+\`\`\`
+
+## Away Status
+
+\`\`\`bash
+tw away                          # Show current away status
+tw away set <type> [until]       # Set away (type: vacation, parental, sickleave, other)
+tw away set vacation 2026-03-20  # Away until March 20
+tw away set vacation 2026-03-20 --from 2026-03-15  # Custom start date
+tw away clear                    # Clear away status
+\`\`\`
+
+## Reactions
+
+\`\`\`bash
+tw react thread <ref> 👍         # Add reaction to thread
+tw react comment <ref> +1        # Add reaction (shortcode)
+tw react message <ref> heart     # Add reaction to DM message
+tw unreact thread <ref> 👍       # Remove reaction
+\`\`\`
+
+Supported shortcodes: +1, -1, heart, tada, smile, laughing, thinking, fire, check, x, eyes, pray, clap, rocket, wave
+
+## Shell Completions
+
+\`\`\`bash
+tw completion install            # Install tab completions (prompts for shell)
+tw completion install bash       # Install for specific shell
+tw completion install zsh
+tw completion install fish
+tw completion uninstall          # Remove completions
+\`\`\`
+
+### Update
+
+\`\`\`bash
+tw update                        # Update CLI to latest version
+tw update --check                # Check for updates without installing
+\`\`\`
+
+### Changelog
+\`\`\`bash
+tw changelog                     # Show last 5 versions
+tw changelog -n 3                # Show last 3 versions
+tw changelog --count 10          # Show last 10 versions
+\`\`\`
+
+## Global Options
+
+\`\`\`bash
+--no-spinner       # Disable loading animations
+--progress-jsonl   # Machine-readable progress events (JSONL to stderr)
+--accessible       # Add text labels to color-coded output (also: TW_ACCESSIBLE=1)
+\`\`\`
+
+## Output Formats
+
+All list/view commands support:
+
+\`\`\`bash
+--json    # Output as JSON
+--ndjson  # Output as newline-delimited JSON (for streaming)
+--full    # Include all fields (default shows essential fields only)
+\`\`\`
+
+## Reference System
+
+Commands accept flexible references:
+- **Numeric IDs**: \`123\` or \`id:123\`
+- **Twist URLs**: Full \`https://twist.com/...\` URLs (parsed automatically)
+- **Fuzzy names**: For workspaces/users - \`"My Workspace"\` or partial matches
+
+## Piping Content
+
+Commands that accept content (\`thread create\`, \`thread reply\`, \`comment update\`, \`conversation reply\`, \`msg update\`) auto-detect piped stdin:
+
+\`\`\`bash
+cat notes.md | tw thread reply <ref>
+tw thread create <channel-ref> "Title" < body.md
+echo "Quick reply" | tw conversation reply <ref>
+\`\`\`
+
+If no content argument is provided and no stdin is piped, the CLI opens \`$EDITOR\` for interactive input.
+
+## Common Workflows
+
+**View by URL (auto-routes to the right command):**
+\`\`\`bash
+tw view https://twist.com/a/1585/ch/100/t/200          # View thread
+tw view https://twist.com/a/1585/ch/100/t/200/c/300     # View comment
+tw view https://twist.com/a/1585/msg/400                 # View conversation
+tw view https://twist.com/a/1585/msg/400/m/500 --json    # View message as JSON
+\`\`\`
+
+**Check inbox and respond:**
+\`\`\`bash
+tw inbox --unread --json
+tw thread view <id> --unread
+tw thread reply <id> "Thanks, I'll look into this."
+tw thread done <id>
+\`\`\`
+
+**Search and review:**
+\`\`\`bash
+tw search "deployment" --type threads --json
+tw thread view <thread-id>
+\`\`\`
+
+**Check DMs:**
+\`\`\`bash
+tw conversation unread --json
+tw conversation view <conversation-id>
+tw conversation with "Alice Example"
+tw conversation reply <id> "Got it, thanks!"
+\`\`\`
+`;
+export const SKILL_FILE_CONTENT = `---
+name: ${SKILL_NAME}
+description: ${JSON.stringify(SKILL_DESCRIPTION)}
+---
+
+${SKILL_CONTENT}`;
+//# sourceMappingURL=content.js.map

package/dist/lib/skills/content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../../src/lib/skills/content.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG,WAAW,CAAA;AAErC,MAAM,CAAC,MAAM,iBAAiB,GAAG,4CAA4C,CAAA;AAE7E,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoR5B,CAAA;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG;QAC1B,UAAU;eACH,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC;;;EAG9C,aAAa,EAAE,CAAA"}

package/dist/lib/skills/create-installer.d.ts

@@ -0,0 +1,9 @@
+import type { SkillInstaller } from './types.js';
+interface InstallerConfig {
+    name: string;
+    description: string;
+    dirName: string;
+}
+export declare function createInstaller(config: InstallerConfig): SkillInstaller;
+export {};
+//# sourceMappingURL=create-installer.d.ts.map

package/dist/lib/skills/create-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-installer.d.ts","sourceRoot":"","sources":["../../../src/lib/skills/create-installer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAkB,cAAc,EAAmC,MAAM,YAAY,CAAA;AAEjG,UAAU,eAAe;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;CAClB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,cAAc,CAqEvE"}

package/dist/lib/skills/create-installer.js

@@ -0,0 +1,60 @@
+import { mkdir, rm, stat, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { SKILL_FILE_CONTENT, SKILL_NAME } from './content.js';
+export function createInstaller(config) {
+    function getInstallPath(options) {
+        const base = options.local ? process.cwd() : homedir();
+        return join(base, config.dirName, 'skills', SKILL_NAME, 'SKILL.md');
+    }
+    return {
+        name: config.name,
+        description: config.description,
+        getInstallPath,
+        async isInstalled(options) {
+            try {
+                await stat(getInstallPath(options));
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+        async install(options) {
+            if (!options.local && config.dirName !== '.agents') {
+                const agentDir = join(homedir(), config.dirName);
+                try {
+                    await stat(agentDir);
+                }
+                catch {
+                    throw new Error(`${config.name} does not appear to be installed (${agentDir} not found)`);
+                }
+            }
+            const skillPath = getInstallPath(options);
+            const exists = await this.isInstalled(options);
+            if (exists && !options.force) {
+                throw new Error(`Skill already installed at ${skillPath}. Use --force to overwrite.`);
+            }
+            await mkdir(dirname(skillPath), { recursive: true });
+            await writeFile(skillPath, SKILL_FILE_CONTENT);
+        },
+        async update(options) {
+            const skillPath = getInstallPath(options);
+            const exists = await this.isInstalled(options);
+            if (!exists) {
+                throw new Error(`Skill not installed at ${skillPath}`);
+            }
+            await writeFile(skillPath, SKILL_FILE_CONTENT);
+        },
+        async uninstall(options) {
+            const skillPath = getInstallPath(options);
+            const exists = await this.isInstalled(options);
+            if (!exists) {
+                throw new Error(`Skill not installed at ${skillPath}`);
+            }
+            const skillDir = dirname(skillPath);
+            await rm(skillDir, { recursive: true });
+        },
+    };
+}
+//# sourceMappingURL=create-installer.js.map

package/dist/lib/skills/create-installer.js.map

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

package/dist/lib/skills/index.d.ts

@@ -0,0 +1,7 @@
+import type { AgentInfo, SkillInstaller } from './types.js';
+export declare const skillInstallers: Record<string, SkillInstaller>;
+export declare function getInstaller(name: string): SkillInstaller | null;
+export declare function listAgentNames(): string[];
+export declare function listAgents(local: boolean): Promise<AgentInfo[]>;
+export type { AgentInfo, InstallOptions, SkillInstaller, UninstallOptions, UpdateOptions, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/skills/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/skills/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAE3D,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CA+B1D,CAAA;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAEhE;AAED,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAEzC;AAED,wBAAsB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAerE;AAED,YAAY,EACR,SAAS,EACT,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,aAAa,GAChB,MAAM,YAAY,CAAA"}

package/dist/lib/skills/index.js

@@ -0,0 +1,54 @@
+import { createInstaller } from './create-installer.js';
+export const skillInstallers = {
+    'claude-code': createInstaller({
+        name: 'claude-code',
+        description: 'Claude Code skill for Twist CLI',
+        dirName: '.claude',
+    }),
+    codex: createInstaller({
+        name: 'codex',
+        description: 'Codex skill for Twist CLI',
+        dirName: '.codex',
+    }),
+    cursor: createInstaller({
+        name: 'cursor',
+        description: 'Cursor skill for Twist CLI',
+        dirName: '.cursor',
+    }),
+    gemini: createInstaller({
+        name: 'gemini',
+        description: 'Gemini CLI skill for Twist CLI',
+        dirName: '.gemini',
+    }),
+    pi: createInstaller({
+        name: 'pi',
+        description: 'Pi skill for Twist CLI',
+        dirName: '.pi',
+    }),
+    universal: createInstaller({
+        name: 'universal',
+        description: 'Universal agent skill for Twist CLI',
+        dirName: '.agents',
+    }),
+};
+export function getInstaller(name) {
+    return skillInstallers[name] ?? null;
+}
+export function listAgentNames() {
+    return Object.keys(skillInstallers);
+}
+export async function listAgents(local) {
+    const agents = [];
+    for (const name of listAgentNames()) {
+        const installer = skillInstallers[name];
+        const installed = await installer.isInstalled({ local });
+        agents.push({
+            name,
+            description: installer.description,
+            installed,
+            path: installed ? installer.getInstallPath({ local }) : null,
+        });
+    }
+    return agents;
+}
+//# sourceMappingURL=index.js.map

package/dist/lib/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/skills/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAGvD,MAAM,CAAC,MAAM,eAAe,GAAmC;IAC3D,aAAa,EAAE,eAAe,CAAC;QAC3B,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,iCAAiC;QAC9C,OAAO,EAAE,SAAS;KACrB,CAAC;IACF,KAAK,EAAE,eAAe,CAAC;QACnB,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,2BAA2B;QACxC,OAAO,EAAE,QAAQ;KACpB,CAAC;IACF,MAAM,EAAE,eAAe,CAAC;QACpB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,4BAA4B;QACzC,OAAO,EAAE,SAAS;KACrB,CAAC;IACF,MAAM,EAAE,eAAe,CAAC;QACpB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,gCAAgC;QAC7C,OAAO,EAAE,SAAS;KACrB,CAAC;IACF,EAAE,EAAE,eAAe,CAAC;QAChB,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,wBAAwB;QACrC,OAAO,EAAE,KAAK;KACjB,CAAC;IACF,SAAS,EAAE,eAAe,CAAC;QACvB,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,qCAAqC;QAClD,OAAO,EAAE,SAAS;KACrB,CAAC;CACL,CAAA;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACrC,OAAO,eAAe,CAAC,IAAI,CAAC,IAAI,IAAI,CAAA;AACxC,CAAC;AAED,MAAM,UAAU,cAAc;IAC1B,OAAO,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;AACvC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAc;IAC3C,MAAM,MAAM,GAAgB,EAAE,CAAA;IAE9B,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,EAAE,CAAC;QAClC,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,CAAC,CAAA;QACvC,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;QACxD,MAAM,CAAC,IAAI,CAAC;YACR,IAAI;YACJ,WAAW,EAAE,SAAS,CAAC,WAAW;YAClC,SAAS;YACT,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI;SAC/D,CAAC,CAAA;IACN,CAAC;IAED,OAAO,MAAM,CAAA;AACjB,CAAC"}

package/dist/lib/skills/types.d.ts

@@ -0,0 +1,30 @@
+export interface InstallOptions {
+    local?: boolean;
+    force?: boolean;
+}
+export interface UninstallOptions {
+    local?: boolean;
+}
+export interface UpdateOptions {
+    local?: boolean;
+}
+export interface SkillInstaller {
+    name: string;
+    description: string;
+    install(options: InstallOptions): Promise<void>;
+    update(options: UpdateOptions): Promise<void>;
+    uninstall(options: UninstallOptions): Promise<void>;
+    isInstalled(options: {
+        local?: boolean;
+    }): Promise<boolean>;
+    getInstallPath(options: {
+        local?: boolean;
+    }): string;
+}
+export interface AgentInfo {
+    name: string;
+    description: string;
+    installed: boolean;
+    path: string | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/skills/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/skills/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,KAAK,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,aAAa;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/C,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7C,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACnD,WAAW,CAAC,OAAO,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC3D,cAAc,CAAC,OAAO,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,CAAA;CACvD;AAED,MAAM,WAAW,SAAS;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,OAAO,CAAA;IAClB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB"}

package/dist/lib/skills/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/lib/skills/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/skills/types.ts"],"names":[],"mappings":""}

package/dist/lib/skills/update-installed.d.ts

@@ -0,0 +1,9 @@
+export interface UpdateAllResult {
+    updated: string[];
+    skipped: string[];
+    errors: string[];
+}
+export declare function updateAllInstalledSkills(options: {
+    local?: boolean;
+}): Promise<UpdateAllResult>;
+//# sourceMappingURL=update-installed.d.ts.map

package/dist/lib/skills/update-installed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-installed.d.ts","sourceRoot":"","sources":["../../../src/lib/skills/update-installed.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,wBAAsB,wBAAwB,CAAC,OAAO,EAAE;IACpD,KAAK,CAAC,EAAE,OAAO,CAAA;CAClB,GAAG,OAAO,CAAC,eAAe,CAAC,CAkB3B"}

package/dist/lib/skills/update-installed.js

@@ -0,0 +1,20 @@
+import { skillInstallers } from './index.js';
+export async function updateAllInstalledSkills(options) {
+    const result = { updated: [], skipped: [], errors: [] };
+    for (const [name, installer] of Object.entries(skillInstallers)) {
+        try {
+            const installed = await installer.isInstalled(options);
+            if (!installed) {
+                result.skipped.push(name);
+                continue;
+            }
+            await installer.update(options);
+            result.updated.push(name);
+        }
+        catch (err) {
+            result.errors.push(`${name}: ${err.message}`);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=update-installed.js.map

package/dist/lib/skills/update-installed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-installed.js","sourceRoot":"","sources":["../../../src/lib/skills/update-installed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAQ5C,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,OAE9C;IACG,MAAM,MAAM,GAAoB,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAA;IAExE,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;QAC9D,IAAI,CAAC;YACD,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;YACtD,IAAI,CAAC,SAAS,EAAE,CAAC;gBACb,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBACzB,SAAQ;YACZ,CAAC;YACD,MAAM,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;YAC/B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAA;QAC5D,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAA;AACjB,CAAC"}

package/dist/lib/spinner.d.ts

@@ -0,0 +1,24 @@
+interface SpinnerOptions {
+    text: string;
+    color?: 'green' | 'yellow' | 'blue' | 'red' | 'gray' | 'cyan' | 'magenta';
+    noSpinner?: boolean;
+}
+export declare function startEarlySpinner(): void;
+export declare function stopEarlySpinner(): void;
+/** For tests only — reset singleton state without stopping */
+export declare function resetEarlySpinner(): void;
+declare class LoadingSpinner {
+    private spinnerInstance;
+    private adopted;
+    start(options: SpinnerOptions): this;
+    succeed(text?: string): void;
+    fail(text?: string): void;
+    stop(): void;
+}
+/**
+ * High-level wrapper function for running async operations with a loading spinner.
+ * Automatically handles success/failure states and cleanup.
+ */
+export declare function withSpinner<T>(options: SpinnerOptions, asyncOperation: () => Promise<T>): Promise<T>;
+export { LoadingSpinner, type SpinnerOptions };
+//# sourceMappingURL=spinner.d.ts.map

package/dist/lib/spinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../src/lib/spinner.ts"],"names":[],"mappings":"AAGA,UAAU,cAAc;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IACzE,SAAS,CAAC,EAAE,OAAO,CAAA;CACtB;AA8BD,wBAAgB,iBAAiB,IAAI,IAAI,CAcxC;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CASvC;AAED,8DAA8D;AAC9D,wBAAgB,iBAAiB,IAAI,IAAI,CAGxC;AAID,cAAM,cAAc;IAChB,OAAO,CAAC,eAAe,CAA+C;IACtE,OAAO,CAAC,OAAO,CAAQ;IAEvB,KAAK,CAAC,OAAO,EAAE,cAAc;IAuB7B,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM;IAcrB,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM;IASlB,IAAI;CAaP;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAC/B,OAAO,EAAE,cAAc,EACvB,cAAc,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACjC,OAAO,CAAC,CAAC,CAAC,CAWZ;AAED,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,CAAA"}