@doist/comms-cli 0.0.1 → 1.0.0

package/dist/lib/search-api.js

@@ -0,0 +1,93 @@
+import { getApiToken } from './auth.js';
+import { CliError } from './errors.js';
+function getBaseUrl() {
+    const override = process.env.COMMS_BASE_URL;
+    if (override) {
+        const trimmed = override.endsWith('/') ? override.slice(0, -1) : override;
+        return `${trimmed}/api/v1`;
+    }
+    return 'https://api.comms.todoist.com/api/v1';
+}
+function toCamelCase(str) {
+    return str.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());
+}
+function camelCaseKeys(obj) {
+    if (Array.isArray(obj)) {
+        return obj.map((item) => camelCaseKeys(item));
+    }
+    if (obj !== null && typeof obj === 'object') {
+        const result = {};
+        for (const [key, value] of Object.entries(obj)) {
+            const camelKey = toCamelCase(key);
+            result[camelKey] = camelCaseKeys(value);
+        }
+        return result;
+    }
+    return obj;
+}
+function transformSearchResult(item) {
+    const result = camelCaseKeys(item);
+    if (typeof result.snippetLastUpdatedTs === 'number') {
+        result.snippetLastUpdated = new Date(result.snippetLastUpdatedTs * 1000);
+        delete result.snippetLastUpdatedTs;
+    }
+    return result;
+}
+export async function extendedSearch(params) {
+    const token = await getApiToken();
+    const apiParams = {
+        workspace_id: params.workspaceId,
+    };
+    if (params.query)
+        apiParams.query = params.query;
+    if (params.title) {
+        apiParams.title = params.title;
+        if (!params.query)
+            apiParams.query = params.title;
+    }
+    if (params.type)
+        apiParams.type = params.type;
+    if (params.channelIds)
+        apiParams.channel_ids = JSON.stringify(params.channelIds);
+    if (params.conversationIds)
+        apiParams.conversation_ids = JSON.stringify(params.conversationIds);
+    if (params.authorIds)
+        apiParams.from_user_id = params.authorIds[0];
+    if (params.toUserIds)
+        apiParams.to_user_id = params.toUserIds[0];
+    if (params.mentionSelf)
+        apiParams.mention_self = params.mentionSelf;
+    if (params.dateFrom)
+        apiParams.after_ts = new Date(params.dateFrom).getTime() / 1000;
+    if (params.dateTo)
+        apiParams.before_ts = new Date(params.dateTo).getTime() / 1000;
+    if (params.limit)
+        apiParams.limit = params.limit;
+    if (params.cursor)
+        apiParams.cursor_mark = params.cursor;
+    const searchParams = new URLSearchParams();
+    for (const [key, value] of Object.entries(apiParams)) {
+        searchParams.append(key, String(value));
+    }
+    const url = `${getBaseUrl()}/search?${searchParams.toString()}`;
+    const response = await fetch(url, {
+        method: 'GET',
+        headers: {
+            Authorization: `Bearer ${token}`,
+            'Content-Type': 'application/json',
+        },
+    });
+    if (!response.ok) {
+        const errorText = await response.text();
+        throw new CliError('API_ERROR', `Search API error (${response.status}): ${errorText}`);
+    }
+    const data = await response.json();
+    const items = (data.items || []).map((item) => transformSearchResult(item));
+    return {
+        items,
+        nextCursorMark: data.next_cursor_mark,
+        hasMore: data.has_more ?? false,
+        isPlanRestricted: data.is_plan_restricted ?? false,
+    };
+}
+//# sourceMappingURL=search-api.js.map

package/dist/lib/search-api.js.map

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

package/dist/lib/search-helpers.d.ts

@@ -0,0 +1,32 @@
+import { Command } from 'commander';
+import type { PaginatedViewOptions } from './options.js';
+import { type ExtendedSearchResponse, type SearchType } from './search-api.js';
+export type SharedSearchOptions = PaginatedViewOptions & {
+    workspace?: string;
+    channel?: string;
+    author?: string;
+    to?: string;
+    type?: SearchType;
+    conversation?: string;
+    cursor?: string;
+    all?: boolean;
+};
+type SearchRequestOptions = SharedSearchOptions & {
+    query?: string;
+    title?: string;
+    mentionSelf?: boolean;
+};
+interface SearchRunResult {
+    workspaceId: number;
+    response: ExtendedSearchResponse;
+}
+type SharedSearchOptionConfig = {
+    addUniqueFilters?: (command: Command) => void;
+    limitDescription?: string;
+};
+export declare function addSharedSearchOptions<T extends Command>(command: T, config?: SharedSearchOptionConfig): T;
+export declare function runSearch(workspaceRef: string | undefined, options: SearchRequestOptions): Promise<SearchRunResult>;
+type SearchOutputOptions = Pick<SharedSearchOptions, 'all' | 'json' | 'ndjson' | 'full'>;
+export declare function printSearchResults(workspaceId: number, response: ExtendedSearchResponse, options: SearchOutputOptions): void;
+export {};
+//# sourceMappingURL=search-helpers.d.ts.map

