chatroom-cli 1.30.1 → 1.32.1

package/dist/commands/telegram/index.js

@@ -0,0 +1,94 @@
+/**
+ * Telegram CLI Commands — send messages to Telegram via chatroom integrations.
+ *
+ * Allows agents to push messages to connected Telegram chats.
+ */
+import { ConvexError } from 'convex/values';
+import { api } from '../../api.js';
+import { getSessionId, getOtherSessionUrls } from '../../infrastructure/auth/storage.js';
+import { getConvexClient, getConvexUrl } from '../../infrastructure/convex/client.js';
+import { formatError, formatAuthError, formatChatroomIdError, } from '../../utils/error-formatting.js';
+// ─── Default Deps Factory ──────────────────────────────────────────────────
+async function createDefaultDeps() {
+    const client = await getConvexClient();
+    return {
+        backend: {
+            action: (endpoint, args) => client.action(endpoint, args),
+        },
+        session: {
+            getSessionId,
+            getConvexUrl,
+            getOtherSessionUrls,
+        },
+    };
+}
+// ─── Commands ──────────────────────────────────────────────────────────────
+/**
+ * Send a message to a connected Telegram integration for a chatroom.
+ */
+export async function sendMessage(options, deps) {
+    const d = deps ?? (await createDefaultDeps());
+    // Get session ID for authentication
+    const sessionId = d.session.getSessionId();
+    if (!sessionId) {
+        const otherUrls = d.session.getOtherSessionUrls();
+        const currentUrl = d.session.getConvexUrl();
+        formatAuthError(currentUrl, otherUrls);
+        process.exit(1);
+        return;
+    }
+    // Validate chatroom ID format
+    const { chatroomId } = options;
+    if (!chatroomId ||
+        typeof chatroomId !== 'string' ||
+        chatroomId.length < 20 ||
+        chatroomId.length > 40) {
+        formatChatroomIdError(chatroomId);
+        process.exit(1);
+        return;
+    }
+    // Validate message is not empty
+    if (!options.message || options.message.trim().length === 0) {
+        formatError('Message cannot be empty', [
+            'Provide a message via --message flag',
+            'Example: chatroom telegram send-message --chatroom-id=<id> --integration-id=<id> --message="Hello"',
+        ]);
+        process.exit(1);
+        return;
+    }
+    const senderRole = options.role || 'user';
+    try {
+        const result = await d.backend.action(api.integrations.telegram.actions.sendMessage, {
+            sessionId,
+            chatroomId: chatroomId,
+            message: options.message,
+            senderRole,
+        });
+        if (result?.success) {
+            console.log('✅ Message sent to Telegram');
+            console.log(`📨 "${options.message}"`);
+        }
+    }
+    catch (error) {
+        console.error('\n❌ ERROR: Failed to send message to Telegram');
+        if (error instanceof ConvexError) {
+            const errorData = error.data;
+            console.error(`\n${errorData.message || 'An unexpected error occurred'}`);
+            if (process.env.CHATROOM_DEBUG === 'true') {
+                console.error('\n🔍 Debug Info:');
+                console.error(JSON.stringify(errorData, null, 2));
+            }
+        }
+        else {
+            console.error(`\n${error instanceof Error ? error.message : String(error)}`);
+            if (process.env.CHATROOM_DEBUG === 'true') {
+                console.error('\n🔍 Debug Info:');
+                console.error(error);
+            }
+        }
+        console.error('\n📚 Need help? Run:');
+        console.error('   chatroom telegram send-message --help');
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=index.js.map

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

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

package/dist/commands/update/deps.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Update Deps — dependency interfaces for the update command.
+ *
+ * The update command checks npm and runs install - it does not use
+ * BackendOps or SessionOps. Uses getVersion and exec for testability.
+ */
+/**
+ * Exec result from running a shell command
+ */
+export interface ExecResult {
+    stdout: string;
+    stderr?: string;
+}
+/**
+ * All external dependencies for the update command.
+ */
+export interface UpdateDeps {
+    getVersion: () => string;
+    exec: (cmd: string) => Promise<ExecResult>;
+}
+//# sourceMappingURL=deps.d.ts.map

package/dist/commands/update/deps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../../../src/commands/update/deps.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,MAAM,CAAC;IACzB,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CAC5C"}

package/dist/commands/update/deps.js

@@ -0,0 +1,8 @@
+/**
+ * Update Deps — dependency interfaces for the update command.
+ *
+ * The update command checks npm and runs install - it does not use
+ * BackendOps or SessionOps. Uses getVersion and exec for testability.
+ */
+export {};
+//# sourceMappingURL=deps.js.map

package/dist/commands/update/deps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps.js","sourceRoot":"","sources":["../../../src/commands/update/deps.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

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

@@ -0,0 +1,8 @@
+/**
+ * Update command
+ * Updates the chatroom CLI to the latest version
+ */
+import type { UpdateDeps } from './deps.js';
+export type { UpdateDeps } from './deps.js';
+export declare function update(deps?: UpdateDeps): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/update/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAO5C,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAc5C,wBAAsB,MAAM,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA4D7D"}

package/dist/commands/update/index.js

@@ -0,0 +1,70 @@
+/**
+ * Update command
+ * Updates the chatroom CLI to the latest version
+ */
+import { exec } from 'node:child_process';
+import { promisify } from 'node:util';
+import { getVersion } from '../../version.js';
+const execAsync = promisify(exec);
+// ─── Default Deps Factory ──────────────────────────────────────────────────
+function createDefaultDeps() {
+    return {
+        getVersion,
+        exec: (cmd) => execAsync(cmd).then((r) => ({ stdout: r.stdout ?? '', stderr: r.stderr })),
+    };
+}
+// ─── Entry Point ───────────────────────────────────────────────────────────
+export async function update(deps) {
+    const d = deps ?? createDefaultDeps();
+    const log = console.log.bind(console);
+    log('\n🔄 Checking for updates...\n');
+    // Check if npm is available
+    try {
+        await d.exec('npm --version');
+    }
+    catch {
+        console.error('❌ npm is not available. Please install npm to update.');
+        process.exit(1);
+        return;
+    }
+    const currentVersion = d.getVersion();
+    log(`   Current version: ${currentVersion}`);
+    // Check latest version
+    let latestVersion = null;
+    try {
+        const { stdout } = await d.exec('npm view chatroom-cli version');
+        latestVersion = stdout.trim() || null;
+    }
+    catch {
+        latestVersion = null;
+    }
+    if (!latestVersion) {
+        console.error('❌ Could not check for latest version.');
+        console.error('   You can manually update with: npm install -g chatroom-cli@latest');
+        process.exit(1);
+        return;
+    }
+    log(`   Latest version:  ${latestVersion}`);
+    if (currentVersion === latestVersion) {
+        log('\n✅ You already have the latest version!');
+        return;
+    }
+    log('\n📦 Updating to latest version...\n');
+    try {
+        const { stdout } = await d.exec('npm install -g chatroom-cli@latest');
+        if (stdout) {
+            log(stdout);
+        }
+        log('\n✅ Successfully updated chatroom-cli!');
+        log(`   ${currentVersion} → ${latestVersion}`);
+    }
+    catch (error) {
+        const err = error;
+        console.error(`\n❌ Update failed: ${err.message}`);
+        console.error('\n   Try running manually with sudo:');
+        console.error('   sudo npm install -g chatroom-cli@latest');
+        process.exit(1);
+        return;
+    }
+}
+//# sourceMappingURL=index.js.map

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

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

package/dist/commands/update/index.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * update Unit Tests
+ *
+ * Tests the update command using injected dependencies.
+ * Covers: auth test (exits 1 - npm not available), success test, error test.
+ */
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/commands/update/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../../src/commands/update/index.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/commands/update/index.test.js

@@ -0,0 +1,108 @@
+/**
+ * update Unit Tests
+ *
+ * Tests the update command using injected dependencies.
+ * Covers: auth test (exits 1 - npm not available), success test, error test.
+ */
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { update } from './index.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function createMockDeps(overrides) {
+    return {
+        getVersion: vi.fn().mockReturnValue('1.0.0'),
+        exec: vi.fn().mockResolvedValue({ stdout: '2.0.0', stderr: '' }),
+        ...overrides,
+    };
+}
+// ---------------------------------------------------------------------------
+// Setup / Teardown
+// ---------------------------------------------------------------------------
+let exitSpy;
+let logSpy;
+let errorSpy;
+beforeEach(() => {
+    exitSpy = vi.spyOn(process, 'exit').mockImplementation((() => { }));
+    logSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+    errorSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+});
+afterEach(() => {
+    vi.restoreAllMocks();
+});
+function getAllLogOutput() {
+    return logSpy.mock.calls.map((c) => c.join(' ')).join('\n');
+}
+function getAllErrorOutput() {
+    return errorSpy.mock.calls.map((c) => c.join(' ')).join('\n');
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('update', () => {
+    describe('authentication / preconditions', () => {
+        it('exits with code 1 when npm is not available', async () => {
+            const deps = createMockDeps({
+                exec: vi.fn().mockRejectedValue(new Error('npm not found')),
+            });
+            await update(deps);
+            expect(exitSpy).toHaveBeenCalledWith(1);
+            expect(getAllErrorOutput()).toContain('npm is not available');
+        });
+        it('exits with code 1 when cannot check latest version', async () => {
+            const deps = createMockDeps({
+                exec: vi
+                    .fn()
+                    .mockResolvedValueOnce({ stdout: '9.0.0', stderr: '' }) // npm --version
+                    .mockRejectedValueOnce(new Error('Network error')), // npm view
+            });
+            await update(deps);
+            expect(exitSpy).toHaveBeenCalledWith(1);
+            expect(getAllErrorOutput()).toContain('Could not check for latest version');
+        });
+    });
+    describe('success', () => {
+        it('reports already on latest version', async () => {
+            const deps = createMockDeps({
+                getVersion: vi.fn().mockReturnValue('2.0.0'),
+                exec: vi.fn().mockResolvedValue({ stdout: '2.0.0', stderr: '' }),
+            });
+            await update(deps);
+            expect(exitSpy).not.toHaveBeenCalled();
+            expect(getAllLogOutput()).toContain('You already have the latest version');
+        });
+        it('runs update and reports success', async () => {
+            const deps = createMockDeps({
+                getVersion: vi.fn().mockReturnValue('1.0.0'),
+                exec: vi
+                    .fn()
+                    .mockResolvedValueOnce({ stdout: '9.0.0', stderr: '' }) // npm --version
+                    .mockResolvedValueOnce({ stdout: '2.0.0', stderr: '' }) // npm view
+                    .mockResolvedValueOnce({ stdout: 'installed', stderr: '' }), // npm install
+            });
+            await update(deps);
+            expect(exitSpy).not.toHaveBeenCalled();
+            expect(getAllLogOutput()).toContain('Successfully updated chatroom-cli');
+            expect(getAllLogOutput()).toContain('1.0.0');
+            expect(getAllLogOutput()).toContain('2.0.0');
+            expect(deps.exec).toHaveBeenCalledWith('npm install -g chatroom-cli@latest');
+        });
+    });
+    describe('error', () => {
+        it('exits with code 1 when npm install fails', async () => {
+            const deps = createMockDeps({
+                exec: vi
+                    .fn()
+                    .mockResolvedValueOnce({ stdout: '9.0.0', stderr: '' }) // npm --version
+                    .mockResolvedValueOnce({ stdout: '2.0.0', stderr: '' }) // npm view
+                    .mockRejectedValueOnce(new Error('EACCES: permission denied')), // npm install
+            });
+            await update(deps);
+            expect(exitSpy).toHaveBeenCalledWith(1);
+            expect(getAllErrorOutput()).toContain('Update failed');
+            expect(getAllErrorOutput()).toContain('permission denied');
+            expect(getAllErrorOutput()).toContain('sudo npm install');
+        });
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/commands/update/index.test.js.map

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

package/dist/commands/workflow/deps.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Workflow Deps — dependency interfaces for the workflow commands.
+ */
+import type { BackendOps, SessionOps } from '../../infrastructure/deps/index.js';
+export interface WorkflowDeps {
+    backend: BackendOps;
+    session: SessionOps;
+}
+//# sourceMappingURL=deps.d.ts.map

package/dist/commands/workflow/deps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../../../src/commands/workflow/deps.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAEjF,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,UAAU,CAAC;IACpB,OAAO,EAAE,UAAU,CAAC;CACrB"}

package/dist/commands/workflow/deps.js

@@ -0,0 +1,5 @@
+/**
+ * Workflow Deps — dependency interfaces for the workflow commands.
+ */
+export {};
+//# sourceMappingURL=deps.js.map

package/dist/commands/workflow/deps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps.js","sourceRoot":"","sources":["../../../src/commands/workflow/deps.ts"],"names":[],"mappings":"AAAA;;GAEG"}

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

@@ -0,0 +1,73 @@
+/**
+ * Workflow commands for managing structured DAG-based workflows.
+ */
+import type { WorkflowDeps } from './deps.js';
+export type { WorkflowDeps } from './deps.js';
+export interface CreateWorkflowOptions {
+    role: string;
+    workflowKey: string;
+    stdinContent: string;
+}
+export interface SpecifyStepOptions {
+    role: string;
+    workflowKey: string;
+    stepKey: string;
+    assigneeRole: string;
+    stdinContent: string;
+}
+export interface ExecuteWorkflowOptions {
+    role: string;
+    workflowKey: string;
+}
+export interface WorkflowStatusOptions {
+    role: string;
+    workflowKey: string;
+}
+export interface StepCompleteOptions {
+    role: string;
+    workflowKey: string;
+    stepKey: string;
+}
+export interface ExitWorkflowOptions {
+    role: string;
+    workflowKey: string;
+    reason: string;
+}
+export interface ViewStepOptions {
+    role: string;
+    workflowKey: string;
+    stepKey: string;
+}
+/**
+ * Parse multi-section stdin content with markers like ---GOAL---, ---REQUIREMENTS---, ---WARNINGS---
+ */
+export declare function parseSections(input: string, requiredSections: string[], optionalSections: string[]): Map<string, string>;
+/**
+ * Create a new workflow with steps from JSON stdin.
+ */
+export declare function createWorkflow(chatroomId: string, options: CreateWorkflowOptions, deps?: WorkflowDeps): Promise<void>;
+/**
+ * Specify a workflow step with goal, requirements, and optional warnings.
+ */
+export declare function specifyWorkflowStep(chatroomId: string, options: SpecifyStepOptions, deps?: WorkflowDeps): Promise<void>;
+/**
+ * Execute (activate) a draft workflow.
+ */
+export declare function executeWorkflow(chatroomId: string, options: ExecuteWorkflowOptions, deps?: WorkflowDeps): Promise<void>;
+/**
+ * Get and display the full status of a workflow.
+ */
+export declare function getWorkflowStatus(chatroomId: string, options: WorkflowStatusOptions, deps?: WorkflowDeps): Promise<void>;
+/**
+ * Mark a workflow step as completed.
+ */
+export declare function completeStep(chatroomId: string, options: StepCompleteOptions, deps?: WorkflowDeps): Promise<void>;
+/**
+ * Exit (cancel) an entire workflow with a required reason.
+ */
+export declare function exitWorkflow(chatroomId: string, options: ExitWorkflowOptions, deps?: WorkflowDeps): Promise<void>;
+/**
+ * View the full details of a single workflow step.
+ */
+export declare function viewStep(chatroomId: string, options: ViewStepOptions, deps?: WorkflowDeps): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/workflow/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAQ9C,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAW9C,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AA8CD;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,gBAAgB,EAAE,MAAM,EAAE,EAC1B,gBAAgB,EAAE,MAAM,EAAE,GACzB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAwCrB;AAoCD;;GAEG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,qBAAqB,EAC9B,IAAI,CAAC,EAAE,YAAY,GAClB,OAAO,CAAC,IAAI,CAAC,CA6Gf;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,kBAAkB,EAC3B,IAAI,CAAC,EAAE,YAAY,GAClB,OAAO,CAAC,IAAI,CAAC,CAkDf;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,sBAAsB,EAC/B,IAAI,CAAC,EAAE,YAAY,GAClB,OAAO,CAAC,IAAI,CAAC,CAwBf;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,qBAAqB,EAC9B,IAAI,CAAC,EAAE,YAAY,GAClB,OAAO,CAAC,IAAI,CAAC,CAwHf;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,mBAAmB,EAC5B,IAAI,CAAC,EAAE,YAAY,GAClB,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,mBAAmB,EAC5B,IAAI,CAAC,EAAE,YAAY,GAClB,OAAO,CAAC,IAAI,CAAC,CA8Bf;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,eAAe,EACxB,IAAI,CAAC,EAAE,YAAY,GAClB,OAAO,CAAC,IAAI,CAAC,CAgGf"}