@uluops/core 0.22.0 → 0.22.1

package/dist/client/UluOpsClient.d.ts

@@ -35,6 +35,26 @@ export declare class UluOpsClient {
      *
      * Use for interactive/ad-hoc validation, experimentation, and development.
      * For reproducible CI runs, use `runCommand()` instead.
+     *
+     * @param name - Agent name or `name@version` ref (e.g. `'code-validator'` or `'code-validator@1.2.0'`).
+     * @param targetOrInput - Absolute path to the project directory, or a full {@link ExecutionInput} object.
+     * @param options - Optional runtime overrides: `model`, `maxTokens`, `thresholds`, `reportMode`,
+     *   and caller-pinned integrity hashes (`expectedHash`/`expectedPromptHash`).
+     * @returns The {@link AgentResult} — score, decision, category breakdown, `completeness`, and `degradationMarkers`.
+     * @throws {ConfigurationError} If the resolved definition is not an agent.
+     * @throws {IntegrityError} If integrity pins are supplied and do not match the resolved content.
+     * @throws {MaxStepsExhaustedError} If the tool loop exhausts its step ceiling with empty output.
+     * @example
+     * ```typescript
+     * const result = await client.runAgent('code-validator', './src');
+     * console.log(`${result.decision} · ${result.score}`);
+     *
+     * // With overrides and an integrity pin:
+     * await client.runAgent('security-analyst', { target: './src' }, {
+     *   model: 'opus',
+     *   expectedHash: 'sha256-…',
+     * });
+     * ```
      */
     runAgent(name: string, targetOrInput: string | ExecutionInput, options?: ExecutionOptions): Promise<AgentResult>;
     /**
@@ -43,28 +63,68 @@ export declare class UluOpsClient {
      * Uses model, thresholds, and aggregation from the command definition.
      * Pass `overrides.model` to override the definition's default model at runtime.
      * Ideal for CI/CD pipelines and team-standardized validation.
+     *
+     * @param name - Command name or `name@version` ref.
+     * @param input - Execution input ({@link ExecutionInput}); `target` is the absolute project path.
+     * @param overrides - Optional runtime overrides; `model` overrides the definition's default model.
+     * @returns The aggregated {@link CommandResult} with per-agent scores, decision, and recommendations.
+     * @throws {ConfigurationError} If the resolved definition is not a command.
+     * @throws {PreflightError} If a preflight check fails.
+     * @throws {ExecutionError} If an underlying agent execution fails.
      */
     runCommand(name: string, input: ExecutionInput, overrides?: {
         model?: string;
     }): Promise<CommandResult>;
     /**
      * Execute a workflow with multi-phase orchestration.
+     *
+     * Phases run as a DAG with quality gates between them; a gate failure
+     * surfaces as a {@link WorkflowError} carrying partial phase results.
+     *
+     * @param name - Workflow name or `name@version` ref.
+     * @param input - Execution input ({@link ExecutionInput}); `target` is the absolute project path.
+     * @returns The {@link WorkflowResult} with per-phase results and aggregate metrics.
+     * @throws {ConfigurationError} If the resolved definition is not a workflow.
+     * @throws {WorkflowError} If a phase gate fails (`error.context.partialResult` holds completed phases).
      */
     runWorkflow(name: string, input: ExecutionInput): Promise<WorkflowResult>;
     /**
      * Execute a pipeline with multi-stage orchestration.
+     *
+     * Runs synchronously to completion. For long-running pipelines you want to
+     * monitor or cancel, use {@link UluOpsClient.startPipeline} instead.
+     *
+     * @param name - Pipeline name or `name@version` ref.
+     * @param input - Execution input ({@link ExecutionInput}); `target` is the absolute project path.
+     * @returns The {@link PipelineResult} with per-stage results and aggregate metrics.
+     * @throws {ConfigurationError} If the resolved definition is not a pipeline.
+     * @throws {PipelineError} If a stage fails (`error.context` holds stage name/index).
      */
     runPipeline(name: string, input: ExecutionInput): Promise<PipelineResult>;
     /**
      * Universal execution — auto-routes based on definition type.
      *
      * Resolves the definition name and delegates to the appropriate executor.
-     * Agents are directly executable (wrapped as ExecutionResult).
+     * Use when the definition type is not known at the call site; prefer the
+     * typed `run*` methods when it is, for a precise return type.
+     *
+     * @param name - Definition name or `name@version` ref (any of the four types).
+     * @param input - Execution input ({@link ExecutionInput}); `target` is the absolute project path.
+     * @returns An {@link AgentResult} for agents, or an {@link ExecutionResult} for command/workflow/pipeline.
+     * @throws {ConfigurationError} If the resolved definition has an unknown type.
      */
     run(name: string, input: ExecutionInput): Promise<ExecutionResult | AgentResult>;
     /**
      * Start an async pipeline execution.
-     * Returns a PipelineHandle for monitoring and control.
+     *
+     * Returns a {@link PipelineHandle} for monitoring and control. Calling
+     * `handle.wait()` resolves with the final {@link PipelineResult} and tracks
+     * it (when tracking is enabled), mirroring {@link UluOpsClient.runPipeline}.
+     *
+     * @param name - Pipeline name or `name@version` ref.
+     * @param input - Execution input ({@link ExecutionInput}); `target` is the absolute project path.
+     * @returns A {@link PipelineHandle} exposing `wait()`, status polling, and cancellation.
+     * @throws {ConfigurationError} If the resolved definition is not a pipeline.
      */
     startPipeline(name: string, input: ExecutionInput): Promise<PipelineHandle>;
     /**
@@ -117,6 +177,12 @@ export declare class UluOpsClient {
      * @param version - Optional explicit version (overrides any suffix in `name`)
      * @param type - Optional definition type to disambiguate when the same name exists across types
      * @returns Resolved definition metadata including type, version, hash, and interface
+     * @example
+     * ```typescript
+     * // When a name is registered as more than one type, pass `type` to disambiguate:
+     * const meta = await client.describe('socrates-explorer', undefined, 'agent');
+     * console.log(meta.type, meta.version, meta.hash);
+     * ```
      */
     describe(name: string, version?: string, type?: DefinitionType): Promise<{
         type: DefinitionType;
@@ -126,18 +192,51 @@ export declare class UluOpsClient {
         interface: Record<string, unknown>;
         riskProfile: Record<string, unknown> | null;
     }>;
-    /** Query run history for a project. */
+    /**
+     * Query run history for a project. Delegates to {@link SubmissionClient.getHistory}.
+     *
+     * @param project - Target project name.
+     * @param options - Optional filters (`workflowType`, `limit`).
+     * @returns An array of {@link RunHistoryEntry} (most recent first).
+     * @throws {SdkApiError} For transport/auth failures from the submission service.
+     */
     getHistory(project: string, options?: SubmissionQueryOptions): Promise<RunHistoryEntry[]>;
-    /** Get details for a specific run by ID. */
+    /**
+     * Get details for a specific run by ID. Delegates to {@link SubmissionClient.getRun}.
+     *
+     * @param runId - The run's UUID.
+     * @returns The {@link RunSubmissionResponse} for the run (correlation counts are zeroed).
+     * @throws {NotFoundError} If no run exists with that id.
+     * @throws {SdkApiError} For transport/auth failures from the submission service.
+     */
     getRun(runId: string): Promise<RunSubmissionResponse>;
-    /** Preview what a submission would do without saving (dry run). */
+    /**
+     * Preview what a submission would do without saving (dry run).
+     * Delegates to {@link SubmissionClient.previewSubmission}.
+     *
+     * @param project - Target project name.
+     * @param workflowType - Workflow type (`agent`/`command`/`workflow`/`pipeline`).
+     * @param result - The execution result that would be submitted.
+     * @returns Whether the submit would create/update/regress, plus any validation errors.
+     * @throws {SdkApiError} For transport/auth failures from the submission service.
+     */
     previewSubmission(project: string, workflowType: string, result: ExecutionResult): Promise<{
         wouldCreate: boolean;
         wouldUpdate: boolean;
         wouldRegress: boolean;
         validationErrors: string[];
     }>;
-    /** Manually submit execution results to the submission service. */
+    /**
+     * Manually submit execution results to the submission service.
+     * Delegates to {@link SubmissionClient.submit}.
+     *
+     * @param project - Target project name.
+     * @param workflowType - Workflow type (`agent`/`command`/`workflow`/`pipeline`).
+     * @param result - The execution result to submit.
+     * @returns The {@link RunSubmissionResponse} — run id/number, dashboard URL, correlation counts.
+     * @throws {SubmissionError} If the service rejects the submission.
+     * @throws {SdkApiError} For transport/auth failures from the submission service.
+     */
     submitResults(project: string, workflowType: string, result: ExecutionResult): Promise<RunSubmissionResponse>;
     /** Clear the definition resolution cache. Call after registry updates in long-lived processes. */
     clearCache(): void;

package/dist/client/UluOpsClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UluOpsClient.d.ts","sourceRoot":"","sources":["../../src/client/UluOpsClient.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"UluOpsClient.d.ts","sourceRoot":"","sources":["../../src/client/UluOpsClient.ts"],"names":[],"mappings":"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"}

package/dist/client/UluOpsClient.js

@@ -55,6 +55,26 @@ export class UluOpsClient {
      *
      * Use for interactive/ad-hoc validation, experimentation, and development.
      * For reproducible CI runs, use `runCommand()` instead.
+     *
+     * @param name - Agent name or `name@version` ref (e.g. `'code-validator'` or `'code-validator@1.2.0'`).
+     * @param targetOrInput - Absolute path to the project directory, or a full {@link ExecutionInput} object.
+     * @param options - Optional runtime overrides: `model`, `maxTokens`, `thresholds`, `reportMode`,
+     *   and caller-pinned integrity hashes (`expectedHash`/`expectedPromptHash`).
+     * @returns The {@link AgentResult} — score, decision, category breakdown, `completeness`, and `degradationMarkers`.
+     * @throws {ConfigurationError} If the resolved definition is not an agent.
+     * @throws {IntegrityError} If integrity pins are supplied and do not match the resolved content.
+     * @throws {MaxStepsExhaustedError} If the tool loop exhausts its step ceiling with empty output.
+     * @example
+     * ```typescript
+     * const result = await client.runAgent('code-validator', './src');
+     * console.log(`${result.decision} · ${result.score}`);
+     *
+     * // With overrides and an integrity pin:
+     * await client.runAgent('security-analyst', { target: './src' }, {
+     *   model: 'opus',
+     *   expectedHash: 'sha256-…',
+     * });
+     * ```
      */
     async runAgent(name, targetOrInput, options) {
         const input = typeof targetOrInput === 'string'
@@ -80,6 +100,14 @@ export class UluOpsClient {
      * Uses model, thresholds, and aggregation from the command definition.
      * Pass `overrides.model` to override the definition's default model at runtime.
      * Ideal for CI/CD pipelines and team-standardized validation.
+     *
+     * @param name - Command name or `name@version` ref.
+     * @param input - Execution input ({@link ExecutionInput}); `target` is the absolute project path.
+     * @param overrides - Optional runtime overrides; `model` overrides the definition's default model.
+     * @returns The aggregated {@link CommandResult} with per-agent scores, decision, and recommendations.
+     * @throws {ConfigurationError} If the resolved definition is not a command.
+     * @throws {PreflightError} If a preflight check fails.
+     * @throws {ExecutionError} If an underlying agent execution fails.
      */
     async runCommand(name, input, overrides) {
         const resolved = await this.resolveByRef(name, 'command');
@@ -92,6 +120,15 @@ export class UluOpsClient {
     }
     /**
      * Execute a workflow with multi-phase orchestration.
+     *
+     * Phases run as a DAG with quality gates between them; a gate failure
+     * surfaces as a {@link WorkflowError} carrying partial phase results.
+     *
+     * @param name - Workflow name or `name@version` ref.
+     * @param input - Execution input ({@link ExecutionInput}); `target` is the absolute project path.
+     * @returns The {@link WorkflowResult} with per-phase results and aggregate metrics.
+     * @throws {ConfigurationError} If the resolved definition is not a workflow.
+     * @throws {WorkflowError} If a phase gate fails (`error.context.partialResult` holds completed phases).
      */
     async runWorkflow(name, input) {
         const resolved = await this.resolveByRef(name, 'workflow');
@@ -104,6 +141,15 @@ export class UluOpsClient {
     }
     /**
      * Execute a pipeline with multi-stage orchestration.
+     *
+     * Runs synchronously to completion. For long-running pipelines you want to
+     * monitor or cancel, use {@link UluOpsClient.startPipeline} instead.
+     *
+     * @param name - Pipeline name or `name@version` ref.
+     * @param input - Execution input ({@link ExecutionInput}); `target` is the absolute project path.
+     * @returns The {@link PipelineResult} with per-stage results and aggregate metrics.
+     * @throws {ConfigurationError} If the resolved definition is not a pipeline.
+     * @throws {PipelineError} If a stage fails (`error.context` holds stage name/index).
      */
     async runPipeline(name, input) {
         const resolved = await this.resolveByRef(name, 'pipeline');
@@ -121,7 +167,13 @@ export class UluOpsClient {
      * Universal execution — auto-routes based on definition type.
      *
      * Resolves the definition name and delegates to the appropriate executor.
-     * Agents are directly executable (wrapped as ExecutionResult).
+     * Use when the definition type is not known at the call site; prefer the
+     * typed `run*` methods when it is, for a precise return type.
+     *
+     * @param name - Definition name or `name@version` ref (any of the four types).
+     * @param input - Execution input ({@link ExecutionInput}); `target` is the absolute project path.
+     * @returns An {@link AgentResult} for agents, or an {@link ExecutionResult} for command/workflow/pipeline.
+     * @throws {ConfigurationError} If the resolved definition has an unknown type.
      */
     async run(name, input) {
         const resolved = await this.resolveByRef(name);
@@ -152,7 +204,15 @@ export class UluOpsClient {
     }
     /**
      * Start an async pipeline execution.
-     * Returns a PipelineHandle for monitoring and control.
+     *
+     * Returns a {@link PipelineHandle} for monitoring and control. Calling
+     * `handle.wait()` resolves with the final {@link PipelineResult} and tracks
+     * it (when tracking is enabled), mirroring {@link UluOpsClient.runPipeline}.
+     *
+     * @param name - Pipeline name or `name@version` ref.
+     * @param input - Execution input ({@link ExecutionInput}); `target` is the absolute project path.
+     * @returns A {@link PipelineHandle} exposing `wait()`, status polling, and cancellation.
+     * @throws {ConfigurationError} If the resolved definition is not a pipeline.
      */
     async startPipeline(name, input) {
         const resolved = await this.resolveByRef(name, 'pipeline');
@@ -231,6 +291,12 @@ export class UluOpsClient {
      * @param version - Optional explicit version (overrides any suffix in `name`)
      * @param type - Optional definition type to disambiguate when the same name exists across types
      * @returns Resolved definition metadata including type, version, hash, and interface
+     * @example
+     * ```typescript
+     * // When a name is registered as more than one type, pass `type` to disambiguate:
+     * const meta = await client.describe('socrates-explorer', undefined, 'agent');
+     * console.log(meta.type, meta.version, meta.hash);
+     * ```
      */
     async describe(name, version, type) {
         const resolved = await this.registry.resolve(name, version, type);
@@ -244,19 +310,52 @@ export class UluOpsClient {
         };
     }
     // ─── Submission Service Delegation ──────────────────────────────────────
-    /** Query run history for a project. */
+    /**
+     * Query run history for a project. Delegates to {@link SubmissionClient.getHistory}.
+     *
+     * @param project - Target project name.
+     * @param options - Optional filters (`workflowType`, `limit`).
+     * @returns An array of {@link RunHistoryEntry} (most recent first).
+     * @throws {SdkApiError} For transport/auth failures from the submission service.
+     */
     async getHistory(project, options) {
         return this.submission.getHistory(project, options);
     }
-    /** Get details for a specific run by ID. */
+    /**
+     * Get details for a specific run by ID. Delegates to {@link SubmissionClient.getRun}.
+     *
+     * @param runId - The run's UUID.
+     * @returns The {@link RunSubmissionResponse} for the run (correlation counts are zeroed).
+     * @throws {NotFoundError} If no run exists with that id.
+     * @throws {SdkApiError} For transport/auth failures from the submission service.
+     */
     async getRun(runId) {
         return this.submission.getRun(runId);
     }
-    /** Preview what a submission would do without saving (dry run). */
+    /**
+     * Preview what a submission would do without saving (dry run).
+     * Delegates to {@link SubmissionClient.previewSubmission}.
+     *
+     * @param project - Target project name.
+     * @param workflowType - Workflow type (`agent`/`command`/`workflow`/`pipeline`).
+     * @param result - The execution result that would be submitted.
+     * @returns Whether the submit would create/update/regress, plus any validation errors.
+     * @throws {SdkApiError} For transport/auth failures from the submission service.
+     */
     async previewSubmission(project, workflowType, result) {
         return this.submission.previewSubmission(project, workflowType, result);
     }
-    /** Manually submit execution results to the submission service. */
+    /**
+     * Manually submit execution results to the submission service.
+     * Delegates to {@link SubmissionClient.submit}.
+     *
+     * @param project - Target project name.
+     * @param workflowType - Workflow type (`agent`/`command`/`workflow`/`pipeline`).
+     * @param result - The execution result to submit.
+     * @returns The {@link RunSubmissionResponse} — run id/number, dashboard URL, correlation counts.
+     * @throws {SubmissionError} If the service rejects the submission.
+     * @throws {SdkApiError} For transport/auth failures from the submission service.
+     */
     async submitResults(project, workflowType, result) {
         return this.submission.submit({ project, workflowType, result });
     }
@@ -385,7 +484,7 @@ export class UluOpsClient {
         if (!shouldTrack)
             return;
         if (!this.config.apiKey) {
-            this.logger.debug('Tracking skipped: no UluOps API key configured. Set trackingEnabled: false to suppress this message.');
+            this.logger.debug('Tracking skipped: no UluOps API key configured. Set trackingEnabled: false to disable tracking (this is a debug log; it does not appear unless debug logging is on).');
             return;
         }
         try {
@@ -409,7 +508,7 @@ export class UluOpsClient {
             const errMsg = error instanceof Error ? error.message : String(error);
             const errName = error instanceof Error ? error.constructor.name : typeof error;
             const errCode = error instanceof Error && 'code' in error ? error.code : undefined;
-            this.logger.warn(`Tracking submission failed (non-fatal): [${errName}${errCode ? `:${errCode}` : ''}] ${errMsg}`);
+            this.logger.warn(`Tracking submission failed (non-fatal): [${errName}${errCode ? `:${errCode}` : ''}] ${errMsg}. Set trackingEnabled: false in config to disable result tracking.`);
             // Log SdkApiError details for diagnosis
             if (error instanceof Error) {
                 const e = error;

package/dist/client/UluOpsClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"UluOpsClient.js","sourceRoot":"","sources":["../../src/client/UluOpsClient.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"UluOpsClient.js","sourceRoot":"","sources":["../../src/client/UluOpsClient.ts"],"names":[],"mappings":"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"}

package/dist/constants.d.ts

@@ -54,12 +54,12 @@ export declare const ANTHROPIC_CONTEXT_KEEP_TOOL_USES = 5;
 export declare const ANTHROPIC_BASH_TOOL_VERSION = "bash_20250124";
 /** Anthropic context management edit type. Update when Anthropic ships a new version. */
 export declare const ANTHROPIC_CONTEXT_MANAGEMENT_TYPE = "clear_tool_uses_20250919";
+/** Default model alias when no model is specified in options or agent definition. */
+export declare const DEFAULT_MODEL_ALIAS = "sonnet";
 /**
  * Default allowlist of valid provider names for dynamic import.
  * Prevents path traversal via crafted provider strings (CWE-829).
  * Users can extend this via config.ai.additionalProviders.
  */
-/** Default model alias when no model is specified in options or agent definition. */
-export declare const DEFAULT_MODEL_ALIAS = "sonnet";
 export declare const DEFAULT_DYNAMIC_PROVIDERS: readonly ["anthropic", "openai", "google", "mistral", "cohere", "groq", "xai", "deepseek"];
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,eAAO,MAAM,uBAAuB,QAA+C,CAAC;AAapF;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,gEAAgE;AAChE,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,uEAAuE;AACvE,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC;;;;;0DAK0D;AAC1D,eAAO,MAAM,+BAA+B,MAAM,CAAC;AAEnD,2DAA2D;AAC3D,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC;;;;;;;qCAOqC;AACrC,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC;;;oEAGoE;AACpE,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AAExC;;;yDAGyD;AACzD,eAAO,MAAM,sBAAsB,SAAU,CAAC;AAE9C;;;;yEAIyE;AACzE,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAOlD,uFAAuF;AACvF,eAAO,MAAM,2BAA2B,kBAAkB,CAAC;AAE3D,yFAAyF;AACzF,eAAO,MAAM,iCAAiC,6BAA6B,CAAC;AAI5E;;;;GAIG;AACH,qFAAqF;AACrF,eAAO,MAAM,mBAAmB,WAAW,CAAC;AAE5C,eAAO,MAAM,yBAAyB,4FAE5B,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,eAAO,MAAM,uBAAuB,QAA+C,CAAC;AAapF;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,gEAAgE;AAChE,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,uEAAuE;AACvE,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC;;;;;0DAK0D;AAC1D,eAAO,MAAM,+BAA+B,MAAM,CAAC;AAEnD,2DAA2D;AAC3D,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC;;;;;;;qCAOqC;AACrC,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC;;;oEAGoE;AACpE,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AAExC;;;yDAGyD;AACzD,eAAO,MAAM,sBAAsB,SAAU,CAAC;AAE9C;;;;yEAIyE;AACzE,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAOlD,uFAAuF;AACvF,eAAO,MAAM,2BAA2B,kBAAkB,CAAC;AAE3D,yFAAyF;AACzF,eAAO,MAAM,iCAAiC,6BAA6B,CAAC;AAI5E,qFAAqF;AACrF,eAAO,MAAM,mBAAmB,WAAW,CAAC;AAE5C;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,4FAE5B,CAAC"}

package/dist/constants.js

@@ -72,13 +72,13 @@ export const ANTHROPIC_BASH_TOOL_VERSION = 'bash_20250124';
 /** Anthropic context management edit type. Update when Anthropic ships a new version. */
 export const ANTHROPIC_CONTEXT_MANAGEMENT_TYPE = 'clear_tool_uses_20250919';
 // ─── Provider Defaults ─────────────────────────────────────────────────────
+/** Default model alias when no model is specified in options or agent definition. */
+export const DEFAULT_MODEL_ALIAS = 'sonnet';
 /**
  * Default allowlist of valid provider names for dynamic import.
  * Prevents path traversal via crafted provider strings (CWE-829).
  * Users can extend this via config.ai.additionalProviders.
  */
-/** Default model alias when no model is specified in options or agent definition. */
-export const DEFAULT_MODEL_ALIAS = 'sonnet';
 export const DEFAULT_DYNAMIC_PROVIDERS = [
     'anthropic', 'openai', 'google', 'mistral', 'cohere', 'groq', 'xai', 'deepseek',
 ];

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE/D;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,OAAO,CAAC,SAAS,EAAE,wBAAwB,CAAC,CAAC;AAEpF,8EAA8E;AAC9E,EAAE;AACF,+EAA+E;AAC/E,gFAAgF;AAChF,8EAA8E;AAC9E,6EAA6E;AAC7E,qFAAqF;AACrF,8EAA8E;AAC9E,4EAA4E;AAC5E,yBAAyB;AAEzB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAEzC,gEAAgE;AAChE,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAEzC,uEAAuE;AACvE,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAEzC;;;;;0DAK0D;AAC1D,MAAM,CAAC,MAAM,+BAA+B,GAAG,GAAG,CAAC;AAEnD,2DAA2D;AAC3D,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAEpC;;;;;;;qCAOqC;AACrC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAEzC;;;oEAGoE;AACpE,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC;AAExC;;;yDAGyD;AACzD,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAO,CAAC;AAE9C;;;;yEAIyE;AACzE,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC;AAElD,8EAA8E;AAC9E,6EAA6E;AAC7E,6EAA6E;AAC7E,uEAAuE;AAEvE,uFAAuF;AACvF,MAAM,CAAC,MAAM,2BAA2B,GAAG,eAAe,CAAC;AAE3D,yFAAyF;AACzF,MAAM,CAAC,MAAM,iCAAiC,GAAG,0BAA0B,CAAC;AAE5E,8EAA8E;AAE9E;;;;GAIG;AACH,qFAAqF;AACrF,MAAM,CAAC,MAAM,mBAAmB,GAAG,QAAQ,CAAC;AAE5C,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU;CACvE,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE/D;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,OAAO,CAAC,SAAS,EAAE,wBAAwB,CAAC,CAAC;AAEpF,8EAA8E;AAC9E,EAAE;AACF,+EAA+E;AAC/E,gFAAgF;AAChF,8EAA8E;AAC9E,6EAA6E;AAC7E,qFAAqF;AACrF,8EAA8E;AAC9E,4EAA4E;AAC5E,yBAAyB;AAEzB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAEzC,gEAAgE;AAChE,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAEzC,uEAAuE;AACvE,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAEzC;;;;;0DAK0D;AAC1D,MAAM,CAAC,MAAM,+BAA+B,GAAG,GAAG,CAAC;AAEnD,2DAA2D;AAC3D,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAEpC;;;;;;;qCAOqC;AACrC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAEzC;;;oEAGoE;AACpE,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC;AAExC;;;yDAGyD;AACzD,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAO,CAAC;AAE9C;;;;yEAIyE;AACzE,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC;AAElD,8EAA8E;AAC9E,6EAA6E;AAC7E,6EAA6E;AAC7E,uEAAuE;AAEvE,uFAAuF;AACvF,MAAM,CAAC,MAAM,2BAA2B,GAAG,eAAe,CAAC;AAE3D,yFAAyF;AACzF,MAAM,CAAC,MAAM,iCAAiC,GAAG,0BAA0B,CAAC;AAE5E,8EAA8E;AAE9E,qFAAqF;AACrF,MAAM,CAAC,MAAM,mBAAmB,GAAG,QAAQ,CAAC;AAE5C;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU;CACvE,CAAC"}

package/dist/executor/CommandExecutor.d.ts

@@ -17,7 +17,18 @@ export declare class CommandExecutor {
     private registry;
     constructor(agentExecutor: AgentExecutor, registry: RegistryClient);
     /**
-     * Execute a command definition
+     * Execute a command definition against a target.
+     *
+     * Runs preflight checks (if any), resolves the referenced agent(s), and
+     * either delegates to {@link AgentExecutor} (single-agent) or aggregates
+     * across agents (multi-agent) per the command's aggregation method.
+     *
+     * @param resolved - Registry-resolved command definition (must have `type: 'command'`).
+     * @param input - Execution input; `target` is the absolute project path.
+     * @param overrides - Optional runtime overrides; `model` wins over the definition's default model.
+     * @returns The aggregated {@link CommandResult} with per-agent scores, decision, and recommendations.
+     * @throws {ExecutionError} If the resolved definition is not a command.
+     * @throws {PreflightError} If a preflight check fails before agents run.
      */
     execute(resolved: ResolvedDefinition, input: ExecutionInput, overrides?: {
         model?: string;

package/dist/executor/CommandExecutor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CommandExecutor.d.ts","sourceRoot":"","sources":["../../src/executor/CommandExecutor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAoC,MAAM,uBAAuB,CAAC;AAC9F,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,qBAAqB,CAAC;AASzE;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAExB,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,QAAQ;gBADR,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,cAAc;IAGlC;;OAEG;IACG,OAAO,CACX,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,EAAE,cAAc,EACrB,SAAS,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC7B,OAAO,CAAC,aAAa,CAAC;YA8EX,mBAAmB;YAWnB,eAAe;IA0B7B;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,OAAO,CAAC,eAAe;IAkCvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAqEzB"}
+{"version":3,"file":"CommandExecutor.d.ts","sourceRoot":"","sources":["../../src/executor/CommandExecutor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAoC,MAAM,uBAAuB,CAAC;AAC9F,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,qBAAqB,CAAC;AASzE;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAExB,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,QAAQ;gBADR,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,cAAc;IAGlC;;;;;;;;;;;;;OAaG;IACG,OAAO,CACX,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,EAAE,cAAc,EACrB,SAAS,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC7B,OAAO,CAAC,aAAa,CAAC;YA8EX,mBAAmB;YAWnB,eAAe;IA0B7B;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,OAAO,CAAC,eAAe;IAkCvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAqEzB"}

package/dist/executor/CommandExecutor.js

@@ -22,7 +22,18 @@ export class CommandExecutor {
         this.registry = registry;
     }
     /**
-     * Execute a command definition
+     * Execute a command definition against a target.
+     *
+     * Runs preflight checks (if any), resolves the referenced agent(s), and
+     * either delegates to {@link AgentExecutor} (single-agent) or aggregates
+     * across agents (multi-agent) per the command's aggregation method.
+     *
+     * @param resolved - Registry-resolved command definition (must have `type: 'command'`).
+     * @param input - Execution input; `target` is the absolute project path.
+     * @param overrides - Optional runtime overrides; `model` wins over the definition's default model.
+     * @returns The aggregated {@link CommandResult} with per-agent scores, decision, and recommendations.
+     * @throws {ExecutionError} If the resolved definition is not a command.
+     * @throws {PreflightError} If a preflight check fails before agents run.
      */
     async execute(resolved, input, overrides) {
         const startTime = Date.now();
@@ -42,7 +53,7 @@ export class CommandExecutor {
         if (agentRefs.length === 1) {
             const ref = agentRefs[0];
             if (!ref)
-                throw new Error('Agent refs array is empty despite length check');
+                throw new ExecutionError('Agent refs array is empty despite length check');
             const [name, version] = parseRef(ref);
             const agentResolved = await this.registry.resolve(name, version, 'agent');
             const agentResult = await this.agentExecutor.execute(agentResolved, input, {

package/dist/executor/CommandExecutor.js.map

@@ -1 +1 @@
-{"version":3,"file":"CommandExecutor.js","sourceRoot":"","sources":["../../src/executor/CommandExecutor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAMpD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAA0B,MAAM,6BAA6B,CAAC;AAEtF;;;;;;;;GAQG;AACH,MAAM,OAAO,eAAe;IAEhB;IACA;IAFV,YACU,aAA4B,EAC5B,QAAwB;QADxB,kBAAa,GAAb,aAAa,CAAe;QAC5B,aAAQ,GAAR,QAAQ,CAAgB;IAC/B,CAAC;IAEJ;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,QAA4B,EAC5B,KAAqB,EACrB,SAA8B;QAE9B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,IAAI,cAAc,CAAC,+BAA+B,QAAQ,CAAC,IAAI,mCAAmC,CAAC,CAAC;QAC5G,CAAC;QACD,MAAM,GAAG,GAAG,QAAQ,CAAC,UAA+B,CAAC;QAErD,oDAAoD;QACpD,MAAM,KAAK,GAAG,SAAS,EAAE,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC;QAEtE,0BAA0B;QAC1B,IAAI,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE,CAAC;YACrC,MAAM,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACnE,CAAC;QAED,+BAA+B;QAC/B,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC;QAErC,6CAA6C;QAC7C,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YACzB,IAAI,CAAC,GAAG;gBAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;YAC5E,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;YACtC,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAE1E,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,aAAa,EAAE,KAAK,EAAE;gBACzE,KAAK;gBACL,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO;gBACxC,UAAU,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU;aAC7C,CAAC,CAAC;YAEH,OAAO,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,GAAG,EAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;QACpG,CAAC;QAED,6CAA6C;QAC7C,MAAM,YAAY,GAAG,KAAK,EAAE,GAAW,EAAwB,EAAE;YAC/D,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;YACtC,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAC1E,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,aAAa,EAAE,KAAK,EAAE;gBACtD,KAAK;gBACL,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO;aACzC,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,IAAI,YAA2B,CAAC;QAChC,IAAI,WAAW,GAAa,EAAE,CAAC;QAE/B,IAAI,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,KAAK,KAAK,EAAE,CAAC;YAC/C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;YACrE,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC;YAChC,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC;QACrC,CAAC;aAAM,CAAC;YACN,YAAY,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QACzE,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAClC,YAAY,EACZ,GAAG,EACH,QAAQ,CAAC,IAAI,EACb,SAAS,EACT,GAAG,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,EAChD,QAAQ,CAAC,eAAe,CACzB,CAAC;QAEF,6EAA6E;QAC7E,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,SAAS,GAAqB,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC1D,KAAK,EAAE,GAAG;gBACV,QAAQ,EAAE,UAAmB;gBAC7B,QAAQ,EAAE,UAAmB;gBAC7B,UAAU,EAAE,EAAE;aACf,CAAC,CAAC,CAAC;YACJ,MAAM,CAAC,eAAe,GAAG,CAAC,GAAG,SAAS,EAAE,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC;QACrE,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,KAAK,CAAC,mBAAmB,CAC/B,IAAc,EACd,EAAyC;QAEzC,MAAM,OAAO,GAAkB,EAAE,CAAC;QAClC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9B,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,KAAK,CAAC,eAAe,CAC3B,IAAc,EACd,EAAyC;QAEzC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QACvD,MAAM,OAAO,GAAkB,EAAE,CAAC;QAClC,MAAM,WAAW,GAAa,EAAE,CAAC;QAEjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;YAC5B,IAAI,OAAO,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBACnC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC9B,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;gBACrB,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBAC9F,WAAW,CAAC,IAAI,CAAC,SAAS,GAAG,YAAY,GAAG,EAAE,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,cAAc,CAAC,+BAA+B,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpF,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IAClC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACK,eAAe,CACrB,WAAwB,EACxB,GAAsB,EACtB,IAAY,EACZ,SAAiB,EACjB,eAAkC;QAElC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAE1C,MAAM,OAAO,GAAmB;YAC9B,GAAG,WAAW,CAAC,OAAO;YACtB,UAAU;YACV,SAAS,EAAE,WAAW,CAAC,OAAO,CAAC,aAAa,IAAI,CAAC;SAClD,CAAC;QAEF,OAAO;YACL,IAAI,EAAE,SAAkB;YACxB,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI;YAChC,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO;YACtC,cAAc,EAAE,IAAI;YACpB,eAAe;YACf,SAAS,EAAE,WAAW,CAAC,SAAS;YAChC,QAAQ,EAAE,WAAW,CAAC,QAAQ;YAC9B,KAAK,EAAE,WAAW,CAAC,KAAK;YACxB,QAAQ,EAAE,WAAW,CAAC,QAAQ;YAC9B,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI;YACjD,UAAU,EAAE,WAAW,CAAC,UAAU,EAAE,GAAG,CAAC,WAAW,CAAC;YACpD,SAAS,EAAE,WAAW,CAAC,SAAS;YAChC,eAAe,EAAE,WAAW,CAAC,eAAe;YAC5C,UAAU;YACV,OAAO;SACR,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,gBAAgB,CACtB,OAAsB,EACtB,GAAsB,EACtB,IAAY,EACZ,SAAiB,EACjB,WAA4E,EAC5E,eAAkC;QAElC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAE1C,8BAA8B;QAC9B,MAAM,eAAe,GAAqB,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;QAElF,0CAA0C;QAC1C,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;QAEjE,IAAI,KAAyB,CAAC;QAC9B,IAAI,QAA4B,CAAC;QAEjC,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,KAAK,GAAG,eAAe,CACrB,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,EACzD,WAAW,CAAC,MAAM,EAClB,WAAW,CAAC,OAAO,CACpB,CAAC;YAEF,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC,CAAC,CAAC;QACpE,CAAC;QAED,6BAA6B;QAC7B,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,IAAI,sBAAsB,CAAC;QACnF,MAAM,aAAa,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,IAAI,sBAAsB,CAAC;QACvF,IAAI,QAAgB,CAAC;QAErB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,KAAK,IAAI,SAAS;gBAAE,QAAQ,GAAG,MAAM,CAAC;iBACrC,IAAI,KAAK,IAAI,aAAa;gBAAE,QAAQ,GAAG,MAAM,CAAC;;gBAC9C,QAAQ,GAAG,MAAM,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;YAC1D,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC;YAC5D,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;QAClE,CAAC;QAED,oBAAoB;QACpB,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3F,MAAM,OAAO,GAAmB;YAC9B,GAAG,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YAC/C,UAAU;YACV,KAAK,EAAE,OAAO;YACd,SAAS,EAAE,cAAc;SAC1B,CAAC;QAEF,OAAO;YACL,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI;YAChC,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO;YACtC,cAAc,EAAE,IAAI;YACpB,eAAe;YACf,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,IAAI,WAAW;YAC/C,QAAQ;YACR,KAAK;YACL,QAAQ;YACR,SAAS;YACT,eAAe;YACf,UAAU;YACV,OAAO;SACR,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"CommandExecutor.js","sourceRoot":"","sources":["../../src/executor/CommandExecutor.ts"],"names":[],"mappings":"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"}

package/dist/executor/PipelineExecutor.d.ts

@@ -21,11 +21,29 @@ export declare class PipelineExecutor {
     constructor(workflowExecutor: WorkflowExecutor, commandExecutor: CommandExecutor, agentExecutor: AgentExecutor, registry: RegistryClient, logger: Logger);
     /**
      * Start pipeline execution asynchronously.
-     * Returns a PipelineHandle for monitoring progress and retrieving results.
+     *
+     * Launches stage execution in the background and returns immediately. Errors
+     * during background execution are captured into the handle's state rather than
+     * thrown here; await {@link PipelineHandle.wait} to surface the final result.
+     *
+     * @param resolved - Registry-resolved pipeline definition (must have `type: 'pipeline'`).
+     * @param input - Execution input; `target` is the absolute project path.
+     * @param options - Optional execution overrides (`timeoutMs`, `model`).
+     * @returns A {@link PipelineHandle} for polling status, waiting, and cancellation.
+     * @throws {PipelineError} If the resolved definition is not a pipeline.
      */
     start(resolved: ResolvedDefinition, input: ExecutionInput, options?: ExecutionOptions): Promise<PipelineHandle>;
     /**
-     * Execute pipeline synchronously (blocking).
+     * Execute a pipeline synchronously (blocking).
+     *
+     * Convenience wrapper that {@link PipelineExecutor.start}s the pipeline and
+     * awaits completion.
+     *
+     * @param resolved - Registry-resolved pipeline definition (must have `type: 'pipeline'`).
+     * @param input - Execution input; `target` is the absolute project path.
+     * @param options - Optional execution overrides (`timeoutMs`, `model`).
+     * @returns The final {@link PipelineResult} with per-stage results and aggregate metrics.
+     * @throws {PipelineError} If the resolved definition is not a pipeline, or a stage fails.
      */
     execute(resolved: ResolvedDefinition, input: ExecutionInput, options?: ExecutionOptions): Promise<PipelineResult>;
     private executeAsync;