goatchain 0.0.24 → 0.0.26

package/dist/tool/index.d.ts

@@ -1,6 +1,6 @@
 export { BaseTool, errorContent, imageContent, textContent } from './base';
-export { AskUserTool, BashTool, EditTool, EnterPlanModeTool, ExitPlanModeTool, getBackgroundProcesses, GlobTool, GrepTool, isProcessRunning, killAllBackgroundProcesses, killProcessesByCategory, killProcessTree, ReadTool, TodoPlanTool, TodoWriteTool, WebFetchTool, WebSearchTool, WriteTool, } from './builtin';
-export type { AskUserArgs, AskUserResult, BashArgs, BashResult, EditArgs, EditResult, EnterPlanModeArgs, EnterPlanModeResult, ExitPlanModeArgs, ExitPlanModeResult, FetchFormat, GlobArgs, GlobResult, GrepArgs, GrepOutputMode, GrepResult, Question, QuestionOption, ReadArgs, ReadResult, TodoItem, TodoPlanArgs, TodoPlanResult, TodoStatus, TodoWriteArgs, TodoWriteResult, TrackedProcess, WebFetchArgs, WebFetchResult, WebSearchArgs, WebSearchResult, WriteArgs, WriteResult, } from './builtin';
+export { AskUserTool, BashTool, EditTool, EnterPlanModeTool, ExitPlanModeTool, getBackgroundProcesses, GlobTool, GrepTool, isProcessRunning, killAllBackgroundProcesses, killProcessesByCategory, killProcessTree, ReadTool, softWrapLines, TodoPlanTool, TodoWriteTool, WebFetchTool, WebSearchTool, WriteTool, } from './builtin';
+export type { AskUserArgs, AskUserResult, BashArgs, BashResult, DeliveryMode, EditArgs, EditResult, EnterPlanModeArgs, EnterPlanModeResult, ExitPlanModeArgs, ExitPlanModeResult, FetchFormat, GlobArgs, GlobResult, GrepArgs, GrepOutputMode, GrepResult, Question, QuestionOption, ReadArgs, ReadResult, TodoItem, TodoPlanArgs, TodoPlanResult, TodoStatus, TodoWriteArgs, TodoWriteResult, TrackedProcess, WebFetchArgs, WebFetchResult, WebSearchArgs, WebSearchResult, WriteArgs, WriteResult, } from './builtin';
 export { FilteredToolRegistry } from './FilteredToolRegistry';
 export { ToolRegistry } from './registry';
 export type { RiskLevel, ToolApprovalResult, ToolApprovalSettings, ToolApprovalStrategy, ToolExecutionContext, ToolExecutionContextInput, ToolRunUsage, } from './types';

package/dist/types/common.d.ts

@@ -52,3 +52,38 @@ export interface Usage {
     completionTokens: number;
     totalTokens: number;
 }
+/**
+ * Small reference stored in checkpoint metadata (JSON-safe).
+ *
+ * Only contains the file path and metadata needed to re-read the file on
+ * resume.  The actual base64 data is stored separately as transient data
+ * that is **not** persisted in checkpoints.
+ */
+export interface ToolAttachmentRef {
+    /** 'image' for images, 'document' for PDFs */
+    type: 'image' | 'document';
+    /** Absolute file path – used to re-read on resume */
+    filePath: string;
+    /** MIME type (e.g. 'image/png', 'application/pdf') */
+    mimeType: string;
+    /** Display name (basename) */
+    name: string;
+    /** File size in bytes – used to detect changes on re-read */
+    fileSize: number;
+}
+/**
+ * Full attachment with base64 data (transient, in-memory only).
+ *
+ * Stored in `state.metadata._toolAttachmentData` which is added to
+ * `TRANSIENT_METADATA_KEYS` and therefore **not** saved to checkpoint.
+ */
+export interface ToolResultAttachment {
+    /** 'image' for images, 'document' for PDFs */
+    type: 'image' | 'document';
+    /** Base64-encoded file content */
+    data: string;
+    /** MIME type (e.g. 'image/png', 'application/pdf') */
+    mimeType: string;
+    /** Display name */
+    name?: string;
+}

