@uluops/core 0.5.0

package/dist/types/config.d.ts

@@ -0,0 +1,136 @@
+/**
+ * AI provider credentials
+ */
+export interface AIProviderCredentials {
+    /** Provider API key. Falls back to standard env var (e.g., ANTHROPIC_API_KEY) */
+    apiKey?: string;
+}
+/**
+ * AI configuration — provider credentials and model resolution.
+ *
+ * Provider names match models.dev / AI SDK conventions
+ * (e.g., 'anthropic', 'openai', 'google').
+ */
+export interface AIConfig {
+    /**
+     * Provider credentials keyed by provider name.
+     * Only configured providers can be used for execution.
+     * `@ai-sdk/anthropic`, `@ai-sdk/openai`, and `@ai-sdk/google` are bundled.
+     * Other providers require installing `@ai-sdk/<provider>` as a peer dependency.
+     *
+     * @example
+     * ```typescript
+     * providers: {
+     *   anthropic: { apiKey: process.env.ANTHROPIC_API_KEY },
+     *   openai: { apiKey: process.env.OPENAI_API_KEY },
+     *   google: { apiKey: process.env.GOOGLE_API_KEY },
+     * }
+     * ```
+     */
+    providers: Record<string, AIProviderCredentials>;
+    /**
+     * Default provider when model alias doesn't include a provider prefix.
+     * @default 'anthropic'
+     */
+    defaultProvider?: string;
+    /**
+     * Model override for all executions (alias, tier, or provider:modelId).
+     * When set, overrides model selection from definition files.
+     */
+    modelOverride?: string;
+}
+/**
+ * Resolved AI configuration with defaults applied
+ */
+export interface ResolvedAIConfig {
+    providers: Record<string, {
+        apiKey: string;
+    }>;
+    defaultProvider: string;
+    modelOverride?: string;
+}
+/**
+ * SDK Configuration
+ */
+export interface UluOpsConfig {
+    /**
+     * UluOps platform API key for registry and validation services.
+     * Falls back to ULUOPS_API_KEY or ULU_API_KEY env var.
+     * This key authenticates against UluOps services only, NOT AI providers.
+     */
+    apiKey?: string;
+    /**
+     * AI provider configuration.
+     * Separates AI provider credentials from UluOps platform auth.
+     *
+     * If omitted, defaults to Anthropic with ANTHROPIC_API_KEY env var.
+     */
+    ai?: AIConfig;
+    /**
+     * Base URL for uluops-registry-api
+     * @default "https://api.uluops.ai/api/v1/registry"
+     */
+    registryUrl?: string;
+    /**
+     * Base URL for uluops-validation-api
+     * @default "https://api.uluops.ai/api/v1/ops"
+     */
+    validationUrl?: string;
+    /**
+     * Base URL for dashboard links
+     * @default "https://app.uluops.ai"
+     */
+    dashboardUrl?: string;
+    /**
+     * Local definitions directory for development
+     * When set, SDK looks here first before remote registry
+     * Supports: *.agent.yaml, *.command.yaml, *.workflow.yaml, *.pipeline.yaml
+     */
+    localDefinitions?: string;
+    /**
+     * Enable result submission to validation service
+     * @default true
+     */
+    trackingEnabled?: boolean;
+    /** Request timeout in ms (default: 300000) */
+    timeout?: number;
+    /** Default project name for validation service */
+    defaultProject?: string;
+    /**
+     * Default extended thinking budget in tokens.
+     * Used when a model supports extendedThinking and no per-call budget is specified.
+     * @default 10000
+     */
+    defaultThinkingBudget?: number;
+    /**
+     * Enable detailed execution logging (model resolution, prompt sizes,
+     * per-step tool calls, usage). Falls back to ULUOPS_DEBUG env var.
+     * @default false
+     */
+    debug?: boolean;
+    /**
+     * Context window budget in tokens for agent execution.
+     * When usage exceeds 80%, the agent is forced to produce output instead of calling more tools.
+     * Also enables Anthropic context management (auto-clearing old tool uses at 50%).
+     * @default 200000
+     */
+    contextBudget?: number;
+}
+/**
+ * Validated configuration with defaults applied
+ */
+export interface ResolvedConfig {
+    apiKey: string;
+    ai: ResolvedAIConfig;
+    registryUrl: string;
+    validationUrl: string;
+    dashboardUrl: string;
+    localDefinitions?: string;
+    trackingEnabled: boolean;
+    timeout: number;
+    defaultProject?: string;
+    defaultThinkingBudget: number;
+    debug: boolean;
+    contextBudget: number;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB;;;;;;;;;;;;;;OAcG;IACH,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAEjD;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9C,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;OAKG;IACH,EAAE,CAAC,EAAE,QAAQ,CAAC;IAEd;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,kDAAkD;IAClD,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,gBAAgB,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,OAAO,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACvB"}

package/dist/types/config.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":""}

package/dist/types/execution.d.ts

@@ -0,0 +1,172 @@
+/**
+ * Definition type discriminator
+ */
+export type DefinitionType = 'agent' | 'command' | 'workflow' | 'pipeline';
+/**
+ * Execution type discriminator (excludes agent - agents aren't directly executable)
+ */
+export type ExecutionType = 'command' | 'workflow' | 'pipeline';
+/**
+ * Domain classification for definitions
+ */
+export type Domain = 'software' | 'legal' | 'medical' | 'financial' | 'scientific' | 'content' | 'general';
+/**
+ * Agent type discriminator.
+ *
+ * - `validator` — Scores code against criteria, produces pass/warn/fail decisions
+ * - `executor` — Performs actions (refactoring, generation), produces complete/partial/failed decisions
+ * - `analyst` — Analyzes patterns and trends, produces analytical reports
+ * - `generator` — Creates new artifacts (scaffolding, templates, documentation)
+ */
+export type AgentType = 'validator' | 'executor' | 'analyst' | 'generator' | 'explorer' | 'forecaster';
+/**
+ * Base input for all execution types
+ */
+export interface ExecutionInput {
+    /** Target path to analyze */
+    target: string;
+    /** Execution options */
+    options?: Record<string, unknown>;
+}
+/**
+ * Base result for all execution types
+ */
+export interface ExecutionResult {
+    /** Execution type discriminator */
+    type: ExecutionType;
+    /** Name of executed definition */
+    name: string;
+    /** Version executed */
+    version: string;
+    /** Definition hash for audit trail */
+    definitionHash: string;
+    /** Final decision */
+    decision: string;
+    /** Aggregated score (0-100). Optional — not all execution types produce scores. */
+    score?: number;
+    /** Total execution duration */
+    durationMs: number;
+    /** Dashboard URL for this run (populated after validation service submission) */
+    dashboardUrl?: string;
+    /** All recommendations (flattened for workflows/pipelines) */
+    recommendations: Recommendation[];
+    /** Execution metrics */
+    metrics: ExecutionMetrics;
+}
+/**
+ * Base metrics collected for all executions
+ */
+export interface ExecutionMetrics {
+    /** Total input tokens */
+    inputTokens: number;
+    /** Total output tokens */
+    outputTokens: number;
+    /** Cache creation tokens */
+    cacheCreationTokens?: number;
+    /** Cache read tokens */
+    cacheReadTokens?: number;
+    /**
+     * Google Gemini thinking tokens (Gemini 2.5+ with extendedThinking).
+     * Charged separately from outputTokens by Google; already included in totalEffectiveTokens.
+     */
+    thinkingTokens?: number;
+    /** Total effective tokens (for cost) */
+    totalEffectiveTokens: number;
+    /** Execution duration in ms */
+    durationMs: number;
+    /** Model used (or primary model for workflows) */
+    model: string;
+    /** Number of LLM tool calls made during execution (agent-level) */
+    toolCallCount?: number;
+    /** Estimated cost in USD */
+    costUsd?: number;
+}
+/**
+ * Call-time execution options for direct agent runs
+ */
+export interface ExecutionOptions {
+    /** Model override: alias ('sonnet'), tier ('premium'), or 'provider:modelId' */
+    model?: string;
+    /** Maximum tokens for response */
+    maxTokens?: number;
+    /** Execution timeout in milliseconds */
+    timeoutMs?: number;
+    /** Threshold overrides for validators */
+    thresholds?: {
+        pass?: number;
+        warn?: number;
+    };
+    /** Submit results to validation service (default: true) */
+    trackResults?: boolean;
+    /** Project name for result tracking */
+    project?: string;
+    /** Temperature for generation (0-1). Default: 0 */
+    temperature?: number;
+    /** Maximum tool loop steps. Default: 50 */
+    maxSteps?: number;
+}
+/**
+ * Merged execution context from agent defaults + runtime options
+ * Used internally by AgentExecutor
+ */
+export interface ResolvedExecutionContext {
+    /** Resolved model: alias, tier, or provider:modelId (from options > agent defaults > config default) */
+    model: string;
+    /** Resolved max tokens */
+    maxTokens: number;
+    /** Resolved timeout in ms */
+    timeoutMs: number;
+    /** Resolved thresholds (for validators) */
+    thresholds?: {
+        pass: number;
+        warn: number;
+    };
+    /** Whether to track results */
+    trackResults: boolean;
+    /** Project for tracking */
+    project?: string;
+    /** Resolved temperature (from options > agent defaults > 0) */
+    temperature: number;
+    /** Resolved max tool loop steps (from options > 50) */
+    maxSteps: number;
+}
+/**
+ * Individual recommendation/issue
+ */
+export interface Recommendation {
+    /** Source validator name */
+    validator?: string;
+    /** Issue title */
+    title: string;
+    /** Priority level */
+    priority: 'critical' | 'suggested' | 'backlog';
+    /** Severity level */
+    severity?: 'critical' | 'high' | 'medium' | 'low' | 'info';
+    /** Failure taxonomy code (e.g., "SEM-INC/H") */
+    failureCode?: string;
+    /** Failure domain (STR=Structural, SEM=Semantic, PRA=Pragmatic, EPI=Epistemic) */
+    failureDomain?: 'STR' | 'SEM' | 'PRA' | 'EPI';
+    /** Failure mode code (e.g., "SYN", "VAL", "INC") */
+    failureMode?: string;
+    /** Issue category (e.g., "type-safety", "security") */
+    category?: string;
+    /** Type of issue (e.g. "feature", "bug", "docs", "config") */
+    type?: string;
+    /** File path relative to target */
+    filePath?: string;
+    /** Line number in file */
+    lineNumber?: number;
+    /** Detailed description */
+    description?: string;
+    /** Classification confidence */
+    classificationConfidence?: 'high' | 'medium' | 'low';
+    /** Who classified this issue */
+    classifiedBy?: 'validator' | 'classifier' | 'human';
+    /** Secondary failure codes when multiple issues apply */
+    secondaryFailureCodes?: string[];
+    /** Version of failure taxonomy used */
+    taxonomyVersion?: string;
+    /** Fingerprint for correlation (populated by validation API) */
+    fingerprint?: string;
+}
+//# sourceMappingURL=execution.d.ts.map

package/dist/types/execution.d.ts.map

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

package/dist/types/execution.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=execution.js.map

package/dist/types/execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.js","sourceRoot":"","sources":["../../src/types/execution.ts"],"names":[],"mappings":""}

package/dist/types/index.d.ts

@@ -0,0 +1,12 @@
+export type { UluOpsConfig, AIConfig, AIProviderCredentials, ResolvedConfig, ResolvedAIConfig } from './config.js';
+export type { DefinitionType, ExecutionType, Domain, AgentType, ExecutionInput, ExecutionResult, ExecutionMetrics, ExecutionOptions, ResolvedExecutionContext, Recommendation, } from './execution.js';
+export type { AgentDefinition, AgentInterface, AgentDefaults, AgentMission, AgentScoring, AgentDecisions, AgentTasks, AgentCompletion, AgentOutput, ScoringCategory, ScoringCriterion, ValidatorAgentResult, ExecutorAgentResult, AgentResult, } from './agent.js';
+export type { CommandDefinition, PreflightCheck, PostflightAction, CommandResult, CommandMetrics, CategoryResult, Finding, Issue, ArtifactResult, } from './command.js';
+export type { WorkflowDefinition, PhaseDefinition, WorkflowResult, WorkflowMetrics, CommandMetricsSummary, PhaseResult, } from './workflow.js';
+export type { PipelineDefinition, StageDefinition, TriggerDefinition, PipelineResult, PipelineMetrics, StageResult, TriggerInfo, PipelineArtifact, PipelineState, PipelineHandle, } from './pipeline.js';
+export type { Tool, ToolUseBlock, ToolResult } from './tools.js';
+export type { UsageMetrics } from './ai.js';
+export type { ParsedOutput, ParsedCategory, ParsedFinding, ExtractionOptions, ExtractionResult, } from './parser.js';
+export type { ResolvedDefinition, ValidatorRuntime, ExecutorRuntime, WorkflowRuntime, PipelineRuntime, CategoryConfig, CriteriaConfig, InputConfig, TaskConfig, OutputConfig, PhaseConfig, AggregationConfig, OutputMapping, StageConfig, TriggerConfig, StateConfig, DefinitionSummary, Reference, } from './registry.js';
+export type { RunSubmission, RunSubmissionResponse, FingerprintedRecommendation, RegressionInfo, ValidationQueryOptions, RunHistoryEntry, } from './validation.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,qBAAqB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGnH,YAAY,EACV,cAAc,EACd,aAAa,EACb,MAAM,EACN,SAAS,EACT,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,wBAAwB,EACxB,cAAc,GACf,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACV,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,UAAU,EACV,eAAe,EACf,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,WAAW,GACZ,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,cAAc,EACd,OAAO,EACP,KAAK,EACL,cAAc,GACf,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,WAAW,GACZ,MAAM,eAAe,CAAC;AAGvB,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,cAAc,GACf,MAAM,eAAe,CAAC;AAGvB,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGjE,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG5C,YAAY,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,eAAe,EACf,cAAc,EACd,cAAc,EACd,WAAW,EACX,UAAU,EACV,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,SAAS,GACV,MAAM,eAAe,CAAC;AAGvB,YAAY,EACV,aAAa,EACb,qBAAqB,EACrB,2BAA2B,EAC3B,cAAc,EACd,sBAAsB,EACtB,eAAe,GAChB,MAAM,iBAAiB,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/dist/types/parser.d.ts

@@ -0,0 +1,75 @@
+import type { ArtifactResult, Issue } from './command.js';
+/**
+ * Raw parsed output from LLM response
+ */
+export interface ParsedOutput {
+    /** Decision outcome from the agent */
+    decision: string;
+    /** Numeric score (0-100 for validators, may be undefined for executors) */
+    score?: number;
+    /** Maximum possible score (validators only) */
+    maxScore?: number;
+    /** Category breakdown with findings (validators only) */
+    categories?: ParsedCategory[];
+    /** Generated artifacts (executors only) */
+    artifacts?: ArtifactResult[];
+    /** Raw JSON if extraction was from code fence */
+    rawJson?: unknown;
+    /** Brief human-readable summary of the result */
+    summary?: string;
+}
+/**
+ * Parsed category from validator output
+ */
+export interface ParsedCategory {
+    /** Category name */
+    name: string;
+    /** Points earned in this category */
+    score: number;
+    /** Maximum points possible */
+    maxPoints: number;
+    /** Findings within this category */
+    findings: ParsedFinding[];
+}
+/**
+ * Parsed finding within a category
+ */
+export interface ParsedFinding {
+    /** Criterion being evaluated */
+    criterion: string;
+    /** Points earned */
+    pointsEarned: number;
+    /** Points possible */
+    pointsPossible: number;
+    /** Individual issues found */
+    issues: Issue[];
+}
+/**
+ * Extraction options
+ */
+export interface ExtractionOptions {
+    /**
+     * Whether to throw on parse failure
+     * @default false
+     */
+    strict?: boolean;
+    /**
+     * Custom JSON code fence language identifier
+     * @default 'json'
+     */
+    codeFenceLanguage?: string;
+}
+/**
+ * Extraction result with metadata
+ */
+export interface ExtractionResult {
+    /** Parsed output */
+    output: ParsedOutput;
+    /** Extraction method used */
+    method: 'json_code_fence' | 'inline_json' | 'structured_text' | 'structured_output';
+    /** Confidence in extraction (0-1) */
+    confidence: number;
+    /** Any warnings during extraction */
+    warnings: string[];
+}
+//# sourceMappingURL=parser.d.ts.map

package/dist/types/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/types/parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IAEjB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,yDAAyD;IACzD,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAE9B,2CAA2C;IAC3C,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;IAE7B,iDAAiD;IACjD,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IAEb,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IAEd,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAElB,oCAAoC;IACpC,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAElB,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IAErB,sBAAsB;IACtB,cAAc,EAAE,MAAM,CAAC;IAEvB,8BAA8B;IAC9B,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oBAAoB;IACpB,MAAM,EAAE,YAAY,CAAC;IAErB,6BAA6B;IAC7B,MAAM,EAAE,iBAAiB,GAAG,aAAa,GAAG,iBAAiB,GAAG,mBAAmB,CAAC;IAEpF,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IAEnB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB"}

package/dist/types/parser.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=parser.js.map

package/dist/types/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/types/parser.ts"],"names":[],"mappings":""}

package/dist/types/pipeline.d.ts

@@ -0,0 +1,155 @@
+import type { ExecutionResult, ExecutionMetrics, Domain } from './execution.js';
+import type { CommandResult } from './command.js';
+import type { WorkflowResult } from './workflow.js';
+/**
+ * Pipeline definition - multi-stage execution flow
+ */
+export interface PipelineDefinition {
+    pipeline: {
+        /** Pipeline metadata */
+        interface: {
+            name: string;
+            version: string;
+            displayName: string;
+            description: string;
+            domain: Domain;
+            subdomain?: string;
+        };
+        /** Stage definitions */
+        stages: StageDefinition[];
+        /** Trigger configuration (optional) */
+        triggers?: TriggerDefinition[];
+        /** Pipeline-level settings */
+        settings?: {
+            timeout?: number;
+            retries?: number;
+            parallel_stages?: boolean;
+        };
+    };
+}
+/**
+ * Stage definition within a pipeline
+ */
+export interface StageDefinition {
+    id: string;
+    name: string;
+    /** Explicit type of the referenced definition */
+    type: 'workflow' | 'command';
+    /** Reference to command or workflow (name@version format) */
+    ref: string;
+    /** Stage dependencies */
+    depends_on?: string[];
+    /** Execution condition (e.g., "pre-merge.decision == 'PASS'") */
+    condition?: string;
+    /** Skip condition (deprecated, use condition with negation) */
+    skip_if?: string;
+    /** Stage-specific options */
+    options?: Record<string, unknown>;
+}
+/**
+ * Trigger definition for pipelines
+ */
+export interface TriggerDefinition {
+    type: 'webhook' | 'schedule' | 'event';
+    config: Record<string, unknown>;
+}
+/**
+ * Pipeline execution result
+ */
+export interface PipelineResult extends ExecutionResult {
+    type: 'pipeline';
+    /** Execution status (pipelines can be async) */
+    status: 'pending' | 'running' | 'complete' | 'failed' | 'cancelled';
+    /** Stage-by-stage results */
+    stages: StageResult[];
+    /** Trigger information */
+    trigger?: TriggerInfo;
+    /** Generated artifacts */
+    artifacts?: PipelineArtifact[];
+    /** Pipeline-specific metrics */
+    metrics: PipelineMetrics;
+}
+/**
+ * Pipeline-specific metrics
+ */
+export interface PipelineMetrics extends ExecutionMetrics {
+    /** Number of stages executed */
+    stagesExecuted: number;
+    /** Number of stages passed */
+    stagesPassed: number;
+    /** Number of stages failed */
+    stagesFailed: number;
+    /** Number of stages skipped */
+    stagesSkipped: number;
+}
+/**
+ * Result for a single stage
+ */
+export interface StageResult {
+    /** Stage identifier */
+    id: string;
+    /** Stage display name */
+    name: string;
+    /** Stage type (inferred from ref) */
+    type: 'workflow' | 'command';
+    /** Stage status */
+    status: 'pending' | 'running' | 'completed' | 'failed' | 'skipped';
+    /** Result (command or workflow depending on stage type) */
+    result?: CommandResult | WorkflowResult;
+    /** Reason if stage was skipped */
+    skipReason?: string;
+    /** Stage start time */
+    startedAt?: string;
+    /** Stage completion time */
+    completedAt?: string;
+    /** Stage duration */
+    durationMs?: number;
+}
+/**
+ * Information about what triggered the pipeline
+ */
+export interface TriggerInfo {
+    type: 'manual' | 'webhook' | 'schedule' | 'event';
+    source?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Pipeline artifact
+ */
+export interface PipelineArtifact {
+    name: string;
+    path: string;
+    size?: number;
+    contentType?: string;
+}
+/**
+ * Internal state for tracking pipeline execution
+ */
+export interface PipelineState {
+    /** Unique pipeline execution ID */
+    pipelineId: string;
+    /** Version of the pipeline definition being executed */
+    definitionVersion: string;
+    /** Hash of the pipeline definition for audit trail */
+    definitionHash: string;
+    /** Current execution status */
+    status: 'pending' | 'running' | 'completed' | 'failed' | 'cancelled';
+    /** Index of currently executing stage */
+    currentStageIndex: number;
+    /** Results from completed stages */
+    stageResults: StageResult[];
+    /** Execution start timestamp (ms since epoch) */
+    startTime: number;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Handle for monitoring async pipeline execution
+ */
+export interface PipelineHandle {
+    readonly executionId: string;
+    status(): Promise<PipelineResult>;
+    wait(pollIntervalMs?: number): Promise<PipelineResult>;
+    cancel(): Promise<void>;
+}
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/types/pipeline.d.ts.map

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

package/dist/types/pipeline.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pipeline.js.map

package/dist/types/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/types/pipeline.ts"],"names":[],"mappings":""}