opencode-swarm 7.94.1 → 7.96.0

package/dist/plan/checkpoint.d.ts

@@ -1,6 +1,20 @@
+/**
+ * Checkpoint artifact writer.
+ * Writes SWARM_PLAN.md and SWARM_PLAN.json inside .swarm/plan-export/.
+ * Export-only — not a live runtime source of truth.
+ * Called on: save_plan, phase completion, /swarm close.
+ * NOT called on every task update.
+ */
+import * as fs from 'node:fs';
+export declare const _fsInternals: {
+    mkdirSync: (path: fs.PathLike, options?: fs.MakeDirectoryOptions | fs.Mode | null | undefined) => string | undefined;
+    writeFileSync: (path: string, data: string, encoding?: BufferEncoding) => void;
+    readFileSync: (path: string, encoding?: BufferEncoding) => string;
+    existsSync: (path: string) => boolean;
+};
 import { type Plan } from '../config/plan-schema';
 /**
- * Write SWARM_PLAN.json and SWARM_PLAN.md inside the .swarm/ directory under the project root.
+ * Write SWARM_PLAN.json and SWARM_PLAN.md inside the .swarm/plan-export/ directory under the project root.
  * Non-blocking: logs a warning on failure but never throws.
  * @param directory - The working directory (project root)
  */
@@ -14,7 +28,7 @@ export interface ImportCheckpointResult {
     error?: string;
 }
 /**
- * Import a checkpoint from .swarm/SWARM_PLAN.json (with backward-compat fallback to project root).
+ * Import a checkpoint from .swarm/plan-export/SWARM_PLAN.json (with backward-compat fallback to .swarm/ and project root).
  * Validates the checkpoint against PlanSchema, persists it as the live plan
  * via savePlan, and appends a 'plan_rebuilt' ledger event.
  *

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

@@ -0,0 +1,29 @@
+import type { ToolDefinition } from '@opencode-ai/plugin/tool';
+import { resolveExecutableFromPath, runExternalTool } from '../utils/external-tool-runner';
+interface ActionlintFinding {
+    file: string;
+    line: number;
+    column: number;
+    kind: string;
+    message: string;
+    endColumn?: number;
+}
+interface WorkflowDiscoveryResult {
+    files: string[];
+    truncated: boolean;
+}
+declare function resolveActionlintBinary(): string | null;
+declare function discoverWorkflowFiles(workspace: string): WorkflowDiscoveryResult;
+declare function parseActionlintOutput(stdout: string, workspace: string, maxResults: number): {
+    findings: ActionlintFinding[];
+    total: number;
+};
+export declare const actionlint_scan: ToolDefinition;
+export declare const _internals: {
+    resolveExecutableFromPath: typeof resolveExecutableFromPath;
+    resolveActionlintBinary: typeof resolveActionlintBinary;
+    runExternalTool: typeof runExternalTool;
+    discoverWorkflowFiles: typeof discoverWorkflowFiles;
+    parseActionlintOutput: typeof parseActionlintOutput;
+};
+export {};

package/dist/tools/ast-grep.d.ts

@@ -0,0 +1,26 @@
+import type { ToolDefinition } from '@opencode-ai/plugin/tool';
+import { resolveExecutableFromPath, runExternalTool } from '../utils/external-tool-runner';
+interface AstGrepMatch {
+    file: string;
+    lineNumber: number;
+    column: number;
+    endLineNumber: number;
+    endColumn: number;
+    text: string;
+    lines: string;
+    language?: string;
+    metaVariables?: unknown;
+}
+declare function resolveAstGrepBinary(): string | null;
+declare function parseAstGrepStream(stdout: string, workspace: string, maxResults: number): {
+    matches: AstGrepMatch[];
+    total: number;
+};
+export declare const ast_grep: ToolDefinition;
+export declare const _internals: {
+    resolveExecutableFromPath: typeof resolveExecutableFromPath;
+    resolveAstGrepBinary: typeof resolveAstGrepBinary;
+    runExternalTool: typeof runExternalTool;
+    parseAstGrepStream: typeof parseAstGrepStream;
+};
+export {};

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

@@ -26,6 +26,7 @@ declare const DispatchLanesAsyncArgsSchema: z.ZodObject<{
     common_prompt: z.ZodOptional<z.ZodString>;
     max_concurrent: z.ZodOptional<z.ZodNumber>;
     timeout_ms: z.ZodOptional<z.ZodNumber>;
+    launch_timeout_ms: z.ZodOptional<z.ZodNumber>;
     batch_id: z.ZodOptional<z.ZodString>;
     mode: z.ZodOptional<z.ZodString>;
     pr_head_sha: z.ZodOptional<z.ZodString>;
@@ -88,6 +89,8 @@ export interface DispatchLanesAsyncResult {
     failed: number;
     rejected: number;
     max_concurrent: number;
+    launch_timeout_ms: number;
+    /** Deprecated alias for launch_timeout_ms; retained for existing callers. */
     timeout_ms: number;
     lane_results: DispatchLaneResult[];
     errors?: string[];
