goatchain 0.0.20 → 0.0.22

package/README.md

@@ -120,6 +120,7 @@ session.send('Read the README.md file')
 ```
 
 **Benefits:**
+
 - Automatically sets the working directory for all tools that support it
 - Persisted across session saves and restores
 - Can be changed at runtime with `session.setCwd()`
@@ -614,10 +615,10 @@ interface ToolHooks {
   // - If allow: false, tool is blocked
   // - Can modify tool call with modifiedToolCall
   preToolUse?: (ctx: HookContext) => Promise<PreToolUseResult>
-  
+
   // Called after successful tool execution
   postToolUse?: (ctx: HookContext, result: unknown) => Promise<void>
-  
+
   // Called after tool execution failure
   postToolUseFailure?: (ctx: HookContext, error: Error) => Promise<void>
 }
@@ -653,9 +654,7 @@ const agent = new Agent({
   name: 'MyAgent',
   systemPrompt: 'You are helpful.',
   model,
-  tools: new ToolRegistry()
-    .register(new ReadTool())
-    .register(new WriteTool()),
+  tools: new ToolRegistry().register(new ReadTool()).register(new WriteTool()),
 })
 
 // Create session with hooks
@@ -664,16 +663,16 @@ const session = await agent.createSession({
     preToolUse: async (ctx) => {
       const toolName = ctx.toolCall.function.name
       console.log(`Tool requested: ${toolName}`)
-      
+
       // Returning { allow: true } skips approval flow and executes tool immediately
       // Returning { allow: false } blocks tool execution
       return { allow: true }
     },
-    
+
     postToolUse: async (ctx, result) => {
       console.log(`Tool ${ctx.toolCall.function.name} completed successfully`)
     },
-    
+
     postToolUseFailure: async (ctx, error) => {
       console.error(`Tool ${ctx.toolCall.function.name} failed:`, error)
     },
@@ -694,12 +693,12 @@ function shouldAutoApprove(toolName: string, riskLevel: RiskLevel): boolean {
   if (riskLevel === 'safe' || riskLevel === 'low') {
     return true
   }
-  
+
   // Block critical tools
   if (riskLevel === 'critical') {
     return false
   }
-  
+
   // For medium/high risk, you can implement custom logic
   // e.g., check environment, user permissions, etc.
   return process.env.AUTO_APPROVE_ALL === 'true'
@@ -711,13 +710,13 @@ const session = await agent.createSession({
       const tool = agent.tools.get(ctx.toolCall.function.name)
       const riskLevel = tool?.riskLevel ?? 'safe'
       const allow = shouldAutoApprove(ctx.toolCall.function.name, riskLevel)
-      
+
       if (allow) {
         console.log(`✓ Auto-approved: ${ctx.toolCall.function.name}`)
       } else {
         console.log(`✗ Blocked: ${ctx.toolCall.function.name}`)
       }
-      
+
       return { allow }
     },
   },
@@ -747,6 +746,7 @@ for await (const event of session.receive()) {
 ```
 
 **Use cases:**
+
 - **Automated workflows**: Scripts that run without user interaction
 - **Testing**: E2E tests that need tools to execute automatically
 - **Trusted environments**: When you trust the agent's tool usage completely
@@ -789,8 +789,9 @@ session.send('Create a file and delete it', {
 for await (const event of session.receive()) {
   if (event.type === 'requires_action') {
     // Save checkpoint
-    checkpoint = event.checkpoint || 
-      await agent.stateStore?.loadCheckpoint(event.checkpointRef?.sessionId)
+    checkpoint =
+      event.checkpoint ||
+      (await agent.stateStore?.loadCheckpoint(event.checkpointRef?.sessionId))
     break // Pause here
   }
 }
@@ -802,12 +803,12 @@ if (checkpoint) {
     checkpoint.pendingToolCalls.map((pending) => {
       const toolName = pending.toolCall.function.name
       const approved = confirm(`Approve ${toolName}?`)
-      
+
       return [
         pending.toolCall.id,
         { approved, reason: approved ? undefined : 'User denied' },
       ]
-    })
+    }),
   )
 
   // Resume session with decisions
@@ -836,6 +837,7 @@ bun run examples/tool-approval-session.ts
 ```
 
 **Key features shown:**
+
 - Creating custom tools with risk levels
 - Implementing approval hooks with async delays
 - Pausing execution on `requires_action` events
@@ -851,11 +853,11 @@ const session = await agent.createSession({
   hooks: {
     preToolUse: async (ctx) => {
       const toolName = ctx.toolCall.function.name
-      
+
       // Example: Add safety constraints to file writes
       if (toolName === 'Write') {
         const args = JSON.parse(ctx.toolCall.function.arguments)
-        
+
         // Modify the tool call to add restrictions
         const modifiedToolCall = {
           ...ctx.toolCall,
@@ -868,13 +870,13 @@ const session = await agent.createSession({
             }),
           },
         }
-        
+
         return {
           allow: true,
           modifiedToolCall,
         }
       }
-      
+
       return { allow: true }
     },
   },
@@ -892,8 +894,8 @@ session.send('Do something risky', {
       strategy: 'high_risk', // Pause on high-risk tools
       // or
       decisions: {
-        'tool_call_id_123': { approved: true },
-        'tool_call_id_456': { approved: false, reason: 'Too dangerous' },
+        tool_call_id_123: { approved: true },
+        tool_call_id_456: { approved: false, reason: 'Too dangerous' },
       },
     },
     // Your custom context
@@ -1451,7 +1453,12 @@ console.log(`Total tokens: ${session.usage.totalTokens}`)
 Combine session-level working directory with auto-approval for automated file operations:
 
 ```typescript
