@oxgeneral/orch 0.3.2 → 0.3.3

package/dist/index.d.ts

@@ -212,6 +212,7 @@ interface OrchestratorState {
     version: 1;
     pid?: number;
     started_at?: string;
+    onboardingCompleted?: boolean;
     running: Record<string, RunningEntry>;
     claimed: Set<string>;
     retry_queue: RetryEntry[];
@@ -228,6 +229,54 @@ interface OrchestratorState {
     };
 }
 
+/**
+ * Typed error hierarchy for the orchestrator.
+ *
+ * Every error carries an exit code (matching CLI_UI_DESIGN.md §11)
+ * and an optional hint for the user.
+ *
+ * Exit codes:
+ *   0 - Success
+ *   1 - General error
+ *   2 - Invalid arguments
+ *   3 - Not initialized (.orchestry/ not found)
+ *   4 - Lock conflict (orchestrator already running)
+ *   5 - Agent error (adapter test failed)
+ */
+declare class OrchestryError extends Error {
+    readonly exitCode: number;
+    readonly hint?: string | undefined;
+    constructor(message: string, exitCode: number, hint?: string | undefined);
+}
+declare class NotInitializedError extends OrchestryError {
+    constructor();
+}
+declare class TaskNotFoundError extends OrchestryError {
+    constructor(taskId: string);
+}
+declare class AgentNotFoundError extends OrchestryError {
+    constructor(agentId: string);
+}
+declare class WorkspaceError extends OrchestryError {
+    constructor(message: string, hint?: string);
+}
+declare enum AdapterErrorKind {
+    ADAPTER_NOT_FOUND = "adapter_not_found",
+    AUTH_FAILED = "auth_failed",
+    TIMEOUT = "timeout",
+    RATE_LIMIT = "rate_limit",
+    PROCESS_CRASH = "process_crash",
+    SPAWN_FAILED = "spawn_failed",
+    UNKNOWN = "unknown"
+}
+interface AdapterErrorHint {
+    message: string;
+    fix: string;
+    doctorHint?: boolean;
+}
+declare const ERROR_HINTS: Record<AdapterErrorKind, AdapterErrorHint>;
+declare function classifyAdapterError(error: string, exitCode?: number): AdapterErrorKind;
+
 /**
  * Goal domain model.
  *
@@ -288,14 +337,6 @@ interface CreateMessageInput {
     reply_to?: string;
 }
 
-/**
- * Orchestrator event system.
- *
- * All communication between layers goes through typed events.
- * The EventBus emits these synchronously; subscribers (TUI, logger,
- * run store, state) react independently.
- */
-
 type OrchestratorEvent = {
     type: 'task:created';
     task: Task;
@@ -338,6 +379,7 @@ type OrchestratorEvent = {
     runId: string;
     agentId: string;
     error: string;
+    errorKind?: AdapterErrorKind;
 } | {
     type: 'run:retry';
     runId: string;
@@ -439,38 +481,6 @@ type EventPayload<T extends OrchestratorEventType> = Extract<OrchestratorEvent,
     type: T;
 }>;
 
-/**
- * Typed error hierarchy for the orchestrator.
- *
- * Every error carries an exit code (matching CLI_UI_DESIGN.md §11)
- * and an optional hint for the user.
- *
- * Exit codes:
- *   0 - Success
- *   1 - General error
- *   2 - Invalid arguments
- *   3 - Not initialized (.orchestry/ not found)
- *   4 - Lock conflict (orchestrator already running)
- *   5 - Agent error (adapter test failed)
- */
-declare class OrchestryError extends Error {
-    readonly exitCode: number;
-    readonly hint?: string | undefined;
-    constructor(message: string, exitCode: number, hint?: string | undefined);
-}
-declare class NotInitializedError extends OrchestryError {
-    constructor();
-}
-declare class TaskNotFoundError extends OrchestryError {
-    constructor(taskId: string);
-}
-declare class AgentNotFoundError extends OrchestryError {
-    constructor(agentId: string);
-}
-declare class WorkspaceError extends OrchestryError {
-    constructor(message: string, hint?: string);
-}
-
 /**
  * Task state machine — pure functions, no side effects.
  *
@@ -878,6 +888,7 @@ interface AdapterTestResult {
     ok: boolean;
     version?: string;
     error?: string;
+    errorKind?: AdapterErrorKind;
     details?: Record<string, unknown>;
 }
 interface ExecuteParams {
@@ -896,6 +907,7 @@ interface AgentEvent {
         output: number;
         total: number;
     };
+    errorKind?: AdapterErrorKind;
 }
 interface ExecuteHandle {
     pid: number;
@@ -1431,4 +1443,4 @@ declare function buildFullContainer(context: CliContext): Promise<Container>;
  */
 declare function buildContainer(context: CliContext): Promise<Container>;
 
-export { AdapterRegistry, type AdapterTestResult, type Agent, type AgentConfig, type AgentEvent, AgentNotFoundError, AgentService, type AgentStats, type AgentStatus, type ApprovalPolicy, type ClipboardContentType, type ClipboardImage, type Container, type CreateAgentInput, type CreateTaskInput, EventBus, type EventPayload, type ExecuteParams, type IAgentAdapter, type LightContainer, NotInitializedError, Orchestrator, type OrchestratorConfig, type OrchestratorEvent, type OrchestratorEventType, type OrchestratorState, OrchestryError, type ProjectConfig, type RetryEntry, type Run, type RunEvent, type RunEventType, RunService, type RunStatus, type RunningEntry, type SchedulingConfig, type Task, TaskNotFoundError, type TaskProof, TaskService, type TaskStatus, type TokenUsage, WorkspaceError, type WorkspaceMode, buildContainer, buildFullContainer, buildLightContainer, canTransition, createTokenUsage, detectClipboardType, getClipboardImage, isBlocked, isClipboardToolAvailable, isDispatchable, isTerminal, resolveFailureStatus };
+export { type AdapterErrorHint, AdapterErrorKind, AdapterRegistry, type AdapterTestResult, type Agent, type AgentConfig, type AgentEvent, AgentNotFoundError, AgentService, type AgentStats, type AgentStatus, type ApprovalPolicy, type ClipboardContentType, type ClipboardImage, type Container, type CreateAgentInput, type CreateTaskInput, ERROR_HINTS, EventBus, type EventPayload, type ExecuteParams, type IAgentAdapter, type LightContainer, NotInitializedError, Orchestrator, type OrchestratorConfig, type OrchestratorEvent, type OrchestratorEventType, type OrchestratorState, OrchestryError, type ProjectConfig, type RetryEntry, type Run, type RunEvent, type RunEventType, RunService, type RunStatus, type RunningEntry, type SchedulingConfig, type Task, TaskNotFoundError, type TaskProof, TaskService, type TaskStatus, type TokenUsage, WorkspaceError, type WorkspaceMode, buildContainer, buildFullContainer, buildLightContainer, canTransition, classifyAdapterError, createTokenUsage, detectClipboardType, getClipboardImage, isBlocked, isClipboardToolAvailable, isDispatchable, isTerminal, resolveFailureStatus };

package/dist/index.js

@@ -1,11 +1,11 @@
-import { ensureDir, Paths, readYaml, writeYaml, listFiles, writeJson, readJson, appendJsonl, readJsonl, readJsonlTail, pathExists } from './chunk-QEEM67OA.js';
-import { canTransition, isTerminal } from './chunk-2UC4SVJB.js';
-export { Orchestrator, canTransition, isBlocked, isDispatchable, isTerminal, resolveFailureStatus } from './chunk-2UC4SVJB.js';
-import { InvalidArgumentsError, TaskNotFoundError, InvalidTransitionError, AgentNotFoundError, OrchestryError, TeamNotFoundError, GoalNotFoundError } from './chunk-IQXRQBUK.js';
-export { AgentNotFoundError, NotInitializedError, OrchestryError, TaskNotFoundError, WorkspaceError } from './chunk-IQXRQBUK.js';
+import { ensureDir, Paths, readYaml, writeYaml, listFiles, writeJson, readJson, appendJsonl, readJsonl, readJsonlTail, pathExists } from './chunk-UIJYU3J7.js';
+import { canTransition, isTerminal } from './chunk-BGHCY7WY.js';
+export { Orchestrator, canTransition, isBlocked, isDispatchable, isTerminal, resolveFailureStatus } from './chunk-BGHCY7WY.js';
 import { AUTONOMOUS_LABEL } from './chunk-B4JQM4NU.js';
 export { AdapterRegistry } from './chunk-6DWHQPTE.js';
 export { createTokenUsage } from './chunk-XDVMX2FO.js';
+import { InvalidArgumentsError, TaskNotFoundError, InvalidTransitionError, AgentNotFoundError, OrchestryError, TeamNotFoundError, GoalNotFoundError } from './chunk-NLQAJ7TW.js';
+export { AdapterErrorKind, AgentNotFoundError, ERROR_HINTS, NotInitializedError, OrchestryError, TaskNotFoundError, WorkspaceError, classifyAdapterError } from './chunk-NLQAJ7TW.js';
 import fs, { mkdtemp, readFile, unlink, rm, mkdir } from 'fs/promises';
 import path, { join } from 'path';
 import { nanoid } from 'nanoid';
@@ -919,6 +919,7 @@ var RunStore = class {
 // src/domain/state.ts
 var DEFAULT_STATE = {
   version: 1,
+  onboardingCompleted: false,
   running: {},
   claimed: /* @__PURE__ */ new Set(),
   retry_queue: [],
@@ -944,6 +945,7 @@ var StateStore = class {
       version: raw.version ?? defaults.version,
       pid: raw.pid,
       started_at: raw.started_at,
+      onboardingCompleted: typeof raw.onboardingCompleted === "boolean" ? raw.onboardingCompleted : false,
       running: raw.running && typeof raw.running === "object" ? raw.running : defaults.running,
       claimed: Array.isArray(raw.claimed) ? new Set(raw.claimed) : new Set(defaults.claimed),
       retry_queue: Array.isArray(raw.retry_queue) ? raw.retry_queue : defaults.retry_queue,
@@ -1757,13 +1759,13 @@ async function buildFullContainer(context) {
   ] = await Promise.all([
     import('./process-manager-A36Y7LHP.js'),
     import('./registry-JXXRLJ5J.js'),
-    import('./claude-RIB3RQS5.js'),
-    import('./codex-VBUSA2GJ.js'),
-    import('./cursor-4QIOTDBW.js'),
-    import('./shell-IH2MMTVP.js'),
-    import('./workspace-manager-T6AXG7XL.js'),
+    import('./claude-INM52PTH.js'),
+    import('./codex-QGH2GRV6.js'),
+    import('./cursor-KQJTQ73D.js'),
+    import('./shell-UXJNTNBC.js'),
+    import('./workspace-manager-EVD67GCG.js'),
     import('./template-engine-MFL5B677.js'),
-    import('./orchestrator-FGGXK3N3.js'),
+    import('./orchestrator-KF4UY5GD.js'),
     import('./doctor-service-F2SXDWHS.js')
   ]);
   const processManager = new ProcessManager();