kimaki 0.4.31 → 0.4.33

package/dist/discord-utils.js

@@ -5,6 +5,7 @@ import { ChannelType, } from 'discord.js';
 import { Lexer } from 'marked';
 import { extractTagsArrays } from './xml.js';
 import { formatMarkdownTables } from './format-tables.js';
+import { limitHeadingDepth } from './limit-heading-depth.js';
 import { unnestCodeBlocksFromLists } from './unnest-code-blocks.js';
 import { createLogger } from './logger.js';
 const discordLogger = createLogger('DISCORD');
@@ -159,6 +160,7 @@ export async function sendThreadMessage(thread, content, options) {
     const MAX_LENGTH = 2000;
     content = formatMarkdownTables(content);
     content = unnestCodeBlocksFromLists(content);
+    content = limitHeadingDepth(content);
     content = escapeBackticksInCodeBlocks(content);
     // If custom flags provided, send as single message (no chunking)
     if (options?.flags !== undefined) {

package/dist/limit-heading-depth.js

@@ -0,0 +1,25 @@
+// Limit heading depth for Discord.
+// Discord only supports headings up to ### (h3), so this converts
+// ####, #####, etc. to ### to maintain consistent rendering.
+import { Lexer } from 'marked';
+export function limitHeadingDepth(markdown, maxDepth = 3) {
+    const lexer = new Lexer();
+    const tokens = lexer.lex(markdown);
+    let result = '';
+    for (const token of tokens) {
+        if (token.type === 'heading') {
+            const heading = token;
+            if (heading.depth > maxDepth) {
+                const hashes = '#'.repeat(maxDepth);
+                result += hashes + ' ' + heading.text + '\n';
+            }
+            else {
+                result += token.raw;
+            }
+        }
+        else {
+            result += token.raw;
+        }
+    }
+    return result;
+}

package/dist/limit-heading-depth.test.js

@@ -0,0 +1,105 @@
+import { expect, test } from 'vitest';
+import { limitHeadingDepth } from './limit-heading-depth.js';
+test('converts h4 to h3', () => {
+    const input = '#### Fourth level heading';
+    const result = limitHeadingDepth(input);
+    expect(result).toMatchInlineSnapshot(`
+    "### Fourth level heading
+    "
+  `);
+});
+test('converts h5 to h3', () => {
+    const input = '##### Fifth level heading';
+    const result = limitHeadingDepth(input);
+    expect(result).toMatchInlineSnapshot(`
+    "### Fifth level heading
+    "
+  `);
+});
+test('converts h6 to h3', () => {
+    const input = '###### Sixth level heading';
+    const result = limitHeadingDepth(input);
+    expect(result).toMatchInlineSnapshot(`
+    "### Sixth level heading
+    "
+  `);
+});
+test('preserves h3 unchanged', () => {
+    const input = '### Third level heading';
+    const result = limitHeadingDepth(input);
+    expect(result).toMatchInlineSnapshot(`"### Third level heading"`);
+});
+test('preserves h2 unchanged', () => {
+    const input = '## Second level heading';
+    const result = limitHeadingDepth(input);
+    expect(result).toMatchInlineSnapshot(`"## Second level heading"`);
+});
+test('preserves h1 unchanged', () => {
+    const input = '# First level heading';
+    const result = limitHeadingDepth(input);
+    expect(result).toMatchInlineSnapshot(`"# First level heading"`);
+});
+test('handles multiple headings in document', () => {
+    const input = `# Title
+
+Some text
+
+## Section
+
+### Subsection
+
+#### Too deep
+
+##### Even deeper
+
+Regular paragraph
+
+### Back to normal
+`;
+    const result = limitHeadingDepth(input);
+    expect(result).toMatchInlineSnapshot(`
+    "# Title
+
+    Some text
+
+    ## Section
+
+    ### Subsection
+
+    ### Too deep
+    ### Even deeper
+    Regular paragraph
+
+    ### Back to normal
+    "
+  `);
+});
+test('preserves heading with inline formatting', () => {
+    const input = '#### Heading with **bold** and `code`';
+    const result = limitHeadingDepth(input);
+    expect(result).toMatchInlineSnapshot(`
+    "### Heading with **bold** and \`code\`
+    "
+  `);
+});
+test('handles empty markdown', () => {
+    const result = limitHeadingDepth('');
+    expect(result).toMatchInlineSnapshot(`""`);
+});
+test('handles markdown with no headings', () => {
+    const input = 'Just some text\n\nAnd more text';
+    const result = limitHeadingDepth(input);
+    expect(result).toMatchInlineSnapshot(`
+    "Just some text
+
+    And more text"
+  `);
+});
+test('allows custom maxDepth', () => {
+    const input = '### Third level';
+    const result = limitHeadingDepth(input, 2);
+    expect(result).toMatchInlineSnapshot(`
+    "## Third level
+    "
+  `);
+});

package/dist/message-formatting.js

@@ -186,10 +186,10 @@ export function formatTodoList(part) {
     const activeTodo = todos[activeIndex];
     if (activeIndex === -1 || !activeTodo)
         return '';
-    // parenthesized digits ⑴-⒇ for 1-20, fallback to regular number for 21+
-    const parenthesizedDigits = '⑴⑵⑶⑷⑸⑹⑺⑻⑼⑽⑾⑿⒀⒁⒂⒃⒄⒅⒆⒇';
+    // digit-with-period ⒈-⒛ for 1-20, fallback to regular number for 21+
+    const digitWithPeriod = '⒈⒉⒊⒋⒌⒍⒎⒏⒐⒑⒒⒓⒔⒕⒖⒗⒘⒙⒚⒛';
     const todoNumber = activeIndex + 1;
-    const num = todoNumber <= 20 ? parenthesizedDigits[todoNumber - 1] : `(${todoNumber})`;
+    const num = todoNumber <= 20 ? digitWithPeriod[todoNumber - 1] : `${todoNumber}.`;
     const content = activeTodo.content.charAt(0).toLowerCase() + activeTodo.content.slice(1);
     return `${num} **${escapeInlineMarkdown(content)}**`;
 }

package/dist/message-formatting.test.js

@@ -24,7 +24,7 @@ describe('formatTodoList', () => {
                 time: { start: 0, end: 0 },
             },
         };
-        expect(formatTodoList(part)).toMatchInlineSnapshot(`"⑵ **second task**"`);
+        expect(formatTodoList(part)).toMatchInlineSnapshot(`"⒉ **second task**"`);
     });
     test('formats double digit todo numbers', () => {
         const todos = Array.from({ length: 12 }, (_, i) => ({
@@ -47,7 +47,7 @@ describe('formatTodoList', () => {
                 time: { start: 0, end: 0 },
             },
         };
-        expect(formatTodoList(part)).toMatchInlineSnapshot(`"⑿ **task 12**"`);
+        expect(formatTodoList(part)).toMatchInlineSnapshot(`"⒓ **task 12**"`);
     });
     test('lowercases first letter of content', () => {
         const part = {
@@ -68,6 +68,6 @@ describe('formatTodoList', () => {
                 time: { start: 0, end: 0 },
             },
         };
-        expect(formatTodoList(part)).toMatchInlineSnapshot(`"⑴ **fix the bug**"`);
+        expect(formatTodoList(part)).toMatchInlineSnapshot(`"⒈ **fix the bug**"`);
     });
 });

package/dist/session-handler.js

@@ -313,8 +313,38 @@ export async function handleOpencodeSession({ prompt, thread, projectDirectory,
                         stopTyping = startTyping();
                     }
                     if (part.type === 'tool' && part.state.status === 'running') {
+                        // Flush any pending text/reasoning parts before showing the tool
+                        // This ensures text the LLM generated before the tool call is shown first
+                        for (const p of currentParts) {
+                            if (p.type !== 'step-start' && p.type !== 'step-finish' && p.id !== part.id) {
+                                await sendPartMessage(p);
+                            }
+                        }
                         await sendPartMessage(part);
                     }
+                    // Show token usage for completed tools with large output (>5k tokens)
+                    if (part.type === 'tool' && part.state.status === 'completed') {
+                        const output = part.state.output || '';
+                        const outputTokens = Math.ceil(output.length / 4);
+                        const LARGE_OUTPUT_THRESHOLD = 3000;
+                        if (outputTokens >= LARGE_OUTPUT_THRESHOLD) {
+                            const formattedTokens = outputTokens >= 1000
+                                ? `${(outputTokens / 1000).toFixed(1)}k`
+                                : String(outputTokens);
+                            const percentageSuffix = (() => {
+                                if (!modelContextLimit) {
+                                    return '';
+                                }
+                                const pct = (outputTokens / modelContextLimit) * 100;
+                                if (pct < 1) {
+                                    return '';
+                                }
+                                return ` (${pct.toFixed(1)}%)`;
+                            })();
+                            const chunk = `⬦ ${part.tool} returned ${formattedTokens} tokens${percentageSuffix}`;
+                            await thread.send({ content: chunk, flags: SILENT_MESSAGE_FLAGS });
+                        }
+                    }
                     if (part.type === 'reasoning') {
                         await sendPartMessage(part);
                     }

package/package.json

@@ -2,7 +2,17 @@
   "name": "kimaki",
   "module": "index.ts",
   "type": "module",
-  "version": "0.4.31",
+  "version": "0.4.33",
+  "scripts": {
+    "dev": "tsx --env-file .env src/cli.ts",
+    "prepublishOnly": "pnpm tsc",
+    "dev:bun": "DEBUG=1 bun --env-file .env src/cli.ts",
+    "watch": "tsx scripts/watch-session.ts",
+    "test:events": "tsx test-events.ts",
+    "pcm-to-mp3": "bun scripts/pcm-to-mp3",
+    "test:send": "tsx send-test-message.ts",
+    "register-commands": "tsx scripts/register-commands.ts"
+  },
   "repository": "https://github.com/remorses/kimaki",
   "bin": "bin.js",
   "files": [
@@ -45,14 +55,5 @@
     "string-dedent": "^3.0.2",
     "undici": "^7.16.0",
     "zod": "^4.2.1"
-  },
-  "scripts": {
-    "dev": "tsx --env-file .env src/cli.ts",
-    "dev:bun": "DEBUG=1 bun --env-file .env src/cli.ts",
-    "watch": "tsx scripts/watch-session.ts",
-    "test:events": "tsx test-events.ts",
-    "pcm-to-mp3": "bun scripts/pcm-to-mp3",
-    "test:send": "tsx send-test-message.ts",
-    "register-commands": "tsx scripts/register-commands.ts"
   }
-}
+}

package/src/discord-utils.ts

@@ -11,6 +11,7 @@ import {
 import { Lexer } from 'marked'
 import { extractTagsArrays } from './xml.js'
 import { formatMarkdownTables } from './format-tables.js'
+import { limitHeadingDepth } from './limit-heading-depth.js'
 import { unnestCodeBlocksFromLists } from './unnest-code-blocks.js'
 import { createLogger } from './logger.js'
 
@@ -201,6 +202,7 @@ export async function sendThreadMessage(
 
   content = formatMarkdownTables(content)
   content = unnestCodeBlocksFromLists(content)
+  content = limitHeadingDepth(content)
   content = escapeBackticksInCodeBlocks(content)
 
   // If custom flags provided, send as single message (no chunking)

package/src/limit-heading-depth.test.ts

@@ -0,0 +1,116 @@
+import { expect, test } from 'vitest'
+import { limitHeadingDepth } from './limit-heading-depth.js'
+
+test('converts h4 to h3', () => {
+  const input = '#### Fourth level heading'
+  const result = limitHeadingDepth(input)
+  expect(result).toMatchInlineSnapshot(`
+    "### Fourth level heading
+    "
+  `)
+})
+
+test('converts h5 to h3', () => {
+  const input = '##### Fifth level heading'
+  const result = limitHeadingDepth(input)
+  expect(result).toMatchInlineSnapshot(`
+    "### Fifth level heading
+    "
+  `)
+})
+
+test('converts h6 to h3', () => {
+  const input = '###### Sixth level heading'
+  const result = limitHeadingDepth(input)
+  expect(result).toMatchInlineSnapshot(`
+    "### Sixth level heading
+    "
+  `)
+})
+
+test('preserves h3 unchanged', () => {
+  const input = '### Third level heading'
+  const result = limitHeadingDepth(input)
+  expect(result).toMatchInlineSnapshot(`"### Third level heading"`)
+})
+
+test('preserves h2 unchanged', () => {
+  const input = '## Second level heading'
+  const result = limitHeadingDepth(input)
+  expect(result).toMatchInlineSnapshot(`"## Second level heading"`)
+})
+
+test('preserves h1 unchanged', () => {
+  const input = '# First level heading'
+  const result = limitHeadingDepth(input)
+  expect(result).toMatchInlineSnapshot(`"# First level heading"`)
+})
+
+test('handles multiple headings in document', () => {
+  const input = `# Title
+
+Some text
+
+## Section
+
+### Subsection
+
+#### Too deep
+
+##### Even deeper
+
+Regular paragraph
+
+### Back to normal
+`
+  const result = limitHeadingDepth(input)
+  expect(result).toMatchInlineSnapshot(`
+    "# Title
+
+    Some text
+
+    ## Section
+
+    ### Subsection
+
+    ### Too deep
+    ### Even deeper
+    Regular paragraph
+
+    ### Back to normal
+    "
+  `)
+})
+
+test('preserves heading with inline formatting', () => {
+  const input = '#### Heading with **bold** and `code`'
+  const result = limitHeadingDepth(input)
+  expect(result).toMatchInlineSnapshot(`
+    "### Heading with **bold** and \`code\`
+    "
+  `)
+})
+
+test('handles empty markdown', () => {
+  const result = limitHeadingDepth('')
+  expect(result).toMatchInlineSnapshot(`""`)
+})
+
+test('handles markdown with no headings', () => {
+  const input = 'Just some text\n\nAnd more text'
+  const result = limitHeadingDepth(input)
+  expect(result).toMatchInlineSnapshot(`
+    "Just some text
+
+    And more text"
+  `)
+})
+
+test('allows custom maxDepth', () => {
+  const input = '### Third level'
+  const result = limitHeadingDepth(input, 2)
+  expect(result).toMatchInlineSnapshot(`
+    "## Third level
+    "
+  `)
+})

package/src/limit-heading-depth.ts

@@ -0,0 +1,26 @@
+// Limit heading depth for Discord.
+// Discord only supports headings up to ### (h3), so this converts
+// ####, #####, etc. to ### to maintain consistent rendering.
+
+import { Lexer, type Tokens } from 'marked'
+
+export function limitHeadingDepth(markdown: string, maxDepth = 3): string {
+  const lexer = new Lexer()
+  const tokens = lexer.lex(markdown)
+
+  let result = ''
+  for (const token of tokens) {
+    if (token.type === 'heading') {
+      const heading = token as Tokens.Heading
+      if (heading.depth > maxDepth) {
+        const hashes = '#'.repeat(maxDepth)
+        result += hashes + ' ' + heading.text + '\n'
+      } else {
+        result += token.raw
+      }
+    } else {
+      result += token.raw
+    }
+  }
+  return result
+}

package/src/message-formatting.test.ts

@@ -27,7 +27,7 @@ describe('formatTodoList', () => {
       },
     }
 
-    expect(formatTodoList(part)).toMatchInlineSnapshot(`"⑵ **second task**"`)
+    expect(formatTodoList(part)).toMatchInlineSnapshot(`"⒉ **second task**"`)
   })
 
   test('formats double digit todo numbers', () => {
@@ -53,7 +53,7 @@ describe('formatTodoList', () => {
       },
     }
 
-    expect(formatTodoList(part)).toMatchInlineSnapshot(`"⑿ **task 12**"`)
+    expect(formatTodoList(part)).toMatchInlineSnapshot(`"⒓ **task 12**"`)
   })
 
   test('lowercases first letter of content', () => {
@@ -76,6 +76,6 @@ describe('formatTodoList', () => {
       },
     }
 
-    expect(formatTodoList(part)).toMatchInlineSnapshot(`"⑴ **fix the bug**"`)
+    expect(formatTodoList(part)).toMatchInlineSnapshot(`"⒈ **fix the bug**"`)
   })
 })

