opencode-swarm 6.41.2 → 6.41.4

package/dist/tools/completion-verify.d.ts

@@ -12,6 +12,8 @@ export interface CompletionVerifyArgs {
     phase: number;
     /** Session ID (optional, auto-provided by plugin context) */
     sessionID?: string;
+    /** Explicit project root directory override */
+    working_directory?: string;
 }
 /**
  * Execute the completion verification check

package/dist/tools/resolve-working-directory.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Shared utility for resolving working_directory across swarm tools.
+ *
+ * Tools that read .swarm/ state (plan.json, evidence/) must resolve paths
+ * relative to the actual project root, not process.cwd(). When the MCP host's
+ * CWD differs from the project root (e.g. CWD=RAGAPPv2, project=RAGAPPv3),
+ * tools that lack a working_directory parameter silently read stale data from
+ * the wrong directory.
+ *
+ * This helper provides consistent validation and resolution, matching the
+ * pattern already used by save_plan and update_task_status.
+ */
+export interface ResolveResult {
+    success: true;
+    directory: string;
+}
+export interface ResolveError {
+    success: false;
+    message: string;
+}
+/**
+ * Resolve the effective working directory for a swarm tool.
+ *
+ * Priority: explicit working_directory param > injected directory (from createSwarmTool).
+ *
+ * When working_directory is provided, it is validated for:
+ * - Null-byte injection
+ * - Path traversal sequences (..)
+ * - Windows device paths
+ * - Existence on disk
+ *
+ * @param workingDirectory - Explicit working_directory from tool args (caller-controlled)
+ * @param fallbackDirectory - Injected directory from createSwarmTool (ctx.directory ?? process.cwd())
+ */
+export declare function resolveWorkingDirectory(workingDirectory: string | undefined | null, fallbackDirectory: string): ResolveResult | ResolveError;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-swarm",
-	"version": "6.41.2",
+	"version": "6.41.4",
 	"description": "Architect-centric agentic swarm plugin for OpenCode - hub-and-spoke orchestration with SME consultation, code generation, and QA review",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",