@doist/comms-cli 1.8.0 → 1.9.1

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [1.9.1](https://github.com/Doist/comms-cli/compare/v1.9.0...v1.9.1) (2026-07-02)
+
+### Bug Fixes
+
+- **deps:** release comms-sdk 0.7.1 for Node 26 terminated fix ([587b17b](https://github.com/Doist/comms-cli/commit/587b17b3a2df4e2060c6452f5a9d2d6dbda12a5b)), closes [#39](https://github.com/Doist/comms-cli/issues/39)
+
+## [1.9.0](https://github.com/Doist/comms-cli/compare/v1.8.0...v1.9.0) (2026-06-26)
+
+### Features
+
+- add migrate urls command ([#38](https://github.com/Doist/comms-cli/issues/38)) ([99697c0](https://github.com/Doist/comms-cli/commit/99697c007eb686d1370af4636c03a0325b26aba1))
+
 ## [1.8.0](https://github.com/Doist/comms-cli/compare/v1.7.0...v1.8.0) (2026-06-18)
 
 ### Features

package/dist/commands/migrate/index.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerMigrateCommand(program: Command): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/migrate/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/migrate/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGxC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsB7D"}

package/dist/commands/migrate/index.js

@@ -0,0 +1,21 @@
+import { migrateUrls } from './urls.js';
+export function registerMigrateCommand(program) {
+    const migrate = program.command('migrate').description('Twist→Comms migration helpers');
+    migrate
+        .command('urls [urls]')
+        .description('Translate twist.com URLs to their Comms equivalents')
+        .option('--twist-token <token>', 'Twist auth token (overrides $TWIST_AUTH_TOKEN)')
+        .option('--json', 'Output as JSON')
+        .option('--ndjson', 'Output as newline-delimited JSON')
+        .addHelpText('after', `
+The migration endpoint needs a Twist (not Comms) token. Prefer the TWIST_AUTH_TOKEN
+environment variable — a CLI flag exposes the token in process listings. If the
+Twist CLI (tw) is installed, you can populate it inline:
+
+Examples:
+  TWIST_AUTH_TOKEN="$(tw auth token view)" tdc migrate urls "https://twist.com/a/1/ch/2/t/3,https://twist.com/a/1/ch/2/t/4"
+  cat old-urls.txt | TWIST_AUTH_TOKEN="$(tw auth token view)" tdc migrate urls
+  tdc migrate urls "https://twist.com/a/1/ch/2/t/3" --json   # token from $TWIST_AUTH_TOKEN`)
+        .action(migrateUrls);
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/migrate/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/migrate/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAEvC,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACnD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,+BAA+B,CAAC,CAAA;IAEvF,OAAO;SACF,OAAO,CAAC,aAAa,CAAC;SACtB,WAAW,CAAC,qDAAqD,CAAC;SAClE,MAAM,CAAC,uBAAuB,EAAE,gDAAgD,CAAC;SACjF,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,UAAU,EAAE,kCAAkC,CAAC;SACtD,WAAW,CACR,OAAO,EACP;;;;;;;;4FAQgF,CACnF;SACA,MAAM,CAAC,WAAW,CAAC,CAAA;AAC5B,CAAC"}

package/dist/commands/migrate/urls.d.ts

@@ -0,0 +1,8 @@
+type MigrateUrlsOptions = {
+    twistToken?: string;
+    json?: boolean;
+    ndjson?: boolean;
+};
+export declare function migrateUrls(urlsArg: string | undefined, options: MigrateUrlsOptions): Promise<void>;
+export {};
+//# sourceMappingURL=urls.d.ts.map

package/dist/commands/migrate/urls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urls.d.ts","sourceRoot":"","sources":["../../../src/commands/migrate/urls.ts"],"names":[],"mappings":"AAMA,KAAK,kBAAkB,GAAG;IACtB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAqCD,wBAAsB,WAAW,CAC7B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,kBAAkB,GAC5B,OAAO,CAAC,IAAI,CAAC,CA0Df"}

package/dist/commands/migrate/urls.js

@@ -0,0 +1,86 @@
+import { fetchNewCommsUrls } from '@doist/comms-sdk';
+import { CliError } from '../../lib/errors.js';
+import { readStdin } from '../../lib/input.js';
+import { colors, formatJson, formatNdjson } from '../../lib/output.js';
+import { withSpinner } from '../../lib/spinner.js';
+/**
+ * Pulls the machine-readable error code out of a {@link CommsRequestError}.
+ *
+ * Not-migratable URLs come back as `{ error: { code: 'invalid_url' } }` (400) or
+ * `{ error: { code: 'not_imported' } }` (404) in `responseData`. Falls back to a
+ * stable `API_ERROR` code (the human-readable text stays in `message`) so callers
+ * never have to branch on free-form prose.
+ */
+function extractErrorCode(error) {
+    const data = error.responseData;
+    if (data && typeof data === 'object' && 'error' in data) {
+        const inner = data.error;
+        if (inner && typeof inner === 'object' && 'code' in inner) {
+            const code = inner.code;
+            if (typeof code === 'string')
+                return code;
+        }
+    }
+    return 'API_ERROR';
+}
+/** Splits a comma- or whitespace-separated blob into trimmed, non-empty URLs. */
+function parseUrls(input) {
+    return input
+        .split(/[\s,]+/)
+        .map((url) => url.trim())
+        .filter(Boolean);
+}
+export async function migrateUrls(urlsArg, options) {
+    // Flag wins over the environment variable, but the env var is the recommended
+    // primary method (a CLI flag exposes the token in process listings).
+    const twistToken = options.twistToken ?? process.env.TWIST_AUTH_TOKEN;
+    if (!twistToken) {
+        throw new CliError('NO_TOKEN', 'No Twist token provided.', [
+            'Set TWIST_AUTH_TOKEN (e.g. TWIST_AUTH_TOKEN="$(tw auth token view)" — requires the Twist CLI), or',
+            'pass --twist-token <token>.',
+        ]);
+    }
+    // readStdin() waits briefly for the first byte then reads to end, so an open
+    // but empty stdin (CI, spawned children) raises MISSING_CONTENT instead of hanging.
+    const rawInput = urlsArg ?? (await readStdin());
+    const oldUrls = rawInput ? parseUrls(rawInput) : [];
+    if (oldUrls.length === 0) {
+        throw new CliError('MISSING_CONTENT', 'No URLs provided.', [
+            'Pass a comma-separated list as an argument, or pipe URLs via stdin.',
+        ]);
+    }
+    // The migration endpoint lives on Twist; honour TWIST_BASE_URL for staging/tests,
+    // mirroring the COMMS_BASE_URL convention used for the Comms API.
+    const baseUrl = process.env.TWIST_BASE_URL;
+    const results = await withSpinner({ text: 'Migrating URLs...' }, () => fetchNewCommsUrls({ oldUrls, twistToken }, baseUrl ? { baseUrl } : undefined));
+    if (options.json || options.ndjson) {
+        const output = results.map((result) => result.error
+            ? {
+                oldUrl: result.oldUrl,
+                error: {
+                    code: extractErrorCode(result.error),
+                    message: result.error.message,
+                },
+            }
+            : { oldUrl: result.oldUrl, newUrl: result.newUrl });
+        console.log(options.json ? formatJson(output) : formatNdjson(output));
+    }
+    else {
+        // Iterate results directly for text output — no need to materialise the
+        // simplified shape just to print and tally.
+        for (const result of results) {
+            if (result.error) {
+                const label = colors.error(`✗ ${extractErrorCode(result.error)}`);
+                console.log(`${result.oldUrl}  ${label}`);
+            }
+            else {
+                console.log(`${result.oldUrl} -> ${result.newUrl}`);
+            }
+        }
+    }
+    // Surface partial failure to scripts/CI: exit non-zero if any URL failed.
+    if (results.some((result) => result.error)) {
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=urls.js.map

package/dist/commands/migrate/urls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"urls.js","sourceRoot":"","sources":["../../../src/commands/migrate/urls.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAC5E,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAC9C,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAelD;;;;;;;GAOG;AACH,SAAS,gBAAgB,CAAC,KAAwB;IAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,CAAA;IAC/B,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QACtD,MAAM,KAAK,GAAI,IAA4B,CAAC,KAAK,CAAA;QACjD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;YACxD,MAAM,IAAI,GAAI,KAA4B,CAAC,IAAI,CAAA;YAC/C,IAAI,OAAO,IAAI,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAA;QAC7C,CAAC;IACL,CAAC;IACD,OAAO,WAAW,CAAA;AACtB,CAAC;AAED,iFAAiF;AACjF,SAAS,SAAS,CAAC,KAAa;IAC5B,OAAO,KAAK;SACP,KAAK,CAAC,QAAQ,CAAC;SACf,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;SACxB,MAAM,CAAC,OAAO,CAAC,CAAA;AACxB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC7B,OAA2B,EAC3B,OAA2B;IAE3B,8EAA8E;IAC9E,qEAAqE;IACrE,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAA;IACrE,IAAI,CAAC,UAAU,EAAE,CAAC;QACd,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,0BAA0B,EAAE;YACvD,mGAAmG;YACnG,6BAA6B;SAChC,CAAC,CAAA;IACN,CAAC;IAED,6EAA6E;IAC7E,oFAAoF;IACpF,MAAM,QAAQ,GAAG,OAAO,IAAI,CAAC,MAAM,SAAS,EAAE,CAAC,CAAA;IAC/C,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IACnD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,QAAQ,CAAC,iBAAiB,EAAE,mBAAmB,EAAE;YACvD,qEAAqE;SACxE,CAAC,CAAA;IACN,CAAC;IAED,kFAAkF;IAClF,kEAAkE;IAClE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAA;IAC1C,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,EAAE,GAAG,EAAE,CAClE,iBAAiB,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAChF,CAAA;IAED,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACjC,MAAM,MAAM,GAAwB,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CACvD,MAAM,CAAC,KAAK;YACR,CAAC,CAAC;gBACI,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,KAAK,EAAE;oBACH,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC;oBACpC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO;iBAChC;aACJ;YACH,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CACzD,CAAA;QACD,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAA;IACzE,CAAC;SAAM,CAAC;QACJ,wEAAwE;QACxE,4CAA4C;QAC5C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC3B,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBACf,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;gBACjE,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC,CAAA;YAC7C,CAAC;iBAAM,CAAC;gBACJ,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,OAAO,MAAM,CAAC,MAAM,EAAE,CAAC,CAAA;YACvD,CAAC;QACL,CAAC;IACL,CAAC;IAED,0EAA0E;IAC1E,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACzC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;IACxB,CAAC;AACL,CAAC"}

package/dist/index.js

@@ -28,6 +28,7 @@ const loadGroupsCommand = async () => (await import('./commands/groups/index.js'
 const loadDoctorCommand = async () => (await import('./commands/doctor.js')).registerDoctorCommand;
 const loadConfigCommand = async () => (await import('./commands/config/index.js')).registerConfigCommand;
 const loadAccountCommand = async () => (await import('./commands/account/index.js')).registerAccountCommand;
+const loadMigrateCommand = async () => (await import('./commands/migrate/index.js')).registerMigrateCommand;
 const commands = {
     workspaces: ['List all workspaces', loadWorkspaceCommand],
     workspace: ['Manage workspace', loadWorkspaceCommand],
@@ -56,6 +57,7 @@ const commands = {
         loadGroupsCommand,
     ],
     config: ['Manage CLI configuration', loadConfigCommand],
+    migrate: ['Twist→Comms migration helpers (urls)', loadMigrateCommand],
 };
 const commandAliases = {
     channels: 'channel',
@@ -150,6 +152,7 @@ else {
             'account',
             'config',
             'skill',
+            'migrate',
         ]);
         const wantsRaw = process.argv.slice(2).includes('--raw');
         const needsMarkdown = !noMarkdownCommands.has(commandName) && !isJsonMode() && !isNdjsonMode() && !wantsRaw;

package/dist/index.js.map

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

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

@@ -3,6 +3,6 @@ export declare const SKILL_DESCRIPTION = "Comms messaging CLI. View and respond
 export declare const SKILL_AUTHOR = "Doist";
 export declare const SKILL_LICENSE = "MIT";
 export declare const SKILL_VERSION: string;
-export declare const SKILL_CONTENT = "# Comms CLI (tdc)\n\nAccess 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.\n\n## Setup\n\n```bash\ntdc auth login                    # OAuth login (standard write scopes)\ntdc auth login --read-only        # OAuth login with read-only scope\ntdc auth login --full-access      # OAuth login with delete/admin scopes\ntdc auth login --callback-port <n># Override the local OAuth callback port (default 8766)\ntdc auth login --json             # Emit a JSON envelope for scripted / agent use\ntdc auth login --ndjson           # Emit an NDJSON envelope for scripted / agent use\ntdc auth token                    # Save API token manually (prompts securely; scope unknown, assumed write-capable)\ntdc auth status                   # Verify authentication + show mode\ntdc auth status --json            # Full status payload as JSON (--ndjson also supported)\ntdc auth status --user <ref>      # Target a specific stored account (id, id:<n>, or display name)\ntdc --user <ref> auth <status|logout|token view|refresh-token view>  # Equivalent to passing --user after the subcommand; other commands accept the flag but ignore it\ntdc auth logout                   # Remove saved token and auth metadata\ntdc auth logout --json            # Emits `{\"ok\": true}` (--ndjson is silent)\ntdc auth logout --user <ref>      # Target a specific stored account; mismatched ref errors with ACCOUNT_NOT_FOUND\ntdc auth token view               # Print the saved token to stdout (pipe-safe; refuses if COMMS_API_TOKEN is set)\ntdc auth token view --user <ref>  # Print the saved token for a specific stored account\ntdc auth refresh-token view       # Print the saved OAuth refresh token to stdout (pipe-safe; OAuth logins only)\ntdc auth refresh-token view --user <ref>  # Print the saved OAuth refresh token for a specific stored account\ntdc account [list|current|use <ref>|remove <ref>]  # Manage stored accounts; all support --json/--ndjson\n                                 # current's payload is {id, label, authMode, authScope, source:\"config\"} | {source:\"env\"} | {source:\"token-only\"}\ntdc auth login                    # Re-running auth login with a different OAuth grant adds a NEW account; default stays pinned unless none was set\ntdc workspaces                    # List available workspaces\ntdc workspace use <ref>           # Set current workspace\ntdc completion install            # Install shell completions\ntdc config view                   # Show the current CLI configuration file (token masked)\ntdc config set <key> <value>      # Set a user preference (e.g. unarchive-new-threads true)\ntdc doctor                        # Diagnose CLI setup and environment issues\ntdc update                        # Update CLI to latest version\ntdc changelog                     # Show recent changelog entries\n```\n\nOAuth login uses Todoist OAuth for Comms access. The default grant can read Comms data and create/update content or messages. It does not include delete, channel management, or user/workspace write scopes; use `tdc auth login --full-access` only when needed. 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.\n\nIn 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.\n\n## View by URL\n\n```bash\ntdc view <url>                    # View any Comms entity by URL\n```\n\nRoutes automatically based on URL structure:\n- Message URL \u2192 `tdc msg view`\n- Conversation URL \u2192 `tdc conversation view`\n- Thread+comment URL \u2192 `tdc thread view` (comment ID extracted from URL)\n- Thread URL \u2192 `tdc thread view`\n\nURLs may use either `https://comms.todoist.com/{workspaceId}/...` or `https://comms.todoist.com/a/{workspaceId}/...`.\n\nAll target command flags pass through (e.g. `--json`, `--raw`, `--full`).\n\n## Inbox\n\n```bash\ntdc inbox                         # Show inbox threads\ntdc inbox --unread                # Only unread threads\ntdc inbox --archive-filter all      # Show active + done threads\ntdc inbox --archive-filter archived # Show only done threads\ntdc inbox --channel <filter>      # Filter by channel name (fuzzy)\ntdc inbox --since <date>          # Filter by date (ISO format)\ntdc inbox --limit <n>             # Max items (default: 50)\n```\n\n## Threads\n\n```bash\ntdc thread <thread-ref>           # View thread (shorthand for view)\ntdc thread view <thread-ref>      # View thread with comments\ntdc thread view <ref> --comment <id> # View a specific comment\ntdc thread view <url-with-/c/id>  # Comment ID extracted from URL\ntdc thread view <ref> --unread    # Show only unread comments\ntdc thread view <ref> --context 3 # Include 3 read comments before unread\ntdc thread view <ref> --limit 20  # Limit number of comments\ntdc thread view <ref> --since <date> # Comments newer than date\ntdc thread view <ref> --raw       # Show raw markdown\ntdc thread create <channel-ref> \"Title\" \"content\"    # Create a new thread\ntdc thread create <channel-ref> \"Title\" \"content\" --json       # Create and return as JSON\ntdc thread create <channel-ref> \"Title\" \"content\" --json --full # Include all thread fields\ntdc thread create <channel-ref> \"Title\" \"content\" --notify 123,456  # Notify specific users and/or groups by ID\ntdc thread create <channel-ref> \"Title\" \"content\" --unarchive  # Land thread in author's Inbox (overrides default Comms auto-archive)\ntdc thread create <channel-ref> \"Title\" \"content\" --no-unarchive  # Force archive even when userSettings.unarchiveNewThreads=true\ntdc thread create <channel-ref> \"Title\" \"content\" --dry-run  # Preview without posting\ntdc thread create <channel-ref> \"Title\" --file ./a.png  # Attach a file (repeatable; content optional)\ntdc thread reply <ref> \"content\"  # Post a comment (notifies EVERYONE_IN_THREAD by default)\ntdc thread reply <ref> \"content\" --notify EVERYONE  # Notify all workspace members\ntdc thread reply <ref> \"content\" --notify 123,id:456   # Notify specific users by ID\ntdc thread reply <ref> \"content\" --notify 123,Cbzzm11ZeYZoJYD4a6rti   # Notify a user and a group (group IDs are base58, not numeric)\ntdc thread reply <ref> \"content\" --json  # Post and return comment as JSON\ntdc thread reply <ref> \"content\" --json --full  # Include all comment fields\ntdc thread reply <ref> \"content\" --close       # Reply and close the thread\ntdc thread reply <ref> \"content\" --reopen      # Reply and reopen a closed thread\ntdc thread reply <ref> \"content\" --file ./a.png  # Attach a file (repeatable; content optional)\ntdc thread done <ref>                 # Preview thread archive (requires --yes to execute)\ntdc thread done <ref> --yes           # Archive thread (mark done)\ntdc thread done <ref> --yes --json    # Archive and return status as JSON\ntdc thread mark-read <ref>        # Mark a thread read\ntdc thread mark-read <ref> <ref> --yes # Mark multiple threads read\nprintf \"123\\n456\\n\" | tdc thread mark-read --dry-run # Preview bulk mark-read from stdin\ntdc thread mute <ref>             # Mute thread for 60 minutes (default)\ntdc thread mute <ref> --minutes 480  # Mute for custom duration\ntdc thread mute <ref> --json      # Mute and return { id, mutedUntil } as JSON\ntdc thread mute <ref> --json --full  # Mute and return full thread as JSON\ntdc thread unmute <ref>           # Unmute a muted thread\ntdc thread unmute <ref> --json    # Unmute and return { id, mutedUntil } as JSON\ntdc thread delete <ref>             # Preview thread deletion (requires --yes to execute)\ntdc thread delete <ref> --yes       # Permanently delete a thread\ntdc thread delete <ref> --yes --json # Delete and return status as JSON\ntdc thread rename <ref> \"New title\"  # Rename a thread (change its title)\ntdc thread rename <ref> \"New title\" --json  # Rename and return { id, title } as JSON\ntdc thread rename <ref> \"New title\" --json --full  # Rename and return full thread as JSON\ntdc thread update <ref> \"New body\"   # Update a thread's body (the first post)\necho \"New body\" | tdc thread update <ref>  # Update body from stdin\ntdc thread update <ref> \"New body\" --dry-run  # Preview without updating\ntdc thread update <ref> \"New body\" --json  # Update and return { id, content } as JSON\ntdc thread update <ref> \"New body\" --json --full  # Update and return full thread as JSON\n```\n\nDefault `--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 <ids>`). Options: EVERYONE, EVERYONE_IN_THREAD, or comma-separated user and/or group IDs.\n\n`--notify` automatically resolves IDs: group IDs are routed to the `groups` API field, user IDs to `recipients`. No special syntax needed.\n\n## Thread Comments\n\n```bash\ntdc comment <comment-ref>                       # View a comment (shorthand for view)\ntdc comment view <comment-ref>                  # View a single thread comment\ntdc comment view <comment-ref> --raw            # Show raw markdown\ntdc comment view <comment-ref> --json           # Output as JSON\ntdc comment view <comment-ref> --ndjson         # Output as newline-delimited JSON\ntdc comment view <comment-ref> --json --full    # Include all fields in JSON output\ntdc comment update <comment-ref> \"new content\"  # Update a thread comment\ntdc comment update <comment-ref> \"content\" --json  # Update and return updated comment as JSON\ntdc comment update <comment-ref> \"content\" --json --full  # Include all comment fields\ntdc comment delete <comment-ref>                     # Preview comment deletion (requires --yes to execute)\ntdc comment delete <comment-ref> --yes               # Delete a thread comment\ntdc comment delete <comment-ref> --yes --json        # Delete and return status as JSON\n```\n\n## Conversations (DMs/Groups)\n\n```bash\ntdc conversation unread                    # List unread conversations\ntdc conversation list                      # List active conversations (DMs and groups)\ntdc conversation list --kind group         # Only group conversations (3+ people)\ntdc conversation list --kind direct        # Only 1:1 conversations (and your self-DM)\ntdc conversation list --participant \"Jane\" # Only conversations including these users (comma-separated)\ntdc conversation list --name \"release\"     # Filter by title substring (case-insensitive)\ntdc conversation list --state archived     # Archived conversations only (active|all|archived; default active)\ntdc conversation list --snippet            # Include the latest message snippet\ntdc conversation list --limit 20 --json    # Cap rows and output as JSON\ntdc conversation <conversation-ref>        # View conversation (shorthand for view)\ntdc conversation view <conversation-ref>   # View conversation messages\ntdc conversation with <user-ref>           # Find your 1:1 DM with a user\ntdc conversation with <user-ref> --snippet # Include the latest message preview\ntdc conversation with <user-ref> --include-groups # List any conversations with that user\ntdc conversation reply <ref> \"content\"     # Send a message\ntdc conversation reply <ref> \"content\" --json  # Send and return message as JSON\ntdc conversation reply <ref> \"content\" --json --full  # Include all message fields\ntdc conversation reply <ref> \"content\" --file ./a.png  # Attach a file (repeatable; content optional)\ntdc conversation done <ref>                    # Preview conversation archive (requires --yes to execute)\ntdc conversation done <ref> --yes              # Archive conversation\ntdc conversation done <ref> --yes --json       # Archive and return status as JSON\ntdc conversation mute <ref>               # Mute conversation for 60 minutes (default)\ntdc conversation mute <ref> --minutes 480 # Mute for custom duration\ntdc conversation mute <ref> --json        # Mute and return { id, mutedUntil } as JSON\ntdc conversation mute <ref> --json --full # Mute and return full conversation as JSON\ntdc conversation unmute <ref>             # Unmute a muted conversation\ntdc conversation unmute <ref> --json      # Unmute and return { id, mutedUntil } as JSON\n```\n\nAlias: `tdc convo` works the same as `tdc conversation`.\n\n## Conversation Messages\n\n```bash\ntdc msg <message-ref>             # View a message (shorthand for view)\ntdc msg view <message-ref>        # View a single conversation message\ntdc msg update <ref> \"content\"    # Edit a conversation message\ntdc msg update <ref> \"content\" --json  # Edit and return updated message as JSON\ntdc msg update <ref> \"content\" --json --full  # Include all message fields\ntdc msg delete <ref>                  # Preview message deletion (requires --yes to execute)\ntdc msg delete <ref> --yes            # Delete a conversation message\ntdc msg delete <ref> --yes --json     # Delete and return status as JSON\n```\n\nAlias: `tdc message` works the same as `tdc msg`.\n\n## Search\n\n```bash\ntdc mentions                      # Show content mentioning current user\ntdc mentions --since 2026-04-01 --all # Fetch every mention since a date\ntdc mentions --type threads --json # Limit mentions to threads\ntdc search \"query\"                # Search content\ntdc search \"query\" --type threads # Filter: threads, messages, or all\ntdc search \"query\" --author <ref> # Filter by author\ntdc search \"query\" --to <ref>     # Messages sent to user\ntdc search \"query\" --title-only   # Search thread titles only\ntdc search \"query\" --mention-me   # Results mentioning current user\ntdc search \"query\" --conversation <refs> # Limit to conversations (comma-separated refs)\ntdc search \"query\" --since <date> # Content from date\ntdc search \"query\" --until <date> # Content until date\ntdc search \"query\" --channel <refs> # Filter by channel refs (comma-separated)\ntdc search \"query\" --limit <n>    # Max results (default: 50)\ntdc search \"query\" --cursor <cur> # Pagination cursor\ntdc search \"query\" --all          # Fetch all result pages\n```\n\n## Users, Channels & Groups\n\n```bash\ntdc user                          # Show current user info\ntdc user --json                   # JSON output\ntdc user --json --full            # Include all fields in JSON output\ntdc users                         # List active workspace users\ntdc users --search <text>         # Filter by name/email\ntdc users --include-removed       # Include users removed from the workspace\ntdc channels                      # List active joined workspace channels (alias of: tdc channel list)\ntdc channels --state all          # Include archived joined channels too\ntdc channels --scope discoverable # Active public channels you can see but have not joined\ntdc channels --scope public --state all --json # All visible public channels, with joined status\ntdc channel create \"Engineering\"  # Create a channel in the current workspace\ntdc channel create \"Leadership Team\" --private --users id:10,id:20 # Create private channel with initial members\ntdc channel create \"Product\" --workspace \"Doist\" --description \"Product discussions\" --json # Create and return channel as JSON\ntdc channel update <channel-ref> \"New name\" # Rename a channel\ntdc channel update <ref> --name \"New name\" # Rename with an explicit flag\ntdc channel update <ref> --description \"Team discussions\" # Update channel description\ntdc channel update <ref> --clear-description # Clear channel description\ntdc channel update <ref> --public # Make a channel public (--private makes it private)\ntdc channel update <ref> --description \"Team discussions\" --json --full # Update and return all channel fields\ntdc channel delete <channel-ref> --yes # Permanently delete a channel (requires --yes; usually admin-only)\ntdc channel delete <ref> --dry-run # Preview deletion\ntdc channel archive <channel-ref> # Archive a channel (no-op if already archived)\ntdc channel unarchive id:<id> # Unarchive a channel (pass id:/numeric ref for archived channels)\ntdc channel threads <channel-ref>  # List threads in a channel (fuzzy name, id:, numeric ID, or URL)\ntdc channel threads \"general\" --unread       # Only unread threads\ntdc channel threads <ref> --archive-filter all  # Include archived threads (active|archived|all)\ntdc channel threads <ref> --since 2026-01-01 # Filter by last-updated date (ISO)\ntdc channel threads <ref> --limit 20         # Max threads per page (default: 50)\ntdc channel threads <ref> --limit 20 --cursor <cursor-from-prev> # Paginate\ntdc channel threads <ref> --json  # { results, nextCursor } with isUnread + url\ntdc channel members <channel-ref> # List a channel's members + groups fully in the channel\ntdc channel members <ref> --json  # JSON with id, name, workspaceId, members\ntdc channel members add <ref> alice group:Design # Add users and/or expand group:<ref> members\ntdc channel members add <ref> a@d.com id:789 --json # Add refs, output result as JSON\ntdc channel members remove <ref> alice group:Frontend # Remove users and/or group members\ntdc channel members set <ref> group:Squad --apply # Replace membership with the resolved set\ntdc channel members set <ref> alice bob # Dry-run by default; refuses to remove you (--include-self to override)\ntdc groups                        # List workspace groups\ntdc groups --search \"frontend\"    # Filter groups by name (case-insensitive)\ntdc groups --json                 # JSON output\ntdc groups --json --full          # Include all fields in JSON output\ntdc groups view <group-ref>       # Show group with member details\ntdc groups view <ref> --json      # JSON output with id, name, workspaceId, members\ntdc groups view <ref> --json --full  # Include all fields in JSON output\ntdc groups create \"Name\"          # Create a new group\ntdc groups create \"Name\" --users alice@doist.com,bob@doist.com  # Create with members\ntdc groups create \"Name\" --json   # Output created group as JSON\ntdc groups rename <group-ref> \"New name\"  # Rename a group\ntdc groups rename <ref> \"Name\" --json     # Output renamed group as JSON\ntdc groups delete <group-ref> --yes       # Delete a group (requires --yes)\ntdc groups delete <ref> --dry-run         # Preview deletion\ntdc groups add-user <group-ref> user1 user2   # Add users to a group\ntdc groups add-user <ref> a@d.com,b@d.com     # Comma-separated refs\ntdc groups add-user <ref> id:123 --json       # Output result as JSON\ntdc groups remove-user <group-ref> user1 user2  # Remove users from a group\ntdc groups remove-user <ref> id:123,id:456      # Comma-separated ID refs\n```\n\nIf 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.\n\n`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.\n\nFor `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 \u2014 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.\n\n## Reactions\n\n```bash\ntdc react thread <ref> \uD83D\uDC4D         # Add reaction to thread\ntdc react comment <ref> +1        # Add reaction (shortcode)\ntdc react message <ref> heart     # Add reaction to DM message\ntdc react thread <ref> \uD83D\uDC4D --json  # Output result as JSON\ntdc unreact thread <ref> \uD83D\uDC4D       # Remove reaction\ntdc unreact thread <ref> \uD83D\uDC4D --json # Output result as JSON\n```\n\nSupported shortcodes: +1, -1, heart, tada, smile, laughing, thinking, fire, check, x, eyes, pray, clap, rocket, wave\n\n## Shell Completions\n\n```bash\ntdc completion install            # Install tab completions (prompts for shell)\ntdc completion install bash       # Install for specific shell\ntdc completion install zsh\ntdc completion install fish\ntdc completion uninstall          # Remove completions\n```\n\n### Diagnostics\n\n```bash\ntdc doctor                        # Run local + network diagnostics\ntdc doctor --offline              # Skip Comms and npm network checks\ntdc doctor --json                 # JSON output with per-check results\n```\n\n### Configuration\n\n```bash\ntdc config view                   # Pretty-printed config, token masked, labels actual token source\ntdc config view --json            # Raw JSON, token masked\ntdc config view --show-token      # Include the full token\ntdc config set unarchive-new-threads true   # Persist: always unarchive new threads so they land in your Inbox\ntdc config set unarchive-new-threads false  # Persist: keep Comms's default (thread auto-archived for author)\n```\n\nUser 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.\n\n### Update\n\n```bash\ntdc update                        # Update CLI to latest version\ntdc update --check                # Check for updates without installing, show channel\ntdc update --check --json         # Same, JSON envelope\ntdc update --check --ndjson       # Same, newline-delimited JSON envelope\ntdc update --channel              # Show current update channel\ntdc update switch --stable        # Switch to stable release channel\ntdc update switch --pre-release   # Switch to pre-release (next) channel\ntdc update switch --pre-release --json    # Same, JSON envelope\ntdc update switch --pre-release --ndjson  # Same, newline-delimited JSON envelope\n```\n\n### Changelog\n```bash\ntdc changelog                     # Show last 5 versions\ntdc changelog -n 3                # Show last 3 versions\ntdc changelog --count 10          # Show last 10 versions\n```\n\n## Global Options\n\n```bash\n--no-spinner               # Disable loading animations\n--progress-jsonl           # Machine-readable progress events (JSONL to stderr)\n--progress-jsonl=<path>    # Same, but write events to <path> instead of stderr\n--progress-jsonl <path>    # Same as above (space-separated form also accepted)\n--accessible               # Add text labels to color-coded output (also: TDC_ACCESSIBLE=1)\n--non-interactive          # Disable interactive prompts (auto-detected when stdin is not a TTY)\n--interactive              # Force interactive mode even when stdin is not a TTY\n```\n\n## Output Formats\n\nAll list/view commands support:\n\n```bash\n--json    # Output as JSON\n--ndjson  # Output as newline-delimited JSON (for streaming)\n--full    # Include all fields (default shows essential fields only)\n```\n\n## Dry Run\n\nMutating 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 \u2014 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:\n\n```\n[dry-run] Would <action>:\n  <Key>: <resolved value>\n  ...\nRun without --dry-run to execute.\n```\n\n## Reference System\n\nCommands accept flexible references:\n- **Numeric IDs**: `123` or `id:123`\n- **Comms URLs**: Full `https://comms.todoist.com/...` URLs (parsed automatically)\n- **Fuzzy names**: For workspaces/users - `\"My Workspace\"` or partial matches\n\n## Piping Input\n\nCommands that accept content (`thread create`, `thread reply`, `comment update`, `conversation reply`, `msg update`) auto-detect piped stdin:\n\n```bash\ncat notes.md | tdc thread reply <ref>\ntdc thread create <channel-ref> \"Title\" < body.md\necho \"Quick reply\" | tdc conversation reply <ref>\n```\n\nIf 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.\n\n`tdc thread mark-read` also accepts thread refs from stdin, one per line:\n\n```bash\nprintf \"123\\n456\\n\" | tdc thread mark-read --yes\n```\n\n## Common Workflows\n\n**View by URL (auto-routes to the right command):**\n```bash\ntdc view https://comms.todoist.com/1585/ch/100/t/200            # View thread\ntdc view https://comms.todoist.com/a/1585/ch/100/t/200          # View thread\ntdc view https://comms.todoist.com/a/1585/ch/100/t/200/c/300     # View comment\ntdc view https://comms.todoist.com/a/1585/msg/400                 # View conversation\ntdc view https://comms.todoist.com/a/1585/msg/400/m/500 --json    # View message as JSON\n```\n\n**Check inbox and respond:**\n```bash\ntdc inbox --unread --json\ntdc thread view <id> --unread\ntdc thread reply <id> \"Thanks, I'll look into this.\"\ntdc thread done <id> --yes\n```\n\n**Search and review:**\n```bash\ntdc mentions --since 2026-04-01 --all --json\ntdc search \"deployment\" --type threads --json\ntdc thread view <thread-id>\n```\n\n**Check DMs:**\n```bash\ntdc conversation unread --json\ntdc conversation list --kind group --json     # find a group DM by participants/name\ntdc conversation view <conversation-id>\ntdc conversation with \"Alice Example\"\ntdc conversation reply <id> \"Got it, thanks!\"\n```\n";
+export declare const SKILL_CONTENT = "# Comms CLI (tdc)\n\nAccess 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.\n\n## Setup\n\n```bash\ntdc auth login                    # OAuth login (standard write scopes)\ntdc auth login --read-only        # OAuth login with read-only scope\ntdc auth login --full-access      # OAuth login with delete/admin scopes\ntdc auth login --callback-port <n># Override the local OAuth callback port (default 8766)\ntdc auth login --json             # Emit a JSON envelope for scripted / agent use\ntdc auth login --ndjson           # Emit an NDJSON envelope for scripted / agent use\ntdc auth token                    # Save API token manually (prompts securely; scope unknown, assumed write-capable)\ntdc auth status                   # Verify authentication + show mode\ntdc auth status --json            # Full status payload as JSON (--ndjson also supported)\ntdc auth status --user <ref>      # Target a specific stored account (id, id:<n>, or display name)\ntdc --user <ref> auth <status|logout|token view|refresh-token view>  # Equivalent to passing --user after the subcommand; other commands accept the flag but ignore it\ntdc auth logout                   # Remove saved token and auth metadata\ntdc auth logout --json            # Emits `{\"ok\": true}` (--ndjson is silent)\ntdc auth logout --user <ref>      # Target a specific stored account; mismatched ref errors with ACCOUNT_NOT_FOUND\ntdc auth token view               # Print the saved token to stdout (pipe-safe; refuses if COMMS_API_TOKEN is set)\ntdc auth token view --user <ref>  # Print the saved token for a specific stored account\ntdc auth refresh-token view       # Print the saved OAuth refresh token to stdout (pipe-safe; OAuth logins only)\ntdc auth refresh-token view --user <ref>  # Print the saved OAuth refresh token for a specific stored account\ntdc account [list|current|use <ref>|remove <ref>]  # Manage stored accounts; all support --json/--ndjson\n                                 # current's payload is {id, label, authMode, authScope, source:\"config\"} | {source:\"env\"} | {source:\"token-only\"}\ntdc auth login                    # Re-running auth login with a different OAuth grant adds a NEW account; default stays pinned unless none was set\ntdc workspaces                    # List available workspaces\ntdc workspace use <ref>           # Set current workspace\ntdc completion install            # Install shell completions\ntdc config view                   # Show the current CLI configuration file (token masked)\ntdc config set <key> <value>      # Set a user preference (e.g. unarchive-new-threads true)\ntdc doctor                        # Diagnose CLI setup and environment issues\ntdc update                        # Update CLI to latest version\ntdc changelog                     # Show recent changelog entries\ntdc migrate urls <urls>           # Translate old twist.com URLs to Comms URLs (needs a Twist token)\n```\n\nOAuth login uses Todoist OAuth for Comms access. The default grant can read Comms data and create/update content or messages. It does not include delete, channel management, or user/workspace write scopes; use `tdc auth login --full-access` only when needed. 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.\n\nIn 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.\n\n## View by URL\n\n```bash\ntdc view <url>                    # View any Comms entity by URL\n```\n\nRoutes automatically based on URL structure:\n- Message URL \u2192 `tdc msg view`\n- Conversation URL \u2192 `tdc conversation view`\n- Thread+comment URL \u2192 `tdc thread view` (comment ID extracted from URL)\n- Thread URL \u2192 `tdc thread view`\n\nURLs may use either `https://comms.todoist.com/{workspaceId}/...` or `https://comms.todoist.com/a/{workspaceId}/...`.\n\nAll target command flags pass through (e.g. `--json`, `--raw`, `--full`).\n\n## Inbox\n\n```bash\ntdc inbox                         # Show inbox threads\ntdc inbox --unread                # Only unread threads\ntdc inbox --archive-filter all      # Show active + done threads\ntdc inbox --archive-filter archived # Show only done threads\ntdc inbox --channel <filter>      # Filter by channel name (fuzzy)\ntdc inbox --since <date>          # Filter by date (ISO format)\ntdc inbox --limit <n>             # Max items (default: 50)\n```\n\n## Threads\n\n```bash\ntdc thread <thread-ref>           # View thread (shorthand for view)\ntdc thread view <thread-ref>      # View thread with comments\ntdc thread view <ref> --comment <id> # View a specific comment\ntdc thread view <url-with-/c/id>  # Comment ID extracted from URL\ntdc thread view <ref> --unread    # Show only unread comments\ntdc thread view <ref> --context 3 # Include 3 read comments before unread\ntdc thread view <ref> --limit 20  # Limit number of comments\ntdc thread view <ref> --since <date> # Comments newer than date\ntdc thread view <ref> --raw       # Show raw markdown\ntdc thread create <channel-ref> \"Title\" \"content\"    # Create a new thread\ntdc thread create <channel-ref> \"Title\" \"content\" --json       # Create and return as JSON\ntdc thread create <channel-ref> \"Title\" \"content\" --json --full # Include all thread fields\ntdc thread create <channel-ref> \"Title\" \"content\" --notify 123,456  # Notify specific users and/or groups by ID\ntdc thread create <channel-ref> \"Title\" \"content\" --unarchive  # Land thread in author's Inbox (overrides default Comms auto-archive)\ntdc thread create <channel-ref> \"Title\" \"content\" --no-unarchive  # Force archive even when userSettings.unarchiveNewThreads=true\ntdc thread create <channel-ref> \"Title\" \"content\" --dry-run  # Preview without posting\ntdc thread create <channel-ref> \"Title\" --file ./a.png  # Attach a file (repeatable; content optional)\ntdc thread reply <ref> \"content\"  # Post a comment (notifies EVERYONE_IN_THREAD by default)\ntdc thread reply <ref> \"content\" --notify EVERYONE  # Notify all workspace members\ntdc thread reply <ref> \"content\" --notify 123,id:456   # Notify specific users by ID\ntdc thread reply <ref> \"content\" --notify 123,Cbzzm11ZeYZoJYD4a6rti   # Notify a user and a group (group IDs are base58, not numeric)\ntdc thread reply <ref> \"content\" --json  # Post and return comment as JSON\ntdc thread reply <ref> \"content\" --json --full  # Include all comment fields\ntdc thread reply <ref> \"content\" --close       # Reply and close the thread\ntdc thread reply <ref> \"content\" --reopen      # Reply and reopen a closed thread\ntdc thread reply <ref> \"content\" --file ./a.png  # Attach a file (repeatable; content optional)\ntdc thread done <ref>                 # Preview thread archive (requires --yes to execute)\ntdc thread done <ref> --yes           # Archive thread (mark done)\ntdc thread done <ref> --yes --json    # Archive and return status as JSON\ntdc thread mark-read <ref>        # Mark a thread read\ntdc thread mark-read <ref> <ref> --yes # Mark multiple threads read\nprintf \"123\\n456\\n\" | tdc thread mark-read --dry-run # Preview bulk mark-read from stdin\ntdc thread mute <ref>             # Mute thread for 60 minutes (default)\ntdc thread mute <ref> --minutes 480  # Mute for custom duration\ntdc thread mute <ref> --json      # Mute and return { id, mutedUntil } as JSON\ntdc thread mute <ref> --json --full  # Mute and return full thread as JSON\ntdc thread unmute <ref>           # Unmute a muted thread\ntdc thread unmute <ref> --json    # Unmute and return { id, mutedUntil } as JSON\ntdc thread delete <ref>             # Preview thread deletion (requires --yes to execute)\ntdc thread delete <ref> --yes       # Permanently delete a thread\ntdc thread delete <ref> --yes --json # Delete and return status as JSON\ntdc thread rename <ref> \"New title\"  # Rename a thread (change its title)\ntdc thread rename <ref> \"New title\" --json  # Rename and return { id, title } as JSON\ntdc thread rename <ref> \"New title\" --json --full  # Rename and return full thread as JSON\ntdc thread update <ref> \"New body\"   # Update a thread's body (the first post)\necho \"New body\" | tdc thread update <ref>  # Update body from stdin\ntdc thread update <ref> \"New body\" --dry-run  # Preview without updating\ntdc thread update <ref> \"New body\" --json  # Update and return { id, content } as JSON\ntdc thread update <ref> \"New body\" --json --full  # Update and return full thread as JSON\n```\n\nDefault `--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 <ids>`). Options: EVERYONE, EVERYONE_IN_THREAD, or comma-separated user and/or group IDs.\n\n`--notify` automatically resolves IDs: group IDs are routed to the `groups` API field, user IDs to `recipients`. No special syntax needed.\n\n## Thread Comments\n\n```bash\ntdc comment <comment-ref>                       # View a comment (shorthand for view)\ntdc comment view <comment-ref>                  # View a single thread comment\ntdc comment view <comment-ref> --raw            # Show raw markdown\ntdc comment view <comment-ref> --json           # Output as JSON\ntdc comment view <comment-ref> --ndjson         # Output as newline-delimited JSON\ntdc comment view <comment-ref> --json --full    # Include all fields in JSON output\ntdc comment update <comment-ref> \"new content\"  # Update a thread comment\ntdc comment update <comment-ref> \"content\" --json  # Update and return updated comment as JSON\ntdc comment update <comment-ref> \"content\" --json --full  # Include all comment fields\ntdc comment delete <comment-ref>                     # Preview comment deletion (requires --yes to execute)\ntdc comment delete <comment-ref> --yes               # Delete a thread comment\ntdc comment delete <comment-ref> --yes --json        # Delete and return status as JSON\n```\n\n## Conversations (DMs/Groups)\n\n```bash\ntdc conversation unread                    # List unread conversations\ntdc conversation list                      # List active conversations (DMs and groups)\ntdc conversation list --kind group         # Only group conversations (3+ people)\ntdc conversation list --kind direct        # Only 1:1 conversations (and your self-DM)\ntdc conversation list --participant \"Jane\" # Only conversations including these users (comma-separated)\ntdc conversation list --name \"release\"     # Filter by title substring (case-insensitive)\ntdc conversation list --state archived     # Archived conversations only (active|all|archived; default active)\ntdc conversation list --snippet            # Include the latest message snippet\ntdc conversation list --limit 20 --json    # Cap rows and output as JSON\ntdc conversation <conversation-ref>        # View conversation (shorthand for view)\ntdc conversation view <conversation-ref>   # View conversation messages\ntdc conversation with <user-ref>           # Find your 1:1 DM with a user\ntdc conversation with <user-ref> --snippet # Include the latest message preview\ntdc conversation with <user-ref> --include-groups # List any conversations with that user\ntdc conversation reply <ref> \"content\"     # Send a message\ntdc conversation reply <ref> \"content\" --json  # Send and return message as JSON\ntdc conversation reply <ref> \"content\" --json --full  # Include all message fields\ntdc conversation reply <ref> \"content\" --file ./a.png  # Attach a file (repeatable; content optional)\ntdc conversation done <ref>                    # Preview conversation archive (requires --yes to execute)\ntdc conversation done <ref> --yes              # Archive conversation\ntdc conversation done <ref> --yes --json       # Archive and return status as JSON\ntdc conversation mute <ref>               # Mute conversation for 60 minutes (default)\ntdc conversation mute <ref> --minutes 480 # Mute for custom duration\ntdc conversation mute <ref> --json        # Mute and return { id, mutedUntil } as JSON\ntdc conversation mute <ref> --json --full # Mute and return full conversation as JSON\ntdc conversation unmute <ref>             # Unmute a muted conversation\ntdc conversation unmute <ref> --json      # Unmute and return { id, mutedUntil } as JSON\n```\n\nAlias: `tdc convo` works the same as `tdc conversation`.\n\n## Conversation Messages\n\n```bash\ntdc msg <message-ref>             # View a message (shorthand for view)\ntdc msg view <message-ref>        # View a single conversation message\ntdc msg update <ref> \"content\"    # Edit a conversation message\ntdc msg update <ref> \"content\" --json  # Edit and return updated message as JSON\ntdc msg update <ref> \"content\" --json --full  # Include all message fields\ntdc msg delete <ref>                  # Preview message deletion (requires --yes to execute)\ntdc msg delete <ref> --yes            # Delete a conversation message\ntdc msg delete <ref> --yes --json     # Delete and return status as JSON\n```\n\nAlias: `tdc message` works the same as `tdc msg`.\n\n## Search\n\n```bash\ntdc mentions                      # Show content mentioning current user\ntdc mentions --since 2026-04-01 --all # Fetch every mention since a date\ntdc mentions --type threads --json # Limit mentions to threads\ntdc search \"query\"                # Search content\ntdc search \"query\" --type threads # Filter: threads, messages, or all\ntdc search \"query\" --author <ref> # Filter by author\ntdc search \"query\" --to <ref>     # Messages sent to user\ntdc search \"query\" --title-only   # Search thread titles only\ntdc search \"query\" --mention-me   # Results mentioning current user\ntdc search \"query\" --conversation <refs> # Limit to conversations (comma-separated refs)\ntdc search \"query\" --since <date> # Content from date\ntdc search \"query\" --until <date> # Content until date\ntdc search \"query\" --channel <refs> # Filter by channel refs (comma-separated)\ntdc search \"query\" --limit <n>    # Max results (default: 50)\ntdc search \"query\" --cursor <cur> # Pagination cursor\ntdc search \"query\" --all          # Fetch all result pages\n```\n\n## Users, Channels & Groups\n\n```bash\ntdc user                          # Show current user info\ntdc user --json                   # JSON output\ntdc user --json --full            # Include all fields in JSON output\ntdc users                         # List active workspace users\ntdc users --search <text>         # Filter by name/email\ntdc users --include-removed       # Include users removed from the workspace\ntdc channels                      # List active joined workspace channels (alias of: tdc channel list)\ntdc channels --state all          # Include archived joined channels too\ntdc channels --scope discoverable # Active public channels you can see but have not joined\ntdc channels --scope public --state all --json # All visible public channels, with joined status\ntdc channel create \"Engineering\"  # Create a channel in the current workspace\ntdc channel create \"Leadership Team\" --private --users id:10,id:20 # Create private channel with initial members\ntdc channel create \"Product\" --workspace \"Doist\" --description \"Product discussions\" --json # Create and return channel as JSON\ntdc channel update <channel-ref> \"New name\" # Rename a channel\ntdc channel update <ref> --name \"New name\" # Rename with an explicit flag\ntdc channel update <ref> --description \"Team discussions\" # Update channel description\ntdc channel update <ref> --clear-description # Clear channel description\ntdc channel update <ref> --public # Make a channel public (--private makes it private)\ntdc channel update <ref> --description \"Team discussions\" --json --full # Update and return all channel fields\ntdc channel delete <channel-ref> --yes # Permanently delete a channel (requires --yes; usually admin-only)\ntdc channel delete <ref> --dry-run # Preview deletion\ntdc channel archive <channel-ref> # Archive a channel (no-op if already archived)\ntdc channel unarchive id:<id> # Unarchive a channel (pass id:/numeric ref for archived channels)\ntdc channel threads <channel-ref>  # List threads in a channel (fuzzy name, id:, numeric ID, or URL)\ntdc channel threads \"general\" --unread       # Only unread threads\ntdc channel threads <ref> --archive-filter all  # Include archived threads (active|archived|all)\ntdc channel threads <ref> --since 2026-01-01 # Filter by last-updated date (ISO)\ntdc channel threads <ref> --limit 20         # Max threads per page (default: 50)\ntdc channel threads <ref> --limit 20 --cursor <cursor-from-prev> # Paginate\ntdc channel threads <ref> --json  # { results, nextCursor } with isUnread + url\ntdc channel members <channel-ref> # List a channel's members + groups fully in the channel\ntdc channel members <ref> --json  # JSON with id, name, workspaceId, members\ntdc channel members add <ref> alice group:Design # Add users and/or expand group:<ref> members\ntdc channel members add <ref> a@d.com id:789 --json # Add refs, output result as JSON\ntdc channel members remove <ref> alice group:Frontend # Remove users and/or group members\ntdc channel members set <ref> group:Squad --apply # Replace membership with the resolved set\ntdc channel members set <ref> alice bob # Dry-run by default; refuses to remove you (--include-self to override)\ntdc groups                        # List workspace groups\ntdc groups --search \"frontend\"    # Filter groups by name (case-insensitive)\ntdc groups --json                 # JSON output\ntdc groups --json --full          # Include all fields in JSON output\ntdc groups view <group-ref>       # Show group with member details\ntdc groups view <ref> --json      # JSON output with id, name, workspaceId, members\ntdc groups view <ref> --json --full  # Include all fields in JSON output\ntdc groups create \"Name\"          # Create a new group\ntdc groups create \"Name\" --users alice@doist.com,bob@doist.com  # Create with members\ntdc groups create \"Name\" --json   # Output created group as JSON\ntdc groups rename <group-ref> \"New name\"  # Rename a group\ntdc groups rename <ref> \"Name\" --json     # Output renamed group as JSON\ntdc groups delete <group-ref> --yes       # Delete a group (requires --yes)\ntdc groups delete <ref> --dry-run         # Preview deletion\ntdc groups add-user <group-ref> user1 user2   # Add users to a group\ntdc groups add-user <ref> a@d.com,b@d.com     # Comma-separated refs\ntdc groups add-user <ref> id:123 --json       # Output result as JSON\ntdc groups remove-user <group-ref> user1 user2  # Remove users from a group\ntdc groups remove-user <ref> id:123,id:456      # Comma-separated ID refs\n```\n\nIf 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.\n\n`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.\n\nFor `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 \u2014 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.\n\n## Reactions\n\n```bash\ntdc react thread <ref> \uD83D\uDC4D         # Add reaction to thread\ntdc react comment <ref> +1        # Add reaction (shortcode)\ntdc react message <ref> heart     # Add reaction to DM message\ntdc react thread <ref> \uD83D\uDC4D --json  # Output result as JSON\ntdc unreact thread <ref> \uD83D\uDC4D       # Remove reaction\ntdc unreact thread <ref> \uD83D\uDC4D --json # Output result as JSON\n```\n\nSupported shortcodes: +1, -1, heart, tada, smile, laughing, thinking, fire, check, x, eyes, pray, clap, rocket, wave\n\n## Shell Completions\n\n```bash\ntdc completion install            # Install tab completions (prompts for shell)\ntdc completion install bash       # Install for specific shell\ntdc completion install zsh\ntdc completion install fish\ntdc completion uninstall          # Remove completions\n```\n\n### Diagnostics\n\n```bash\ntdc doctor                        # Run local + network diagnostics\ntdc doctor --offline              # Skip Comms and npm network checks\ntdc doctor --json                 # JSON output with per-check results\n```\n\n### Configuration\n\n```bash\ntdc config view                   # Pretty-printed config, token masked, labels actual token source\ntdc config view --json            # Raw JSON, token masked\ntdc config view --show-token      # Include the full token\ntdc config set unarchive-new-threads true   # Persist: always unarchive new threads so they land in your Inbox\ntdc config set unarchive-new-threads false  # Persist: keep Comms's default (thread auto-archived for author)\n```\n\nUser 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.\n\n### Update\n\n```bash\ntdc update                        # Update CLI to latest version\ntdc update --check                # Check for updates without installing, show channel\ntdc update --check --json         # Same, JSON envelope\ntdc update --check --ndjson       # Same, newline-delimited JSON envelope\ntdc update --channel              # Show current update channel\ntdc update switch --stable        # Switch to stable release channel\ntdc update switch --pre-release   # Switch to pre-release (next) channel\ntdc update switch --pre-release --json    # Same, JSON envelope\ntdc update switch --pre-release --ndjson  # Same, newline-delimited JSON envelope\n```\n\n### Changelog\n```bash\ntdc changelog                     # Show last 5 versions\ntdc changelog -n 3                # Show last 3 versions\ntdc changelog --count 10          # Show last 10 versions\n```\n\n## Migration\n\nTranslate old `twist.com` URLs to their Comms equivalents (e.g. for rewriting bookmarks or history). The migration endpoint authenticates with a **Twist** token (not a Comms one). Prefer the `TWIST_AUTH_TOKEN` environment variable \u2014 a CLI flag exposes the token in process listings. `--twist-token` is supported for ad-hoc use and overrides the env var. If the Twist CLI (`tw`) is installed, populate the env var inline with `TWIST_AUTH_TOKEN=\"$(tw auth token view)\"`.\n\n```bash\n# Comma-separated list as an argument (token from the environment)\nTWIST_AUTH_TOKEN=\"$(tw auth token view)\" tdc migrate urls \"https://twist.com/a/1/ch/2/t/3,https://twist.com/a/1/ch/2/t/4\"\n\n# Or pipe URLs via stdin (comma- or newline-separated)\ncat old-urls.txt | TWIST_AUTH_TOKEN=\"$(tw auth token view)\" tdc migrate urls\n\n# --twist-token overrides the env var (visible in process lists \u2014 prefer the env var)\ntdc migrate urls \"https://twist.com/a/1/ch/2/t/3\" --twist-token <token>\n\ntdc migrate urls \"<urls>\" --json    # Structured output ({ oldUrl, newUrl } / { oldUrl, error })\ntdc migrate urls \"<urls>\" --ndjson  # Newline-delimited JSON\n```\n\nOutput is one line per URL in input order: `old -> new` on success, `old  \u2717 <code>` on failure (`invalid_url` / `not_imported`, or `API_ERROR` when the endpoint gives no code). Per-URL failures don't abort the run; the command exits non-zero if any URL fails to migrate.\n\n## Global Options\n\n```bash\n--no-spinner               # Disable loading animations\n--progress-jsonl           # Machine-readable progress events (JSONL to stderr)\n--progress-jsonl=<path>    # Same, but write events to <path> instead of stderr\n--progress-jsonl <path>    # Same as above (space-separated form also accepted)\n--accessible               # Add text labels to color-coded output (also: TDC_ACCESSIBLE=1)\n--non-interactive          # Disable interactive prompts (auto-detected when stdin is not a TTY)\n--interactive              # Force interactive mode even when stdin is not a TTY\n```\n\n## Output Formats\n\nAll list/view commands support:\n\n```bash\n--json    # Output as JSON\n--ndjson  # Output as newline-delimited JSON (for streaming)\n--full    # Include all fields (default shows essential fields only)\n```\n\n## Dry Run\n\nMutating 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 \u2014 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:\n\n```\n[dry-run] Would <action>:\n  <Key>: <resolved value>\n  ...\nRun without --dry-run to execute.\n```\n\n## Reference System\n\nCommands accept flexible references:\n- **Numeric IDs**: `123` or `id:123`\n- **Comms URLs**: Full `https://comms.todoist.com/...` URLs (parsed automatically)\n- **Fuzzy names**: For workspaces/users - `\"My Workspace\"` or partial matches\n\n## Piping Input\n\nCommands that accept content (`thread create`, `thread reply`, `comment update`, `conversation reply`, `msg update`) auto-detect piped stdin:\n\n```bash\ncat notes.md | tdc thread reply <ref>\ntdc thread create <channel-ref> \"Title\" < body.md\necho \"Quick reply\" | tdc conversation reply <ref>\n```\n\nIf 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.\n\n`tdc thread mark-read` also accepts thread refs from stdin, one per line:\n\n```bash\nprintf \"123\\n456\\n\" | tdc thread mark-read --yes\n```\n\n## Common Workflows\n\n**View by URL (auto-routes to the right command):**\n```bash\ntdc view https://comms.todoist.com/1585/ch/100/t/200            # View thread\ntdc view https://comms.todoist.com/a/1585/ch/100/t/200          # View thread\ntdc view https://comms.todoist.com/a/1585/ch/100/t/200/c/300     # View comment\ntdc view https://comms.todoist.com/a/1585/msg/400                 # View conversation\ntdc view https://comms.todoist.com/a/1585/msg/400/m/500 --json    # View message as JSON\n```\n\n**Check inbox and respond:**\n```bash\ntdc inbox --unread --json\ntdc thread view <id> --unread\ntdc thread reply <id> \"Thanks, I'll look into this.\"\ntdc thread done <id> --yes\n```\n\n**Search and review:**\n```bash\ntdc mentions --since 2026-04-01 --all --json\ntdc search \"deployment\" --type threads --json\ntdc thread view <thread-id>\n```\n\n**Check DMs:**\n```bash\ntdc conversation unread --json\ntdc conversation list --kind group --json     # find a group DM by participants/name\ntdc conversation view <conversation-id>\ntdc conversation with \"Alice Example\"\ntdc conversation reply <id> \"Got it, thanks!\"\n```\n";
 export declare const SKILL_FILE_CONTENT: string;
 //# sourceMappingURL=content.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../../src/lib/skills/content.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,UAAU,cAAc,CAAA;AAErC,eAAO,MAAM,iBAAiB,2TAC8R,CAAA;AAE5T,eAAO,MAAM,YAAY,UAAU,CAAA;AAEnC,eAAO,MAAM,aAAa,QAAQ,CAAA;AAElC,eAAO,MAAM,aAAa,QAAsB,CAAA;AAEhD,eAAO,MAAM,aAAa,i9zBAsbzB,CAAA;AAED,eAAO,MAAM,kBAAkB,QASd,CAAA"}
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../../src/lib/skills/content.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,UAAU,cAAc,CAAA;AAErC,eAAO,MAAM,iBAAiB,2TAC8R,CAAA;AAE5T,eAAO,MAAM,YAAY,UAAU,CAAA;AAEnC,eAAO,MAAM,aAAa,QAAQ,CAAA;AAElC,eAAO,MAAM,aAAa,QAAsB,CAAA;AAEhD,eAAO,MAAM,aAAa,y+2BA2czB,CAAA;AAED,eAAO,MAAM,kBAAkB,QASd,CAAA"}

package/dist/lib/skills/content.js

@@ -40,6 +40,7 @@ tdc config set <key> <value>      # Set a user preference (e.g. unarchive-new-th
 tdc doctor                        # Diagnose CLI setup and environment issues
 tdc update                        # Update CLI to latest version
 tdc changelog                     # Show recent changelog entries
+tdc migrate urls <urls>           # Translate old twist.com URLs to Comms URLs (needs a Twist token)
 \`\`\`
 
 OAuth login uses Todoist OAuth for Comms access. The default grant can read Comms data and create/update content or messages. It does not include delete, channel management, or user/workspace write scopes; use \`tdc auth login --full-access\` only when needed. 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.
@@ -350,6 +351,26 @@ tdc changelog -n 3                # Show last 3 versions
 tdc changelog --count 10          # Show last 10 versions
 \`\`\`
 
+## Migration
+
+Translate old \`twist.com\` URLs to their Comms equivalents (e.g. for rewriting bookmarks or history). The migration endpoint authenticates with a **Twist** token (not a Comms one). Prefer the \`TWIST_AUTH_TOKEN\` environment variable — a CLI flag exposes the token in process listings. \`--twist-token\` is supported for ad-hoc use and overrides the env var. If the Twist CLI (\`tw\`) is installed, populate the env var inline with \`TWIST_AUTH_TOKEN="$(tw auth token view)"\`.
+
+\`\`\`bash
+# Comma-separated list as an argument (token from the environment)
+TWIST_AUTH_TOKEN="$(tw auth token view)" tdc migrate urls "https://twist.com/a/1/ch/2/t/3,https://twist.com/a/1/ch/2/t/4"
+
+# Or pipe URLs via stdin (comma- or newline-separated)
+cat old-urls.txt | TWIST_AUTH_TOKEN="$(tw auth token view)" tdc migrate urls
+
+# --twist-token overrides the env var (visible in process lists — prefer the env var)
+tdc migrate urls "https://twist.com/a/1/ch/2/t/3" --twist-token <token>
+
+tdc migrate urls "<urls>" --json    # Structured output ({ oldUrl, newUrl } / { oldUrl, error })
+tdc migrate urls "<urls>" --ndjson  # Newline-delimited JSON
+\`\`\`
+
+Output is one line per URL in input order: \`old -> new\` on success, \`old  ✗ <code>\` on failure (\`invalid_url\` / \`not_imported\`, or \`API_ERROR\` when the endpoint gives no code). Per-URL failures don't abort the run; the command exits non-zero if any URL fails to migrate.
+
 ## Global Options
 
 \`\`\`bash

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

@@ -1 +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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsb5B,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"}
+{"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2c5B,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/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@doist/comms-cli",
-    "version": "1.8.0",
+    "version": "1.9.1",
     "description": "TypeScript CLI for Comms",
     "type": "module",
     "main": "dist/index.js",
@@ -51,7 +51,7 @@
     ],
     "dependencies": {
         "@doist/cli-core": "0.26.0",
-        "@doist/comms-sdk": "0.5.0",
+        "@doist/comms-sdk": "0.7.1",
         "@pnpm/tabtab": "0.5.4",
         "chalk": "5.6.2",
         "commander": "14.0.3",