diff --git a/packages/plugin/src/tool.ts b/packages/plugin/src/tool.ts
index 37e802ac408..f759c07d2b5 100644
--- a/packages/plugin/src/tool.ts
+++ b/packages/plugin/src/tool.ts
@@ -5,6 +5,15 @@ export type ToolContext = {
   messageID: string
   agent: string
   abort: AbortSignal
+  metadata(input: { title?: string; metadata?: { [key: string]: any } }): void
+  ask(input: AskInput): Promise<void>
+}
+
+type AskInput = {
+  permission: string
+  patterns: string[]
+  always: string[]
+  metadata: { [key: string]: any }
 }
 
 export function tool<Args extends z.ZodRawShape>(input: {