opencode-orchestrator 1.5.1 → 1.6.0

package/dist/core/config/options-schema.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Schema-driven plugin options (Builder learning, Phase G).
+ *
+ * Builder derives one JSON Schema from its config types so the TOML, the schema
+ * file, and the editor UI never drift (`builder.schema.json` via schemars).
+ * Orchestrator models its plugin-tuple options as Zod here, which is both the
+ * runtime validator and the source for the exported JSON Schema.
+ *
+ * Parsing stays tolerant — invalid or missing fields fall back to defaults —
+ * to preserve the previous hand-rolled behavior exactly.
+ */
+import { z } from "zod";
+export declare const MissionLoopOptionsSchema: z.ZodCatch<z.ZodObject<{
+    ledger: z.ZodDefault<z.ZodCatch<z.ZodBoolean>>;
+    markdownMemory: z.ZodDefault<z.ZodCatch<z.ZodBoolean>>;
+    maxEvidenceEvents: z.ZodDefault<z.ZodCatch<z.ZodNumber>>;
+}, z.core.$strip>>;
+/** Full plugin-tuple options object — used to generate the public JSON Schema. */
+export declare const OrchestratorOptionsSchema: z.ZodObject<{
+    agentConcurrency: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    providerConcurrency: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    modelConcurrency: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    defaultConcurrency: z.ZodOptional<z.ZodNumber>;
+    missionLoop: z.ZodOptional<z.ZodCatch<z.ZodObject<{
+        ledger: z.ZodDefault<z.ZodCatch<z.ZodBoolean>>;
+        markdownMemory: z.ZodDefault<z.ZodCatch<z.ZodBoolean>>;
+        maxEvidenceEvents: z.ZodDefault<z.ZodCatch<z.ZodNumber>>;
+    }, z.core.$strip>>>;
+}, z.core.$loose>;
+/** Tolerant parse of the `missionLoop` option block. */
+export declare function parseMissionLoopOptions(value: unknown): {
+    ledger: boolean;
+    markdownMemory: boolean;
+    maxEvidenceEvents: number;
+};
+/** JSON Schema for editor autocomplete / external validation. */
+export declare function orchestratorOptionsJsonSchema(): unknown;

package/dist/core/knowledge/context-provider.d.ts

