opencode-swarm 4.4.0 → 5.0.0

package/dist/plan/index.d.ts

@@ -0,0 +1 @@
+export { derivePlanMarkdown, loadPlan, migrateLegacyPlan, savePlan, updateTaskStatus, } from './manager';

package/dist/plan/manager.d.ts

@@ -0,0 +1,33 @@
+import { type Plan, type TaskStatus } from '../config/plan-schema';
+/**
+ * Load plan.json ONLY without auto-migration from plan.md.
+ * Returns null if plan.json doesn't exist or is invalid.
+ * Use this when you want to check for structured plans without triggering migration.
+ */
+export declare function loadPlanJsonOnly(directory: string): Promise<Plan | null>;
+/**
+ * Load and validate plan from .swarm/plan.json with 4-step precedence:
+ * 1. .swarm/plan.json exists AND validates → return parsed Plan
+ * 2. .swarm/plan.json exists but FAILS validation → log warning, fall to step 3
+ * 3. .swarm/plan.md exists → call migrateLegacyPlan(), save result, return it
+ * 4. Neither exists → return null
+ */
+export declare function loadPlan(directory: string): Promise<Plan | null>;
+/**
+ * Validate against PlanSchema (throw on invalid), write to .swarm/plan.json via atomic temp+rename pattern,
+ * then derive and write .swarm/plan.md
+ */
+export declare function savePlan(directory: string, plan: Plan): Promise<void>;
+/**
+ * Load plan → find task by ID → update status → save → return updated plan.
+ * Throw if plan not found or task not found.
+ */
+export declare function updateTaskStatus(directory: string, taskId: string, status: TaskStatus): Promise<Plan>;
+/**
+ * Generate markdown view from plan object
+ */
+export declare function derivePlanMarkdown(plan: Plan): string;
+/**
+ * Convert existing plan.md to plan.json. PURE function — no I/O.
+ */
+export declare function migrateLegacyPlan(planContent: string, swarmId?: string): Plan;

package/dist/state.d.ts

@@ -33,6 +33,29 @@ export interface DelegationEntry {
     to: string;
     timestamp: number;
 }
+/**
+ * Represents per-session state for guardrail tracking
+ */
+export interface AgentSessionState {
+    /** Which agent this session belongs to */
+    agentName: string;
+    /** Date.now() when session started */
+    startTime: number;
+    /** Total tool calls in this session */
+    toolCallCount: number;
+    /** Consecutive errors (reset on success) */
+    consecutiveErrors: number;
+    /** Circular buffer of recent tool calls, max 20 entries */
+    recentToolCalls: Array<{
+        tool: string;
+        argsHash: number;
+        timestamp: number;
+    }>;
+    /** Whether a soft warning has been issued */
+    warningIssued: boolean;
+    /** Whether a hard limit has been triggered */
+    hardLimitHit: boolean;
+}
 /**
  * Singleton state object for sharing data across hooks
  */
@@ -47,8 +70,29 @@ export declare const swarmState: {
     delegationChains: Map<string, DelegationEntry[]>;
     /** Number of events since last flush */
     pendingEvents: number;
+    /** Per-session guardrail state — keyed by sessionID */
+    agentSessions: Map<string, AgentSessionState>;
 };
 /**
  * Reset all state to initial values - useful for testing
  */
 export declare function resetSwarmState(): void;
+/**
+ * Start a new agent session with initialized guardrail state.
+ * Also removes any stale sessions older than staleDurationMs.
+ * @param sessionId - The session identifier
+ * @param agentName - The agent associated with this session
+ * @param staleDurationMs - Age threshold for stale session eviction (default: 60 min)
+ */
+export declare function startAgentSession(sessionId: string, agentName: string, staleDurationMs?: number): void;
+/**
+ * End an agent session by removing it from the state.
+ * @param sessionId - The session identifier to remove
+ */
+export declare function endAgentSession(sessionId: string): void;
+/**
+ * Get an agent session state by session ID.
+ * @param sessionId - The session identifier
+ * @returns The AgentSessionState or undefined if not found
+ */
+export declare function getAgentSession(sessionId: string): AgentSessionState | undefined;

package/dist/state.js

@@ -0,0 +1,48 @@
+// src/state.ts
+var swarmState = {
+  activeToolCalls: new Map,
+  toolAggregates: new Map,
+  activeAgent: new Map,
+  delegationChains: new Map,
+  pendingEvents: 0,
+  agentSessions: new Map
+};
+function resetSwarmState() {
+  swarmState.activeToolCalls.clear();
+  swarmState.toolAggregates.clear();
+  swarmState.activeAgent.clear();
+  swarmState.delegationChains.clear();
+  swarmState.pendingEvents = 0;
+  swarmState.agentSessions.clear();
+}
+function startAgentSession(sessionId, agentName, staleDurationMs = 3600000) {
+  const now = Date.now();
+  for (const [id, session] of swarmState.agentSessions) {
+    if (now - session.startTime > staleDurationMs) {
+      swarmState.agentSessions.delete(id);
+    }
+  }
+  const sessionState = {
+    agentName,
+    startTime: now,
+    toolCallCount: 0,
+    consecutiveErrors: 0,
+    recentToolCalls: [],
+    warningIssued: false,
+    hardLimitHit: false
+  };
+  swarmState.agentSessions.set(sessionId, sessionState);
+}
+function endAgentSession(sessionId) {
+  swarmState.agentSessions.delete(sessionId);
+}
+function getAgentSession(sessionId) {
+  return swarmState.agentSessions.get(sessionId);
+}
+export {
+  swarmState,
+  startAgentSession,
+  resetSwarmState,
+  getAgentSession,
+  endAgentSession
+};

package/package.json

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