opencode-swarm 6.33.0 → 6.33.2

package/dist/model-fallback.adversarial.test.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Adversarial tests for model fallback schema and state (v6.33)
+ *
+ * Tests attack vectors against:
+ * 1. AgentOverrideConfigSchema fallback_models field
+ * 2. AgentSessionState model_fallback_index and modelFallbackExhausted
+ *
+ * ADVERSARIAL TEST CASES:
+ * 1. fallback_models with 1000 entries — should Zod-reject (max 3)
+ * 2. fallback_models with non-string values (numbers, objects, null)
+ * 3. fallback_models with empty strings ""
+ * 4. fallback_models with extremely long model name strings (10K chars)
+ * 5. model_fallback_index set to NaN — should it be NaN or coerced?
+ * 6. model_fallback_index set to -1 — negative index
+ * 7. model_fallback_index set to MAX_SAFE_INTEGER — overflow risk?
+ * 8. modelFallbackExhausted set to undefined in deserialization — should default to false
+ * 9. Circular reference in fallback_models array elements
+ * 10. Prototype pollution via __proto__ in fallback_models
+ * 11. AgentOverrideConfigSchema.parse with all fields including fallback_models, verify no field collision
+ * 12. Serialization with model_fallback_index as a float (3.14) — should survive round-trip
+ */
+export {};

package/dist/model-fallback.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Tests for model fallback schema and state (v6.33)
+ *
+ * Covers:
+ * 1. AgentOverrideConfigSchema fallback_models field parsing
+ * 2. State initialization of model_fallback_index and modelFallbackExhausted
+ * 3. Serialization round-trip for both fields
+ * 4. Deserialization defaults when fields are missing
+ * 5. Migration safety via ensureAgentSession
+ * 6. Edge cases for schema and state
+ */
+export {};

package/dist/session/snapshot-writer.d.ts

@@ -41,6 +41,14 @@ export interface SerializedAgentSession {
     taskWorkflowStates?: Record<string, string>;
     /** Flag for one-shot scope violation warning injection (omitted when undefined for additive-only schema) */
     scopeViolationDetected?: boolean;
+    /** Current index into the fallback_models array (v6.33) */
+    model_fallback_index: number;
+    /** Flag set when all fallback models have been exhausted (v6.33) */
+    modelFallbackExhausted: boolean;
+    /** Number of coder revisions in the current task (v6.33) */
+    coderRevisions: number;
+    /** Flag set when coder revisions hit the configured ceiling (v6.33) */
+    revisionLimitHit: boolean;
 }
 /**
  * Minimal interface for serialized InvocationWindow
@@ -87,4 +95,10 @@ export declare function writeSnapshot(directory: string, state: typeof swarmStat
  * Returns a hook function that writes the current swarmState to disk.
  */
 export declare function createSnapshotWriterHook(directory: string): (input: unknown, output: unknown) => Promise<void>;
+/**
+ * v6.33.1: Flush any pending debounced snapshot write immediately.
+ * Used by phase-complete and handoff to ensure critical state transitions
+ * are persisted before returning.
+ */
+export declare function flushPendingSnapshot(directory: string): Promise<void>;
 export {};

package/dist/state.d.ts

@@ -106,6 +106,10 @@ export interface AgentSessionState {
     scopeViolationDetected?: boolean;
     /** Files modified by the current coder task (populated by guardrails toolBefore/toolAfter, reset on new coder delegation) */
     modifiedFilesThisCoderTask: string[];
+    /** Number of coder revisions in the current task (incremented on each coder delegation completion) */
+    coderRevisions: number;
+    /** Flag set when coder revisions hit the configured ceiling */
+    revisionLimitHit: boolean;
     /** Timestamp of most recent phase completion */
     lastPhaseCompleteTimestamp: number;
     /** Phase number of most recent phase completion */
@@ -114,6 +118,10 @@ export interface AgentSessionState {
     phaseAgentsDispatched: Set<string>;
     /** Set of agents dispatched in the most recently completed phase (persisted across phase reset) */
     lastCompletedPhaseAgentsDispatched: Set<string>;
+    /** Current index into the fallback_models array (0 = primary model, incremented on transient failure) */
+    model_fallback_index: number;
+    /** Flag set when all fallback models have been exhausted */
+    modelFallbackExhausted: boolean;
     /** Session-scoped Turbo Mode flag for controlling LLM inference speed */
     turboMode: boolean;
     /** Sliding window of last 10 Task delegation hashes for loop detection */

package/dist/tools/doc-scan.d.ts

@@ -0,0 +1,38 @@
+import { createSwarmTool } from './create-tool.js';
+export interface DocManifestFile {
+    path: string;
+    title: string;
+    summary: string;
+    lines: number;
+    mtime: number;
+}
+export interface DocManifest {
+    schema_version: 1;
+    scanned_at: string;
+    files: DocManifestFile[];
+}
+export declare function scanDocIndex(directory: string): Promise<{
+    manifest: DocManifest;
+    cached: boolean;
+}>;
+/**
+ * Extract actionable constraints from project documentation relevant to a task.
+ *
+ * Algorithm:
+ * 1. Read .swarm/doc-manifest.json (or generate via scanDocIndex if missing)
+ * 2. Score each doc against task files + description using Jaccard bigram similarity
+ * 3. For docs with score > RELEVANCE_THRESHOLD, read full content and extract constraints
+ * 4. Dedup against existing knowledge entries before appending
+ * 5. Return extraction statistics
+ */
+export declare function extractDocConstraints(directory: string, taskFiles: string[], taskDescription: string): Promise<{
+    extracted: number;
+    skipped: number;
+    details: {
+        path: string;
+        score: number;
+        constraints: string[];
+    }[];
+}>;
+export declare const doc_scan: ReturnType<typeof createSwarmTool>;
+export declare const doc_extract: ReturnType<typeof createSwarmTool>;

package/dist/tools/index.d.ts

@@ -5,6 +5,7 @@ export { complexity_hotspots } from './complexity-hotspots';
 export { curator_analyze } from './curator-analyze';
 export { declare_scope } from './declare-scope';
 export { type DiffErrorResult, type DiffResult, diff } from './diff';
+export { doc_extract, doc_scan } from './doc-scan';
 export { detect_domains } from './domain-detector';
 export { evidence_check } from './evidence-check';
 export { extract_code_blocks } from './file-extractor';

package/package.json

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