@uluops/core 0.5.0

package/dist/client/UluOpsClient.d.ts

@@ -0,0 +1,111 @@
+import type { UluOpsConfig } from '../types/config.js';
+import type { ExecutionInput, ExecutionResult, ExecutionOptions } from '../types/execution.js';
+import type { AgentResult } from '../types/agent.js';
+import type { CommandResult } from '../types/command.js';
+import type { WorkflowResult } from '../types/workflow.js';
+import type { PipelineHandle } from '../types/pipeline.js';
+import type { DefinitionSummary } from '../types/registry.js';
+import type { DefinitionType } from '../types/execution.js';
+import type { RunSubmissionResponse, RunHistoryEntry, ValidationQueryOptions } from '../types/validation.js';
+/**
+ * Unified UluOps SDK client.
+ *
+ * Wires together registry, validation, AI, and execution layers.
+ * Provides type-safe methods for each execution type plus auto-routing.
+ *
+ * Execution methods:
+ * - `runAgent(name, target, options?)` — Direct agent execution with call-time options
+ * - `runCommand(name, input)` — Command execution with saved configuration
+ * - `runWorkflow(name, input)` — Workflow execution
+ * - `run(name, input)` — Auto-detect type and route
+ * - `startPipeline(name, input)` — Async pipeline execution
+ */
+export declare class UluOpsClient {
+    private registry;
+    private validation;
+    private agentExecutor;
+    private commandExecutor;
+    private workflowExecutor;
+    private pipelineExecutor;
+    private config;
+    private logger;
+    constructor(config: UluOpsConfig);
+    /**
+     * Direct agent execution with call-time options.
+     *
+     * Use for interactive/ad-hoc validation, experimentation, and development.
+     * For reproducible CI runs, use `runCommand()` instead.
+     */
+    runAgent(name: string, target: string, options?: ExecutionOptions): Promise<AgentResult>;
+    /**
+     * Execute a saved command configuration.
+     *
+     * Uses model, thresholds, and aggregation from the command definition.
+     * Ideal for CI/CD pipelines and team-standardized validation.
+     */
+    runCommand(name: string, input: ExecutionInput): Promise<CommandResult>;
+    /**
+     * Execute a workflow with multi-phase orchestration.
+     */
+    runWorkflow(name: string, input: ExecutionInput): Promise<WorkflowResult>;
+    /**
+     * 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).
+     */
+    run(name: string, input: ExecutionInput): Promise<ExecutionResult | AgentResult>;
+    /**
+     * Start an async pipeline execution.
+     * Returns a PipelineHandle for monitoring and control.
+     */
+    startPipeline(name: string, input: ExecutionInput): Promise<PipelineHandle>;
+    /** Run the built-in `validate` command against a target. */
+    validate(target: string, options?: Record<string, unknown>): Promise<CommandResult>;
+    /** Run the built-in `security` command against a target. */
+    security(target: string, options?: Record<string, unknown>): Promise<CommandResult>;
+    /** Run the built-in `optimize` command against a target. */
+    optimize(target: string, options?: Record<string, unknown>): Promise<CommandResult>;
+    /** Run the built-in `ship` workflow against a target. */
+    ship(target: string, options?: Record<string, unknown>): Promise<WorkflowResult>;
+    /** Run the built-in `post-implementation` workflow against a target. */
+    postImplementation(target: string, options?: Record<string, unknown>): Promise<WorkflowResult>;
+    /** List available definitions from local files and registry. */
+    list(filter?: {
+        type?: DefinitionType;
+        domain?: string;
+    }): Promise<DefinitionSummary[]>;
+    /** Inspect a definition's metadata and interface. */
+    describe(name: string): Promise<{
+        type: DefinitionType;
+        name: string;
+        version: string;
+        hash: string;
+        interface: Record<string, unknown>;
+    }>;
+    /** Query validation run history for a project. */
+    getHistory(project: string, options?: ValidationQueryOptions): Promise<RunHistoryEntry[]>;
+    /** Get details for a specific validation run by ID. */
+    getRun(runId: string): Promise<RunSubmissionResponse>;
+    /** Preview what a submission would do without saving (dry run). */
+    validateRun(project: string, workflowType: string, result: ExecutionResult): Promise<{
+        wouldCreate: boolean;
+        wouldUpdate: boolean;
+        wouldRegress: boolean;
+        validationErrors: string[];
+    }>;
+    /** Manually submit execution results to the validation service. */
+    submitResults(project: string, workflowType: string, result: ExecutionResult): Promise<RunSubmissionResponse>;
+    private resolveConfig;
+    /**
+     * Resolve AI config with env var fallbacks.
+     *
+     * Default: Anthropic provider with ANTHROPIC_API_KEY env var.
+     * Env var convention: <PROVIDER>_API_KEY (e.g., ANTHROPIC_API_KEY, OPENAI_API_KEY)
+     */
+    private resolveAIConfig;
+    private resolveByRef;
+    private trackIfEnabled;
+    private extractInterface;
+}
+//# sourceMappingURL=UluOpsClient.d.ts.map

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

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

