@uluops/core 0.5.0

package/dist/errors/index.js

@@ -0,0 +1,93 @@
+import { UluOpsError } from './UluOpsError.js';
+export { UluOpsError } from './UluOpsError.js';
+/** Thrown when agent/command/workflow execution fails. May include a partial result. */
+export class ExecutionError extends UluOpsError {
+    partialResult;
+    constructor(message, partialResult, options) {
+        super(message, options);
+        this.partialResult = partialResult;
+        this.name = 'ExecutionError';
+    }
+}
+/** Thrown when a preflight check fails (e.g. missing env var, unavailable tool). */
+export class PreflightError extends UluOpsError {
+    check;
+    details;
+    constructor(message, check, details) {
+        super(message);
+        this.check = check;
+        this.details = details;
+        this.name = 'PreflightError';
+    }
+}
+/** Thrown when the SDK is misconfigured (missing API key, invalid provider, etc.). */
+export class ConfigurationError extends UluOpsError {
+    constructor(message) {
+        super(message);
+        this.name = 'ConfigurationError';
+    }
+}
+/** Thrown when a model alias cannot be resolved via the registry model catalog. */
+export class ModelNotFoundError extends UluOpsError {
+    constructor(message) {
+        super(message);
+        this.name = 'ModelNotFoundError';
+    }
+}
+/** Thrown when a resolved model lacks a required capability (e.g. tools, vision, extendedThinking). */
+export class CapabilityError extends UluOpsError {
+    constructor(message) {
+        super(message);
+        this.name = 'CapabilityError';
+    }
+}
+/**
+ * Error codes for validation service errors
+ */
+export const ValidationErrorCodes = {
+    VALIDATION_ERROR: 'VALIDATION_ERROR',
+    NOT_FOUND: 'NOT_FOUND',
+    CONFLICT: 'CONFLICT',
+    RATE_LIMITED: 'RATE_LIMITED',
+    REQUEST_FAILED: 'REQUEST_FAILED',
+    SUBMISSION_FAILED: 'SUBMISSION_FAILED',
+    UNAUTHORIZED: 'UNAUTHORIZED',
+    FORBIDDEN: 'FORBIDDEN',
+};
+/** Thrown when the validation service rejects a submission or returns an error. */
+export class ValidationError extends UluOpsError {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.name = 'ValidationError';
+        this.code = code;
+    }
+}
+/** Thrown when a workflow phase gate fails. Includes partial results for completed phases. */
+export class WorkflowError extends UluOpsError {
+    context;
+    constructor(message, context) {
+        super(message);
+        this.context = context;
+        this.name = 'WorkflowError';
+    }
+}
+/** Thrown when a pipeline stage fails or a pipeline-level error occurs. */
+export class PipelineError extends UluOpsError {
+    constructor(message) {
+        super(message);
+        this.name = 'PipelineError';
+    }
+}
+/** Thrown when structured output cannot be extracted from an LLM response. */
+export class ParseError extends UluOpsError {
+    contentPreview;
+    constructor(message, contentPreview) {
+        super(message);
+        this.name = 'ParseError';
+        this.contentPreview = contentPreview;
+    }
+}
+// Re-exports from @uluops/sdk-core
+export { SdkApiError, RateLimitError, UnauthorizedError, ForbiddenError, NotFoundError, ServiceUnavailableError, NetworkError, TimeoutError, } from '@uluops/sdk-core/errors';
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

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

package/dist/executor/AgentExecutor.d.ts

