817 Commits

• Fix export HTML styling issues

  - Match help-bar font size (11px) with header-info
  - Add newline after 'Available Tools' header
  - Remove excessive margin-top from tool-output

  Mario Zechner · 2026-01-01 21:34:07 +01:00
  89db7ed024
• Remove unused imports and variables
  Mario Zechner · 2026-01-01 21:14:36 +01:00
  93aaf8160e
• Refactor export-html and add /share command

  - Split template into separate files: template.html, template.css, template.js
  - Add tree visualization sidebar for session navigation
  - Fix HTML sanitization to prevent <style> tags breaking DOM
  - Add DOM node caching for faster re-renders
  - Fix tree indentation to match tree-selector.ts
  - Add /share command to upload session as GitHub gist
  - Support shittycodingagent.ai/session?{gistId} URLs
  
  Closes #375, closes #380

  Mario Zechner · 2026-01-01 21:13:40 +01:00
  3fa9eb58b8
• Show edit diff before tool execution (fixes #393)

  - Extract diff computation from edit.ts into shared edit-diff.ts
  - ToolExecutionComponent computes and caches diff when args are complete
  - Diff is visible while permission hooks block, before tool executes

  Mario Zechner · 2026-01-01 20:34:19 +01:00
  1ed009e2cf
• Fix export-html tree sidebar to match TUI tree-selector

  - Show tool results in default filter (not hidden)
  - Branch summary shows summary text inline
  - Custom message support in tree with customType label
  - Remove extra padding from tree nodes (use line-height)
  - Remove border styling from active/in-path nodes
  - Consistent 18px line-height for tree entries

  Mario Zechner · 2026-01-01 17:25:30 +01:00
  173b81bc04
• Fix export-html message stats and help bar

  - Fix entry type names: branch_summary, custom_message (snake_case)
  - Fix toolResult role (was 'tool')
  - Count all entry types: user, assistant, tool results, custom, compactions, branch summaries
  - Use global stats for tokens/cost (all entries), not just current branch
  - Make help bar more prominent (12px, full opacity)
  - Remove Esc shortcut from help bar

  Mario Zechner · 2026-01-01 17:16:47 +01:00
  a9da0ce3fd
• Fix export-html header stats and UX

  - Header h1 font size now 12px (matches body)
  - Token/cost stats now computed for all entries, not just current branch
  - Token display matches footer format: ↑input ↓output Rcache Wcache
  - Cost display uses 3 decimal places like footer
  - Scroll to target uses requestAnimationFrame for DOM readiness
  - Initial load and Escape scroll to bottom, tree clicks scroll to target

  Mario Zechner · 2026-01-01 17:12:44 +01:00
  9e5163c296
• Fix export-html spacing to use line-height based system

  - Add --line-height CSS variable (18px = 12px font * 1.5)
  - Convert all padding/margin to use var(--line-height)
  - Remove fractional values for terminal-like consistency
  - Fix gap between consecutive tool executions
  - Remove extra padding from error-text and model-change
  - Fix thinking toggle to show 'Thinking ...' when collapsed
  - Remove top padding after timestamps in assistant messages
  - Remove bottom padding from assistant-text

  Mario Zechner · 2026-01-01 14:28:31 +01:00
  f16fa1efb2
• Fix export-html styling and behavior

  - Fix UTF-8 decoding with TextDecoder for base64 session data
  - Use toolOutput color for expand hints (not borderAccent)
  - Remove '- click to expand' text to match TUI
  - Ctrl+O toggles expanded state (not visibility) on tool outputs
  - Edit diffs always visible (not affected by Ctrl+O)
  - Remove Ctrl+F override to allow browser search
  - Replace tabs with 3 spaces in all tool outputs
  - Fix syntax highlighting default color to use --text
  - Add more hljs token selectors (property, punctuation, operator)
  - Compaction uses customMessageBg/Label/Text colors
  - Model change uses dim color without background
  - Scroll to end on initial load
  - Pointer cursor on expandable elements

  Mario Zechner · 2026-01-01 13:24:01 +01:00
  fcb700701e
• Add image support and mobile UX improvements to export-html

  - Display images from read tool results (base64 encoded)
  - Add ellipsis for truncated tree entries
  - Make mobile hamburger button more subtle
  - Add X close button in sidebar header on mobile
  - Hide hamburger when sidebar is open

  Mario Zechner · 2026-01-01 12:41:58 +01:00
  55fd8d9fed
• Polish export-html tree styling

  - Add subtle border between sidebar and content
  - Use selectedBg for tree node hover state
  - Add left border accent for active and in-path nodes

  Mario Zechner · 2026-01-01 03:46:08 +01:00
  c8c7e0fba4
• Improve export-html styling with derived export colors

  - Add deriveExportColors() to compute page/card/info backgrounds from userMessageBg
  - Use luminance detection to adapt colors for light/dark themes
  - Use info-bg for model-change, compaction, system-prompt sections
  - Use selectedBg for hover states and summary backgrounds
  - Add scroll-to-message with highlight when clicking tree nodes
  - Fix mobile overlay to close sidebar on click
  - Wider sidebar (400px) with search and filter controls

  Mario Zechner · 2026-01-01 03:44:19 +01:00
  f53cabe1e3
• WIP: Rewrite export-html with tree sidebar, client-side rendering

  - Add tree sidebar with search and filter (Default/All/Labels)
  - Client-side markdown/syntax highlighting via vendored marked.js + highlight.js
  - Base64 encode session data to avoid escaping issues
  - Reuse theme.ts color tokens via getResolvedThemeColors()
  - Sticky sidebar, responsive mobile layout with overlay
  - Click tree node to scroll to message
  - Keyboard shortcuts: Esc to reset, Ctrl/Cmd+F to search

  Mario Zechner · 2026-01-01 03:36:47 +01:00
  256fa575fb
• fix: enabledModels now supports glob patterns for OAuth providers

  Added glob pattern support (e.g., github-copilot/*, *sonnet*) to --models
  and enabledModels. Patterns are matched against both provider/modelId and
  just modelId, so *sonnet* works without requiring anthropic/*sonnet*.
  
  The existing fuzzy substring matching for non-glob patterns is preserved.
  
  fixes #337

  Mario Zechner · 2026-01-01 02:04:04 +01:00
  46bb5dcde8
• Merge main, resolve CHANGELOG conflict
  Mario Zechner · 2026-01-01 00:10:46 +01:00
  c15efdbcd9
• Add setEditorText/getEditorText to hook UI context, improve custom() API

  - Add setEditorText() and getEditorText() to HookUIContext for prompt generator pattern
  - custom() now accepts async factories for fire-and-forget work
  - Add CancellableLoader component to tui package
  - Add BorderedLoader component for hooks with cancel UI
  - Export HookAPI, HookContext, HookFactory from main package
  - Update all examples to import from packages instead of relative paths
  - Update hooks.md and custom-tools.md documentation
  
  fixes #350

  Mario Zechner · 2026-01-01 00:04:56 +01:00
  6f7c10e323
• Fix hook tool_result event not emitted for tool errors

  Tools are supposed to throw on error. What needs fixing is that we need to report tool_result for erroneous tool executions as well.
  
  Fixes #374

  Mario Zechner · 2025-12-31 17:12:55 +01:00
  02d0d6e192
• fix(coding-agent): save initial model and thinking level to session

  When creating a new session, initial model and thinking level were set
  on the agent but never saved to session file. This caused --resume to
  default thinking level to 'off'.
  
  fixes #342

  Aliou Diallo · 2025-12-31 15:21:41 +01:00
  98c85bf36a
• Change branch() to use entryId instead of entryIndex

  - AgentSession.branch(entryId: string) now takes entry ID
  - SessionBeforeBranchEvent.entryId replaces entryIndex
  - getUserMessagesForBranching() returns entryId
  - Update RPC types and client
  - Update UserMessageSelectorComponent
  - Update hook examples and tests
  - Update docs (hooks.md, sdk.md)

  Mario Zechner · 2025-12-31 13:47:34 +01:00
  8e1e99ca05
• Add custom models/providers to system prompt doc references
  Mario Zechner · 2025-12-31 13:18:05 +01:00
  67a1b9581c
• Fix system prompt: add specific doc/example paths for each topic
  Mario Zechner · 2025-12-31 13:17:25 +01:00
  dbdb99c486
• Add creation hints to docs and update system prompt

  - System prompt now instructs to read docs AND examples, follow cross-refs
  - Each doc starts with 'pi can create X. Ask it to build one.'

  Mario Zechner · 2025-12-31 13:16:44 +01:00
  84b663276d
• Add category hints to examples path in system prompt
  Mario Zechner · 2025-12-31 13:14:06 +01:00
  57dc16d9b9
• Add examples path to system prompt

  Agent can now find examples at the documented path for
  hooks, custom tools, and SDK usage.

  Mario Zechner · 2025-12-31 13:13:12 +01:00
  d1465fa0ca
• Remove hook execution timeouts

  - Remove timeout logic from HookRunner
  - Remove hookTimeout from Settings interface
  - Remove getHookTimeout/setHookTimeout methods
  - Update CHANGELOG.md and hooks.md
  
  Timeouts were inconsistently applied and caused issues with
  legitimate slow operations (LLM calls, user prompts). Users can
  use Ctrl+C to abort hung hooks.

  Mario Zechner · 2025-12-31 12:57:54 +01:00
  88e39471ea
• Reorder execute params: (toolCallId, params, onUpdate, ctx, signal?)

  Optional signal now at the end for cleaner API

  Mario Zechner · 2025-12-31 12:14:28 +01:00
  19c4182c21
• Rework custom tools API with CustomToolContext

  - CustomAgentTool renamed to CustomTool
  - ToolAPI renamed to CustomToolAPI
  - ToolContext renamed to CustomToolContext
  - ToolSessionEvent renamed to CustomToolSessionEvent
  - Added CustomToolContext parameter to execute() and onSession()
  - CustomToolFactory now returns CustomTool<any, any> for type compatibility
  - dispose() replaced with onSession({ reason: 'shutdown' })
  - Added wrapCustomTool() to convert CustomTool to AgentTool
  - Session exposes setToolUIContext() instead of leaking internals
  - Fix ToolExecutionComponent to sync with toolOutputExpanded state
  - Update all custom tool examples for new API

  Mario Zechner · 2025-12-31 12:05:24 +01:00
  568150f18b
• Replace custom tool dispose() with shutdown session event

  Breaking change: CustomAgentTool.dispose() removed. Use onSession with
  reason 'shutdown' instead for cleanup.
  
  - Add 'shutdown' to SessionEvent.reason for custom tools
  - Remove dispose() method from CustomAgentTool interface
  - Make emitToolSessionEvent() public on AgentSession
  - Emit shutdown event to tools in InteractiveMode.shutdown()
  - Update custom-tools.md with new API and examples

  Mario Zechner · 2025-12-31 02:55:45 +01:00
  ff78ac2f84
• refactor(coding-agent): fix compaction for branched sessions, consolidate hook context types

  Compaction API:
  - prepareCompaction() now takes (pathEntries, settings) only
  - CompactionPreparation restructured: removed cutPoint/messagesToKeep/boundaryStart, added turnPrefixMessages/isSplitTurn/previousSummary/fileOps/settings
  - compact() now takes (preparation, model, apiKey, customInstructions?, signal?)
  - Fixed token overflow by using getPath() instead of getEntries()
  
  Hook types:
  - HookEventContext renamed to HookContext
  - HookCommandContext removed, RegisteredCommand.handler takes (args, ctx)
  - HookContext now includes model field
  - SessionBeforeCompactEvent: removed previousCompactions/model, added branchEntries
  - SessionBeforeTreeEvent: removed model (use ctx.model)
  - HookRunner.initialize() added for modes to set up callbacks

  Mario Zechner · 2025-12-31 02:24:24 +01:00
  ddda8b124c
• Extract shared compaction/branch-summarization utils

  - New utils.ts with shared functions:
    - FileOperations type and createFileOps()
    - extractFileOpsFromMessage()
    - computeFileLists()
    - formatFileOperations()
    - serializeConversation()
    - SUMMARIZATION_SYSTEM_PROMPT
  
  - branch-summarization.ts now uses:
    - Serialization approach (conversation as text, not LLM messages)
    - completeSimple with system prompt
    - Shared utility functions

  Mario Zechner · 2025-12-30 22:42:24 +01:00
  81f4cdf3e3
• Use convertToLlm before serializing, include thinking, remove truncation

  - serializeConversation now takes Message[] (after convertToLlm)
  - Handles all custom message types via convertToLlm
  - Includes thinking blocks as [Assistant thinking]
  - Removes truncation of tool args and results (already token-budgeted)

  Mario Zechner · 2025-12-30 22:42:24 +01:00
  17ce3814a8
• Serialize conversation to text for summarization

  Instead of passing conversation as LLM messages (which makes the model
  try to continue it), serialize to text wrapped in <conversation> tags.
  
  - serializeConversation() formats messages as [User]/[Assistant]/[Tool result]
  - Tool calls shown as function(args) format
  - Tool results truncated to prevent bloat
  - Conversation wrapped in <conversation> tags in the prompt

  Mario Zechner · 2025-12-30 22:42:24 +01:00
  2add465fbe
• Add system prompt to compaction summarization

  - SUMMARIZATION_SYSTEM_PROMPT explains the task clearly
  - Tells model to NOT continue conversation, ONLY output summary
  - Updated prompts to reference 'messages above' for clarity
  - Pass systemPrompt to completeSimple

  Mario Zechner · 2025-12-30 22:42:24 +01:00
  3c6c9e52cd
• Add file tracking and iterative summary merging to compaction

  - CompactionDetails type with readFiles/modifiedFiles
  - extractFileOperations collects from tool calls and previous compaction details
  - UPDATE_SUMMARIZATION_PROMPT for merging with previous summary
  - generateSummary now accepts previousSummary for iterative updates
  - compact() extracts files, passes previousSummary, returns details
  - Only merges from !fromHook compaction entries (backward compatible)

  Mario Zechner · 2025-12-30 22:42:24 +01:00
  09d6131bef
• Pass fromHook to appendCompaction for both manual and auto compaction
  Mario Zechner · 2025-12-30 22:42:24 +01:00
  d4dc07ab20
• Add fromHook field to CompactionEntry and BranchSummaryEntry

  - fromHook: true = hook generated, skip file extraction
  - fromHook: undefined/false = pi generated, extract files (backward compatible)
  - branchWithSummary now accepts fromHook parameter
  - File extraction only runs for !entry.fromHook entries

  Mario Zechner · 2025-12-30 22:42:24 +01:00
  f118cdc67b
• Add preamble to branch summary for context

  Prepends: 'The user explored a different conversation branch before
  returning here. Summary of that exploration:'
  
  This helps the LLM understand the summary is background context from
  a different path, not the current thread being continued.

  Mario Zechner · 2025-12-30 22:42:24 +01:00
  8fe8fe9920
• Fix branch summarization: use convertToLlm instead of messagesToText

  The old messagesToText only extracted text content, losing all tool calls.
  Now uses convertToLlm like compaction does, preserving the full conversation
  including tool calls, which is essential for generating useful summaries.

  Mario Zechner · 2025-12-30 22:42:24 +01:00
  2ba69878ed
• Return defensive copies from SettingsManager getters

  getHookPaths(), getCustomToolPaths(), and getSkillsSettings() now return
  copies of arrays instead of references to internal state. This prevents
  callers from accidentally mutating settings without going through setters.
  
  Fixes #361

  Mario Zechner · 2025-12-30 22:42:24 +01:00
  0fe9f74b4e
• Fix common ancestor finding: iterate backwards to find deepest ancestor

  getPath returns root-first, so iterating forward found root as common
  ancestor instead of the deepest shared node. Now iterates backwards.

  Mario Zechner · 2025-12-30 22:42:24 +01:00
  92947a3dc4
• Remove restrictive sentence limits from Goal section
  Mario Zechner · 2025-12-30 22:42:24 +01:00
  a602e8aba8
• Use structured output format for compaction and branch summarization

  Both now use consistent sections:
  - Goal
  - Constraints & Preferences
  - Progress (Done/In Progress/Blocked)
  - Key Decisions
  - Next Steps
  - Critical Context (compaction only)
  
  Prompts instruct LLM to use EXACT format and preserve file paths/function names.

  Mario Zechner · 2025-12-30 22:42:24 +01:00
  ac71aac090
• Append file lists to summary text for LLM context and TUI display

  Files are included both:
  - In summary text as <read-files>/<modified-files> tags (visible to LLM and TUI)
  - In details for structured access by code

  Mario Zechner · 2025-12-30 22:42:24 +01:00
  d1a49c45ff
• Store file lists in BranchSummaryEntry.details for cumulative tracking

  - BranchSummaryResult now returns readFiles and modifiedFiles separately
  - BranchSummaryDetails type for details: { readFiles, modifiedFiles }
  - branchWithSummary accepts optional details parameter
  - Collect files from existing branch_summary.details when preparing entries
  - Files accumulate across nested branch summaries

  Mario Zechner · 2025-12-30 22:42:24 +01:00
  4ef3325cec
• Use XML tags for file operations in branch summary

  <read-files> and <modified-files> with one path per line

  Mario Zechner · 2025-12-30 22:42:24 +01:00
  04f2fcf004
• Fix file ops: Read (not modified) and Modified (edited or written)

  - Read: files only read, not modified
  - Modified: files that were edited OR written
  - Avoids duplicate listings when same file is read then edited

  Mario Zechner · 2025-12-30 22:42:24 +01:00
  e7bfb5afe7
• Use reserveTokens for branch summary (tokens left for prompt + response)

  - tokenBudget = contextWindow - reserveTokens
  - Default 16384, same as compaction
  - Consistent naming with CompactionSettings.reserveTokens

  Mario Zechner · 2025-12-30 22:42:24 +01:00
  dc5fc4fc40
• Use token-based maxTokens instead of fraction-based reserveFraction

  - BranchSummarySettings.maxTokens (default 100000) instead of reserveFraction
  - More intuitive and consistent with CompactionSettings.keepRecentTokens

  Mario Zechner · 2025-12-30 22:42:24 +01:00
  f5f39f08f1
• Use AgentMessage in BranchPreparation and add BranchSummarySettings

  - BranchPreparation now uses AgentMessage[] instead of custom type
  - Reuse getMessageFromEntry pattern from compaction.ts
  - Add BranchSummarySettings with reserveFraction to settings.json
  - Add getBranchSummarySettings() to SettingsManager
  - Use settings for reserveFraction instead of hardcoded value

  Mario Zechner · 2025-12-30 22:42:23 +01:00
  839a46e6fe
• Add ReadonlySessionManager and refactor branch summarization

  - Add ReadonlySessionManager interface to session-manager.ts
  - Re-export from hooks/index.ts
  - Add collectEntriesForBranchSummary() to extract entries for summarization
  - Don't stop at compaction boundaries (include their summaries as context)
  - Add token budget support to prepareBranchEntries()
  - Walk entries newest-to-oldest to prioritize recent context
  - Use options object for generateBranchSummary()
  - Handle compaction entries as context summaries
  - Export new types: CollectEntriesResult, GenerateBranchSummaryOptions

  Mario Zechner · 2025-12-30 22:42:23 +01:00
  08fab16e2d