package/dist/client/UluOpsClient.js

@@ -0,0 +1,329 @@
+import { RegistryClient } from '../registry/RegistryClient.js';
+import { ValidationClient } from '../validation/ValidationClient.js';
+import { AIProvider } from '../ai/AIProvider.js';
+import { ModelCatalog } from '../ai/ModelCatalog.js';
+import { AgentExecutor } from '../executor/AgentExecutor.js';
+import { CommandExecutor } from '../executor/CommandExecutor.js';
+import { WorkflowExecutor } from '../executor/WorkflowExecutor.js';
+import { PipelineExecutor } from '../executor/PipelineExecutor.js';
+import { createLogger } from '@uluops/sdk-core';
+import { ConfigurationError } from '../errors/index.js';
+import { parseRef } from '../utils/parseRef.js';
+/** Default request timeout: 5 minutes. Allows for model cold-start + multi-step tool loops in agent execution. */
+const DEFAULT_TIMEOUT_MS = 300_000;
+/**
+ * Unified UluOps SDK client.
+ *
+ * Wires together registry, validation, AI, and execution layers.
+ * Provides type-safe methods for each execution type plus auto-routing.
+ *
+ * Execution methods:
+ * - `runAgent(name, target, options?)` — Direct agent execution with call-time options
+ * - `runCommand(name, input)` — Command execution with saved configuration
+ * - `runWorkflow(name, input)` — Workflow execution
+ * - `run(name, input)` — Auto-detect type and route
+ * - `startPipeline(name, input)` — Async pipeline execution
+ */
+export class UluOpsClient {
+    registry;
+    validation;
+    agentExecutor;
+    commandExecutor;
+    workflowExecutor;
+    pipelineExecutor;
+    config;
+    logger;
+    constructor(config) {
+        this.config = this.resolveConfig(config);
+        this.logger = createLogger('[core]', this.config.debug);
+        const logger = this.logger;
+        this.registry = new RegistryClient(this.config, logger);
+        this.validation = new ValidationClient(this.config);
+        // ModelCatalog resolves aliases via registry (no auto-sync; cache cleared via refresh())
+        const modelCatalog = new ModelCatalog(this.registry.registrySdk);
+        const aiProvider = new AIProvider(this.config, modelCatalog, logger);
+        this.agentExecutor = new AgentExecutor(this.config, aiProvider, logger);
+        this.commandExecutor = new CommandExecutor(this.agentExecutor, this.registry);
+        this.workflowExecutor = new WorkflowExecutor(this.commandExecutor, this.registry);
+        this.pipelineExecutor = new PipelineExecutor(this.workflowExecutor, this.commandExecutor, this.registry);
+    }
+    // ─── Primary Execution Methods ──────────────────────────────────────────
+    /**
+     * Direct agent execution with call-time options.
+     *
+     * Use for interactive/ad-hoc validation, experimentation, and development.
+     * For reproducible CI runs, use `runCommand()` instead.
+     */
+    async runAgent(name, target, options) {
+        const resolved = await this.resolveByRef(name, 'agent');
+        if (resolved.type !== 'agent') {
+            throw new ConfigurationError(`${name} is not an agent (type: ${resolved.type}). Use runCommand() instead.`);
+        }
+        const result = await this.agentExecutor.execute(resolved, { target }, options);
+        await this.trackIfEnabled(result, resolved, 'agent', options);
+        return result;
+    }
+    /**
+     * Execute a saved command configuration.
+     *
+     * Uses model, thresholds, and aggregation from the command definition.
+     * Ideal for CI/CD pipelines and team-standardized validation.
+     */
+    async runCommand(name, input) {
+        const resolved = await this.resolveByRef(name, 'command');
+        if (resolved.type !== 'command') {
+            throw new ConfigurationError(`${name} is not a command (type: ${resolved.type}). Use runAgent() for agents or runWorkflow() for workflows.`);
+        }
+        const result = await this.commandExecutor.execute(resolved, input);
+        await this.trackIfEnabled(result, resolved, 'command');
+        return result;
+    }
+    /**
+     * Execute a workflow with multi-phase orchestration.
+     */
+    async runWorkflow(name, input) {
+        const resolved = await this.resolveByRef(name, 'workflow');
+        if (resolved.type !== 'workflow') {
+            throw new ConfigurationError(`${name} is not a workflow (type: ${resolved.type}). Use runAgent() for agents or runCommand() for commands.`);
+        }
+        const result = await this.workflowExecutor.execute(resolved, input);
+        await this.trackIfEnabled(result, resolved, 'workflow');
+        return result;
+    }
+    /**
+     * 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).
+     */
+    async run(name, input) {
+        const resolved = await this.resolveByRef(name);
+        let result;
+        switch (resolved.type) {
+            case 'agent':
+                result = await this.agentExecutor.execute(resolved, input);
+                break;
+            case 'command':
+                result = await this.commandExecutor.execute(resolved, input);
+                break;
+            case 'workflow':
+                result = await this.workflowExecutor.execute(resolved, input);
+                break;
+            case 'pipeline':
+                result = await this.pipelineExecutor.execute(resolved, input);
+                break;
+            default:
+                throw new ConfigurationError(`Unknown definition type: ${resolved.type}`);
+        }
+        await this.trackIfEnabled(result, resolved, resolved.type);
+        return result;
+    }
+    /**
+     * Start an async pipeline execution.
+     * Returns a PipelineHandle for monitoring and control.
+     */
+    async startPipeline(name, input) {
+        const resolved = await this.resolveByRef(name, 'pipeline');
+        if (resolved.type !== 'pipeline') {
+            throw new ConfigurationError(`${name} is not a pipeline (type: ${resolved.type}). Use runWorkflow() for workflows or runCommand() for commands.`);
+        }
+        return this.pipelineExecutor.start(resolved, input);
+    }
+    // ─── Convenience Methods ────────────────────────────────────────────────
+    /** Run the built-in `validate` command against a target. */
+    async validate(target, options) {
+        return this.runCommand('validate', { target, options });
+    }
+    /** Run the built-in `security` command against a target. */
+    async security(target, options) {
+        return this.runCommand('security', { target, options });
+    }
+    /** Run the built-in `optimize` command against a target. */
+    async optimize(target, options) {
+        return this.runCommand('optimize', { target, options });
+    }
+    /** Run the built-in `ship` workflow against a target. */
+    async ship(target, options) {
+        return this.runWorkflow('ship', { target, options });
+    }
+    /** Run the built-in `post-implementation` workflow against a target. */
+    async postImplementation(target, options) {
+        return this.runWorkflow('post-implementation', { target, options });
+    }
+    // ─── Discovery ──────────────────────────────────────────────────────────
+    /** List available definitions from local files and registry. */
+    async list(filter) {
+        return this.registry.list(filter);
+    }
+    /** Inspect a definition's metadata and interface. */
+    async describe(name) {
+        const resolved = await this.registry.resolve(name);
+        return {
+            type: resolved.type,
+            name: resolved.name,
+            version: resolved.version,
+            hash: resolved.hash,
+            interface: this.extractInterface(resolved.definition),
+        };
+    }
+    // ─── Validation Service Delegation ──────────────────────────────────────
+    /** Query validation run history for a project. */
+    async getHistory(project, options) {
+        return this.validation.getHistory(project, options);
+    }
+    /** Get details for a specific validation run by ID. */
+    async getRun(runId) {
+        return this.validation.getRun(runId);
+    }
+    /** Preview what a submission would do without saving (dry run). */
+    async validateRun(project, workflowType, result) {
+        return this.validation.validateRun(project, workflowType, result);
+    }
+    /** Manually submit execution results to the validation service. */
+    async submitResults(project, workflowType, result) {
+        return this.validation.submit({ project, workflowType, result });
+    }
+    // ─── Private Helpers ────────────────────────────────────────────────────
+    resolveConfig(config) {
+        const apiKey = config.apiKey ?? process.env['ULUOPS_API_KEY'] ?? process.env['ULU_API_KEY'];
+        if (!apiKey) {
+            throw new ConfigurationError('UluOps API key is required. Provide via config.apiKey, ULUOPS_API_KEY, or ULU_API_KEY environment variable. ' +
+                'Generate a key at https://app.uluops.ai.');
+        }
+        if (!apiKey.startsWith('ulr_')) {
+            throw new ConfigurationError(`Invalid API key format: keys must begin with "ulr_". ` +
+                `Got: "${apiKey.substring(0, 4)}...". ` +
+                `Generate a valid key at https://app.uluops.ai.`);
+        }
+        return {
+            apiKey,
+            ai: this.resolveAIConfig(config.ai),
+            registryUrl: config.registryUrl ?? process.env['ULUOPS_REGISTRY_URL'] ?? 'https://api.uluops.ai/api/v1/registry',
+            validationUrl: config.validationUrl ?? process.env['ULUOPS_VALIDATION_URL'] ?? 'https://api.uluops.ai/api/v1/ops',
+            dashboardUrl: config.dashboardUrl ?? process.env['ULUOPS_DASHBOARD_URL'] ?? 'https://app.uluops.ai',
+            localDefinitions: config.localDefinitions ?? process.env['ULUOPS_LOCAL_DEFINITIONS'],
+            trackingEnabled: config.trackingEnabled ?? (process.env['ULUOPS_TRACKING_ENABLED'] !== 'false'),
+            timeout: config.timeout ?? DEFAULT_TIMEOUT_MS,
+            defaultProject: config.defaultProject ?? process.env['ULUOPS_PROJECT'],
+            defaultThinkingBudget: config.defaultThinkingBudget ?? 10_000,
+            debug: config.debug ?? (process.env['ULUOPS_DEBUG'] === 'true'),
+            contextBudget: config.contextBudget ?? 200_000,
+        };
+    }
+    /**
+     * Resolve AI config with env var fallbacks.
+     *
+     * Default: Anthropic provider with ANTHROPIC_API_KEY env var.
+     * Env var convention: <PROVIDER>_API_KEY (e.g., ANTHROPIC_API_KEY, OPENAI_API_KEY)
+     */
+    resolveAIConfig(ai) {
+        const providers = {};
+        if (ai?.providers) {
+            // Use explicitly configured providers with env var fallback
+            for (const [name, creds] of Object.entries(ai.providers)) {
+                const apiKey = creds.apiKey ?? resolveProviderApiKey(name);
+                if (apiKey) {
+                    providers[name] = { apiKey };
+                }
+            }
+        }
+        else {
+            // Auto-detect: scan env vars for known provider API keys
+            const KNOWN_PROVIDERS = ['anthropic', 'openai', 'google', 'mistral', 'cohere'];
+            for (const name of KNOWN_PROVIDERS) {
+                const apiKey = resolveProviderApiKey(name);
+                if (apiKey) {
+                    providers[name] = { apiKey };
+                }
+            }
+        }
+        return {
+            providers,
+            defaultProvider: ai?.defaultProvider ?? 'anthropic',
+            modelOverride: ai?.modelOverride,
+        };
+    }
+    async resolveByRef(name, type) {
+        const [refName, refVersion] = parseRef(name);
+        return type
+            ? this.registry.resolve(refName, refVersion, type)
+            : this.registry.resolve(refName, refVersion);
+    }
+    async trackIfEnabled(result, resolved, workflowType, options) {
+        const shouldTrack = options?.trackResults ?? this.config.trackingEnabled;
+        if (!shouldTrack)
+            return;
+        try {
+            // SAFETY: AgentResult extends ExecutionResult structurally — both share
+            // type, name, version, definitionHash, decision, score, durationMs, recommendations, metrics.
+            // AgentResult adds agentType, maxScore, categories which the validation API ignores.
+            const execResult = {
+                type: result.type,
+                name: result.name,
+                version: result.version,
+                definitionHash: result.definitionHash,
+                decision: result.decision,
+                score: result.score,
+                durationMs: result.durationMs,
+                recommendations: result.recommendations,
+                metrics: result.metrics,
+            };
+            const response = await this.validation.submit({
+                project: options?.project ?? this.config.defaultProject ?? resolved.name,
+                workflowType,
+                result: execResult,
+            });
+            // Attach dashboard URL to original result for caller convenience
+            result.dashboardUrl = response.dashboardUrl;
+            // Record execution in registry for definition-level analytics (non-fatal)
+            if (resolved.version !== 'unknown') {
+                try {
+                    await this.registry.registrySdk.executions.record(resolved.type, resolved.name, resolved.version, { source: 'core-sdk', runId: response.runId });
+                    this.logger.debug(`Execution recorded for ${resolved.type}/${resolved.name}@${resolved.version}`);
+                }
+                catch (execError) {
+                    this.logger.warn(`Execution recording failed (non-fatal): ${execError instanceof Error ? execError.message : String(execError)}`);
+                }
+            }
+            else {
+                this.logger.debug('Skipping execution recording for unversioned local definition');
+            }
+        }
+        catch (error) {
+            this.logger.warn(`Tracking submission failed (non-fatal): ${error instanceof Error ? error.message : String(error)}`);
+            if (error instanceof Error && 'statusCode' in error) {
+                this.logger.debug(`Tracking error: statusCode=${error.statusCode}`);
+            }
+        }
+    }
+    extractInterface(definition) {
+        const def = definition;
+        for (const key of ['agent', 'command', 'workflow', 'pipeline']) {
+            const section = def[key];
+            if (section && typeof section === 'object') {
+                const iface = section['interface'];
+                if (iface && typeof iface === 'object') {
+                    return iface;
+                }
+            }
+        }
+        return {};
+    }
+}
+/**
+ * Resolve an API key for a provider from environment variables.
+ * Checks `<PROVIDER>_API_KEY` first, then provider-specific fallbacks
+ * (e.g., `GOOGLE_GENERATIVE_AI_API_KEY` for Google's SDK default).
+ */
+function resolveProviderApiKey(name) {
+    const envKey = `${name.toUpperCase()}_API_KEY`;
+    const apiKey = process.env[envKey];
+    if (apiKey)
+        return apiKey;
+    // Google SDK uses GOOGLE_GENERATIVE_AI_API_KEY by default
+    if (name === 'google') {
+        return process.env['GOOGLE_GENERATIVE_AI_API_KEY'];
+    }
+    return undefined;
+}
+//# sourceMappingURL=UluOpsClient.js.map

