@cleocode/contracts 2026.4.96 → 2026.4.98

package/dist/operations/nexus.js

@@ -0,0 +1,22 @@
+/**
+ * Nexus Domain Operations (22 operations)
+ *
+ * Query operations: 13
+ * Mutate operations: 9
+ *
+ * NEXUS is the cross-project coordination layer (the BRAIN Network). It tracks
+ * registered projects in a global registry (`nexus.db`), serves cross-project
+ * task references (`project:taskId` syntax), answers dependency / blocker /
+ * orphan queries, and orchestrates cross-project transfers. These wire-format
+ * contracts describe the CLI + HTTP dispatch surface.
+ *
+ * SYNC: Canonical implementations at
+ *   packages/core/src/nexus/* and packages/nexus/*
+ * Engine adapter at
+ *   packages/cleo/src/dispatch/engines/nexus-engine.ts
+ *
+ * @task T910 — Orchestration Coherence v4 (contract surface completion)
+ * @see packages/cleo/src/dispatch/domains/nexus.ts
+ */
+export {};
+//# sourceMappingURL=nexus.js.map

package/dist/operations/nexus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nexus.js","sourceRoot":"","sources":["../../src/operations/nexus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG"}

package/dist/operations/orchestrate.d.ts

@@ -3,113 +3,323 @@
  *
  * Query operations: 7
  * Mutate operations: 6
+ *
+ * SYNC: Canonical implementations at
+ *   packages/cleo/src/dispatch/engines/orchestrate-engine.ts
+ *   packages/core/src/orchestration/*.ts
+ *
+ * @task T963 — contract↔impl drift reconciliation (T910 audit)
  */
 /**
  * Common orchestration types
  */
 export interface Wave {
+    /** 1-based wave number. @task T963 */
     wave: number;
+    /** Task IDs scheduled in this wave. @task T963 */
     taskIds: string[];
+    /** True when every task in the wave can run in parallel. @task T963 */
     canRunParallel: boolean;
+    /** Upstream wave/task dependencies. @task T963 */
     dependencies: string[];
 }
 export interface SkillDefinition {
+    /** Skill name. @task T963 */
     name: string;
+    /** Skill description. @task T963 */
     description: string;
+    /** Skill tags. @task T963 */
     tags: string[];
+    /** Preferred model. @task T963 */
     model?: string;
+    /** Supported protocol phases. @task T963 */
     protocols: string[];
 }
 /**
  * Query Operations
  */
+/**
+ * Parameters for `orchestrate.status`.
+ *
+ * @remarks
+ * Re-synced to match `orchestrateStatus(epicId?, projectRoot?)` in
+ * `packages/cleo/src/dispatch/engines/orchestrate-engine.ts`. When `epicId`
+ * is omitted, the engine returns an overall status envelope across all
+ * tasks in the project.
+ *
+ * @task T963 — contract↔impl drift reconciliation (T910 audit)
+ */
 export interface OrchestrateStatusParams {
-    epicId: string;
+    /** Epic to scope the status to. Omit for project-wide status. @task T963 */
+    epicId?: string;
+}
+/** Per-status task counts. @task T963 */
+export interface OrchestrateStatusCounts {
+    /** Pending tasks. @task T963 */
+    pending: number;
+    /** Active tasks. @task T963 */
+    active: number;
+    /** Blocked tasks. @task T963 */
+    blocked: number;
+    /** Completed tasks. @task T963 */
+    done: number;
+    /** Cancelled tasks (epic scope only). @task T963 */
+    cancelled?: number;
 }
