@doist/comms-cli 0.0.1 → 1.1.0

package/dist/lib/skills/content.js

@@ -0,0 +1,419 @@
+import packageJson from '../../../package.json' with { type: 'json' };
+export const SKILL_NAME = 'comms-cli';
+export const SKILL_DESCRIPTION = 'Comms messaging CLI. View and respond to inbox threads, channel threads, direct messages, mentions, and group conversations; search, react, archive, mute, and manage workspaces. Use when the user mentions Comms, asks about their inbox, mentions, threads, DMs, channels, or wants to read or send Comms messages.';
+export const SKILL_AUTHOR = 'Doist';
+export const SKILL_LICENSE = 'MIT';
+export const SKILL_VERSION = packageJson.version;
+export const SKILL_CONTENT = `# Comms CLI (tdc)
+
+Access Comms messaging via the \`tdc\` CLI. Use when the user asks about their Comms workspaces, threads, messages, or wants to interact with Comms in any way.
+
+## Setup
+
+\`\`\`bash
+tdc auth login                    # OAuth login (opens browser, read-write)
+tdc auth login --read-only        # OAuth login with read-only scope
+tdc auth login --callback-port <n># Override the local OAuth callback port (default 8766)
+tdc auth login --json             # Emit a JSON envelope for scripted / agent use
+tdc auth login --ndjson           # Emit an NDJSON envelope for scripted / agent use
+tdc auth token                    # Save API token manually (prompts securely; scope unknown, assumed write-capable)
+tdc auth status                   # Verify authentication + show mode
+tdc auth status --json            # Full status payload as JSON (--ndjson also supported)
+tdc auth status --user <ref>      # Target a specific stored account (id, id:<n>, or display name)
+tdc --user <ref> auth <status|logout|token view>  # Equivalent to passing --user after the subcommand; other commands accept the flag but ignore it
+tdc auth logout                   # Remove saved token and auth metadata
+tdc auth logout --json            # Emits \`{"ok": true}\` (--ndjson is silent)
+tdc auth logout --user <ref>      # Target a specific stored account; mismatched ref errors with ACCOUNT_NOT_FOUND
+tdc auth token view               # Print the saved token to stdout (pipe-safe; refuses if COMMS_API_TOKEN is set)
+tdc auth token view --user <ref>  # Print the saved token for a specific stored account
+tdc account [list|current|use <ref>|remove <ref>]  # Manage stored accounts; all support --json/--ndjson
+                                 # current's payload is {id, label, authMode, authScope, source:"config"} | {source:"env"} | {source:"token-only"}
+tdc auth login                    # Re-running auth login with a different OAuth grant adds a NEW account; default stays pinned unless none was set
+tdc workspaces                    # List available workspaces
+tdc workspace use <ref>           # Set current workspace
+tdc completion install            # Install shell completions
+tdc config view                   # Show the current CLI configuration file (token masked)
+tdc config set <key> <value>      # Set a user preference (e.g. unarchive-new-threads true)
+tdc doctor                        # Diagnose CLI setup and environment issues
+tdc update                        # Update CLI to latest version
+tdc changelog                     # Show recent changelog entries
+\`\`\`
+
+Stored auth uses the system credential manager when available. If secure storage is unavailable, \`tdc\` warns and falls back to \`~/.config/comms-cli/config.json\`. \`COMMS_API_TOKEN\` always takes priority over the stored token.
+
+In read-only mode (\`tdc auth login --read-only\`), commands that modify Comms data (reply, archive, react, delete, etc.) are blocked by the CLI. Externally provided tokens (\`COMMS_API_TOKEN\` or \`tdc auth token\`) are treated as unknown scope and assumed write-capable.
+
+## View by URL
+
+\`\`\`bash
+tdc view <url>                    # View any Comms entity by URL
+\`\`\`
+
+Routes automatically based on URL structure:
+- Message URL → \`tdc msg view\`
+- Conversation URL → \`tdc conversation view\`
+- Thread+comment URL → \`tdc thread view\` (comment ID extracted from URL)
+- Thread URL → \`tdc thread view\`
+
+All target command flags pass through (e.g. \`--json\`, \`--raw\`, \`--full\`).
+
+## Inbox
+
+\`\`\`bash
+tdc inbox                         # Show inbox threads
+tdc inbox --unread                # Only unread threads
+tdc inbox --archive-filter all      # Show active + done threads
+tdc inbox --archive-filter archived # Show only done threads
+tdc inbox --channel <filter>      # Filter by channel name (fuzzy)
+tdc inbox --since <date>          # Filter by date (ISO format)
+tdc inbox --limit <n>             # Max items (default: 50)
+\`\`\`
+
+## Threads
+
+\`\`\`bash
+tdc thread <thread-ref>           # View thread (shorthand for view)
+tdc thread view <thread-ref>      # View thread with comments
+tdc thread view <ref> --comment <id> # View a specific comment
+tdc thread view <url-with-/c/id>  # Comment ID extracted from URL
+tdc thread view <ref> --unread    # Show only unread comments
+tdc thread view <ref> --context 3 # Include 3 read comments before unread
+tdc thread view <ref> --limit 20  # Limit number of comments
+tdc thread view <ref> --since <date> # Comments newer than date
+tdc thread view <ref> --raw       # Show raw markdown
+tdc thread create <channel-ref> "Title" "content"    # Create a new thread
+tdc thread create <channel-ref> "Title" "content" --json       # Create and return as JSON
+tdc thread create <channel-ref> "Title" "content" --json --full # Include all thread fields
+tdc thread create <channel-ref> "Title" "content" --notify 123,456  # Notify specific users
+tdc thread create <channel-ref> "Title" "content" --unarchive  # Land thread in author's Inbox (overrides default Comms auto-archive)
+tdc thread create <channel-ref> "Title" "content" --no-unarchive  # Force archive even when userSettings.unarchiveNewThreads=true
+tdc thread create <channel-ref> "Title" "content" --dry-run  # Preview without posting
+tdc thread reply <ref> "content"  # Post a comment (notifies EVERYONE_IN_THREAD by default)
+tdc thread reply <ref> "content" --notify EVERYONE  # Notify all workspace members
+tdc thread reply <ref> "content" --notify 123,id:456   # Notify specific user IDs
+tdc thread reply <ref> "content" --json  # Post and return comment as JSON
+tdc thread reply <ref> "content" --json --full  # Include all comment fields
+tdc thread reply <ref> "content" --close       # Reply and close the thread
+tdc thread reply <ref> "content" --reopen      # Reply and reopen a closed thread
+tdc thread done <ref>             # Archive thread (mark done)
+tdc thread done <ref> --json      # Archive and return status as JSON
+tdc thread mute <ref>             # Mute thread for 60 minutes (default)
+tdc thread mute <ref> --minutes 480  # Mute for custom duration
+tdc thread mute <ref> --json      # Mute and return { id, mutedUntil } as JSON
+tdc thread mute <ref> --json --full  # Mute and return full thread as JSON
+tdc thread unmute <ref>           # Unmute a muted thread
+tdc thread unmute <ref> --json    # Unmute and return { id, mutedUntil } as JSON
+tdc thread delete <ref>             # Preview thread deletion (requires --yes to execute)
+tdc thread delete <ref> --yes       # Permanently delete a thread
+tdc thread delete <ref> --yes --json # Delete and return status as JSON
+tdc thread rename <ref> "New title"  # Rename a thread (change its title)
+tdc thread rename <ref> "New title" --json  # Rename and return { id, title } as JSON
+tdc thread rename <ref> "New title" --json --full  # Rename and return full thread as JSON
+tdc thread update <ref> "New body"   # Update a thread's body (the first post)
+echo "New body" | tdc thread update <ref>  # Update body from stdin
+tdc thread update <ref> "New body" --dry-run  # Preview without updating
+tdc thread update <ref> "New body" --json  # Update and return { id, content } as JSON
+tdc thread update <ref> "New body" --json --full  # Update and return full thread 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 ID refs.
+
+\`--notify\` automatically resolves IDs: group IDs are routed to the \`groups\` API field, user IDs to \`recipients\`. No special syntax needed.
+
+## Thread Comments
+
+\`\`\`bash
+tdc comment <comment-ref>                       # View a comment (shorthand for view)
+tdc comment view <comment-ref>                  # View a single thread comment
+tdc comment view <comment-ref> --raw            # Show raw markdown
+tdc comment view <comment-ref> --json           # Output as JSON
+tdc comment view <comment-ref> --ndjson         # Output as newline-delimited JSON
+tdc comment view <comment-ref> --json --full    # Include all fields in JSON output
+tdc comment update <comment-ref> "new content"  # Update a thread comment
+tdc comment update <comment-ref> "content" --json  # Update and return updated comment as JSON
+tdc comment update <comment-ref> "content" --json --full  # Include all comment fields
+tdc comment delete <comment-ref>                # Delete a thread comment
+tdc comment delete <comment-ref> --json         # Delete and return status as JSON
+\`\`\`
+
+## Conversations (DMs/Groups)
+
+\`\`\`bash
+tdc conversation unread                    # List unread conversations
+tdc conversation <conversation-ref>        # View conversation (shorthand for view)
+tdc conversation view <conversation-ref>   # View conversation messages
+tdc conversation with <user-ref>           # Find your 1:1 DM with a user
+tdc conversation with <user-ref> --snippet # Include the latest message preview
+tdc conversation with <user-ref> --include-groups # List any conversations with that user
+tdc conversation reply <ref> "content"     # Send a message
+tdc conversation reply <ref> "content" --json  # Send and return message as JSON
+tdc conversation reply <ref> "content" --json --full  # Include all message fields
+tdc conversation done <ref>                # Archive conversation
+tdc conversation done <ref> --json         # Archive and return status as JSON
+tdc conversation mute <ref>               # Mute conversation for 60 minutes (default)
+tdc conversation mute <ref> --minutes 480 # Mute for custom duration
+tdc conversation mute <ref> --json        # Mute and return { id, mutedUntil } as JSON
+tdc conversation mute <ref> --json --full # Mute and return full conversation as JSON
+tdc conversation unmute <ref>             # Unmute a muted conversation
+tdc conversation unmute <ref> --json      # Unmute and return { id, mutedUntil } as JSON
+\`\`\`
+
+Alias: \`tdc convo\` works the same as \`tdc conversation\`.
+
+## Conversation Messages
+
+\`\`\`bash
+tdc msg <message-ref>             # View a message (shorthand for view)
+tdc msg view <message-ref>        # View a single conversation message
+tdc msg update <ref> "content"    # Edit a conversation message
+tdc msg update <ref> "content" --json  # Edit and return updated message as JSON
+tdc msg update <ref> "content" --json --full  # Include all message fields
+tdc msg delete <ref>              # Delete a conversation message
+tdc msg delete <ref> --json       # Delete and return status as JSON
+\`\`\`
+
+Alias: \`tdc message\` works the same as \`tdc msg\`.
+
+## Search
+
+\`\`\`bash
+tdc mentions                      # Show content mentioning current user
+tdc mentions --since 2026-04-01 --all # Fetch every mention since a date
+tdc mentions --type threads --json # Limit mentions to threads
+tdc search "query"                # Search content
+tdc search "query" --type threads # Filter: threads, messages, or all
+tdc search "query" --author <ref> # Filter by author
+tdc search "query" --to <ref>     # Messages sent to user
+tdc search "query" --title-only   # Search thread titles only
+tdc search "query" --mention-me   # Results mentioning current user
+tdc search "query" --conversation <refs> # Limit to conversations (comma-separated refs)
+tdc search "query" --since <date> # Content from date
+tdc search "query" --until <date> # Content until date
+tdc search "query" --channel <refs> # Filter by channel refs (comma-separated)
+tdc search "query" --limit <n>    # Max results (default: 50)
+tdc search "query" --cursor <cur> # Pagination cursor
+tdc search "query" --all          # Fetch all result pages
+\`\`\`
+
+## Users, Channels & Groups
+
+\`\`\`bash
+tdc user                          # Show current user info
+tdc user --json                   # JSON output
+tdc user --json --full            # Include all fields in JSON output
+tdc users                         # List workspace users
+tdc users --search <text>         # Filter by name/email
+tdc channels                      # List active joined workspace channels (alias of: tdc channel list)
+tdc channels --state all          # Include archived joined channels too
+tdc channels --scope discoverable # Active public channels you can see but have not joined
+tdc channels --scope public --state all --json # All visible public channels, with joined status
+tdc channel create "Engineering"  # Create a channel in the current workspace
+tdc channel create "Leadership Team" --private --users id:10,id:20 # Create private channel with initial members
+tdc channel create "Product" --workspace "Doist" --description "Product discussions" --json # Create and return channel as JSON
+tdc channel update <channel-ref> "New name" # Rename a channel
+tdc channel update <ref> --name "New name" # Rename with an explicit flag
+tdc channel update <ref> --description "Team discussions" # Update channel description
+tdc channel update <ref> --clear-description # Clear channel description
+tdc channel update <ref> --public # Make a channel public (--private makes it private)
+tdc channel update <ref> --description "Team discussions" --json --full # Update and return all channel fields
+tdc channel threads <channel-ref>  # List threads in a channel (fuzzy name, id:, numeric ID, or URL)
+tdc channel threads "general" --unread       # Only unread threads
+tdc channel threads <ref> --archive-filter all  # Include archived threads (active|archived|all)
+tdc channel threads <ref> --since 2026-01-01 # Filter by last-updated date (ISO)
+tdc channel threads <ref> --limit 20         # Max threads per page (default: 50)
+tdc channel threads <ref> --limit 20 --cursor <cursor-from-prev> # Paginate
+tdc channel threads <ref> --json  # { results, nextCursor } with isUnread + url
+tdc channel members <channel-ref> # List a channel's members + groups fully in the channel
+tdc channel members <ref> --json  # JSON with id, name, workspaceId, members
+tdc channel members add <ref> alice group:Design # Add users and/or expand group:<ref> members
+tdc channel members add <ref> a@d.com id:789 --json # Add refs, output result as JSON
+tdc channel members remove <ref> alice group:Frontend # Remove users and/or group members
+tdc channel members set <ref> group:Squad --apply # Replace membership with the resolved set
+tdc channel members set <ref> alice bob # Dry-run by default; refuses to remove you (--include-self to override)
+tdc groups                        # List workspace groups
+tdc groups --search "frontend"    # Filter groups by name (case-insensitive)
+tdc groups --json                 # JSON output
+tdc groups --json --full          # Include all fields in JSON output
+tdc groups view <group-ref>       # Show group with member details
+tdc groups view <ref> --json      # JSON output with id, name, workspaceId, members
+tdc groups view <ref> --json --full  # Include all fields in JSON output
+tdc groups create "Name"          # Create a new group
+tdc groups create "Name" --users alice@doist.com,bob@doist.com  # Create with members
+tdc groups create "Name" --json   # Output created group as JSON
+tdc groups rename <group-ref> "New name"  # Rename a group
+tdc groups rename <ref> "Name" --json     # Output renamed group as JSON
+tdc groups delete <group-ref> --yes       # Delete a group (requires --yes)
+tdc groups delete <ref> --dry-run         # Preview deletion
+tdc groups add-user <group-ref> user1 user2   # Add users to a group
+tdc groups add-user <ref> a@d.com,b@d.com     # Comma-separated refs
+tdc groups add-user <ref> id:123 --json       # Output result as JSON
+tdc groups remove-user <group-ref> user1 user2  # Remove users from a group
+tdc groups remove-user <ref> id:123,id:456      # Comma-separated ID refs
+\`\`\`
+
+If a channel is not found in \`tdc channels\`, widen with broader listings such as \`tdc channels --scope public\`, then \`tdc channels --scope public --state all\`. Check \`tdc channels --help\` for other available filters.
+
+\`tdc channel threads\` returns every thread in the channel; pagination filters (\`--limit\`, \`--cursor\`, \`--since\`, \`--until\`, \`--unread\`) are applied client-side after fetch. \`--archive-filter\` is applied server-side. Results are sorted newest-first by last activity. In \`--json\` / \`--ndjson\`, the response includes a \`nextCursor\` string (opaque) you can pass via \`--cursor\` to fetch the next page; NDJSON emits the cursor as a final \`{ "_meta": true, "nextCursor": "..." }\` line.
+
+For \`tdc channel members add/remove/set\`, refs accept user identifiers (\`id:N\`, email, name) or \`group:<ref>\`, which expands to the group's current members. Group expansion is one-shot — it is not a persistent link, so users added to the group later will not auto-join the channel. \`set\` replaces membership with the resolved set and is dry-run by default (pass \`--apply\` to mutate); it refuses to remove the acting user unless \`--include-self\` is passed.
+
+## Reactions
+
+\`\`\`bash
+tdc react thread <ref> 👍         # Add reaction to thread
+tdc react comment <ref> +1        # Add reaction (shortcode)
+tdc react message <ref> heart     # Add reaction to DM message
+tdc react thread <ref> 👍 --json  # Output result as JSON
+tdc unreact thread <ref> 👍       # Remove reaction
+tdc unreact thread <ref> 👍 --json # Output result as JSON
+\`\`\`
+
+Supported shortcodes: +1, -1, heart, tada, smile, laughing, thinking, fire, check, x, eyes, pray, clap, rocket, wave
+
+## Shell Completions
+
+\`\`\`bash
+tdc completion install            # Install tab completions (prompts for shell)
+tdc completion install bash       # Install for specific shell
+tdc completion install zsh
+tdc completion install fish
+tdc completion uninstall          # Remove completions
+\`\`\`
+
+### Diagnostics
+
+\`\`\`bash
+tdc doctor                        # Run local + network diagnostics
+tdc doctor --offline              # Skip Comms and npm network checks
+tdc doctor --json                 # JSON output with per-check results
+\`\`\`
+
+### Configuration
+
+\`\`\`bash
+tdc config view                   # Pretty-printed config, token masked, labels actual token source
+tdc config view --json            # Raw JSON, token masked
+tdc config view --show-token      # Include the full token
+tdc config set unarchive-new-threads true   # Persist: always unarchive new threads so they land in your Inbox
+tdc config set unarchive-new-threads false  # Persist: keep Comms's default (thread auto-archived for author)
+\`\`\`
+
+User preferences are stored under \`userSettings\` in the config file. Currently supported keys: \`unarchive-new-threads\`. The flag on \`tdc thread create\` (\`--unarchive\` / \`--no-unarchive\`) overrides this default per-invocation.
+
+### Update
+
+\`\`\`bash
+tdc update                        # Update CLI to latest version
+tdc update --check                # Check for updates without installing, show channel
+tdc update --check --json         # Same, JSON envelope
+tdc update --check --ndjson       # Same, newline-delimited JSON envelope
+tdc update --channel              # Show current update channel
+tdc update switch --stable        # Switch to stable release channel
+tdc update switch --pre-release   # Switch to pre-release (next) channel
+tdc update switch --pre-release --json    # Same, JSON envelope
+tdc update switch --pre-release --ndjson  # Same, newline-delimited JSON envelope
+\`\`\`
+
+### Changelog
+\`\`\`bash
+tdc changelog                     # Show last 5 versions
+tdc changelog -n 3                # Show last 3 versions
+tdc changelog --count 10          # Show last 10 versions
+\`\`\`
+
+## Global Options
+
+\`\`\`bash
+--no-spinner               # Disable loading animations
+--progress-jsonl           # Machine-readable progress events (JSONL to stderr)
+--progress-jsonl=<path>    # Same, but write events to <path> instead of stderr
+--progress-jsonl <path>    # Same as above (space-separated form also accepted)
+--accessible               # Add text labels to color-coded output (also: TDC_ACCESSIBLE=1)
+--non-interactive          # Disable interactive prompts (auto-detected when stdin is not a TTY)
+--interactive              # Force interactive mode even when stdin is not a TTY
+\`\`\`
+
+## 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)
+\`\`\`
+
+## Dry Run
+
+Mutating commands accept \`--dry-run\` to preview the operation without making the change. Where a command performs pre-flight validation (e.g. fetching the target thread to check channel access or ownership), those checks still run in dry-run — only the mutating write is skipped. Commands that have no pre-flight validation parse the reference and print the preview without hitting the API. The preview is structured:
+
+\`\`\`
+[dry-run] Would <action>:
+  <Key>: <resolved value>
+  ...
+Run without --dry-run to execute.
+\`\`\`
+
+## Reference System
+
+Commands accept flexible references:
+- **Numeric IDs**: \`123\` or \`id:123\`
+- **Comms URLs**: Full \`https://comms.todoist.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 | tdc thread reply <ref>
+tdc thread create <channel-ref> "Title" < body.md
+echo "Quick reply" | tdc conversation reply <ref>
+\`\`\`
+
+If no content argument is provided and no stdin is piped, the CLI opens \`$EDITOR\` for interactive input. In non-TTY environments (e.g. when called by an agent or in a pipeline), the editor is automatically skipped and the command fails fast with an actionable error message. Use \`--non-interactive\` to force this behavior even in a TTY, or \`--interactive\` to override auto-detection.
+
+## Common Workflows
+
+**View by URL (auto-routes to the right command):**
+\`\`\`bash
+tdc view https://comms.todoist.com/a/1585/ch/100/t/200          # View thread
+tdc view https://comms.todoist.com/a/1585/ch/100/t/200/c/300     # View comment
+tdc view https://comms.todoist.com/a/1585/msg/400                 # View conversation
+tdc view https://comms.todoist.com/a/1585/msg/400/m/500 --json    # View message as JSON
+\`\`\`
+
+**Check inbox and respond:**
+\`\`\`bash
+tdc inbox --unread --json
+tdc thread view <id> --unread
+tdc thread reply <id> "Thanks, I'll look into this."
+tdc thread done <id>
+\`\`\`
+
+**Search and review:**
+\`\`\`bash
+tdc mentions --since 2026-04-01 --all --json
+tdc search "deployment" --type threads --json
+tdc thread view <thread-id>
+\`\`\`
+
+**Check DMs:**
+\`\`\`bash
+tdc conversation unread --json
+tdc conversation view <conversation-id>
+tdc conversation with "Alice Example"
+tdc conversation reply <id> "Got it, thanks!"
+\`\`\`
+`;
+export const SKILL_FILE_CONTENT = `---
+name: ${SKILL_NAME}
+description: ${JSON.stringify(SKILL_DESCRIPTION)}
+license: ${SKILL_LICENSE}
+metadata:
+  author: ${SKILL_AUTHOR}
+  version: ${JSON.stringify(SKILL_VERSION)}
+---
+
+${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,OAAO,WAAW,MAAM,uBAAuB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AAErE,MAAM,CAAC,MAAM,UAAU,GAAG,WAAW,CAAA;AAErC,MAAM,CAAC,MAAM,iBAAiB,GAC1B,wTAAwT,CAAA;AAE5T,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAA;AAEnC,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAA;AAElC,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,CAAA;AAEhD,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiZ5B,CAAA;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG;QAC1B,UAAU;eACH,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC;WACrC,aAAa;;YAEZ,YAAY;aACX,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC;;;EAGxC,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":"AAKA,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,CA2EvE"}

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

@@ -0,0 +1,65 @@
+import { mkdir, rm, stat, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { CliError } from '../errors.js';
+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 CliError('NOT_INSTALLED', `${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 CliError('ALREADY_INSTALLED', `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 CliError('NOT_INSTALLED', `Skill not installed at ${skillPath}`, [
+                    `Run: tdc skill install ${config.name}`,
+                ]);
+            }
+            await writeFile(skillPath, SKILL_FILE_CONTENT);
+        },
+        async uninstall(options) {
+            const skillPath = getInstallPath(options);
+            const exists = await this.isInstalled(options);
+            if (!exists) {
+                throw new CliError('NOT_INSTALLED', `Skill not installed at ${skillPath}`, [
+                    `Run: tdc skill install ${config.name}`,
+                ]);
+            }
+            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 Comms CLI',
+        dirName: '.claude',
+    }),
+    codex: createInstaller({
+        name: 'codex',
+        description: 'Codex skill for Comms CLI',
+        dirName: '.codex',
+    }),
+    cursor: createInstaller({
+        name: 'cursor',
+        description: 'Cursor skill for Comms CLI',
+        dirName: '.cursor',
+    }),
+    gemini: createInstaller({
+        name: 'gemini',
+        description: 'Gemini CLI skill for Comms CLI',
+        dirName: '.gemini',
+    }),
+    pi: createInstaller({
+        name: 'pi',
+        description: 'Pi skill for Comms CLI',
+        dirName: '.pi',
+    }),
+    universal: createInstaller({
+        name: 'universal',
+        description: 'Universal agent skill for Comms 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"}