kimaki 0.4.41 → 0.4.43

package/dist/cli.js

@@ -1027,23 +1027,68 @@ cli
             throw new Error(`Channel belongs to a different bot (expected: ${appId}, got: ${channelAppId})`);
         }
         s.message('Creating starter message...');
-        // Create starter message with just the prompt (no prefix)
-        const starterMessageResponse = await fetch(`https://discord.com/api/v10/channels/${channelId}/messages`, {
-            method: 'POST',
-            headers: {
-                Authorization: `Bot ${botToken}`,
-                'Content-Type': 'application/json',
-            },
-            body: JSON.stringify({
-                content: prompt,
-            }),
-        });
-        if (!starterMessageResponse.ok) {
-            const error = await starterMessageResponse.text();
-            s.stop('Failed to create message');
-            throw new Error(`Discord API error: ${starterMessageResponse.status} - ${error}`);
+        // Discord has a 2000 character limit for messages.
+        // If prompt exceeds this, send it as a file attachment instead.
+        const DISCORD_MAX_LENGTH = 2000;
+        let starterMessage;
+        if (prompt.length > DISCORD_MAX_LENGTH) {
+            // Send as file attachment with a short summary
+            const preview = prompt.slice(0, 100).replace(/\n/g, ' ');
+            const summaryContent = `📄 **Prompt attached as file** (${prompt.length} chars)\n\n> ${preview}...`;
+            // Write prompt to a temp file
+            const tmpDir = path.join(process.cwd(), 'tmp');
+            if (!fs.existsSync(tmpDir)) {
+                fs.mkdirSync(tmpDir, { recursive: true });
+            }
+            const tmpFile = path.join(tmpDir, `prompt-${Date.now()}.md`);
+            fs.writeFileSync(tmpFile, prompt);
+            try {
+                // Create message with file attachment
+                const formData = new FormData();
+                formData.append('payload_json', JSON.stringify({
+                    content: summaryContent,
+                    attachments: [{ id: 0, filename: 'prompt.md' }],
+                }));
+                const buffer = fs.readFileSync(tmpFile);
+                formData.append('files[0]', new Blob([buffer], { type: 'text/markdown' }), 'prompt.md');
+                const starterMessageResponse = await fetch(`https://discord.com/api/v10/channels/${channelId}/messages`, {
+                    method: 'POST',
+                    headers: {
+                        Authorization: `Bot ${botToken}`,
+                    },
+                    body: formData,
+                });
+                if (!starterMessageResponse.ok) {
+                    const error = await starterMessageResponse.text();
+                    s.stop('Failed to create message');
+                    throw new Error(`Discord API error: ${starterMessageResponse.status} - ${error}`);
+                }
+                starterMessage = (await starterMessageResponse.json());
+            }
+            finally {
+                // Clean up temp file
+                fs.unlinkSync(tmpFile);
+            }
+        }
+        else {
+            // Normal case: send prompt inline
+            const starterMessageResponse = await fetch(`https://discord.com/api/v10/channels/${channelId}/messages`, {
+                method: 'POST',
+                headers: {
+                    Authorization: `Bot ${botToken}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({
+                    content: prompt,
+                }),
+            });
+            if (!starterMessageResponse.ok) {
+                const error = await starterMessageResponse.text();
+                s.stop('Failed to create message');
+                throw new Error(`Discord API error: ${starterMessageResponse.status} - ${error}`);
+            }
+            starterMessage = (await starterMessageResponse.json());
         }
-        const starterMessage = (await starterMessageResponse.json());
         s.message('Creating thread...');
         // Create thread from the message
         const threadName = name || (prompt.length > 80 ? prompt.slice(0, 77) + '...' : prompt);

package/dist/session-handler.js

@@ -16,6 +16,9 @@ const sessionLogger = createLogger('SESSION');
 const voiceLogger = createLogger('VOICE');
 const discordLogger = createLogger('DISCORD');
 export const abortControllers = new Map();
+// Track multiple pending permissions per thread (keyed by permission ID)
+// OpenCode handles blocking/sequencing - we just need to track all pending permissions
+// to avoid duplicates and properly clean up on auto-reject
 export const pendingPermissions = new Map();
 // Queue of messages waiting to be sent after current response finishes
 // Key is threadId, value is array of queued messages
@@ -148,26 +151,32 @@ export async function handleOpencodeSession({ prompt, thread, projectDirectory,
         voiceLogger.log(`[ABORT] Cancelling existing request for session: ${session.id}`);
         existingController.abort(new Error('New request started'));
     }
-    const pendingPerm = pendingPermissions.get(thread.id);
-    if (pendingPerm) {
-        try {
-            sessionLogger.log(`[PERMISSION] Auto-rejecting pending permission ${pendingPerm.permission.id} due to new message`);
-            const clientV2 = getOpencodeClientV2(directory);
-            if (clientV2) {
-                await clientV2.permission.reply({
-                    requestID: pendingPerm.permission.id,
-                    reply: 'reject',
-                });
+    // Auto-reject ALL pending permissions for this thread
+    const threadPermissions = pendingPermissions.get(thread.id);
+    if (threadPermissions && threadPermissions.size > 0) {
+        const clientV2 = getOpencodeClientV2(directory);
+        let rejectedCount = 0;
+        for (const [permId, pendingPerm] of threadPermissions) {
+            try {
+                sessionLogger.log(`[PERMISSION] Auto-rejecting permission ${permId} due to new message`);
+                if (clientV2) {
+                    await clientV2.permission.reply({
+                        requestID: permId,
+                        reply: 'reject',
+                    });
+                }
+                cleanupPermissionContext(pendingPerm.contextHash);
+                rejectedCount++;
+            }
+            catch (e) {
+                sessionLogger.log(`[PERMISSION] Failed to auto-reject permission ${permId}:`, e);
+                cleanupPermissionContext(pendingPerm.contextHash);
             }
-            // Clean up both the pending permission and its dropdown context
-            cleanupPermissionContext(pendingPerm.contextHash);
-            pendingPermissions.delete(thread.id);
-            await sendThreadMessage(thread, `⚠️ Previous permission request auto-rejected due to new message`);
         }
-        catch (e) {
-            sessionLogger.log(`[PERMISSION] Failed to auto-reject permission:`, e);
-            cleanupPermissionContext(pendingPerm.contextHash);
-            pendingPermissions.delete(thread.id);
+        pendingPermissions.delete(thread.id);
+        if (rejectedCount > 0) {
+            const plural = rejectedCount > 1 ? 's' : '';
+            await sendThreadMessage(thread, `⚠️ ${rejectedCount} pending permission request${plural} auto-rejected due to new message`);
         }
     }
     // Cancel any pending question tool if user sends a new message (silently, no thread message)
@@ -382,7 +391,7 @@ export async function handleOpencodeSession({ prompt, thread, projectDirectory,
                     if (part.type === 'step-start') {
                         // Don't start typing if user needs to respond to a question or permission
                         const hasPendingQuestion = [...pendingQuestionContexts.values()].some((ctx) => ctx.thread.id === thread.id);
-                        const hasPendingPermission = pendingPermissions.has(thread.id);
+                        const hasPendingPermission = (pendingPermissions.get(thread.id)?.size ?? 0) > 0;
                         if (!hasPendingQuestion && !hasPendingPermission) {
                             stopTyping = startTyping();
                         }
@@ -451,7 +460,7 @@ export async function handleOpencodeSession({ prompt, thread, projectDirectory,
                                 return;
                             // Don't restart typing if user needs to respond to a question or permission
                             const hasPendingQuestion = [...pendingQuestionContexts.values()].some((ctx) => ctx.thread.id === thread.id);
-                            const hasPendingPermission = pendingPermissions.has(thread.id);
+                            const hasPendingPermission = (pendingPermissions.get(thread.id)?.size ?? 0) > 0;
                             if (hasPendingQuestion || hasPendingPermission)
                                 return;
                             stopTyping = startTyping();
@@ -487,6 +496,12 @@ export async function handleOpencodeSession({ prompt, thread, projectDirectory,
                         voiceLogger.log(`[PERMISSION IGNORED] Permission for different session (expected: ${session.id}, got: ${permission.sessionID})`);
                         continue;
                     }
+                    // Skip if this exact permission ID is already pending (dedupe)
+                    const threadPermissions = pendingPermissions.get(thread.id);
+                    if (threadPermissions?.has(permission.id)) {
+                        sessionLogger.log(`[PERMISSION] Skipping duplicate permission ${permission.id} (already pending)`);
+                        continue;
+                    }
                     sessionLogger.log(`Permission requested: permission=${permission.permission}, patterns=${permission.patterns.join(', ')}`);
                     // Stop typing - user needs to respond now, not the bot
                     if (stopTyping) {
@@ -499,7 +514,11 @@ export async function handleOpencodeSession({ prompt, thread, projectDirectory,
                         permission,
                         directory,
                     });
-                    pendingPermissions.set(thread.id, {
+                    // Track permission in nested map (threadId -> permissionId -> data)
+                    if (!pendingPermissions.has(thread.id)) {
+                        pendingPermissions.set(thread.id, new Map());
+                    }
+                    pendingPermissions.get(thread.id).set(permission.id, {
                         permission,
                         messageId,
                         directory,
@@ -512,10 +531,18 @@ export async function handleOpencodeSession({ prompt, thread, projectDirectory,
                         continue;
                     }
                     sessionLogger.log(`Permission ${requestID} replied with: ${reply}`);
-                    const pending = pendingPermissions.get(thread.id);
-                    if (pending && pending.permission.id === requestID) {
-                        cleanupPermissionContext(pending.contextHash);
-                        pendingPermissions.delete(thread.id);
+                    // Clean up the specific permission from nested map
+                    const threadPermissions = pendingPermissions.get(thread.id);
+                    if (threadPermissions) {
+                        const pending = threadPermissions.get(requestID);
+                        if (pending) {
+                            cleanupPermissionContext(pending.contextHash);
+                            threadPermissions.delete(requestID);
+                            // Remove thread entry if no more pending permissions
+                            if (threadPermissions.size === 0) {
+                                pendingPermissions.delete(thread.id);
+                            }
+                        }
                     }
                 }
                 else if (event.type === 'question.asked') {

package/dist/system-message.js

@@ -35,6 +35,21 @@ Use --notify-only to create a notification thread without starting an AI session
 npx -y kimaki send --channel ${channelId} --prompt "User cancelled subscription" --notify-only
 
 This is useful for automation (cron jobs, GitHub webhooks, n8n, etc.)
+
+### Session handoff
+
+When you are approaching the **context window limit** or the user explicitly asks to **handoff to a new thread**, use the \`kimaki send\` command to start a fresh session with context:
+
+\`\`\`bash
+npx -y kimaki send --channel ${channelId} --prompt "Continuing from previous session: <summary of current task and state>"
+\`\`\`
+
+The command automatically handles long prompts (over 2000 chars) by sending them as file attachments.
+
+Use this for handoff when:
+- User asks to "handoff", "continue in new thread", or "start fresh session"
+- You detect you're running low on context window space
+- A complex task would benefit from a clean slate with summarized context
 `
         : ''}
 ## showing diffs
@@ -43,17 +58,17 @@ IMPORTANT: After editing any files, you MUST execute the critique command using
 
 Execute this after making changes:
 
-bunx critique web --title "Add user authentication flow"
+bunx critique --web "Add user authentication flow"
 
 If there are other unrelated changes in the working directory, filter to only show the files you edited:
 
-bunx critique web --title "Fix database connection retry" -- path/to/file1.ts path/to/file2.ts
+bunx critique --web "Fix database connection retry" --filter "path/to/file1.ts" --filter "path/to/file2.ts"
 
 You can also show latest commit changes using:
 
-bunx critique web --title "Refactor API endpoints" HEAD
+bunx critique HEAD --web "Refactor API endpoints"
 
-bunx critique web --title "Update dependencies" HEAD~1 to get the one before last
+bunx critique HEAD~1 --web "Update dependencies"
 
 Do this in case you committed the changes yourself (only if the user asks so, never commit otherwise).
 

package/dist/voice-handler.js

@@ -375,6 +375,7 @@ export async function processVoiceAttachment({ message, thread, projectDirectory
             EmptyTranscriptionError: (e) => e.message,
             NoResponseContentError: (e) => e.message,
             NoToolResponseError: (e) => e.message,
+            Error: (e) => e.message,
         });
         voiceLogger.error(`Transcription failed:`, transcription);
         await sendThreadMessage(thread, `⚠️ Transcription failed: ${errMsg}`);

package/package.json

@@ -2,7 +2,7 @@
   "name": "kimaki",
   "module": "index.ts",
   "type": "module",
-  "version": "0.4.41",
+  "version": "0.4.43",
   "repository": "https://github.com/remorses/kimaki",
   "bin": "bin.js",
   "files": [
@@ -41,7 +41,7 @@
     "string-dedent": "^3.0.2",
     "undici": "^7.16.0",
     "zod": "^4.2.1",
-    "errore": "^0.7.1"
+    "errore": "^0.9.0"
   },
   "optionalDependencies": {
     "@discordjs/opus": "^0.10.0",

package/src/cli.ts

@@ -1381,28 +1381,83 @@ cli
 
       s.message('Creating starter message...')
 
-      // Create starter message with just the prompt (no prefix)
-      const starterMessageResponse = await fetch(
-        `https://discord.com/api/v10/channels/${channelId}/messages`,
-        {
-          method: 'POST',
-          headers: {
-            Authorization: `Bot ${botToken}`,
-            'Content-Type': 'application/json',
+      // Discord has a 2000 character limit for messages.
+      // If prompt exceeds this, send it as a file attachment instead.
+      const DISCORD_MAX_LENGTH = 2000
+      let starterMessage: { id: string }
+
+      if (prompt.length > DISCORD_MAX_LENGTH) {
+        // Send as file attachment with a short summary
+        const preview = prompt.slice(0, 100).replace(/\n/g, ' ')
+        const summaryContent = `📄 **Prompt attached as file** (${prompt.length} chars)\n\n> ${preview}...`
+
+        // Write prompt to a temp file
+        const tmpDir = path.join(process.cwd(), 'tmp')
+        if (!fs.existsSync(tmpDir)) {
+          fs.mkdirSync(tmpDir, { recursive: true })
+        }
+        const tmpFile = path.join(tmpDir, `prompt-${Date.now()}.md`)
+        fs.writeFileSync(tmpFile, prompt)
+
+        try {
+          // Create message with file attachment
+          const formData = new FormData()
+          formData.append(
+            'payload_json',
+            JSON.stringify({
+              content: summaryContent,
+              attachments: [{ id: 0, filename: 'prompt.md' }],
+            }),
+          )
+          const buffer = fs.readFileSync(tmpFile)
+          formData.append('files[0]', new Blob([buffer], { type: 'text/markdown' }), 'prompt.md')
+
+          const starterMessageResponse = await fetch(
+            `https://discord.com/api/v10/channels/${channelId}/messages`,
+            {
+              method: 'POST',
+              headers: {
+                Authorization: `Bot ${botToken}`,
+              },
+              body: formData,
+            },
+          )
+
+          if (!starterMessageResponse.ok) {
+            const error = await starterMessageResponse.text()
+            s.stop('Failed to create message')
+            throw new Error(`Discord API error: ${starterMessageResponse.status} - ${error}`)
+          }
+
+          starterMessage = (await starterMessageResponse.json()) as { id: string }
+        } finally {
+          // Clean up temp file
+          fs.unlinkSync(tmpFile)
+        }
+      } else {
+        // Normal case: send prompt inline
+        const starterMessageResponse = await fetch(
+          `https://discord.com/api/v10/channels/${channelId}/messages`,
+          {
+            method: 'POST',
+            headers: {
+              Authorization: `Bot ${botToken}`,
+              'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+              content: prompt,
+            }),
           },
-          body: JSON.stringify({
-            content: prompt,
-          }),
-        },
-      )
+        )
 
-      if (!starterMessageResponse.ok) {
-        const error = await starterMessageResponse.text()
-        s.stop('Failed to create message')
-        throw new Error(`Discord API error: ${starterMessageResponse.status} - ${error}`)
-      }
+        if (!starterMessageResponse.ok) {
+          const error = await starterMessageResponse.text()
+          s.stop('Failed to create message')
+          throw new Error(`Discord API error: ${starterMessageResponse.status} - ${error}`)
+        }
 
-      const starterMessage = (await starterMessageResponse.json()) as { id: string }
+        starterMessage = (await starterMessageResponse.json()) as { id: string }
+      }
 
       s.message('Creating thread...')
 

package/src/session-handler.ts

@@ -38,9 +38,12 @@ const discordLogger = createLogger('DISCORD')
 
 export const abortControllers = new Map<string, AbortController>()
 
+// Track multiple pending permissions per thread (keyed by permission ID)
+// OpenCode handles blocking/sequencing - we just need to track all pending permissions
+// to avoid duplicates and properly clean up on auto-reject
 export const pendingPermissions = new Map<
-  string,
-  { permission: PermissionRequest; messageId: string; directory: string; contextHash: string }
+  string, // threadId
+  Map<string, { permission: PermissionRequest; messageId: string; directory: string; contextHash: string }> // permissionId -> data
 >()
 
 export type QueuedMessage = {
@@ -246,30 +249,34 @@ export async function handleOpencodeSession({
     existingController.abort(new Error('New request started'))
   }
 
-  const pendingPerm = pendingPermissions.get(thread.id)
-  if (pendingPerm) {
-    try {
-      sessionLogger.log(
-        `[PERMISSION] Auto-rejecting pending permission ${pendingPerm.permission.id} due to new message`,
-      )
-      const clientV2 = getOpencodeClientV2(directory)
-      if (clientV2) {
-        await clientV2.permission.reply({
-          requestID: pendingPerm.permission.id,
-          reply: 'reject',
-        })
+  // Auto-reject ALL pending permissions for this thread
+  const threadPermissions = pendingPermissions.get(thread.id)
+  if (threadPermissions && threadPermissions.size > 0) {
+    const clientV2 = getOpencodeClientV2(directory)
+    let rejectedCount = 0
+    for (const [permId, pendingPerm] of threadPermissions) {
+      try {
+        sessionLogger.log(`[PERMISSION] Auto-rejecting permission ${permId} due to new message`)
+        if (clientV2) {
+          await clientV2.permission.reply({
+            requestID: permId,
+            reply: 'reject',
+          })
+        }
+        cleanupPermissionContext(pendingPerm.contextHash)
+        rejectedCount++
+      } catch (e) {
+        sessionLogger.log(`[PERMISSION] Failed to auto-reject permission ${permId}:`, e)
+        cleanupPermissionContext(pendingPerm.contextHash)
       }
-      // Clean up both the pending permission and its dropdown context
-      cleanupPermissionContext(pendingPerm.contextHash)
-      pendingPermissions.delete(thread.id)
+    }
+    pendingPermissions.delete(thread.id)
+    if (rejectedCount > 0) {
+      const plural = rejectedCount > 1 ? 's' : ''
       await sendThreadMessage(
         thread,
-        `⚠️ Previous permission request auto-rejected due to new message`,
+        `⚠️ ${rejectedCount} pending permission request${plural} auto-rejected due to new message`,
       )
-    } catch (e) {
-      sessionLogger.log(`[PERMISSION] Failed to auto-reject permission:`, e)
-      cleanupPermissionContext(pendingPerm.contextHash)
-      pendingPermissions.delete(thread.id)
     }
   }
 
@@ -536,7 +543,7 @@ export async function handleOpencodeSession({
             const hasPendingQuestion = [...pendingQuestionContexts.values()].some(
               (ctx) => ctx.thread.id === thread.id,
             )
-            const hasPendingPermission = pendingPermissions.has(thread.id)
+            const hasPendingPermission = (pendingPermissions.get(thread.id)?.size ?? 0) > 0
             if (!hasPendingQuestion && !hasPendingPermission) {
               stopTyping = startTyping()
             }
@@ -612,7 +619,7 @@ export async function handleOpencodeSession({
               const hasPendingQuestion = [...pendingQuestionContexts.values()].some(
                 (ctx) => ctx.thread.id === thread.id,
               )
-              const hasPendingPermission = pendingPermissions.has(thread.id)
+              const hasPendingPermission = (pendingPermissions.get(thread.id)?.size ?? 0) > 0
               if (hasPendingQuestion || hasPendingPermission) return
               stopTyping = startTyping()
             }, 300)
@@ -650,6 +657,15 @@ export async function handleOpencodeSession({
             continue
           }
 
+          // Skip if this exact permission ID is already pending (dedupe)
+          const threadPermissions = pendingPermissions.get(thread.id)
+          if (threadPermissions?.has(permission.id)) {
+            sessionLogger.log(
+              `[PERMISSION] Skipping duplicate permission ${permission.id} (already pending)`,
+            )
+            continue
+          }
+
           sessionLogger.log(
             `Permission requested: permission=${permission.permission}, patterns=${permission.patterns.join(', ')}`,
           )
@@ -667,7 +683,11 @@ export async function handleOpencodeSession({
             directory,
           })
 
-          pendingPermissions.set(thread.id, {
+          // Track permission in nested map (threadId -> permissionId -> data)
+          if (!pendingPermissions.has(thread.id)) {
+            pendingPermissions.set(thread.id, new Map())
+          }
+          pendingPermissions.get(thread.id)!.set(permission.id, {
             permission,
             messageId,
             directory,
@@ -681,10 +701,18 @@ export async function handleOpencodeSession({
 
           sessionLogger.log(`Permission ${requestID} replied with: ${reply}`)
 
-          const pending = pendingPermissions.get(thread.id)
-          if (pending && pending.permission.id === requestID) {
-            cleanupPermissionContext(pending.contextHash)
-            pendingPermissions.delete(thread.id)
+          // Clean up the specific permission from nested map
+          const threadPermissions = pendingPermissions.get(thread.id)
+          if (threadPermissions) {
+            const pending = threadPermissions.get(requestID)
+            if (pending) {
+              cleanupPermissionContext(pending.contextHash)
+              threadPermissions.delete(requestID)
+              // Remove thread entry if no more pending permissions
+              if (threadPermissions.size === 0) {
+                pendingPermissions.delete(thread.id)
+              }
+            }
           }
         } else if (event.type === 'question.asked') {
           const questionRequest = event.properties

package/src/system-message.ts

@@ -43,6 +43,21 @@ Use --notify-only to create a notification thread without starting an AI session
 npx -y kimaki send --channel ${channelId} --prompt "User cancelled subscription" --notify-only
 
 This is useful for automation (cron jobs, GitHub webhooks, n8n, etc.)
+
+### Session handoff
+
+When you are approaching the **context window limit** or the user explicitly asks to **handoff to a new thread**, use the \`kimaki send\` command to start a fresh session with context:
+
+\`\`\`bash
+npx -y kimaki send --channel ${channelId} --prompt "Continuing from previous session: <summary of current task and state>"
+\`\`\`
+
+The command automatically handles long prompts (over 2000 chars) by sending them as file attachments.
+
+Use this for handoff when:
+- User asks to "handoff", "continue in new thread", or "start fresh session"
+- You detect you're running low on context window space
+- A complex task would benefit from a clean slate with summarized context
 `
     : ''
 }
@@ -52,17 +67,17 @@ IMPORTANT: After editing any files, you MUST execute the critique command using
 
 Execute this after making changes:
 
-bunx critique web --title "Add user authentication flow"
+bunx critique --web "Add user authentication flow"
 
 If there are other unrelated changes in the working directory, filter to only show the files you edited:
 
-bunx critique web --title "Fix database connection retry" -- path/to/file1.ts path/to/file2.ts
+bunx critique --web "Fix database connection retry" --filter "path/to/file1.ts" --filter "path/to/file2.ts"
 
 You can also show latest commit changes using:
 
-bunx critique web --title "Refactor API endpoints" HEAD
+bunx critique HEAD --web "Refactor API endpoints"
 
-bunx critique web --title "Update dependencies" HEAD~1 to get the one before last
+bunx critique HEAD~1 --web "Update dependencies"
 
 Do this in case you committed the changes yourself (only if the user asks so, never commit otherwise).
 

package/src/voice-handler.ts

@@ -506,6 +506,7 @@ export async function processVoiceAttachment({
       EmptyTranscriptionError: (e) => e.message,
       NoResponseContentError: (e) => e.message,
       NoToolResponseError: (e) => e.message,
+      Error: (e) => e.message,
     })
     voiceLogger.error(`Transcription failed:`, transcription)
     await sendThreadMessage(thread, `⚠️ Transcription failed: ${errMsg}`)