package/dist/lib/search-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-helpers.d.ts","sourceRoot":"","sources":["../../src/lib/search-helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAA;AAM3C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AASxD,OAAO,EAGH,KAAK,sBAAsB,EAC3B,KAAK,UAAU,EAClB,MAAM,iBAAiB,CAAA;AAoBxB,MAAM,MAAM,mBAAmB,GAAG,oBAAoB,GAAG;IACrD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,OAAO,CAAA;CAChB,CAAA;AAED,KAAK,oBAAoB,GAAG,mBAAmB,GAAG;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,OAAO,CAAA;CACxB,CAAA;AAED,UAAU,eAAe;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,sBAAsB,CAAA;CACnC;AAED,KAAK,wBAAwB,GAAG;IAC5B,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;IAC7C,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC5B,CAAA;AAED,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,OAAO,EACpD,OAAO,EAAE,CAAC,EACV,MAAM,GAAE,wBAA6B,GACtC,CAAC,CA2BH;AAmGD,wBAAsB,SAAS,CAC3B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,OAAO,EAAE,oBAAoB,GAC9B,OAAO,CAAC,eAAe,CAAC,CAQ1B;AAiCD,KAAK,mBAAmB,GAAG,IAAI,CAAC,mBAAmB,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAA;AAExF,wBAAgB,kBAAkB,CAC9B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,sBAAsB,EAChC,OAAO,EAAE,mBAAmB,GAC7B,IAAI,CA4DN"}

package/dist/lib/search-helpers.js

