kimaki 0.4.25 → 0.4.26

package/dist/markdown.js

@@ -4,6 +4,8 @@
 import * as yaml from 'js-yaml';
 import { formatDateTime } from './utils.js';
 import { extractNonXmlContent } from './xml.js';
+import { createLogger } from './logger.js';
+const markdownLogger = createLogger('MARKDOWN');
 export class ShareMarkdown {
     client;
     constructor(client) {
@@ -204,3 +206,105 @@ export class ShareMarkdown {
         return `${minutes}m ${seconds}s`;
     }
 }
+/**
+ * Generate compact session context for voice transcription.
+ * Includes system prompt (optional), user messages, assistant text,
+ * and tool calls in compact form (name + params only, no output).
+ */
+export async function getCompactSessionContext({ client, sessionId, includeSystemPrompt = false, maxMessages = 20, }) {
+    try {
+        const messagesResponse = await client.session.messages({
+            path: { id: sessionId },
+        });
+        const messages = messagesResponse.data || [];
+        const lines = [];
+        // Get system prompt if requested
+        // Note: OpenCode SDK doesn't expose system prompt directly. We try multiple approaches:
+        // 1. session.system field (if available in future SDK versions)
+        // 2. synthetic text part in first assistant message (current approach)
+        if (includeSystemPrompt && messages.length > 0) {
+            const firstAssistant = messages.find((m) => m.info.role === 'assistant');
+            if (firstAssistant) {
+                // look for text part marked as synthetic (system prompt)
+                const systemPart = (firstAssistant.parts || []).find((p) => p.type === 'text' && p.synthetic === true);
+                if (systemPart && 'text' in systemPart && systemPart.text) {
+                    lines.push('[System Prompt]');
+                    const truncated = systemPart.text.slice(0, 3000);
+                    lines.push(truncated);
+                    if (systemPart.text.length > 3000) {
+                        lines.push('...(truncated)');
+                    }
+                    lines.push('');
+                }
+            }
+        }
+        // Process recent messages
+        const recentMessages = messages.slice(-maxMessages);
+        for (const msg of recentMessages) {
+            if (msg.info.role === 'user') {
+                const textParts = (msg.parts || [])
+                    .filter((p) => p.type === 'text' && 'text' in p)
+                    .map((p) => ('text' in p ? extractNonXmlContent(p.text || '') : ''))
+                    .filter(Boolean);
+                if (textParts.length > 0) {
+                    lines.push(`[User]: ${textParts.join(' ').slice(0, 1000)}`);
+                    lines.push('');
+                }
+            }
+            else if (msg.info.role === 'assistant') {
+                // Get assistant text parts (non-synthetic, non-empty)
+                const textParts = (msg.parts || [])
+                    .filter((p) => p.type === 'text' && 'text' in p && !p.synthetic && p.text)
+                    .map((p) => ('text' in p ? p.text : ''))
+                    .filter(Boolean);
+                if (textParts.length > 0) {
+                    lines.push(`[Assistant]: ${textParts.join(' ').slice(0, 1000)}`);
+                    lines.push('');
+                }
+                // Get tool calls in compact form (name + params only)
+                const toolParts = (msg.parts || []).filter((p) => p.type === 'tool' &&
+                    'state' in p &&
+                    p.state?.status === 'completed');
+                for (const part of toolParts) {
+                    if (part.type === 'tool' && 'tool' in part && 'state' in part) {
+                        const toolName = part.tool;
+                        // skip noisy tools
+                        if (toolName === 'todoread' || toolName === 'todowrite') {
+                            continue;
+                        }
+                        const input = part.state?.input || {};
+                        // compact params: just key=value on one line
+                        const params = Object.entries(input)
+                            .map(([k, v]) => {
+                            const val = typeof v === 'string' ? v.slice(0, 100) : JSON.stringify(v).slice(0, 100);
+                            return `${k}=${val}`;
+                        })
+                            .join(', ');
+                        lines.push(`[Tool ${toolName}]: ${params}`);
+                    }
+                }
+            }
+        }
+        return lines.join('\n').slice(0, 8000);
+    }
+    catch (e) {
+        markdownLogger.error('Failed to get compact session context:', e);
+        return '';
+    }
+}
+/**
+ * Get the last session for a directory (excluding the current one).
+ */
+export async function getLastSessionId({ client, excludeSessionId, }) {
+    try {
+        const sessionsResponse = await client.session.list();
+        const sessions = sessionsResponse.data || [];
+        // Sessions are sorted by time, get the most recent one that isn't the current
+        const lastSession = sessions.find((s) => s.id !== excludeSessionId);
+        return lastSession?.id || null;
+    }
+    catch (e) {
+        markdownLogger.error('Failed to get last session:', e);
+        return null;
+    }
+}

package/dist/markdown.test.js

@@ -1,7 +1,7 @@
 import { test, expect, beforeAll, afterAll } from 'vitest';
 import { spawn } from 'child_process';
 import { OpencodeClient } from '@opencode-ai/sdk';
-import { ShareMarkdown } from './markdown.js';
+import { ShareMarkdown, getCompactSessionContext } from './markdown.js';
 let serverProcess;
 let client;
 let port;
@@ -230,3 +230,33 @@ test('generate markdown from multiple sessions', async () => {
         }
     }
 });