@@ -181,6 +184,16 @@ export interface SessionOps {
         }> | null;
         error?: unknown;
     }>;
+    status?: (args: {
+        query?: {
+            directory?: string;
+        };
+    }) => Promise<{
+        data?: Record<string, {
+            type?: string;
+        }> | null;
+        error?: unknown;
+    }>;
     abort?: (args: {
         path: {
             id: string;
@@ -225,11 +238,16 @@ export declare const _test_exports: {
         common_prompt: z.ZodOptional<z.ZodString>;
         max_concurrent: z.ZodOptional<z.ZodNumber>;
         timeout_ms: z.ZodOptional<z.ZodNumber>;
+        launch_timeout_ms: z.ZodOptional<z.ZodNumber>;
         batch_id: z.ZodOptional<z.ZodString>;
         mode: z.ZodOptional<z.ZodString>;
         pr_head_sha: z.ZodOptional<z.ZodString>;
         scope: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
+    DEFAULT_TIMEOUT_MS: number;
+    DEFAULT_ASYNC_LAUNCH_TIMEOUT_MS: number;
+    DEFAULT_ASYNC_STALE_TIMEOUT_MS: number;
+    DEFAULT_COLLECT_TIMEOUT_MS: number;
 };
 type ReadOnlyToolPermissions = Record<string, false> & {
     write: false;

package/dist/tools/gh-evidence.d.ts

@@ -0,0 +1,10 @@
+import type { ToolDefinition } from '@opencode-ai/plugin/tool';
+import { resolveExecutableFromPath, runExternalTool } from '../utils/external-tool-runner';
+declare function resolveGhBinary(): string | null;
+export declare const gh_evidence: ToolDefinition;
+export declare const _internals: {
+    resolveExecutableFromPath: typeof resolveExecutableFromPath;
+    resolveGhBinary: typeof resolveGhBinary;
+    runExternalTool: typeof runExternalTool;
+};
+export {};

package/dist/tools/index.d.ts

@@ -1,6 +1,8 @@
 import { swarmApplyPatch } from './apply-patch';
 export { swarmApplyPatch };
 export declare const swarm_apply_patch: typeof swarmApplyPatch;
+export { actionlint_scan } from './actionlint-scan';
+export { ast_grep } from './ast-grep';
 export { batch_symbols } from './batch-symbols';
 export { build_check } from './build-check';
 export { check_gate_status } from './check-gate-status';
@@ -29,6 +31,7 @@ export { external_skill_revoke } from './external-skill-revoke';
 export { extract_code_blocks } from './file-extractor';
 export { get_approved_plan } from './get-approved-plan';
 export { get_qa_gate_profile } from './get-qa-gate-profile';
+export { gh_evidence } from './gh-evidence';
 export { git_blame } from './git-blame';
 export { fetchGitingest, type GitingestArgs, gitingest } from './gitingest';
 export { imports } from './imports';
@@ -39,6 +42,7 @@ export { knowledge_recall } from './knowledge-recall';
 export { knowledge_receipt } from './knowledge-receipt';
 export { knowledge_remove } from './knowledge-remove';
 export { lint } from './lint';
+export { osv_scan } from './osv-scan';
 export { parse_lane_candidates } from './parse-lane-candidates';
 export { phase_complete } from './phase-complete';
 export { pkg_audit } from './pkg-audit';

package/dist/tools/manifest.d.ts

@@ -77,6 +77,10 @@ export declare const TOOL_MANIFEST: {
     knowledge_remove: () => ToolDefinition;
     co_change_analyzer: () => ToolDefinition;
     search: () => ToolDefinition;
+    ast_grep: () => ToolDefinition;
+    actionlint_scan: () => ToolDefinition;
+    osv_scan: () => ToolDefinition;
+    gh_evidence: () => ToolDefinition;
     batch_symbols: () => ToolDefinition;
     suggest_patch: () => ToolDefinition;
     req_coverage: () => ToolDefinition;

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

@@ -0,0 +1,27 @@
+import type { ToolDefinition } from '@opencode-ai/plugin/tool';
+import { resolveExecutableFromPath, runExternalTool } from '../utils/external-tool-runner';
+interface OsvFinding {
+    id: string;
+    summary?: string;
+    packageName?: string;
+    ecosystem?: string;
+    installedVersion?: string;
+    fixedVersion?: string;
+    aliases?: string[];
+    references?: string[];
+}
+interface ParsedOsvOutput {
+    findings: OsvFinding[];
+    total: number;
+    parseError: boolean;
+}
+declare function resolveOsvScannerBinary(): string | null;
+declare function parseOsvOutput(stdout: string, maxResults: number): ParsedOsvOutput;
+export declare const osv_scan: ToolDefinition;
+export declare const _internals: {
+    resolveExecutableFromPath: typeof resolveExecutableFromPath;
+    resolveOsvScannerBinary: typeof resolveOsvScannerBinary;
+    runExternalTool: typeof runExternalTool;
+    parseOsvOutput: typeof parseOsvOutput;
+};
+export {};

package/dist/tools/search.d.ts

@@ -1,4 +1,5 @@
 import type { ToolDefinition } from '@opencode-ai/plugin/tool';
+import { resolveExecutableFromPath, runExternalTool } from '../utils/external-tool-runner';
 export interface SearchMatch {
     file: string;
     lineNumber: number;
@@ -12,6 +13,9 @@ export interface SearchResult {
     query: string;
     mode: 'literal' | 'regex';
     maxResults: number;
+    engine: 'ripgrep' | 'fallback';
+    outputTruncated?: boolean;
+    warning?: string;
 }
 export interface SearchError {
     error: true;
@@ -26,4 +30,27 @@ export interface SearchArgs {
     max_results?: number;
     max_lines?: number;
 }
+declare function resolvePackagedRipgrep(): string | null;
+declare function resolveRipgrepBinary(): string | null;
+interface FallbackSearchOptions {
+    query: string;
+    mode: 'literal' | 'regex';
+    include?: string;
+    exclude?: string;
+    maxResults: number;
+    maxLines: number;
+    workspace: string;
+}
+/**
+ * Execute search using Node.js fallback (when ripgrep not available).
+ */
+declare function fallbackSearch(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;
+};
+export {};

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

@@ -239,6 +239,22 @@ export declare const TOOL_METADATA: {
         description: string;
         agents: ("reviewer" | "test_engineer" | "coder" | "docs" | "designer" | "explorer" | "sme" | "critic_hallucination_verifier" | "critic_oversight" | "architect" | "researcher" | "docs_design" | "skill_improver" | "spec_writer")[];
     };
+    ast_grep: {
+        description: string;
+        agents: ("test_engineer" | "coder" | "docs" | "explorer" | "sme" | "critic_hallucination_verifier" | "architect" | "researcher" | "docs_design" | "spec_writer")[];
+    };
+    actionlint_scan: {
+        description: string;
+        agents: ("test_engineer" | "architect")[];
+    };
+    osv_scan: {
+        description: string;
+        agents: ("test_engineer" | "architect")[];
+    };
+    gh_evidence: {
+        description: string;
+        agents: ("architect" | "researcher")[];
+    };
     batch_symbols: {
         description: string;
         agents: ("reviewer" | "explorer" | "critic_hallucination_verifier" | "critic_oversight" | "architect")[];

package/dist/utils/external-tool-runner.d.ts

@@ -0,0 +1,25 @@
+import { bunSpawn } from './bun-compat';
+export interface ExternalToolRunOptions {
+    executable: string;
+    args: string[];
+    cwd: string;
+    timeoutMs: number;
+    maxStdoutBytes: number;
+    maxStderrBytes: number;
+    env?: Record<string, string | undefined>;
+}
+export interface ExternalToolRunResult {
+    status: 'completed' | 'timeout' | 'spawn-error';
+    exitCode: number | null;
+    stdout: string;
+    stderr: string;
+    stdoutTruncated: boolean;
+    stderrTruncated: boolean;
+    message?: string;
+}
+export declare function resolveExecutableFromPath(names: string[], envPath?: string, platform?: NodeJS.Platform): string | null;
+export declare function runExternalTool(options: ExternalToolRunOptions): Promise<ExternalToolRunResult>;
+export declare const _internals: {
+    bunSpawn: typeof bunSpawn;
+    platform: () => NodeJS.Platform;
+};

package/package.json

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