opencode-orchestrator 1.5.1 → 1.6.0

package/dist/shared/recovery/index.d.ts

@@ -1,6 +1,5 @@
 /**
  * Recovery Domain
  */
-export * from "./constants/index.js";
-export * from "./interfaces/index.js";
-export * from "./types/index.js";
+export * from "./constants.js";
+export * from "./types.js";

package/dist/shared/recovery/types.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Recovery types (consolidated)
+ */
+/**
+ * Recovery action type
+ */
+export type RecoveryAction = "retry" | "abort" | "escalate" | "ignore";
+/**
+ * Error context for recovery
+ */
+export interface ErrorContext {
+    sessionId: string;
+    taskId?: string;
+    agent?: string;
+    error: Error;
+    attempt: number;
+    timestamp: Date;
+}
+/**
+ * Recovery history record
+ */
+export interface RecoveryRecord {
+    context: ErrorContext;
+    action: RecoveryAction;
+    timestamp: Date;
+}

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

@@ -0,0 +1,80 @@
+/**
+ * Session constants (consolidated)
+ */
+/**
+ * Task lifecycle events
+ */
+export declare const TASK_EVENTS: {
+    readonly STARTED: "task.started";
+    readonly COMPLETED: "task.completed";
+    readonly FAILED: "task.failed";
+    readonly CANCELLED: "task.cancelled";
+};
+/**
+ * Todo lifecycle events
+ */
+export declare const TODO_EVENTS: {
+    readonly CREATED: "todo.created";
+    readonly UPDATED: "todo.updated";
+    readonly COMPLETED: "todo.completed";
+};
+/**
+ * Session state events
+ */
+export declare const SESSION_EVENTS: {
+    readonly IDLE: "session.idle";
+    readonly STATUS: "session.status";
+    readonly UPDATED: "session.updated";
+    readonly COMPACTED: "session.compacted";
+    readonly BUSY: "session.busy";
+    readonly ERROR: "session.error";
+    readonly DELETED: "session.deleted";
+    readonly CREATED: "session.created";
+};
+/**
+ * Document cache events
+ */
+export declare const DOCUMENT_EVENTS: {
+    readonly CACHED: "document.cached";
+    readonly EXPIRED: "document.expired";
+};
+/**
+ * Mission lifecycle events
+ */
+export declare const MISSION_EVENTS: {
+    readonly COMPLETE: "mission.complete";
+    readonly FAILED: "mission.failed";
+    readonly ALL_TASKS_COMPLETE: "all_tasks.complete";
+};
+/**
+ * Message Event Types
+ */
+export declare const MESSAGE_EVENTS: {
+    readonly UPDATED: "message.updated";
+};
+/**
+ * Special event types
+ */
+export declare const SPECIAL_EVENTS: {
+    readonly WILDCARD: "*";
+};
+export declare const EVENT_TYPES: {
+    readonly WILDCARD: "*";
+    readonly UPDATED: "message.updated";
+    readonly COMPLETE: "mission.complete";
+    readonly FAILED: "mission.failed";
+    readonly ALL_TASKS_COMPLETE: "all_tasks.complete";
+    readonly CACHED: "document.cached";
+    readonly EXPIRED: "document.expired";
+    readonly IDLE: "session.idle";
+    readonly STATUS: "session.status";
+    readonly COMPACTED: "session.compacted";
+    readonly BUSY: "session.busy";
+    readonly ERROR: "session.error";
+    readonly DELETED: "session.deleted";
+    readonly CREATED: "session.created";
+    readonly COMPLETED: "todo.completed";
+    readonly STARTED: "task.started";
+    readonly CANCELLED: "task.cancelled";
+};
+export type EventTypeValue = (typeof EVENT_TYPES)[keyof typeof EVENT_TYPES];

package/dist/shared/session/index.d.ts

@@ -1,4 +1,4 @@
 /**
  * Session Domain
  */
-export * from "./constants/index.js";
+export * from "./constants.js";

package/dist/shared/task/{constants/parallel-task.d.ts → constants.d.ts}

@@ -1,6 +1,33 @@
 /**
- * Parallel Task Configuration
+ * Background Task Status
  */
