# 도구와 권한 공개 API 이 페이지는 고정 소스 리비전의 production(non-test) Go 파일을 AST로 열거한 공개 계약 색인이다. 테스트 선언, 비공개 식별자, 비공개 receiver 메서드는 제외했다. 각 행의 근거는 선언이 있는 파일 자체이며, 자세한 기본값과 실패 의미는 [설정 참조](configuration.md), [도구 계약](tools.md), [저장 스키마](persistence-schemas.md)에서 보완한다. 다른 묶음: [실행 코어](public-api-runtime.md) · [도구/권한](public-api-actions.md) · [컨텍스트/지속성](public-api-context.md) · [확장/조정](public-api-extensions.md) ## `tool` | 종류 | 식별자 | 선언/시그니처 | 근거 | |---|---|---|---| | const | `ExecuteExtraToolName` | const ExecuteExtraToolName = "ExecuteExtraTool" | [tool/deferred.go](evidence:api-tool-deferred) | | const | `KindBash` | const KindBash TaskKind = "bash" | [tool/task.go](evidence:api-tool-task) | | const | `KindMonitor` | const KindMonitor TaskKind = "monitor" | [tool/task.go](evidence:api-tool-task) | | const | `SearchExtraToolsName` | const SearchExtraToolsName = "SearchExtraTools" | [tool/deferred.go](evidence:api-tool-deferred) | | const | `TaskCompleted` | const TaskCompleted TaskStatus = "completed" | [tool/task.go](evidence:api-tool-task) | | const | `TaskFailed` | const TaskFailed TaskStatus = "failed" | [tool/task.go](evidence:api-tool-task) | | const | `TaskKilled` | const TaskKilled TaskStatus = "killed" | [tool/task.go](evidence:api-tool-task) | | const | `TaskRunning` | const TaskRunning TaskStatus = "running" | [tool/task.go](evidence:api-tool-task) | | const | `TodoCompleted` | const TodoCompleted TodoStatus = "completed" | [tool/todo.go](evidence:api-tool-todo) | | const | `TodoInProgress` | const TodoInProgress TodoStatus = "in_progress" | [tool/todo.go](evidence:api-tool-todo) | | const | `TodoPending` | const TodoPending TodoStatus = "pending" | [tool/todo.go](evidence:api-tool-todo) | | field | `Answer.Selected` | Selected []string | [tool/ask.go](evidence:api-tool-ask) | | field | `Notification.Kind` | Kind TaskKind | [tool/task.go](evidence:api-tool-task) | | field | `Notification.OutputPath` | OutputPath string | [tool/task.go](evidence:api-tool-task) | | field | `Notification.Status` | Status TaskStatus | [tool/task.go](evidence:api-tool-task) | | field | `Notification.Summary` | Summary string | [tool/task.go](evidence:api-tool-task) | | field | `Notification.TaskID` | TaskID string | [tool/task.go](evidence:api-tool-task) | | field | `Option.Description` | Description string | [tool/ask.go](evidence:api-tool-ask) | | field | `Option.Label` | Label string | [tool/ask.go](evidence:api-tool-ask) | | field | `ProgressInfo.Message` | Message string | [tool/tool.go](evidence:api-tool-tool) | | field | `Question.Header` | Header string | [tool/ask.go](evidence:api-tool-ask) | | field | `Question.MultiSelect` | MultiSelect bool | [tool/ask.go](evidence:api-tool-ask) | | field | `Question.Options` | Options []Option | [tool/ask.go](evidence:api-tool-ask) | | field | `Question.Question` | Question string | [tool/ask.go](evidence:api-tool-ask) | | field | `Result.Content` | Content []llm.ContentBlock | [tool/tool.go](evidence:api-tool-tool) | | field | `Result.Extra` | Extra []llm.Message | [tool/tool.go](evidence:api-tool-tool) | | field | `Result.IsError` | IsError bool | [tool/tool.go](evidence:api-tool-tool) | | field | `SearchResult.Description` | Description string `json:"description"` | [tool/websearch.go](evidence:api-tool-websearch) | | field | `SearchResult.Position` | Position int `json:"position"` | [tool/websearch.go](evidence:api-tool-websearch) | | field | `SearchResult.Title` | Title string `json:"title"` | [tool/websearch.go](evidence:api-tool-websearch) | | field | `SearchResult.URL` | URL string `json:"url"` | [tool/websearch.go](evidence:api-tool-websearch) | | field | `SpawnSpec.Command` | Command string | [tool/task.go](evidence:api-tool-task) | | field | `SpawnSpec.Description` | Description string | [tool/task.go](evidence:api-tool-task) | | field | `SpawnSpec.Env` | Env []string | [tool/task.go](evidence:api-tool-task) | | field | `SpawnSpec.Kind` | Kind TaskKind | [tool/task.go](evidence:api-tool-task) | | field | `SpawnSpec.WorkingDir` | WorkingDir string | [tool/task.go](evidence:api-tool-task) | | field | `Spec.Concurrent` | Concurrent func(json.RawMessage) bool | [tool/tool.go](evidence:api-tool-tool) | | field | `Spec.Description` | Description string | [tool/tool.go](evidence:api-tool-tool) | | field | `Spec.Name` | Name string | [tool/tool.go](evidence:api-tool-tool) | | field | `Spec.Permissions` | Permissions func(ctx context.Context, input json.RawMessage, pc permission.Context) permission.Decision | [tool/tool.go](evidence:api-tool-tool) | | field | `Spec.Prompt` | Prompt string | [tool/tool.go](evidence:api-tool-tool) | | field | `Spec.RawInput` | RawInput bool | [tool/tool.go](evidence:api-tool-tool) | | field | `Spec.ReadOnly` | ReadOnly func(json.RawMessage) bool | [tool/tool.go](evidence:api-tool-tool) | | field | `Spec.Run` | Run func(ctx context.Context, input json.RawMessage, tc *ToolContext) (Result, error) | [tool/tool.go](evidence:api-tool-tool) | | field | `Spec.Schema` | Schema map[string]any | [tool/tool.go](evidence:api-tool-tool) | | field | `Task.Command` | Command string | [tool/task.go](evidence:api-tool-task) | | field | `Task.Description` | Description string | [tool/task.go](evidence:api-tool-task) | | field | `Task.EndTime` | EndTime time.Time | [tool/task.go](evidence:api-tool-task) | | field | `Task.ExitCode` | ExitCode int | [tool/task.go](evidence:api-tool-task) | | field | `Task.ID` | ID string | [tool/task.go](evidence:api-tool-task) | | field | `Task.Kind` | Kind TaskKind | [tool/task.go](evidence:api-tool-task) | | field | `Task.OutputPath` | OutputPath string | [tool/task.go](evidence:api-tool-task) | | field | `Task.StartTime` | StartTime time.Time | [tool/task.go](evidence:api-tool-task) | | field | `Task.Status` | Status TaskStatus | [tool/task.go](evidence:api-tool-task) | | field | `TaskInfo.Backgrounded` | Backgrounded bool | [tool/task.go](evidence:api-tool-task) | | field | `TaskInfo.Command` | Command string | [tool/task.go](evidence:api-tool-task) | | field | `TaskInfo.Description` | Description string | [tool/task.go](evidence:api-tool-task) | | field | `TaskInfo.EndTime` | EndTime time.Time | [tool/task.go](evidence:api-tool-task) | | field | `TaskInfo.ExitCode` | ExitCode int | [tool/task.go](evidence:api-tool-task) | | field | `TaskInfo.ID` | ID string | [tool/task.go](evidence:api-tool-task) | | field | `TaskInfo.Kind` | Kind TaskKind | [tool/task.go](evidence:api-tool-task) | | field | `TaskInfo.OutputPath` | OutputPath string | [tool/task.go](evidence:api-tool-task) | | field | `TaskInfo.StartTime` | StartTime time.Time | [tool/task.go](evidence:api-tool-task) | | field | `TaskInfo.Status` | Status TaskStatus | [tool/task.go](evidence:api-tool-task) | | field | `Todo.Content` | Content string `json:"content"` | [tool/todo.go](evidence:api-tool-todo) | | field | `Todo.Status` | Status TodoStatus `json:"status"` | [tool/todo.go](evidence:api-tool-todo) | | field | `ToolContext.AgentID` | AgentID string | [tool/tool.go](evidence:api-tool-tool) | | field | `ToolContext.Emit` | Emit func(ProgressInfo) | [tool/tool.go](evidence:api-tool-tool) | | field | `ToolContext.Env` | Env []string | [tool/tool.go](evidence:api-tool-tool) | | field | `ToolContext.MaxOutputChars` | MaxOutputChars int | [tool/tool.go](evidence:api-tool-tool) | | field | `ToolContext.OutputDir` | OutputDir string | [tool/tool.go](evidence:api-tool-tool) | | field | `ToolContext.Tasks` | Tasks *Manager | [tool/tool.go](evidence:api-tool-tool) | | field | `ToolContext.ToolUseID` | ToolUseID string | [tool/tool.go](evidence:api-tool-tool) | | field | `ToolContext.WorkingDir` | WorkingDir string | [tool/tool.go](evidence:api-tool-tool) | | field | `WebFetchConfig.CACert` | CACert string | [tool/webfetch.go](evidence:api-tool-webfetch) | | field | `WebFetchConfig.InsecureTLS` | InsecureTLS bool | [tool/webfetch.go](evidence:api-tool-webfetch) | | field | `WebFetchConfig.Proxy` | Proxy string | [tool/webfetch.go](evidence:api-tool-webfetch) | | field | `WebSearchConfig.Backend` | Backend string | [tool/websearch.go](evidence:api-tool-websearch) | | field | `WebSearchConfig.BraveAPIKey` | BraveAPIKey string | [tool/websearch.go](evidence:api-tool-websearch) | | field | `WebSearchConfig.CACert` | CACert string | [tool/websearch.go](evidence:api-tool-websearch) | | field | `WebSearchConfig.DeepSeekAPIKey` | DeepSeekAPIKey string | [tool/websearch.go](evidence:api-tool-websearch) | | field | `WebSearchConfig.DeepSeekBaseURL` | DeepSeekBaseURL string | [tool/websearch.go](evidence:api-tool-websearch) | | field | `WebSearchConfig.DeepSeekModel` | DeepSeekModel string | [tool/websearch.go](evidence:api-tool-websearch) | | field | `WebSearchConfig.InsecureTLS` | InsecureTLS bool | [tool/websearch.go](evidence:api-tool-websearch) | | field | `WebSearchConfig.Proxy` | Proxy string | [tool/websearch.go](evidence:api-tool-websearch) | | field | `WebSearchConfig.TavilyAPIKey` | TavilyAPIKey string | [tool/websearch.go](evidence:api-tool-websearch) | | func | `BackgroundTasksDisabled` | func BackgroundTasksDisabled() bool | [tool/task.go](evidence:api-tool-task) | | func | `Build` | func Build(s Spec) CoreTool | [tool/tool.go](evidence:api-tool-tool) | | func | `Capture` | func Capture(tc *ToolContext, s string) string | [tool/helpers.go](evidence:api-tool-helpers) | | func | `CaptureOnce` | func CaptureOnce(tc *ToolContext, s string) string | [tool/helpers.go](evidence:api-tool-helpers) | | func | `DefaultTools` | func DefaultTools() []CoreTool | [tool/registry.go](evidence:api-tool-registry) | | func | `EnsureRipgrep` | func EnsureRipgrep() string | [tool/ripgrep.go](evidence:api-tool-ripgrep) | | func | `Errorf` | func Errorf(s string) Result | [tool/tool.go](evidence:api-tool-tool) | | func | `InteractiveShellDisabled` | func InteractiveShellDisabled() bool | [tool/shell_session.go](evidence:api-tool-shell-session) | | func | `NewAskUserQuestion` | func NewAskUserQuestion(ask AskUserFunc) CoreTool | [tool/ask.go](evidence:api-tool-ask) | | func | `NewBash` | func NewBash() CoreTool | [tool/bash.go](evidence:api-tool-bash) | | func | `NewEdit` | func NewEdit() CoreTool | [tool/files.go](evidence:api-tool-files) | | func | `NewExecuteExtraTool` | func NewExecuteExtraTool(reg *Registry, unlock *UnlockSet) CoreTool | [tool/deferred.go](evidence:api-tool-deferred) | | func | `NewGlob` | func NewGlob() CoreTool | [tool/search.go](evidence:api-tool-search) | | func | `NewGrep` | func NewGrep() CoreTool | [tool/search.go](evidence:api-tool-search) | | func | `NewLS` | func NewLS() CoreTool | [tool/ls.go](evidence:api-tool-ls) | | func | `NewManager` | func NewManager(sessionID string) (*Manager, error) | [tool/task.go](evidence:api-tool-task) | | func | `NewMonitor` | func NewMonitor() CoreTool | [tool/monitor.go](evidence:api-tool-monitor) | | func | `NewMultiEdit` | func NewMultiEdit() CoreTool | [tool/multiedit.go](evidence:api-tool-multiedit) | | func | `NewRead` | func NewRead() CoreTool | [tool/files.go](evidence:api-tool-files) | | func | `NewRegistry` | func NewRegistry(tools ...CoreTool) *Registry | [tool/registry.go](evidence:api-tool-registry) | | func | `NewSearchExtraTools` | func NewSearchExtraTools(reg *Registry, deferred []string) CoreTool | [tool/deferred.go](evidence:api-tool-deferred) | | func | `NewShellClose` | func NewShellClose() CoreTool | [tool/shell_tools.go](evidence:api-tool-shell-tools) | | func | `NewShellList` | func NewShellList() CoreTool | [tool/shell_tools.go](evidence:api-tool-shell-tools) | | func | `NewShellOpen` | func NewShellOpen() CoreTool | [tool/shell_tools.go](evidence:api-tool-shell-tools) | | func | `NewShellRead` | func NewShellRead() CoreTool | [tool/shell_tools.go](evidence:api-tool-shell-tools) | | func | `NewShellSend` | func NewShellSend() CoreTool | [tool/shell_tools.go](evidence:api-tool-shell-tools) | | func | `NewSleep` | func NewSleep() CoreTool | [tool/sleep.go](evidence:api-tool-sleep) | | func | `NewTaskList` | func NewTaskList() CoreTool | [tool/tasklist.go](evidence:api-tool-tasklist) | | func | `NewTaskOutput` | func NewTaskOutput() CoreTool | [tool/taskoutput.go](evidence:api-tool-taskoutput) | | func | `NewTaskStop` | func NewTaskStop() CoreTool | [tool/taskstop.go](evidence:api-tool-taskstop) | | func | `NewTodoStore` | func NewTodoStore() *TodoStore | [tool/todo.go](evidence:api-tool-todo) | | func | `NewUnlockSet` | func NewUnlockSet(initial ...string) *UnlockSet | [tool/deferred.go](evidence:api-tool-deferred) | | func | `NewWebFetch` | func NewWebFetch(cfg WebFetchConfig) CoreTool | [tool/webfetch.go](evidence:api-tool-webfetch) | | func | `NewWebSearch` | func NewWebSearch(cfg WebSearchConfig) (CoreTool, error) | [tool/websearch.go](evidence:api-tool-websearch) | | func | `NewWrite` | func NewWrite() CoreTool | [tool/files.go](evidence:api-tool-files) | | func | `RenderDeferredToolsBlock` | func RenderDeferredToolsBlock(names []string) string | [tool/deferred.go](evidence:api-tool-deferred) | | func | `RenderTodoReminder` | func RenderTodoReminder(todos []Todo) string | [tool/todo.go](evidence:api-tool-todo) | | func | `RipgrepPath` | func RipgrepPath() string | [tool/ripgrep.go](evidence:api-tool-ripgrep) | | func | `ShellSessionTools` | func ShellSessionTools() []CoreTool | [tool/shell_tools.go](evidence:api-tool-shell-tools) | | func | `Text` | func Text(s string) Result | [tool/tool.go](evidence:api-tool-tool) | | func | `ValidateInput` | func ValidateInput(schema map[string]any, raw json.RawMessage) error | [tool/schema.go](evidence:api-tool-schema) | | func | `WebSearchProbe` | func WebSearchProbe(ctx context.Context, cfg WebSearchConfig, query string, limit int) ([]SearchResult, error) | [tool/websearch.go](evidence:api-tool-websearch) | | interface method | `CoreTool.Call` | Callfunc(ctx context.Context, input json.RawMessage, tc *ToolContext) (Result, error) | [tool/tool.go](evidence:api-tool-tool) | | interface method | `CoreTool.CheckPermissions` | CheckPermissionsfunc(ctx context.Context, input json.RawMessage, pc permission.Context) permission.Decision | [tool/tool.go](evidence:api-tool-tool) | | interface method | `CoreTool.Description` | Descriptionfunc() string | [tool/tool.go](evidence:api-tool-tool) | | interface method | `CoreTool.InputSchema` | InputSchemafunc() map[string]any | [tool/tool.go](evidence:api-tool-tool) | | interface method | `CoreTool.IsConcurrencySafe` | IsConcurrencySafefunc(input json.RawMessage) bool | [tool/tool.go](evidence:api-tool-tool) | | interface method | `CoreTool.IsReadOnly` | IsReadOnlyfunc(input json.RawMessage) bool | [tool/tool.go](evidence:api-tool-tool) | | interface method | `CoreTool.Name` | Namefunc() string | [tool/tool.go](evidence:api-tool-tool) | | interface method | `CoreTool.Prompt` | Promptfunc() string | [tool/tool.go](evidence:api-tool-tool) | | method | `Manager.Background` | func (*Manager) Background(id string) | [tool/task.go](evidence:api-tool-task) | | method | `Manager.Cleanup` | func (*Manager) Cleanup() | [tool/task.go](evidence:api-tool-task) | | method | `Manager.DrainNotifications` | func (*Manager) DrainNotifications() []Notification | [tool/task.go](evidence:api-tool-task) | | method | `Manager.Forget` | func (*Manager) Forget(id string) | [tool/task.go](evidence:api-tool-task) | | method | `Manager.Get` | func (*Manager) Get(id string) (TaskInfo, bool) | [tool/task.go](evidence:api-tool-task) | | method | `Manager.Kill` | func (*Manager) Kill(id string) bool | [tool/task.go](evidence:api-tool-task) | | method | `Manager.KillAll` | func (*Manager) KillAll() int | [tool/task.go](evidence:api-tool-task) | | method | `Manager.List` | func (*Manager) List() []TaskInfo | [tool/task.go](evidence:api-tool-task) | | method | `Manager.Output` | func (*Manager) Output(id string, maxBytes int) (string, error) | [tool/task.go](evidence:api-tool-task) | | method | `Manager.RunForeground` |

