@weaveio/weave-adapter-opencode 0.0.0-preview-20260715084847 → 0.0.0-preview-20260716120703

package/dist/adapter.d.ts

@@ -8,8 +8,10 @@
  * Boundary rule: this module imports SDK types only through `./sdk-types`.
  * It must not import directly from `@opencode-ai/sdk`.
  */
-import type { AgentDescriptor, HarnessAdapter, PlanStateProvider, SkillInfo } from "@weaveio/weave-engine";
+import type { WeaveConfig } from "@weaveio/weave-core";
+import type { AgentDescriptor, HarnessAdapter, PlanStateProvider, ReviewExecutionResult, ReviewFanOutAdapterError, ReviewVariantDescriptor, SkillInfo } from "@weaveio/weave-engine";
 import { type ResultAsync } from "neverthrow";
+import { type DirectReviewError, type DirectReviewResult } from "./direct-review.js";
 import { type OpenCodeModelContext } from "./model-resolution.js";
 import type { OpenCodeClientFacade } from "./opencode-client.js";
 import type { OpenCodeAgentConfig } from "./sdk-types.js";
@@ -93,6 +95,16 @@ export interface OpenCodeAdapterOptions {
      * ```
      */
     readonly availableSkills?: SkillInfo[];
+    /**
+     * Resolved Weave configuration.
+     *
+     * When provided, enables the `executeDirectReview()` method which fans out a
+     * reviewer agent to one session per `review_models` entry, runs them in
+     * parallel, and collates the results into a `CollatedReview`.
+     *
+     * When omitted, `executeDirectReview()` returns an error immediately.
+     */
+    readonly config?: WeaveConfig;
 }
 /**
  * OpenCode harness adapter.
@@ -165,6 +177,13 @@ export declare class OpenCodeAdapter implements HarnessAdapter {
      * `undefined` when no skills were injected (adapter returns empty list).
      */
     private readonly harnessSkills;
+    /**
+     * Resolved Weave configuration.
+     *
+     * Injected at construction time. Required for `executeDirectReview()`. When
+     * `undefined`, `executeDirectReview()` returns `err(DirectReviewError)`.
+     */
+    private readonly weaveConfig;
     constructor(options?: OpenCodeAdapterOptions);
     /**
      * Perform one-time initialisation required before any agent can be
@@ -213,6 +232,44 @@ export declare class OpenCodeAdapter implements HarnessAdapter {
      * @returns `ok(undefined)` on success, `err(OpenCodeAdapterError)` on failure.
      */
     spawnSubagent(descriptor: AgentDescriptor): ResultAsync<void, OpenCodeAdapterError>;
+    /**
+     * Execute a parallel fan-out of review variant agents.
+     *
+     * When no OpenCode client is available (translation-only mode), returns an
+     * error immediately — review fan-out requires a live harness connection.
+     *
+     * When a client is available, delegates to `executeReviewVariants()` which
+     * spawns each variant as an OpenCode session in parallel and collects results.
+     *
+     * @param variants - One descriptor per review variant to spawn.
+     * @param reviewPrompt - The rendered review prompt text to send to each variant agent.
+     * @returns `ok(results)` with one result per variant, or `err` on fatal
+     *   infrastructure failure. Partial per-variant failures are captured inside
+     *   the `ok` results array — callers should inspect each entry.
+     */
+    spawnReviewVariants(variants: ReviewVariantDescriptor[], reviewPrompt: string): ResultAsync<ReviewExecutionResult[], ReviewFanOutAdapterError>;
+    /**
+     * Execute a direct review for the named agent.
+     *
+     * Fans out to one variant per `review_models` entry on the named agent,
+     * runs them in parallel, collates the results, and returns the combined
+     * `CollatedReview`.
+     *
+     * This is a separate entry point from the workflow gate path (`spawnReviewVariants`).
+     * It is intended for callers that invoke a reviewer agent directly — outside
+     * a workflow step — and need the collated result rather than a gate pass/fail.
+     *
+     * Returns `err(DirectReviewError)` when:
+     * - No `WeaveConfig` was injected at construction time.
+     * - No `OpenCodeClientFacade` was injected at construction time.
+     * - The named agent does not declare `review_models` (fan-out produces no variants).
+     * - All review variants failed during execution.
+     *
+     * @param agentName - Logical name of the reviewer agent (must declare `review_models`).
+     * @param reviewPrompt - The rendered review prompt text sent to each variant.
+     * @returns `ok(DirectReviewResult)` on success, `err(DirectReviewError)` on failure.
+     */
+    executeDirectReview(agentName: string, reviewPrompt: string): ResultAsync<DirectReviewResult, DirectReviewError>;
 }
 export {};
 //# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,SAAS,EACV,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EACL,KAAK,oBAAoB,EAE1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAK1D,KAAK,wBAAwB,GACzB,sBAAsB,GACtB,qBAAqB,GACrB,qBAAqB,CAAC;AAE1B,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;gBAEZ,KAAK,EAAE;QACjB,IAAI,EAAE,wBAAwB,CAAC;QAC/B,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;CAOF;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAEvC;;;;;;;;OAQG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,oBAAoB,CAAC;IAE7C;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,EAAE,CAAC;CACxC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,eAAgB,YAAW,cAAc;IACpD;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAa;IAExE;;;;;;;OAOG;IACH,iBAAiB,EAAE,iBAAiB,GAAG,SAAS,CAAa;IAE7D,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IAErC;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAmC;IAElE;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuB;IAEpD;;;;;;;;;OASG;IACH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA0B;gBAE5C,OAAO,GAAE,sBAA2B;IAOhD;;;;;;OAMG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAa3B;;;;;;;;;;;;;;;OAeG;IACG,mBAAmB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IASjD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,aAAa,CACX,UAAU,EAAE,eAAe,GAC1B,WAAW,CAAC,IAAI,EAAE,oBAAoB,CAAC;CAiG3C"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,SAAS,EACV,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EAExB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,KAAK,oBAAoB,EAE1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAK1D,KAAK,wBAAwB,GACzB,sBAAsB,GACtB,qBAAqB,GACrB,qBAAqB,CAAC;AAE1B,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;gBAEZ,KAAK,EAAE;QACjB,IAAI,EAAE,wBAAwB,CAAC;QAC/B,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;CAOF;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAEvC;;;;;;;;OAQG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,oBAAoB,CAAC;IAE7C;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,EAAE,CAAC;IAEvC;;;;;;;;OAQG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,eAAgB,YAAW,cAAc;IACpD;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAa;IAExE;;;;;;;OAOG;IACH,iBAAiB,EAAE,iBAAiB,GAAG,SAAS,CAAa;IAE7D,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IAErC;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAmC;IAElE;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuB;IAEpD;;;;;;;;;OASG;IACH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA0B;IAExD;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0B;gBAE1C,OAAO,GAAE,sBAA2B;IAQhD;;;;;;OAMG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAa3B;;;;;;;;;;;;;;;OAeG;IACG,mBAAmB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IASjD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,aAAa,CACX,UAAU,EAAE,eAAe,GAC1B,WAAW,CAAC,IAAI,EAAE,oBAAoB,CAAC;IAkG1C;;;;;;;;;;;;;;OAcG;IACH,mBAAmB,CACjB,QAAQ,EAAE,uBAAuB,EAAE,EACnC,YAAY,EAAE,MAAM,GACnB,WAAW,CAAC,qBAAqB,EAAE,EAAE,wBAAwB,CAAC;IAiCjE;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,mBAAmB,CACjB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,WAAW,CAAC,kBAAkB,EAAE,iBAAiB,CAAC;CAsBtD"}

package/dist/direct-review.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Direct review execution path for the OpenCode adapter.
+ *
+ * When a reviewer agent with `review_models` is invoked directly (outside a
+ * workflow gate), this module fans out to one variant per review model, runs
+ * them in parallel, collates the results, and returns the combined review.
+ *
+ * ## Flow
+ *
+ * 1. `ReviewOrchestrator.fanOut(agentName)` — derive variant descriptors
+ * 2. Map `GeneratedReviewVariant` entries to `ReviewVariantDescriptor[]`
+ * 3. `executeReviewVariants(variants, client, reviewPrompt)` — parallel execution
+ * 4. `ReviewOrchestrator.collate(results)` — aggregate into `CollatedReview`
+ *
+ * @see packages/adapters/opencode/src/execute-review-variants.ts
+ * @see packages/engine/src/review-orchestration.ts
+ * @see docs/adapter-boundary.md
+ */
+import type { WeaveConfig } from "@weaveio/weave-core";
+import type { CollatedReview } from "@weaveio/weave-engine";
+import { type ResultAsync } from "neverthrow";
+import type { OpenCodeClientFacade } from "./opencode-client.js";
+/**
+ * The successful result of `executeDirectReview`.
+ *
+ * The formatted summary is returned to the caller. In the OpenCode plugin,
+ * the caller can inject it into the session via the agent's response, or
+ * display it via a toast/log. The adapter does not own session I/O for
+ * direct review results; the plugin entry point or command handler does.
+ */
+export interface DirectReviewResult {
+    readonly collatedReview: CollatedReview;
+    readonly formattedSummary: string;
+}
+/**
+ * Discriminated union of errors that `executeDirectReview` can return.
+ *
+ * - `FanOutPlanError` — `ReviewOrchestrator.fanOut` failed (agent not found,
+ *   conflict, or no `review_models` declared).
+ * - `ExecutionError` — `executeReviewVariants` returned an infrastructure
+ *   error during parallel session execution.
+ * - `CollationError` — all variants failed; `ReviewOrchestrator.collate`
+ *   returned an error (typically `CollatedReviewAllFailedError`).
+ */
+export type DirectReviewError = {
+    type: "FanOutPlanError";
+    message: string;
+} | {
+    type: "ExecutionError";
+    message: string;
+} | {
+    type: "CollationError";
+    message: string;
+};
+/**
+ * Execute a direct review for the named agent.
+ *
+ * Fans out to one variant per `review_models` entry, runs them in parallel via
+ * the provided `OpenCodeClientFacade`, collates the results, and returns the
+ * combined `CollatedReview`.
+ *
+ * This is a separate entry point from the workflow gate path. It does not
+ * replace `spawnSubagent`; adapters and plugins call it when a reviewer agent
+ * is invoked directly rather than through a workflow step.
+ *
+ * @param agentName - Logical name of the reviewer agent (must declare `review_models`).
+ * @param config - The resolved `WeaveConfig` containing the agent definition.
+ * @param client - Live `OpenCodeClientFacade` used to spawn parallel sessions.
+ * @param reviewPrompt - The rendered review prompt text sent to each variant.
+ * @returns `ok(DirectReviewResult)` on success, `err(DirectReviewError)` on failure.
+ */
+export declare function executeDirectReview(agentName: string, config: WeaveConfig, client: OpenCodeClientFacade, reviewPrompt: string): ResultAsync<DirectReviewResult, DirectReviewError>;
+//# sourceMappingURL=direct-review.d.ts.map

package/dist/direct-review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-review.d.ts","sourceRoot":"","sources":["../src/direct-review.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EACV,cAAc,EAEf,MAAM,uBAAuB,CAAC;AAM/B,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAGjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AASjE;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAMD;;;;;;;;;GASG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAMhD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,oBAAoB,EAC5B,YAAY,EAAE,MAAM,GACnB,WAAW,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,CAkFpD"}

package/dist/execute-review-variants.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Review variant fan-out executor for the OpenCode adapter.
+ *
+ * Executes a set of review variant agents in parallel via the
+ * `OpenCodeClientFacade` session API and returns results compatible with
+ * `ReviewOrchestrator.collate()`.
+ *
+ * Design notes:
+ * - All variants run in parallel via `Promise.allSettled`.
+ * - Individual variant failures are captured as `success: false` entries and
+ *   do NOT propagate to the top-level `ResultAsync` error channel.
+ * - Session cleanup (`deleteSession`) is best-effort: a cleanup failure is
+ *   logged but does not cause the variant to be marked as failed.
+ * - Only a catastrophic infrastructure failure that prevents all variants from
+ *   even starting should return `err(ReviewFanOutAdapterError)`. If at least
+ *   one variant ran (even if it failed), `ok(results)` is returned.
+ */
+import type { ReviewExecutionResult, ReviewFanOutAdapterError, ReviewVariantDescriptor } from "@weaveio/weave-engine";
+import { ResultAsync } from "neverthrow";
+import type { OpenCodeClientFacade } from "./opencode-client.js";
+/**
+ * Executes review variant agents in parallel via the OpenCode session API.
+ *
+ * All variants run concurrently via `Promise.allSettled`. Individual variant
+ * failures are captured as `success: false` entries and do not propagate to
+ * the top-level error channel. Only an infrastructure failure that prevents
+ * any variants from running returns `err(ReviewFanOutAdapterError)`.
+ *
+ * @param variants - Normalized variant descriptors produced by the engine.
+ * @param client - The `OpenCodeClientFacade` to use for session operations.
+ * @param reviewPrompt - The composed review prompt text to send to each variant.
+ * @returns A `ResultAsync` resolving to an array of per-variant results.
+ */
+export declare function executeReviewVariants(variants: ReviewVariantDescriptor[], client: OpenCodeClientFacade, reviewPrompt: string): ResultAsync<ReviewExecutionResult[], ReviewFanOutAdapterError>;
+//# sourceMappingURL=execute-review-variants.d.ts.map

package/dist/execute-review-variants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-review-variants.d.ts","sourceRoot":"","sources":["../src/execute-review-variants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAY,WAAW,EAAE,MAAM,YAAY,CAAC;AAEnD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAkHjE;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,uBAAuB,EAAE,EACnC,MAAM,EAAE,oBAAoB,EAC5B,YAAY,EAAE,MAAM,GACnB,WAAW,CAAC,qBAAqB,EAAE,EAAE,wBAAwB,CAAC,CAoEhE"}