opencode-swarm 7.160.2 → 7.161.0

package/dist/learning/admission.d.ts

@@ -17,8 +17,8 @@
  *
  * - the `transactKnowledge` call is NEVER raced or timed out;
  * - only genuinely cancellable work (the optional LLM screening call) is
- *   bounded, via a manual `AbortController` + `setTimeout` (see
- *   `timeoutSignal` below) + `isAbortError`. This deliberately does NOT use
+ *   bounded by the shared `withTimeoutSignal` helper, which uses a manual
+ *   `AbortController` + `setTimeout` + `isAbortError`. This deliberately does NOT use
  *   the host's built-in timeout signal: Bun on Windows
  *   has a native bug where that signal's `abort` event never fires when
  *   awaited by a plain JS Promise (oven-sh/bun#29546) — exactly the shape

package/dist/memory/schema.d.ts

@@ -52,8 +52,8 @@ export declare const MemorySourceSchema: z.ZodObject<{
         agent: "agent";
         file: "file";
         tool: "tool";
-        manual: "manual";
         test: "test";
+        manual: "manual";
         commit: "commit";
         user: "user";
         repo: "repo";
@@ -117,8 +117,8 @@ export declare const MemoryRecordSchema: z.ZodObject<{
             agent: "agent";
             file: "file";
             tool: "tool";
-            manual: "manual";
             test: "test";
+            manual: "manual";
             commit: "commit";
             user: "user";
             repo: "repo";
@@ -211,8 +211,8 @@ export declare const MemoryProposalSchema: z.ZodObject<{
                 agent: "agent";
                 file: "file";
                 tool: "tool";
-                manual: "manual";
                 test: "test";
+                manual: "manual";
                 commit: "commit";
                 user: "user";
                 repo: "repo";

package/dist/observability/catalog.d.ts

@@ -1,7 +1,7 @@
 /**
  * The event catalog (issue #2029).
  *
- * Exactly 55 entries, matching the `TelemetryEvent` union at
+ * Exactly 56 entries, matching the `TelemetryEvent` union at
  * `src/telemetry.ts:15-131`. Thirty-eight predate the #2029 contract; the 39th is
  * `agent_conflict_detected` (previously emitted through a force-cast past the
  * type system), the 40th is `close_archive_result` (issue #2030 — the
@@ -80,7 +80,7 @@ export interface CatalogEntry {
     /**
      * Whether an event of this kind must carry `trace.parentSpanId`.
      *
-     * `false` for all 55 entries today, and that is a truthful statement about
+     * `false` for all 56 entries today, and that is a truthful statement about
      * the current system rather than a placeholder: no producer supplies a
      * parent span, so `createObservation` never sets one. Setting this to `true`
      * for a kind whose producer cannot supply a parent would make every

package/dist/prm/types.d.ts

@@ -38,6 +38,15 @@ export interface TrajectoryEntry {
     args_summary?: string;
     /** Optional: elapsed time in milliseconds */
     elapsed_ms?: number;
+    /**
+     * Issue #2045 canonical join keys for delegation-terminal observations: a
+     * lane terminal entry correlates to its background-delegation record by
+     * these exact IDs, never by agent-name matching. Optional + additive; the
+     * bounded store serializes entries as JSON with no strict field validation.
+     */
+    batchId?: string;
+    laneId?: string;
+    taskId?: string;
 }
 /**
  * Result of pattern detection indicating a detected problematic trajectory pattern

package/dist/telemetry.d.ts

@@ -1,6 +1,6 @@
 import { createObservation, toLegacyTelemetryLine } from './observability/index.js';
 import type { DelegationCostFields } from './services/cost-accounting.js';
-export type TelemetryEvent = 'session_started' | 'session_ended' | 'agent_activated' | 'delegation_begin' | 'delegation_end' | 'delegation_cost_correction' | 'delegation_cost_binding' | 'delegation_cost_join' | 'task_state_changed' | 'gate_passed' | 'gate_failed' | 'gate_parse_error' | 'reviewer_gate_decision' | 'phase_changed' | 'budget_updated' | 'context_pruned' | 'model_fallback'
+export type TelemetryEvent = 'session_started' | 'session_ended' | 'agent_activated' | 'delegation_begin' | 'delegation_end' | 'delegation_cost_correction' | 'delegation_cost_binding' | 'delegation_cost_join' | 'task_state_changed' | 'gate_passed' | 'gate_failed' | 'gate_parse_error' | 'reviewer_gate_decision' | 'phase_changed' | 'budget_updated' | 'context_pruned' | 'retrieval_routed' | 'model_fallback'
 /**
  * Issue #2271 bug 4 — a configured agent model id was POSITIVELY confirmed
  * unresolvable against the live provider catalog (distinct from a runtime
@@ -435,6 +435,14 @@ export declare const telemetry: {
      * containment armed but never reached the model.
      */
     prmHardStopDelivered(sessionId: string, pattern: string, level: number, occurrenceCount: number): void;
+    retrievalRouted(sessionId: string, data: {
+        mode: "graph" | "lexical" | "semantic" | "security" | "test" | "hybrid";
+        graph_hit: boolean;
+        fallback_reason: string | null;
+        token_budget_requested: number;
+        token_budget_used: number;
+        omitted_context_count: number;
+    }): void;
 };
 /**
  * Test-only dependency-injection seam. Production code calls

package/dist/tools/repo-graph/retrieval-router.d.ts

@@ -0,0 +1,57 @@
+import type { RepoGraph, RouteMethod } from './types';
+export declare const RETRIEVAL_MODES: readonly ["graph", "lexical", "semantic", "security", "test", "hybrid"];
+export type RetrievalMode = (typeof RETRIEVAL_MODES)[number];
+export declare const ROUTER_METADATA_OVERHEAD_TOKENS = 2048;
+export interface RetrievalRequest {
+    question: string;
+    file?: string;
+    files?: string[];
+    symbol?: string;
+    diff?: string;
+    entity?: string;
+    routePath?: string;
+    method?: RouteMethod;
+    maxTokens?: number;
+    topN?: number;
+}
+export interface LexicalResult {
+    matches?: unknown[];
+    total?: number;
+    truncated?: boolean;
+    engine?: string;
+    warning?: string;
+    error?: boolean;
+}
+/** Structured fallback request so lexical retrieval preserves validated scope
+ * and security hints instead of reducing everything to a bare string. */
+export interface LexicalRequest {
+    query: string;
+    files?: string[];
+    routePath?: string;
+    method?: RouteMethod;
+}
+export interface RetrievalResult {
+    mode: RetrievalMode;
+    algorithm: 'literal' | 'graph' | 'fuzzy_graph' | 'graph_packs' | 'mixed';
+    reason: string;
+    actions: string[];
+    graphHit: boolean;
+    fallbackReason: string | null;
+    context: Array<{
+        action: string;
+        data: unknown;
+    }>;
+    explanation: string[];
+    warnings: string[];
+    budget: {
+        requestedTokens: number;
+        usedTokens: number;
+        omittedContextCount: number;
+        metadataOverheadTokens: number;
+    };
+}
+export declare function classifyRetrieval(question: string): {
+    mode: RetrievalMode;
+    reason: string;
+};
+export declare function routeRetrieval(graph: RepoGraph | null, request: RetrievalRequest, lexical: (request: LexicalRequest) => Promise<LexicalResult>, graphUnavailableReason?: string): Promise<RetrievalResult>;

package/dist/tools/repo-graph.d.ts

@@ -28,6 +28,8 @@ export { extractFileOntology, normalizeRoutePathInput, } from './repo-graph/onto
 export { buildTestPack, traceData, traceRoute } from './repo-graph/pack-query';
 export type { DeadExportsOptions } from './repo-graph/query';
 export { buildOntologyPreflightPacket, getBlastRadius, getCallers, getContextPack, getDeadExports, getDependencies, getFileOntology, getGraphHealth, getGraphNode, getImporters, getKeyFiles, getLocalizationContext, getPackageBoundaries, getSymbolConsumers, isGraphFresh, resetQueryCache, } from './repo-graph/query';
+export type { LexicalRequest, LexicalResult, RetrievalMode, RetrievalRequest, RetrievalResult, } from './repo-graph/retrieval-router';
+export { classifyRetrieval, RETRIEVAL_MODES, ROUTER_METADATA_OVERHEAD_TOKENS, routeRetrieval, } from './repo-graph/retrieval-router';
 export { getGraphPath, loadGraph, loadGraphSync, loadOrCreateGraph, saveGraph, saveIfDirty, } from './repo-graph/storage';
 export { explainGraphEntry, getDiffContext, getImpactCone, getSymbolContext, searchSymbols, } from './repo-graph/symbol-query';
 export type { AskHit, AskOptions, AskResult, BlastRadiusResult, BuildWorkspaceGraphOptions, CallerReference, ConeEntry, ContextPackCoverage, ContextPackResult, ContextPackSnippet, ContextPackSourceMode, ContextPackSpan, ConventionFact, DataOperationFact, DataTraceAccess, DataTraceResult, DeadExportCandidate, DeadExportsResult, DerivedAssociation, DiffContextResult, DiffFileSummary, DiffSymbolChange, ExplainReason, FileOntology, FileReference, FileRole, FreshnessProbeState, GraphEdge, GraphExplainResult, GraphExtractionFailure, GraphExtractorInputWitness, GraphHealthResult, GraphNode, GraphSymbolKind, GraphSymbolVisibility, GraphUnresolvedImport, ImpactConeResult, LocalizationBlock, OntologyFinding, OntologyLink, OntologyLinkConfidence, OntologyLinkKind, PackageBoundarySummary, RepoGraph, RepoGraphDiagnostics, RouteFact, RouteMethod, RouteTraceResult, RouteTraceRoute, SecurityFact, SymbolContextResult, SymbolEdge, SymbolEdgeEvidence, SymbolEdgeKind, SymbolEdgeResolution, SymbolHit, SymbolIdentityKind, SymbolReference, SymbolSearchResult, TestPackFixture, TestPackResult, TestPackTestEntry, } from './repo-graph/types';

package/dist/tools/repo-map.d.ts

@@ -6,5 +6,207 @@ export declare const _internals: {
     probeFreshness: typeof probeFreshness;
     updateGraphForFiles: typeof updateGraphForFiles;
     writeFingerprint: typeof writeFingerprint;
+    telemetry: {
+        sessionStarted(sessionId: string, agentName: string): void;
+        sessionEnded(sessionId: string, reason: string): void;
+        agentActivated(sessionId: string, agentName: string, oldName?: string): void;
+        delegationBegin(sessionId: string, agentName: string, taskId: string): void;
+        delegationEnd(sessionId: string, agentName: string, taskId: string, result: string, costFields?: Partial<import("../services/cost-accounting").DelegationCostFields>): void;
+        taskStateChanged(sessionId: string, taskId: string, newState: string, oldState?: string): void;
+        gatePassed(sessionId: string, gate: string, taskId: string): void;
+        gateParseError(taskId: string, error: Error): void;
+        gateFailed(sessionId: string, gate: string, taskId: string, reason: string): void;
+        reviewerGateDecision(sessionId: string, taskId: string, blocked: boolean, reasonCode: import("../telemetry").ReviewerGateReasonCode, evidenceKind: import("../telemetry").ReviewerGateEvidenceKind): void;
+        phaseChanged(sessionId: string, oldPhase: number, newPhase: number): void;
+        budgetUpdated(sessionId: string, budgetPct: number, agentName: string): void;
+        contextPruned(data: {
+            sessionId: string;
+            agentName: string;
+            trigger: "agent_switch" | "critical_threshold";
+            usageSource: "provider" | "estimated";
+            beforeTokens: number;
+            afterTokens: number;
+            modelLimit: number;
+            maskedMessages: number;
+            maskedToolParts: number;
+            maskedTokensFreed: number;
+            prunedMessages: number;
+            prunedTextParts: number;
+            prunedToolParts: number;
+            prunedTokensFreed: number;
+        }): void;
+        modelFallback(sessionId: string, agentName: string, fromModel: string, toModel: string, reason: string): void;
+        modelUnresolved(agentName: string, model: string, detail: string): void;
+        hardLimitHit(sessionId: string, agentName: string, limitType: string, value: number): void;
+        revisionLimitHit(sessionId: string, agentName: string): void;
+        loopDetected(sessionId: string, agentName: string, loopType: string): void;
+        noOpStrongWarning(sessionId: string, agentName: string, count: number, threshold: number): void;
+        gateDenialLoop(sessionId: string, tool: string, code: string, count: number): void;
+        executionStallWarning(sessionId: string, count: number, threshold: number): void;
+        executionStallDenied(sessionId: string, tool: string, count: number, threshold: number): void;
+        swarmInternalsReadDenied(sessionId: string, tool: string, target: string): void;
+        scopeViolation(sessionId: string, agentName: string, file: string, reason: string): void;
+        qaSkipViolation(sessionId: string, agentName: string, skipCount: number): void;
+        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;
+        prmPatternDetected(sessionId: string, pattern: string, severity: string, category: string, stepRange: [number, number]): void;
+        prmCourseCorrectionInjected(sessionId: string, pattern: string, level: number): void;
+        prmEscalationTriggered(sessionId: string, pattern: string, level: number, occurrenceCount: number): void;
+        prmHardStop(sessionId: string, pattern: string, level: number, occurrenceCount: number): void;
+        closeArchiveResult(data: {
+            archive_valid: boolean;
+            archive_empty: boolean;
+            file_count: number;
+            bundle: string;
+            artifacts: Array<{
+                artifact: string;
+                requiredness: string;
+                attempt: string;
+                validation: string;
+                source_disposition: string;
+                method: string;
+                reason_code: string;
+                row_counts?: {
+                    schema_migrations_max_version: number | null;
+                    project_constraints: number;
+                    qa_gate_profile: number;
+                };
+            }>;
+        }): void;
+        residueHealth(data: {
+            trigger: string;
+            scanned: number;
+            matched: number;
+            eligible: number;
+            ambiguous: number;
+            quarantined: number;
+            preserved: number;
+            total_bytes: number;
+            oldest_age_ms: number;
+            grammar_counts: Record<string, number>;
+        }): void;
+        contextTelemetryHealth(data: {
+            trigger: "compaction" | "close";
+            accepted_count: number;
+            compacted_count: number;
+            retained_count: number;
+            dropped_count: number;
+            corrupt_count: number;
+            oldest_timestamp: string | null;
+            newest_timestamp: string | null;
+            bytes: number;
+            limit_bytes: number;
+        }): void;
+        skillUsageHealth(data: {
+            trigger: "compaction" | "migration" | "consumption" | "pressure";
+            accepted: number;
+            compacted: number;
+            dropped: number;
+            skills_dropped: number;
+            corrupt: number;
+            pending_retained: number;
+            uncertain_retained: number;
+            uncertain_expired: number;
+            pending_evicted: number;
+            no_source_knowledge: number;
+            no_matching_knowledge: number;
+            bump_retry: number;
+            bump_unrecoverable: number;
+            bump_applied_zero: number;
+            pressure: number;
+            curator_skipped: number;
+            bytes: number;
+            limit_bytes: number;
+            oldest_timestamp: string | null;
+            newest_timestamp: string | null;
+            coverage: boolean;
+        }): void;
+        coreEventsHealth(data: {
+            trigger: "compaction" | "close";
+            accepted_count: number;
+            compacted_count: number;
+            retained_count: number;
+            dropped_count: number;
+            corrupt_count: number;
+            authority_index_count: number;
+            authority_evicted_count: number;
+            oldest_timestamp: string | null;
+            newest_timestamp: string | null;
+            bytes: number;
+            limit_bytes: number;
+        }): void;
+        shellAuditHealth(data: {
+            trigger: "compaction" | "close";
+            accepted_count: number;
+            compacted_count: number;
+            retained_count: number;
+            dropped_count: number;
+            corrupt_count: number;
+            oldest_timestamp: string | null;
+            newest_timestamp: string | null;
+            bytes: number;
+            limit_bytes: number;
+        }): void;
+        trajectoryHealth(data: {
+            trigger: "compaction" | "cleanup" | "append_skip";
+            retained_count: number;
+            dropped_count: number;
+            corrupt_count: number;
+            skipped_lock_count: number;
+            bytes: number;
+            limit_bytes: number;
+        }): void;
+        prSubscriptionHealth(data: {
+            trigger: "compact" | "migrate-complete" | "archive" | "foreign-rebind" | "corrupt-quarantine";
+            active_count: number;
+            terminal_count: number;
+            compactions: number;
+            corrupt_count: number;
+            dropped_audit_count: number;
+            recovery_resets: number;
+            checkpoint_bytes: number;
+            limit_bytes: number;
+        }): void;
+        learningHealthAlarm(data: {
+            alarm: string;
+            transition: "raised" | "sustained" | "recovered";
+            severity: "warning" | "critical";
+            scope_class: "session" | "identity" | "project";
+            session_ref?: string;
+            model?: string;
+            provider?: string;
+            window_ms: number;
+            coverage_facts: number;
+            raise_facts: number;
+            age_ms: number;
+            limit_source?: string;
+            denominator_fallback?: boolean;
+            pressure_pct?: number;
+            band?: string;
+            share_pct?: number;
+            field_count?: number;
+            non_field_count?: number;
+            store?: string;
+            dropped?: number;
+            corrupt?: number;
+            retained?: number;
+            accepted?: number;
+            gap_type?: "membership_to_terminal" | "terminal_to_application";
+            role?: string;
+            phase?: number;
+            reason?: string;
+        }): void;
+        prmHardStopDelivered(sessionId: string, pattern: string, level: number, occurrenceCount: number): void;
+        retrievalRouted(sessionId: string, data: {
+            mode: "graph" | "lexical" | "semantic" | "security" | "test" | "hybrid";
+            graph_hit: boolean;
+            fallback_reason: string | null;
+            token_budget_requested: number;
+            token_budget_used: number;
+            omitted_context_count: number;
+        }): void;
+    };
 };
 export declare const repo_map: ReturnType<typeof createSwarmTool>;

package/dist/tools/search.d.ts

@@ -44,13 +44,13 @@ interface FallbackSearchOptions {
 /**
  * Execute search using Node.js fallback (when ripgrep not available).
  */
-declare function fallbackSearch(opts: FallbackSearchOptions): Promise<SearchResult | SearchError>;
+export declare function searchWorkspaceLiteral(opts: FallbackSearchOptions): Promise<SearchResult | SearchError>;
 export declare const search: ToolDefinition;
 export declare const _internals: {
     resolvePackagedRipgrep: typeof resolvePackagedRipgrep;
     resolveExecutableFromPath: typeof resolveExecutableFromPath;
     resolveRipgrepBinary: typeof resolveRipgrepBinary;
     runExternalTool: typeof runExternalTool;
-    fallbackSearch: typeof fallbackSearch;
+    fallbackSearch: typeof searchWorkspaceLiteral;
 };
 export {};

package/package.json

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