opencode-swarm 6.83.0 → 6.84.1

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

@@ -0,0 +1,29 @@
+/**
+ * General Council Mode — advisory routing helper.
+ *
+ * Sibling to ./council-advisory.ts (which is hard-typed to CouncilSynthesis
+ * for the verdict-based Work Complete Council). This helper accepts a
+ * GeneralCouncilResult and renders an advisory body the architect will see
+ * on its next turn via the standard pendingAdvisoryMessages → ADVISORIES
+ * messagesTransform flow.
+ *
+ * Design choices:
+ *   - No dedup. The general council is user-triggered (`/swarm council ...`);
+ *     a user asking the same question twice expects two advisories. The
+ *     QA-council dedup-by-taskId-and-round semantic doesn't apply here —
+ *     general council has no taskId.
+ *   - No "blocking" header. The general council is advisory by definition.
+ *     Use a clear visual marker so the architect distinguishes it from the
+ *     QA council's blocking advisories.
+ */
+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.
+ *
+ * Safe to call: missing session or empty advisory body silently skips.
+ * Always idempotent at the architect-prompt level (no duplicate-suppression
+ * here — see header comment for rationale).
+ */
+export declare function pushGeneralCouncilAdvisory(session: Pick<AgentSessionState, 'pendingAdvisoryMessages'>, result: GeneralCouncilResult): void;

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

@@ -0,0 +1,22 @@
+/**
+ * General Council Mode — pure synthesis service.
+ *
+ * No I/O, no HTTP. Takes completed member responses for all rounds and
+ * produces the final `GeneralCouncilResult`. Mirrors the design of
+ * `./council-service.ts` (synthesizeCouncilVerdicts).
+ *
+ * Quadratic Voting (NSED arXiv:2601.16863): consensus claims are weighted by
+ * member confidence rather than counted by headcount. A claim is a consensus
+ * point only when its weighted agreement exceeds 0.6 across members.
+ *
+ * MAINTAIN/CONCEDE/NUANCE protocol (ConfMAD): a Round 2 response with the
+ * CONCEDE keyword on a topic resolves the corresponding Round 1 disagreement;
+ * MAINTAIN leaves it persisting; NUANCE marks it persisting-with-boundary.
+ */
+import type { GeneralCouncilDeliberationResponse, GeneralCouncilMemberResponse, GeneralCouncilResult } from './general-council-types.js';
+/**
+ * Pure synthesis. Given completed member responses, produces the final
+ * `GeneralCouncilResult` (without `moderatorOutput` — moderator is invoked
+ * by the architect after this returns and populated separately).
+ */
+export declare function synthesizeGeneralCouncil(question: string, mode: 'general' | 'spec_review', round1Responses: GeneralCouncilMemberResponse[], round2Responses: GeneralCouncilDeliberationResponse[]): GeneralCouncilResult;

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

@@ -0,0 +1,98 @@
+/**
+ * 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.
+ *
+ * No business logic, no I/O. Only types, interfaces, and defaults.
+ */
+export type GeneralCouncilMemberRole = 'generalist' | 'skeptic' | 'domain_expert' | 'devil_advocate' | 'synthesizer';
+export interface WebSearchResult {
+    title: string;
+    url: string;
+    snippet: string;
+    query: string;
+}
+export interface GeneralCouncilMemberConfig {
+    memberId: string;
+    model: string;
+    role: GeneralCouncilMemberRole;
+    persona?: string;
+}
+export interface GeneralCouncilMemberResponse {
+    memberId: string;
+    model: string;
+    role: GeneralCouncilMemberRole;
+    response: string;
+    sources: WebSearchResult[];
+    searchQueries: string[];
+    /** Self-reported confidence (0.0–1.0) — feeds Quadratic Voting weighted consensus */
+    confidence: number;
+    areasOfUncertainty: string[];
+    durationMs: number;
+}
+export interface GeneralCouncilDisagreementPosition {
+    memberId: string;
+    claim: string;
+    evidence: string;
+}
+export interface GeneralCouncilDisagreement {
+    topic: string;
+    positions: GeneralCouncilDisagreementPosition[];
+}
+export interface GeneralCouncilDeliberationResponse extends GeneralCouncilMemberResponse {
+    /** Topics the member addressed in Round 2 (subset of Round 1 disagreements). */
+    disagreementTopics: string[];
+}
+export interface GeneralCouncilResult {
+    question: string;
+    mode: 'general' | 'spec_review';
+    round1Responses: GeneralCouncilMemberResponse[];
+    disagreements: GeneralCouncilDisagreement[];
+    round2Responses: GeneralCouncilDeliberationResponse[];
+    /** Structural synthesis markdown (sections: consensus / disagreements / sources). */
+    synthesis: string;
+    consensusPoints: string[];
+    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.
+     */
+    moderatorOutput?: string;
+    timestamp: string;
+}
+/**
+ * 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).
+ */
+export interface GeneralCouncilConfig {
+    enabled: boolean;
+    searchProvider: 'tavily' | 'brave';
+    /**
+     * Optional API key. When omitted, falls back to `TAVILY_API_KEY` or
+     * `BRAVE_SEARCH_API_KEY` env vars depending on `searchProvider`.
+     */
+    searchApiKey?: string;
+    members: GeneralCouncilMemberConfig[];
+    /** Named groups of members for `/swarm council --preset <name>`. */
+    presets: Record<string, GeneralCouncilMemberConfig[]>;
+    /** When true, after Round 1 the architect routes disagreements back to disputing members. */
+    deliberate: boolean;
+    /** When true, the architect delegates a moderator pass to `council_moderator` after synthesis. */
+    moderator: boolean;
+    /** Required when `moderator: true` — model identifier for the council_moderator delegation. */
+    moderatorModel?: string;
+    /** Hard cap on results returned per member per search call (1–20). Defaults to 5. */
+    maxSourcesPerMember: number;
+}
+export declare const GENERAL_COUNCIL_DEFAULTS: GeneralCouncilConfig;

