@uluops/core 0.22.0 → 0.22.7

package/README.md

@@ -43,15 +43,20 @@ const result = await client.runAgent('code-validator', './src', {
 });
 
 console.log(`Score: ${result.score} | Decision: ${result.decision}`);
+
+// Or run a saved command configuration (model, thresholds, and aggregation
+// come from the command definition — ideal for CI):
+const cmd = await client.runCommand('validate', { target: './src' });
+console.log(`Score: ${cmd.score} | Decision: ${cmd.decision}`);
 ```
 
 ```bash
 npx tsx validate.ts
 ```
 
-### Offline Quick Start (No API Key)
+### Offline Quick Start (No UluOps API Key)
 
-Use the bundled starter agents without registry access:
+Use the bundled starter agents without registry access. An AI provider key (e.g. `ANTHROPIC_API_KEY`) is still required:
 
 ```typescript
 import { UluOpsClient, STARTER_DEFINITIONS_DIR } from '@uluops/core';
@@ -67,6 +72,8 @@ console.log(`Score: ${result.score} | Decision: ${result.decision}`);
 
 This still requires an AI provider key but no UluOps API key or network access to the registry.
 
+> **Note:** `runAgent`/`resolve` return immediately from local definitions when found. `client.list()`, however, always queries the registry first and only falls back to the bundled definitions after the request fails — in a genuinely offline environment that means a few seconds of retry/backoff before the local list returns.
+
 ## Table of Contents
 
 - [Overview](#overview)
@@ -98,7 +105,7 @@ The `@uluops/core` SDK provides:
 - **4-Layer Execution Hierarchy** - Agent > Command > Workflow > Pipeline orchestration
 - **AI SDK v6 Integration** - Vercel AI SDK for LLM communication with automatic tool loops (`maxSteps`) and built-in retry
 - **Registry-Backed Model Resolution** - Model aliases resolved via UluOps Registry with provider metadata
-- **Multi-Provider AI** - Anthropic-first with deepest optimization (caching, context management, bash tools); OpenAI + Google bundled; Mistral, Cohere, and 10+ others via dynamic `@ai-sdk/*` import. See [SCOPE.md](https://github.com/Uluops/-uluops-core/blob/main/SCOPE.md) for provider strategy.
+- **Multi-Provider AI** - Anthropic-first with deepest optimization (caching, context management, bash tools); OpenAI + Google bundled; Mistral, Cohere, and 10+ others via dynamic `@ai-sdk/*` import. See [SCOPE.md](https://github.com/Uluops/uluops-core/blob/main/SCOPE.md) for provider strategy.
 - **Filesystem Sandboxing** - ToolHandler restricts LLM file access to the target directory with symlink-aware path validation
 - **Content-Addressed Integrity Verification** - Registry-resolved definitions carry a SHA-256 YAML content hash (`sha256:…`) and, for agents/commands, a `promptHash` over the frozen rendered prompt. Hashing uses the shared `@uluops/sdk-core` implementation, so the client and registry hash identically. Remote resolution executes the **frozen `runtimeMd`** the `promptHash` certifies (not a live re-render). Callers can pin `expectedHash`/`expectedPromptHash` (from a trusted channel) on `resolve()`/`ExecutionOptions`; pins are verified **fail-closed** on every resolve path (cache/local/remote) and a mismatch throws `IntegrityError`. Verification is opt-in — unpinned resolves behave as before. See [Integrity Verification](#integrity-verification).
 - **Universal Agent Output** - Single `agentOutputSchema` with categories + artifacts for all 6 agent types (validator, executor, analyst, generator, explorer, forecaster)
@@ -426,7 +433,8 @@ try {
 } catch (err) {
   if (err instanceof IntegrityError) {
     // err.kind: 'yaml' | 'prompt' | 'unavailable'; err.expected / err.actual
-    console.error(`Execution refused (${err.kind}): ${err.message}`);
+    // err.definitionName / err.definitionVersion identify which definition failed
+    console.error(`Execution refused (${err.kind}) for ${err.definitionName}@${err.definitionVersion}: ${err.message}`);
   }
 }
 ```
@@ -441,7 +449,9 @@ try {
 
 ## Architecture
 
-```
+For a detailed, hop-by-hop trace of every execution chain (resolution → LLM generation → persistence), see [ARCHITECTURE.md](./ARCHITECTURE.md).
+
+```text
 UluOpsClient (facade)
   |
   +-- AgentExecutor        (single-agent LLM execution)
@@ -507,6 +517,24 @@ import {
   parseRef,            // Parse "name@version" reference strings
   classifyDecision,    // Classify decision strings into positive/negative/conditional/neutral
   buildVocabularyMap,  // Build custom decision vocabulary from agent definitions
+  deriveCompleteness,         // Recompute completeness from a DegradationMarker[]
+  resolutionMarkersFromLegacy, // Convert the deprecated degradations[] to DegradationMarker[]
+} from '@uluops/core';
+```
+
+### Exported Constants
+
+The default thresholds and limits used by the executors are exported for custom
+threshold logic, diagnostics, and tests:
+
+```typescript
+import {
+  DEFAULT_PASS_THRESHOLD,  // 75    — default validator pass threshold
+  DEFAULT_WARN_THRESHOLD,  // 50    — default warn threshold
+  DEFAULT_GATE_THRESHOLD,  // 70    — default workflow phase gate
+  DEFAULT_MAX_STEPS,       // 50    — default tool-loop step ceiling
+  DEFAULT_MAX_TOKENS,      // 16384 — default output tokens per generation call
+  STARTER_DEFINITIONS_DIR, // bundled starter definitions directory (offline quick start)
 } from '@uluops/core';
 ```
 
@@ -539,7 +567,7 @@ const catalog = new ModelCatalog(registrySdk);
 const resolved = await catalog.resolve('sonnet', {
   requiredCapabilities: ['tools', 'extendedThinking'],
 });
-// → { provider: 'anthropic', model: 'claude-sonnet-4-...' }
+// → { provider: 'anthropic', modelId: 'claude-sonnet-4-...', providerModelId: 'claude-sonnet-4-...' }
 
 // Enumerate available models and aliases
 const aliases = await catalog.listAliases();
@@ -622,6 +650,7 @@ const client = new UluOpsClient({
 | Variable | Description | Default |
 |----------|-------------|---------|
 | `ULUOPS_API_KEY` | Platform API key | (required) |
+| `ULU_API_KEY` | Platform API key (legacy alias; used only if `ULUOPS_API_KEY` is unset) | - |
 | `ANTHROPIC_API_KEY` | Anthropic provider key | - |
 | `OPENAI_API_KEY` | OpenAI provider key | - |
 | `GOOGLE_API_KEY` | Google/Gemini provider key | - |
@@ -657,15 +686,26 @@ import {
   type UluOpsConfig,
   type ExecutionInput,
   type ExecutionOptions,
+  // Async pipeline handle (return type of startPipeline)
+  type PipelineHandle,
   // Decision classification
   classifyDecision,
   type DecisionCategory,
+  type DecisionVocabularyMap,   // return type of buildVocabularyMap
+  // Analysis & AI layer companion types (for direct Advanced Exports usage)
+  type AnalysisExtractionResult, // return type of AnalysisSummaryExtractor
+  type ResolvedModel,            // return type of ModelCatalog.resolve
   // Completeness & degradation markers
   deriveCompleteness,
+  resolutionMarkersFromLegacy, // migrate the deprecated degradations[] field
   type Completeness,
   type DegradationMarker,
+  type DegradationPhase,        // 'resolution' | 'execution'
+  type DegradationSeverity,     // 'info' | 'degraded' | 'critical'
   // Usage metrics
-  type UsageMetrics,
+  type ExecutionMetrics,        // type of result.metrics on every result type (camelCase)
+  type UsageMetrics,            // raw AI-provider usage on AIGenerateResult.usage (advanced; snake_case)
+  type AIGenerateResult,        // return type of AIProvider.generate() (advanced)
   // Error classes
   ExecutionError,
   MaxStepsExhaustedError,
@@ -711,10 +751,10 @@ The SDK provides a structured error hierarchy:
 | `WorkflowError` | `WorkflowExecutor.execute()` | Phase gate failure. Check `error.context.partialResult` for completed phase results |
 | `PipelineError` | `PipelineExecutor.execute()` | Pipeline stage failure. Check `error.context` for stage name/index |
 | `SubscriptionRequiredError` | `RegistryClient.resolve()` | Definition requires a higher subscription tier. Check `error.requiredTier`, `error.currentTier`, and `error.upgradeUrl` for upgrade guidance |
-| `IntegrityError` | `RegistryClient.resolve()` (caller-pinned) | A pinned `expectedHash`/`expectedPromptHash` did not match the resolved content, or a prompt pin was supplied for a definition with no rendered prompt. Check `error.kind` (`'yaml'`/`'prompt'`/`'unavailable'`), `error.expected`, `error.actual`. Fail-closed — execution is refused |
+| `IntegrityError` | `RegistryClient.resolve()` (caller-pinned) | A pinned `expectedHash`/`expectedPromptHash` did not match the resolved content, or a prompt pin was supplied for a definition with no rendered prompt. Check `error.kind` (`'yaml'`/`'prompt'`/`'unavailable'`), `error.expected`, `error.actual`, and `error.definitionName`/`error.definitionVersion` (which definition failed). Fail-closed — execution is refused |
 
 ```typescript
-import { ConfigurationError, ModelNotFoundError, ExecutionError, MaxStepsExhaustedError, SubscriptionRequiredError } from '@uluops/core';
+import { ConfigurationError, ModelNotFoundError, CapabilityError, ExecutionError, MaxStepsExhaustedError, WorkflowError, SubscriptionRequiredError } from '@uluops/core';
 
 try {
   const result = await client.runAgent('code-validator', './src');
@@ -723,12 +763,19 @@ try {
     console.error('Check your config:', error.message);
   } else if (error instanceof ModelNotFoundError) {
     console.error('Unknown model alias:', error.message);
+  } else if (error instanceof CapabilityError) {
+    console.error('Model lacks a required capability:', error.message);
   } else if (error instanceof MaxStepsExhaustedError) {
     // Check this BEFORE ExecutionError — it is a subclass.
     console.error(`Hit the step ceiling (${error.steps} steps) — raise maxSteps or narrow the target.`);
   } else if (error instanceof ExecutionError) {
     console.error('Execution failed:', error.message);
     console.log('Partial result:', error.partialResult);
+  } else if (error instanceof WorkflowError) {
+    // Phase gate failure — completed phases are in error.context.partialResult
+    console.error('Workflow gate failed:', error.message);
+  } else if (error instanceof SubscriptionRequiredError) {
+    console.error(`Upgrade required: needs "${error.requiredTier}" (you have "${error.currentTier}"). ${error.upgradeUrl}`);
   }
 }
 ```

package/dist/ai/AIProvider.d.ts

@@ -114,6 +114,18 @@ export declare class AIProvider {
      * 3. Get AI SDK LanguageModel from provider factory
      * 4. Build provider options (cache control, thinking, etc.)
      * 5. Call generateText with maxSteps for automatic tool loop
+     *
+     * Every call is gated through the shared concurrency limiter so wide fan-out
+     * plus per-request retries cannot collectively overrun a provider rate limit.
+     *
+     * @param options - Generation options ({@link AIGenerateOptions}): `model` alias, `system`,
+     *   `messages`/`prompt`, `tools`, `requiredCapabilities`, `providerOptions`, `contextBudget`, etc.
+     * @returns The {@link AIGenerateResult} — generated text, tool calls, usage metrics, and finish reason.
+     * @throws {ConfigurationError} If the requested provider is not configured.
+     * @throws {ModelNotFoundError} If the model alias cannot be resolved by the catalog.
+     * @throws {CapabilityError} If the resolved model lacks a required capability.
+     * @throws {RateLimitError} If the provider returns a 429 after retries are exhausted.
+     * @throws {SdkApiError} For other provider/API errors surfaced by the AI SDK.
      */
     generate(options: AIGenerateOptions): Promise<AIGenerateResult>;
     private generateInner;

package/dist/ai/AIProvider.d.ts.map

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

package/dist/ai/AIProvider.js

@@ -77,6 +77,18 @@ export class AIProvider {
      * 3. Get AI SDK LanguageModel from provider factory
      * 4. Build provider options (cache control, thinking, etc.)
      * 5. Call generateText with maxSteps for automatic tool loop
+     *
+     * Every call is gated through the shared concurrency limiter so wide fan-out
+     * plus per-request retries cannot collectively overrun a provider rate limit.
+     *
+     * @param options - Generation options ({@link AIGenerateOptions}): `model` alias, `system`,
+     *   `messages`/`prompt`, `tools`, `requiredCapabilities`, `providerOptions`, `contextBudget`, etc.
+     * @returns The {@link AIGenerateResult} — generated text, tool calls, usage metrics, and finish reason.
+     * @throws {ConfigurationError} If the requested provider is not configured.
+     * @throws {ModelNotFoundError} If the model alias cannot be resolved by the catalog.
+     * @throws {CapabilityError} If the resolved model lacks a required capability.
+     * @throws {RateLimitError} If the provider returns a 429 after retries are exhausted.
+     * @throws {SdkApiError} For other provider/API errors surfaced by the AI SDK.
      */
     async generate(options) {
         // Gate every generation through the shared concurrency limiter so that

package/dist/ai/AIProvider.js.map

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

package/dist/ai/ModelCatalog.d.ts

@@ -53,16 +53,24 @@ export declare class ModelCatalog {
      *
      * @param input - Alias ('sonnet'), tier ('premium'), or 'provider:modelId'
      * @param opts - Resolution options (capability checks, provider preference)
+     * @returns The fully-qualified {@link ResolvedModel} — `provider`, `modelId`,
+     *   `providerModelId`, tier, and the resolved capability set.
      * @throws {ModelNotFoundError} If alias/model cannot be resolved
      * @throws {CapabilityError} If model lacks required capabilities
      */
     resolve(input: string, opts?: ResolveOptions): Promise<ResolvedModel>;
     /**
-     * List all available aliases
+     * List all available model aliases from the registry.
+     *
+     * @returns The array of {@link RegistryModelAlias} (alias → provider/model mappings).
      */
     listAliases(): Promise<RegistryModelAlias[]>;
     /**
-     * List available models, optionally filtered
+     * List available models, optionally filtered.
+     *
+     * @param filter - Optional filters: `provider`, `tier`, and `capability`
+     *   (a key of {@link ModelCapabilities}, e.g. `'tools'`, `'extendedThinking'`).
+     * @returns The matching array of {@link Model} entries from the registry.
      */
     listModels(filter?: {
         provider?: string;

package/dist/ai/ModelCatalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ModelCatalog.d.ts","sourceRoot":"","sources":["../../src/ai/ModelCatalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,IAAI,WAAW,EAC7B,KAAK,EACL,UAAU,IAAI,kBAAkB,EAEhC,iBAAiB,EACjB,SAAS,EACV,MAAM,sBAAsB,CAAC;AAG9B;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IAEjB,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAEhB,4CAA4C;IAC5C,eAAe,EAAE,MAAM,CAAC;IAExB,qCAAqC;IACrC,IAAI,EAAE,SAAS,CAAC;IAEhB,yBAAyB;IACzB,YAAY,EAAE,iBAAiB,CAAC;IAEhC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0CAA0C;IAC1C,oBAAoB,CAAC,EAAE,KAAK,CAAC,MAAM,iBAAiB,CAAC,CAAC;IAEtD,uDAAuD;IACvD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAeD;;;;;;;;;;GAUG;AACH,qBAAa,YAAY;IAIX,OAAO,CAAC,GAAG;IAHvB,OAAO,CAAC,UAAU,CAAsC;IACxD,OAAO,CAAC,UAAU,CAA4B;gBAE1B,GAAG,EAAE,WAAW;IAEpC;;;;;;;OAOG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAwB3E;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAKlD;;OAEG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE;QACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,SAAS,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,iBAAiB,CAAC;KACtC,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAKpB;;OAEG;IACH,OAAO,IAAI,IAAI;YASD,eAAe;YAsCf,YAAY;YAcZ,aAAa;YAgCb,QAAQ;IActB,iEAAiE;IACjE,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,oBAAoB;CAe7B"}
+{"version":3,"file":"ModelCatalog.d.ts","sourceRoot":"","sources":["../../src/ai/ModelCatalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,IAAI,WAAW,EAC7B,KAAK,EACL,UAAU,IAAI,kBAAkB,EAEhC,iBAAiB,EACjB,SAAS,EACV,MAAM,sBAAsB,CAAC;AAG9B;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IAEjB,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAEhB,4CAA4C;IAC5C,eAAe,EAAE,MAAM,CAAC;IAExB,qCAAqC;IACrC,IAAI,EAAE,SAAS,CAAC;IAEhB,yBAAyB;IACzB,YAAY,EAAE,iBAAiB,CAAC;IAEhC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0CAA0C;IAC1C,oBAAoB,CAAC,EAAE,KAAK,CAAC,MAAM,iBAAiB,CAAC,CAAC;IAEtD,uDAAuD;IACvD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAwBD;;;;;;;;;;GAUG;AACH,qBAAa,YAAY;IAIX,OAAO,CAAC,GAAG;IAHvB,OAAO,CAAC,UAAU,CAAsC;IACxD,OAAO,CAAC,UAAU,CAA4B;gBAE1B,GAAG,EAAE,WAAW;IAEpC;;;;;;;;;OASG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAwB3E;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAKlD;;;;;;OAMG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE;QACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,SAAS,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,iBAAiB,CAAC;KACtC,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAKpB;;OAEG;IACH,OAAO,IAAI,IAAI;YASD,eAAe;YAsCf,YAAY;YAcZ,aAAa;YAgCb,QAAQ;IActB,iEAAiE;IACjE,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,oBAAoB;CAe7B"}

package/dist/ai/ModelCatalog.js

@@ -1,10 +1,19 @@
 import { ModelNotFoundError, CapabilityError } from '../errors/index.js';
 const VALID_TIERS = ['budget', 'standard', 'premium', 'reasoning'];
+// Capabilities assumed for models ABSENT from the registry — reached only on two
+// paths: an unregistered explicit provider:modelId (resolveExplicit) and an alias
+// whose resolution carries no model object (toResolvedModel). Registered models and
+// tier resolution use the registry's own capabilities.
 const DEFAULT_CAPABILITIES = {
     vision: false,
     tools: true,
     streaming: true,
     extendedThinking: false,
+    // Default-deny is intentional, not a placeholder: with no registry data we can't
+    // know a model supports JSON-schema structured output, and assuming true produces
+    // hard API errors when wrong. false routes to text extraction, which works for any
+    // model emitting a JSON fence (and is non-destructive since the Option B extraction
+    // fix). Register the model to opt it into structured output. Do NOT flip to true.
     structuredOutput: false,
     // Absence/true = allowed. Only false (set in the catalog for Google/Gemini)
     // disables structured output when tools are present.
@@ -33,6 +42,8 @@ export class ModelCatalog {
      *
      * @param input - Alias ('sonnet'), tier ('premium'), or 'provider:modelId'
      * @param opts - Resolution options (capability checks, provider preference)
+     * @returns The fully-qualified {@link ResolvedModel} — `provider`, `modelId`,
+     *   `providerModelId`, tier, and the resolved capability set.
      * @throws {ModelNotFoundError} If alias/model cannot be resolved
      * @throws {CapabilityError} If model lacks required capabilities
      */
@@ -56,14 +67,20 @@ export class ModelCatalog {
             `Use catalog.listAliases() to see available aliases.`);
     }
     /**
-     * List all available aliases
+     * List all available model aliases from the registry.
+     *
+     * @returns The array of {@link RegistryModelAlias} (alias → provider/model mappings).
      */
     async listAliases() {
         const result = await this.sdk.models.listAliases();
         return result.aliases;
     }
     /**
-     * List available models, optionally filtered
+     * List available models, optionally filtered.
+     *
+     * @param filter - Optional filters: `provider`, `tier`, and `capability`
+     *   (a key of {@link ModelCapabilities}, e.g. `'tools'`, `'extendedThinking'`).
+     * @returns The matching array of {@link Model} entries from the registry.
      */
     async listModels(filter) {
         const result = await this.sdk.models.list(filter);

package/dist/ai/ModelCatalog.js.map

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

package/dist/ai/TokenBudgetTracker.d.ts

@@ -28,6 +28,8 @@ export declare class TokenBudgetTracker {
      * so the value reflects whether the run *ended* in forced wrap-up — a run
      * that latched then recovered is not left flagged. Read by AgentExecutor to
      * emit a `budget.forced-wrap-up` degradation marker.
+     *
+     * @param engaged - `true` if the wrap-up latch is currently engaged, `false` if released.
      */
     markForcedWrapUp(engaged: boolean): void;
     /** Whether the wrap-up latch was engaged at the end of the run. */
@@ -35,8 +37,10 @@ export declare class TokenBudgetTracker {
     /**
      * Record token usage from a completed step.
      *
-     * `inputTokens` is the full context window size for the latest API call
-     * (replaces previous value). `outputTokens` is incremental (accumulated).
+     * @param inputTokens - Full context window size for the latest API call.
+     *   This **replaces** the prior value (it is the total, not a delta), because
+     *   it represents the whole input window the next call will carry.
+     * @param outputTokens - Output tokens for this step; **accumulated** across steps.
      */
     update(inputTokens: number, outputTokens: number): void;
     /**

package/dist/ai/TokenBudgetTracker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TokenBudgetTracker.d.ts","sourceRoot":"","sources":["../../src/ai/TokenBudgetTracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,qBAAa,kBAAkB;IAQjB,OAAO,CAAC,MAAM;IAP1B,mEAAmE;IACnE,OAAO,CAAC,oBAAoB,CAAK;IACjC,gDAAgD;IAChD,OAAO,CAAC,gBAAgB,CAAK;IAC7B,qEAAqE;IACrE,OAAO,CAAC,gBAAgB,CAAS;gBAEb,MAAM,EAAE,MAAM;IAElC;;;;;;OAMG;IACH,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIxC,mEAAmE;IACnE,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED;;;;;OAKG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAKvD;;;;;OAKG;IACH,SAAS,IAAI;QACX,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;KACrB;IAeD;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;CAG5C"}
+{"version":3,"file":"TokenBudgetTracker.d.ts","sourceRoot":"","sources":["../../src/ai/TokenBudgetTracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,qBAAa,kBAAkB;IAQjB,OAAO,CAAC,MAAM;IAP1B,mEAAmE;IACnE,OAAO,CAAC,oBAAoB,CAAK;IACjC,gDAAgD;IAChD,OAAO,CAAC,gBAAgB,CAAK;IAC7B,qEAAqE;IACrE,OAAO,CAAC,gBAAgB,CAAS;gBAEb,MAAM,EAAE,MAAM;IAElC;;;;;;;;OAQG;IACH,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIxC,mEAAmE;IACnE,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAKvD;;;;;OAKG;IACH,SAAS,IAAI;QACX,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;KACrB;IAeD;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;CAG5C"}

package/dist/ai/TokenBudgetTracker.js

@@ -30,6 +30,8 @@ export class TokenBudgetTracker {
      * so the value reflects whether the run *ended* in forced wrap-up — a run
      * that latched then recovered is not left flagged. Read by AgentExecutor to
      * emit a `budget.forced-wrap-up` degradation marker.
+     *
+     * @param engaged - `true` if the wrap-up latch is currently engaged, `false` if released.
      */
     markForcedWrapUp(engaged) {
         this.forcedWrapUpFlag = engaged;
@@ -41,8 +43,10 @@ export class TokenBudgetTracker {
     /**
      * Record token usage from a completed step.
      *
-     * `inputTokens` is the full context window size for the latest API call
-     * (replaces previous value). `outputTokens` is incremental (accumulated).
+     * @param inputTokens - Full context window size for the latest API call.
+     *   This **replaces** the prior value (it is the total, not a delta), because
+     *   it represents the whole input window the next call will carry.
+     * @param outputTokens - Output tokens for this step; **accumulated** across steps.
      */
     update(inputTokens, outputTokens) {
         this.currentContextTokens = inputTokens;

package/dist/ai/TokenBudgetTracker.js.map

@@ -1 +1 @@
-{"version":3,"file":"TokenBudgetTracker.js","sourceRoot":"","sources":["../../src/ai/TokenBudgetTracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,kBAAkB;IAQT;IAPpB,mEAAmE;IAC3D,oBAAoB,GAAG,CAAC,CAAC;IACjC,gDAAgD;IACxC,gBAAgB,GAAG,CAAC,CAAC;IAC7B,qEAAqE;IAC7D,gBAAgB,GAAG,KAAK,CAAC;IAEjC,YAAoB,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAEtC;;;;;;OAMG;IACH,gBAAgB,CAAC,OAAgB;QAC/B,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC;IAClC,CAAC;IAED,mEAAmE;IACnE,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,WAAmB,EAAE,YAAoB;QAC9C,IAAI,CAAC,oBAAoB,GAAG,WAAW,CAAC;QACxC,IAAI,CAAC,gBAAgB,IAAI,YAAY,CAAC;IACxC,CAAC;IAED;;;;;OAKG;IACH,SAAS;QAQP,MAAM,SAAS,GAAG,IAAI,CAAC,oBAAoB,CAAC;QAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;QACvD,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAEtF,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,oBAAoB;YACpC,UAAU,EAAE,IAAI,CAAC,gBAAgB;YACjC,SAAS;YACT,SAAS;YACT,WAAW;SACZ,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,SAAiB;QAC/B,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,oBAAoB,IAAI,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;IACjF,CAAC;CACF"}
+{"version":3,"file":"TokenBudgetTracker.js","sourceRoot":"","sources":["../../src/ai/TokenBudgetTracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,kBAAkB;IAQT;IAPpB,mEAAmE;IAC3D,oBAAoB,GAAG,CAAC,CAAC;IACjC,gDAAgD;IACxC,gBAAgB,GAAG,CAAC,CAAC;IAC7B,qEAAqE;IAC7D,gBAAgB,GAAG,KAAK,CAAC;IAEjC,YAAoB,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAEtC;;;;;;;;OAQG;IACH,gBAAgB,CAAC,OAAgB;QAC/B,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC;IAClC,CAAC;IAED,mEAAmE;IACnE,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,WAAmB,EAAE,YAAoB;QAC9C,IAAI,CAAC,oBAAoB,GAAG,WAAW,CAAC;QACxC,IAAI,CAAC,gBAAgB,IAAI,YAAY,CAAC;IACxC,CAAC;IAED;;;;;OAKG;IACH,SAAS;QAQP,MAAM,SAAS,GAAG,IAAI,CAAC,oBAAoB,CAAC;QAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;QACvD,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAEtF,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,oBAAoB;YACpC,UAAU,EAAE,IAAI,CAAC,gBAAgB;YACjC,SAAS;YACT,SAAS;YACT,WAAW;SACZ,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,SAAiB;QAC/B,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,oBAAoB,IAAI,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;IACjF,CAAC;CACF"}

package/dist/analysis/AnalysisSummaryExtractor.d.ts

@@ -39,6 +39,23 @@ export declare class AnalysisSummaryExtractor {
      * @throws {Error} if the analysis block JSON is malformed (propagated from JSON.parse)
      */
     extract(result: AgentResult, resolved: ResolvedDefinition): AnalysisExtractionResult;
+    /**
+     * Resolve the analysis block, preferring the rawOutput ```json fence (the
+     * unchanged primary path) and falling back to the untruncated `rawJson.analysis`
+     * when the fence is absent.
+     *
+     * `rawOutput` is capped at MAX_RAW_OUTPUT_BYTES in AgentExecutor for storage/
+     * display; a report exceeding that cap is clipped at the END, dropping the closing
+     * ```json fence — so `parseAnalysisBlock` finds nothing and analysis_summary/
+     * analysis_records would silently vanish on an otherwise successful run. `rawJson`
+     * holds the SAME parsed fence object captured by OutputExtractor from the full,
+     * untruncated output, so `rawJson.analysis` recovers the block regardless of the
+     * cap. The fence stays primary so non-truncated runs are byte-for-byte unchanged.
+     * (tracker d03bdb43)
+     */
+    private resolveAnalysisBlock;
+    /** Extract the `analysis` sub-object from the untruncated rawJson, if present. */
+    private analysisFromRawJson;
     private buildSummary;
     /**
      * Parse the JSON code fence from the agent's markdown report.
@@ -94,11 +111,22 @@ export declare class AnalysisSummaryExtractor {
     /** Validate that a reshaped section has the required fields for its declared type. */
     private validateSectionShape;
     /**
-     * Build analysis records with 4-tier precedence:
-     * 1. Analysis block records (from JSON code fence — richest: typed, meaningful IDs)
-     * 2. Structured output analysisRecords (from agentOutputSchema — typed, meaningful IDs)
-     * 3. Derived from exploration maps (inventory items, agenda questions, etc.)
-     * 4. Auto-generated from recommendations (fallback — evidence_finding, hash IDs)
+     * Build analysis records via a first-non-empty-tier-wins cascade. The tiers are
+     * mutually-exclusive *representations* of the same findings, not additive sources —
+     * an agent emits records in exactly one form, and the highest-fidelity present form
+     * wins. (First-wins, not merge, so a finding expressed in two forms isn't counted
+     * twice.) Each tier is the primary source for a different agent class, so the
+     * ordering is a contract, not a convenience — reordering or removing a tier changes
+     * the persisted record shape for whichever class depends on it. The precedence
+     * boundaries are locked by the "record tier precedence" tests; keep them in sync.
+     *
+     * 1. Analysis block records (JSON code fence) — analysts/validators in report mode;
+     *    richest: typed records with meaningful IDs.
+     * 2. Structured output analysisRecords (agentOutputSchema) — analysts/validators in
+     *    structured-output mode; typed, meaningful IDs.
+     * 3. Derived from exploration maps — explorers (inventory items, agenda questions).
+     * 4. Auto-generated from recommendations — fallback for any agent that emitted none
+     *    of the above (evidence_finding, hash IDs).
      */
     private buildAnalysisRecords;
     /**

package/dist/analysis/AnalysisSummaryExtractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AnalysisSummaryExtractor.d.ts","sourceRoot":"","sources":["../../src/analysis/AnalysisSummaryExtractor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAiC,MAAM,iBAAiB,CAAC;AAChH,OAAO,KAAK,EAAE,WAAW,EAAmB,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAmB/D;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,OAAO,EAAE,mBAAmB,EAAE,CAAC;CAChC;AAeD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,wBAAwB;IACnC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,kBAAkB,GAAG,wBAAwB;IAWpF,OAAO,CAAC,YAAY;IAsBpB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IA6B1B;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAqB/B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAuB3B;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;IA8B1B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAkB5B;;;OAGG;IACH,OAAO,CAAC,0BAA0B;IAalC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAahC;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IA0B9B;;;OAGG;IACH,OAAO,CAAC,cAAc;IAiCtB,sFAAsF;IACtF,OAAO,CAAC,oBAAoB;IAiB5B;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IA+C5B;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAwBhC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,gCAAgC;IAuDxC;;;OAGG;IACH,OAAO,CAAC,eAAe;IAevB;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CASzC;IAEF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAqD;IAEnG,OAAO,CAAC,uBAAuB;IAI/B,OAAO,CAAC,mBAAmB;IAM3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;;OAGG;IACH,OAAO,CAAC,YAAY;CAIrB"}
+{"version":3,"file":"AnalysisSummaryExtractor.d.ts","sourceRoot":"","sources":["../../src/analysis/AnalysisSummaryExtractor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAiC,MAAM,iBAAiB,CAAC;AAChH,OAAO,KAAK,EAAE,WAAW,EAAmB,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAmB/D;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,OAAO,EAAE,mBAAmB,EAAE,CAAC;CAChC;AAeD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,wBAAwB;IACnC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,kBAAkB,GAAG,wBAAwB;IASpF;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,oBAAoB;IAI5B,kFAAkF;IAClF,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,YAAY;IAsBpB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IA6B1B;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAqB/B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAuB3B;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;IA8B1B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAkB5B;;;OAGG;IACH,OAAO,CAAC,0BAA0B;IAalC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAahC;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IA0B9B;;;OAGG;IACH,OAAO,CAAC,cAAc;IAiCtB,sFAAsF;IACtF,OAAO,CAAC,oBAAoB;IAiB5B;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,oBAAoB;IA+C5B;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAwBhC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,gCAAgC;IAuDxC;;;OAGG;IACH,OAAO,CAAC,eAAe;IAevB;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CASzC;IAEF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAqD;IAEnG,OAAO,CAAC,uBAAuB;IAI/B,OAAO,CAAC,mBAAmB;IAM3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;;OAGG;IACH,OAAO,CAAC,YAAY;CAIrB"}