@uluops/core 0.21.1 → 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":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,cAAc,EAA0B,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AASxD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAG1D,kHAAkH;AAClH,MAAM,kBAAkB,GAAG,OAAO,CAAC;AAEnC;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,YAAY;IACf,QAAQ,CAAiB;IACzB,UAAU,CAAmB;IAC7B,aAAa,CAAgB;IAC7B,eAAe,CAAkB;IACjC,gBAAgB,CAAmB;IACnC,gBAAgB,CAAmB;IACnC,MAAM,CAAiB;IACvB,MAAM,CAAkC;IAEhD,YAAY,MAAoB;QAC9B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAEzC,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAE3B,IAAI,CAAC,QAAQ,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACxD,IAAI,CAAC,UAAU,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEpD,yFAAyF;QACzF,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACjE,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;QAErE,IAAI,CAAC,aAAa,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QACxE,IAAI,CAAC,eAAe,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9E,IAAI,CAAC,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;QACtG,IAAI,CAAC,gBAAgB,GAAG,IAAI,gBAAgB,CAC1C,IAAI,CAAC,gBAAgB,EACrB,IAAI,CAAC,eAAe,EACpB,IAAI,CAAC,aAAa,EAClB,IAAI,CAAC,QAAQ,EACb,MAAM,CACP,CAAC;IACJ,CAAC;IAED,2EAA2E;IAE3E;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CACZ,IAAY,EACZ,aAAsC,EACtC,OAA0B;QAE1B,MAAM,KAAK,GAAmB,OAAO,aAAa,KAAK,QAAQ;YAC7D,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE;YAC3B,CAAC,CAAC,aAAa,CAAC;QAElB,+EAA+E;QAC/E,6EAA6E;QAC7E,mEAAmE;QACnE,MAAM,IAAI,GACR,OAAO,EAAE,YAAY,IAAI,OAAO,EAAE,kBAAkB;YAClD,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,EAAE;YACxF,CAAC,CAAC,SAAS,CAAC;QAChB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAE9D,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC9B,MAAM,IAAI,kBAAkB,CAAC,GAAG,IAAI,2BAA2B,QAAQ,CAAC,IAAI,8BAA8B,CAAC,CAAC;QAC9G,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAC1E,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAClF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,KAAqB,EAAE,SAA8B;QAClF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAE1D,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,IAAI,kBAAkB,CAAC,GAAG,IAAI,4BAA4B,QAAQ,CAAC,IAAI,8DAA8D,CAAC,CAAC;QAC/I,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;QAC9E,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACpF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,IAAY,EAAE,KAAqB;QACnD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAE3D,IAAI,QAAQ,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACjC,MAAM,IAAI,kBAAkB,CAAC,GAAG,IAAI,6BAA6B,QAAQ,CAAC,IAAI,4DAA4D,CAAC,CAAC;QAC9I,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACpE,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAClF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,IAAY,EAAE,KAAqB;QACnD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAE3D,IAAI,QAAQ,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACjC,MAAM,IAAI,kBAAkB,CAAC,GAAG,IAAI,6BAA6B,QAAQ,CAAC,IAAI,kEAAkE,CAAC,CAAC;QACpJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE;YAClE,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;YAC9B,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,aAAa;SACpC,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAClF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAC,IAAY,EAAE,KAAqB;QAC3C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,MAAqC,CAAC;QAE1C,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;YACtB,KAAK,OAAO;gBACV,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;gBAC3D,MAAM;YACR,KAAK,SAAS;gBACZ,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;gBAC7D,MAAM;YACR,KAAK,UAAU;gBACb,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;gBAC9D,MAAM;YACR,KAAK,UAAU;gBACb,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE;oBAC5D,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;oBAC9B,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,aAAa;iBACpC,CAAC,CAAC;gBACH,MAAM;YACR,OAAO,CAAC,CAAC,CAAC;gBACR,MAAM,WAAW,GAAU,QAAQ,CAAC,IAAI,CAAC;gBACzC,MAAM,IAAI,kBAAkB,CAAC,4BAA4B,WAAW,EAAE,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;QAED,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACpF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,aAAa,CAAC,IAAY,EAAE,KAAqB;QACrD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAE3D,IAAI,QAAQ,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACjC,MAAM,IAAI,kBAAkB,CAAC,GAAG,IAAI,6BAA6B,QAAQ,CAAC,IAAI,kEAAkE,CAAC,CAAC;QACpJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAElE,4EAA4E;QAC5E,4EAA4E;QAC5E,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9C,MAAM,CAAC,IAAI,GAAG,KAAK,EAAE,cAAuB,EAA2B,EAAE;YACvE,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,cAAc,CAAC,CAAC;YAClD,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;YAClF,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC;QAEF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,2EAA2E;IAE3E;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,OAAiC;QAC9D,OAAO,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,OAAiC;QAC9D,OAAO,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,OAAiC;QAC9D,OAAO,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,MAAc,EAAE,OAAiC;QAC1D,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IACvD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,kBAAkB,CAAC,MAAc,EAAE,OAAiC;QACxE,OAAO,IAAI,CAAC,WAAW,CAAC,qBAAqB,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,2EAA2E;IAE3E;;;;OAIG;IACH,KAAK,CAAC,IAAI,CAAC,MAAmD;QAC5D,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ,CACZ,IAAY,EACZ,OAAgB,EAChB,IAAqB;QASrB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAClE,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,SAAS,EAAE,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,UAAU,CAAC;YACrD,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,IAAI;SAC1C,CAAC;IACJ,CAAC;IAED,2EAA2E;IAE3E,uCAAuC;IACvC,KAAK,CAAC,UAAU,CACd,OAAe,EACf,OAAgC;QAEhC,OAAO,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAED,4CAA4C;IAC5C,KAAK,CAAC,MAAM,CAAC,KAAa;QACxB,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,mEAAmE;IACnE,KAAK,CAAC,iBAAiB,CACrB,OAAe,EACf,YAAoB,EACpB,MAAuB;QAEvB,OAAO,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IAC1E,CAAC;IAED,mEAAmE;IACnE,KAAK,CAAC,aAAa,CACjB,OAAe,EACf,YAAoB,EACpB,MAAuB;QAEvB,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,kGAAkG;IAClG,UAAU;QACR,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IAC7B,CAAC;IAED,2EAA2E;IAEnE,aAAa,CAAC,MAAoB;QACxC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAE5F,2EAA2E;QAC3E,qEAAqE;QACrE,wEAAwE;QACxE,MAAM,iBAAiB,GAAG,CAAC,MAAM,CAAC,gBAAgB,IAAI,MAAM,CAAC,eAAe,KAAK,KAAK,CAAC;QACvF,IAAI,CAAC,MAAM,IAAI,iBAAiB,EAAE,CAAC;YACjC,MAAM,IAAI,kBAAkB,CAC1B,+DAA+D;gBAC/D,kFAAkF;gBAClF,2CAA2C;gBAC3C,qEAAqE,CACtE,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,kBAAkB,CAC1B,uDAAuD;gBACvD,qBAAqB;gBACrB,gDAAgD,CACjD,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,uCAAuC,CAAC;QACxH,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,IAAI,8BAA8B,CAAC;QACrH,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,IAAI,uBAAuB,CAAC;QAE3G,mFAAmF;QACnF,mFAAmF;QACnF,MAAM,UAAU,GAAG,CAAC,GAAW,EAAE,EAAE;YACjC,IAAI,CAAC;gBAAC,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;gBAAC,OAAO,CAAC,CAAC,QAAQ,KAAK,WAAW,IAAI,CAAC,CAAC,QAAQ,KAAK,WAAW,CAAC;YAAC,CAAC;YAChG,MAAM,CAAC;gBAAC,OAAO,KAAK,CAAC;YAAC,CAAC;QACzB,CAAC,CAAC;QACF,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1C,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,WAAW,CAAC,EAAE,CAAC,eAAe,EAAE,aAAa,CAAC,CAAU,EAAE,CAAC;gBACrG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBACpD,MAAM,IAAI,kBAAkB,CAC1B,GAAG,KAAK,uDAAuD,GAAG,MAAM;wBACxE,qFAAqF,CACtF,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO;YACL,MAAM;YACN,EAAE,EAAE,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;YACnC,WAAW;YACX,aAAa;YACb,YAAY;YACZ,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,IAAI,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC;YACpF,eAAe,EAAE,MAAM,CAAC,eAAe,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,KAAK,OAAO,CAAC;YAC/F,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,kBAAkB;YAC7C,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;YACtE,qBAAqB,EAAE,MAAM,CAAC,qBAAqB,IAAI,MAAM;YAC7D,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,MAAM,CAAC;YAC/D,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC,IAAI,uBAAuB;YACnI,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;SACjG,CAAC;IACJ,CAAC;IAED;;;OAGG;IACK,mBAAmB,CAAC,QAAiB;QAC3C,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAS,CAAC;QAChC,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACxC,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACrD,CAAC;IAED;;;;;OAKG;IACK,iBAAiB,CAAC,QAAiB;QACzC,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAS,CAAC;QAChC,OAAO,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAChE,CAAC;IAEO,eAAe,CAAC,EAAa;QACnC,MAAM,SAAS,GAAuC,EAAE,CAAC;QAEzD,IAAI,EAAE,EAAE,SAAS,EAAE,CAAC;YAClB,4DAA4D;YAC5D,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC;gBACzD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,qBAAqB,CAAC,IAAI,CAAC,CAAC;gBAC3D,IAAI,MAAM,EAAE,CAAC;oBACX,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC;gBAC/B,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,yDAAyD;YACzD,MAAM,eAAe,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAC;YACxF,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;gBACnC,MAAM,MAAM,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;gBAC3C,IAAI,MAAM,EAAE,CAAC;oBACX,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC;gBAC/B,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO;YACL,SAAS;YACT,eAAe,EAAE,EAAE,EAAE,eAAe,IAAI,WAAW;YACnD,aAAa,EAAE,EAAE,EAAE,aAAa;YAChC,mBAAmB,EAAE,EAAE,EAAE,mBAAmB;SAC7C,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,IAAY,EAAE,IAAqB,EAAE,IAAwB;QACtF,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,IAAI;YACT,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC;YAClD,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACjD,CAAC;IAEO,KAAK,CAAC,cAAc,CAC1B,MAAqC,EACrC,QAA4B,EAC5B,YAAoB,EACpB,OAAsD,EACtD,MAAe;QAEf,MAAM,WAAW,GAAG,OAAO,EAAE,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC;QACzE,IAAI,CAAC,WAAW;YAAE,OAAO;QAEzB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,sGAAsG,CAAC,CAAC;YAC1H,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,gGAAgG;YAChG,sFAAsF;YACtF,gDAAgD;YAChD,MAAM,eAAe,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;YACrF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;gBAC5C,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,eAAe;gBAC1E,YAAY;gBACZ,kFAAkF;gBAClF,MAAM;gBACN,kBAAkB,EAAE,QAAQ;aAC7B,CAAC,CAAC;YACH,iEAAiE;YACjE,MAAM,CAAC,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC;YAE5C,MAAM,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;YAC7B,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACtE,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC;YAC/E,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,CAAC,CAAC,CAAE,KAA0B,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;YACzG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,4CAA4C,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC,CAAC;YAClH,wCAAwC;YACxC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,MAAM,CAAC,GAAG,KAAsF,CAAC;gBACjG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,UAAU,cAAc,CAAC,CAAC,SAAS,YAAY,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC;YACzH,CAAC;QACH,CAAC;IACH,CAAC;IAED,oFAAoF;IAC5E,KAAK,CAAC,gBAAgB,CAC5B,QAA4B,EAC5B,MAAqC,EACrC,KAAa;QAEb,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACnC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,+DAA+D,CAAC,CAAC;YACnF,OAAO;QACT,CAAC;QAED,6BAA6B;QAC7B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,MAAM,CAC/C,QAAQ,CAAC,IAAyE,EAClF,QAAQ,CAAC,IAAI,EACb,QAAQ,CAAC,OAAO,EAChB,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAC9B,CAAC;YACF,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;QACpG,CAAC;QAAC,OAAO,SAAS,EAAE,CAAC;YACnB,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,2CAA2C,SAAS,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAChH,CAAC;QACJ,CAAC;QAED,+CAA+C;QAC/C,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YACrD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;oBAAE,SAAS;gBAC5D,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,MAAM,CAC/C,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAClC,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAC9B,CAAC;gBACJ,CAAC;gBAAC,OAAO,cAAc,EAAE,CAAC;oBACxB,iEAAiE;oBACjE,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,mCAAmC,KAAK,CAAC,IAAI,KAAK,cAAc,YAAY,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,CACtI,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAEO,gBAAgB,CAAC,UAAmB;QAC1C,MAAM,GAAG,GAAG,UAAqC,CAAC;QAClD,KAAK,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,CAAC;YAC/D,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;YACzB,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAC3C,MAAM,KAAK,GAAI,OAAmC,CAAC,WAAW,CAAC,CAAC;gBAChE,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;oBACvC,OAAO,KAAgC,CAAC;gBAC1C,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;CACF;AAED;;;;GAIG;AACH,SAAS,qBAAqB,CAAC,IAAY;IACzC,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC;IAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,0DAA0D;IAC1D,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,OAAO,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"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/AgentExecutor.d.ts