@@ -0,0 +1,183 @@
+import { getFullCommsURL } from '@doist/comms-sdk';
+import { Option } from 'commander';
+import { getCurrentWorkspaceId } from './api.js';
+import { withCaseInsensitiveChoices } from './completion.js';
+import { formatRelativeDate } from './dates.js';
+import { CliError } from './errors.js';
+import { includePrivateChannels } from './global-args.js';
+import { colors, formatJson } from './output.js';
+import { getPublicChannelIds } from './public-channels.js';
+import { resolveChannelId, resolveConversationId, resolveUserRefs, resolveWorkspaceRef, } from './refs.js';
+import { extendedSearch, } from './search-api.js';
+function resolveStringRefs(refs, entityType, resolver) {
+    if (!refs)
+        return undefined;
+    return refs.split(',').map((raw) => {
+        const ref = raw.trim();
+        if (!ref) {
+            throw new CliError('INVALID_REF', `Invalid ${entityType} reference list: found empty value`);
+        }
+        return resolver(ref);
+    });
+}
+export function addSharedSearchOptions(command, config = {}) {
+    const limitDescription = config.limitDescription ?? 'Max results (default: 50)';
+    command
+        .option('--workspace <ref>', 'Workspace ID or name')
+        .option('--channel <channel-refs>', 'Filter by channels (comma-separated refs)')
+        .option('--author <user-refs>', 'Filter by author (comma-separated refs)')
+        .option('--to <user-refs>', 'Messages sent to user (comma-separated refs)')
+        .addOption(withCaseInsensitiveChoices(new Option('--type <type>', 'Filter: threads, messages, or all'), ['threads', 'messages', 'all']));
+    config.addUniqueFilters?.(command);
+    return command
+        .option('--conversation <refs>', 'Limit to conversations (comma-separated refs)')
+        .option('--since <date>', 'Content from date')
+        .option('--until <date>', 'Content until date')
+        .option('--limit <n>', limitDescription)
+        .option('--cursor <cursor>', 'Pagination cursor')
+        .option('--all', 'Fetch all pages of results')
+        .option('--json', 'Output as JSON')
+        .option('--ndjson', 'Output as newline-delimited JSON')
+        .option('--full', 'Include all fields in JSON output');
+}
+async function resolveWorkspaceId(workspaceRef, workspaceOption) {
+    if (workspaceRef && workspaceOption) {
+        throw new CliError('CONFLICTING_OPTIONS', 'Cannot specify workspace both as argument and --workspace flag');
+    }
+    const ref = workspaceRef || workspaceOption;
+    if (!ref) {
+        return getCurrentWorkspaceId();
+    }
+    const workspace = await resolveWorkspaceRef(ref);
+    return workspace.id;
+}
+async function buildSearchParams(workspaceId, options) {
+    const limit = options.limit ? parseInt(options.limit, 10) : 50;
+    const channelIds = resolveStringRefs(options.channel, 'channel', resolveChannelId);
+    const authorIds = options.author
+        ? await resolveUserRefs(options.author, workspaceId)
+        : undefined;
+    const toUserIds = options.to ? await resolveUserRefs(options.to, workspaceId) : undefined;
+    const conversationIds = resolveStringRefs(options.conversation, 'conversation', resolveConversationId);
+    return {
+        workspaceId,
+        query: options.query,
+        title: options.title,
+        type: options.type,
+        channelIds,
+        conversationIds,
+        authorIds,
+        toUserIds,
+        mentionSelf: options.mentionSelf,
+        dateFrom: options.since,
+        dateTo: options.until,
+        limit,
+        cursor: options.cursor,
+    };
+}
+async function fetchSearchPages(params, all = false) {
+    if (!all) {
+        return extendedSearch(params);
+    }
+    const items = [];
+    let cursor = params.cursor;
+    let hasMore = false;
+    let isPlanRestricted = false;
+    do {
+        const response = await extendedSearch({ ...params, cursor });
+        items.push(...response.items);
+        cursor = response.nextCursorMark;
+        hasMore = response.hasMore;
+        isPlanRestricted = isPlanRestricted || response.isPlanRestricted;
+    } while (hasMore && cursor);
+    return {
+        items,
+        hasMore: false,
+        isPlanRestricted,
+    };
+}
+async function filterVisibleSearchResults(workspaceId, response) {
+    if (includePrivateChannels()) {
+        return response;
+    }
+    const publicIds = await getPublicChannelIds(workspaceId);
+    return {
+        ...response,
+        items: response.items.filter((item) => !item.channelId || publicIds.has(item.channelId)),
+    };
+}
+export async function runSearch(workspaceRef, options) {
+    const workspaceId = await resolveWorkspaceId(workspaceRef, options.workspace);
+    const params = await buildSearchParams(workspaceId, options);
+    const response = await fetchSearchPages(params, options.all);
+    return {
+        workspaceId,
+        response: await filterVisibleSearchResults(workspaceId, response),
+    };
+}
+function buildSearchResultUrl(workspaceId, result) {
+    if (result.type === 'thread' && result.threadId && result.channelId) {
+        return getFullCommsURL({
+            workspaceId,
+            channelId: result.channelId,
+            threadId: result.threadId,
+        });
+    }
+    if (result.type === 'comment' && result.threadId && result.channelId && result.commentId) {
+        return getFullCommsURL({
+            workspaceId,
+            channelId: result.channelId,
+            threadId: result.threadId,
+            commentId: result.commentId,
+        });
+    }
+    if (result.type === 'message' && result.conversationId) {
+        return getFullCommsURL({ workspaceId, conversationId: result.conversationId });
+    }
+    return `https://comms.todoist.com/a/${workspaceId}`;
+}
+export function printSearchResults(workspaceId, response, options) {
+    const resultsWithUrls = response.items.map((result) => ({
+        ...result,
+        url: buildSearchResultUrl(workspaceId, result),
+    }));
+    if (options.json) {
+        console.log(formatJson({
+            results: resultsWithUrls,
+            nextCursor: response.nextCursorMark || null,
+        }, undefined, options.full));
+        return;
+    }
+    if (options.ndjson) {
+        for (const result of resultsWithUrls) {
+            console.log(JSON.stringify(result));
+        }
+        if (resultsWithUrls.length === 0 || response.nextCursorMark) {
+            console.log(JSON.stringify({ _meta: true, nextCursor: response.nextCursorMark || null }));
+        }
+        return;
+    }
+    if (resultsWithUrls.length === 0) {
+        if (!options.all && response.hasMore && response.nextCursorMark) {
+            console.log('No public results on this page.');
+            console.log(colors.timestamp(`More results available. Use --cursor ${response.nextCursorMark}`));
+        }
+        else {
+            console.log('No results found.');
+        }
+        return;
+    }
+    for (const result of resultsWithUrls) {
+        const type = colors.channel(`[${result.type}]`);
+        const title = result.title || result.snippet.slice(0, 50);
+        const time = colors.timestamp(formatRelativeDate(result.snippetLastUpdated));
+        console.log(`${type} ${title}`);
+        console.log(`  ${colors.timestamp(result.snippet.slice(0, 100))}`);
+        console.log(`  ${time}  ${colors.url(result.url)}`);
+        console.log('');
+    }
+    if (!options.all && response.hasMore) {
+        console.log(colors.timestamp(`More results available. Use --cursor ${response.nextCursorMark}`));
+    }
+}
+//# sourceMappingURL=search-helpers.js.map

package/dist/lib/search-helpers.js.map

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

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

@@ -0,0 +1,8 @@
+export declare const SKILL_NAME = "comms-cli";
+export declare 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 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 (opens browser, read-write)\ntdc auth login --read-only        # OAuth login with read-only scope\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>  # 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 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\nStored 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\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\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 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 user IDs\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 done <ref>             # Archive thread (mark done)\ntdc thread done <ref> --json      # Archive and return status as JSON\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 <user-ids>`). Options: EVERYONE, EVERYONE_IN_THREAD, or comma-separated ID refs.\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>                # Delete a thread comment\ntdc comment delete <comment-ref> --json         # Delete and return status as JSON\n```\n\n## Conversations (DMs/Groups)\n\n```bash\ntdc conversation unread                    # List unread conversations\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 done <ref>                # Archive conversation\ntdc conversation done <ref> --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>              # Delete a conversation message\ntdc msg delete <ref> --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 workspace users\ntdc users --search <text>         # Filter by name/email\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 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 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\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 Content\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## Common Workflows\n\n**View by URL (auto-routes to the right command):**\n```bash\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>\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 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

@@ -0,0 +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,iprBAwYzB,CAAA;AAED,eAAO,MAAM,kBAAkB,QASd,CAAA"}