opencode-orchestrator 1.5.1 → 1.6.0

package/dist/utils/parsing/safe-json.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Tolerant JSON parsing for model- and network-authored payloads.
+ *
+ * Builder learning (adoption assessment 2026-06-19, item F): LLM/provider output
+ * and fetched bodies are frequently wrapped in markdown fences, padded with
+ * prose, or left with trailing commas. Instead of hard-failing, attempt a small
+ * sequence of repairs and fall back gracefully.
+ *
+ * This is intentionally NOT used for our own machine-written state files
+ * (mission-loop.json, ledger, cache) where a strict parse should surface
+ * corruption rather than mask it.
+ */
+/**
+ * Parse JSON, repairing common LLM/network defects. Returns `fallback`
+ * (default `null`) if every attempt fails.
+ */
+export declare function safeJsonParse<T = unknown>(input: unknown, fallback?: T | null): T | null;

package/opencode-orchestrator.schema.json

@@ -0,0 +1,75 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "agentConcurrency": {
+      "type": "object",
+      "propertyNames": {
+        "type": "string"
+      },
+      "additionalProperties": {
+        "type": "integer",
+        "exclusiveMinimum": 0,
+        "maximum": 9007199254740991
+      }
+    },
+    "providerConcurrency": {
+      "type": "object",
+      "propertyNames": {
+        "type": "string"
+      },
+      "additionalProperties": {
+        "type": "integer",
+        "exclusiveMinimum": 0,
+        "maximum": 9007199254740991
+      }
+    },
+    "modelConcurrency": {
+      "type": "object",
+      "propertyNames": {
+        "type": "string"
+      },
+      "additionalProperties": {
+        "type": "integer",
+        "exclusiveMinimum": 0,
+        "maximum": 9007199254740991
+      }
+    },
+    "defaultConcurrency": {
+      "type": "integer",
+      "exclusiveMinimum": 0,
+      "maximum": 9007199254740991
+    },
+    "missionLoop": {
+      "default": {
+        "ledger": true,
+        "markdownMemory": true,
+        "maxEvidenceEvents": 20
+      },
+      "type": "object",
+      "properties": {
+        "ledger": {
+          "default": true,
+          "type": "boolean"
+        },
+        "markdownMemory": {
+          "default": true,
+          "type": "boolean"
+        },
+        "maxEvidenceEvents": {
+          "default": 20,
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991
+        }
+      },
+      "required": [
+        "ledger",
+        "markdownMemory",
+        "maxEvidenceEvents"
+      ],
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": {}
+}

package/package.json

@@ -2,7 +2,7 @@
   "name": "opencode-orchestrator",
   "displayName": "OpenCode Orchestrator",
   "description": "Multi-agent mission control for OpenCode with Commander, Planner, Worker, and Reviewer workflows.",