package/dist/council/web-search-provider.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Web search provider abstraction for the General Council Mode.
+ *
+ * Two concrete providers (Tavily, Brave) plus a factory that selects one
+ * based on `GeneralCouncilConfig.searchProvider`. Pure HTTP layer — no tool
+ * wiring or prompt rendering. Uses the native `fetch` API (Bun-compatible);
+ * no external HTTP libraries.
+ *
+ * Errors are surfaced as typed exceptions:
+ *   - WebSearchConfigError — missing API key (factory)
+ *   - WebSearchError       — HTTP failure (4xx/5xx, network, timeout)
+ * Malformed but successful responses produce an empty result array, never throw.
+ */
+import type { GeneralCouncilConfig, WebSearchResult } from './general-council-types.js';
+export declare class WebSearchError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+export declare class WebSearchConfigError extends Error {
+    constructor(message: string);
+}
+export interface WebSearchProvider {
+    search(query: string, maxResults: number): Promise<WebSearchResult[]>;
+}
+export declare class TavilyProvider implements WebSearchProvider {
+    private readonly apiKey;
+    constructor(apiKey: string);
+    search(query: string, maxResults: number): Promise<WebSearchResult[]>;
+}
+export declare class BraveProvider implements WebSearchProvider {
+    private readonly apiKey;
+    constructor(apiKey: string);
+    search(query: string, maxResults: number): Promise<WebSearchResult[]>;
+}
+export declare function createWebSearchProvider(config: GeneralCouncilConfig): WebSearchProvider;

package/dist/db/qa-gate-profile.d.ts

@@ -7,7 +7,7 @@
  * Sessions can only ratchet gates tighter (enable more), never disable them.
  */
 /**
- * QA gate flags. All eight gates are tracked explicitly.
+ * QA gate flags. All nine gates are tracked explicitly.
  */
 export interface QaGates {
     reviewer: boolean;
@@ -18,6 +18,7 @@ export interface QaGates {
     hallucination_guard: boolean;
     sast_enabled: boolean;
     mutation_test: boolean;
+    council_general_review: boolean;
 }
 /**
  * Default QA gate configuration for newly-created profiles.
@@ -92,6 +93,9 @@ export declare function computeProfileHash(profile: QaGateProfile): string;
  *   until .swarm/evidence/{phase}/hallucination-guard.json has APPROVED verdict).
  * - mutation_test — src/tools/phase-complete.ts Gate 4 (blocks phase_complete
  *   until .swarm/evidence/{phase}/mutation-gate.json has pass verdict; warn does not block)
+ * - council_general_review — src/agents/architect.ts SPECIFY-COUNCIL-REVIEW
+ *   (fires when gate is true; runs convene_general_council on draft spec before
+ *   critic-gate to fold multi-model deliberation into the spec).
  *
  * Session overrides are intentionally ephemeral — they live only in
  * in-memory `AgentSessionState.qaGateSessionOverrides` and are NOT