package/dist/client/UluOpsClient.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Path to bundled starter agent definitions.
+ * Use as `localDefinitions` in config for quick-start without registry access.
+ */
+export declare const STARTER_DEFINITIONS_DIR: string;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,eAAO,MAAM,uBAAuB,QAA+C,CAAC"}

package/dist/constants.js

@@ -0,0 +1,9 @@
+import { resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = fileURLToPath(new URL('.', import.meta.url));
+/**
+ * Path to bundled starter agent definitions.
+ * Use as `localDefinitions` in config for quick-start without registry access.
+ */
+export const STARTER_DEFINITIONS_DIR = resolve(__dirname, '../definitions/starter');
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +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"}

package/dist/errors/UluOpsError.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Base error class for all @uluops/core SDK errors.
+ *
+ * Supports the standard `cause` property (ES2022) for wrapping
+ * underlying errors while preserving the original stack trace.
+ */
+export declare class UluOpsError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+//# sourceMappingURL=UluOpsError.d.ts.map

package/dist/errors/UluOpsError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UluOpsError.d.ts","sourceRoot":"","sources":["../../src/errors/UluOpsError.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD"}

package/dist/errors/UluOpsError.js

@@ -0,0 +1,13 @@
+/**
+ * Base error class for all @uluops/core SDK errors.
+ *
+ * Supports the standard `cause` property (ES2022) for wrapping
+ * underlying errors while preserving the original stack trace.
+ */
+export class UluOpsError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'UluOpsError';
+    }
+}
+//# sourceMappingURL=UluOpsError.js.map

