@shuyhere/takotako 0.0.1

package/dist/core/streaming.js

@@ -0,0 +1,264 @@
+/**
+ * Response streaming — deliver model output in chunks as it's generated.
+ *
+ * Instead of waiting for the full response, stream text chunks to the
+ * channel in real-time. Handles:
+ * - Chunk buffering (don't send every token, batch ~50-100 chars)
+ * - Channel-specific chunk delivery (Discord edits, Telegram edits, CLI stdout)
+ * - Tool call handling (pause streaming during tool execution)
+ * - Markdown boundary detection (don't split mid-codeblock)
+ */
+const DEFAULT_STREAM_CONFIG = {
+    enabled: true,
+    minChunkSize: 200,
+    flushIntervalMs: 1000,
+    maxMessageLength: 2000,
+};
+// ─── ResponseStreamer ───────────────────────────────────────────────
+/**
+ * Buffers streaming text and delivers it to a channel in chunks.
+ *
+ * For channels that support `editMessage` (Discord, Telegram), the streamer
+ * sends an initial message then edits it as more text arrives. When the
+ * message exceeds `maxMessageLength`, it sends a new message and continues.
+ *
+ * For channels without edit support (CLI), text is written incrementally
+ * via `send()`.
+ */
+export class ResponseStreamer {
+    config;
+    context;
+    buffer = '';
+    sentMessageId;
+    totalSent = '';
+    flushTimer;
+    finished = false;
+    constructor(config, context) {
+        this.config = { ...DEFAULT_STREAM_CONFIG, ...config };
+        this.context = context;
+        if (context.messageId) {
+            this.sentMessageId = context.messageId;
+        }
+    }
+    /** Add text to the stream buffer. May trigger a flush. */
+    async push(text) {
+        if (this.finished)
+            return;
+        this.buffer += text;
+        if (this.shouldFlush()) {
+            await this.flush();
+        }
+        else if (!this.flushTimer) {
+            this.flushTimer = setTimeout(() => {
+                this.flushTimer = undefined;
+                if (this.buffer.length > 0 && !this.finished) {
+                    this.flush().catch((err) => {
+                        console.warn('[streaming] Timer flush error:', err instanceof Error ? err.message : err);
+                    });
+                }
+            }, this.config.flushIntervalMs);
+        }
+    }
+    /** Force flush remaining buffer (call at end of response). */
+    async finish() {
+        if (this.finished)
+            return;
+        this.finished = true;
+        this.clearTimer();
+        if (this.buffer.length > 0) {
+            await this.flush();
+        }
+    }
+    /** Cancel streaming (e.g., on error). */
+    async cancel() {
+        this.finished = true;
+        this.clearTimer();
+        this.buffer = '';
+    }
+    /** Get total characters streamed so far. */
+    get length() {
+        return this.totalSent.length + this.buffer.length;
+    }
+    // ─── Private ────────────────────────────────────────────────────
+    clearTimer() {
+        if (this.flushTimer) {
+            clearTimeout(this.flushTimer);
+            this.flushTimer = undefined;
+        }
+    }
+    shouldFlush() {
+        return this.buffer.length >= this.config.minChunkSize;
+    }
+    /**
+     * Flush the buffer to the channel.
+     *
+     * Strategy depends on channel capabilities:
+     * - If channel has editMessage + sendAndGetId: edit-in-place, split on overflow
+     * - Otherwise: send incremental chunks via send()
+     */
+    async flush() {
+        if (this.buffer.length === 0)
+            return;
+        this.clearTimer();
+        const { channel, channelId } = this.context;
+        // Determine how much to flush — find a safe breakpoint
+        const breakAt = this.findSafeBreakpoint(this.buffer);
+        if (breakAt === 0) {
+            // Safe breakpoint says "don't flush yet" (unclosed markdown formatting)
+            // Re-arm the timer to try again later
+            if (!this.flushTimer && !this.finished) {
+                this.flushTimer = setTimeout(() => {
+                    this.flushTimer = undefined;
+                    if (this.buffer.length > 0 && !this.finished) {
+                        this.flush().catch(() => { });
+                    }
+                }, this.config.flushIntervalMs);
+            }
+            return;
+        }
+        const toFlush = this.buffer.slice(0, breakAt);
+        this.buffer = this.buffer.slice(breakAt);
+        if (channel.editMessage && channel.sendAndGetId) {
+            // Edit-in-place strategy — channel has both methods (narrowed by guard above)
+            await this.flushWithEdit(toFlush, channelId, channel);
+        }
+        else {
+            // Incremental send strategy (CLI-style)
+            await channel.send({ target: channelId, content: toFlush });
+            this.totalSent += toFlush;
+        }
+    }
+    /** Flush using edit-in-place (Discord/Telegram style). */
+    async flushWithEdit(text, channelId, channel) {
+        const candidate = this.totalSent + text;
+        if (candidate.length <= this.config.maxMessageLength) {
+            // Still fits in current message — edit or send initial
+            if (this.sentMessageId) {
+                await channel.editMessage(channelId, this.sentMessageId, candidate);
+            }
+            else {
+                const msg = { target: channelId, content: candidate };
+                this.sentMessageId = await channel.sendAndGetId(msg);
+            }
+            this.totalSent = candidate;
+        }
+        else {
+            // Overflow — finalize current message, start a new one
+            // First, fill current message to capacity if we haven't sent yet
+            if (!this.sentMessageId) {
+                const first = candidate.slice(0, this.config.maxMessageLength);
+                const msg = { target: channelId, content: first };
+                this.sentMessageId = await channel.sendAndGetId(msg);
+                this.totalSent = first;
+                // Put the overflow back in the buffer
+                this.buffer = candidate.slice(this.config.maxMessageLength) + this.buffer;
+            }
+            else {
+                // Edit current message to its final state (up to maxMessageLength)
+                const currentCapacity = this.config.maxMessageLength - this.totalSent.length;
+                if (currentCapacity > 0) {
+                    const fitText = text.slice(0, currentCapacity);
+                    const finalContent = this.totalSent + fitText;
+                    await channel.editMessage(channelId, this.sentMessageId, finalContent);
+                    // Remaining text goes into a new message
+                    const overflow = text.slice(currentCapacity);
+                    this.totalSent = '';
+                    this.sentMessageId = undefined;
+                    if (overflow.length > 0) {
+                        this.buffer = overflow + this.buffer;
+                    }
+                }
+                else {
+                    // Current message is full — start fresh
+                    this.totalSent = '';
+                    this.sentMessageId = undefined;
+                    this.buffer = text + this.buffer;
+                }
+            }
+        }
+    }
+    /**
+     * Find a safe position to break the text at, avoiding splits inside:
+     * - Fenced code blocks (```)
+     * - Markdown formatting (**bold**, *italic*, __underline__, ~~strike~~)
+     * - Bullet points / list items
+     * - Mid-word
+     *
+     * Returns the index to break at (exclusive).
+     */
+    findSafeBreakpoint(text) {
+        // If the entire buffer is small enough, take it all
+        if (text.length <= this.config.minChunkSize * 2) {
+            return text.length;
+        }
+        // Don't split inside a fenced code block
+        const codeBlockPattern = /```/g;
+        let match;
+        let openCount = 0;
+        let lastOpenPos = -1;
+        while ((match = codeBlockPattern.exec(text)) !== null) {
+            if (openCount % 2 === 0) {
+                lastOpenPos = match.index;
+            }
+            openCount++;
+        }
+        // If we have an unclosed code block, break before it opens
+        if (openCount % 2 !== 0 && lastOpenPos > this.config.minChunkSize) {
+            return lastOpenPos;
+        }
+        // Don't split inside markdown formatting markers
+        // Count ** and * to check if we're mid-bold/italic
+        const hasUnclosedBold = (text.match(/\*\*/g)?.length ?? 0) % 2 !== 0;
+        const hasUnclosedItalic = (text.match(/(?<!\*)\*(?!\*)/g)?.length ?? 0) % 2 !== 0;
+        const hasUnclosedStrike = (text.match(/~~/g)?.length ?? 0) % 2 !== 0;
+        const hasUnclosedUnderline = (text.match(/__/g)?.length ?? 0) % 2 !== 0;
+        if (hasUnclosedBold || hasUnclosedItalic || hasUnclosedStrike || hasUnclosedUnderline) {
+            // Find the last complete markdown section (break at a double newline or paragraph)
+            const lastParagraph = text.lastIndexOf('\n\n');
+            if (lastParagraph > this.config.minChunkSize) {
+                return lastParagraph + 2;
+            }
+            // Otherwise don't flush yet — wait for more text to close the formatting
+            if (text.length < this.config.maxMessageLength) {
+                return 0; // signal: don't flush yet
+            }
+        }
+        // Try to break at a double newline (paragraph boundary — safest)
+        const lastParagraph = text.lastIndexOf('\n\n');
+        if (lastParagraph > this.config.minChunkSize) {
+            return lastParagraph + 2;
+        }
+        // Try to break at a newline (but not mid-list-item)
+        // Find the last newline that isn't followed by a continuation (bullet, space, etc.)
+        for (let i = text.length - 1; i >= this.config.minChunkSize; i--) {
+            if (text[i] === '\n') {
+                // Check if the next line starts a new block (not a continuation)
+                const nextChar = text[i + 1];
+                if (nextChar === '\n' || nextChar === '#' || nextChar === '-' || nextChar === '*' ||
+                    nextChar === '|' || nextChar === '>' || nextChar === undefined) {
+                    return i + 1;
+                }
+            }
+        }
+        // Try any newline
+        const lastNewline = text.lastIndexOf('\n');
+        if (lastNewline > this.config.minChunkSize) {
+            return lastNewline + 1;
+        }
+        // Try to break at a sentence boundary (. or ! or ? followed by space)
+        for (let i = text.length - 1; i >= this.config.minChunkSize; i--) {
+            if ((text[i] === '.' || text[i] === '!' || text[i] === '?') &&
+                (text[i + 1] === ' ' || text[i + 1] === '\n' || i === text.length - 1)) {
+                return i + 1;
+            }
+        }
+        // Try to break at a space
+        const lastSpace = text.lastIndexOf(' ');
+        if (lastSpace > this.config.minChunkSize) {
+            return lastSpace + 1;
+        }
+        // Take everything
+        return text.length;
+    }
+}
+//# sourceMappingURL=streaming.js.map

package/dist/core/streaming.js.map

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

package/dist/core/symphony/orchestrator.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Symphony Orchestrator — polls GitHub issues and dispatches agent workers.
+ *
+ * Implements the core Symphony loop:
+ * 1. Poll → Reconcile → Dispatch → Monitor
+ *
+ * State is in-memory (no database required). Recovery is tracker-driven.
+ */
+import type { SymphonyConfig, GitHubIssue, OrchestratorState } from './types.js';
+export declare class SymphonyOrchestrator {
+    private config;
+    private state;
+    private workspace;
+    private workflowLoader;
+    private workflow;
+    private pollTimer;
+    private processes;
+    private historyDir;
+    private constructor();
+    /** Get or create the singleton orchestrator. */
+    static getInstance(config?: SymphonyConfig): SymphonyOrchestrator | null;
+    /** Destroy the singleton (for testing or shutdown). */
+    static destroyInstance(): void;
+    /** Apply WORKFLOW.md config to the runtime config. */
+    private applyWorkflowConfig;
+    /** Start the polling loop. */
+    start(): void;
+    /** Stop polling, kill all agents. */
+    stop(): void;
+    /** Whether the orchestrator is currently running. */
+    isRunning(): boolean;
+    /** Get current state for dashboard. */
+    getState(): OrchestratorState;
+    /** Get current config. */
+    getConfig(): SymphonyConfig;
+    /** One poll cycle: reconcile → fetch → dispatch. */
+    pollTick(): Promise<void>;
+    /** Check running agents, detect stalls, update states. */
+    reconcile(): Promise<void>;
+    /** Fetch candidate issues from GitHub. */
+    fetchCandidateIssues(): Promise<GitHubIssue[]>;
+    /** Check if we can dispatch another agent. */
+    private canDispatch;
+    /** Create workspace and spawn agent for an issue. */
+    dispatchIssue(issue: GitHubIssue, attempt?: number): Promise<void>;
+    /** Build the full agent prompt from WORKFLOW.md + issue context. */
+    private buildAgentPrompt;
+    /** Spawn a background agent process. */
+    private spawnAgent;
+    /** Handle agent process exit. */
+    handleWorkerExit(issueNumber: number, success: boolean, error?: string): void;
+    /** Schedule a retry with exponential backoff. */
+    scheduleRetry(issueNumber: number, currentAttempt: number, error?: string): void;
+    /** Kill a running process. */
+    private killProcess;
+    /** Persist a completed run to disk for history. */
+    private persistRun;
+    /** Check if a specific issue is eligible for dispatch. */
+    isEligible(issue: GitHubIssue): boolean;
+}
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/core/symphony/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../../src/core/symphony/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EAGX,iBAAiB,EAElB,MAAM,YAAY,CAAC;AAUpB,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,UAAU,CAAS;IAE3B,OAAO;IAmCP,gDAAgD;IAChD,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,oBAAoB,GAAG,IAAI;IAOxE,uDAAuD;IACvD,MAAM,CAAC,eAAe,IAAI,IAAI;IAO9B,sDAAsD;IACtD,OAAO,CAAC,mBAAmB;IA8B3B,8BAA8B;IAC9B,KAAK,IAAI,IAAI;IAcb,qCAAqC;IACrC,IAAI,IAAI,IAAI;IAqCZ,qDAAqD;IACrD,SAAS,IAAI,OAAO;IAIpB,uCAAuC;IACvC,QAAQ,IAAI,iBAAiB;IAI7B,0BAA0B;IAC1B,SAAS,IAAI,cAAc;IAI3B,oDAAoD;IAC9C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAc/B,0DAA0D;IACpD,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAkChC,0CAA0C;IACpC,oBAAoB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IA8DpD,8CAA8C;IAC9C,OAAO,CAAC,WAAW;IAKnB,qDAAqD;IAC/C,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAiDnE,oEAAoE;IACpE,OAAO,CAAC,gBAAgB;IAoBxB,wCAAwC;IACxC,OAAO,CAAC,UAAU;IA2ClB,iCAAiC;IACjC,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IA0C7E,iDAAiD;IACjD,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAqDhF,8BAA8B;IAC9B,OAAO,CAAC,WAAW;IAWnB,mDAAmD;IACnD,OAAO,CAAC,UAAU;IAUlB,0DAA0D;IAC1D,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO;CASxC"}