-  "version": "1.5.1",
+  "version": "1.6.0",
   "author": "agnusdei1207",
   "license": "MIT",
   "repository": {
@@ -37,7 +37,8 @@
     "scripts/run-install-hook.mjs",
     "bin",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "opencode-orchestrator.schema.json"
   ],
   "scripts": {
     "docker:build-all": "docker compose run --rm dev && docker compose run --rm rust-arm64 && docker compose run --rm win-builder",
@@ -46,6 +47,7 @@
     "docker:test": "docker compose run --rm test",
     "docker:clean": "docker compose down -v",
     "build": "node scripts/build.mjs",
+    "gen:schema": "esbuild scripts/gen-schema.ts --bundle --platform=node --format=esm --outfile=node_modules/.cache/gen-schema.mjs && node node_modules/.cache/gen-schema.mjs",
     "build:all": "npm run build && npm run docker:rust-dist",
     "test": "vitest run --reporter=verbose",
     "test:coverage": "vitest run --coverage",

package/scripts/run-install-hook.mjs

@@ -1,66 +1,66 @@
-#!/usr/bin/env node
-
-import { existsSync } from "node:fs";
-import { spawnSync } from "node:child_process";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-const VALID_HOOKS = new Set(["postinstall", "preuninstall"]);
-
-function resolveRepoRoot() {
-  const scriptPath = fileURLToPath(import.meta.url);
-  return path.resolve(path.dirname(scriptPath), "..");
-}
-
-function resolveHookCommand(repoRoot, hookName) {
-  const distEntry = path.join(repoRoot, "dist", "scripts", `${hookName}.js`);
-  if (existsSync(distEntry)) {
-    return {
-      command: process.execPath,
-      args: [distEntry],
-    };
-  }
-
-  const sourceEntry = path.join(repoRoot, "scripts", `${hookName}.ts`);
-  if (existsSync(sourceEntry)) {
-    return {
-      command: process.execPath,
-      args: ["--experimental-strip-types", sourceEntry],
-    };
-  }
-
-  return null;
-}
-
-function main() {
-  const hookName = process.argv[2];
-  if (!VALID_HOOKS.has(hookName)) {
-    console.error(`Unknown install hook: ${hookName ?? "(missing)"}`);
-    process.exit(1);
-  }
-
-  const repoRoot = resolveRepoRoot();
-  const hookCommand = resolveHookCommand(repoRoot, hookName);
-
-  if (!hookCommand) {
-    console.log(`⚠️  ${hookName} entrypoint not found. Skipping gracefully.`);
-    process.exit(0);
-  }
-
-  const result = spawnSync(hookCommand.command, hookCommand.args, {
-    cwd: repoRoot,
-    stdio: "inherit",
-    env: process.env,
-  });
-
-  if (typeof result.status === "number") {
-    process.exit(result.status);
-  }
-
-  if (result.error) {
-    console.error(`Failed to run ${hookName}: ${result.error.message}`);
-  }
-  process.exit(1);
-}
-
-main();
+#!/usr/bin/env node
+
+import { existsSync } from "node:fs";
+import { spawnSync } from "node:child_process";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const VALID_HOOKS = new Set(["postinstall", "preuninstall"]);
+
+function resolveRepoRoot() {
+  const scriptPath = fileURLToPath(import.meta.url);
+  return path.resolve(path.dirname(scriptPath), "..");
+}
+
+function resolveHookCommand(repoRoot, hookName) {
+  const distEntry = path.join(repoRoot, "dist", "scripts", `${hookName}.js`);
+  if (existsSync(distEntry)) {
+    return {
+      command: process.execPath,
+      args: [distEntry],
+    };
+  }
+
+  const sourceEntry = path.join(repoRoot, "scripts", `${hookName}.ts`);
+  if (existsSync(sourceEntry)) {
+    return {
+      command: process.execPath,
+      args: ["--experimental-strip-types", sourceEntry],
+    };
+  }
+
+  return null;
+}
+
+function main() {
+  const hookName = process.argv[2];
+  if (!VALID_HOOKS.has(hookName)) {
+    console.error(`Unknown install hook: ${hookName ?? "(missing)"}`);
+    process.exit(1);
+  }
+
+  const repoRoot = resolveRepoRoot();
+  const hookCommand = resolveHookCommand(repoRoot, hookName);
+
+  if (!hookCommand) {
+    console.log(`⚠️  ${hookName} entrypoint not found. Skipping gracefully.`);
+    process.exit(0);
+  }
+
+  const result = spawnSync(hookCommand.command, hookCommand.args, {
+    cwd: repoRoot,
+    stdio: "inherit",
+    env: process.env,
+  });
+
+  if (typeof result.status === "number") {
+    process.exit(result.status);
+  }
+
+  if (result.error) {
+    console.error(`Failed to run ${hookName}: ${result.error.message}`);
+  }
+  process.exit(1);
+}
+
+main();

package/dist/shared/agent/constants/index.d.ts

@@ -1,4 +0,0 @@
-/**
- * Agent constants
- */
-export { AGENT_NAMES } from "./names.js";

package/dist/shared/agent/interfaces/agent-definition.d.ts

@@ -1,10 +0,0 @@
-/**
- * Agent definition for orchestrator
- */
-export interface AgentDefinition {
-    id: string;
-    description: string;
-    systemPrompt: string;
-    canWrite: boolean;
-    canBash: boolean;
-}

package/dist/shared/agent/interfaces/concurrency-config.d.ts

@@ -1,9 +0,0 @@
-/**
- * Concurrency limits configuration
- */
-export interface ConcurrencyConfig {
-    defaultConcurrency?: number;
-    agentConcurrency?: Record<string, number>;
-    providerConcurrency?: Record<string, number>;
-    modelConcurrency?: Record<string, number>;
-}

package/dist/shared/agent/interfaces/index.d.ts

@@ -1,5 +0,0 @@
-/**
- * Agent interfaces
- */
-export type { AgentDefinition } from "./agent-definition.js";
-export type { ConcurrencyConfig } from "./concurrency-config.js";

package/dist/shared/agent/types/agent-name.d.ts

@@ -1,5 +0,0 @@
-/**
- * Agent name type (derived from AGENT_NAMES)
- */
-import { AGENT_NAMES } from "../constants/names.js";
-export type AgentName = (typeof AGENT_NAMES)[keyof typeof AGENT_NAMES];

package/dist/shared/agent/types/index.d.ts

@@ -1,4 +0,0 @@
-/**
- * Agent types
- */
-export type { AgentName } from "./agent-name.js";

package/dist/shared/cache/constants/cache-actions.d.ts

@@ -1,10 +0,0 @@
-/**
- * Cache Actions
- */
-export declare const CACHE_ACTIONS: {
-    readonly LIST: "list";
-    readonly GET: "get";
-    readonly CLEAR: "clear";
-    readonly STATS: "stats";
-};
-export type CacheAction = (typeof CACHE_ACTIONS)[keyof typeof CACHE_ACTIONS];

package/dist/shared/cache/constants/cache.d.ts

@@ -1,11 +0,0 @@
-/**
- * Cache Configuration Constants
- */
-export declare const CACHE: {
-    /** Default cache TTL (24 hours) */
-    readonly DEFAULT_TTL_MS: number;
-    /** Maximum cache entries */
-    readonly MAX_ENTRIES: 100;
-    /** Session TTL (24 hours for long tasks) */
-    readonly SESSION_TTL_MS: number;
-};

package/dist/shared/cache/constants/filter-status.d.ts

@@ -1,12 +0,0 @@
-/**
- * Filter Status (for list operations)
- */
-export declare const FILTER_STATUS: {
-    readonly ALL: "all";
-    readonly RUNNING: "running";
-    readonly DONE: "done";
-    readonly COMPLETED: "completed";
-    readonly ERROR: "error";
-    readonly PENDING: "pending";
-};
-export type FilterStatus = (typeof FILTER_STATUS)[keyof typeof FILTER_STATUS];

package/dist/shared/cache/constants/index.d.ts

@@ -1,8 +0,0 @@
-/**
- * Cache constants
- */
-export { CACHE } from "./cache.js";
-export { CACHE_ACTIONS } from "./cache-actions.js";
-export type { CacheAction } from "./cache-actions.js";
-export { FILTER_STATUS } from "./filter-status.js";
-export type { FilterStatus } from "./filter-status.js";

package/dist/shared/command/interfaces/index.d.ts

@@ -1,5 +0,0 @@
-/**
- * Command interfaces
- */
-export type { BackgroundTask } from "./background-task.js";
-export type { RunBackgroundOptions } from "./run-background-options.js";

package/dist/shared/command/interfaces/run-background-options.d.ts

@@ -1,9 +0,0 @@
-/**
- * Options for running background command
- */
-export interface RunBackgroundOptions {
-    command: string;
-    cwd?: string;
-    timeout?: number;
-    label?: string;
-}

package/dist/shared/command/types/background-task-status.d.ts

@@ -1,4 +0,0 @@
-/**
- * Background task status values
- */
-export type BackgroundTaskStatus = "pending" | "running" | "done" | "error" | "timeout";

package/dist/shared/command/types/index.d.ts

@@ -1,4 +0,0 @@
-/**
- * Command types
- */
-export type { BackgroundTaskStatus } from "./background-task-status.js";

package/dist/shared/core/constants/cli.d.ts

@@ -1,26 +0,0 @@
-/**
- * CLI Tool Names
- */
-export declare const CLI_NAME: {
-    readonly NPX: "npx";
-    readonly TSC: "tsc";
-    readonly ESLINT: "eslint";
-    readonly RG: "rg";
-    readonly SED: "sed";
-    readonly AST_GREP: "ast-grep";
-    readonly GIT: "git";
-    readonly JQ: "jq";
-    readonly NODE: "node";
-    readonly SH: "sh";
-};
-/**
- * Node Process Events
- */
-export declare const PROC_EVENT: {
-    readonly CLOSE: "close";
-    readonly ERROR: "error";
-    readonly EXIT: "exit";
-    readonly DATA: "data";
-    readonly MESSAGE: "message";
-    readonly DISCONNECT: "disconnect";
-};

package/dist/shared/core/constants/id-prefix.d.ts

@@ -1,14 +0,0 @@
-/**
- * ID Prefixes
- *
- * Format: PREFIX + number (e.g., ses_1, SYNC-42, UT-100)
- * No fixed digit limit - use any positive integer.
- */
-export declare const ID_PREFIX: {
-    readonly TASK: "task_";
-    readonly JOB: "job_";
-    readonly SESSION: "ses_";
-    readonly SYNC_ISSUE: "SYNC-";
-    readonly UNIT_TEST: "UT-";
-    readonly WORKER: "wrk_";
-};

package/dist/shared/core/constants/index.d.ts

@@ -1,15 +0,0 @@
-/**
- * Core constants
- */
-export { TIME } from "./time.js";
-export { ID_PREFIX } from "./id-prefix.js";
-export { PATHS } from "./paths.js";
-export { MEMORY_LIMITS } from "./memory-limits.js";
-export { STATUS_LABEL, type TaskStatus } from "./status-labels.js";
-export { LIMITS } from "./limits.js";
-export { WAL_ACTIONS } from "./wal-actions.js";
-export { PHASES } from "./phases.js";
-export { MEMORY_CONSTANTS, HOOK_NAMES, TODO_CONSTANTS, TUI_CONSTANTS } from "./memory-hooks.js";
-export { SHUTDOWN_HANDLERS } from "./lifecycle.js";
-export { LOG_PREFIX } from "./logging.js";
-export * from "./cli.js";

package/dist/shared/core/constants/lifecycle.d.ts

@@ -1,22 +0,0 @@
-/**
- * Lifecycle & Shutdown Handler Constants
- *
- * Centralized constant definitions for all shutdown handler names used
- * throughout the application to ensure consistency and maintainability.
- */
-export declare const SHUTDOWN_HANDLERS: {
-    /** TodoSyncService - Syncs TODO state via file watching */
-    readonly TODO_SYNC_SERVICE: "TodoSyncService";
-    /** CleanupScheduler - Manages periodic cleanup tasks */
-    readonly CLEANUP_SCHEDULER: "CleanupScheduler";
-    /** RustToolPool - Manages Rust tool instances */
-    readonly RUST_TOOL_POOL: "RustToolPool";
-    /** BackgroundTaskManager - Manages background command execution */
-    readonly BACKGROUND_TASK_MANAGER: "BackgroundTaskManager";
-    /** ParallelAgentManager - Manages parallel agent task execution */
-    readonly PARALLEL_AGENT_MANAGER: "ParallelAgentManager";
-    /** PluginManager - Manages dynamic plugin lifecycle */
-    readonly PLUGIN_MANAGER: "PluginManager";
-};
-/** Type for shutdown handler names */
-export type ShutdownHandlerName = typeof SHUTDOWN_HANDLERS[keyof typeof SHUTDOWN_HANDLERS];

package/dist/shared/core/constants/limits.d.ts

@@ -1,19 +0,0 @@
-/**
- * System Limits
- */
-export declare const LIMITS: {
-    /** Maximum mission loop iterations */
-    readonly MAX_ITERATIONS: 1000000000;
-    /** Default scan limit for file listing */
-    readonly DEFAULT_SCAN_LIMIT: 20;
-    /** Max message history to check for conclusion */
-    readonly CONCLUDE_CHECK_HISTORY: 3;
-    /** Max concurrent tasks per agent */
-    readonly MAX_TASKS_PER_AGENT: 10;
-    /** Default history/list limit for UI */
-    readonly DEFAULT_LIST_LIMIT: 20;
-    /** Default progress bar width */
-    readonly DEFAULT_PROGRESS_WIDTH: 20;
-    /** Maximum time for atomic task (minutes) */
-    readonly TASK_TIME_LIMIT_MIN: 10;
-};

package/dist/shared/core/constants/logging.d.ts

@@ -1,39 +0,0 @@
-/**
- * Logging Constants
- *
- * Centralized log prefixes used throughout the application to ensure
- * consistent formatting and easier log filtering.
- */
-export declare const LOG_PREFIX: {
-    /** Rust Tool pool operations */
-    readonly RUST_TOOL: "RustTool";
-    readonly RUST_POOL: "RustPool";
-    /** LSP diagnostics caching */
-    readonly DIAGNOSTICS_CACHE: "DiagnosticsCache";
-    /** Context window monitoring */
-    readonly CONTEXT_WINDOW_MONITOR: "context-window-monitor";
-    /** Memory management */
-    readonly MEMORY_MANAGER: "MemoryManager";
-    /** Plugin system */
-    readonly PLUGIN_MANAGER: "PluginManager";
-    /** OS notifications */
-    readonly SESSION_NOTIFY: "session-notify";
-    /** Session recovery */
-    readonly SESSION_RECOVERY: "session-recovery";
-    /** Lifecycle management */
-    readonly SHUTDOWN_MANAGER: "ShutdownManager";
-    /** Agent registry */
-    readonly AGENT_REGISTRY: "AgentRegistry";
-    /** Task synchronization */
-    readonly TODO_SYNC: "TodoSync";
-    /** Cleanup scheduler */
-    readonly CLEANUP_SCHEDULER: "CleanupScheduler";
-    /** Background task management */
-    readonly BACKGROUND_TASK_MANAGER: "BackgroundTaskManager";
-    /** Parallel agent management */
-    readonly PARALLEL_AGENT_MANAGER: "ParallelAgentManager";
-    /** File watching */
-    readonly FILE_WATCHER: "FileWatcher";
-};
-/** Type for log prefixes */
-export type LogPrefix = typeof LOG_PREFIX[keyof typeof LOG_PREFIX];