opencode-orchestrator 1.5.1 → 1.6.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 agnusdei1207
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 agnusdei1207
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -6,7 +6,7 @@
   [![MIT License](https://img.shields.io/badge/license-MIT-red.svg)](LICENSE)
   [![npm](https://img.shields.io/npm/v/opencode-orchestrator.svg)](https://www.npmjs.com/package/opencode-orchestrator)
   <!-- VERSION:START -->
-  **Version:** `1.5.1`
+  **Version:** `1.6.0`
   <!-- VERSION:END -->
 </div>
 
@@ -84,6 +84,8 @@ Model selection follows normal OpenCode inheritance. The plugin does not force a
 
 Legacy top-level concurrency keys (`agentConcurrency`, `providerConcurrency`, `modelConcurrency`, `defaultConcurrency`) are still accepted for backward compatibility, but the plugin tuple is the preferred location.
 
+Plugin options are schema-described in `opencode-orchestrator.schema.json` (generated from the Zod source, shipped in the package) for editor autocomplete and validation. Invalid or missing option fields fall back to defaults rather than failing.
+
 ## 3. Run
 
 Inside OpenCode:
@@ -152,6 +154,14 @@ flowchart LR
 | Worker | Implements scoped file changes with isolated context. |
 | Reviewer | Checks completion evidence, tests, and integration risk. |
 
+The mission loop adjudicates continuation at the idle boundary rather than trusting a model's "done":
+
+1. Tool calls are observed to record changed files and verification runs; if files changed with no verification, the continuation prompt emphatically asks the model to run tests/build/lint and cite results (a nudge, never a hard block).
+2. Before declaring done the model is asked for a short self-account (scope fit, verification, residual risk).
+3. After sustained stagnation the loop stops blind retries and escalates: DECOMPOSE → RE-PLAN → ASK the user.
+
+Memory retrieval is role-aware (planners favor structure, workers favor exact matches, reviewers favor breadth) and memory notes carry a relevance `horizon`.
+
 Runtime evidence is written only when enabled:
 
 | Artifact | Purpose |
@@ -163,13 +173,22 @@ Runtime evidence is written only when enabled:
 
 ## 5. Developer Notes
 
+Local checks that mirror CI (`.github/workflows/ci.yml`), which gates every push and PR:
+
 ```bash
+# TypeScript
 npm run build
 npx tsc --noEmit
 npm test
-cargo test --workspace --all-targets
+
+# Rust (same gates CI enforces)
+cargo fmt --all --check
+cargo clippy --workspace --all-targets -- -D warnings
+cargo test --workspace
 ```
 
+Regenerate the plugin-options JSON Schema after changing option types: `npm run gen:schema`.
+
 Useful references:
 
 1. OpenCode plugins: https://opencode.ai/docs/plugins/

package/dist/agents/commander.d.ts

@@ -5,5 +5,5 @@
  * Reads shared state (.opencode/) for loop continuation.
  * Handles sync issues by instructing Planner and Workers.
  */
-import type { AgentDefinition } from "../shared/agent/interfaces/index.js";
+import type { AgentDefinition } from "../shared/agent/index.js";
 export declare const commander: AgentDefinition;

package/dist/agents/definitions.d.ts

@@ -7,5 +7,5 @@
  * - Worker: Implementation + Documentation
  * - Reviewer: Verification + Context Management (Final Quality Gate)
  */
-import type { AgentDefinition } from "../shared/agent/interfaces/index.js";
+import type { AgentDefinition } from "../shared/agent/index.js";
 export declare const AGENTS: Record<string, AgentDefinition>;

package/dist/agents/prompts/registry.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Prompt Registry
+ *
+ * Central composition seam for agent system prompts (Builder-inspired:
+ * `builder_app/src/system_prompt.rs` + `template_engine.rs`).
+ *
+ * Goals:
+ * 1. One place that joins prompt sections into a final system prompt.
+ * 2. Lightweight `{{var}}` interpolation for runtime context injection.
+ * 3. Model-tier "profiles" — a `compact` profile drops sections tagged
+ *    `verbose: true`, so weaker/smaller models can be given a leaner prompt
+ *    without duplicating prompt text. The default `standard` profile keeps
+ *    every section, so existing composed output is unchanged.
+ */
+export type PromptProfile = "standard" | "compact";
+/** A prompt fragment. Plain strings are always kept; tagged sections can be
+ *  dropped by profile. */
+export interface PromptSection {
+    body: string;
+    /** Dropped under the `compact` profile. */
+    verbose?: boolean;
+}
+export type PromptFragment = string | PromptSection;
+/**
+ * Replace `{{key}}` placeholders. Unknown keys are left intact, so calling with
+ * no vars is an identity transform on text that has no placeholders.
+ */
+export declare function interpolate(template: string, vars?: Record<string, string | number>): string;
+export interface ComposeOptions {
+    profile?: PromptProfile;
+    vars?: Record<string, string | number>;
+    separator?: string;
+}
+/**
+ * Compose a final prompt from ordered fragments. With the default `standard`
+ * profile, no vars, and the default separator this is exactly
+ * `fragments.join("\n\n")` — preserving existing prompt output byte-for-byte.
+ */
+export declare function composePrompt(fragments: PromptFragment[], options?: ComposeOptions): string;

package/dist/agents/subagents/planner.d.ts

@@ -5,5 +5,5 @@
  * FILE-LEVEL planning - lists all files to create/modify/delete.
  * TODO sync - updates TODO based on Commander instructions.
  */
-import type { AgentDefinition } from "../../shared/agent/interfaces/index.js";
+import type { AgentDefinition } from "../../shared/agent/index.js";
 export declare const planner: AgentDefinition;

package/dist/agents/subagents/reviewer.d.ts

@@ -5,5 +5,5 @@
  * ONLY agent authorized to mark [x] in TODO after verification.
  * Async monitoring of parallel workers, integration testing, sync verification.
  */
-import type { AgentDefinition } from "../../shared/agent/interfaces/index.js";
+import type { AgentDefinition } from "../../shared/agent/index.js";
 export declare const reviewer: AgentDefinition;

package/dist/agents/subagents/worker.d.ts

@@ -5,5 +5,5 @@
  * Reads .opencode for assignments and shared state.
  * Follows Commander instructions for sync fixes.
  */
-import type { AgentDefinition } from "../../shared/agent/interfaces/index.js";
+import type { AgentDefinition } from "../../shared/agent/index.js";
 export declare const worker: AgentDefinition;

package/dist/core/agents/agent-registry.d.ts

@@ -1,7 +1,7 @@
 /**
  * Agent Registry - Manages built-in and custom agent definitions
  */
-import type { AgentDefinition } from "../../shared/agent/interfaces/index.js";
+import type { AgentDefinition } from "../../shared/agent/index.js";
 export declare class AgentRegistry {
     private static instance;
     private agents;

package/dist/core/agents/concurrency.d.ts

@@ -7,9 +7,9 @@
  * - Resource-aware scheduling
  * - Adaptive auto-scaling
  */
-import type { ConcurrencyConfig } from "../../shared/agent/interfaces/concurrency-config.js";
+import type { ConcurrencyConfig } from "../../shared/agent/index.js";
 import { ConcurrencyToken } from "./concurrency-token.js";
-export type { ConcurrencyConfig } from "../../shared/agent/interfaces/concurrency-config.js";
+export type { ConcurrencyConfig } from "../../shared/agent/index.js";
 export declare enum TaskPriority {
     HIGH = 0,
     NORMAL = 1,

package/dist/core/agents/consts/task-status.const.d.ts

@@ -1,2 +1,2 @@
-export { TASK_STATUS } from "../../../shared/loop/constants/task-status.js";
-export { TODO_STATUS } from "../../../shared/loop/constants/todo-status.js";
+export { TASK_STATUS } from "../../../shared/loop/constants.js";
+export { TODO_STATUS } from "../../../shared/loop/constants.js";

package/dist/core/agents/interfaces/index.d.ts

@@ -2,8 +2,8 @@
  * Agents Interfaces Index
  * Re-exports from shared to maintain compatibility
  */
-export type { ParallelTask } from "../../../shared/task/interfaces/parallel-task.js";
-export type { TaskProgress } from "../../../shared/task/interfaces/task-progress.js";
-export type { ConcurrencyConfig } from "../../../shared/agent/interfaces/concurrency-config.js";
+export type { ParallelTask } from "../../../shared/task/types.js";
+export type { TaskProgress } from "../../../shared/task/types.js";
+export type { ConcurrencyConfig } from "../../../shared/agent/index.js";
 export type { LaunchInput } from "./launch-input.interface.js";
 export type { ResumeInput } from "./resume-input.interface.js";