opencode-swarm 7.0.1 → 7.0.3

package/dist/commands/registry.d.ts

@@ -162,9 +162,9 @@ export declare const COMMAND_REGISTRY: {
     };
     readonly council: {
         readonly handler: (ctx: CommandContext) => Promise<string>;
-        readonly description: "Enter architect MODE: COUNCIL — multi-model deliberation [question] [--preset <name>] [--spec-review]";
-        readonly args: "<question> [--preset <name>] [--spec-review]";
-        readonly details: "Triggers the architect to convene a configurable General Council: each member independently web-searches, answers, and engages in one structured deliberation round on disagreements; an optional moderator pass synthesizes the final answer. --preset <name> selects a member group from council.general.presets. --spec-review switches to single-pass advisory mode for spec review. Requires council.general.enabled: true and a search API key in opencode-swarm.json.";
+        readonly description: "Enter architect MODE: COUNCIL — multi-model deliberation [question] [--spec-review]";
+        readonly args: "<question> [--spec-review]";
+        readonly details: string;
     };
     readonly 'pr-review': {
         readonly handler: (ctx: CommandContext) => Promise<string>;

package/dist/config/constants.d.ts

@@ -2,8 +2,8 @@ import type { ToolName } from '../tools/tool-names';
 export declare const QA_AGENTS: readonly ["reviewer", "critic", "critic_oversight"];
 export declare const PIPELINE_AGENTS: readonly ["explorer", "coder", "test_engineer"];
 export declare const ORCHESTRATOR_NAME: "architect";
-export declare const ALL_SUBAGENT_NAMES: readonly ["sme", "docs", "designer", "critic_sounding_board", "critic_drift_verifier", "critic_hallucination_verifier", "curator_init", "curator_phase", "council_member", "council_moderator", "reviewer", "critic", "critic_oversight", "explorer", "coder", "test_engineer"];
-export declare const ALL_AGENT_NAMES: readonly ["architect", "sme", "docs", "designer", "critic_sounding_board", "critic_drift_verifier", "critic_hallucination_verifier", "curator_init", "curator_phase", "council_member", "council_moderator", "reviewer", "critic", "critic_oversight", "explorer", "coder", "test_engineer"];
+export declare const ALL_SUBAGENT_NAMES: readonly ["sme", "docs", "designer", "critic_sounding_board", "critic_drift_verifier", "critic_hallucination_verifier", "curator_init", "curator_phase", "council_generalist", "council_skeptic", "council_domain_expert", "reviewer", "critic", "critic_oversight", "explorer", "coder", "test_engineer"];
+export declare const ALL_AGENT_NAMES: readonly ["architect", "sme", "docs", "designer", "critic_sounding_board", "critic_drift_verifier", "critic_hallucination_verifier", "curator_init", "curator_phase", "council_generalist", "council_skeptic", "council_domain_expert", "reviewer", "critic", "critic_oversight", "explorer", "coder", "test_engineer"];
 export declare const OPENCODE_NATIVE_AGENTS: Set<"compaction" | "title" | "build" | "general" | "plan" | "explore" | "summary">;
 export type QAAgentName = (typeof QA_AGENTS)[number];
 export type PipelineAgentName = (typeof PIPELINE_AGENTS)[number];

package/dist/config/index.d.ts

@@ -2,7 +2,7 @@ export type { AgentName, PipelineAgentName, QAAgentName, } from './constants';
 export { ALL_AGENT_NAMES, ALL_SUBAGENT_NAMES, DEFAULT_MODELS, isQAAgent, isSubagent, ORCHESTRATOR_NAME, PIPELINE_AGENTS, QA_AGENTS, } from './constants';
 export type { ApprovalEvidence, BaseEvidence, DiffEvidence, Evidence, EvidenceBundle, EvidenceType, EvidenceVerdict, NoteEvidence, ReviewEvidence, TestEvidence, } from './evidence-schema';
 export { ApprovalEvidenceSchema, BaseEvidenceSchema, DiffEvidenceSchema, EVIDENCE_MAX_JSON_BYTES, EVIDENCE_MAX_PATCH_BYTES, EVIDENCE_MAX_TASK_BYTES, EvidenceBundleSchema, EvidenceSchema, EvidenceTypeSchema, EvidenceVerdictSchema, NoteEvidenceSchema, ReviewEvidenceSchema, TestEvidenceSchema, } from './evidence-schema';
-export { loadAgentPrompt, loadPluginConfig, loadPluginConfigWithMeta, } from './loader';
+export { loadAgentPrompt, loadPluginConfig, loadPluginConfigWithMeta, loadPluginConfigWithMetaAsync, } from './loader';
 export type { MigrationStatus, Phase, PhaseStatus, Plan, Task, TaskSize, TaskStatus, } from './plan-schema';
 export { MigrationStatusSchema, PhaseSchema, PhaseStatusSchema, PlanSchema, TaskSchema, TaskSizeSchema, TaskStatusSchema, } from './plan-schema';
 export type { AgentOverrideConfig, AutomationCapabilities, AutomationConfig, AutomationMode, PhaseCompleteConfig, PipelineConfig, PluginConfig, SwarmConfig, } from './schema';

package/dist/config/loader.d.ts

@@ -22,6 +22,14 @@ export declare function loadPluginConfigWithMeta(directory: string): {
     config: PluginConfig;
     loadedFromFile: boolean;
 };
+/**
+ * Async variant of `loadPluginConfigWithMeta`. Used by the plugin entry
+ * (issue #704) so initialization does not perform synchronous fs reads.
+ */
+export declare function loadPluginConfigWithMetaAsync(directory: string): Promise<{
+    config: PluginConfig;
+    loadedFromFile: boolean;
+}>;
 /**
  * Load custom prompt for an agent from the prompts directory.
  * Checks for {agent}.md (replaces default) and {agent}_append.md (appends).

package/dist/council/general-council-advisory.d.ts

@@ -20,7 +20,7 @@ import type { AgentSessionState } from '../state';
 import type { GeneralCouncilResult } from './general-council-types.js';
 /**
  * Push a GeneralCouncilResult into the architect's advisory queue. The body
- * is the synthesis markdown plus the moderator output when present.
+ * is the structural synthesis markdown returned by `convene_general_council`.
  *
  * Safe to call: missing session or empty advisory body silently skips.
  * Always idempotent at the architect-prompt level (no duplicate-suppression

package/dist/council/general-council-types.d.ts

@@ -2,10 +2,12 @@
  * General Council Mode — data contracts.
  *
  * Distinct from the Work Complete Council (`./types.ts`). The general council
- * is an advisory deliberation system: user-selected models each independently
- * web-search and answer a question, then optionally engage in a single
- * disagreement-targeted reconciliation round. A moderator agent synthesizes
- * the final user-facing answer.
+ * is an advisory deliberation system: a fixed three-agent council
+ * (council_generalist / council_skeptic / council_domain_expert) reviews a
+ * question using an architect-supplied RESEARCH CONTEXT block and a
+ * disagreement-targeted reconciliation round. The architect synthesizes the
+ * final user-facing answer directly using inline output rules — the
+ * dedicated council_moderator agent has been removed.
  *
  * No business logic, no I/O. Only types, interfaces, and defaults.
  */
@@ -59,10 +61,12 @@ export interface GeneralCouncilResult {
     persistingDisagreements: string[];
     allSources: WebSearchResult[];
     /**
-     * Final moderator output (when council.general.moderator: true and a moderator
-     * model is configured). Populated by `convene-general-council.ts` after the
-     * architect delegates the moderator prompt to `council_moderator`. Undefined
-     * when no moderator pass is configured.
+     * @deprecated The dedicated council_moderator agent has been removed; the
+     * architect now synthesizes the final answer directly using inline output
+     * rules. This field is never populated post-refactor and the consumer in
+     * `general-council-advisory.ts` guards on its presence so omitting it is
+     * safe. Field kept on the type for backward compatibility with persisted
+     * evidence files.
      */
     moderatorOutput?: string;
     timestamp: string;
@@ -70,10 +74,17 @@ export interface GeneralCouncilResult {
 /**
  * Config shape — matched in schema.ts via GeneralCouncilConfigSchema.
  *
- * `enabled` defaults to false (feature gate). The moderator pass requires
- * a configured `moderatorModel`; when set, the architect delegates the
- * moderator prompt produced by `convene_general_council` to the dedicated
- * `council_moderator` agent (no `web_search` access — synthesis only).
+ * `enabled` defaults to false (feature gate). The council is now a fixed
+ * three-agent set (generalist / skeptic / domain_expert) registered when
+ * `enabled` is true; their models come from the reviewer / critic / sme
+ * swarm config entries respectively.
+ *
+ * Several fields are retained for backward compatibility with existing
+ * `opencode-swarm.json` files but are NO LONGER USED at runtime. See the
+ * per-field deprecation notes below. The schema in `schema.ts` is `.strict()`
+ * so removing these fields would break validation for users with stale
+ * configs; instead, they are accepted and ignored, and a deferred warning
+ * is surfaced when the legacy moderator fields are set.
  */
 export interface GeneralCouncilConfig {
     enabled: boolean;
@@ -83,16 +94,32 @@ export interface GeneralCouncilConfig {
      * `BRAVE_SEARCH_API_KEY` env vars depending on `searchProvider`.
      */
     searchApiKey?: string;
+    /**
+     * @deprecated Member selection is hardcoded to the three council agents
+     * (generalist / skeptic / domain_expert). This field is retained for
+     * backward compatibility but is ignored at runtime.
+     */
     members: GeneralCouncilMemberConfig[];
-    /** Named groups of members for `/swarm council --preset <name>`. */
+    /**
+     * @deprecated Preset-based member selection is no longer supported.
+     * Retained for backward compatibility; ignored at runtime.
+     */
     presets: Record<string, GeneralCouncilMemberConfig[]>;
-    /** When true, after Round 1 the architect routes disagreements back to disputing members. */
+    /** When true, after Round 1 the architect routes disagreements back to disputing agents. */
     deliberate: boolean;
-    /** When true, the architect delegates a moderator pass to `council_moderator` after synthesis. */
+    /**
+     * @deprecated The dedicated council_moderator agent has been removed; the
+     * architect synthesizes the final answer directly. Retained for backward
+     * compatibility; ignored at runtime. A deferred warning is surfaced when
+     * this field is set to silence the deprecation explicitly.
+     */
     moderator: boolean;
-    /** Required when `moderator: true` — model identifier for the council_moderator delegation. */
+    /**
+     * @deprecated See `moderator` — no longer used. Retained for backward
+     * compatibility; ignored at runtime.
+     */
     moderatorModel?: string;
-    /** Hard cap on results returned per member per search call (1–20). Defaults to 5. */
+    /** Hard cap on results returned per architect web_search call (1–20). Defaults to 5. */
     maxSourcesPerMember: number;
 }
 export declare const GENERAL_COUNCIL_DEFAULTS: GeneralCouncilConfig;

package/dist/hooks/__tests__/repo-graph-builder.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Repo-graph builder hook tests (issue #704).
+ *
+ * These tests validate the contract that prevents the OpenCode Desktop hang:
+ *   - calling `init()` returns control to the caller within a single
+ *     macrotask (i.e. async-function-runs-sync-until-first-await is not
+ *     reintroduced),
+ *   - `toolAfter` waits for the initial scan before applying incremental
+ *     updates (no race between the deferred init and the first write tool),
+ *   - the homedir-refusal guard surfaces as a clean catch in `init()`.
+ */
+export {};

package/dist/hooks/repo-graph-builder.d.ts

@@ -4,6 +4,16 @@
  * Startup hook that builds or refreshes the repo dependency graph when a session starts.
  * Write-trigger hook that incrementally updates the graph when write tools are called.
  * Wrapped in try/catch — failures are logged but never block plugin initialization.
+ *
+ * Issue #704: the previous implementation called the synchronous
+ * `buildWorkspaceGraph` from inside an `async init()`. JS executes async
+ * function bodies synchronously up to the first `await`, so calling
+ * `init()` blocked the entire event loop on the recursive workspace scan,
+ * preventing the plugin host's `await server(...)` from ever resolving and
+ * hanging the OpenCode Desktop loading screen indefinitely. The fix wires
+ * the async builder, yields to the event loop before doing any work, and
+ * exposes the init promise so `toolAfter` can serialize incremental
+ * updates after the initial scan completes.
  */
 import { type RepoGraph } from '../tools/repo-graph';
 export interface RepoGraphBuilderHook {
@@ -21,7 +31,9 @@ export interface RepoGraphDeps {
     buildWorkspaceGraph: (workspace: string, options?: {
         maxFileSizeBytes?: number;
         maxFiles?: number;
-    }) => RepoGraph;
+        walkBudgetMs?: number;
+        followSymlinks?: boolean;
+    }) => Promise<RepoGraph>;
     saveGraph: (workspace: string, graph: RepoGraph, options?: {
         createAtomic?: boolean;
     }) => Promise<void>;