@@ -0,0 +1,57 @@
+import type { AIProvider } from '../ai/AIProvider.js';
+import type { ResolvedConfig } from '../types/config.js';
+import type { ResolvedDefinition } from '../types/registry.js';
+import type { ExecutionInput, ExecutionOptions } from '../types/execution.js';
+import type { AgentResult } from '../types/agent.js';
+import type { Logger } from '@uluops/sdk-core';
+/**
+ * Primary executor for single-agent runs.
+ *
+ * Orchestrates:
+ * 1. Prompt rendering from agent definition
+ * 2. Tool setup and adaptation for AI SDK
+ * 3. LLM generation via AIProvider (tool loop handled by AI SDK)
+ * 4. Output parsing and result construction
+ *
+ * Used directly by `UluOpsClient.runAgent()` and delegated to by
+ * `CommandExecutor` for single-agent commands.
+ */
+export declare class AgentExecutor {
+    private config;
+    private aiProvider;
+    private logger;
+    private outputExtractor;
+    constructor(config: ResolvedConfig, aiProvider: AIProvider, logger: Logger);
+    /**
+     * Execute an agent with optional runtime options
+     */
+    execute(resolved: ResolvedDefinition, input: ExecutionInput, options?: ExecutionOptions): Promise<AgentResult>;
+    /**
+     * Merge agent defaults with runtime options.
+     * Priority: options > agent defaults > config defaults
+     */
+    private resolveContext;
+    private resolveThresholds;
+    /**
+     * Build the initial user message with project structure context
+     */
+    private buildInitialMessage;
+    private scanProjectStructure;
+    private detectLanguages;
+    private buildTreePreview;
+    /**
+     * Get the appropriate output schema for an agent type.
+     */
+    private getOutputSchema;
+    /**
+     * Map structured output to ParsedOutput.
+     * Null values from .nullable() fields are converted to undefined.
+     */
+    private mapStructuredOutput;
+    /**
+     * Flatten parsed categories → flat Recommendation array
+     */
+    private flattenRecommendations;
+    private calculateEffectiveTokens;
+}
+//# sourceMappingURL=AgentExecutor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AgentExecutor.d.ts","sourceRoot":"","sources":["../../src/executor/AgentExecutor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAUtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAqC,MAAM,sBAAsB,CAAC;AAClG,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAA4C,MAAM,uBAAuB,CAAC;AACxH,OAAO,KAAK,EAAE,WAAW,EAA6C,MAAM,mBAAmB,CAAC;AAIhG,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE/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;IAmJvB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAsBtB,OAAO,CAAC,iBAAiB;IAUzB;;OAEG;YACW,mBAAmB;YAsBnB,oBAAoB;IA4BlC,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAcvB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAyB3B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA0B9B,OAAO,CAAC,wBAAwB;CAOjC"}

package/dist/executor/AgentExecutor.js

