@doist/comms-cli 0.0.1 → 1.0.0

package/dist/lib/progress.js

@@ -0,0 +1,86 @@
+import fs from 'node:fs';
+import { getProgressJsonlPath, isProgressJsonlEnabled } from './global-args.js';
+export class ProgressTracker {
+    enabled = false;
+    outputStream = null;
+    constructor() {
+        this.checkAndInitialize();
+    }
+    checkAndInitialize() {
+        if (!isProgressJsonlEnabled()) {
+            return;
+        }
+        this.enabled = true;
+        const outputPath = getProgressJsonlPath();
+        if (outputPath) {
+            try {
+                this.outputStream = fs.createWriteStream(outputPath, { flags: 'a' });
+            }
+            catch (_error) {
+                // Fall back to stderr if file creation fails
+                console.error(`Warning: Could not create progress file ${outputPath}, falling back to stderr`);
+                this.outputStream = process.stderr;
+            }
+        }
+        else {
+            this.outputStream = process.stderr;
+        }
+    }
+    isEnabled() {
+        return this.enabled;
+    }
+    emit(event) {
+        if (!this.enabled || !this.outputStream) {
+            return;
+        }
+        const progressEvent = {
+            ...event,
+            timestamp: new Date().toISOString(),
+        };
+        const line = `${JSON.stringify(progressEvent)}\n`;
+        this.outputStream.write(line);
+    }
+    emitStart(command) {
+        this.emit({ type: 'start', command });
+    }
+    emitApiCall(endpoint, cursor) {
+        this.emit({ type: 'api_call', endpoint, cursor });
+    }
+    emitApiResponse(count, hasMore, nextCursor) {
+        this.emit({
+            type: 'api_response',
+            count,
+            has_more: hasMore,
+            next_cursor: nextCursor,
+        });
+    }
+    emitComplete() {
+        this.emit({ type: 'complete' });
+    }
+    emitError(errorCode, message) {
+        this.emit({ type: 'error', error_code: errorCode, message });
+    }
+    close() {
+        if (this.outputStream && this.outputStream !== process.stderr) {
+            ;
+            this.outputStream.close();
+        }
+        this.enabled = false;
+        this.outputStream = null;
+    }
+}
+// Global singleton instance
+let progressTracker = null;
+export function getProgressTracker() {
+    if (!progressTracker) {
+        progressTracker = new ProgressTracker();
+    }
+    return progressTracker;
+}
+export function resetProgressTracker() {
+    if (progressTracker) {
+        progressTracker.close();
+    }
+    progressTracker = null;
+}
+//# sourceMappingURL=progress.js.map

package/dist/lib/progress.js.map

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

package/dist/lib/public-channels.d.ts

@@ -0,0 +1,4 @@
+export declare function getPublicChannelIds(workspaceId: number): Promise<Set<string>>;
+export declare function clearPublicChannelCache(): void;
+export declare function assertChannelIsPublic(channelId: string, workspaceId: number): Promise<void>;
+//# sourceMappingURL=public-channels.d.ts.map

package/dist/lib/public-channels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-channels.d.ts","sourceRoot":"","sources":["../../src/lib/public-channels.ts"],"names":[],"mappings":"AAMA,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAYnF;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAED,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQjG"}

package/dist/lib/public-channels.js

@@ -0,0 +1,32 @@
+import { getCommsClient } from './api.js';
+import { CliError } from './errors.js';
+import { includePrivateChannels } from './global-args.js';
+const publicChannelCache = new Map();
+export async function getPublicChannelIds(workspaceId) {
+    const cached = publicChannelCache.get(workspaceId);
+    if (cached)
+        return cached;
+    const client = await getCommsClient();
+    const channels = await client.channels.getChannels({ workspaceId });
+    const publicIds = new Set();
+    for (const ch of channels) {
+        if (ch.public)
+            publicIds.add(ch.id);
+    }
+    publicChannelCache.set(workspaceId, publicIds);
+    return publicIds;
+}
+export function clearPublicChannelCache() {
+    publicChannelCache.clear();
+}
+export async function assertChannelIsPublic(channelId, workspaceId) {
+    if (includePrivateChannels())
+        return;
+    const publicIds = await getPublicChannelIds(workspaceId);
+    if (!publicIds.has(channelId)) {
+        throw new CliError('NOT_FOUND', 'This thread belongs to a private channel.', [
+            'Use --include-private-channels to access it',
+        ]);
+    }
+}
+//# sourceMappingURL=public-channels.js.map