+// test for getCompactSessionContext - disabled in CI since it requires a specific session
+test.skipIf(process.env.CI)('getCompactSessionContext generates compact format', async () => {
+    const sessionId = 'ses_46c2205e8ffeOll1JUSuYChSAM';
+    const context = await getCompactSessionContext({
+        client,
+        sessionId,
+        includeSystemPrompt: true,
+        maxMessages: 15,
+    });
+    console.log(`Generated compact context length: ${context.length} characters`);
+    expect(context).toBeTruthy();
+    expect(context.length).toBeGreaterThan(0);
+    // should have tool calls or messages
+    expect(context).toMatch(/\[Tool \w+\]:|\[User\]:|\[Assistant\]:/);
+    await expect(context).toMatchFileSnapshot('./__snapshots__/compact-session-context.md');
+});
+test.skipIf(process.env.CI)('getCompactSessionContext without system prompt', async () => {
+    const sessionId = 'ses_46c2205e8ffeOll1JUSuYChSAM';
+    const context = await getCompactSessionContext({
+        client,
+        sessionId,
+        includeSystemPrompt: false,
+        maxMessages: 10,
+    });
+    console.log(`Generated compact context (no system) length: ${context.length} characters`);
+    expect(context).toBeTruthy();
+    // should NOT have system prompt
+    expect(context).not.toContain('[System Prompt]');
+    await expect(context).toMatchFileSnapshot('./__snapshots__/compact-session-context-no-system.md');
+});

package/dist/message-formatting.js

@@ -1,8 +1,18 @@
 // OpenCode message part formatting for Discord.
 // Converts SDK message parts (text, tools, reasoning) to Discord-friendly format,
 // handles file attachments, and provides tool summary generation.
+import fs from 'node:fs';
+import path from 'node:path';
 import { createLogger } from './logger.js';
+const ATTACHMENTS_DIR = path.join(process.cwd(), 'tmp', 'discord-attachments');
 const logger = createLogger('FORMATTING');
