agent-relay-runner 0.11.5 → 0.11.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay-runner",
-  "version": "0.11.5",
+  "version": "0.11.6",
   "description": "Unified provider lifecycle runner for Agent Relay",
   "type": "module",
   "bin": {

package/plugins/claude/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "agent-relay-runner",
   "description": "Thin Agent Relay runner bridge for Claude Code",
-  "version": "0.11.5",
+  "version": "0.11.6",
   "agentRelayContracts": {
     "providerPluginProtocol": 1
   }

package/plugins/claude/hooks/hooks.json

@@ -11,6 +11,18 @@
         ]
       }
     ],
+    "PreToolUse": [
+      {
+        "matcher": "AskUserQuestion",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"${CLAUDE_PLUGIN_ROOT}/hooks/permission-request.sh\"",
+            "timeout": 900
+          }
+        ]
+      }
+    ],
     "PermissionRequest": [
       {
         "hooks": [

package/src/adapter.ts

@@ -89,12 +89,15 @@ export interface TerminalAttachSpec {
   ttlMs?: number;
 }
 
-export type ProviderPermissionDecision = "approve" | "approve-session" | "deny" | "abort";
+export type ProviderPermissionDecision = "approve" | "approve-session" | "deny" | "abort" | "answer";
 
 export interface ProviderPermissionDecisionInput {
   approvalId: string;
   decision: ProviderPermissionDecision;
   reason?: string;
+  // For "answer" decisions (Claude AskUserQuestion): maps each question's text
+  // to the chosen option label(s). Multi-select labels are comma-joined.
+  answers?: Record<string, string>;
 }
 
 export interface ProviderAdapter {

package/src/control-server.ts

@@ -197,9 +197,25 @@ async function handlePermissionRequest(
   return Response.json(claudePermissionHookResponse(decision, body));
 }
 
-function claudePermissionApprovalView(id: string, body: Record<string, unknown>): Record<string, unknown> {
+export function claudePermissionApprovalView(id: string, body: Record<string, unknown>): Record<string, unknown> {
   const toolName = typeof body.tool_name === "string" ? body.tool_name : "Tool";
   const toolInput = isRecord(body.tool_input) ? body.tool_input : {};
+  // AskUserQuestion is not a yes/no gate — it asks the user to pick answers.
+  // Surface the structured questions so the dashboard can render a form and
+  // return the selections via an "answer" decision (handled in the hook
+  // response below as a PreToolUse allow + updatedInput).
+  if (toolName === "AskUserQuestion" && Array.isArray(toolInput.questions) && toolInput.questions.length) {
+    const count = toolInput.questions.length;
+    return {
+      id,
+      provider: "claude",
+      kind: "questions",
+      title: count > 1 ? `Claude is asking ${count} questions` : "Claude is asking a question",
+      body: "",
+      questions: toolInput.questions,
+      choices: [],
+    };
+  }
   const command = typeof toolInput.command === "string" ? toolInput.command : "";
   const description = typeof toolInput.description === "string" ? toolInput.description : "";
   const bodyText = [
@@ -222,7 +238,30 @@ function claudePermissionApprovalView(id: string, body: Record<string, unknown>)
   };
 }
 
-function claudePermissionHookResponse(decision: ProviderPermissionDecisionInput, body: Record<string, unknown>): Record<string, unknown> {
+export function claudePermissionHookResponse(decision: ProviderPermissionDecisionInput, body: Record<string, unknown>): Record<string, unknown> {
+  // AskUserQuestion comes through a PreToolUse hook. The only way to satisfy it
+  // headlessly is permissionDecision "allow" + updatedInput carrying the answers
+  // (echoing back the original questions). A bare "allow" is not sufficient, so
+  // anything that is not a populated answer is treated as a deny.
+  if (body.hook_event_name === "PreToolUse") {
+    const toolInput = isRecord(body.tool_input) ? body.tool_input : {};
+    if (decision.decision === "answer" && decision.answers && Object.keys(decision.answers).length) {
+      return {
+        hookSpecificOutput: {
+          hookEventName: "PreToolUse",
+          permissionDecision: "allow",
+          updatedInput: { ...toolInput, answers: decision.answers },
+        },
+      };
+    }
+    return {
+      hookSpecificOutput: {
+        hookEventName: "PreToolUse",
+        permissionDecision: "deny",
+        permissionDecisionReason: decision.reason || "Dismissed from Agent Relay dashboard",
+      },
+    };
+  }
   const hookEventName = "PermissionRequest";
   if (decision.decision === "approve" || decision.decision === "approve-session") {
     const suggestions = Array.isArray(body.permission_suggestions) ? body.permission_suggestions : [];

package/src/runner.ts

@@ -500,13 +500,23 @@ export class AgentRunner {
     const approvalId = typeof params.approvalId === "string" ? params.approvalId : "";
     const decision = typeof params.decision === "string" ? params.decision : "";
     if (!approvalId) throw new Error("approvalId required");
-    if (decision !== "approve" && decision !== "approve-session" && decision !== "deny" && decision !== "abort") {
-      throw new Error("decision must be approve, approve-session, deny, or abort");
+    if (decision !== "approve" && decision !== "approve-session" && decision !== "deny" && decision !== "abort" && decision !== "answer") {
+      throw new Error("decision must be approve, approve-session, deny, abort, or answer");
+    }
+    const answersRaw = params.answers;
+    const answers = answersRaw && typeof answersRaw === "object" && !Array.isArray(answersRaw)
+      ? Object.fromEntries(
+          Object.entries(answersRaw as Record<string, unknown>).filter(([, v]) => typeof v === "string") as [string, string][],
+        )
+      : undefined;
+    if (decision === "answer" && (!answers || Object.keys(answers).length === 0)) {
+      throw new Error("answers required for answer decision");
     }
     const input: ProviderPermissionDecisionInput = {
       approvalId,
       decision: decision as ProviderPermissionDecision,
       ...(typeof params.reason === "string" ? { reason: params.reason } : {}),
+      ...(answers ? { answers } : {}),
     };
     if (this.control?.resolvePermissionDecision(input)) {
       return { approvalId, decision, provider: "claude" };