package/dist/types/event.d.ts

@@ -5,7 +5,7 @@ import type { AgentLoopCheckpoint } from './snapshot';
 /**
  * Event types for streaming responses
  */
-export type AgentEventType = 'text_start' | 'text_delta' | 'text_end' | 'tool_call_start' | 'tool_call_delta' | 'tool_call_end' | 'tool_result' | 'tool_output_start' | 'tool_output_delta' | 'tool_approval_requested' | 'requires_action' | 'tool_skipped' | 'thinking_start' | 'thinking_delta' | 'thinking_end' | 'done' | 'iteration_start' | 'iteration_end' | 'session_created' | 'subagent_event';
+export type AgentEventType = 'text_start' | 'text_delta' | 'text_end' | 'tool_call_start' | 'tool_call_delta' | 'tool_call_end' | 'tool_result' | 'tool_output_start' | 'tool_output_delta' | 'tool_approval_requested' | 'requires_action' | 'tool_skipped' | 'thinking_start' | 'thinking_delta' | 'thinking_end' | 'done' | 'iteration_start' | 'iteration_end' | 'session_created' | 'subagent_event' | 'completion_assessed' | 'compression_start' | 'compression_end';
 /**
  * Base event interface
  */
@@ -45,6 +45,8 @@ export interface ToolCallDeltaEvent extends BaseEvent {
     callId: string;
     toolName?: string;
     argsTextDelta?: string;
+    /** Optional line count hint for Write tool content. */
+    linesWritten?: number;
 }
 export interface ToolCallEndEvent extends BaseEvent {
     type: 'tool_call_end';
@@ -174,7 +176,7 @@ export interface DoneEvent extends BaseEvent {
     /** Final accumulated response text */
     finalResponse?: string;
     /** Stop reason for the loop */
-    stopReason?: 'max_iterations' | 'final_response' | 'error' | 'cancelled' | 'approval_required';
+    stopReason?: 'max_iterations' | 'final_response' | 'error' | 'cancelled' | 'approval_required' | 'max_follow_ups';
     /** Stop reason reported by the last model call (if available) */
     modelStopReason?: ModelStopReason;
     /**
@@ -218,6 +220,23 @@ export interface IterationEndEvent extends BaseEvent {
 export interface SessionCreatedEvent extends BaseEvent {
     type: 'session_created';
 }
+/**
+ * Completion assessed event - emitted when the long_running middleware assessor
+ * evaluates whether the task is complete.
+ *
+ * Only emitted when `createLongRunningMiddleware()` is registered.
+ */
+export interface CompletionAssessedEvent extends BaseEvent {
+    type: 'completion_assessed';
+    /** Whether the assessor determined the task is complete */
+    isComplete: boolean;
+    /** Reason for the assessment */
+    reason?: string;
+    /** Name of the assessor that made the determination */
+    assessorName: string;
+    /** Current follow-up round number */
+    followUpRound: number;
+}
 /**
  * Subagent event - wraps events emitted by delegated subagents
  *
@@ -235,7 +254,40 @@ export interface SubagentEvent extends BaseEvent {
     /** Optional: task description for context */
     taskDescription?: string;
 }
+/**
+ * Compression start event - emitted when AI-based summary compression begins.
+ *
+ * Only emitted for summary compression (Stage 1), not tool compression (Stage 2).
+ * Emitted by `createContextCompressionMiddleware()` when tokens exceed 80% threshold.
+ */
+export interface CompressionStartEvent extends BaseEvent {
+    type: 'compression_start';
+    /** Token count before compression */
+    tokensBefore: number;
+    /** Token threshold that triggered compression */
+    threshold: number;
+}
+/**
+ * Compression end event - emitted when AI-based summary compression completes.
+ *
+ * Only emitted for summary compression (Stage 1), not tool compression (Stage 2).
+ */
+export interface CompressionEndEvent extends BaseEvent {
+    type: 'compression_end';
+    /** Token count before compression */
+    tokensBefore: number;
+    /** Token count after compression */
+    tokensAfter: number;
+    /** Number of messages removed by summarization */
+    removedMessages: number;
+    /** Number of tool outputs cleared by tool compression */
+    clearedToolOutputs: number;
+    /** Whether a summary was successfully generated */
+    summaryGenerated: boolean;
+    /** Time taken for compression in milliseconds */
+    elapsedMs: number;
+}
 /**
  * Union type for all agent events
  */
-export type AgentEvent = TextStartEvent | TextDeltaEvent | TextEndEvent | ToolCallStartEvent | ToolCallDeltaEvent | ToolCallEndEvent | ToolResultEvent | ToolOutputStartEvent | ToolOutputDeltaEvent | ToolApprovalRequestedEvent | RequiresActionEvent | ToolSkippedEvent | ThinkingStartEvent | ThinkingDeltaEvent | ThinkingEndEvent | DoneEvent | IterationStartEvent | IterationEndEvent | SessionCreatedEvent | SubagentEvent;
+export type AgentEvent = TextStartEvent | TextDeltaEvent | TextEndEvent | ToolCallStartEvent | ToolCallDeltaEvent | ToolCallEndEvent | ToolResultEvent | ToolOutputStartEvent | ToolOutputDeltaEvent | ToolApprovalRequestedEvent | RequiresActionEvent | ToolSkippedEvent | ThinkingStartEvent | ThinkingDeltaEvent | ThinkingEndEvent | DoneEvent | IterationStartEvent | IterationEndEvent | SessionCreatedEvent | SubagentEvent | CompletionAssessedEvent | CompressionStartEvent | CompressionEndEvent;

package/dist/types/snapshot.d.ts

@@ -320,7 +320,7 @@ export interface AgentLoopCheckpoint {
     /**
      * Stop reason (if stopped)
      */
-    stopReason?: 'max_iterations' | 'final_response' | 'error' | 'cancelled' | 'approval_required';
+    stopReason?: 'max_iterations' | 'final_response' | 'error' | 'cancelled' | 'approval_required' | 'max_follow_ups';
     /**
      * Stop reason reported by the last model call (if available).
      */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "goatchain",
   "type": "module",
-  "version": "0.0.24",
+  "version": "0.0.26",
   "workspaces": [
     "packages/*"
   ],
@@ -35,6 +35,7 @@
     "prettier:check": "prettier --check \"src/**/*.{ts,js,json,md}\" \"examples/**/*.{ts,js,json,md}\" \"packages/cli/src/**/*.{ts,js,json,md}\"",
     "format:check": "prettier --check \"src/**/*.{ts,js,json,md}\" \"examples/**/*.{ts,js,json,md}\" \"packages/cli/src/**/*.{ts,js,json,md}\"",
     "test": "bun test --preload ./packages/cli/test/setup.ts ./test ./packages/cli/test",
+    "test:colors": "bun test ./packages/tui/test/terminal-capability.test.ts ./packages/tui/test/stdout-renderer-color-mode.test.ts",
     "check:commit": "GOATCHAIN_RUN_INTEGRATION=0 bun run typecheck && bun run lint && bun run format:check && bun run test && cd packages/cli && bun run typecheck && cd ../tui && bun run typecheck && bun run format && bun run test",
     "diff:demo": "GOATCHAIN_DIFF_DEMO=1 bun test --preload ./packages/cli/test/setup.ts ./packages/cli/test/diff-highlight-console.demo.test.ts",
     "test:serial": "bun run --filter '*' build && bun test --preload ./packages/cli/test/setup.ts ./test ./packages/cli/test",
@@ -61,6 +62,7 @@
     "providers:update": "node packages/cli/scripts/update-provider-models.mjs",
     "release": "bumpp --commit --no-verify --no-tag --no-push && bun run build && bun publish",
     "release:cli": "cd packages/cli && bumpp --commit --no-verify --no-tag --no-push && bun run build && bun publish",
+    "publish:bin": "node npmbin/scripts/publish.mjs",
     "acp-server": "bun run packages/cli/src/acp-server.ts",
     "prepare": "bash scripts/setup-githooks.sh"
   },
@@ -111,4 +113,4 @@
     "@ast-grep/napi"
   ],
   "prettier": "@sxzz/prettier-config"
-}
+}