opencode-swarm 6.55.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
  */
@@ -220,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
@@ -373,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/package.json

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