@fonz/tgcc 0.0.1 → 0.3.0

package/dist/cc-protocol.d.ts

@@ -0,0 +1,255 @@
+export interface TextContent {
+    type: 'text';
+    text: string;
+}
+export interface ImageContent {
+    type: 'image';
+    source: {
+        type: 'base64';
+        media_type: 'image/png' | 'image/jpeg' | 'image/gif' | 'image/webp';
+        data: string;
+    };
+}
+export type ContentBlock = TextContent | ImageContent;
+export interface UserMessage {
+    type: 'user';
+    message: {
+        role: 'user';
+        content: string | ContentBlock[];
+    };
+    uuid: string;
+}
+export declare function createTextMessage(text: string): UserMessage;
+export declare function createImageMessage(text: string, imageBase64: string, mediaType?: ImageContent['source']['media_type']): UserMessage;
+export declare function createDocumentMessage(text: string, filePath: string, fileName: string): UserMessage;
+export declare function serializeMessage(msg: UserMessage): string;
+export interface ControlRequestInitialize {
+    type: 'control_request';
+    request_id: string;
+    request: {
+        subtype: 'initialize';
+    };
+}
+export interface PermissionRequest {
+    type: 'control_request';
+    request_id: string;
+    request: {
+        subtype: 'can_use_tool';
+        tool_name: string;
+        input: Record<string, unknown>;
+        tool_use_id: string;
+        agent_id?: string;
+        permission_suggestions?: unknown[];
+        blocked_path?: string;
+        decision_reason?: string;
+    };
+}
+export type ControlRequest = ControlRequestInitialize | PermissionRequest;
+export interface ControlResponse {
+    type: 'control_response';
+    request_id?: string;
+    response: {
+        subtype: 'success' | 'error';
+        request_id?: string;
+        response?: {
+            behavior: 'allow' | 'deny';
+            updatedInput?: Record<string, unknown>;
+            message?: string;
+        };
+        error?: string;
+        [key: string]: unknown;
+    };
+}
+export declare function createInitializeRequest(): ControlRequestInitialize;
+export declare function createPermissionResponse(requestId: string, allowed: boolean, updatedInput?: Record<string, unknown>): ControlResponse;
+export interface InitEvent {
+    type: 'system';
+    subtype: 'init';
+    cwd: string;
+    session_id: string;
+    tools: string[];
+    model: string;
+    uuid: string;
+}
+export interface AssistantTextBlock {
+    type: 'text';
+    text: string;
+}
+export interface AssistantToolUseBlock {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+export interface AssistantThinkingBlock {
+    type: 'thinking';
+    thinking: string;
+}
+export type AssistantContentBlock = AssistantTextBlock | AssistantToolUseBlock | AssistantThinkingBlock;
+export interface AssistantMessage {
+    type: 'assistant';
+    message: {
+        model: string;
+        id: string;
+        role: 'assistant';
+        content: AssistantContentBlock[];
+        stop_reason: string | null;
+        usage?: {
+            input_tokens: number;
+            output_tokens: number;
+            cache_read_input_tokens?: number;
+            cache_creation_input_tokens?: number;
+        };
+    };
+    session_id?: string;
+    uuid?: string;
+}
+export interface ToolResultEvent {
+    type: 'tool_result';
+    tool_use_id: string;
+    content: string;
+    /** Rich structured metadata from CC's tool_use_result field (teammate_spawned, etc.) */
+    tool_use_result?: {
+        status?: string;
+        name?: string;
+        agent_id?: string;
+        agent_type?: string;
+        color?: string;
+        team_name?: string;
+        prompt?: string;
+        teammate_id?: string;
+        [key: string]: unknown;
+    };
+}
+export interface ResultEvent {
+    type: 'result';
+    subtype: 'success' | 'error' | 'error_max_turns' | 'error_input';
+    is_error: boolean;
+    duration_ms?: number;
+    duration_api_ms?: number;
+    num_turns?: number;
+    result?: string;
+    session_id?: string;
+    total_cost_usd?: number;
+    usage?: {
+        input_tokens: number;
+        output_tokens: number;
+        cache_read_input_tokens?: number;
+        cache_creation_input_tokens?: number;
+        web_search_requests?: number;
+    };
+    uuid?: string;
+}
+export interface StreamMessageStart {
+    type: 'message_start';
+    message: {
+        model: string;
+        id: string;
+        role: 'assistant';
+        content: unknown[];
+        stop_reason: null;
+        usage: Record<string, number>;
+    };
+}
+export interface StreamContentBlockStartText {
+    type: 'content_block_start';
+    index: number;
+    content_block: {
+        type: 'text';
+        text: string;
+    };
+}
+export interface StreamContentBlockStartThinking {
+    type: 'content_block_start';
+    index: number;
+    content_block: {
+        type: 'thinking';
+        thinking: string;
+    };
+}
+export interface StreamContentBlockStartToolUse {
+    type: 'content_block_start';
+    index: number;
+    content_block: {
+        type: 'tool_use';
+        id: string;
+        name: string;
+        input: Record<string, unknown>;
+    };
+}
+export type StreamContentBlockStart = StreamContentBlockStartText | StreamContentBlockStartThinking | StreamContentBlockStartToolUse;
+export interface StreamTextDelta {
+    type: 'content_block_delta';
+    index: number;
+    delta: {
+        type: 'text_delta';
+        text: string;
+    };
+}
+export interface StreamThinkingDelta {
+    type: 'content_block_delta';
+    index: number;
+    delta: {
+        type: 'thinking_delta';
+        thinking: string;
+    };
+}
+export interface StreamInputJsonDelta {
+    type: 'content_block_delta';
+    index: number;
+    delta: {
+        type: 'input_json_delta';
+        partial_json: string;
+    };
+}
+export type StreamContentBlockDelta = StreamTextDelta | StreamThinkingDelta | StreamInputJsonDelta;
+export interface StreamContentBlockStop {
+    type: 'content_block_stop';
+    index: number;
+}
+export interface StreamMessageStop {
+    type: 'message_stop';
+}
+export type StreamInnerEvent = StreamMessageStart | StreamContentBlockStart | StreamContentBlockDelta | StreamContentBlockStop | StreamMessageStop;
+export interface StreamEvent {
+    type: 'stream_event';
+    event: StreamInnerEvent;
+}
+export interface ApiErrorEvent {
+    type: 'system';
+    subtype: 'api_error';
+    level: 'error';
+    error: {
+        message?: string;
+        status?: number;
+        [key: string]: unknown;
+    };
+    retryInMs?: number;
+    retryAttempt?: number;
+    maxRetries?: number;
+    timestamp?: string;
+    uuid?: string;
+}
+/** User output message — wraps tool_result content blocks (sub-agent results). */
+export interface UserOutputMessage {
+    type: 'user';
+    message: {
+        role: 'user';
+        content: Array<{
+            type: string;
+            tool_use_id?: string;
+            content?: string | Array<{
+                type: string;
+                text?: string;
+            }>;
+            is_error?: boolean;
+        }>;
+    };
+}
+export type CCOutputEvent = InitEvent | AssistantMessage | UserOutputMessage | ToolResultEvent | ResultEvent | StreamEvent | ControlResponse | ApiErrorEvent | PermissionRequest;
+export declare function parseCCOutputLine(line: string): CCOutputEvent | null;
+export declare function extractAssistantText(msg: AssistantMessage): string;
+export declare function extractToolUses(msg: AssistantMessage): AssistantToolUseBlock[];
+export declare function isStreamTextDelta(event: StreamInnerEvent): event is StreamTextDelta;
+export declare function isStreamThinkingDelta(event: StreamInnerEvent): event is StreamThinkingDelta;
+export declare function getStreamBlockType(event: StreamInnerEvent): string | null;

package/dist/cc-protocol.js

@@ -0,0 +1,109 @@
+import { v4 as uuidv4 } from 'uuid';
+export function createTextMessage(text) {
+    return {
+        type: 'user',
+        message: { role: 'user', content: text },
+        uuid: uuidv4(),
+    };
+}
+export function createImageMessage(text, imageBase64, mediaType = 'image/jpeg') {
+    const content = [
+        { type: 'text', text },
+        { type: 'image', source: { type: 'base64', media_type: mediaType, data: imageBase64 } },
+    ];
+    return {
+        type: 'user',
+        message: { role: 'user', content },
+        uuid: uuidv4(),
+    };
+}
+export function createDocumentMessage(text, filePath, fileName) {
+    const content = `${text}\n\nUser sent a document: ${filePath} (${fileName}). Read and process it.`;
+    return createTextMessage(content);
+}
+export function serializeMessage(msg) {
+    return JSON.stringify(msg);
+}
+export function createInitializeRequest() {
+    return {
+        type: 'control_request',
+        request_id: uuidv4(),
+        request: { subtype: 'initialize' },
+    };
+}
+export function createPermissionResponse(requestId, allowed, updatedInput) {
+    if (allowed) {
+        return {
+            type: 'control_response',
+            response: {
+                subtype: 'success',
+                request_id: requestId,
+                response: {
+                    behavior: 'allow',
+                    updatedInput,
+                },
+            },
+        };
+    }
+    return {
+        type: 'control_response',
+        response: {
+            subtype: 'success',
+            request_id: requestId,
+            response: {
+                behavior: 'deny',
+                message: 'Denied by user via Telegram',
+            },
+        },
+    };
+}
+// ── Parser ──
+export function parseCCOutputLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return null;
+    try {
+        const parsed = JSON.parse(trimmed);
+        if (!parsed || typeof parsed.type !== 'string')
+            return null;
+        switch (parsed.type) {
+            case 'system':
+            case 'assistant':
+            case 'user':
+            case 'tool_result':
+            case 'result':
+            case 'stream_event':
+            case 'control_response':
+            case 'control_request':
+                return parsed;
+            default:
+                return null;
+        }
+    }
+    catch {
+        return null;
+    }
+}
+// ── Helpers for extracting text from assistant messages ──
+export function extractAssistantText(msg) {
+    return msg.message.content
+        .filter((b) => b.type === 'text')
+        .map(b => b.text)
+        .join('');
+}
+export function extractToolUses(msg) {
+    return msg.message.content.filter((b) => b.type === 'tool_use');
+}
+export function isStreamTextDelta(event) {
+    return event.type === 'content_block_delta' && event.delta?.type === 'text_delta';
+}
+export function isStreamThinkingDelta(event) {
+    return event.type === 'content_block_delta' && event.delta?.type === 'thinking_delta';
+}
+export function getStreamBlockType(event) {
+    if (event.type === 'content_block_start') {
+        return event.content_block.type;
+    }
+    return null;
+}
+//# sourceMappingURL=cc-protocol.js.map

package/dist/cc-protocol.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};