package/dist/errors/UluOpsError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UluOpsError.js","sourceRoot":"","sources":["../../src/errors/UluOpsError.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,YAAY,OAAe,EAAE,OAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF"}

package/dist/errors/index.d.ts

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

package/dist/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,wFAAwF;AACxF,qBAAa,cAAe,SAAQ,WAAW;aAG3B,aAAa,CAAC,EAAE,OAAO;gBADvC,OAAO,EAAE,MAAM,EACC,aAAa,CAAC,EAAE,OAAO,YAAA,EACvC,OAAO,CAAC,EAAE,YAAY;CAKzB;AAED,oFAAoF;AACpF,qBAAa,cAAe,SAAQ,WAAW;aAG3B,KAAK,EAAE,MAAM;aACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFjD,OAAO,EAAE,MAAM,EACC,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAKpD;AAED,sFAAsF;AACtF,qBAAa,kBAAmB,SAAQ,WAAW;gBACrC,OAAO,EAAE,MAAM;CAI5B;AAED,mFAAmF;AACnF,qBAAa,kBAAmB,SAAQ,WAAW;gBACrC,OAAO,EAAE,MAAM;CAI5B;AAED,uGAAuG;AACvG,qBAAa,eAAgB,SAAQ,WAAW;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;CASvB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,OAAO,oBAAoB,CAAC,MAAM,OAAO,oBAAoB,CAAC,CAAC;AAEjG,mFAAmF;AACnF,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,SAAgB,IAAI,CAAC,EAAE,mBAAmB,CAAC;gBAE/B,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,mBAAmB;CAKxD;AAED,8FAA8F;AAC9F,qBAAa,aAAc,SAAQ,WAAW;aAG1B,OAAO,EAAE;QAAE,aAAa,EAAE,OAAO,CAAA;KAAE;gBADnD,OAAO,EAAE,MAAM,EACC,OAAO,EAAE;QAAE,aAAa,EAAE,OAAO,CAAA;KAAE;CAKtD;AAED,2EAA2E;AAC3E,qBAAa,aAAc,SAAQ,WAAW;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAED,8EAA8E;AAC9E,qBAAa,UAAW,SAAQ,WAAW;IACzC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;gBAEpB,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM;CAKpD;AAGD,OAAO,EACL,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,uBAAuB,EACvB,YAAY,EACZ,YAAY,GACb,MAAM,yBAAyB,CAAC"}