opencode-swarm 6.54.0 → 6.56.0

package/dist/services/tool-doctor.d.ts

@@ -17,4 +17,10 @@ export type ToolDoctorResult = ConfigDoctorResult;
  * Verifies that every entry in TOOL_NAMES has a corresponding key
  * in the plugin's tool: {} block in src/index.ts.
  */
+/**
+ * Returns a structured advisory string for any missing Class 3 binaries.
+ * Intended for injection into the architect's first system prompt.
+ * Returns null if all binaries are available.
+ */
+export declare function getBinaryReadinessAdvisory(): string | null;
 export declare function runToolDoctor(_directory: string, pluginRoot?: string): ToolDoctorResult;

package/dist/state.d.ts

@@ -7,6 +7,7 @@
  * and delegation chains.
  */
 import type { OpencodeClient } from '@opencode-ai/sdk';
+import { type EnvironmentProfile } from './environment/profile.js';
 /**
  * Represents a single tool call entry for tracking purposes
  */
@@ -34,6 +35,11 @@ export interface DelegationEntry {
     to: string;
     timestamp: number;
 }
+/**
+ * Reason a non-architect agent was activated during delegation tracking.
+ * Used by delegation-tracker.ts to record why a delegation occurred.
+ */
+export type DelegationReason = 'normal_delegation' | 'review_rejected' | 'critic_consultation' | 'retry_circuit_breaker' | 'conflict_escalation' | 'stale_recovery';
 /**
  * Per-task workflow state for gate progression tracking.
  * Transitions must be forward-only: idle → coder_delegated → pre_check_passed → reviewer_run → tests_run → complete
@@ -53,6 +59,8 @@ export interface AgentSessionState {
     lastAgentEventTime: number;
     /** Whether active delegation is in progress for this session */
     delegationActive: boolean;
+    /** Reason the most recent non-architect agent was activated */
+    lastDelegationReason?: DelegationReason;
     /** Current active invocation ID for this agent */
     activeInvocationId: number;
     /** Last invocation ID by agent name (e.g., { "coder": 3, "reviewer": 1 }) */
@@ -213,6 +221,8 @@ export declare const swarmState: {
     pendingRehydrations: Set<Promise<void>>;
     /** Whether full-auto mode is enabled in config */
     fullAutoEnabledInConfig: boolean;
+    /** Per-session environment profiles — keyed by sessionID */
+    environmentProfiles: Map<string, EnvironmentProfile>;
 };
 /**
  * Reset all state to initial values - useful for testing
@@ -366,3 +376,6 @@ export declare function hasActiveTurboMode(sessionID?: string): boolean;
  * @returns true if the specified session has fullAutoMode: true (model validation is advisory-only).
  */
 export declare function hasActiveFullAuto(sessionID?: string): boolean;
+export declare function setSessionEnvironment(sessionId: string, profile: EnvironmentProfile): void;
+export declare function getSessionEnvironment(sessionId: string): EnvironmentProfile | undefined;
+export declare function ensureSessionEnvironment(sessionId: string): EnvironmentProfile;

package/dist/telemetry.d.ts

@@ -1,4 +1,4 @@
-export type TelemetryEvent = 'session_started' | 'session_ended' | 'agent_activated' | 'delegation_begin' | 'delegation_end' | 'task_state_changed' | 'gate_passed' | 'gate_failed' | 'phase_changed' | 'budget_updated' | 'model_fallback' | 'hard_limit_hit' | 'revision_limit_hit' | 'loop_detected' | 'scope_violation' | 'qa_skip_violation' | 'heartbeat' | 'turbo_mode_changed' | 'auto_oversight_escalation';
+export type TelemetryEvent = 'session_started' | 'session_ended' | 'agent_activated' | 'delegation_begin' | 'delegation_end' | 'task_state_changed' | 'gate_passed' | 'gate_failed' | 'phase_changed' | 'budget_updated' | 'model_fallback' | 'hard_limit_hit' | 'revision_limit_hit' | 'loop_detected' | 'scope_violation' | 'qa_skip_violation' | 'heartbeat' | 'turbo_mode_changed' | 'auto_oversight_escalation' | 'environment_detected';
 export type TelemetryListener = (event: TelemetryEvent, data: Record<string, unknown>) => void;
 /** @internal - For testing only */
 export declare function resetTelemetryForTesting(): void;
@@ -51,4 +51,5 @@ export declare const telemetry: {
     heartbeat(sessionId: string): void;
     turboModeChanged(sessionId: string, enabled: boolean, agentName: string): void;
     autoOversightEscalation(sessionId: string, reason: string, interactionCount: number, deadlockCount: number, phase?: number): void;
+    environmentDetected(sessionId: string, hostOS: string, shellFamily: string, executionMode: string): void;
 };

package/dist/tools/create-tool.d.ts