+/**
+ * Escapes Discord inline markdown characters so dynamic content
+ * doesn't break formatting when wrapped in *, _, **, etc.
+ */
+function escapeInlineMarkdown(text) {
+    return text.replace(/([*_~|`\\])/g, '\\$1');
+}
 /**
  * Collects and formats the last N assistant parts from session messages.
  * Used by both /resume and /fork to show recent assistant context.
@@ -61,17 +71,42 @@ export async function getTextAttachments(message) {
     }));
     return textContents.join('\n\n');
 }
-export function getFileAttachments(message) {
+export async function getFileAttachments(message) {
     const fileAttachments = Array.from(message.attachments.values()).filter((attachment) => {
         const contentType = attachment.contentType || '';
         return (contentType.startsWith('image/') || contentType === 'application/pdf');
     });
-    return fileAttachments.map((attachment) => ({
-        type: 'file',
-        mime: attachment.contentType || 'application/octet-stream',
-        filename: attachment.name,
-        url: attachment.url,
+    if (fileAttachments.length === 0) {
+        return [];
+    }
+    // ensure tmp directory exists
+    if (!fs.existsSync(ATTACHMENTS_DIR)) {
+        fs.mkdirSync(ATTACHMENTS_DIR, { recursive: true });
+    }
+    const results = await Promise.all(fileAttachments.map(async (attachment) => {
+        try {
+            const response = await fetch(attachment.url);
+            if (!response.ok) {
+                logger.error(`Failed to fetch attachment ${attachment.name}: ${response.status}`);
+                return null;
+            }
+            const buffer = Buffer.from(await response.arrayBuffer());
+            const localPath = path.join(ATTACHMENTS_DIR, `${message.id}-${attachment.name}`);
+            fs.writeFileSync(localPath, buffer);
+            logger.log(`Downloaded attachment to ${localPath}`);
+            return {
+                type: 'file',
+                mime: attachment.contentType || 'application/octet-stream',
+                filename: attachment.name,
+                url: localPath,
+            };
+        }
+        catch (error) {
+            logger.error(`Error downloading attachment ${attachment.name}:`, error);
+            return null;
+        }
     }));
+    return results.filter((r) => r !== null);
 }
 export function getToolSummaryText(part) {
     if (part.type !== 'tool')
@@ -83,48 +118,48 @@ export function getToolSummaryText(part) {
         const added = newString.split('\n').length;
         const removed = oldString.split('\n').length;
         const fileName = filePath.split('/').pop() || '';
-        return fileName ? `*${fileName}* (+${added}-${removed})` : `(+${added}-${removed})`;
+        return fileName ? `*${escapeInlineMarkdown(fileName)}* (+${added}-${removed})` : `(+${added}-${removed})`;
     }
     if (part.tool === 'write') {
         const filePath = part.state.input?.filePath || '';
         const content = part.state.input?.content || '';
         const lines = content.split('\n').length;
         const fileName = filePath.split('/').pop() || '';
-        return fileName ? `*${fileName}* (${lines} line${lines === 1 ? '' : 's'})` : `(${lines} line${lines === 1 ? '' : 's'})`;
+        return fileName ? `*${escapeInlineMarkdown(fileName)}* (${lines} line${lines === 1 ? '' : 's'})` : `(${lines} line${lines === 1 ? '' : 's'})`;
     }
     if (part.tool === 'webfetch') {
         const url = part.state.input?.url || '';
         const urlWithoutProtocol = url.replace(/^https?:\/\//, '');
-        return urlWithoutProtocol ? `*${urlWithoutProtocol}*` : '';
+        return urlWithoutProtocol ? `*${escapeInlineMarkdown(urlWithoutProtocol)}*` : '';
     }
     if (part.tool === 'read') {
         const filePath = part.state.input?.filePath || '';
         const fileName = filePath.split('/').pop() || '';
-        return fileName ? `*${fileName}*` : '';
+        return fileName ? `*${escapeInlineMarkdown(fileName)}*` : '';
     }
     if (part.tool === 'list') {
         const path = part.state.input?.path || '';
         const dirName = path.split('/').pop() || path;
-        return dirName ? `*${dirName}*` : '';
+        return dirName ? `*${escapeInlineMarkdown(dirName)}*` : '';
     }
     if (part.tool === 'glob') {
         const pattern = part.state.input?.pattern || '';
-        return pattern ? `*${pattern}*` : '';
+        return pattern ? `*${escapeInlineMarkdown(pattern)}*` : '';
     }
     if (part.tool === 'grep') {
         const pattern = part.state.input?.pattern || '';
-        return pattern ? `*${pattern}*` : '';
+        return pattern ? `*${escapeInlineMarkdown(pattern)}*` : '';
     }
     if (part.tool === 'bash' || part.tool === 'todoread' || part.tool === 'todowrite') {
         return '';
     }
     if (part.tool === 'task') {
         const description = part.state.input?.description || '';
-        return description ? `_${description}_` : '';
+        return description ? `_${escapeInlineMarkdown(description)}_` : '';
     }
     if (part.tool === 'skill') {
         const name = part.state.input?.name || '';
-        return name ? `_${name}_` : '';
+        return name ? `_${escapeInlineMarkdown(name)}_` : '';
     }
     if (!part.state.input)
         return '';
@@ -151,12 +186,24 @@ export function formatTodoList(part) {
     const activeTodo = todos[activeIndex];
     if (activeIndex === -1 || !activeTodo)
         return '';
-    return `${activeIndex + 1}. **${activeTodo.content}**`;
+    // parenthesized digits ⑴-⒇ for 1-20, fallback to regular number for 21+
+    const parenthesizedDigits = '⑴⑵⑶⑷⑸⑹⑺⑻⑼⑽⑾⑿⒀⒁⒂⒃⒄⒅⒆⒇';
+    const todoNumber = activeIndex + 1;
+    const num = todoNumber <= 20 ? parenthesizedDigits[todoNumber - 1] : `(${todoNumber})`;
+    const content = activeTodo.content.charAt(0).toLowerCase() + activeTodo.content.slice(1);
+    return `${num} **${escapeInlineMarkdown(content)}**`;
 }
 export function formatPart(part) {
     if (part.type === 'text') {
         if (!part.text?.trim())
             return '';
+        const trimmed = part.text.trimStart();
+        const firstChar = trimmed[0] || '';
+        const markdownStarters = ['#', '*', '_', '-', '>', '`', '[', '|'];
+        const startsWithMarkdown = markdownStarters.includes(firstChar) || /^\d+\./.test(trimmed);
+        if (startsWithMarkdown) {
+            return `\n${part.text}`;
+        }
         return `⬥ ${part.text}`;
     }
     if (part.type === 'reasoning') {
@@ -180,6 +227,10 @@ export function formatPart(part) {
         if (part.tool === 'todowrite') {
             return formatTodoList(part);
         }
+        // Question tool is handled via Discord dropdowns, not text
+        if (part.tool === 'question') {
+            return '';
+        }
         if (part.state.status === 'pending') {
             return '';
         }
@@ -193,19 +244,18 @@ export function formatPart(part) {
             const command = part.state.input?.command || '';
             const description = part.state.input?.description || '';
             const isSingleLine = !command.includes('\n');
-            const hasUnderscores = command.includes('_');
-            if (isSingleLine && !hasUnderscores && command.length <= 50) {
-                toolTitle = `_${command}_`;
+            if (isSingleLine && command.length <= 50) {
+                toolTitle = `_${escapeInlineMarkdown(command)}_`;
             }
             else if (description) {
-                toolTitle = `_${description}_`;
+                toolTitle = `_${escapeInlineMarkdown(description)}_`;
             }
             else if (stateTitle) {
-                toolTitle = `_${stateTitle}_`;
+                toolTitle = `_${escapeInlineMarkdown(stateTitle)}_`;
             }
         }
         else if (stateTitle) {
-            toolTitle = `_${stateTitle}_`;
+            toolTitle = `_${escapeInlineMarkdown(stateTitle)}_`;
         }
         const icon = (() => {
             if (part.state.status === 'error') {

package/dist/message-formatting.test.js

@@ -0,0 +1,73 @@
+import { describe, test, expect } from 'vitest';
+import { formatTodoList } from './message-formatting.js';
+describe('formatTodoList', () => {
+    test('formats active todo with monospace numbers', () => {
+        const part = {
+            id: 'test',
+            type: 'tool',
+            tool: 'todowrite',
+            sessionID: 'ses_test',
+            messageID: 'msg_test',
+            callID: 'call_test',
+            state: {
+                status: 'completed',
+                input: {
+                    todos: [
+                        { content: 'First task', status: 'completed' },
+                        { content: 'Second task', status: 'in_progress' },
+                        { content: 'Third task', status: 'pending' },
+                    ],
+                },
+                output: '',
+                title: 'todowrite',
+                metadata: {},
+                time: { start: 0, end: 0 },
+            },
+        };
+        expect(formatTodoList(part)).toMatchInlineSnapshot(`"⑵ **second task**"`);
+    });
+    test('formats double digit todo numbers', () => {
+        const todos = Array.from({ length: 12 }, (_, i) => ({
+            content: `Task ${i + 1}`,
+            status: i === 11 ? 'in_progress' : 'completed',
+        }));
+        const part = {
+            id: 'test',
+            type: 'tool',
+            tool: 'todowrite',
+            sessionID: 'ses_test',
+            messageID: 'msg_test',
+            callID: 'call_test',
+            state: {
+                status: 'completed',
+                input: { todos },
+                output: '',
+                title: 'todowrite',
+                metadata: {},
+                time: { start: 0, end: 0 },
+            },
+        };
+        expect(formatTodoList(part)).toMatchInlineSnapshot(`"⑿ **task 12**"`);
+    });
+    test('lowercases first letter of content', () => {
+        const part = {
+            id: 'test',
+            type: 'tool',
+            tool: 'todowrite',
+            sessionID: 'ses_test',
+            messageID: 'msg_test',
+            callID: 'call_test',
+            state: {
+                status: 'completed',
+                input: {
+                    todos: [{ content: 'Fix the bug', status: 'in_progress' }],
+                },
+                output: '',
+                title: 'todowrite',
+                metadata: {},
+                time: { start: 0, end: 0 },
+            },
+        };
+        expect(formatTodoList(part)).toMatchInlineSnapshot(`"⑴ **fix the bug**"`);
+    });
+});

package/dist/opencode.js

@@ -2,8 +2,10 @@
 // Spawns and maintains OpenCode API servers per project directory,
 // handles automatic restarts on failure, and provides typed SDK clients.
 import { spawn } from 'node:child_process';
+import fs from 'node:fs';
 import net from 'node:net';
 import { createOpencodeClient, } from '@opencode-ai/sdk';
+import { createOpencodeClient as createOpencodeClientV2, } from '@opencode-ai/sdk/v2';
 import { createLogger } from './logger.js';
 const opencodeLogger = createLogger('OPENCODE');
 const opencodeServers = new Map();
@@ -30,22 +32,37 @@ async function waitForServer(port, maxAttempts = 30) {
     for (let i = 0; i < maxAttempts; i++) {
         try {
             const endpoints = [
-                `http://localhost:${port}/api/health`,
-                `http://localhost:${port}/`,
-                `http://localhost:${port}/api`,
+                `http://127.0.0.1:${port}/api/health`,
+                `http://127.0.0.1:${port}/`,
+                `http://127.0.0.1:${port}/api`,
             ];
             for (const endpoint of endpoints) {
                 try {
                     const response = await fetch(endpoint);
                     if (response.status < 500) {
-                        opencodeLogger.log(`Server ready on port `);
                         return true;
                     }
+                    const body = await response.text();
+                    // Fatal errors that won't resolve with retrying
+                    if (body.includes('BunInstallFailedError')) {
+                        throw new Error(`Server failed to start: ${body.slice(0, 200)}`);
+                    }
+                }
+                catch (e) {
+                    // Re-throw fatal errors
+                    if (e.message?.includes('Server failed to start')) {
+                        throw e;
+                    }
                 }
-                catch (e) { }
             }
         }
-        catch (e) { }
+        catch (e) {
+            // Re-throw fatal errors that won't resolve with retrying
+            if (e.message?.includes('Server failed to start')) {
+                throw e;
+            }
+            opencodeLogger.debug(`Server polling attempt failed: ${e.message}`);
+        }
         await new Promise((resolve) => setTimeout(resolve, 1000));
     }
     throw new Error(`Server did not start on port ${port} after ${maxAttempts} seconds`);
@@ -62,8 +79,16 @@ export async function initializeOpencodeForDirectory(directory) {
             return entry.client;
         };
     }
+    // Verify directory exists and is accessible before spawning
+    try {
+        fs.accessSync(directory, fs.constants.R_OK | fs.constants.X_OK);
+    }
+    catch {
+        throw new Error(`Directory does not exist or is not accessible: ${directory}`);
+    }
     const port = await getOpenPort();
-    const opencodeCommand = process.env.OPENCODE_PATH || 'opencode';
+    const opencodeBinDir = `${process.env.HOME}/.opencode/bin`;
+    const opencodeCommand = process.env.OPENCODE_PATH || `${opencodeBinDir}/opencode`;
     const serverProcess = spawn(opencodeCommand, ['serve', '--port', port.toString()], {
         stdio: 'pipe',
         detached: false,
@@ -83,14 +108,17 @@ export async function initializeOpencodeForDirectory(directory) {
             OPENCODE_PORT: port.toString(),
         },
     });
+    // Buffer logs until we know if server started successfully
+    const logBuffer = [];
+    logBuffer.push(`Spawned opencode serve --port ${port} in ${directory} (pid: ${serverProcess.pid})`);
     serverProcess.stdout?.on('data', (data) => {
-        opencodeLogger.log(`opencode ${directory}: ${data.toString().trim()}`);
+        logBuffer.push(`[stdout] ${data.toString().trim()}`);
     });
     serverProcess.stderr?.on('data', (data) => {
-        opencodeLogger.error(`opencode ${directory}: ${data.toString().trim()}`);
+        logBuffer.push(`[stderr] ${data.toString().trim()}`);
     });
     serverProcess.on('error', (error) => {
-        opencodeLogger.error(`Failed to start server on port :`, port, error);
+        logBuffer.push(`Failed to start server on port ${port}: ${error}`);
     });
     serverProcess.on('exit', (code) => {
         opencodeLogger.log(`Opencode server on ${directory} exited with code:`, code);
@@ -112,17 +140,35 @@ export async function initializeOpencodeForDirectory(directory) {
             serverRetryCount.delete(directory);
         }
     });
-    await waitForServer(port);
+    try {
+        await waitForServer(port);
+        opencodeLogger.log(`Server ready on port ${port}`);
+    }
+    catch (e) {
+        // Dump buffered logs on failure
+        opencodeLogger.error(`Server failed to start for ${directory}:`);
+        for (const line of logBuffer) {
+            opencodeLogger.error(`  ${line}`);
+        }
+        throw e;
+    }
+    const baseUrl = `http://127.0.0.1:${port}`;
+    const fetchWithTimeout = (request) => fetch(request, {
+        // @ts-ignore
+        timeout: false,
+    });
     const client = createOpencodeClient({
-        baseUrl: `http://localhost:${port}`,
-        fetch: (request) => fetch(request, {
-            // @ts-ignore
-            timeout: false,
-        }),
+        baseUrl,
+        fetch: fetchWithTimeout,
+    });
+    const clientV2 = createOpencodeClientV2({
+        baseUrl,
+        fetch: fetchWithTimeout,
     });
     opencodeServers.set(directory, {
         process: serverProcess,
         client,
+        clientV2,
         port,
     });
     return () => {
@@ -136,3 +182,11 @@ export async function initializeOpencodeForDirectory(directory) {
 export function getOpencodeServers() {
     return opencodeServers;
 }
+export function getOpencodeServerPort(directory) {
+    const entry = opencodeServers.get(directory);
+    return entry?.port ?? null;
+}
+export function getOpencodeClientV2(directory) {
+    const entry = opencodeServers.get(directory);
+    return entry?.clientV2 ?? null;
+}