package/src/message-formatting.ts

@@ -245,10 +245,10 @@ export function formatTodoList(part: Part): string {
   })
   const activeTodo = todos[activeIndex]
   if (activeIndex === -1 || !activeTodo) return ''
-  // parenthesized digits ⑴-⒇ for 1-20, fallback to regular number for 21+
-  const parenthesizedDigits = '⑴⑵⑶⑷⑸⑹⑺⑻⑼⑽⑾⑿⒀⒁⒂⒃⒄⒅⒆⒇'
+  // digit-with-period ⒈-⒛ for 1-20, fallback to regular number for 21+
+  const digitWithPeriod = '⒈⒉⒊⒋⒌⒍⒎⒏⒐⒑⒒⒓⒔⒕⒖⒗⒘⒙⒚⒛'
   const todoNumber = activeIndex + 1
-  const num = todoNumber <= 20 ? parenthesizedDigits[todoNumber - 1] : `(${todoNumber})`
+  const num = todoNumber <= 20 ? digitWithPeriod[todoNumber - 1] : `${todoNumber}.`
   const content = activeTodo.content.charAt(0).toLowerCase() + activeTodo.content.slice(1)
   return `${num} **${escapeInlineMarkdown(content)}**`
 }

package/src/session-handler.ts

@@ -437,9 +437,40 @@ export async function handleOpencodeSession({
           }
 
           if (part.type === 'tool' && part.state.status === 'running') {
+            // Flush any pending text/reasoning parts before showing the tool
+            // This ensures text the LLM generated before the tool call is shown first
+            for (const p of currentParts) {
+              if (p.type !== 'step-start' && p.type !== 'step-finish' && p.id !== part.id) {
+                await sendPartMessage(p)
+              }
+            }
             await sendPartMessage(part)
           }
 
+          // Show token usage for completed tools with large output (>5k tokens)
+          if (part.type === 'tool' && part.state.status === 'completed') {
+            const output = part.state.output || ''
+            const outputTokens = Math.ceil(output.length / 4)
+            const LARGE_OUTPUT_THRESHOLD = 3000
+            if (outputTokens >= LARGE_OUTPUT_THRESHOLD) {
+              const formattedTokens = outputTokens >= 1000
+                ? `${(outputTokens / 1000).toFixed(1)}k`
+                : String(outputTokens)
+              const percentageSuffix = (() => {
+                if (!modelContextLimit) {
+                  return ''
+                }
+                const pct = (outputTokens / modelContextLimit) * 100
+                if (pct < 1) {
+                  return ''
+                }
+                return ` (${pct.toFixed(1)}%)`
+              })()
+              const chunk = `⬦ ${part.tool} returned ${formattedTokens} tokens${percentageSuffix}`
+              await thread.send({ content: chunk, flags: SILENT_MESSAGE_FLAGS })
+            }
+          }
+
           if (part.type === 'reasoning') {
             await sendPartMessage(part)
           }

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 Kimaki
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.