-export interface OrchestrateStatusResult {
+/**
+ * Epic-scoped status (returned when `epicId` is supplied). Mirrors
+ * `EpicStatus` in `packages/core/src/orchestration/status.ts`.
+ * @task T963
+ */
+export interface OrchestrateEpicStatus {
+    /** Epic task id. @task T963 */
     epicId: string;
+    /** Epic title. @task T963 */
+    epicTitle: string;
+    /** Count of direct children. @task T963 */
     totalTasks: number;
-    completedTasks: number;
-    pendingTasks: number;
-    blockedTasks: number;
-    currentWave: number;
-    totalWaves: number;
-    parallelCapacity: number;
+    /** Per-status breakdown of the children. @task T963 */
+    byStatus: OrchestrateStatusCounts;
+    /** Total wave count computed for the epic. @task T963 */
+    waves: number;
+    /** First non-completed wave number, or `null` when all waves done. @task T963 */
+    currentWave: number | null;
 }
+/**
+ * Project-wide status (returned when `epicId` is omitted). Mirrors
+ * `OverallStatus` in `packages/core/src/orchestration/status.ts`.
+ * @task T963
+ */
+export interface OrchestrateOverallStatus {
+    /** Count of detected root epics. @task T963 */
+    totalEpics: number;
+    /** Total tasks in the project. @task T963 */
+    totalTasks: number;
+    /** Per-status breakdown of the project. @task T963 */
+    byStatus: OrchestrateStatusCounts;
+}
+/** Result of `orchestrate.status` — union of epic-scoped and overall. @task T963 */
+export type OrchestrateStatusResult = OrchestrateEpicStatus | OrchestrateOverallStatus;
+/** Parameters for `orchestrate.next`. @task T963 */
 export interface OrchestrateNextParams {
+    /** Epic to pull the next task from (required). @task T963 */
     epicId: string;
 }
+/**
+ * Result of `orchestrate.next`.
+ *
+ * @remarks
+ * Re-synced to match `orchestrateNext(epicId, projectRoot?)` in the engine.
+ * The legacy `{taskId, title, recommendedSkill, reasoning}` shape was never
+ * implemented — the engine returns a `nextTask | null` + alternatives
+ * envelope.
+ *
+ * @task T963 — contract↔impl drift reconciliation (T910 audit)
+ */
 export interface OrchestrateNextResult {
-    taskId: string;
-    title: string;
-    recommendedSkill: string;
-    reasoning: string;
+    /** Epic id that was queried. @task T963 */
+    epicId: string;
+    /** Next task to work on, or `null` when nothing ready. @task T963 */
+    nextTask: {
+        /** Task id. @task T963 */
+        id: string;
+        /** Task title. @task T963 */
+        title: string;
+        /** Priority rollup from the engine. @task T963 */
+        priority: string;
+    } | null;
+    /** Other ready alternatives (up to 3). Absent when `nextTask` is null. @task T963 */
+    alternatives?: Array<{
+        id: string;
+        title: string;
+        priority: string;
+    }>;
+    /** Total ready tasks for the epic. Absent when `nextTask` is null. @task T963 */
+    totalReady?: number;
+    /** Human-readable hint when nothing is ready. @task T963 */
+    message?: string;
 }
+/** Parameters for `orchestrate.ready`. @task T963 */
 export interface OrchestrateReadyParams {
+    /** Epic to compute the ready set for (required). @task T963 */
     epicId: string;
 }
+/**
+ * A single ready-task descriptor as returned by `orchestrate.ready`.
+ * @task T963
+ */
+export interface OrchestrateReadyTask {
+    /** Task id. @task T963 */
+    id: string;
+    /** Task title. @task T963 */
+    title: string;
+    /** Engine-rolled priority. @task T963 */
+    priority: string;
+    /** IDs of tasks this one depends on (blocker/depends chain). @task T963 */
+    depends: string[];
+}
+/**
+ * Result of `orchestrate.ready`.
+ *
+ * @remarks
+ * Re-synced to match `orchestrateReady(epicId, projectRoot?)`. Returns
+ * the filtered ready set from `getReadyTasks` + a diagnostic `reason`
+ * when empty.
+ *
+ * @task T963 — contract↔impl drift reconciliation (T910 audit)
+ */
 export interface OrchestrateReadyResult {
-    wave: number;
-    taskIds: string[];
-    parallelSafe: boolean;
+    /** Epic id that was queried. @task T963 */
+    epicId: string;
+    /** Ready task set (filtered to `ready === true`). @task T963 */
+    readyTasks: OrchestrateReadyTask[];
+    /** Count of ready tasks (may be zero). @task T963 */
+    total: number;
+    /** Diagnostic reason populated when `total === 0`. @task T963 */
+    reason?: string;
 }
+/**
+ * Parameters for `orchestrate.analyze`.
+ *
+ * @remarks
+ * Re-synced: engine signature is
+ * `orchestrateAnalyze(epicId?, projectRoot?, mode?)`. Mode
+ * `critical-path` delegates to `orchestrateCriticalPath` — callers may
+ * branch on `mode` at the dispatch layer.
+ *
+ * @task T963 — contract↔impl drift reconciliation (T910 audit)
+ */
 export interface OrchestrateAnalyzeParams {
-    epicId: string;
+    /**
+     * Epic to analyze. Required for standard mode; optional for
+     * `mode: 'critical-path'` which operates across the whole project.
+     * @task T963
+     */
+    epicId?: string;
+    /** Analysis mode — `undefined` | `'critical-path'`. @task T963 */
+    mode?: 'critical-path';
 }
+/**
+ * Result of `orchestrate.analyze` (standard mode).
+ *
+ * @remarks
+ * Returns the wave plan + dependency diagnostics from
+ * `analyzeEpic` + `analyzeDependencies`.
+ *
+ * @task T963 — contract↔impl drift reconciliation (T910 audit)
+ */
 export interface OrchestrateAnalyzeResult {
+    /** Epic task id that was analyzed. @task T963 */
+    epicId: string;
+    /** Epic title (falls back to `epicId` when title unresolvable). @task T963 */
+    epicTitle: string;
+    /** Count of direct children. @task T963 */
+    totalTasks: number;
+    /** Computed wave plan. @task T963 */
     waves: Wave[];
-    criticalPath: string[];
-    estimatedParallelism: number;
-    bottlenecks: string[];
+    /** Detected circular dependency chains. @task T963 */
+    circularDependencies: string[][];
+    /** Dependencies that point at nonexistent task ids. @task T963 */
+    missingDependencies: string[];
+    /**
+     * Adjacency-list dependency graph (taskId → depends-on ids).
+     * @task T963
+     */
+    dependencyGraph: Record<string, string[]>;
 }
+/**
+ * Parameters for `orchestrate.context`.
+ *
+ * @remarks
+ * Re-synced to match `orchestrateContext(epicId?, projectRoot?)` in the
+ * engine. The legacy `tokens` field was unused; the real parameter is
+ * an optional `epicId` that scopes the task-count basis of the estimate.
+ *
+ * @task T963 — contract↔impl drift reconciliation (T910 audit)
+ */
 export interface OrchestrateContextParams {
-    tokens?: number;
+    /** Epic id to scope the context estimate. Omit for project-wide. @task T963 */
+    epicId?: string;
 }
+/**
+ * Result of `orchestrate.context`.
+ *
+ * @remarks
+ * Mirrors `ContextEstimation` in `packages/core/src/orchestration/context.ts`.
+ *
+ * @task T963 — contract↔impl drift reconciliation (T910 audit)
+ */
 export interface OrchestrateContextResult {
-    currentTokens: number;
-    maxTokens: number;
-    percentUsed: number;
-    level: 'safe' | 'medium' | 'high' | 'critical';
+    /** Epic id the estimate was scoped to, or `null` for project-wide. @task T963 */
+    epicId: string | null;
+    /** Count of tasks included in the estimate. @task T963 */
+    taskCount: number;
+    /** Count of MANIFEST.jsonl entries. @task T963 */
+    manifestEntries: number;
+    /** Rough estimated token count (taskCount * per-task weight). @task T963 */
+    estimatedTokens: number;
+    /** Human-readable recommendation. @task T963 */
     recommendation: string;
+    /** Context budget limits + current usage. @task T963 */
+    limits: {
+        /** Maximum orchestrator context budget. @task T963 */
+        orchestratorBudget: number;
+        /** Max files a single agent should read. @task T963 */
+        maxFilesPerAgent: number;
+        /** Current token usage (mirrors `estimatedTokens`). @task T963 */
+        currentUsage: number;
+    };
 }
+/** Parameters for `orchestrate.waves`. @task T963 */
 export interface OrchestrateWavesParams {
+    /** Epic to compute waves for. @task T963 */
     epicId: string;
 }
 export type OrchestrateWavesResult = Wave[];
+/** Parameters for `orchestrate.skill.list`. @task T963 */
 export interface OrchestrateSkillListParams {
+    /** Free-text filter across skill name/tags. @task T963 */
     filter?: string;
 }
 export type OrchestrateSkillListResult = SkillDefinition[];
+/** Parameters for `orchestrate.bootstrap`. @task T963 */
 export interface OrchestrateBootstrapParams {
+    /** Bootstrap verbosity mode. @task T963 */
     speed?: 'fast' | 'full' | 'complete';
 }
 export interface BrainState {
+    /** Currently active session summary. @task T963 */
     session?: {
         id: string;
         name: string;
         status: string;
         startedAt: string;
     };
+    /** Current task context. @task T963 */
     currentTask?: {
         id: string;
         title: string;
         status: string;
     };
+    /** Suggested next task with score. @task T963 */
     nextSuggestion?: {
         id: string;
         title: string;
         score: number;
     };
+    /** Recent decisions for the brain-state rollup. @task T963 */
     recentDecisions?: Array<{
         id: string;
         decision: string;
         timestamp: string;
     }>;
+    /** Blockers currently affecting progress. @task T963 */
     blockers?: Array<{
         taskId: string;
         title: string;
         blockedBy: string[];
     }>;
+    /** Progress rollup. @task T963 */
     progress?: {
         total: number;
         done: number;
@@ -117,10 +327,12 @@ export interface BrainState {
         blocked: number;
         pending: number;
     };
+    /** Context drift score + contributing factors. @task T963 */
     contextDrift?: {
         score: number;
         factors: string[];
     };
+    /** Bootstrap envelope metadata. @task T963 */
     _meta: {
         speed: 'fast' | 'full' | 'complete';
         generatedAt: string;
@@ -130,73 +342,274 @@ export interface BrainState {
 /**
  * Mutate Operations
  */
+/** Parameters for `orchestrate.startup`. @task T963 */
 export interface OrchestrateStartupParams {
+    /** Epic id to initialize. @task T963 */
     epicId: string;
 }
+/**
+ * Result of `orchestrate.startup`.
+ *
+ * @remarks
+ * Re-synced to match `orchestrateStartup(epicId, projectRoot?)` + the
+ * `computeStartupSummary` output + auto-init fields. The legacy shape
+ * assumed nested status/analysis/firstTask envelopes; the engine actually
+ * returns a flat summary + auto-init metadata.
+ *
+ * @task T963 — contract↔impl drift reconciliation (T910 audit)
+ */
 export interface OrchestrateStartupResult {
+    /** Epic id that was initialized. @task T963 */
     epicId: string;
-    status: OrchestrateStatusResult;
-    analysis: OrchestrateAnalyzeResult;
-    firstTask: OrchestrateNextResult;
+    /** Epic title. @task T963 */
+    epicTitle: string;
+    /** Always true once startup reaches return — pipeline + research stage recorded. @task T963 */
+    initialized: true;
+    /** Summary rollup of the epic's children. @task T963 */
+    summary: {
+        /** Total child count. @task T963 */
+        totalTasks: number;
+        /** Wave count. @task T963 */
+        totalWaves: number;
+        /** Count of tasks ready to spawn. @task T963 */
+        readyTasks: number;
+        /** Per-status breakdown. @task T963 */
+        byStatus: OrchestrateStatusCounts;
+    };
+    /** First wave payload, or `null` when epic has no children. @task T963 */
+    firstWave: Wave | null;
+    /**
+     * True when this startup call auto-initialized the lifecycle to the
+     * `research` stage. False when the epic already had a pipeline.
+     * @task T963
+     */
+    autoInitialized: boolean;
+    /**
+     * Current pipeline stage after startup — `research` when auto-initialized,
+     * `already-initialized` marker string otherwise.
+     * @task T963
+     */
+    currentStage: string;
 }
+/**
+ * Parameters for `orchestrate.spawn` (T882 canonical spawn contract).
+ *
+ * @remarks
+ * Re-synced to match `orchestrateSpawn(taskId, protocolType, projectRoot, tier)`
+ * in `packages/cleo/src/dispatch/engines/orchestrate-engine.ts`. The legacy
+ * `{skill, model}` fields from earlier drafts were never implemented — the
+ * T882 rebuild (v2026.4.85) introduced `protocolType` + `tier` as the
+ * authoritative inputs.
+ *
+ * @task T963 — contract↔impl drift reconciliation (T910 audit)
+ * @task T882 — canonical spawn-prompt rebuild
+ */
 export interface OrchestrateSpawnParams {
+    /** Task ID to spawn a worker for (required). @task T963 */
     taskId: string;
-    skill?: string;
-    model?: string;
+    /**
+     * Protocol phase dispatched to the worker (e.g. `'research'`,
+     * `'implementation'`, `'validation'`). When omitted, the composer runs
+     * `autoDispatch` to classify the task.
+     * @task T963
+     */
+    protocolType?: string;
+    /**
+     * Spawn prompt tier per T882 (0=minimal, 1=standard with CLEO-INJECTION
+     * embed, 2=full with skill excerpts + SUBAGENT-PROTOCOL-BLOCK). When
+     * omitted, resolved from the agent role (orchestrator=2, lead=1, worker=0).
+     * @task T963
+     */
+    tier?: 0 | 1 | 2;
 }
+/**
+ * Result of `orchestrate.spawn`.
+ *
+ * @remarks
+ * Re-synced to match the T932 `composeSpawnForTask` payload envelope returned
+ * by the orchestrate engine (prompt + atomicity verdict + traceability meta).
+ * Mirrors `SpawnPayload` in `packages/core/src/orchestration/spawn.ts`.
+ *
+ * @task T963 — contract↔impl drift reconciliation (T910 audit)
+ */
 export interface OrchestrateSpawnResult {
+    /** Task ID the spawn is about (mirrors `task.id`). @task T963 */
     taskId: string;
-    skill: string;
-    model: string;
+    /**
+     * Fully-resolved spawn prompt, copy-pastable into any LLM runtime
+     * (Claude, GPT-4, Gemini, open-source). Primary payload every caller
+     * should consume.
+     * @task T963
+     */
     prompt: string;
-    metadata: {
-        tokensUsed: number;
-        protocolsInjected: string[];
-        dependencies: string[];
+    /** Agent id the spawn is routed to. @task T963 */
+    agentId: string;
+    /** Role the agent will execute as (`orchestrator` | `lead` | `worker`). @task T963 */
+    role: string;
+    /** Tier of the rendered prompt (0/1/2). @task T963 */
+    tier: 0 | 1 | 2;
+    /** Harness hint driving dedup decisions (`claude-code` | `generic` | `bare`). @task T963 */
+    harnessHint: string;
+    /**
+     * Atomicity gate verdict from the worker file-scope guard. When
+     * `allowed=false`, the spawn was rejected and the orchestrate engine
+     * surfaces an `E_ATOMICITY_VIOLATION` error envelope.
+     * @task T963
+     */
+    atomicity: {
+        /** Whether the spawn is permitted. @task T963 */
+        allowed: boolean;
+        /** Error code when the spawn was rejected. @task T963 */
+        code?: string;
+        /** Diagnostic message. @task T963 */
+        message?: string;
+        /** Fix hint for the violation. @task T963 */
+        fixHint?: string;
+    };
+    /**
+     * Traceability / accounting metadata. Mirrors `SpawnPayloadMeta` —
+     * pinned `composerVersion: '3.0.0'` on every call.
+     * @task T963
+     */
+    meta: {
+        /** Tier the resolved agent was sourced from. @task T963 */
+        sourceTier: string;
+        /** Characters saved by skipping the tier-1 CLEO-INJECTION embed. @task T963 */
+        dedupSavedChars: number;
+        /** Character length of the final prompt. @task T963 */
+        promptChars: number;
+        /** Protocol phase the prompt was rendered for. @task T963 */
+        protocol: string;
+        /** ISO 8601 timestamp when the payload was generated. @task T963 */
+        generatedAt: string;
+        /** Pinned composer contract version. @task T963 */
+        composerVersion: '3.0.0';
+    };
+    /**
+     * Mirror of `meta.protocol` at the top level for legacy callers. Equals
+     * the resolved protocol phase (from `protocolType` param or auto-dispatch).
+     * @task T963
+     */
+    protocolType: string;
+    /**
+     * Active session id threaded into the prompt, or `null` when the
+     * orchestrator had no active session at spawn time.
+     * @task T963
+     */
+    sessionId: string | null;
+    /**
+     * Legacy mirror of the prompt/protocolType/tier bundle for readers that
+     * still consume `spawnContext.*`.
+     * @task T963
+     */
+    spawnContext: {
+        /** Task id mirrored from top level. @task T963 */
+        taskId: string;
+        /** Protocol string from the composer. @task T963 */
+        protocol: string;
+        /** Resolved protocol type. @task T963 */
+        protocolType: string;
+        /** Tier mirror. @task T963 */
+        tier: 0 | 1 | 2;
+        /** Prompt mirror. @task T963 */
+        prompt: string;
     };
 }
+/** Parameters for `orchestrate.handoff`. @task T963 */
 export interface OrchestrateHandoffParams {
+    /** Task id to hand off to. @task T963 */
     taskId: string;
+    /** Protocol phase for the successor spawn. @task T963 */
     protocolType: string;
+    /** Free-form session-end note. @task T963 */
     note?: string;
+    /** Next-action hint for the successor. @task T963 */
     nextAction?: string;
+    /** Context injection variant (skill preset). @task T963 */
     variant?: string;
+    /** Tier override for the spawn prompt. @task T963 */
     tier?: 0 | 1 | 2;
+    /** Client-supplied idempotency key for handoff retries. @task T963 */
     idempotencyKey?: string;
 }
+/** Result of `orchestrate.handoff`. @task T963 */
 export interface OrchestrateHandoffResult {
+    /** Task id that was handed off to. @task T963 */
     taskId: string;
+    /** Session id that was active before handoff. @task T963 */
     predecessorSessionId: string;
+    /** Session id that was ended. @task T963 */
     endedSessionId: string;
+    /** Protocol type resolved for the successor. @task T963 */
     protocolType: string;
 }
+/** Validation issue surfaced by `orchestrate.validate`. @task T963 */
+export interface OrchestrateValidationIssue {
+    /** Stable issue code (e.g. `V_NOT_FOUND`, `V_UNMET_DEP`, `V_MISSING_TITLE`). @task T963 */
+    code: string;
+    /** Human-readable diagnostic message. @task T963 */
+    message: string;
+    /** Issue severity (`error` | `warning` | `info`). @task T963 */
+    severity: string;
+}
+/** Parameters for `orchestrate.validate`. @task T963 */
 export interface OrchestrateValidateParams {
+    /** Task id to validate. @task T963 */
     taskId: string;
 }
+/**
+ * Result of `orchestrate.validate`.
+ *
+ * @remarks
+ * Re-synced to match `validateSpawnReadiness` in
+ * `packages/core/src/orchestration/validate-spawn.ts`. The legacy shape
+ * (`{blockers, lifecycleGate, recommendations}`) never matched the engine;
+ * the real output is a `{ready, issues}` envelope.
+ *
+ * @task T963 — contract↔impl drift reconciliation (T910 audit)
+ */
 export interface OrchestrateValidateResult {
+    /** Task id that was validated. @task T963 */
     taskId: string;
+    /** Task title snapshot. @task T963 */
+    title: string;
+    /** True when the task passed every readiness check. @task T963 */
     ready: boolean;
-    blockers: string[];
-    lifecycleGate: 'passed' | 'failed' | 'pending';
-    recommendations: string[];
+    /** Issues preventing spawn (empty array when `ready === true`). @task T963 */
+    issues: OrchestrateValidationIssue[];
 }
+/** Parameters for `orchestrate.parallel.start`. @task T963 */
 export interface OrchestrateParallelStartParams {
+    /** Epic id. @task T963 */
     epicId: string;
+    /** Wave number to launch. @task T963 */
     wave: number;
 }
+/** Result of `orchestrate.parallel.start`. @task T963 */
 export interface OrchestrateParallelStartResult {
+    /** Wave number launched. @task T963 */
     wave: number;
+    /** Task IDs in the wave. @task T963 */
     taskIds: string[];
+    /** ISO 8601 start timestamp. @task T963 */
     started: string;
 }
+/** Parameters for `orchestrate.parallel.end`. @task T963 */
 export interface OrchestrateParallelEndParams {
+    /** Epic id. @task T963 */
     epicId: string;
+    /** Wave number that ended. @task T963 */
     wave: number;
 }
+/** Result of `orchestrate.parallel.end`. @task T963 */
 export interface OrchestrateParallelEndResult {
+    /** Wave number. @task T963 */
     wave: number;
+    /** Tasks that completed successfully. @task T963 */
     completed: number;
+    /** Tasks that failed. @task T963 */
     failed: number;
+    /** Wave duration (ISO 8601 duration string). @task T963 */
     duration: string;
 }
 //# sourceMappingURL=orchestrate.d.ts.map