chatroom-cli 1.31.1 → 1.33.0

package/dist/commands/report-progress/index.test.js.map

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

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

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

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

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

package/dist/commands/skill/deps.js

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

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

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

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

@@ -0,0 +1,20 @@
+/**
+ * Skill commands — list and activate chatroom skills.
+ */
+import type { SkillDeps } from './deps.js';
+export type { SkillDeps } from './deps.js';
+export interface ListSkillsOptions {
+    role: string;
+}
+export interface ActivateSkillOptions {
+    role: string;
+}
+/**
+ * List all enabled skills for a chatroom.
+ */
+export declare function listSkills(chatroomId: string, options: ListSkillsOptions, deps?: SkillDeps): Promise<void>;
+/**
+ * Activate a named skill in the chatroom, creating a pending task with the skill's prompt.
+ */
+export declare function activateSkill(chatroomId: string, skillId: string, options: ActivateSkillOptions, deps?: SkillDeps): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/skill/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAQ3C,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAI3C,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;CACd;AAgCD;;GAEG;AACH,wBAAsB,UAAU,CAC9B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,iBAAiB,EAC1B,IAAI,CAAC,EAAE,SAAS,GACf,OAAO,CAAC,IAAI,CAAC,CAgCf;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,oBAAoB,EAC7B,IAAI,CAAC,EAAE,SAAS,GACf,OAAO,CAAC,IAAI,CAAC,CAuBf"}

package/dist/commands/skill/index.js