-import { Agent, createModel, createOpenAIAdapter, createBuiltinTools } from 'goatchain'
+import {
+  Agent,
+  createModel,
+  createOpenAIAdapter,
+  createBuiltinTools,
+} from 'goatchain'
 
 const model = createModel({
   adapter: createOpenAIAdapter({
@@ -1484,8 +1491,7 @@ session.send('List all TypeScript files, then create a summary.md file', {
 for await (const event of session.receive()) {
   if (event.type === 'text_delta') {
     process.stdout.write(event.delta)
-  }
-  else if (event.type === 'tool_call_start') {
+  } else if (event.type === 'tool_call_start') {
     console.log(`\nExecuting: ${event.toolName}`)
   }
 }
@@ -1506,6 +1512,7 @@ for await (const event of session.receive()) {
 ```
 
 **Perfect for:**
+
 - CI/CD pipelines that need file analysis
 - Automated code review bots
 - Project documentation generators

package/dist/acp-adapter/types.d.ts

@@ -21,6 +21,7 @@ export interface ACPToolCall {
     function: {
         name: string;
         arguments: string | Record<string, unknown>;
+        thoughtSignature?: string;
     };
 }
 /**

package/dist/index.d.ts

@@ -1,7 +1,10 @@
 export * from './acp-adapter';
 export { runAcpServer } from './acp-server';
+export { startApiServer } from './server';
+export type { ApiServerHandle, StartApiServerOptions, QueryHandler, QueryHandlerResult, ServerCapabilities } from './server';
 export { Agent, AgentAbortError, AgentMaxIterationsError, compose, compressSessionManually, createContextCompressionMiddleware, createInitialLoopState, ensureNotAborted, extractPersistentMetadata, extractPersistentState, fromLoopCheckpoint, HookManager, toLoopCheckpoint, } from './agent';
 export type { AgentInput, AgentLoopState, AgentOptions, CompressionStats, ContextCompressionOptions, CreateSessionOptions, HookContext, ManualCompressionOptions, ManualCompressionResult, Middleware, NextFunction, PostToolUseFailureHook, PostToolUseHook, PreToolUseHook, PreToolUseResult, SendOptions, SessionHandleOptions, ToCheckpointOptions, ToolCallWithResult, ToolHooks, } from './agent';
+export * from './mcp-client';
 export { createAgentRulesMiddleware } from './middleware/agentRulesMiddleware';
 export type { AgentRulesMiddlewareOptions } from './middleware/agentRulesMiddleware';
 export { createCommitModeMiddleware } from './middleware/commitModeMiddleware';
@@ -19,13 +22,13 @@ export type { ParsedSkill, SkillsMiddlewareOptions } from './middleware/skillsMi
 export { injectSystemReminderToLastUserMessage, } from './middleware/utils';
 export * from './model';
 export type { OpenAITool } from './model';
-export * from './mcp-client';
 export { BaseSession, BaseSessionManager, Session } from './session';
 export { FileStateStore, InMemoryStateStore, StateKeys, StateStore, } from './state';
 export type { CompressionState, FileStateStoreOptions, StateKey, StateStoreOptions, } from './state';
 export * from './subagent';
 export { BaseTool, errorContent, FilteredToolRegistry, imageContent, textContent, ToolRegistry } from './tool';
-export { AskUserTool, AstGrepReplaceTool, AstGrepSearchTool, BashTool, EditTool, GlobTool, GrepTool, ReadTool, TodoPlanTool, TodoWriteTool, WebFetchTool, WebSearchTool, WriteTool, } from './tool';
+export { AskUserTool, BashTool, EditTool, GlobTool, GrepTool, ReadTool, TodoPlanTool, TodoWriteTool, WebFetchTool, WebSearchTool, WriteTool, } from './tool';
 export type { BashArgs, BashResult, RiskLevel, ToolApprovalResult, ToolApprovalSettings, ToolApprovalStrategy, ToolExecutionContext, ToolExecutionContextInput, ToolRunUsage, } from './tool';
-export type { AskUserArgs, AskUserResult, AstGrepMatch, AstGrepReplaceArgs, AstGrepReplaceResult, AstGrepSearchArgs, AstGrepSearchResult, EditArgs, EditResult, FetchFormat, GlobArgs, GlobResult, GrepArgs, GrepOutputMode, GrepResult, Question, QuestionOption, ReadArgs, ReadResult, TodoItem, TodoPlanArgs, TodoPlanResult, TodoStatus, TodoWriteArgs, TodoWriteResult, WebFetchArgs, WebFetchResult, WebSearchArgs, WebSearchResult, WriteArgs, WriteResult, } from './tool';
+export type { AskUserArgs, AskUserResult, EditArgs, EditResult, FetchFormat, GlobArgs, GlobResult, GrepArgs, GrepOutputMode, GrepResult, Question, QuestionOption, ReadArgs, ReadResult, TodoItem, TodoPlanArgs, TodoPlanResult, TodoStatus, TodoWriteArgs, TodoWriteResult, WebFetchArgs, WebFetchResult, WebSearchArgs, WebSearchResult, WriteArgs, WriteResult, } from './tool';
+export * from './tool/converters';
 export type { AgentEvent, AgentEventType, AgentLoopCheckpoint, AssistantMessage, BaseEvent, CallToolResult, ContentBlock, DoneEvent, ImageContent, IterationEndEvent, IterationStartEvent, JSONSchemaProperty, Message, MessageContent, MessageRole, SystemMessage, TextContent, TextDeltaEvent, TextEndEvent, TextStartEvent, ThinkingDeltaEvent, Tool, ToolCall, ToolCallDeltaEvent, ToolCallEndEvent, ToolCallStartEvent, ToolMessage, ToolResultEvent, Usage, UserMessage, } from './types';