opencara 0.106.0 → 0.107.1

package/dist/bin.js

@@ -82,12 +82,19 @@ var AcpHistoryTurnSchema = z3.object({
   role: z3.enum(["user", "assistant"]),
   text: z3.string()
 });
+var AcpPermissionModeSchema = z3.enum([
+  "default",
+  "acceptEdits",
+  "plan",
+  "bypassPermissions"
+]);
 var AcpSpecSchema = z3.object({
   systemPromptMd: z3.string(),
   userPromptMd: z3.string(),
   history: z3.array(AcpHistoryTurnSchema).default([]),
   pageContextJson: z3.string().optional(),
-  priorSessionId: z3.string().optional()
+  priorSessionId: z3.string().optional(),
+  permissionMode: AcpPermissionModeSchema.optional()
 });
 var AgentSpecSchema = z3.object({
   kind: z3.string(),
@@ -198,6 +205,11 @@ var HelloAckSchema = z4.object({
   agentHostId: z4.string(),
   deviceName: z4.string()
 });
+var CancelJobSchema = z4.object({
+  type: z4.literal("cancel"),
+  runId: z4.string(),
+  reason: z4.enum(["user_stopped", "wave_cancelled"])
+});
 var PingSchema = z4.object({ type: z4.literal("ping") });
 var PongSchema = z4.object({ type: z4.literal("pong") });
 var AgentCallEnvelope = {
@@ -225,10 +237,56 @@ var TemplateNodeConfigSetCallSchema = z4.object({
   nodeId: z4.string().min(1),
   config: z4.record(z4.string(), z4.unknown())
 });
+var KanbanWaveDispatchCallSchema = z4.object({
+  ...AgentCallEnvelope,
+  kind: z4.literal("kanban.wave.dispatch"),
+  flowSlug: z4.string().min(1),
+  issueNumbers: z4.array(z4.number().int()).min(1).max(10)
+});
+var IssueSubissueCreateCallSchema = z4.object({
+  ...AgentCallEnvelope,
+  kind: z4.literal("issue.subissue.create"),
+  parentIssueNumber: z4.number().int(),
+  title: z4.string().min(1),
+  bodyMd: z4.string(),
+  labels: z4.array(z4.string()).optional()
+});
+var IssueCreateCallSchema = z4.object({
+  ...AgentCallEnvelope,
+  kind: z4.literal("issue.create"),
+  title: z4.string().min(1),
+  bodyMd: z4.string(),
+  labels: z4.array(z4.string()).optional()
+});
+var IssueStateSetCallSchema = z4.object({
+  ...AgentCallEnvelope,
+  kind: z4.literal("issue.state.set"),
+  issueNumber: z4.number().int(),
+  state: z4.enum(["open", "closed"]),
+  stateReason: z4.enum(["completed", "not_planned", "reopened"]).nullable().optional()
+});
+var IssueCommentCreateCallSchema = z4.object({
+  ...AgentCallEnvelope,
+  kind: z4.literal("issue.comment.create"),
+  issueNumber: z4.number().int(),
+  bodyMd: z4.string().min(1)
+});
+var IssueLabelsSetCallSchema = z4.object({
+  ...AgentCallEnvelope,
+  kind: z4.literal("issue.labels.set"),
+  issueNumber: z4.number().int(),
+  labels: z4.array(z4.string())
+});
 var AgentCallSchema = z4.discriminatedUnion("kind", [
   IssueBodySetCallSchema,
   FlowNodeConfigSetCallSchema,
-  TemplateNodeConfigSetCallSchema
+  TemplateNodeConfigSetCallSchema,
+  KanbanWaveDispatchCallSchema,
+  IssueSubissueCreateCallSchema,
+  IssueCreateCallSchema,
+  IssueStateSetCallSchema,
+  IssueCommentCreateCallSchema,
+  IssueLabelsSetCallSchema
 ]);
 var AgentCallRequestEnvelope = {
   type: z4.literal("agent-call-request"),
@@ -255,10 +313,56 @@ var TemplateNodeConfigSetCallRequestSchema = z4.object({
   nodeId: z4.string().min(1),
   config: z4.record(z4.string(), z4.unknown())
 });
+var KanbanWaveDispatchCallRequestSchema = z4.object({
+  ...AgentCallRequestEnvelope,
+  kind: z4.literal("kanban.wave.dispatch"),
+  flowSlug: z4.string().min(1),
+  issueNumbers: z4.array(z4.number().int()).min(1).max(10)
+});
+var IssueSubissueCreateCallRequestSchema = z4.object({
+  ...AgentCallRequestEnvelope,
+  kind: z4.literal("issue.subissue.create"),
+  parentIssueNumber: z4.number().int(),
+  title: z4.string().min(1),
+  bodyMd: z4.string(),
+  labels: z4.array(z4.string()).optional()
+});
+var IssueCreateCallRequestSchema = z4.object({
+  ...AgentCallRequestEnvelope,
+  kind: z4.literal("issue.create"),
+  title: z4.string().min(1),
+  bodyMd: z4.string(),
+  labels: z4.array(z4.string()).optional()
+});
+var IssueStateSetCallRequestSchema = z4.object({
+  ...AgentCallRequestEnvelope,
+  kind: z4.literal("issue.state.set"),
+  issueNumber: z4.number().int(),
+  state: z4.enum(["open", "closed"]),
+  stateReason: z4.enum(["completed", "not_planned", "reopened"]).nullable().optional()
+});
+var IssueCommentCreateCallRequestSchema = z4.object({
+  ...AgentCallRequestEnvelope,
+  kind: z4.literal("issue.comment.create"),
+  issueNumber: z4.number().int(),
+  bodyMd: z4.string().min(1)
+});
+var IssueLabelsSetCallRequestSchema = z4.object({
+  ...AgentCallRequestEnvelope,
+  kind: z4.literal("issue.labels.set"),
+  issueNumber: z4.number().int(),
+  labels: z4.array(z4.string())
+});
 var AgentCallRequestSchema = z4.discriminatedUnion("kind", [
   IssueBodySetCallRequestSchema,
   FlowNodeConfigSetCallRequestSchema,
-  TemplateNodeConfigSetCallRequestSchema
+  TemplateNodeConfigSetCallRequestSchema,
+  KanbanWaveDispatchCallRequestSchema,
+  IssueSubissueCreateCallRequestSchema,
+  IssueCreateCallRequestSchema,
+  IssueStateSetCallRequestSchema,
+  IssueCommentCreateCallRequestSchema,
+  IssueLabelsSetCallRequestSchema
 ]);
 var AgentCallResultSchema = z4.object({
   type: z4.literal("agent-call-result"),
@@ -273,7 +377,8 @@ var ServerToDeviceMessageSchema = z4.discriminatedUnion("type", [
   JobAssignmentSchema,
   HelloAckSchema,
   PingSchema,
-  AgentCallResultSchema
+  AgentCallResultSchema,
+  CancelJobSchema
 ]);
 var DeviceToServerMessageSchema = z4.union([
   HelloMessageSchema,
@@ -1046,6 +1151,72 @@ function buildAgentCallRequest(runId, callId, kind, args) {
         nodeId: String(args["nodeId"] ?? ""),
         config: args["config"] ?? {}
       };
+    case "kanban.wave.dispatch":
+      return {
+        type: "agent-call-request",
+        runId,
+        callId,
+        kind: "kanban.wave.dispatch",
+        flowSlug: String(args["flowSlug"] ?? ""),
+        issueNumbers: Array.isArray(args["issueNumbers"]) ? args["issueNumbers"].map((n) => Number(n)) : []
+      };
+    case "issue.subissue.create": {
+      const labels = args["labels"];
+      return {
+        type: "agent-call-request",
+        runId,
+        callId,
+        kind: "issue.subissue.create",
+        parentIssueNumber: Number(args["parentIssueNumber"]),
+        title: String(args["title"] ?? ""),
+        bodyMd: String(args["bodyMd"] ?? ""),
+        ...Array.isArray(labels) ? { labels: labels.map((l) => String(l)) } : {}
+      };
+    }
+    case "issue.create": {
+      const labels = args["labels"];
+      return {
+        type: "agent-call-request",
+        runId,
+        callId,
+        kind: "issue.create",
+        title: String(args["title"] ?? ""),
+        bodyMd: String(args["bodyMd"] ?? ""),
+        ...Array.isArray(labels) ? { labels: labels.map((l) => String(l)) } : {}
+      };
+    }
+    case "issue.state.set": {
+      const reason = args["stateReason"];
+      return {
+        type: "agent-call-request",
+        runId,
+        callId,
+        kind: "issue.state.set",
+        issueNumber: Number(args["issueNumber"]),
+        state: args["state"] === "closed" ? "closed" : "open",
+        ...reason === void 0 ? {} : {
+          stateReason: reason === null ? null : String(reason)
+        }
+      };
+    }
+    case "issue.comment.create":
+      return {
+        type: "agent-call-request",
+        runId,
+        callId,
+        kind: "issue.comment.create",
+        issueNumber: Number(args["issueNumber"]),
+        bodyMd: String(args["bodyMd"] ?? "")
+      };
+    case "issue.labels.set":
+      return {
+        type: "agent-call-request",
+        runId,
+        callId,
+        kind: "issue.labels.set",
+        issueNumber: Number(args["issueNumber"]),
+        labels: Array.isArray(args["labels"]) ? args["labels"].map((l) => String(l)) : []
+      };
     default:
       return null;
   }
@@ -1073,9 +1244,35 @@ function runAcpJob(opts) {
   const translator = createUpdateTranslator(handlers.onLog);
   client.onSessionUpdate((p) => translator.handle(p.update));
   client.onStderr((chunk) => handlers.onLog("stderr", chunk));
+  let activeSessionId = null;
+  let cancelRequested = false;
+  let forceCloseScheduled = false;
+  const scheduleForceClose = () => {
+    if (forceCloseScheduled) return;
+    forceCloseScheduled = true;
+    setTimeout(() => {
+      client.close(0).catch(() => void 0);
+    }, 2e3);
+  };
   const controller = {
     onAgentCallResult(msg) {
       bridge.onResult(msg);
+    },
+    cancel() {
+      if (cancelRequested) return;
+      cancelRequested = true;
+      if (activeSessionId) {
+        try {
+          client.cancel(activeSessionId);
+        } catch (err) {
+          handlers.onLog(
+            "stderr",
+            `[opencara] cancel notify failed: ${err instanceof Error ? err.message : String(err)}
+`
+          );
+        }
+      }
+      scheduleForceClose();
     }
   };
   const promise = (async () => {
@@ -1102,8 +1299,21 @@ function runAcpJob(opts) {
         const session = await client.newSession({ cwd, mcpServers });
         sessionId = session.sessionId;
       }
+      activeSessionId = sessionId;
+      if (cancelRequested) {
+        try {
+          client.cancel(sessionId);
+        } catch {
+        }
+        result = { exitCode: 1, stopReason: "cancelled", sessionId };
+        return result;
+      }
       const prompt = buildPromptContent(acpSpec);
-      const promptResult = await client.prompt({ sessionId, prompt });
+      const promptResult = await client.prompt({
+        sessionId,
+        prompt,
+        ...acpSpec.permissionMode ? { permissionMode: acpSpec.permissionMode } : {}
+      });
       result = {
         exitCode: promptResult.stopReason === "end_turn" ? 0 : 1,
         stopReason: promptResult.stopReason,
@@ -1232,7 +1442,7 @@ function resolveLocalAcpAdapter(command, args) {
 }
 
 // src/commands/run.ts
-var PKG_VERSION = "0.106.0";
+var PKG_VERSION = "0.107.1";
 var LOG_FLUSH_MS = 800;
 var MAX_CHUNK_SIZE = 4 * 1024;
 async function run(opts = {}) {
@@ -1283,6 +1493,16 @@ function handleServerMessage(msg, client, _cfg) {
     acpControllers.get(msg.runId)?.onAgentCallResult(msg);
     return;
   }
+  if (msg.type === "cancel") {
+    const ctrl = acpControllers.get(msg.runId);
+    if (ctrl) {
+      console.log(
+        `[opencara] job ${msg.runId.slice(-8)} cancel requested (${msg.reason})`
+      );
+      ctrl.cancel();
+    }
+    return;
+  }
 }
 async function executeJob(job, client) {
   const runId = job.run.id;
@@ -1561,6 +1781,11 @@ function worktreeCreate(args) {
   if (useLfs && !useCache) {
     fail("--lfs requires --cache-repo");
   }
+  if (useLfs && !hasGitLfs()) {
+    fail(
+      "--lfs is set but git-lfs is not installed on this host \u2014 install it (e.g. `apt install git-lfs && git lfs install`) or disable LFS on the agent.worktree.cacheRepo config"
+    );
+  }
   const cacheDir = useCache ? join2(CACHE_ROOT, safeKey(repo)) : null;
   const gitEnv = useCache && !useLfs ? { ...process.env, GIT_LFS_SKIP_SMUDGE: "1" } : void 0;
   const HELPER_SNIPPET = '!f() { echo username=x-access-token; echo "password=$GH_TOKEN"; }; f';
@@ -1733,6 +1958,16 @@ function refExists(cwd, ref) {
     return false;
   }
 }
+function hasGitLfs() {
+  try {
+    execFileSync("git", ["lfs", "version"], {
+      stdio: ["ignore", "ignore", "ignore"]
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
 function pickFlag(argv, name) {
   const i = argv.indexOf(name);
   if (i === -1) return void 0;

package/dist/claude-acp.js

@@ -62,7 +62,7 @@ function notify(method, params) {
   send({ jsonrpc: "2.0", method, params });
 }
 var sessions = /* @__PURE__ */ new Map();
-async function runClaudeTurn(sessionId, state, promptText) {
+async function runClaudeTurn(sessionId, state, promptText, permissionMode) {
   return new Promise((resolve, reject) => {
     const idFlag = state.resume ? "--resume" : "--session-id";
     const args = [
@@ -75,16 +75,19 @@ async function runClaudeTurn(sessionId, state, promptText) {
       "--include-partial-messages",
       "--verbose",
       idFlag,
-      sessionId,
-      // Headless: no human in the loop to approve tool use. Matches the
-      // legacy `claudeAdapter` posture in agents/kinds.ts.
-      "--dangerously-skip-permissions"
+      sessionId
     ];
+    if (permissionMode && permissionMode !== "default") {
+      args.push("--permission-mode", permissionMode);
+    } else {
+      args.push("--dangerously-skip-permissions");
+    }
     const child = spawn("claude", args, {
       cwd: state.cwd,
       env: process.env,
       stdio: ["pipe", "pipe", "pipe"]
     });
+    state.activeChild = child;
     child.stdin.on("error", () => {
     });
     child.stdin.end(promptText);
@@ -116,9 +119,14 @@ async function runClaudeTurn(sessionId, state, promptText) {
         reject(err);
       }
     });
-    child.on("close", (code) => {
+    child.on("close", (code, signal) => {
+      state.activeChild = null;
       if (!resolved) {
         resolved = true;
+        if (signal === "SIGTERM" || signal === "SIGINT") {
+          resolve({ stopReason: "cancelled" });
+          return;
+        }
         if (code !== 0) {
           stderr.write(`[claude-acp] claude exited code=${code} without result event
 `);
@@ -225,10 +233,29 @@ async function handlePrompt(params) {
   if (promptText.length === 0) {
     throw new Error("session/prompt: no text content blocks");
   }
-  const result = await runClaudeTurn(params.sessionId, state, promptText);
+  const result = await runClaudeTurn(
+    params.sessionId,
+    state,
+    promptText,
+    params.permissionMode
+  );
   state.resume = true;
   return { stopReason: result.stopReason };
 }
+function handleCancel(params) {
+  const state = sessions.get(params.sessionId);
+  if (!state) return;
+  const child = state.activeChild;
+  if (!child) return;
+  try {
+    child.kill("SIGTERM");
+  } catch (err) {
+    stderr.write(
+      `[claude-acp] session/cancel kill failed: ${err instanceof Error ? err.message : String(err)}
+`
+    );
+  }
+}
 var isMainModule = import.meta.url === `file://${process.argv[1]}` || process.argv[1]?.endsWith("claude-acp.ts") === true || process.argv[1]?.endsWith("claude-acp.js") === true;
 if (isMainModule) {
   const decoder = new FrameDecoder();
@@ -246,7 +273,16 @@ if (isMainModule) {
   });
 }
 async function dispatch(msg) {
-  if (!("id" in msg) || msg.id == null) return;
+  if (!("id" in msg) || msg.id == null) {
+    const notification = msg;
+    if (notification.method === "session/cancel") {
+      const params = notification.params;
+      if (params && typeof params.sessionId === "string") {
+        handleCancel(params);
+      }
+    }
+    return;
+  }
   if ("result" in msg || "error" in msg) return;
   const req = msg;
   try {

package/dist/opencara-mcp.js

@@ -123,12 +123,19 @@ var AcpHistoryTurnSchema = z2.object({
   role: z2.enum(["user", "assistant"]),
   text: z2.string()
 });
+var AcpPermissionModeSchema = z2.enum([
+  "default",
+  "acceptEdits",
+  "plan",
+  "bypassPermissions"
+]);
 var AcpSpecSchema = z2.object({
   systemPromptMd: z2.string(),
   userPromptMd: z2.string(),
   history: z2.array(AcpHistoryTurnSchema).default([]),
   pageContextJson: z2.string().optional(),
-  priorSessionId: z2.string().optional()
+  priorSessionId: z2.string().optional(),
+  permissionMode: AcpPermissionModeSchema.optional()
 });
 var AgentSpecSchema = z2.object({
   kind: z2.string(),
@@ -239,6 +246,11 @@ var HelloAckSchema = z3.object({
   agentHostId: z3.string(),
   deviceName: z3.string()
 });
+var CancelJobSchema = z3.object({
+  type: z3.literal("cancel"),
+  runId: z3.string(),
+  reason: z3.enum(["user_stopped", "wave_cancelled"])
+});
 var PingSchema = z3.object({ type: z3.literal("ping") });
 var PongSchema = z3.object({ type: z3.literal("pong") });
 var AgentCallEnvelope = {
@@ -266,10 +278,56 @@ var TemplateNodeConfigSetCallSchema = z3.object({
   nodeId: z3.string().min(1),
   config: z3.record(z3.string(), z3.unknown())
 });
+var KanbanWaveDispatchCallSchema = z3.object({
+  ...AgentCallEnvelope,
+  kind: z3.literal("kanban.wave.dispatch"),
+  flowSlug: z3.string().min(1),
+  issueNumbers: z3.array(z3.number().int()).min(1).max(10)
+});
+var IssueSubissueCreateCallSchema = z3.object({
+  ...AgentCallEnvelope,
+  kind: z3.literal("issue.subissue.create"),
+  parentIssueNumber: z3.number().int(),
+  title: z3.string().min(1),
+  bodyMd: z3.string(),
+  labels: z3.array(z3.string()).optional()
+});
+var IssueCreateCallSchema = z3.object({
+  ...AgentCallEnvelope,
+  kind: z3.literal("issue.create"),
+  title: z3.string().min(1),
+  bodyMd: z3.string(),
+  labels: z3.array(z3.string()).optional()
+});
+var IssueStateSetCallSchema = z3.object({
+  ...AgentCallEnvelope,
+  kind: z3.literal("issue.state.set"),
+  issueNumber: z3.number().int(),
+  state: z3.enum(["open", "closed"]),
+  stateReason: z3.enum(["completed", "not_planned", "reopened"]).nullable().optional()
+});
+var IssueCommentCreateCallSchema = z3.object({
+  ...AgentCallEnvelope,
+  kind: z3.literal("issue.comment.create"),
+  issueNumber: z3.number().int(),
+  bodyMd: z3.string().min(1)
+});
+var IssueLabelsSetCallSchema = z3.object({
+  ...AgentCallEnvelope,
+  kind: z3.literal("issue.labels.set"),
+  issueNumber: z3.number().int(),
+  labels: z3.array(z3.string())
+});
 var AgentCallSchema = z3.discriminatedUnion("kind", [
   IssueBodySetCallSchema,
   FlowNodeConfigSetCallSchema,
-  TemplateNodeConfigSetCallSchema
+  TemplateNodeConfigSetCallSchema,
+  KanbanWaveDispatchCallSchema,
+  IssueSubissueCreateCallSchema,
+  IssueCreateCallSchema,
+  IssueStateSetCallSchema,
+  IssueCommentCreateCallSchema,
+  IssueLabelsSetCallSchema
 ]);
 var AgentCallRequestEnvelope = {
   type: z3.literal("agent-call-request"),
@@ -296,10 +354,56 @@ var TemplateNodeConfigSetCallRequestSchema = z3.object({
   nodeId: z3.string().min(1),
   config: z3.record(z3.string(), z3.unknown())
 });
+var KanbanWaveDispatchCallRequestSchema = z3.object({
+  ...AgentCallRequestEnvelope,
+  kind: z3.literal("kanban.wave.dispatch"),
+  flowSlug: z3.string().min(1),
+  issueNumbers: z3.array(z3.number().int()).min(1).max(10)
+});
+var IssueSubissueCreateCallRequestSchema = z3.object({
+  ...AgentCallRequestEnvelope,
+  kind: z3.literal("issue.subissue.create"),
+  parentIssueNumber: z3.number().int(),
+  title: z3.string().min(1),
+  bodyMd: z3.string(),
+  labels: z3.array(z3.string()).optional()
+});
+var IssueCreateCallRequestSchema = z3.object({
+  ...AgentCallRequestEnvelope,
+  kind: z3.literal("issue.create"),
+  title: z3.string().min(1),
+  bodyMd: z3.string(),
+  labels: z3.array(z3.string()).optional()
+});
+var IssueStateSetCallRequestSchema = z3.object({
+  ...AgentCallRequestEnvelope,
+  kind: z3.literal("issue.state.set"),
+  issueNumber: z3.number().int(),
+  state: z3.enum(["open", "closed"]),
+  stateReason: z3.enum(["completed", "not_planned", "reopened"]).nullable().optional()
+});
+var IssueCommentCreateCallRequestSchema = z3.object({
+  ...AgentCallRequestEnvelope,
+  kind: z3.literal("issue.comment.create"),
+  issueNumber: z3.number().int(),
+  bodyMd: z3.string().min(1)
+});
+var IssueLabelsSetCallRequestSchema = z3.object({
+  ...AgentCallRequestEnvelope,
+  kind: z3.literal("issue.labels.set"),
+  issueNumber: z3.number().int(),
+  labels: z3.array(z3.string())
+});
 var AgentCallRequestSchema = z3.discriminatedUnion("kind", [
   IssueBodySetCallRequestSchema,
   FlowNodeConfigSetCallRequestSchema,
-  TemplateNodeConfigSetCallRequestSchema
+  TemplateNodeConfigSetCallRequestSchema,
+  KanbanWaveDispatchCallRequestSchema,
+  IssueSubissueCreateCallRequestSchema,
+  IssueCreateCallRequestSchema,
+  IssueStateSetCallRequestSchema,
+  IssueCommentCreateCallRequestSchema,
+  IssueLabelsSetCallRequestSchema
 ]);
 var AgentCallResultSchema = z3.object({
   type: z3.literal("agent-call-result"),
@@ -314,7 +418,8 @@ var ServerToDeviceMessageSchema = z3.discriminatedUnion("type", [
   JobAssignmentSchema,
   HelloAckSchema,
   PingSchema,
-  AgentCallResultSchema
+  AgentCallResultSchema,
+  CancelJobSchema
 ]);
 var DeviceToServerMessageSchema = z3.union([
   HelloMessageSchema,
@@ -383,6 +488,42 @@ var templateNodeConfigSetShape = TemplateNodeConfigSetCallSchema.omit({
   callId: true,
   kind: true
 }).shape;
+var kanbanWaveDispatchShape = KanbanWaveDispatchCallSchema.omit({
+  type: true,
+  runId: true,
+  callId: true,
+  kind: true
+}).shape;
+var issueSubissueCreateShape = IssueSubissueCreateCallSchema.omit({
+  type: true,
+  runId: true,
+  callId: true,
+  kind: true
+}).shape;
+var issueCreateShape = IssueCreateCallSchema.omit({
+  type: true,
+  runId: true,
+  callId: true,
+  kind: true
+}).shape;
+var issueStateSetShape = IssueStateSetCallSchema.omit({
+  type: true,
+  runId: true,
+  callId: true,
+  kind: true
+}).shape;
+var issueCommentCreateShape = IssueCommentCreateCallSchema.omit({
+  type: true,
+  runId: true,
+  callId: true,
+  kind: true
+}).shape;
+var issueLabelsSetShape = IssueLabelsSetCallSchema.omit({
+  type: true,
+  runId: true,
+  callId: true,
+  kind: true
+}).shape;
 var TOOLS = [
   {
     name: "opencara_issue_body_set",
@@ -404,6 +545,48 @@ var TOOLS = [
     title: "Update a flow-template draft node's config",
     description: "Replace the config blob of a node in the user's draft of the named flow template. Per-user scope, not per-project. Reject with reason if the template draft isn't owned by the run's user.",
     inputShape: templateNodeConfigSetShape
+  },
+  {
+    name: "opencara_kanban_wave_dispatch",
+    kind: "kanban.wave.dispatch",
+    title: "Dispatch a batch of issues to a flow",
+    description: "Dispatch up to 10 issues in parallel to the named project flow. Requires project scope. Reject if the flow does not exist, is disabled, or any of the issue numbers are not in the project. Returns the wave id.",
+    inputShape: kanbanWaveDispatchShape
+  },
+  {
+    name: "opencara_issue_subissue_create",
+    kind: "issue.subissue.create",
+    title: "Create a GitHub sub-issue under a parent",
+    description: "Create a new GitHub issue and link it as a child of the given parent issue via the GraphQL addSubIssue mutation. Requires project scope. Reject if the parent issue is not in the project.",
+    inputShape: issueSubissueCreateShape
+  },
+  {
+    name: "opencara_issue_create",
+    kind: "issue.create",
+    title: "Create a top-level GitHub issue",
+    description: "Create a new GitHub issue in the run's project with no parent link. Requires project scope. Returns the new issueNumber and nodeId.",
+    inputShape: issueCreateShape
+  },
+  {
+    name: "opencara_issue_state_set",
+    kind: "issue.state.set",
+    title: "Open or close an existing issue",
+    description: "Set an issue's state to open or closed. Optional stateReason: completed | not_planned | reopened. Requires project scope. Reject if the issue is not in the project.",
+    inputShape: issueStateSetShape
+  },
+  {
+    name: "opencara_issue_comment_create",
+    kind: "issue.comment.create",
+    title: "Post a comment on an issue",
+    description: "Post a Markdown comment on the named issue. Comments are not mirrored locally; the comment lives on GitHub. Requires project scope. Reject if the issue is not in the project.",
+    inputShape: issueCommentCreateShape
+  },
+  {
+    name: "opencara_issue_labels_set",
+    kind: "issue.labels.set",
+    title: "Replace the label set on an issue",
+    description: "Set the issue's labels to exactly the listed names (REST setLabels semantics). Any label not in the list is removed; empty array clears all labels. Requires project scope.",
+    inputShape: issueLabelsSetShape
   }
 ];
 function registerOpencaraTools(server, router) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencara",
-  "version": "0.106.0",
+  "version": "0.107.1",
   "description": "OpenCara agent-host CLI: register a machine as an agent host and run dispatched agents.",
   "license": "MIT",
   "repository": {