opencode-swarm 7.84.0 → 7.86.0

package/dist/tools/dispatch-lanes.d.ts

@@ -56,6 +56,13 @@ export interface DispatchLaneResult {
     output?: string;
     output_chars?: number;
     output_truncated?: boolean;
+    output_ref?: string;
+    output_digest?: string;
+    output_preview_chars?: number;
+    output_degraded?: boolean;
+    output_artifact_error?: string;
+    transcript_incomplete?: boolean;
+    message_count?: number;
     error?: string;
 }
 export interface DispatchLanesResult {
@@ -194,7 +201,7 @@ export declare const _internals: {
 };
 export declare const _test_exports: {
     applyCommonPrompt: typeof applyCommonPrompt;
-    extractLastAssistantText: typeof extractLastAssistantText;
+    extractAssistantTranscript: typeof extractAssistantTranscript;
     formatError: typeof formatError;
     nextCollectPollInterval: typeof nextCollectPollInterval;
     promptHash: typeof promptHash;
@@ -235,7 +242,7 @@ interface DispatchLanesExecutionContext {
 export declare function executeDispatchLanes(args: unknown, directory: string, context?: DispatchLanesExecutionContext): Promise<DispatchLanesResult>;
 export declare function executeDispatchLanesAsync(args: unknown, directory: string, context?: DispatchLanesExecutionContext): Promise<DispatchLanesAsyncResult>;
 export declare function executeCollectLaneResults(args: unknown, directory: string, context?: Pick<DispatchLanesExecutionContext, 'sessionID'>): Promise<CollectLaneResultsResult>;
-declare function extractLastAssistantText(messages: Array<{
+declare function extractAssistantTranscript(messages: Array<{
     info?: {
         role?: string;
     };
@@ -243,7 +250,11 @@ declare function extractLastAssistantText(messages: Array<{
         type: string;
         text?: string;
     }>;
-}>): string;
+}>): {
+    text: string;
+    messageCount: number;
+    transcriptIncomplete: boolean;
+};
 declare function nextCollectPollInterval(currentMs: number): number;
 type ApplyCommonPromptResult = {
     ok: true;

package/dist/tools/index.d.ts

@@ -47,6 +47,7 @@ export { type QualityBudgetInput, type QualityBudgetResult, quality_budget, qual
 export { buildWorkspaceGraph, type GraphEdge, type GraphNode, loadGraph, loadOrCreateGraph, type RepoGraph, resolveModuleSpecifier, saveGraph, updateGraphForFiles, } from './repo-graph';
 export { repo_map } from './repo-map';
 export { req_coverage } from './req-coverage';
+export { retrieve_lane_output } from './retrieve-lane-output';
 export { retrieve_summary } from './retrieve-summary';
 export { type SastScanFinding, type SastScanInput, type SastScanResult, sast_scan, sastScan, } from './sast-scan';
 export type { SavePlanArgs, SavePlanResult } from './save-plan';

package/dist/tools/manifest.d.ts

@@ -56,6 +56,7 @@ export declare const TOOL_MANIFEST: {
     git_blame: () => ToolDefinition;
     gitingest: () => ToolDefinition;
     retrieve_summary: () => ToolDefinition;
+    retrieve_lane_output: () => ToolDefinition;
     extract_code_blocks: () => ToolDefinition;
     phase_complete: () => ToolDefinition;
     save_plan: () => ToolDefinition;

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

@@ -26,6 +26,8 @@ export declare const _internals: {
     extractPythonSymbols: typeof extractPythonSymbols;
     parseFileImports: typeof parseFileImports;
     extractFileOntology: typeof extractFileOntology;
+    stripComments: typeof stripComments;
+    computeUsedSymbols: typeof computeUsedSymbols;
 };
 /**
  * Add or update a node in the graph.
@@ -66,6 +68,16 @@ export declare function resolveModuleSpecifier(workspaceRoot: string, sourceFile
 /**
  * A parsed import with its specifier and type.
  */
+/**
+ * A single imported binding: the symbol's *exported* name in the target file
+ * and the *local* name it is bound to in the importing file (differs when an
+ * `as` alias or default import is used). Used to attribute call-site usage back
+ * to the correct exported symbol.
+ */
+interface ImportBinding {
+    imported: string;
+    local: string;
+}
 interface ParsedImport {
     /** The module specifier (e.g., './foo', 'lodash') */
     specifier: string;
@@ -73,8 +85,42 @@ interface ParsedImport {
     importType: 'default' | 'named' | 'namespace' | 'require' | 'sideeffect';
     /** Named imported symbols when statically detectable */
     importedSymbols: string[];
+    /** Alias-aware imported→local bindings for usage attribution */
+    bindings: ImportBinding[];
+    /** True for `export { x } from '...'` re-exports (symbols are re-exposed). */
+    reExport: boolean;
 }
+/**
+ * Strip line (`//…`) and block (`/* … *\/`) comments from JS/TS source while
+ * preserving string, template-literal, and regex-literal contents (DD-C010).
+ * Import specifiers live inside string literals, so strings must be kept
+ * intact; only comment spans are removed. This is a bounded single-pass scanner
+ * — not a full parser (AST parsing in the repo-graph init path would violate
+ * AGENTS.md invariant 1) — and it eliminates the most common source of false
+ * import edges: import-like text inside comments (`// import x from "y"`).
+ *
+ * It is string-aware (a `//` inside `"http://…"` is not a comment) and
+ * regex-aware (a regex literal such as `/[/*]/` must not be mistaken for the
+ * start of a block comment, which would otherwise run to EOF and delete real
+ * imports). Regex-vs-division is disambiguated by the previous significant
+ * character (REGEX_ALLOWED_AFTER).
+ */
+declare function stripComments(content: string): string;
 declare function parseFileImports(rawContent: string): ParsedImport[];
+/**
+ * Conservatively determine which imported bindings are actually referenced in
+ * the importing file's body.
+ *
+ * Heuristic: in a well-formed import statement, each local binding name appears
+ * exactly once. Counting occurrences of the local name across the
+ * comment-stripped file content, a count > 1 means at least one body reference.
+ * Strings are intentionally *not* stripped, so the bias is toward "used" — a
+ * conservative direction that avoids false dead-export positives. Bindings whose
+ * local name cannot be safely word-boundary matched are assumed used.
+ *
+ * @returns the *exported* names (binding.imported) judged to be used.
+ */
+declare function computeUsedSymbols(strippedContent: string, bindings: readonly ImportBinding[]): string[];
 /**
  * Result of scanning a single file for graph updates.
  */

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

@@ -1,10 +1,35 @@
-import type { BlastRadiusResult, FileOntology, FileReference, GraphNode, LocalizationBlock, PackageBoundarySummary, RepoGraph, SymbolReference } from './types';
+import type { BlastRadiusResult, CallerReference, DeadExportsResult, FileOntology, FileReference, GraphNode, LocalizationBlock, PackageBoundarySummary, RepoGraph, SymbolReference } from './types';
 export declare function getGraphNode(graph: RepoGraph, input: string): GraphNode | undefined;
 export declare function resetQueryCache(): void;
 export declare function isGraphFresh(graph: RepoGraph | null, maxAgeMs?: number): boolean;
 export declare function getImporters(graph: RepoGraph, filePath: string): FileReference[];
 export declare function getDependencies(graph: RepoGraph, filePath: string): FileReference[];
 export declare function getSymbolConsumers(graph: RepoGraph, filePath: string, symbolName: string): SymbolReference[];
+/**
+ * Files that actually *reference* an exported symbol of `filePath` — call-site
+ * granularity, not just "imports the file". On schema >= 1.1.0 graphs this uses
+ * per-edge `usedSymbols`; on older graphs (or namespace imports) it falls back
+ * to import-level matching, flagged via `resolution: 'imported'`.
+ */
+export declare function getCallers(graph: RepoGraph, filePath: string, symbolName: string): CallerReference[];
+export interface DeadExportsOptions {
+    /** Max candidates returned (default 100). */
+    maxCandidates?: number;
+}
+/**
+ * Conservatively detect exported symbols with no detected in-repo reference.
+ *
+ * Scoping for precision (advisory "candidate" output, never a delete directive):
+ *   - Requires schema >= 1.1.0 (per-edge usedSymbols); otherwise returns
+ *     schemaSupported=false so the caller can prompt a rebuild.
+ *   - Only considers files imported by >= 1 other file — a file with no
+ *     importers is a likely public-API entry / CLI / test, not dead code.
+ *   - Skips files imported anywhere via namespace/side-effect/require/dynamic
+ *     imports, where per-symbol usage is unresolvable.
+ *   - Excludes framework-invoked roles (routes, CLIs, tests, agents, hooks,
+ *     middleware) and the synthetic 'default' export.
+ */
+export declare function getDeadExports(graph: RepoGraph, options?: DeadExportsOptions): DeadExportsResult;
 export declare function getBlastRadius(graph: RepoGraph, filePaths: string[], maxDepth?: number): BlastRadiusResult;
 export declare function getKeyFiles(graph: RepoGraph, topN?: number): GraphNode[];
 export declare function getFileOntology(graph: RepoGraph, filePath: string): FileOntology | null;

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

@@ -7,7 +7,23 @@
  * Every other submodule imports from here.
  */
 export declare const REPO_GRAPH_FILENAME = "repo-graph.json";
-export declare const GRAPH_SCHEMA_VERSION = "1.0.0";
+/**
+ * Graph schema version.
+ *
+ * 1.1.0 added per-edge `usedSymbols` (imported symbols actually referenced in
+ * the importing file) and per-node `exportLines`, enabling the `callers` and
+ * `dead_exports` queries. Both fields are optional, so graphs written by older
+ * versions (1.0.0) still load — but `dead_exports` requires >= 1.1.0 data and
+ * self-gates via {@link isSchemaVersionAtLeast} rather than relying on the
+ * loader (which only checks that a version string is present, not its value).
+ */
+export declare const GRAPH_SCHEMA_VERSION = "1.1.0";
+/**
+ * Compare dotted numeric version strings (e.g. '1.1.0' >= '1.1.0').
+ * Missing/non-numeric segments are treated as 0. Returns true when `version`
+ * is greater than or equal to `minimum`.
+ */
+export declare function isSchemaVersionAtLeast(version: string | undefined, minimum: string): boolean;
 export declare const FILE_ROLE_VALUES: readonly ["api_route", "middleware", "service_module", "data_module", "swarm_tool", "agent", "hook", "config", "schema", "test_file", "cli_command", "documentation", "source_module"];
 export type FileRole = (typeof FILE_ROLE_VALUES)[number];
 export declare const ROUTE_METHOD_VALUES: readonly ["GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS", "HEAD", "ALL"];
@@ -73,6 +89,13 @@ export interface GraphNode {
     moduleName: string;
     /** Exported symbols from this file */
     exports: string[];
+    /**
+     * Definition line for each exported symbol, keyed by symbol name (1-based).
+     * Optional and best-effort: present on graphs built at schema >= 1.1.0,
+     * absent for symbols whose line could not be determined. Used to point
+     * `dead_exports` candidates at a location.
+     */
+    exportLines?: Record<string, number>;
     /** Imported module specifiers */
     imports: string[];
     /** Language/extension of the file */
@@ -98,6 +121,14 @@ export interface GraphEdge {
     importType: ImportType;
     /** Named symbols imported from the target, when statically detectable */
     importedSymbols?: string[];
+    /**
+     * The subset of the target's exported symbols (by their *exported* name)
+     * that are actually referenced in the source file's body — not merely
+     * imported. Computed at build time via a conservative, alias-aware textual
+     * scan (schema >= 1.1.0). Absent on namespace/side-effect/require/dynamic
+     * imports, where individual symbol usage is not statically resolvable.
+     */
+    usedSymbols?: string[];
 }
 export interface FileReference {
     file: string;
@@ -109,6 +140,47 @@ export interface SymbolReference {
     line?: number;
     importedAs: string;
 }
+/**
+ * A file that references a specific exported symbol of a target file.
+ * `resolution` records how confidently the usage was attributed:
+ *   - 'used'     → the symbol was found referenced in the source body
+ *   - 'imported' → fallback for graphs predating usedSymbols (schema < 1.1.0);
+ *                  the symbol is imported but body usage was not analyzed
+ */
+export interface CallerReference {
+    file: string;
+    resolution: 'used' | 'imported';
+}
+/**
+ * An exported symbol with no detected in-repo reference. Advisory only —
+ * regex-based analysis cannot see dynamic dispatch, string-keyed access, or
+ * usage through namespace/barrel re-exports, so this is a *candidate* for
+ * review, never a directive to delete.
+ */
+export interface DeadExportCandidate {
+    /** Module name (workspace-relative) of the file that owns the export */
+    file: string;
+    /** The exported symbol name */
+    symbol: string;
+    /** Definition line, when known (from exportLines) */
+    line?: number;
+    /** How many other in-repo files import this file at all */
+    importerCount: number;
+}
+export interface DeadExportsResult {
+    /** False when the graph predates schema 1.1.0 (rebuild required). */
+    schemaSupported: boolean;
+    /** Files whose exports were analyzed (imported by >= 1 other file). */
+    analyzedFiles: number;
+    /**
+     * Files skipped because at least one importer used a namespace/side-effect/
+     * require/dynamic import, making per-symbol usage unresolvable.
+     */
+    skippedUnresolvable: number;
+    candidates: DeadExportCandidate[];
+    /** Human-readable note describing scope and limitations of the result. */
+    note: string;
+}
 export interface BlastRadiusResult {
     target: string[];
     directDependents: string[];

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

@@ -20,8 +20,9 @@ export { clearCache, getCachedGraph, getCachedMtime, isDirty, markDirty, setCach
 export { updateGraphForFiles } from './repo-graph/incremental';
 export type { ExtractFileOntologyInput } from './repo-graph/ontology';
 export { extractFileOntology } from './repo-graph/ontology';
-export { buildOntologyPreflightPacket, getBlastRadius, getDependencies, getFileOntology, getGraphNode, getImporters, getKeyFiles, getLocalizationContext, getPackageBoundaries, getSymbolConsumers, isGraphFresh, resetQueryCache, } from './repo-graph/query';
+export type { DeadExportsOptions } from './repo-graph/query';
+export { buildOntologyPreflightPacket, getBlastRadius, getCallers, getDeadExports, getDependencies, getFileOntology, getGraphNode, getImporters, getKeyFiles, getLocalizationContext, getPackageBoundaries, getSymbolConsumers, isGraphFresh, resetQueryCache, } from './repo-graph/query';
 export { getGraphPath, loadGraph, loadGraphSync, loadOrCreateGraph, saveGraph, saveIfDirty, } from './repo-graph/storage';
-export type { BlastRadiusResult, BuildWorkspaceGraphOptions, ConventionFact, DataOperationFact, FileOntology, FileReference, FileRole, GraphEdge, GraphNode, LocalizationBlock, OntologyFinding, PackageBoundarySummary, RepoGraph, RouteFact, RouteMethod, SecurityFact, SymbolReference, } from './repo-graph/types';
-export { createEmptyGraph, GRAPH_SCHEMA_VERSION, normalizeGraphPath, REPO_GRAPH_FILENAME, updateGraphMetadata, } from './repo-graph/types';
+export type { BlastRadiusResult, BuildWorkspaceGraphOptions, CallerReference, ConventionFact, DataOperationFact, DeadExportCandidate, DeadExportsResult, FileOntology, FileReference, FileRole, GraphEdge, GraphNode, LocalizationBlock, OntologyFinding, PackageBoundarySummary, RepoGraph, RouteFact, RouteMethod, SecurityFact, SymbolReference, } from './repo-graph/types';
+export { createEmptyGraph, GRAPH_SCHEMA_VERSION, isSchemaVersionAtLeast, normalizeGraphPath, REPO_GRAPH_FILENAME, updateGraphMetadata, } from './repo-graph/types';
 export { validateGraphEdge, validateGraphNode, validateWorkspace, } from './repo-graph/validation';

package/dist/tools/retrieve-lane-output.d.ts

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

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

@@ -155,6 +155,10 @@ export declare const TOOL_METADATA: {
         description: string;
         agents: ("reviewer" | "test_engineer" | "coder" | "docs" | "designer" | "explorer" | "sme" | "critic" | "critic_sounding_board" | "critic_drift_verifier" | "critic_hallucination_verifier" | "critic_architecture_supervisor" | "critic_oversight" | "architect" | "docs_design" | "spec_writer")[];
     };
+    retrieve_lane_output: {
+        description: string;
+        agents: "architect"[];
+    };
     extract_code_blocks: {
         description: string;
         agents: ("reviewer" | "test_engineer" | "coder" | "docs" | "designer" | "explorer" | "sme" | "architect" | "docs_design" | "spec_writer")[];

package/package.json

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