@@ -0,0 +1,331 @@
+import { ToolHandler, extToLanguage } from './ToolHandler.js';
+import { ToolAdapter } from '../ai/ToolAdapter.js';
+import { TokenBudgetTracker } from '../ai/TokenBudgetTracker.js';
+import { OutputExtractor } from '../parser/OutputExtractor.js';
+import { validatorOutputSchema, executorOutputSchema, genericOutputSchema, } from '../parser/outputSchemas.js';
+/**
+ * Primary executor for single-agent runs.
+ *
+ * Orchestrates:
+ * 1. Prompt rendering from agent definition
+ * 2. Tool setup and adaptation for AI SDK
+ * 3. LLM generation via AIProvider (tool loop handled by AI SDK)
+ * 4. Output parsing and result construction
+ *
+ * Used directly by `UluOpsClient.runAgent()` and delegated to by
+ * `CommandExecutor` for single-agent commands.
+ */
+export class AgentExecutor {
+    config;
+    aiProvider;
+    logger;
+    outputExtractor = new OutputExtractor();
+    constructor(config, aiProvider, logger) {
+        this.config = config;
+        this.aiProvider = aiProvider;
+        this.logger = logger;
+    }
+    /**
+     * Execute an agent with optional runtime options
+     */
+    async execute(resolved, input, options) {
+        const startTime = Date.now();
+        const agentType = resolved.agentType ?? 'validator';
+        this.logger.info(`Agent: ${resolved.name} v${resolved.version} (${agentType})`);
+        this.logger.debug(`Target: ${input.target}`);
+        // 1. Merge options with agent defaults
+        const context = this.resolveContext(resolved, options);
+        this.logger.debug(`Context: model=${context.model}, maxSteps=${context.maxSteps}, temp=${context.temperature}, timeout=${context.timeoutMs}ms`);
+        // 2. Determine if shell tool should be enabled (opt-in via agent tools list)
+        const runtime = resolved.runtime;
+        const agentTools = runtime.interface?.tools;
+        let additionalTools;
+        if (agentTools?.includes('bash')) {
+            // Resolve model early to determine the provider for shell tool selection
+            const modelInput = options?.model ?? runtime.defaults?.model ?? this.config.ai.modelOverride ?? 'sonnet';
+            const resolvedModel = await this.aiProvider.resolveModel(modelInput);
+            additionalTools = this.aiProvider.createProviderShellTool(resolvedModel.provider, input.target, context.timeoutMs);
+        }
+        // 3. Setup tool handler, budget tracker, and AI SDK tool adapter
+        const toolHandler = new ToolHandler(input.target, this.logger);
+        const contextBudget = this.config.contextBudget;
+        const budgetTracker = new TokenBudgetTracker(contextBudget);
+        const toolAdapter = new ToolAdapter(toolHandler, additionalTools, budgetTracker);
+        // 4. Get the system prompt
+        const systemPrompt = runtime.prompt;
+        // 5. Build initial context message
+        const initialMessage = await this.buildInitialMessage(input, toolHandler);
+        // 6. Execute via AI SDK (tool loop handled automatically)
+        const outputSchema = this.getOutputSchema(agentType);
+        const result = await this.aiProvider.generate({
+            model: context.model,
+            system: systemPrompt,
+            prompt: initialMessage,
+            tools: toolAdapter.getTools(),
+            maxTokens: context.maxTokens,
+            maxSteps: context.maxSteps,
+            timeoutMs: context.timeoutMs,
+            temperature: context.temperature,
+            contextBudget,
+            budgetTracker,
+            output: outputSchema,
+        });
+        // 6b. Log raw LLM output for cross-model diagnosis
+        const rawText = result.text ?? '';
+        this.logger.debug(`Raw output: ${rawText.length} chars, finishReason=${result.finishReason}`);
+        if (rawText.length > 0 && rawText.length <= 5000) {
+            this.logger.debug(`Raw output text:\n${rawText}`);
+        }
+        else if (rawText.length > 5000) {
+            this.logger.debug(`Raw output (last 2000 chars):\n${rawText.slice(-2000)}`);
+        }
+        else {
+            this.logger.warn('Empty output — model likely hit maxSteps while still calling tools');
+        }
+        // 7. Parse output — prefer structured output, fall back to extraction
+        let parsed;
+        let extraction;
+        if (result.structuredOutput) {
+            parsed = this.mapStructuredOutput(result.structuredOutput, agentType);
+            extraction = {
+                output: parsed,
+                method: 'structured_output',
+                confidence: 1.0,
+                warnings: [],
+            };
+            this.logger.info('Output extraction: method=structured_output, confidence=1.0');
+        }
+        else {
+            extraction = this.outputExtractor.extractWithMetadata(result.text, agentType);
+            parsed = extraction.output;
+            this.logger.info(`Output extraction: method=${extraction.method}, confidence=${extraction.confidence}`);
+        }
+        this.logger.debug(`Parsed output: decision=${parsed.decision}, score=${parsed.score}, hasRawJson=${!!parsed.rawJson}`);
+        if (parsed.rawJson) {
+            const keys = Object.keys(parsed.rawJson);
+            this.logger.debug(`Raw JSON keys: [${keys.join(', ')}]`);
+            this.logger.debug(`Raw JSON sample: ${JSON.stringify(parsed.rawJson).slice(0, 1000)}`);
+        }
+        if (extraction.warnings.length > 0) {
+            this.logger.warn(`Extraction warnings: ${extraction.warnings.join('; ')}`);
+        }
+        // 7. Build recommendations
+        const recommendations = this.flattenRecommendations(parsed, resolved.name);
+        this.logger.info(`Result: decision=${parsed.decision}, score=${parsed.score ?? 'N/A'}, recommendations=${recommendations.length}`);
+        // 8. Compute metrics
+        const durationMs = Date.now() - startTime;
+        const metrics = {
+            inputTokens: result.usage.input_tokens,
+            outputTokens: result.usage.output_tokens,
+            cacheCreationTokens: result.usage.cache_creation_input_tokens,
+            cacheReadTokens: result.usage.cache_read_input_tokens,
+            thinkingTokens: result.usage.thinking_tokens,
+            totalEffectiveTokens: this.calculateEffectiveTokens(result.usage),
+            durationMs,
+            model: result.model,
+            toolCallCount: result.toolCallCount,
+        };
+        // 9. Return discriminated result
+        if (agentType === 'validator') {
+            return {
+                type: 'agent',
+                agentType: 'validator',
+                name: resolved.name,
+                version: resolved.version,
+                definitionHash: resolved.hash,
+                decision: parsed.decision ?? 'FAIL',
+                score: parsed.score ?? 0,
+                maxScore: parsed.maxScore ?? 100,
+                threshold: context.thresholds?.pass,
+                categories: parsed.categories?.map(c => ({
+                    name: c.name,
+                    score: c.score,
+                    maxScore: c.maxPoints,
+                    findings: c.findings,
+                })),
+                recommendations,
+                durationMs,
+                metrics,
+                rawOutput: rawText || undefined,
+            };
+        }
+        return {
+            type: 'agent',
+            agentType: 'executor',
+            name: resolved.name,
+            version: resolved.version,
+            definitionHash: resolved.hash,
+            decision: parsed.decision ?? 'FAILED',
+            artifacts: parsed.artifacts,
+            recommendations,
+            durationMs,
+            metrics,
+            rawOutput: rawText || undefined,
+        };
+    }
+    /**
+     * Merge agent defaults with runtime options.
+     * Priority: options > agent defaults > config defaults
+     */
+    resolveContext(resolved, options) {
+        const runtime = resolved.runtime;
+        const defaults = runtime?.defaults;
+        return {
+            model: options?.model ?? defaults?.model ?? this.config.ai.modelOverride ?? 'sonnet',
+            maxTokens: options?.maxTokens ?? defaults?.maxTokens ?? 8192,
+            timeoutMs: options?.timeoutMs ?? defaults?.timeout ?? this.config.timeout ?? 300_000,
+            temperature: options?.temperature ?? defaults?.temperature ?? 0,
+            maxSteps: options?.maxSteps ?? 50,
+            thresholds: this.resolveThresholds(options?.thresholds, defaults && 'thresholds' in defaults ? defaults.thresholds : undefined),
+            trackResults: options?.trackResults ?? this.config.trackingEnabled,
+            project: options?.project ?? this.config.defaultProject,
+        };
+    }
+    resolveThresholds(optThresholds, defThresholds) {
+        const pass = optThresholds?.pass ?? defThresholds?.pass;
+        const warn = optThresholds?.warn ?? defThresholds?.warn;
+        if (pass === undefined && warn === undefined)
+            return undefined;
+        return { pass: pass ?? 75, warn: warn ?? 50 };
+    }
+    /**
+     * Build the initial user message with project structure context
+     */
+    async buildInitialMessage(input, toolHandler) {
+        const stats = await this.scanProjectStructure(toolHandler);
+        return [
+            'Analyze the following project:',
+            '',
+            `Target: ${input.target}`,
+            '',
+            'Project Structure:',
+            stats.tree,
+            '',
+            'Statistics:',
+            `- Files: ${stats.fileCount}`,
+            `- Languages: ${stats.languages.join(', ')}`,
+            '',
+            `Options: ${JSON.stringify(input.options ?? {})}`,
+            '',
+            'Use the provided tools to read files and analyze the codebase.',
+            'Produce your assessment in the required JSON output format.',
+        ].join('\n');
+    }
+    async scanProjectStructure(toolHandler) {
+        const files = await toolHandler.fulfill({
+            id: 'init',
+            name: 'list_files',
+            input: { path: '.', pattern: '**/*', max_results: 100 },
+        });
+        const fileList = files.content.split('\n').filter(Boolean);
+        const languages = this.detectLanguages(fileList);
+        const tree = this.buildTreePreview(fileList, 20);
+        // Count may include "... and N more files" line
+        const countLine = fileList.find(l => l.startsWith('... and '));
+        let fileCount = fileList.length;
+        if (countLine) {
+            const match = /\.\.\. and (\d+) more files/.exec(countLine);
+            if (match) {
+                fileCount = fileList.length - 1 + parseInt(match[1], 10);
+            }
+        }
+        return { tree, fileCount, languages };
+    }
+    detectLanguages(files) {
+        const detected = new Set();
+        for (const file of files) {
+            // Strip metadata suffix: "file.ts (3.8 KB, 120 lines)" → "file.ts"
+            const fileName = file.replace(/\s+\(.*\)$/, '');
+            const dotIdx = fileName.lastIndexOf('.');
+            if (dotIdx === -1)
+                continue;
+            const ext = fileName.substring(dotIdx);
+            const lang = extToLanguage(ext);
+            if (lang !== 'Unknown')
+                detected.add(lang);
+        }
+        return Array.from(detected);
+    }
+    buildTreePreview(files, maxFiles) {
+        const preview = files.slice(0, maxFiles);
+        const remaining = files.length - maxFiles;
+        let tree = preview.map(f => `  ${f}`).join('\n');
+        if (remaining > 0)
+            tree += `\n  ... and ${remaining} more files`;
+        return tree;
+    }
+    /**
+     * Get the appropriate output schema for an agent type.
+     */
+    getOutputSchema(agentType) {
+        switch (agentType) {
+            case 'validator':
+                return { schema: validatorOutputSchema, name: 'ValidationResult' };
+            case 'executor':
+                return { schema: executorOutputSchema, name: 'ExecutionResult' };
+            case 'analyst':
+            case 'generator':
+            case 'explorer':
+            case 'forecaster':
+                return { schema: genericOutputSchema, name: 'AgentResult' };
+        }
+    }
+    /**
+     * Map structured output to ParsedOutput.
+     * Null values from .nullable() fields are converted to undefined.
+     */
+    mapStructuredOutput(output, agentType) {
+        const base = output;
+        const result = {
+            decision: base.decision,
+            score: base.score,
+            maxScore: base.maxScore,
+            summary: base.summary ?? undefined,
+            rawJson: output,
+        };
+        if (agentType === 'validator') {
+            const v = output;
+            if (v.categories) {
+                result.categories = v.categories;
+            }
+        }
+        else if (agentType === 'executor') {
+            const e = output;
+            if (e.artifacts) {
+                result.artifacts = e.artifacts;
+            }
+        }
+        return result;
+    }
+    /**
+     * Flatten parsed categories → flat Recommendation array
+     */
+    flattenRecommendations(parsed, agentName) {
+        const recommendations = [];
+        for (const category of parsed.categories ?? []) {
+            for (const finding of category.findings ?? []) {
+                for (const issue of finding.issues ?? []) {
+                    recommendations.push({
+                        validator: agentName,
+                        title: issue.title,
+                        priority: issue.priority,
+                        severity: issue.severity,
+                        failureCode: issue.failureCode,
+                        filePath: issue.filePath,
+                        lineNumber: issue.lineNumber,
+                        description: issue.description,
+                    });
+                }
+            }
+        }
+        return recommendations;
+    }
+    calculateEffectiveTokens(usage) {
+        // reasoning_tokens (OpenAI) excluded: already counted within output_tokens by OpenAI's billing.
+        // thinking_tokens (Google) included: charged separately from output_tokens by Google.
+        return usage.input_tokens + usage.output_tokens
+            + (usage.cache_creation_input_tokens ?? 0)
+            + (usage.thinking_tokens ?? 0);
+    }
+}
+//# sourceMappingURL=AgentExecutor.js.map