@@ -0,0 +1,86 @@
+/**
+ * Skill commands — list and activate chatroom skills.
+ */
+import { api } from '../../api.js';
+import { getSessionId, getOtherSessionUrls } from '../../infrastructure/auth/storage.js';
+import { getConvexClient, getConvexUrl } from '../../infrastructure/convex/client.js';
+import { getErrorMessage } from '../../utils/convex-error.js';
+// ─── Default Deps Factory ──────────────────────────────────────────────────
+async function createDefaultDeps() {
+    const client = await getConvexClient();
+    return {
+        backend: {
+            mutation: (endpoint, args) => client.mutation(endpoint, args),
+            query: (endpoint, args) => client.query(endpoint, args),
+        },
+        session: {
+            getSessionId,
+            getConvexUrl,
+            getOtherSessionUrls,
+        },
+    };
+}
+// ─── Auth Helper ───────────────────────────────────────────────────────────
+function requireAuth(d) {
+    const sessionId = d.session.getSessionId();
+    if (!sessionId) {
+        console.error(`❌ Not authenticated. Please run: chatroom auth login`);
+        process.exit(1);
+    }
+    return sessionId;
+}
+// ─── Commands ──────────────────────────────────────────────────────────────
+/**
+ * List all enabled skills for a chatroom.
+ */
+export async function listSkills(chatroomId, options, deps) {
+    const d = deps ?? (await createDefaultDeps());
+    const sessionId = requireAuth(d);
+    try {
+        const skills = await d.backend.query(api.skills.list, {
+            sessionId,
+            chatroomId: chatroomId,
+        });
+        if (!skills || skills.length === 0) {
+            console.log('No skills available.');
+            return;
+        }
+        // Calculate column width for aligned output
+        const maxSkillIdLen = Math.max(...skills.map((s) => s.skillId.length));
+        console.log('Available skills:');
+        for (const skill of skills) {
+            const padded = skill.skillId.padEnd(maxSkillIdLen);
+            console.log(`  ${padded}  ${skill.description}`);
+        }
+    }
+    catch (error) {
+        console.error(`❌ Failed to list skills: ${getErrorMessage(error)}`);
+        process.exit(1);
+    }
+}
+/**
+ * Activate a named skill in the chatroom, creating a pending task with the skill's prompt.
+ */
+export async function activateSkill(chatroomId, skillId, options, deps) {
+    const d = deps ?? (await createDefaultDeps());
+    const sessionId = requireAuth(d);
+    try {
+        const convexUrl = d.session.getConvexUrl();
+        const result = await d.backend.mutation(api.skills.activate, {
+            sessionId,
+            chatroomId: chatroomId,
+            skillId,
+            role: options.role,
+            convexUrl: convexUrl ?? undefined,
+        });
+        console.log('');
+        console.log(`✅ Skill "${result.skill.skillId}" activated.`);
+        console.log(`   The agent will now: ${result.skill.description}`);
+        console.log('');
+    }
+    catch (error) {
+        console.error(`❌ Failed to activate skill: ${getErrorMessage(error)}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * skill command Unit Tests
+ *
+ * Tests the skill commands using injected dependencies.
+ * Does NOT make real network calls — all backend ops are mocked.
+ */
+export {};
+//# sourceMappingURL=index.test.d.ts.map

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

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

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

@@ -0,0 +1,166 @@
+/**
+ * skill command Unit Tests
+ *
+ * Tests the skill commands using injected dependencies.
+ * Does NOT make real network calls — all backend ops are mocked.
+ */
+import { ConvexError } from 'convex/values';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { activateSkill, listSkills } from './index.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+const TEST_CHATROOM_ID = 'test_chatroom_id_12345678';
+const TEST_SESSION_ID = 'test-session-id';
+function createMockDeps(overrides) {
+    return {
+        backend: {
+            mutation: vi.fn().mockResolvedValue({}),
+            query: vi.fn().mockResolvedValue([]),
+        },
+        session: {
+            getSessionId: vi.fn().mockReturnValue(TEST_SESSION_ID),
+            getConvexUrl: vi.fn().mockReturnValue('http://test:3210'),
+            getOtherSessionUrls: vi.fn().mockReturnValue([]),
+        },
+        ...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');
+}
+// ---------------------------------------------------------------------------
+// listSkills tests
+// ---------------------------------------------------------------------------
+describe('listSkills', () => {
+    it('exits with code 1 when not authenticated', async () => {
+        const deps = createMockDeps({
+            session: {
+                getSessionId: vi.fn().mockReturnValue(null),
+                getConvexUrl: vi.fn().mockReturnValue('http://test:3210'),
+                getOtherSessionUrls: vi.fn().mockReturnValue([]),
+            },
+        });
+        await listSkills(TEST_CHATROOM_ID, { role: 'builder' }, deps);
+        expect(exitSpy).toHaveBeenCalledWith(1);
+        expect(getAllErrorOutput()).toContain('Not authenticated');
+    });
+    it('prints "No skills available." when the query returns empty array', async () => {
+        const deps = createMockDeps();
+        deps.backend.query.mockResolvedValue([]);
+        await listSkills(TEST_CHATROOM_ID, { role: 'builder' }, deps);
+        expect(exitSpy).not.toHaveBeenCalled();
+        expect(getAllLogOutput()).toContain('No skills available.');
+    });
+    it('prints aligned skill list when skills are returned', async () => {
+        const deps = createMockDeps();
+        deps.backend.query.mockResolvedValue([
+            {
+                skillId: 'backlog',
+                name: 'Score Backlog',
+                description: 'Score all unscored backlog items by complexity, value, and priority.',
+                type: 'builtin',
+            },
+        ]);
+        await listSkills(TEST_CHATROOM_ID, { role: 'builder' }, deps);
+        expect(exitSpy).not.toHaveBeenCalled();
+        const output = getAllLogOutput();
+        expect(output).toContain('backlog');
+        expect(output).toContain('Score all unscored backlog items by complexity, value, and priority.');
+        expect(output).toContain('Available skills:');
+    });
+    it('exits with code 1 when query throws a generic error', async () => {
+        const deps = createMockDeps();
+        deps.backend.query.mockRejectedValue(new Error('Network error'));
+        await listSkills(TEST_CHATROOM_ID, { role: 'builder' }, deps);
+        expect(exitSpy).toHaveBeenCalledWith(1);
+        expect(getAllErrorOutput()).toContain('Network error');
+    });
+});
+// ---------------------------------------------------------------------------
+// activateSkill tests
+// ---------------------------------------------------------------------------
+describe('activateSkill', () => {
+    it('exits with code 1 when not authenticated', async () => {
+        const deps = createMockDeps({
+            session: {
+                getSessionId: vi.fn().mockReturnValue(null),
+                getConvexUrl: vi.fn().mockReturnValue('http://test:3210'),
+                getOtherSessionUrls: vi.fn().mockReturnValue([]),
+            },
+        });
+        await activateSkill(TEST_CHATROOM_ID, 'backlog', { role: 'builder' }, deps);
+        expect(exitSpy).toHaveBeenCalledWith(1);
+        expect(getAllErrorOutput()).toContain('Not authenticated');
+    });
+    it('prints success message when activation succeeds', async () => {
+        const deps = createMockDeps();
+        deps.backend.mutation.mockResolvedValue({
+            success: true,
+            skill: {
+                skillId: 'backlog',
+                name: 'Score Backlog',
+                description: 'Score all unscored backlog items.',
+            },
+        });
+        await activateSkill(TEST_CHATROOM_ID, 'backlog', { role: 'builder' }, deps);
+        expect(exitSpy).not.toHaveBeenCalled();
+        const output = getAllLogOutput();
+        expect(output).toContain('✅ Skill "backlog" activated.');
+        expect(output).toContain('Score all unscored backlog items.');
+    });
+    it('exits with code 1 and prints error message when skill not found (ConvexError)', async () => {
+        const deps = createMockDeps();
+        deps.backend.mutation.mockRejectedValue(new ConvexError('Skill "bad-skill" not found or is disabled.'));
+        await activateSkill(TEST_CHATROOM_ID, 'bad-skill', { role: 'builder' }, deps);
+        expect(exitSpy).toHaveBeenCalledWith(1);
+        const errorOutput = getAllErrorOutput();
+        expect(errorOutput).toContain('not found or is disabled');
+    });
+    it('exits with code 1 when mutation throws a generic error', async () => {
+        const deps = createMockDeps();
+        deps.backend.mutation.mockRejectedValue(new Error('Connection refused'));
+        await activateSkill(TEST_CHATROOM_ID, 'backlog', { role: 'builder' }, deps);
+        expect(exitSpy).toHaveBeenCalledWith(1);
+        const errorOutput = getAllErrorOutput();
+        expect(errorOutput).toContain('Connection refused');
+    });
+    it('calls mutation with the correct arguments', async () => {
+        const deps = createMockDeps();
+        deps.backend.mutation.mockResolvedValue({
+            success: true,
+            skill: {
+                skillId: 'backlog',
+                name: 'Score Backlog',
+                description: 'Score all unscored backlog items.',
+            },
+        });
+        await activateSkill(TEST_CHATROOM_ID, 'backlog', { role: 'planner' }, deps);
+        expect(deps.backend.mutation).toHaveBeenCalledWith(expect.anything(), // api.skills.activate
+        expect.objectContaining({
+            sessionId: TEST_SESSION_ID,
+            chatroomId: TEST_CHATROOM_ID,
+            skillId: 'backlog',
+            role: 'planner',
+            convexUrl: 'http://test:3210',
+        }));
+    });
+});
+//# sourceMappingURL=index.test.js.map

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

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

package/dist/commands/task/read/deps.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Task Read Deps — dependency interfaces for the task read command.
+ *
+ * Applies interface segregation: the command declares exactly which
+ * dependencies it needs, so tests only mock what's relevant.
+ */
+import type { BackendOps, SessionOps } from '../../../infrastructure/deps/index.js';
+/**
+ * All external dependencies for the task read command.
+ *
+ * - `backend`: Convex client for mutations
+ * - `session`: Authentication and session retrieval
+ */
+export interface TaskReadDeps {
+    backend: BackendOps;
+    session: SessionOps;
+}
+//# sourceMappingURL=deps.d.ts.map

package/dist/commands/task/read/deps.d.ts.map

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

package/dist/commands/task/read/deps.js

@@ -0,0 +1,8 @@
+/**
+ * Task Read Deps — dependency interfaces for the task read command.
+ *
+ * Applies interface segregation: the command declares exactly which
+ * dependencies it needs, so tests only mock what's relevant.
+ */
+export {};
+//# sourceMappingURL=deps.js.map

package/dist/commands/task/read/deps.js.map

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

package/dist/commands/task/read/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Read a task and mark it as in_progress
+ *
+ * This command is the primary way to transition a task from acknowledged →in_progress.
+ * It calls the backend readTask mutation which atomically:
+ * 1. Validates the task exists and is assigned to the caller's role
+ * 2. Transitions the task to in_progress
+ * 3. Returns the task content
+ */
+import type { TaskReadDeps } from './deps.js';
+export type { TaskReadDeps } from './deps.js';
+export interface TaskReadOptions {
+    role: string;
+    taskId: string;
+}
+export declare function taskRead(chatroomId: string, options: TaskReadOptions, deps?: TaskReadDeps): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/task/read/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/task/read/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAQ9C,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAI9C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAqBD,wBAAsB,QAAQ,CAC5B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,eAAe,EACxB,IAAI,CAAC,EAAE,YAAY,GAClB,OAAO,CAAC,IAAI,CAAC,CA2If"}

package/dist/commands/task/read/index.js

@@ -0,0 +1,144 @@
+/**
+ * Read a task and mark it as in_progress
+ *
+ * This command is the primary way to transition a task from acknowledged →in_progress.
+ * It calls the backend readTask mutation which atomically:
+ * 1. Validates the task exists and is assigned to the caller's role
+ * 2. Transitions the task to in_progress
+ * 3. Returns the task content
+ */
+import { api } from '../../../api.js';
+import { getSessionId, getOtherSessionUrls } from '../../../infrastructure/auth/storage.js';
+import { getConvexClient, getConvexUrl } from '../../../infrastructure/convex/client.js';
+// ─── Default Deps Factory ───────────────────────────────────────────────────
+async function createDefaultDeps() {
+    const client = await getConvexClient();
+    return {
+        backend: {
+            mutation: (endpoint, args) => client.mutation(endpoint, args),
+            query: (endpoint, args) => client.query(endpoint, args),
+        },
+        session: {
+            getSessionId,
+            getConvexUrl,
+            getOtherSessionUrls,
+        },
+    };
+}
+// ─── Entry Point ───────────────────────────────────────── ──────────────────
+export async function taskRead(chatroomId, options, deps) {
+    const d = deps ?? (await createDefaultDeps());
+    const { role, taskId } = options;
+    // Get Convex URL for error messages
+    const convexUrl = d.session.getConvexUrl();
+    // Get session ID for authentication
+    const sessionId = d.session.getSessionId();
+    if (!sessionId) {
+        const otherUrls = d.session.getOtherSessionUrls();
+        console.error(`❌ Not authenticated for: ${convexUrl}`);
+        if (otherUrls.length > 0) {
+            console.error(`\n💡 You have sessions for other environments:`);
+            for (const url of otherUrls) {
+                console.error(`   • ${url}`);
+            }
+            console.error(`\n   To use a different environment, set CHATROOM_CONVEX_URL:`);
+            console.error(`   CHATROOM_CONVEX_URL=${otherUrls[0]} chatroom task read ...`);
+            console.error(`\n   Or to authenticate for the current environment:`);
+        }
+        console.error(`   chatroom auth login`);
+        process.exit(1);
+    }
+    // Validate chatroomId format
+    if (!chatroomId ||
+        typeof chatroomId !== 'string' ||
+        chatroomId.length < 20 ||
+        chatroomId.length > 40) {
+        console.error(`❌ Invalid chatroom ID format: ID must be 20-40 characters (got ${chatroomId?.length || 0})`);
+        process.exit(1);
+    }
+    // Validate taskId format
+    if (!taskId || typeof taskId !== 'string' || taskId.length < 20 || taskId.length > 40) {
+        console.error(`❌ Invalid task ID format: ID must be 20-40 characters (got ${taskId?.length || 0})`);
+        process.exit(1);
+    }
+    // Call the readTask mutation
+    try {
+        const result = await d.backend.mutation(api.tasks.readTask, {
+            sessionId,
+            chatroomId: chatroomId,
+            role,
+            taskId: taskId,
+        });
+        // Success - display the task content
+        console.log(`✅ Task content:`);
+        console.log(`   Task ID: ${result.taskId}`);
+        console.log(`   Status: ${result.status}`);
+        // Display pinned context if available
+        if (result.context) {
+            console.log('');
+            console.log('PINNED CONTEXT');
+            console.log('---');
+            console.log('<context>');
+            console.log(result.context.content);
+            console.log('</context>');
+            if (result.context.triggerMessageContent) {
+                console.log('in response to');
+                const senderTag = result.context.triggerMessageSenderRole ?? 'unknown';
+                console.log(`<${senderTag}-message>`);
+                console.log(result.context.triggerMessageContent);
+                console.log(`</${senderTag}-message>`);
+            }
+            // Staleness notice
+            const hoursAgo = Math.round(result.context.elapsedHours);
+            const msgsSince = result.context.messagesSinceContext;
+            const isStale = hoursAgo >= 24 || msgsSince >= 50;
+            if (isStale) {
+                const ageLabel = hoursAgo >= 48
+                    ? `${Math.round(hoursAgo / 24)}d old`
+                    : hoursAgo >= 24
+                        ? `${hoursAgo}h old`
+                        : `${msgsSince} messages old`;
+                console.log(`<system-notice>`);
+                console.log(`⚠️ Context is ${ageLabel}.`);
+                console.log(`   Entry point role will update when needed.`);
+                console.log(`</system-notice>`);
+            }
+            console.log('---');
+        }
+        console.log(`\n${result.content}`);
+        // Display attached backlog items as XML attachments
+        if (result.attachedBacklogItems && result.attachedBacklogItems.length > 0) {
+            console.log('');
+            console.log('<attachments>');
+            for (const item of result.attachedBacklogItems) {
+                console.log(`  <attachment type="backlog-item">`);
+                console.log(`    - [${item.status.toUpperCase()}] ${item.content}`);
+                console.log(`      ID: ${item._id}`);
+                console.log(`    <hint>`);
+                console.log(`      If you have completed work on a backlog item and it is ready for review, run:`);
+                console.log(`        chatroom backlog mark-for-review --chatroom-id="${chatroomId}" --role="${role}" --backlog-item-id=${item._id}`);
+                console.log(`    </hint>`);
+                console.log(`  </attachment>`);
+            }
+            console.log('</attachments>');
+        }
+    }
+    catch (error) {
+        const err = error;
+        console.error(`❌ Failed to read task`);
+        console.error(`   Error: ${err.message}`);
+        // Provide helpful hints for common errors
+        if (err.message.includes('not found')) {
+            console.error(`\n   Verify the task ID is correct and you have access to this chatroom.`);
+        }
+        else if (err.message.includes('assigned to')) {
+            console.error(`\n   This task is not assigned to your role. Use the correct --role flag.`);
+        }
+        else if (err.message.includes('acknowledged')) {
+            console.error(`\n   Tasks must be in 'acknowledged' status to be read.`);
+            console.error(`   If this task is already in_progress, this might be a recovery situation.`);
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/task/read/index.js.map

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

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

@@ -0,0 +1,13 @@
+/**
+ * Telegram Deps — dependency interfaces for the telegram commands.
+ */
+import type { SessionOps } from '../../infrastructure/deps/index.js';
+export interface TelegramBackendOps {
+    /** Call a Convex action */
+    action: (endpoint: any, args: any) => Promise<any>;
+}
+export interface TelegramDeps {
+    backend: TelegramBackendOps;
+    session: SessionOps;
+}
+//# sourceMappingURL=deps.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../../../src/commands/telegram/deps.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAErE,MAAM,WAAW,kBAAkB;IACjC,2BAA2B;IAE3B,MAAM,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,kBAAkB,CAAC;IAC5B,OAAO,EAAE,UAAU,CAAC;CACrB"}

package/dist/commands/telegram/deps.js

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

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

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

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

@@ -0,0 +1,18 @@
+/**
+ * Telegram CLI Commands — send messages to Telegram via chatroom integrations.
+ *
+ * Allows agents to push messages to connected Telegram chats.
+ */
+import type { TelegramDeps } from './deps.js';
+export type { TelegramDeps } from './deps.js';
+export interface TelegramSendMessageOptions {
+    chatroomId: string;
+    integrationId: string;
+    message: string;
+    role?: string;
+}
+/**
+ * Send a message to a connected Telegram integration for a chatroom.
+ */
+export declare function sendMessage(options: TelegramSendMessageOptions, deps?: TelegramDeps): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/telegram/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAa9C,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAI9C,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAoBD;;GAEG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,0BAA0B,EACnC,IAAI,CAAC,EAAE,YAAY,GAClB,OAAO,CAAC,IAAI,CAAC,CA0Ef"}