func (*Manager) RunForeground(ctx context.Context, spec SpawnSpec, timeout time.Duration) (t *Task, finished bool, output string, err error)

| [tool/task.go](evidence:api-tool-task) | | method | `Manager.Spawn` | func (*Manager) Spawn(spec SpawnSpec) (*Task, error) | [tool/task.go](evidence:api-tool-task) | | method | `Manager.Wait` | func (*Manager) Wait(ctx context.Context, id string, timeout time.Duration) (TaskInfo, bool) | [tool/task.go](evidence:api-tool-task) | | method | `Notification.String` | func (Notification) String() string | [tool/task.go](evidence:api-tool-task) | | method | `Option.UnmarshalJSON` | func (*Option) UnmarshalJSON(data []byte) error | [tool/ask.go](evidence:api-tool-ask) | | method | `Registry.Add` | func (*Registry) Add(t CoreTool) | [tool/registry.go](evidence:api-tool-registry) | | method | `Registry.Get` | func (*Registry) Get(name string) (CoreTool, bool) | [tool/registry.go](evidence:api-tool-registry) | | method | `Registry.List` | func (*Registry) List() []CoreTool | [tool/registry.go](evidence:api-tool-registry) | | method | `Registry.Schemas` | func (*Registry) Schemas() []llm.ToolSchema | [tool/registry.go](evidence:api-tool-registry) | | method | `Result.Flatten` | func (Result) Flatten() string | [tool/tool.go](evidence:api-tool-tool) | | method | `TaskStatus.Terminal` | func (TaskStatus) Terminal() bool | [tool/task.go](evidence:api-tool-task) | | method | `TodoStore.List` | func (*TodoStore) List() []Todo | [tool/todo.go](evidence:api-tool-todo) | | method | `TodoStore.Tool` | func (*TodoStore) Tool() CoreTool | [tool/todo.go](evidence:api-tool-todo) | | method | `UnlockSet.Add` | func (*UnlockSet) Add(names ...string) | [tool/deferred.go](evidence:api-tool-deferred) | | method | `UnlockSet.Has` | func (*UnlockSet) Has(name string) bool | [tool/deferred.go](evidence:api-tool-deferred) | | method | `UnlockSet.List` | func (*UnlockSet) List() []string | [tool/deferred.go](evidence:api-tool-deferred) | | type | `Answer` | type Answer struct | [tool/ask.go](evidence:api-tool-ask) | | type | `AskUserFunc` | type AskUserFunc func(ctx context.Context, q Question) Answer | [tool/ask.go](evidence:api-tool-ask) | | type | `CoreTool` | type CoreTool interface | [tool/tool.go](evidence:api-tool-tool) | | type | `Manager` | type Manager struct | [tool/task.go](evidence:api-tool-task) | | type | `Notification` | type Notification struct | [tool/task.go](evidence:api-tool-task) | | type | `Option` | type Option struct | [tool/ask.go](evidence:api-tool-ask) | | type | `ProgressInfo` | type ProgressInfo struct | [tool/tool.go](evidence:api-tool-tool) | | type | `Question` | type Question struct | [tool/ask.go](evidence:api-tool-ask) | | type | `Registry` | type Registry struct | [tool/registry.go](evidence:api-tool-registry) | | type | `Result` | type Result struct | [tool/tool.go](evidence:api-tool-tool) | | type | `SearchResult` | type SearchResult struct | [tool/websearch.go](evidence:api-tool-websearch) | | type | `SpawnSpec` | type SpawnSpec struct | [tool/task.go](evidence:api-tool-task) | | type | `Spec` | type Spec struct | [tool/tool.go](evidence:api-tool-tool) | | type | `Task` | type Task struct | [tool/task.go](evidence:api-tool-task) | | type | `TaskInfo` | type TaskInfo struct | [tool/task.go](evidence:api-tool-task) | | type | `TaskKind` | type TaskKind string | [tool/task.go](evidence:api-tool-task) | | type | `TaskStatus` | type TaskStatus string | [tool/task.go](evidence:api-tool-task) | | type | `Todo` | type Todo struct | [tool/todo.go](evidence:api-tool-todo) | | type | `TodoStatus` | type TodoStatus string | [tool/todo.go](evidence:api-tool-todo) | | type | `TodoStore` | type TodoStore struct | [tool/todo.go](evidence:api-tool-todo) | | type | `ToolContext` | type ToolContext struct | [tool/tool.go](evidence:api-tool-tool) | | type | `UnlockSet` | type UnlockSet struct | [tool/deferred.go](evidence:api-tool-deferred) | | type | `WebFetchConfig` | type WebFetchConfig struct | [tool/webfetch.go](evidence:api-tool-webfetch) | | type | `WebSearchConfig` | type WebSearchConfig struct | [tool/websearch.go](evidence:api-tool-websearch) | ## `permission` | 종류 | 식별자 | 선언/시그니처 | 근거 | |---|---|---|---| | const | `Allow` | const Allow Behavior = "allow" | [permission/permission.go](evidence:api-permission-permission) | | const | `Ask` | const Ask Behavior = "ask" | [permission/permission.go](evidence:api-permission-permission) | | const | `Deny` | const Deny Behavior = "deny" | [permission/permission.go](evidence:api-permission-permission) | | const | `ModeAcceptEdits` | const ModeAcceptEdits Mode = "acceptEdits" | [permission/permission.go](evidence:api-permission-permission) | | const | `ModeAuto` | const ModeAuto Mode = "auto" | [permission/permission.go](evidence:api-permission-permission) | | const | `ModeBypass` | const ModeBypass Mode = "bypassPermissions" | [permission/permission.go](evidence:api-permission-permission) | | const | `ModeDefault` | const ModeDefault Mode = "default" | [permission/permission.go](evidence:api-permission-permission) | | const | `ModeDontAsk` | const ModeDontAsk Mode = "dontAsk" | [permission/permission.go](evidence:api-permission-permission) | | const | `ModePlan` | const ModePlan Mode = "plan" | [permission/permission.go](evidence:api-permission-permission) | | field | `Context.Allowed` | Allowed []string | [permission/permission.go](evidence:api-permission-permission) | | field | `Context.Disallowed` | Disallowed []string | [permission/permission.go](evidence:api-permission-permission) | | field | `Context.Mode` | Mode Mode | [permission/permission.go](evidence:api-permission-permission) | | field | `Context.WorkingDir` | WorkingDir string | [permission/permission.go](evidence:api-permission-permission) | | field | `Decision.Behavior` | Behavior Behavior | [permission/permission.go](evidence:api-permission-permission) | | field | `Decision.Message` | Message string | [permission/permission.go](evidence:api-permission-permission) | | field | `Decision.Suggestions` | Suggestions []Update | [permission/permission.go](evidence:api-permission-permission) | | field | `Decision.UpdatedInput` | UpdatedInput json.RawMessage | [permission/permission.go](evidence:api-permission-permission) | | field | `Request.Ask` | Ask CanUseTool | [permission/permission.go](evidence:api-permission-permission) | | field | `Request.Ctx` | Ctx Context | [permission/permission.go](evidence:api-permission-permission) | | field | `Request.Input` | Input json.RawMessage | [permission/permission.go](evidence:api-permission-permission) | | field | `Request.IsReadOnly` | IsReadOnly bool | [permission/permission.go](evidence:api-permission-permission) | | field | `Request.ToolDecision` | ToolDecision Decision | [permission/permission.go](evidence:api-permission-permission) | | field | `Request.ToolName` | ToolName string | [permission/permission.go](evidence:api-permission-permission) | | field | `Update.Rule` | Rule string `json:"rule"` | [permission/permission.go](evidence:api-permission-permission) | | field | `Update.Type` | Type string `json:"type"` | [permission/permission.go](evidence:api-permission-permission) | | func | `Allowed` | func Allowed() Decision | [permission/permission.go](evidence:api-permission-permission) | | func | `AskUser` | func AskUser(msg string) Decision | [permission/permission.go](evidence:api-permission-permission) | | func | `Denied` | func Denied(msg string) Decision | [permission/permission.go](evidence:api-permission-permission) | | func | `Evaluate` | func Evaluate(ctx context.Context, req Request) Decision | [permission/permission.go](evidence:api-permission-permission) | | type | `Behavior` | type Behavior string | [permission/permission.go](evidence:api-permission-permission) | | type | `CanUseTool` | type CanUseTool func(ctx context.Context, toolName string, input json.RawMessage, pc Context) Decision | [permission/permission.go](evidence:api-permission-permission) | | type | `Context` | type Context struct | [permission/permission.go](evidence:api-permission-permission) | | type | `Decision` | type Decision struct | [permission/permission.go](evidence:api-permission-permission) | | type | `Mode` | type Mode string | [permission/permission.go](evidence:api-permission-permission) | | type | `Request` | type Request struct | [permission/permission.go](evidence:api-permission-permission) | | type | `Update` | type Update struct | [permission/permission.go](evidence:api-permission-permission) | ## `hook` | 종류 | 식별자 | 선언/시그니처 | 근거 | |---|---|---|---| | const | `PostToolUse` | const PostToolUse EventType = "PostToolUse" | [hook/hook.go](evidence:api-hook-hook) | | const | `PostToolUseFailure` | const PostToolUseFailure EventType = "PostToolUseFailure" | [hook/hook.go](evidence:api-hook-hook) | | const | `PreToolUse` | const PreToolUse EventType = "PreToolUse" | [hook/hook.go](evidence:api-hook-hook) | | const | `SessionEnd` | const SessionEnd EventType = "SessionEnd" | [hook/hook.go](evidence:api-hook-hook) | | const | `SessionStart` | const SessionStart EventType = "SessionStart" | [hook/hook.go](evidence:api-hook-hook) | | const | `Stop` | const Stop EventType = "Stop" | [hook/hook.go](evidence:api-hook-hook) | | const | `SubagentStart` | const SubagentStart EventType = "SubagentStart" | [hook/hook.go](evidence:api-hook-hook) | | const | `UserPromptSubmit` | const UserPromptSubmit EventType = "UserPromptSubmit" | [hook/hook.go](evidence:api-hook-hook) | | field | `Event.AgentType` | AgentType string | [hook/hook.go](evidence:api-hook-hook) | | field | `Event.Input` | Input json.RawMessage | [hook/hook.go](evidence:api-hook-hook) | | field | `Event.IsError` | IsError bool | [hook/hook.go](evidence:api-hook-hook) | | field | `Event.Messages` | Messages []llm.Message | [hook/hook.go](evidence:api-hook-hook) | | field | `Event.Prompt` | Prompt string | [hook/hook.go](evidence:api-hook-hook) | | field | `Event.Result` | Result json.RawMessage | [hook/hook.go](evidence:api-hook-hook) | | field | `Event.ToolName` | ToolName string | [hook/hook.go](evidence:api-hook-hook) | | field | `Event.Type` | Type EventType | [hook/hook.go](evidence:api-hook-hook) | | field | `Result.AdditionalContext` | AdditionalContext string | [hook/hook.go](evidence:api-hook-hook) | | field | `Result.Decision` | Decision string | [hook/hook.go](evidence:api-hook-hook) | | field | `Result.Message` | Message string | [hook/hook.go](evidence:api-hook-hook) | | field | `Result.PreventContinuation` | PreventContinuation bool | [hook/hook.go](evidence:api-hook-hook) | | field | `Result.UpdatedInput` | UpdatedInput json.RawMessage | [hook/hook.go](evidence:api-hook-hook) | | func | `NewRegistry` | func NewRegistry() *Registry | [hook/hook.go](evidence:api-hook-hook) | | method | `Registry.FireSessionEnd` | func (*Registry) FireSessionEnd(ctx context.Context) | [hook/hook.go](evidence:api-hook-hook) | | method | `Registry.FireSessionStart` | func (*Registry) FireSessionStart(ctx context.Context) | [hook/hook.go](evidence:api-hook-hook) | | method | `Registry.FireSubagentStart` | func (*Registry) FireSubagentStart(ctx context.Context, agentType string) | [hook/hook.go](evidence:api-hook-hook) | | method | `Registry.FireUserPromptSubmit` | func (*Registry) FireUserPromptSubmit(ctx context.Context, prompt string) string | [hook/hook.go](evidence:api-hook-hook) | | method | `Registry.On` | func (*Registry) On(t EventType, f Func) *Registry | [hook/hook.go](evidence:api-hook-hook) | | method | `Registry.PostToolUse` | func (*Registry) PostToolUse(ctx context.Context, name string, input, result []byte, isErr bool) | [hook/hook.go](evidence:api-hook-hook) | | method | `Registry.PreToolUse` | func (*Registry) PreToolUse(ctx context.Context, name string, input []byte) (bool, string, []byte) | [hook/hook.go](evidence:api-hook-hook) | | method | `Registry.Stop` |

func (*Registry) Stop(ctx context.Context, messages []llm.Message) (prevent bool, blockingErrors []string, message string)

| [hook/hook.go](evidence:api-hook-hook) | | type | `Event` | type Event struct | [hook/hook.go](evidence:api-hook-hook) | | type | `EventType` | type EventType string | [hook/hook.go](evidence:api-hook-hook) | | type | `Func` | type Func func(ctx context.Context, ev Event) Result | [hook/hook.go](evidence:api-hook-hook) | | type | `Registry` | type Registry struct | [hook/hook.go](evidence:api-hook-hook) | | type | `Result` | type Result struct | [hook/hook.go](evidence:api-hook-hook) |