package/dist/executor/AgentExecutor.js.map

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

package/dist/executor/CommandExecutor.d.ts

@@ -0,0 +1,33 @@
+import type { AgentExecutor } from './AgentExecutor.js';
+import type { RegistryClient } from '../registry/RegistryClient.js';
+import type { ResolvedDefinition } from '../types/registry.js';
+import type { ExecutionInput } from '../types/execution.js';
+import type { CommandResult } from '../types/command.js';
+/**
+ * Executes command definitions.
+ *
+ * - Single-agent commands: delegates to AgentExecutor
+ * - Multi-agent commands: runs agents in sequence, aggregates results
+ *
+ * Handles preflight checks, model/threshold overrides from command definition,
+ * and multi-agent score aggregation.
+ */
+export declare class CommandExecutor {
+    private agentExecutor;
+    private registry;
+    constructor(agentExecutor: AgentExecutor, registry: RegistryClient);
+    /**
+     * Execute a command definition
+     */
+    execute(resolved: ResolvedDefinition, input: ExecutionInput): Promise<CommandResult>;
+    private executeSequentially;
+    /**
+     * Wrap a single agent result as a CommandResult
+     */
+    private wrapAgentResult;
+    /**
+     * Aggregate multiple agent results into a single CommandResult
+     */
+    private aggregateResults;
+}
+//# sourceMappingURL=CommandExecutor.d.ts.map

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

@@ -0,0 +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,EAAkB,MAAM,uBAAuB,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,qBAAqB,CAAC;AAKzE;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAExB,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,QAAQ;gBADR,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,cAAc;IAGlC;;OAEG;IACG,OAAO,CAAC,QAAQ,EAAE,kBAAkB,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;YAmD5E,mBAAmB;IAWjC;;OAEG;IACH,OAAO,CAAC,eAAe;IA4CvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAyFzB"}