@@ -2,6 +2,10 @@ import { type ToolContext, tool } from '@opencode-ai/plugin';
 /**
  * Options for creating a swarm tool.
  * The args type is inferred from what you pass to the tool() call.
+ *
+ * Note: The session-level EnvironmentProfile is available to any tool that has
+ * a sessionID via `getSessionEnvironment(ctx?.sessionID)` from '../state.js'.
+ * ToolContext is defined externally in @opencode-ai/plugin and is not modified here.
  */
 export interface SwarmToolOptions<Args extends Record<string, unknown>> {
     description: string;

package/dist/tools/index.d.ts

@@ -14,10 +14,10 @@ export { evidence_check } from './evidence-check';
 export { extract_code_blocks } from './file-extractor';
 export { fetchGitingest, type GitingestArgs, gitingest } from './gitingest';
 export { imports } from './imports';
-export { knowledgeAdd } from './knowledge-add';
+export { knowledge_add } from './knowledge-add';
 export { knowledge_query } from './knowledge-query';
-export { knowledgeRecall } from './knowledge-recall';
-export { knowledgeRemove } from './knowledge-remove';
+export { knowledge_recall } from './knowledge-recall';
+export { knowledge_remove } from './knowledge-remove';
 export { lint } from './lint';
 export { phase_complete } from './phase-complete';
 export { pkg_audit } from './pkg-audit';

package/dist/tools/knowledge-add.d.ts

@@ -1,2 +1,2 @@
 import { createSwarmTool } from './create-tool.js';
-export declare const knowledgeAdd: ReturnType<typeof createSwarmTool>;
+export declare const knowledge_add: ReturnType<typeof createSwarmTool>;

package/dist/tools/knowledge-recall.d.ts

@@ -1,2 +1,2 @@
 import { createSwarmTool } from './create-tool.js';
-export declare const knowledgeRecall: ReturnType<typeof createSwarmTool>;
+export declare const knowledge_recall: ReturnType<typeof createSwarmTool>;

package/dist/tools/knowledge-remove.d.ts

@@ -1,2 +1,2 @@
 import { createSwarmTool } from './create-tool.js';
-export declare const knowledgeRemove: ReturnType<typeof createSwarmTool>;
+export declare const knowledge_remove: ReturnType<typeof createSwarmTool>;

package/dist/tools/tool-names.d.ts

@@ -3,7 +3,7 @@
  * Used for constants and agent setup references.
  */
 /** Union type of all valid tool names */
-export type ToolName = 'diff' | 'syntax_check' | 'placeholder_scan' | 'imports' | 'lint' | 'secretscan' | 'sast_scan' | 'build_check' | 'pre_check_batch' | 'quality_budget' | 'symbols' | 'complexity_hotspots' | 'schema_drift' | 'todo_extract' | 'evidence_check' | 'check_gate_status' | 'completion_verify' | 'sbom_generate' | 'checkpoint' | 'pkg_audit' | 'test_runner' | 'detect_domains' | 'gitingest' | 'retrieve_summary' | 'extract_code_blocks' | 'phase_complete' | 'save_plan' | 'update_task_status' | 'write_retro' | 'write_drift_evidence' | 'declare_scope' | 'knowledge_query' | 'doc_scan' | 'doc_extract' | 'curator_analyze' | 'knowledgeAdd' | 'knowledgeRecall' | 'knowledgeRemove' | 'co_change_analyzer' | 'search' | 'batch_symbols' | 'suggest_patch';
+export type ToolName = 'diff' | 'syntax_check' | 'placeholder_scan' | 'imports' | 'lint' | 'secretscan' | 'sast_scan' | 'build_check' | 'pre_check_batch' | 'quality_budget' | 'symbols' | 'complexity_hotspots' | 'schema_drift' | 'todo_extract' | 'evidence_check' | 'check_gate_status' | 'completion_verify' | 'sbom_generate' | 'checkpoint' | 'pkg_audit' | 'test_runner' | 'detect_domains' | 'gitingest' | 'retrieve_summary' | 'extract_code_blocks' | 'phase_complete' | 'save_plan' | 'update_task_status' | 'write_retro' | 'write_drift_evidence' | 'declare_scope' | 'knowledge_query' | 'doc_scan' | 'doc_extract' | 'curator_analyze' | 'knowledge_add' | 'knowledge_recall' | 'knowledge_remove' | 'co_change_analyzer' | 'search' | 'batch_symbols' | 'suggest_patch';
 /** Readonly array of all tool names */
 export declare const TOOL_NAMES: readonly ToolName[];
 /** Set for O(1) tool name validation */

package/dist/types/events.d.ts

@@ -52,4 +52,24 @@ export interface CoderRetryCircuitBreakerEvent {
     phase: number;
     action: 'sounding_board_consultation' | 'simplification' | 'user_escalation';
 }
-export type V619Event = SoundingBoardConsultedEvent | ArchitectLoopDetectedEvent | PrecedentManipulationDetectedEvent | CoderSelfAuditEvent | CoderRetryCircuitBreakerEvent;
+export interface AgentConflictDetectedEvent {
+    type: 'agent_conflict_detected';
+    timestamp: string;
+    sessionId: string;
+    phase: number;
+    taskId?: string;
+    sourceAgent: 'architect' | 'coder' | 'reviewer' | 'critic' | 'test_engineer';
+    targetAgent: 'architect' | 'coder' | 'reviewer' | 'critic' | 'test_engineer';
+    conflictType: 'feedback_rejection' | 'authority_collision' | 'retry_spiral' | 'scope_disagreement' | 'quality_gate_dispute';
+    resolutionPath: 'self_resolve' | 'soundingboard' | 'simplification' | 'sme_consult' | 'user_escalation';
+    summary: string;
+}
+export interface AuthorityHandoffResolvedEvent {
+    type: 'authority_handoff_resolved';
+    timestamp: string;
+    sessionId: string;
+    previousAgent: string;
+    newAgent: string;
+    reason: 'task_complete' | 'stale_delegation' | 'conflict_escalation' | 'manual_reset';
+}
+export type V619Event = SoundingBoardConsultedEvent | ArchitectLoopDetectedEvent | PrecedentManipulationDetectedEvent | CoderSelfAuditEvent | CoderRetryCircuitBreakerEvent | AgentConflictDetectedEvent | AuthorityHandoffResolvedEvent;

package/package.json

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