package/dist/lib/public-channels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-channels.js","sourceRoot":"","sources":["../../src/lib/public-channels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAEzD,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAuB,CAAA;AAEzD,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,WAAmB;IACzD,MAAM,MAAM,GAAG,kBAAkB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;IAClD,IAAI,MAAM;QAAE,OAAO,MAAM,CAAA;IAEzB,MAAM,MAAM,GAAG,MAAM,cAAc,EAAE,CAAA;IACrC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,EAAE,CAAC,CAAA;IACnE,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAA;IACnC,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;QACxB,IAAI,EAAE,CAAC,MAAM;YAAE,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IACvC,CAAC;IACD,kBAAkB,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,CAAA;IAC9C,OAAO,SAAS,CAAA;AACpB,CAAC;AAED,MAAM,UAAU,uBAAuB;IACnC,kBAAkB,CAAC,KAAK,EAAE,CAAA;AAC9B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,SAAiB,EAAE,WAAmB;IAC9E,IAAI,sBAAsB,EAAE;QAAE,OAAM;IACpC,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,WAAW,CAAC,CAAA;IACxD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,QAAQ,CAAC,WAAW,EAAE,2CAA2C,EAAE;YACzE,6CAA6C;SAChD,CAAC,CAAA;IACN,CAAC;AACL,CAAC"}

package/dist/lib/refs.d.ts

@@ -0,0 +1,62 @@
+import type { Channel, Group, Workspace } from '@doist/comms-sdk';
+export declare function isIdRef(ref: string): boolean;
+/**
+ * Returns the raw id portion of `123`, `id:123`, or `id:abc-xyz`. The Comms
+ * backend uses numeric ids for users and workspaces and base58 UUIDv7 strings
+ * for everything else, so this stays string-typed and consumers narrow as
+ * needed (`Number(...)` for numeric refs after validation).
+ */
+export declare function extractId(ref: string): string;
+export declare function extractNumericId(ref: string): number;
+export declare function parseNumericIdRefs(refs: string, label?: string): number[] | null;
+export declare function looksLikeRawId(ref: string): boolean;
+export interface ParsedCommsUrl {
+    workspaceId?: number;
+    channelId?: string;
+    threadId?: string;
+    commentId?: string;
+    conversationId?: string;
+    messageId?: string;
+}
+export declare function parseCommsUrl(url: string): ParsedCommsUrl | null;
+export type ParsedRef = {
+    type: 'id';
+    id: string;
+} | {
+    type: 'url';
+    parsed: ParsedCommsUrl;
+} | {
+    type: 'name';
+    name: string;
+};
+export declare function parseRef(ref: string): ParsedRef;
+export declare function resolveWorkspaceRef(ref: string): Promise<Workspace>;
+export declare function resolveThreadId(ref: string): string;
+export declare function resolveChannelRef(ref: string, workspaceId: number): Promise<Channel>;
+export declare function resolveChannelId(ref: string): string;
+export declare function getDirectChannelId(ref: string): string | null;
+export declare function resolveCommentId(ref: string): string;
+export declare function resolveConversationId(ref: string): string;
+export declare function resolveMessageId(ref: string): string;
+export type CommsUrlRoute = {
+    entityType: 'message' | 'conversation' | 'comment' | 'thread';
+    url: string;
+};
+export declare function classifyCommsUrl(url: string): CommsUrlRoute | null;
+/**
+ * Split a list of notify refs into numeric user IDs and base58 group IDs by
+ * checking each ref against the workspace's known group IDs. Anything not in
+ * the group set is treated as a user ID and parsed as a number.
+ */
+export declare function partitionNotifyIds(ids: readonly string[], groupIds: ReadonlySet<string>): {
+    userIds: number[];
+    groupIds: string[];
+};
+/**
+ * Parse a comma-separated list of notify refs into raw IDs (untyped — callers
+ * use {@link partitionNotifyIds} to split into users vs. groups).
+ */
+export declare function parseNotifyIdRefs(refs: string): string[];
+export declare function resolveGroupRef(ref: string, workspaceId: number): Promise<Group>;
+export declare function resolveUserRefs(refs: string, workspaceId: number): Promise<number[]>;
+//# sourceMappingURL=refs.d.ts.map

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

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