@@ -1,5 +1,5 @@
 export declare class KnowledgeContextProvider {
-    buildPrompt(directory: string, query: string): string | null;
+    buildPrompt(directory: string, query: string, role?: string): string | null;
     private collectMarkdownFiles;
     private walkDirectory;
     private indexKnowledge;

package/dist/core/knowledge/hybrid-search.d.ts

@@ -4,6 +4,7 @@
  */
 import type { TagIndexer } from "./tag-indexer.js";
 import type { GraphParser } from "./graph-parser.js";
+import { type EngineWeights } from "./retrieval-weights.js";
 /** Unified search result with provenance tracking. */
 export interface SearchResult {
     noteName: string;
@@ -24,7 +25,7 @@ export declare class HybridSearch {
     /**
      * Fuse lexical, tag, and graph rankings via RRF to produce a single list.
      */
-    search(query: string, maxResults?: number): SearchResult[];
+    search(query: string, maxResults?: number, weights?: EngineWeights): SearchResult[];
     /**
      * BM25-inspired term-frequency scoring across all indexed documents.
      * Approximates IDF via corpus size and document frequency.

package/dist/core/knowledge/mission-memory.d.ts

@@ -1,4 +1,4 @@
-import type { MissionLoopState } from "../../shared/loop/interfaces/mission-loop.js";
+import type { MissionLoopState } from "../../shared/loop/types.js";
 export declare function syncMissionMemory(directory: string, state: MissionLoopState): boolean;
 export declare function getMissionScratchpadPath(directory: string): string;
 export declare function getMissionCanvasPath(directory: string): string;

package/dist/core/knowledge/retrieval-weights.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Role-aware retrieval weights and memory horizons.
+ *
+ * Builder learning (adoption assessment 2026-06-19, item E):
+ * - Context horizons classify a memory by how long it stays relevant
+ *   (`builder` MEMORY-SYSTEM deep dive: strategic / execution / closure).
+ * - The contextual reranker biases retrieval engines differently per role
+ *   (`unified_retrieval.rs`): planners favor structure, workers favor exact
+ *   lexical hits, reviewers favor breadth.
+ *
+ * Defaults are neutral (all weights = 1), so omitting a role leaves retrieval
+ * behavior unchanged.
+ */
+/** Relative multipliers applied to each hybrid-search engine's RRF contribution. */
+export interface EngineWeights {
+    lexical: number;
+    tag: number;
+    graph: number;
+}
+export declare const NEUTRAL_WEIGHTS: EngineWeights;
+/**
+ * Per-role engine bias. Roles are matched case-insensitively; unknown roles
+ * fall back to neutral weights.
+ */
+export declare const ROLE_WEIGHTS: Record<string, EngineWeights>;
+export declare function weightsForRole(role?: string | null): EngineWeights;
+/** Memory relevance horizon, derived from the memory level. */
+export type MemoryHorizon = "strategic" | "execution" | "closure";
+export declare function horizonForLevel(level: string): MemoryHorizon;

package/dist/core/loop/evidence.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Mission evidence store (Builder learning, adoption assessment item C).
+ *
+ * Builder treats a model's "done" as a candidate until the runtime has recorded
+ * enough evidence to close the task (`builder_app/src/plumbing_trace.rs`:
+ * changed files must be traced/verified). Orchestrator is a plugin and cannot
+ * own the per-turn loop, but it DOES own the mission-loop continuation decision.
+ *
+ * This module records, by observing `tool.execute.after`, which files a session
+ * changed and whether a verification command (test/build/lint) ran afterward. A
+ * "wiring gap" exists when files were changed with no later verification. The
+ * gap is surfaced as an emphatic continuation nudge — never a hard block — so it
+ * can never cause a false "not done" loop.
+ */
+export declare function recordChangedFile(sessionID: string, filePath: string, now?: number): void;
+export declare function recordVerification(sessionID: string, now?: number): void;
+/** Record evidence from a single observed tool call. */
+export declare function recordToolEvidence(sessionID: string, tool: string, args: Record<string, unknown> | undefined, now?: number): void;
+/** Number of changed files with no verification recorded after the last change. */
+export declare function getUnverifiedChangeCount(sessionID: string): number;
+export declare function getChangedFiles(sessionID: string): string[];
+export declare function clearEvidence(sessionID: string): void;

package/dist/core/loop/mission-loop.d.ts

@@ -5,10 +5,12 @@
  * This system moves away from explicit signaling (seals) and relies
  * strictly on file-based state verification.
  */
-import type { MissionLoopState, MissionLoopOptions } from "../../shared/loop/interfaces/mission-loop.js";
+import type { MissionLoopState, MissionLoopOptions } from "../../shared/loop/types.js";
 type MissionContinuationContext = {
     verificationSummary?: string;
     continuationReason?: string;
+    /** Files changed this mission with no verification recorded afterward. */
+    unverifiedChanges?: number;
 };
 type MissionContinuationInput = string | MissionContinuationContext;
 /**

package/dist/core/orchestrator/types/task-status.d.ts

@@ -2,4 +2,4 @@
  * Task Status - Re-export from central location
  */
 export { TASK_STATUS } from "../../../shared/index.js";
-export type { ParallelTaskStatus as TaskStatus } from "../../../shared/task/types/index.js";
+export type { ParallelTaskStatus as TaskStatus } from "../../../shared/task/types.js";

package/dist/core/pool/task-pool.d.ts

@@ -5,7 +5,7 @@
  * Pool size: 200 instances (typical max concurrent tasks)
  */
 import { ObjectPool } from "./object-pool.js";
-import type { ParallelTask } from "../../shared/task/interfaces/parallel-task.js";
+import type { ParallelTask } from "../../shared/task/types.js";
 /**
  * Global ParallelTask pool
  * Pool size: 200 (typical max concurrent tasks)

package/dist/core/task/interfaces/task-node.d.ts

@@ -1,7 +1,7 @@
 /**
  * Task Node Interface
  */
-import type { ParallelTaskStatus } from "../../../shared/task/types/index.js";
+import type { ParallelTaskStatus } from "../../../shared/task/types.js";
 export type TaskStatus = ParallelTaskStatus;
 export interface TaskNode {
     id: string;