opencode-swarm 7.148.3 → 7.148.4

package/dist/services/status-service.d.ts

@@ -1,5 +1,5 @@
 import type { AgentDefinition } from '../agents';
-import { type DelegationLedgerHealth } from '../background/delegation-health';
+import { type DelegationHealthMaintenanceSection, type DelegationLedgerHealth } from '../background/delegation-health';
 import { loadFullAutoRunState } from '../full-auto/state';
 import { type RecentEscalation } from '../hooks/knowledge-escalator';
 import { getActiveFullAutoSessionID, hasActiveFullAuto, hasActiveLeanTurbo } from '../state';
@@ -167,12 +167,62 @@ export interface StatusData {
      * exist (clean repos keep their previous byte-identical output).
      */
     delegationLedgerHealth?: DelegationLedgerHealth;
+    /**
+     * Issue #2104: opt-in background-work status. Populated ONLY when
+     * `hooks.background_subagents` is enabled — a disabled (default) feature
+     * adds no section and no output. All reads are bounded (recovery scan +
+     * bounded reservation store + health artifact); over-bound or corrupt
+     * stores surface as typed uncertainty, never partially-trusted counts.
+     */
+    backgroundWork?: BackgroundWorkStatus;
+}
+/** Issue #2104: opt-in background-work status snapshot for /swarm status. */
+export interface BackgroundWorkStatus {
+    /** Live-set counts by delegation status (bounded recovery scan). */
+    counts: {
+        pending: number;
+        running: number;
+        completed: number;
+        consumed: number;
+        stale: number;
+        cancelled: number;
+        error: number;
+        ingestion_error: number;
+    };
+    /** Active coder reservations with their lease state. */
+    reservations: Array<{
+        reservationId: string;
+        planTaskId: string | null;
+        generation: number;
+        state: 'reserved' | 'bound';
+        leaseState: 'active' | 'expired' | 'protected-legacy';
+        leaseExpiresAt?: number;
+    }>;
+    /** Durable maintenance state from the health artifact (null when absent). */
+    maintenance: DelegationHealthMaintenanceSection | null;
+    /**
+     * Provenance: 'validated-recovery' when the bounded recovery scan and
+     * reservation scan both validated; 'uncertain' when either store is
+     * corrupt/over-bound — in that case counts/reservations are NOT presented
+     * (never a partial record set as authoritative) and `uncertainty` carries
+     * the typed reason.
+     */
+    source: 'validated-recovery' | 'uncertain';
+    /** Typed uncertainty reason when source is 'uncertain'. */
+    uncertainty?: string;
 }
 /**
  * Get status data from the swarm directory.
  * Returns structured data that can be used by GUI, background flows, or commands.
  */
-export declare function getStatusData(directory: string, agents: Record<string, AgentDefinition>, sessionId?: string): Promise<StatusData>;
+export declare function getStatusData(directory: string, agents: Record<string, AgentDefinition>, sessionId?: string, options?: {
+    /**
+     * Explicit `hooks.background_subagents` value (issue #2104). When
+     * omitted, the service resolves it from the same config loader it
+     * already uses for the memory section (fail-open to disabled).
+     */
+    backgroundSubagents?: boolean;
+}): Promise<StatusData>;
 /**
  * Format status data as markdown for command output.
  * This is the thin adapter that delegates to the service.
@@ -182,4 +232,6 @@ export declare function formatStatusMarkdown(status: StatusData): string;
  * Handle status command - delegates to service and formats output.
  * Kept for backward compatibility - thin adapter.
  */
-export declare function handleStatusCommand(directory: string, agents: Record<string, AgentDefinition>, sessionId?: string): Promise<string>;
+export declare function handleStatusCommand(directory: string, agents: Record<string, AgentDefinition>, sessionId?: string, options?: {
+    backgroundSubagents?: boolean;
+}): Promise<string>;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-swarm",
-	"version": "7.148.3",
+	"version": "7.148.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",