package/dist/lib/refs.js

@@ -0,0 +1,378 @@
+import { fetchWorkspaces, getGroup, getWorkspaceGroups, getCommsClient } from './api.js';
+import { CliError } from './errors.js';
+function normalizeRef(ref) {
+    return ref.trim();
+}
+export function isIdRef(ref) {
+    return normalizeRef(ref).startsWith('id:');
+}
+/**
+ * Returns the raw id portion of `123`, `id:123`, or `id:abc-xyz`. The Comms
+ * backend uses numeric ids for users and workspaces and base58 UUIDv7 strings
+ * for everything else, so this stays string-typed and consumers narrow as
+ * needed (`Number(...)` for numeric refs after validation).
+ */
+export function extractId(ref) {
+    const normalized = normalizeRef(ref);
+    const idStr = isIdRef(normalized) ? normalized.slice(3).trim() : normalized;
+    if (!idStr) {
+        throw new CliError('INVALID_ID', `Invalid ID: ${ref}`);
+    }
+    return idStr;
+}
+export function extractNumericId(ref) {
+    const idStr = extractId(ref);
+    if (!/^\d+$/.test(idStr)) {
+        throw new CliError('INVALID_ID', `Invalid numeric ID: ${ref}`);
+    }
+    return Number(idStr);
+}
+export function parseNumericIdRefs(refs, label = 'reference') {
+    const ids = [];
+    for (const rawRef of refs.split(',')) {
+        const ref = rawRef.trim();
+        if (!ref) {
+            throw new CliError('INVALID_REF', `Invalid ${label} reference list: found empty value`);
+        }
+        const id = extractId(ref);
+        if (!/^\d+$/.test(id)) {
+            return null;
+        }
+        ids.push(Number(id));
+    }
+    return ids;
+}
+export function looksLikeRawId(ref) {
+    const normalized = normalizeRef(ref);
+    if (!normalized || normalized.includes(' '))
+        return false;
+    return /^[A-Za-z0-9_-]+$/.test(normalized) && /\d/.test(normalized);
+}
+export function parseCommsUrl(url) {
+    try {
+        const parsed = new URL(url);
+        if (!parsed.hostname.includes('comms.todoist.com')) {
+            return null;
+        }
+        const path = parsed.pathname;
+        const result = {};
+        // Pattern: /a/{workspaceId}/ch/{channelId}/t/{threadId}/c/{commentId}
+        // Pattern: /a/{workspaceId}/msg/{conversationId}/m/{messageId}
+        const workspaceMatch = path.match(/\/a\/(\d+)/);
+        if (workspaceMatch) {
+            result.workspaceId = parseInt(workspaceMatch[1], 10);
+        }
+        const channelMatch = path.match(/\/ch\/([A-Za-z0-9_-]+)/);
+        if (channelMatch) {
+            result.channelId = channelMatch[1];
+        }
+        const threadMatch = path.match(/\/t\/([A-Za-z0-9_-]+)/);
+        if (threadMatch) {
+            result.threadId = threadMatch[1];
+        }
+        const commentMatch = path.match(/\/c\/([A-Za-z0-9_-]+)/);
+        if (commentMatch) {
+            result.commentId = commentMatch[1];
+        }
+        const conversationMatch = path.match(/\/msg\/([A-Za-z0-9_-]+)/);
+        if (conversationMatch) {
+            result.conversationId = conversationMatch[1];
+        }
+        const messageMatch = path.match(/\/m\/([A-Za-z0-9_-]+)/);
+        if (messageMatch) {
+            result.messageId = messageMatch[1];
+        }
+        return Object.keys(result).length > 0 ? result : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function parseRef(ref) {
+    const normalized = normalizeRef(ref);
+    if (isIdRef(normalized)) {
+        return { type: 'id', id: extractId(normalized) };
+    }
+    if (normalized.startsWith('http://') || normalized.startsWith('https://')) {
+        const parsed = parseCommsUrl(normalized);
+        if (parsed) {
+            return { type: 'url', parsed };
+        }
+    }
+    if (looksLikeRawId(normalized)) {
+        return { type: 'id', id: normalized };
+    }
+    return { type: 'name', name: normalized };
+}
+/**
+ * Match an entity by name: exact (case-insensitive) → unique substring → ambiguous/not-found.
+ */
+function matchByName(items, query, opts) {
+    const lower = query.toLowerCase();
+    const exact = items.find((item) => item.name.toLowerCase() === lower);
+    if (exact)
+        return exact;
+    const partial = items.filter((item) => item.name.toLowerCase().includes(lower));
+    if (partial.length === 1)
+        return partial[0];
+    if (partial.length > 1) {
+        const matches = partial
+            .slice(0, 5)
+            .map((item) => `"${item.name}" (id:${item.id})`)
+            .join(', ');
+        throw new CliError(opts.ambiguousCode, `Multiple matches for "${opts.ref}": ${matches}`, [
+            'Use the numeric ID (e.g. id:123) to specify exactly which one.',
+        ]);
+    }
+    throw new CliError(opts.notFoundCode, `"${opts.ref}" not found`, [opts.listHint]);
+}
+export async function resolveWorkspaceRef(ref) {
+    const workspaces = await fetchWorkspaces();
+    const parsed = parseRef(ref);
+    if (parsed.type === 'id') {
+        const numericId = Number(parsed.id);
+        if (!Number.isFinite(numericId)) {
+            throw new CliError('WORKSPACE_NOT_FOUND', `Workspace with ID ${parsed.id} not found`, [
+                'Run: tdc workspaces to list available workspaces',
+            ]);
+        }
+        const workspace = workspaces.find((w) => w.id === numericId);
+        if (!workspace) {
+            throw new CliError('WORKSPACE_NOT_FOUND', `Workspace with ID ${parsed.id} not found`, [
+                'Run: tdc workspaces to list available workspaces',
+            ]);
+        }
+        return workspace;
+    }
+    if (parsed.type === 'url' && parsed.parsed.workspaceId) {
+        const workspace = workspaces.find((w) => w.id === parsed.parsed.workspaceId);
+        if (!workspace) {
+            throw new CliError('WORKSPACE_NOT_FOUND', `Workspace with ID ${parsed.parsed.workspaceId} not found`, ['Run: tdc workspaces to list available workspaces']);
+        }
+        return workspace;
+    }
+    if (parsed.type === 'name') {
+        return matchByName(workspaces, parsed.name, {
+            ambiguousCode: 'AMBIGUOUS_WORKSPACE',
+            notFoundCode: 'WORKSPACE_NOT_FOUND',
+            ref,
+            listHint: 'Run: tdc workspaces to list available workspaces',
+        });
+    }
+    throw new CliError('WORKSPACE_NOT_FOUND', `Workspace "${ref}" not found`, [
+        'Run: tdc workspaces to list available workspaces',
+    ]);
+}
+export function resolveThreadId(ref) {
+    const parsed = parseRef(ref);
+    if (parsed.type === 'id') {
+        return parsed.id;
+    }
+    if (parsed.type === 'url' && parsed.parsed.threadId) {
+        return parsed.parsed.threadId;
+    }
+    throw new CliError('INVALID_REF', `Invalid thread reference: ${ref}. Use an id, id:<id>, or a Comms URL.`);
+}
+function assertChannelInWorkspace(channel, workspaceId) {
+    if (channel.workspaceId !== workspaceId) {
+        throw new CliError('CHANNEL_NOT_FOUND', `Channel ${channel.id} does not belong to workspace ${workspaceId}`);
+    }
+}
+export async function resolveChannelRef(ref, workspaceId) {
+    const parsed = parseRef(ref);
+    const client = await getCommsClient();
+    if (parsed.type === 'id') {
+        const channel = await client.channels.getChannel(parsed.id);
+        assertChannelInWorkspace(channel, workspaceId);
+        return channel;
+    }
+    if (parsed.type === 'url' && parsed.parsed.channelId) {
+        if (parsed.parsed.workspaceId && parsed.parsed.workspaceId !== workspaceId) {
+            throw new CliError('CHANNEL_NOT_FOUND', `Channel URL belongs to workspace ${parsed.parsed.workspaceId}, but the current workspace is ${workspaceId}`, ['Pass the matching workspace-ref or use the default workspace that owns the URL.']);
+        }
+        const channel = await client.channels.getChannel(parsed.parsed.channelId);
+        assertChannelInWorkspace(channel, workspaceId);
+        return channel;
+    }
+    if (parsed.type === 'name') {
+        const channels = await client.channels.getChannels({ workspaceId });
+        return matchByName(channels, parsed.name, {
+            ambiguousCode: 'AMBIGUOUS_CHANNEL',
+            notFoundCode: 'CHANNEL_NOT_FOUND',
+            ref,
+            listHint: 'Run: tdc channels to list available channels',
+        });
+    }
+    throw new CliError('CHANNEL_NOT_FOUND', `Channel "${ref}" not found`, [
+        'Run: tdc channels to list available channels',
+    ]);
+}
+export function resolveChannelId(ref) {
+    const channelId = getDirectChannelId(ref);
+    if (channelId)
+        return channelId;
+    throw new CliError('INVALID_REF', `Invalid channel reference: ${ref}. Use an id, id:<id>, or a Comms URL.`);
+}
+export function getDirectChannelId(ref) {
+    const parsed = parseRef(ref);
+    if (parsed.type === 'id') {
+        return parsed.id;
+    }
+    if (parsed.type === 'url') {
+        if (parsed.parsed.channelId) {
+            return parsed.parsed.channelId;
+        }
+        throw new CliError('INVALID_REF', `Invalid channel reference: ${ref}. Use an id, id:<id>, or a Comms URL.`);
+    }
+    return null;
+}
+export function resolveCommentId(ref) {
+    const parsed = parseRef(ref);
+    if (parsed.type === 'id') {
+        return parsed.id;
+    }
+    if (parsed.type === 'url' && parsed.parsed.commentId) {
+        return parsed.parsed.commentId;
+    }
+    throw new CliError('INVALID_REF', `Invalid comment reference: ${ref}. Use an id, id:<id>, or a Comms URL.`);
+}
+export function resolveConversationId(ref) {
+    const parsed = parseRef(ref);
+    if (parsed.type === 'id') {
+        return parsed.id;
+    }
+    if (parsed.type === 'url' && parsed.parsed.conversationId) {
+        return parsed.parsed.conversationId;
+    }
+    throw new CliError('INVALID_REF', `Invalid conversation reference: ${ref}. Use an id, id:<id>, or a Comms URL.`);
+}
+export function resolveMessageId(ref) {
+    const parsed = parseRef(ref);
+    if (parsed.type === 'id') {
+        return parsed.id;
+    }
+    if (parsed.type === 'url' && parsed.parsed.messageId) {
+        return parsed.parsed.messageId;
+    }
+    throw new CliError('INVALID_REF', `Invalid message reference: ${ref}. Use an id, id:<id>, or a Comms URL.`);
+}
+export function classifyCommsUrl(url) {
+    const parsed = parseCommsUrl(url);
+    if (!parsed)
+        return null;
+    if (parsed.messageId)
+        return { entityType: 'message', url };
+    if (parsed.conversationId && !parsed.messageId)
+        return { entityType: 'conversation', url };
+    if (parsed.commentId)
+        return { entityType: 'comment', url };
+    if (parsed.threadId && !parsed.commentId)
+        return { entityType: 'thread', url };
+    return null;
+}
+/**
+ * Split a list of notify refs into numeric user IDs and base58 group IDs by
+ * checking each ref against the workspace's known group IDs. Anything not in
+ * the group set is treated as a user ID and parsed as a number.
+ */
+export function partitionNotifyIds(ids, groupIds) {
+    const users = [];
+    const groups = [];
+    for (const id of ids) {
+        if (groupIds.has(id)) {
+            groups.push(id);
+            continue;
+        }
+        const num = Number(id);
+        if (!Number.isFinite(num) || !/^\d+$/.test(id)) {
+            throw new CliError('INVALID_REF', `Invalid notify ID "${id}": expected a numeric user ID or a known group ID.`);
+        }
+        users.push(num);
+    }
+    return { userIds: users, groupIds: groups };
+}
+/**
+ * Parse a comma-separated list of notify refs into raw IDs (untyped — callers
+ * use {@link partitionNotifyIds} to split into users vs. groups).
+ */
+export function parseNotifyIdRefs(refs) {
+    return refs.split(',').map((userRef) => {
+        const trimmed = userRef.trim();
+        if (!trimmed) {
+            throw new CliError('INVALID_REF', 'Invalid notify reference list: found empty value');
+        }
+        try {
+            return extractId(trimmed);
+        }
+        catch {
+            throw new CliError('INVALID_REF', `Invalid notify reference: ${trimmed}. Use a user or group id.`);
+        }
+    });
+}
+export async function resolveGroupRef(ref, workspaceId) {
+    const parsed = parseRef(ref);
+    if (parsed.type === 'id') {
+        try {
+            const group = await getGroup(parsed.id, workspaceId);
+            if (group.workspaceId !== workspaceId) {
+                throw new CliError('GROUP_NOT_FOUND', `Group ${parsed.id} does not belong to workspace ${workspaceId}`);
+            }
+            return group;
+        }
+        catch (error) {
+            if (error instanceof CliError)
+                throw error;
+            throw new CliError('GROUP_NOT_FOUND', `Group with ID ${parsed.id} not found`, [
+                'Run: tdc groups to list available groups',
+            ]);
+        }
+    }
+    if (parsed.type === 'name') {
+        const groups = await getWorkspaceGroups(workspaceId);
+        return matchByName(groups, parsed.name, {
+            ambiguousCode: 'AMBIGUOUS_GROUP',
+            notFoundCode: 'GROUP_NOT_FOUND',
+            ref,
+            listHint: 'Run: tdc groups to list available groups',
+        });
+    }
+    throw new CliError('GROUP_NOT_FOUND', `Group "${ref}" not found`, [
+        'Run: tdc groups to list available groups',
+    ]);
+}
+export async function resolveUserRefs(refs, workspaceId) {
+    const numericIds = parseNumericIdRefs(refs, 'user');
+    if (numericIds)
+        return numericIds;
+    const { getWorkspaceUsers } = await import('./api.js');
+    const users = await getWorkspaceUsers(workspaceId);
+    const parts = refs.split(',').map((r) => r.trim());
+    const ids = [];
+    for (const ref of parts) {
+        const parsed = parseRef(ref);
+        if (parsed.type === 'id') {
+            const num = Number(parsed.id);
+            if (!Number.isFinite(num) || !/^\d+$/.test(parsed.id)) {
+                throw new CliError('INVALID_REF', `Invalid user ID: ${ref}`);
+            }
+            ids.push(num);
+            continue;
+        }
+        const query = ref.toLowerCase();
+        const matches = users.filter((u) => u.fullName.toLowerCase().includes(query) || u.email?.toLowerCase().includes(query));
+        if (matches.length === 0) {
+            throw new CliError('USER_NOT_FOUND', `No user found matching "${ref}"`, [
+                'Run: tdc users to list workspace members',
+            ]);
+        }
+        if (matches.length > 1) {
+            const list = matches
+                .map((u) => `  ${u.id}  ${u.fullName} <${u.email ?? ''}>`)
+                .join('\n');
+            throw new CliError('AMBIGUOUS_USER', `Multiple users match "${ref}":\n${list}\n\nUse numeric ID to specify.`);
+        }
+        ids.push(matches[0].id);
+    }
+    return ids;
+}
+//# sourceMappingURL=refs.js.map

package/dist/lib/refs.js.map

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

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

@@ -0,0 +1,25 @@
+import type { SearchResult } from '@doist/comms-sdk';
+export type SearchType = 'threads' | 'messages' | 'all';
+export interface ExtendedSearchParams {
+    workspaceId: number;
+    query?: string;
+    title?: string;
+    type?: SearchType;
+    channelIds?: string[];
+    conversationIds?: string[];
+    authorIds?: number[];
+    toUserIds?: number[];
+    mentionSelf?: boolean;
+    dateFrom?: string;
+    dateTo?: string;
+    limit?: number;
+    cursor?: string;
+}
+export interface ExtendedSearchResponse {
+    items: SearchResult[];
+    nextCursorMark?: string;
+    hasMore: boolean;
+    isPlanRestricted: boolean;
+}
+export declare function extendedSearch(params: ExtendedSearchParams): Promise<ExtendedSearchResponse>;
+//# sourceMappingURL=search-api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search-api.d.ts","sourceRoot":"","sources":["../../src/lib/search-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAapD,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,KAAK,CAAA;AAEvD,MAAM,WAAW,oBAAoB;IACjC,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,sBAAsB;IACnC,KAAK,EAAE,YAAY,EAAE,CAAA;IACrB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,OAAO,EAAE,OAAO,CAAA;IAChB,gBAAgB,EAAE,OAAO,CAAA;CAC5B;AA8BD,wBAAsB,cAAc,CAChC,MAAM,EAAE,oBAAoB,GAC7B,OAAO,CAAC,sBAAsB,CAAC,CAqDjC"}