goatchain 0.0.27 → 0.0.29

package/README.md

@@ -563,11 +563,11 @@ tools.register(
 | Tool | What it does | How `cwd` is applied | Per-call override | Extra sandbox options |
 | --- | --- | --- | --- | --- |
 | `ReadTool` | Reads files (and some converted formats) | Relative `file_path` resolves from `cwd` | `file_path` can be absolute | `allowedDirectory`, `fileBlacklist`, `disableBlacklist` |
-| `WriteTool` | Writes/overwrites files | Relative `file_path` resolves from `cwd` | `file_path` can be absolute | `allowedDirectory`, `readOnlyPaths`, `fileBlacklist`, `disableBlacklist` |
-| `EditTool` | Replaces `old_string` with `new_string` in a file | Relative `file_path` resolves from `cwd` | `file_path` can be absolute | `readOnlyPaths`, `fileBlacklist`, `disableBlacklist` |
+| `WriteTool` | Writes/overwrites files | Relative `file_path` resolves from `cwd` | `file_path` can be absolute | `allowedDirectory`, `fileBlacklist`, `disableBlacklist` |
+| `EditTool` | Replaces `old_string` with `new_string` in a file | Relative `file_path` resolves from `cwd` | `file_path` can be absolute | `fileBlacklist`, `disableBlacklist` |
 | `GlobTool` | Finds files by pattern | Search root defaults to `cwd` | `path` argument can change search root | `fileBlacklist`, `disableBlacklist` |
 | `GrepTool` | Searches text content in files | Search runs under `cwd` | `path` argument narrows search scope | `fileBlacklist`, `disableBlacklist` |
-| `BashTool` | Runs shell commands | Commands execute in `cwd` | `workdir` argument overrides per call | `readOnlyPaths` |
+| `BashTool` | Runs shell commands | Commands execute in `cwd` | `workdir` argument overrides per call | None |
 
 **Directory & Protection Options:**
 
@@ -575,24 +575,6 @@ tools.register(
 | ------------------ | ------------------------------------------------------------------- | ------------------------------------- |
 | `cwd`              | Working directory for resolving relative paths                      | `{ cwd: '/app/output' }`              |
 | `allowedDirectory` | Restrict file access to this directory only (blocks path traversal) | `{ allowedDirectory: '/app/output' }` |
-| `readOnlyPaths`    | Mark paths/directories as read-only for write-like operations       | `{ readOnlyPaths: ['docs', { path: '.env', reason: 'secrets' }] }` |
-
-`readOnlyPaths` is supported by `WriteTool`, `EditTool`, and `BashTool`.
-Use it to protect specific directories/files from modifications while still allowing reads/searches.
-
-```typescript
-const tools = new ToolRegistry()
-
-const readOnlyPaths = [
-  'docs', // relative to cwd
-  { path: '.env', reason: 'Secrets file must not be modified' },
-  { path: '/absolute/path/to/protected-dir', reason: 'Managed by another system' },
-]
-
-tools.register(new WriteTool({ cwd: OUTPUT_DIR, readOnlyPaths }))
-tools.register(new EditTool({ cwd: OUTPUT_DIR, readOnlyPaths }))
-tools.register(new BashTool({ cwd: OUTPUT_DIR, readOnlyPaths }))
-```
 
 **When to use `allowedDirectory`:**
 
@@ -728,9 +710,6 @@ interface ToolHookContext extends BaseHookContext {
   toolContext: ToolExecutionContext
 }
 
-// `HookContext` is kept as a backward-compatible alias of ToolHookContext
-type HookContext = ToolHookContext
-
 interface PermissionRequestResult {
   // If true, passes permission checks and skips approval flow
   // (tool still goes through normal middleware/disabled checks)

package/dist/agent/hooks/index.d.ts

@@ -1,2 +1,2 @@
 export { HookManager } from './manager';
-export type { AgentHooks, BaseHookContext, HookContext, PermissionRequestHook, PermissionRequestResult, PostToolUseFailureHook, PostToolUseHook, PreToolUseHook, PreToolUseResult, SessionEndContext, SessionEndHook, SessionStartContext, SessionStartHook, StopContext, StopHook, SubagentStartContext, SubagentStartHook, SubagentStopContext, SubagentStopHook, ToolHookContext, ToolHooks, UserPromptSubmitContext, UserPromptSubmitHook, UserPromptSubmitResult, } from './types';
+export type { AgentHooks, BaseHookContext, PermissionRequestHook, PermissionRequestResult, PostToolUseFailureHook, PostToolUseHook, PreToolUseHook, PreToolUseResult, SessionEndContext, SessionEndHook, SessionStartContext, SessionStartHook, StopContext, StopHook, SubagentStartContext, SubagentStartHook, SubagentStopContext, SubagentStopHook, ToolHookContext, ToolHooks, UserPromptSubmitContext, UserPromptSubmitHook, UserPromptSubmitResult, } from './types';

package/dist/agent/hooks/manager.d.ts

@@ -1,14 +1,14 @@
-import type { AgentHooks, HookContext, PermissionRequestResult, PreToolUseResult, SessionEndContext, SessionStartContext, SubagentStartContext, StopContext, SubagentStopContext, UserPromptSubmitContext, UserPromptSubmitResult } from './types';
+import type { AgentHooks, PermissionRequestResult, PreToolUseResult, SessionEndContext, SessionStartContext, SubagentStartContext, StopContext, SubagentStopContext, ToolHookContext, UserPromptSubmitContext, UserPromptSubmitResult } from './types';
 export declare class HookManager {
     private readonly hooks;
     constructor(hooks?: AgentHooks);
-    executePermissionRequest(context: HookContext): Promise<PermissionRequestResult>;
-    executePreToolUse(context: HookContext): Promise<PreToolUseResult | void>;
+    executePermissionRequest(context: ToolHookContext): Promise<PermissionRequestResult>;
+    executePreToolUse(context: ToolHookContext): Promise<PreToolUseResult | void>;
     executeUserPromptSubmit(context: UserPromptSubmitContext): Promise<UserPromptSubmitResult>;
     executeSessionStart(context: SessionStartContext): Promise<void>;
     executeSessionEnd(context: SessionEndContext): Promise<void>;
-    executePostToolUse(context: HookContext, result: unknown): Promise<void>;
-    executePostToolUseFailure(context: HookContext, error: Error): Promise<void>;
+    executePostToolUse(context: ToolHookContext, result: unknown): Promise<void>;
+    executePostToolUseFailure(context: ToolHookContext, error: Error): Promise<void>;
     executeStop(context: StopContext): Promise<void>;
     executeSubagentStart(context: SubagentStartContext): Promise<void>;
     executeSubagentStop(context: SubagentStopContext): Promise<void>;

package/dist/agent/hooks/types.d.ts

@@ -6,14 +6,11 @@ export interface BaseHookContext {
 }
 /**
  * Context for tool-level hooks (PermissionRequest, PreToolUse, PostToolUse, PostToolUseFailure).
- * Also exported as `HookContext` for backward compatibility.
  */
 export interface ToolHookContext extends BaseHookContext {
     toolCall: ToolCall;
     toolContext: ToolExecutionContext;
 }
-/** @deprecated Use `ToolHookContext` instead. Kept for backward compatibility. */
-export type HookContext = ToolHookContext;
 export interface SessionStartContext extends BaseHookContext {
     /** Whether this run starts from a new session or a resumed state/checkpoint. */
     startReason: 'new' | 'resume';

package/dist/agent/index.d.ts

@@ -6,7 +6,7 @@ export type { ToCheckpointOptions } from '../session/handlers/CheckpointManager'
 export { Agent } from './agent';
 export { AgentAbortError, AgentMaxIterationsError, AgentPauseError, ensureNotAborted } from './errors';
 export { HookManager } from './hooks';
-export type { AgentHooks, BaseHookContext, HookContext, PermissionRequestHook, PermissionRequestResult, PostToolUseFailureHook, PostToolUseHook, PreToolUseHook, PreToolUseResult, SessionEndContext, SessionEndHook, SessionStartContext, SessionStartHook, StopContext, StopHook, SubagentStartContext, SubagentStartHook, SubagentStopContext, SubagentStopHook, ToolHookContext, ToolHooks, UserPromptSubmitContext, UserPromptSubmitHook, UserPromptSubmitResult, } from './hooks';
+export type { AgentHooks, BaseHookContext, PermissionRequestHook, PermissionRequestResult, PostToolUseFailureHook, PostToolUseHook, PreToolUseHook, PreToolUseResult, SessionEndContext, SessionEndHook, SessionStartContext, SessionStartHook, StopContext, StopHook, SubagentStartContext, SubagentStartHook, SubagentStopContext, SubagentStopHook, ToolHookContext, ToolHooks, UserPromptSubmitContext, UserPromptSubmitHook, UserPromptSubmitResult, } from './hooks';
 export { compose } from './middleware';
 export type { Middleware, NamedMiddleware, NextFunction } from './middleware';
 export { countContentTokens, countMessagesTokens, countMessageTokens, countTokens, createCachedTokenCounter, estimateMessagesTokens, estimateTokens, } from './tokenCounter';

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export * from './acp-adapter';
 export { Agent, AgentAbortError, AgentMaxIterationsError, compose, compressSessionManually, createContextCompressionMiddleware, createInitialLoopState, ensureNotAborted, extractPersistentMetadata, extractPersistentState, fromLoopCheckpoint, HookManager, toLoopCheckpoint, } from './agent';
-export type { AgentHooks, AgentInput, AgentLoopState, AgentOptions, BaseHookContext, CompressionStats, ContextCompressionOptions, CreateSessionOptions, HookContext, ManualCompressionOptions, ManualCompressionResult, Middleware, NextFunction, PermissionRequestHook, PermissionRequestResult, PostToolUseFailureHook, PostToolUseHook, PreToolUseHook, PreToolUseResult, SessionEndContext, SessionEndHook, SessionStartContext, SessionStartHook, SendOptions, SessionHandleOptions, StopContext, StopHook, SubagentStartContext, SubagentStartHook, SubagentStopContext, SubagentStopHook, ToCheckpointOptions, ToolCallWithResult, ToolHookContext, ToolHooks, UserPromptSubmitContext, UserPromptSubmitHook, UserPromptSubmitResult, } from './agent';
+export type { AgentHooks, AgentInput, AgentLoopState, AgentOptions, BaseHookContext, CompressionStats, ContextCompressionOptions, CreateSessionOptions, ManualCompressionOptions, ManualCompressionResult, Middleware, NextFunction, PermissionRequestHook, PermissionRequestResult, PostToolUseFailureHook, PostToolUseHook, PreToolUseHook, PreToolUseResult, SessionEndContext, SessionEndHook, SessionStartContext, SessionStartHook, SendOptions, SessionHandleOptions, StopContext, StopHook, SubagentStartContext, SubagentStartHook, SubagentStopContext, SubagentStopHook, ToCheckpointOptions, ToolCallWithResult, ToolHookContext, ToolHooks, UserPromptSubmitContext, UserPromptSubmitHook, UserPromptSubmitResult, } from './agent';
 export { applyCcMockSystemPrompt, CCMOCK_SYSTEM_PROMPT_PREFIX, isCcMockEnabled, readCcMockFlag, } from './ccmock';
 export * from './mcp-client';
 export { createAgentRulesMiddleware } from './middleware/agentRulesMiddleware';