+export declare const BACKGROUND_STATUS: {
+    readonly RUNNING: "running";
+    readonly DONE: "done";
+    readonly ERROR: "error";
+    readonly TIMEOUT: "timeout";
+};
+export type BackgroundStatus = (typeof BACKGROUND_STATUS)[keyof typeof BACKGROUND_STATUS];
+/**
+ * Background Task Configuration
+ */
+export declare const BACKGROUND_TASK: {
+    readonly DEFAULT_TIMEOUT_MS: number;
+    readonly MAX_OUTPUT_LENGTH: 10000;
+    readonly MAX_CONCURRENT: 5;
+    readonly POLL_INTERVAL_MS: 500;
+    readonly RETRY_COOLDOWN_MS: number;
+};
+/**
+ * Task Metadata Keys
+ */
+export declare const TASK_METADATA: {
+    readonly PARALLEL: "parallel";
+    readonly PARALLEL_GROUP: "parallel_group";
+    readonly DEPENDS: "depends";
+    readonly AGENT: "agent";
+    readonly SIZE: "size";
+};
 export declare const TASK_MODE: {
     readonly NORMAL: "normal";
     readonly RACE: "race";

package/dist/shared/task/index.d.ts

@@ -1,6 +1,5 @@
 /**
  * Task Domain
  */
-export * from "./constants/index.js";
-export * from "./interfaces/index.js";
-export * from "./types/index.js";
+export * from "./constants.js";
+export * from "./types.js";

package/dist/shared/task/types.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Task types and interfaces (consolidated)
+ */
+import type { Poolable } from "../core/index.js";
+/**
+ * Parallel task status values
+ */
+export type ParallelTaskStatus = "pending" | "running" | "completed" | "failed" | "error" | "timeout" | "cancelled";
+/**
+ * Task progress tracking
+ */
+export interface TaskProgress {
+    toolCalls: number;
+    lastTool?: string;
+    lastMessage?: string;
+    lastUpdate: Date;
+}
+/**
+ * Input for launching a parallel task
+ */
+export interface LaunchInput {
+    description: string;
+    prompt: string;
+    agent: string;
+    parentSessionID: string;
+    /** Current nesting depth (default: 1) */
+    depth?: number;
+}
+/**
+ * Input for resuming an existing parallel task session
+ *
+ * Preserves context for:
+ * - Retry after failure
+ * - Follow-up questions
+ * - Token efficiency
+ */
+export interface ResumeInput {
+    /** Session ID to resume */
+    sessionId: string;
+    /** New prompt for resumed session */
+    prompt: string;
+    /** Parent session for notifications */
+    parentSessionID: string;
+}
+/**
+ * Parallel task running in child session
+ * MERGED: Contains both core and shared fields
+ */
+export interface ParallelTask extends Poolable {
+    id: string;
+    sessionID: string;
+    parentSessionID: string;
+    description: string;
+    prompt: string;
+    agent: string;
+    status: ParallelTaskStatus;
+    startedAt: Date;
+    completedAt?: Date;
+    error?: string;
+    result?: string;
+    concurrencyKey?: string;
+    depth: number;
+    mode?: "normal" | "race" | "fractal";
+    groupID?: string;
+    lastMsgCount?: number;
+    stablePolls?: number;
+    progress?: TaskProgress;
+    hasStartedOutputting?: boolean;
+}

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

@@ -0,0 +1,105 @@
+/**
+ * Tool Output Configuration
+ */
+export declare const TOOL_OUTPUT: {
+    /** Maximum length for healthy output capture */
+    readonly MAX_HEALTHY_OUTPUT_LENGTH: 1000;
+    /** Threshold for considering output small enough to capture */
+    readonly SMALL_OUTPUT_THRESHOLD: 5000;
+};
+/**
+ * Common Tool Languages
+ */
+export declare const TOOL_LANG: {
+    readonly TS: "ts";
+    readonly JS: "js";
+    readonly JSON: "json";
+    readonly ALL: "*";
+};
+/**
+ * Formatted Tool Output Labels
+ */
+export declare const OUTPUT_LABEL: {
+    readonly ERROR: "[ERROR]";
+    readonly WARNING: "[WARNING]";
+    readonly INFO: "[INFO]";
+    readonly DONE: "[DONE]";
+    readonly OK: "[OK]";
+    readonly SPAWNED: "[SPAWNED]";
+    readonly RESUME: "[RESUME]";
+    readonly TIMEOUT: "[TIMEOUT]";
+    readonly RUNNING: "[RUNNING]";
+    readonly CANCELLED: "[CANCELLED]";
+    readonly RESUMED_DONE: "[RESUMED & DONE]";
+    readonly SYNC_START: "[SYNC START]";
+    readonly CACHED: "[CACHED]";
+    readonly JSON_FETCHED: "[JSON FETCHED]";
+    readonly TEXT_FETCHED: "[TEXT FETCHED]";
+};
+/**
+ * Common Tool Sources
+ */
+export declare const TOOL_SOURCE: {
+    readonly TYPESCRIPT: "typescript";
+    readonly ESLINT: "eslint";
+    readonly AST_GREP: "ast-grep";
+};
+/**
+ * Common Tool Labels
+ */
+export declare const TOOL_LABEL: {
+    readonly ERROR: "error";
+    readonly WARNING: "warning";
+    readonly INFO: "info";
+    readonly HINT: "hint";
+    readonly SUCCESS: "success";
+    readonly FAILED: "failed";
+    readonly CLEAN: "clean";
+    readonly TIMEOUT: "timeout";
+    readonly DONE: "done";
+    readonly PENDING: "pending";
+    readonly RUNNING: "running";
+};
+/**
+ * LSP Severity Constant
+ */
+export declare const LSP_SEVERITY: {
+    readonly ERROR: 1;
+    readonly WARNING: 2;
+    readonly INFO: 3;
+    readonly HINT: 4;
+};
+/**
+ * LSP Severity Labels Constant
+ */
+export declare const LSP_SEVERITY_LABELS: {
+    readonly 1: "error";
+    readonly 2: "warning";
+    readonly 3: "info";
+    readonly 4: "hint";
+};
+/**
+ * Parallel Tool Logging Constants
+ */
+export declare const PARALLEL_LOG: {
+    readonly DELEGATE_TASK: "[delegate-task]";
+};
+/**
+ * Parallel Tool Parameter Names
+ */
+export declare const PARALLEL_PARAMS: {
+    readonly AGENT: "agent";
+    readonly TASK: "task";
+    readonly PROMPT: "prompt";
+    readonly CONTEXT: "context";
+    readonly BACKGROUND: "background";
+    readonly PARALLEL_GROUP: "parallel_group";
+    readonly RETRY: "retry";
+    readonly TIMEOUT: "timeout";
+    readonly DESCRIPTION: "description";
+    readonly RESUME: "resume";
+    readonly MODE: "mode";
+    readonly GROUP_ID: "groupID";
+    readonly TASK_ID: "taskId";
+    readonly STATUS: "status";
+};

package/dist/shared/tool/index.d.ts

@@ -1,5 +1,6 @@
 /**
  * Tool Domain
  */
-export * from "./constants/index.js";
-export * from "./interfaces/index.js";
+export * from "./tool-names.js";
+export * from "./constants.js";
+export * from "./types.js";

package/dist/shared/tool/types.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Tool types and interfaces (consolidated)
+ */
+/**
+ * AST Search Result Interface
+ */
+export interface AstSearchResult {
+    file: string;
+    line: number;
+    column: number;
+    content: string;
+    context: {
+        before: string[];
+        after: string[];
+    };
+}
+/**
+ * AST Replace Result Interface
+ */
+export interface AstReplaceResult {
+    file: string;
+    success: boolean;
+    error?: string;
+}
+/**
+ * LSP Diagnostic Interface
+ */
+export interface LspDiagnostic {
+    file: string;
+    line: number;
+    column: number;
+    severity: number;
+    message: string;
+    source?: string;
+}
+/**
+ * LSP Rename Location Interface
+ */
+export interface LspRenameLocation {
+    file: string;
+    line: number;
+    column: number;
+    oldText: string;
+}
+/**
+ * LSP Rename Result Interface
+ */
+export interface LspRenameResult {
+    success: boolean;
+    locations: LspRenameLocation[];
+    error?: string;
+}
+/**
+ * LSP Command Result Interface
+ */
+export interface LspCommandResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+/**
+ * Poll Result Interface
+ */
+export interface PollResult {
+    success: boolean;
+    timedOut: boolean;
+    error?: string;
+    pollCount: number;
+    elapsedMs: number;
+}
+/**
+ * Session Client Interface
+ */
+export interface SessionClient {
+    create: (opts: {
+        body: {
+            parentID: string;
+            title: string;
+        };
+        query: {
+            directory: string;
+        };
+    }) => Promise<{
+        data?: {
+            id: string;
+        };
+        error?: string;
+    }>;
+    prompt: (opts: {
+        path: {
+            id: string;
+        };
+        body: {
+            agent: string;
+            tools?: Record<string, boolean>;
+            parts: {
+                type: string;
+                text: string;
+            }[];
+        };
+    }) => Promise<{
+        error?: string;
+    }>;
+    messages: (opts: {
+        path: {
+            id: string;
+        };
+    }) => Promise<{
+        data?: unknown[];
+        error?: string;
+    }>;
+    status: () => Promise<{
+        data?: Record<string, {
+            type: string;
+        }>;
+    }>;
+}

package/dist/shared/verification/{constants/categories.d.ts → constants.d.ts}

@@ -1,3 +1,48 @@
+/**
+ * Verification Signaling Constants
+ *
+ * Centralized strings used to trigger specific verification behaviors
+ * between the Commander and Reviewer agents.
+ */
+export declare const VERIFICATION_SIGNALS: {
+    /** Trigger for all-encompassing system check at the end of a mission */
+    readonly FINAL_PASS: "Full System Verification";
+};
+/**
+ * Checklist Parsing Patterns
+ *
+ * Regular expressions for parsing verification checklist markdown.
+ */
+export declare const CHECKLIST_PATTERNS: {
+    /** Incomplete item: - [ ] */
+    readonly INCOMPLETE: RegExp;
+    /** Complete item: - [x] or - [X] */
+    readonly COMPLETE: RegExp;
+    /** Category header: ## Category */
+    readonly CATEGORY: RegExp;
+    /** Item with ID format: - [ ] **ID**: Description */
+    readonly ITEM_WITH_ID: RegExp;
+    /** Simple item format: - [ ] Description */
+    readonly SIMPLE_ITEM: RegExp;
+    /** Mark as complete indicator (x or X) */
+    readonly COMPLETE_MARK: RegExp;
+};
+/**
+ * Verification Checklist Constants
+ *
+ * File paths and configuration for the verification checklist system.
+ */
+/**
+ * Checklist file and configuration constants
+ */
+export declare const CHECKLIST: {
+    /** Path to the verification checklist file */
+    readonly FILE: ".opencode/verification-checklist.md";
+    /** Minimum required items for valid checklist */
+    readonly MIN_ITEMS: 1;
+    /** Maximum items to show in error messages */
+    readonly MAX_ERROR_ITEMS: 5;
+};
 /**
  * Checklist Category Constants
  *

package/dist/shared/verification/index.d.ts

@@ -1,8 +1,5 @@
 /**
  * Verification Domain
- *
- * Constants, types, and interfaces for verification checklist system.
  */
-export * from "./constants/index.js";
-export * from "./interfaces/index.js";
-export * from "./types/index.js";
+export * from "./constants.js";
+export * from "./types.js";

package/dist/shared/verification/types.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Verification types and interfaces (consolidated)
+ */
+/**
+ * Checklist Category Type
+ *
+ * Type definition for verification checklist categories.
+ * Derived from CATEGORY_ID constant for single source of truth.
+ */
+/**
+ * Available checklist category identifiers
+ *
+ * - code-quality: Lint, type check, static analysis
+ * - unit-tests: Unit tests execution
+ * - integration-tests: E2E and integration tests
+ * - build: Build verification
+ * - runtime: Runtime verification (starts, runs)
+ * - infrastructure: Docker, compose, CI/CD, etc.
+ * - custom: Project-specific custom checks
+ */
+export type ChecklistCategory = "code-quality" | "unit-tests" | "integration-tests" | "build" | "runtime" | "infrastructure" | "custom";
+/**
+ * Checklist Item Interface
+ *
+ * Represents a single verification checklist item.
+ */
+/**
+ * A single item in the verification checklist
+ */
+export interface ChecklistItem {
+    /** Unique ID for the item (e.g., "unit-tests", "build", "docker") */
+    id: string;
+    /** Category of the check */
+    category: ChecklistCategory;
+    /** Description of what to verify */
+    description: string;
+    /** Whether this item is completed */
+    completed: boolean;
+    /** Optional: Evidence or notes about verification */
+    evidence?: string;
+}
+/**
+ * Verification Checklist Interface
+ *
+ * Represents the complete verification checklist with metadata.
+ */
+/**
+ * Complete verification checklist with metadata
+ */
+export interface VerificationChecklist {
+    /** Unique mission ID or timestamp */
+    missionId: string;
+    /** When the checklist was created */
+    createdAt: string;
+    /** Last update time */
+    updatedAt: string;
+    /** All checklist items */
+    items: ChecklistItem[];
+}
+/**
+ * Checklist Verification Result Interface
+ *
+ * Result of verifying a checklist's completion status.
+ */
+/**
+ * Result of verifying a checklist
+ */
+export interface ChecklistVerificationResult {
+    /** Whether all items are complete */
+    passed: boolean;
+    /** Total number of items */
+    totalItems: number;
+    /** Number of completed items */
+    completedItems: number;
+    /** Number of incomplete items */
+    incompleteItems: number;
+    /** Progress string e.g., "8/10" */
+    progress: string;
+    /** List of incomplete item descriptions */
+    incompleteList: string[];
+    /** List of verification failures */
+    errors: string[];
+}
+/**
+ * Verification Result Interface
+ *
+ * Unified result for mission completion verification.
+ * Combines TODO, sync issues, and checklist verification.
+ */
+/**
+ * Unified verification result for mission completion
+ */
+export interface VerificationResult {
+    /** Whether all verification checks passed */
+    passed: boolean;
+    /** Whether all TODO items are complete */
+    todoComplete: boolean;
+    /** Progress string e.g., "8/10" */
+    todoProgress: string;
+    /** Number of incomplete tasks */
+    todoIncomplete: number;
+    /** Whether sync-issues.md is empty or has no issues */
+    syncIssuesEmpty: boolean;
+    /** Count of sync issues found */
+    syncIssuesCount: number;
+    /** Whether verification checklist is complete */
+    checklistComplete: boolean;
+    /** Checklist progress string */
+    checklistProgress: string;
+    /** List of verification failures */
+    errors: string[];
+}