@@ -68,6 +68,20 @@ export declare class AgentExecutor {
      * Classify decision using agent definition vocabulary.
      */
     private classifyAgentDecision;
+    /**
+     * Collect execution-phase degradation markers for a completed generation.
+     *
+     * - `budget.forced-wrap-up` — the context-budget latch was engaged at run end.
+     * - `steps.near-exhaustion` — the tool loop was cut at the step ceiling
+     *   (`finishReason === 'tool-calls'`) but had already produced output. The
+     *   empty-output form of this is thrown as MaxStepsExhaustedError upstream, so
+     *   here finishReason 'tool-calls' implies non-empty text. We rely on
+     *   finishReason, not a step-count comparison, because the effective ceiling is
+     *   `maxSteps + (structuredOutput ? 2 : 0)` and is not known to the executor.
+     * - `extraction.failed` (critical) / `extraction.low-confidence` (degraded) —
+     *   from the output extractor's confidence.
+     */
+    private collectExecutionMarkers;
     /**
      * Build discriminated agent result based on agent type.
      */

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

@@ -1 +1 @@
-{"version":3,"file":"AgentExecutor.d.ts","sourceRoot":"","sources":["../../src/executor/AgentExecutor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAoB,MAAM,qBAAqB,CAAC;AASxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAiC,MAAM,sBAAsB,CAAC;AAC9F,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAA8D,MAAM,uBAAuB,CAAC;AAC1I,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAkB/C;;;;;;;;;;;GAWG;AACH,qBAAa,aAAa;IAItB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,MAAM;IALhB,OAAO,CAAC,eAAe,CAAyB;gBAGtC,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,MAAM;IAGxB;;;;;;;;;;;;;;;OAeG;IACG,OAAO,CACX,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,EAAE,cAAc,EACrB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,WAAW,CAAC;IAgHvB;;OAEG;YACW,UAAU;IAsBxB;;;OAGG;IACH,OAAO,CAAC,aAAa;IASrB;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;IACH,OAAO,CAAC,WAAW;IAYnB;;OAEG;IACH,OAAO,CAAC,aAAa;IAYrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAQ7B;;OAEG;IACH,OAAO,CAAC,WAAW;IAuCnB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAuBtB,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,iBAAiB;IAUzB;;;;OAIG;YACW,mBAAmB;IAsCjC,OAAO,CAAC,WAAW;IAiBnB,OAAO,CAAC,qBAAqB;YAWf,oBAAoB;IA4BlC,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,gBAAgB;IAUxB;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IA0C3B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA0B9B,OAAO,CAAC,wBAAwB;CAOjC"}
+{"version":3,"file":"AgentExecutor.d.ts","sourceRoot":"","sources":["../../src/executor/AgentExecutor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAoB,MAAM,qBAAqB,CAAC;AAWxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAiC,MAAM,sBAAsB,CAAC;AAC9F,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAA8D,MAAM,uBAAuB,CAAC;AAC1I,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAkB/C;;;;;;;;;;;GAWG;AACH,qBAAa,aAAa;IAItB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,MAAM;IALhB,OAAO,CAAC,eAAe,CAAyB;gBAGtC,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,MAAM;IAGxB;;;;;;;;;;;;;;;OAeG;IACG,OAAO,CACX,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,EAAE,cAAc,EACrB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,WAAW,CAAC;IAqHvB;;OAEG;YACW,UAAU;IAsBxB;;;OAGG;IACH,OAAO,CAAC,aAAa;IASrB;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;IACH,OAAO,CAAC,WAAW;IAYnB;;OAEG;IACH,OAAO,CAAC,aAAa;IAYrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAQ7B;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,uBAAuB;IA6C/B;;OAEG;IACH,OAAO,CAAC,WAAW;IAkDnB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAuBtB,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,iBAAiB;IAUzB;;;;OAIG;YACW,mBAAmB;IAsCjC,OAAO,CAAC,WAAW;IAiBnB,OAAO,CAAC,qBAAqB;YAWf,oBAAoB;IA4BlC,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,gBAAgB;IAUxB;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IA0C3B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA0B9B,OAAO,CAAC,wBAAwB;CAOjC"}

package/dist/executor/AgentExecutor.js

@@ -6,8 +6,9 @@ import { deriveContextBudget } from '../ai/contextBudget.js';
 import { agentOutputSchema } from '../parser/outputSchemas.js';
 import { ExecutionError, MaxStepsExhaustedError } from '../errors/index.js';
 import { classifyDecision, buildVocabularyMap } from './classifyDecision.js';
+import { deriveCompleteness, resolutionMarkersFromLegacy } from './degradationMarkers.js';
 import { mapCategory } from './mapCategory.js';
-import { DEFAULT_PASS_THRESHOLD, DEFAULT_WARN_THRESHOLD, DEFAULT_MAX_STEPS, DEFAULT_MAX_TOKENS, DEFAULT_MODEL_ALIAS } from '../constants.js';
+import { DEFAULT_PASS_THRESHOLD, DEFAULT_WARN_THRESHOLD, DEFAULT_MAX_STEPS, DEFAULT_MAX_TOKENS, DEFAULT_MODEL_ALIAS, EXTRACTION_CONFIDENCE_THRESHOLD } from '../constants.js';
 /**
  * Maximum bytes retained from the LLM's raw text output on AgentResult.rawOutput.
  *
@@ -148,7 +149,11 @@ export class AgentExecutor {
         // exception — it checks for literal 'PASS' | 'SHIP'. See issue A3 in tracker.
         const effectiveDecision = parsed.decision ?? 'FAIL';
         const decisionCategory = this.classifyAgentDecision(resolved, effectiveDecision);
-        return this.buildResult(resolved, agentType, context, parsed, effectiveDecision, extraction, recommendations, durationMs, metrics, decisionCategory, rawText);
+        // Execution-phase degradation markers (resolution-phase markers are merged
+        // from resolved.degradations inside buildResult). These feed the run's
+        // derived completeness — see deriveCompleteness().
+        const executionMarkers = this.collectExecutionMarkers(result, rawText, extraction, toolAdapter.budgetTracker);
+        return this.buildResult(resolved, agentType, context, parsed, effectiveDecision, extraction, recommendations, durationMs, metrics, decisionCategory, rawText, executionMarkers);
     }
     /**
      * Setup tool handler, budget tracker, and optional shell tool.
@@ -240,10 +245,66 @@ export class AgentExecutor {
         const vocabularyMap = buildVocabularyMap(resolved.definition);
         return classifyDecision(decision, vocabularyMap);
     }
+    /**
+     * Collect execution-phase degradation markers for a completed generation.
+     *
+     * - `budget.forced-wrap-up` — the context-budget latch was engaged at run end.
+     * - `steps.near-exhaustion` — the tool loop was cut at the step ceiling
+     *   (`finishReason === 'tool-calls'`) but had already produced output. The
+     *   empty-output form of this is thrown as MaxStepsExhaustedError upstream, so
+     *   here finishReason 'tool-calls' implies non-empty text. We rely on
+     *   finishReason, not a step-count comparison, because the effective ceiling is
+     *   `maxSteps + (structuredOutput ? 2 : 0)` and is not known to the executor.
+     * - `extraction.failed` (critical) / `extraction.low-confidence` (degraded) —
+     *   from the output extractor's confidence.
+     */
+    collectExecutionMarkers(result, rawText, extraction, budgetTracker) {
+        const markers = [];
+        if (budgetTracker.forcedWrapUp) {
+            markers.push({
+                code: 'budget.forced-wrap-up',
+                phase: 'execution',
+                severity: 'degraded',
+                detail: 'Context-budget wrap-up was forced; coverage may be partial.',
+            });
+        }
+        if (result.finishReason === 'tool-calls' && rawText.length > 0) {
+            markers.push({
+                code: 'steps.near-exhaustion',
+                phase: 'execution',
+                severity: 'degraded',
+                detail: `Tool loop cut at the step ceiling after ${result.steps} steps with output present.`,
+            });
+        }
+        if (extraction.confidence === 0) {
+            markers.push({
+                code: 'extraction.failed',
+                phase: 'execution',
+                severity: 'critical',
+                detail: `No structured output and no usable text extracted (method: ${extraction.method}).`,
+            });
+        }
+        else if (extraction.confidence < EXTRACTION_CONFIDENCE_THRESHOLD) {
+            markers.push({
+                code: 'extraction.low-confidence',
+                phase: 'execution',
+                severity: 'degraded',
+                detail: `Extracted via ${extraction.method} at confidence ${extraction.confidence}; decision/score may be approximate.`,
+            });
+        }
+        return markers;
+    }
     /**
      * Build discriminated agent result based on agent type.
      */
-    buildResult(resolved, agentType, context, parsed, effectiveDecision, extraction, recommendations, durationMs, metrics, decisionCategory, rawText) {
+    buildResult(resolved, agentType, context, parsed, effectiveDecision, extraction, recommendations, durationMs, metrics, decisionCategory, rawText, executionMarkers) {
+        // Merge resolution-phase markers (derived from the legacy degradations
+        // strings, byte-exact) with execution-phase markers, then derive completeness.
+        const degradationMarkers = [
+            ...resolutionMarkersFromLegacy(resolved.degradations ?? []),
+            ...executionMarkers,
+        ];
+        const completeness = deriveCompleteness(degradationMarkers);
         return {
             type: 'agent',
             agentType,
@@ -266,6 +327,8 @@ export class AgentExecutor {
             extractionMethod: extraction.method,
             extractionConfidence: extraction.confidence,
             degradations: resolved.degradations,
+            degradationMarkers: degradationMarkers.length > 0 ? degradationMarkers : undefined,
+            completeness,
             rawJson: parsed.rawJson,
         };
     }