dev-flow-deepseek 0.8.8 → 0.9.0

package/lib/workspace-tool.mjs

@@ -0,0 +1,118 @@
+import { defineTool } from "@deepseek-ai/dsh-tools";
+
+import {
+  WORKSPACE_COORDINATOR_TOOL,
+  authorizeWorkspaceExecution,
+  createWorkspaceCoordinator,
+} from "./workspace-coordinator.mjs";
+
+export function registerWorkspaceCoordinator(ctx, options) {
+  const coordinator = createWorkspaceCoordinator({
+    ...options,
+    readTask: options?.readTask ?? (async (request) => await readCoreTask(ctx, request)),
+  });
+  const disposeGuard = ctx.tools.guard((execution) => {
+    if (execution?.name !== WORKSPACE_COORDINATOR_TOOL) return undefined;
+    try {
+      authorizeWorkspaceExecution(execution);
+      return undefined;
+    } catch (error) {
+      return error.message;
+    }
+  });
+  const disposeTool = ctx.tools.register(defineTool({
+    name: WORKSPACE_COORDINATOR_TOOL,
+    description: "Provision, consume, or separately clean up a user-confirmed isolated Dev Flow worktree launch. Every mutation requires its exact current-turn confirmation.",
+    parameters: {
+      operation: { type: "string", required: true, enum: ["provision", "consume", "prepare_cleanup", "cleanup_worktree", "cleanup_branch"] },
+      request: { type: "string", description: "Exact admitted development request for a new provision operation." },
+      profile: { type: "string", description: "Current DSH Profile name." },
+      launch_id: { type: "string", description: "Provisioning launch identity returned by provision." },
+      task_id: { type: "string", description: "Fresh terminal Core Task identity for cleanup." },
+      revision: { type: "integer", description: "Fresh terminal Core Task revision for cleanup." },
+      repository_key: { type: "string", description: "Receipt-owned repository selected for cleanup." },
+      source_repository_path: { type: "string", description: "Current source checkout used only for separately authorized branch cleanup; never persisted." },
+      repositories: {
+        type: "array",
+        description: "Confirmed repositories in primary-first order.",
+        items: {
+          type: "object",
+          additionalProperties: false,
+          properties: {
+            repository_key: { type: "string", required: true },
+            source_repository_path: { type: "string", required: true },
+            remote_name: { type: "string", required: true },
+            base_branch: { type: "string", required: true },
+            target_branch: { type: "string", required: true },
+          },
+        },
+      },
+    },
+    output: {
+      schema: { type: "json" },
+      render(_arguments, value) {
+        return [{ type: "text", text: JSON.stringify(value) }];
+      },
+    },
+    timeoutMs: 10 * 60_000,
+    async execute(arguments_, execution) {
+      authorizeWorkspaceExecution({ ...execution, name: WORKSPACE_COORDINATOR_TOOL, arguments: arguments_ });
+      if (arguments_.operation === "provision") {
+        return await coordinator.provision({
+          request: arguments_.request,
+          profile: arguments_.profile,
+          repositories: arguments_.repositories,
+          signal: execution.signal,
+        });
+      }
+      if (arguments_.operation === "consume") return await coordinator.consume({ launchID: arguments_.launch_id, signal: execution.signal });
+      if (arguments_.operation === "prepare_cleanup") {
+        return await coordinator.prepareCleanup({
+          launchID: arguments_.launch_id, repositoryKey: arguments_.repository_key,
+          taskID: arguments_.task_id, revision: arguments_.revision,
+          sourceRepositoryPath: arguments_.source_repository_path,
+          signal: execution.signal, execution,
+        });
+      }
+      if (arguments_.operation === "cleanup_worktree") {
+        const result = await coordinator.cleanupWorktree({
+          launchID: arguments_.launch_id, repositoryKey: arguments_.repository_key,
+          taskID: arguments_.task_id, revision: arguments_.revision,
+          signal: execution.signal, execution,
+        });
+        execution.concludeTurn();
+        return result;
+      }
+      const result = await coordinator.cleanupBranch({
+        launchID: arguments_.launch_id, repositoryKey: arguments_.repository_key,
+        taskID: arguments_.task_id, revision: arguments_.revision,
+        sourceRepositoryPath: arguments_.source_repository_path,
+        signal: execution.signal, execution,
+      });
+      execution.concludeTurn();
+      return result;
+    },
+  }));
+  return () => {
+    disposeTool();
+    disposeGuard();
+  };
+}
+
+async function readCoreTask(ctx, { taskID, signal, execution }) {
+  const result = await ctx.tools.execute({
+    callId: `${execution.callId}:terminal-task`,
+    rootCallId: execution.rootCallId ?? execution.callId,
+    parent: execution.token,
+    name: "mcp__dev_flow__dev_flow_get_task",
+    arguments: { host: "deepseek", task_id: taskID },
+    agent: execution.agent,
+    signal,
+  });
+  const text = result.content.filter((block) => block.type === "text").map((block) => block.text).join("\n");
+  const start = text.indexOf("{");
+  if (result.isError || start < 0) throw new Error("terminal Core Task read failed");
+  const envelope = JSON.parse(text.slice(start));
+  if (envelope?.ok !== true || envelope.result?.task === undefined) throw new Error("terminal Core Task read failed");
+  return envelope.result.task;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dev-flow-deepseek",
-  "version": "0.8.8",
+  "version": "0.9.0",
   "private": false,
   "description": "Explicit DeepSeek Harness adapter for the Dev Flow process graph.",
   "license": "Apache-2.0",
@@ -20,8 +20,11 @@
     "lib/index.mjs",
     "lib/paths.mjs",
     "lib/platform.mjs",
+    "lib/provisioning-receipt.mjs",
     "lib/runtime.mjs",
     "lib/tool-names.mjs",
+    "lib/workspace-coordinator.mjs",
+    "lib/workspace-tool.mjs",
     "runtime/darwin-arm64/dev-flow",
     "runtime/win32-x64/dev-flow.exe",
     "skills/dev-flow/SKILL.md",