@uluops/core 0.5.0

package/dist/types/agent.d.ts

@@ -0,0 +1,406 @@
+import type { Domain, AgentType, ExecutionMetrics, Recommendation } from './execution.js';
+import type { Finding, ArtifactResult } from './command.js';
+/**
+ * Agent definition — the atomic validation/execution unit.
+ * Matches the ADL v1.6.0 JSON schema structure.
+ *
+ * Agents are NOT directly executable; they must be wrapped in a Command.
+ */
+export interface AgentDefinition {
+    agent: {
+        /** Agent metadata (required) */
+        interface: AgentInterface;
+        /** Default execution settings */
+        defaults?: AgentDefaults;
+        /** Execution context configuration */
+        context?: AgentContext;
+        /** Agent identity, purpose framing, and behavioral boundaries */
+        mission?: AgentMission;
+        /** Embedded domain expertise for scoring categories */
+        knowledge_base?: AgentKnowledgeBase;
+        /** Scoring configuration — required for validators, forbidden for executors */
+        scoring?: AgentScoring;
+        /** Decision vocabulary and thresholds — required for validators */
+        decisions?: AgentDecisions;
+        /** Task definitions — required for executors, forbidden for validators */
+        tasks?: AgentTasks;
+        /** Completion criteria — required for executors */
+        completion?: AgentCompletion;
+        /** Auto-fail conditions */
+        auto_fail?: AgentAutoFail;
+        /** Severity deduction scale */
+        deductions?: AgentDeductions;
+        /** Rollback configuration — executors only */
+        rollback?: AgentRollback;
+        /** Reasoning process and scaffolding */
+        process?: AgentProcess;
+        /** Output specification */
+        output?: AgentOutput;
+        /** Edge case handling */
+        edge_cases?: AgentEdgeCase[];
+        /** Communication tone */
+        tone?: AgentTone;
+    };
+}
+export interface AgentInterface {
+    name: string;
+    version: string;
+    displayName: string;
+    description: string;
+    agentType: AgentType;
+    domain: Domain;
+    subdomain?: string;
+    domain_profile?: string;
+    risk_level?: 'low' | 'standard' | 'high' | 'critical';
+    tools?: string[];
+    tags?: string[];
+    triggers?: AgentTriggers;
+    dependencies?: AgentDependencies;
+}
+export interface AgentTriggers {
+    file_patterns?: string[];
+    explicit_only?: boolean;
+}
+export interface AgentDependencies {
+    requires?: string[];
+    recommends?: string[];
+}
+export interface AgentDefaults {
+    model?: string;
+    timeout?: number;
+    max_tokens?: number;
+    temperature?: number;
+}
+export interface AgentContext {
+    working_directory?: string;
+    environment?: Record<string, string>;
+    timeout_behavior?: 'fail' | 'warn' | 'continue';
+    shell?: 'bash' | 'sh' | 'zsh' | 'powershell';
+    data_sources?: unknown[];
+}
+export interface AgentMission {
+    /** Present-tense immersive opening statement */
+    opener?: string;
+    /** Why this validation matters */
+    stakes?: string;
+    /** What the agent produces */
+    outcome_framing?: string;
+    /** Agent scope and limitations */
+    role_boundaries?: string[];
+    /** Whether issues must include taxonomy classification */
+    taxonomy_mandate?: boolean;
+    /** Why this decision vocabulary was chosen */
+    vocabulary_rationale?: string;
+    /** Hard boundaries — what agent must NOT do */
+    explicit_prohibitions?: string[];
+}
+export interface AgentKnowledgeBase {
+    sections?: KnowledgeSection[];
+    failure_code_examples?: FailureCodeExample[];
+    global_references?: string[];
+}
+export interface KnowledgeSection {
+    category_ref: string;
+    what_to_check?: string[];
+    detection_patterns?: unknown[];
+    red_flags?: CodeExample[];
+    safe_patterns?: CodeExample[];
+    references?: string[];
+    common_mistakes?: CommonMistake[];
+}
+export interface CodeExample {
+    description: string;
+    code?: string;
+    language?: string;
+    severity?: string;
+    why?: string;
+}
+export interface CommonMistake {
+    mistake: string;
+    why_wrong: string;
+    correct_approach: string;
+}
+export interface FailureCodeExample {
+    issue: string;
+    failure_code: string;
+    explanation: string;
+}
+export interface AgentScoring {
+    maxScore: number;
+    categories: ScoringCategory[];
+    calibration_examples?: CalibrationExample[];
+    constraints?: ScoringConstraints;
+}
+export interface ScoringCategory {
+    id: string;
+    name: string;
+    weight: number;
+    description?: string;
+    criteria: ScoringCriterion[];
+}
+export interface ScoringCriterion {
+    id: string;
+    name: string;
+    points: number;
+    description?: string;
+    failure_taxonomy?: FailureTaxonomy;
+    verification?: CriterionVerification;
+}
+export interface FailureTaxonomy {
+    domain: 'structural' | 'semantic' | 'pragmatic' | 'epistemic';
+    failure_mode: string;
+    default_severity: 'critical' | 'high' | 'medium' | 'low' | 'info';
+}
+export interface CriterionVerification {
+    method: 'manual' | 'automated' | 'hybrid';
+    checks?: string[];
+    automation?: {
+        tool: string;
+        pattern?: string;
+    };
+}
+export interface CalibrationExample {
+    score: number;
+    scenario: string;
+    description?: string;
+    deductions?: Array<{
+        criterion: string;
+        points_lost: number;
+        reason: string;
+    }>;
+}
+export interface ScoringConstraints {
+    min_categories?: number;
+    max_categories?: number;
+    min_category_weight?: number;
+    max_category_weight?: number;
+    min_criterion_points?: number;
+    max_criterion_points?: number;
+    total_must_equal?: number;
+}
+export interface AgentDecisions {
+    vocabulary: {
+        positive: string;
+        negative: string;
+        conditional?: string | null;
+    };
+    thresholds?: DecisionThreshold[];
+    preset?: 'low_risk' | 'quality_gate' | 'high_stakes' | 'security' | 'critical' | null;
+    tracking?: {
+        category: 'gate' | 'safety' | 'advisory';
+        notify_on?: string[];
+    };
+    success_criteria?: {
+        description: string;
+        criteria: string[];
+    };
+}
+export interface DecisionThreshold {
+    decision: 'positive' | 'conditional' | 'negative';
+    min_score?: number;
+    max_score?: number;
+    label?: string;
+}
+export interface AgentTasks {
+    inputs: TaskInput[];
+    operations: TaskOperation[];
+    outputs: TaskOutput[];
+}
+export interface TaskInput {
+    name: string;
+    type: string;
+    description: string;
+    required?: boolean;
+    default?: unknown;
+}
+export interface TaskOperation {
+    id: string;
+    name: string;
+    description: string;
+    steps?: string[];
+    depends_on?: string[];
+}
+export interface TaskOutput {
+    name: string;
+    type: string;
+    description: string;
+}
+export interface AgentCompletion {
+    vocabulary: {
+        complete: string;
+        partial: string;
+        failed: string;
+    };
+    criteria: string[];
+}
+export interface AgentAutoFail {
+    enabled?: boolean;
+    conditions: AutoFailCondition[];
+}
+export interface AutoFailCondition {
+    id: string;
+    display_id: string;
+    name: string;
+    severity: 'critical';
+    detection: {
+        method: 'pattern' | 'semantic' | 'tool';
+        patterns?: string[];
+        description?: string;
+        command?: string;
+        failure_condition?: string;
+    };
+    category_override?: string;
+    evidence_required?: boolean;
+    remediation?: string;
+}
+export interface AgentDeductions {
+    severity_scale?: Record<string, {
+        points: number;
+        description: string;
+    }>;
+}
+export interface AgentRollback {
+    enabled: boolean;
+    strategy?: string;
+    preserve_logs?: boolean;
+}
+export interface AgentProcess {
+    reasoning_scaffolding?: string[];
+    pre_decision_checklist?: string[];
+    phases?: Array<{
+        name: string;
+        actions: Array<{
+            action: string;
+            description: string;
+        }>;
+    }>;
+}
+export interface AgentOutput {
+    format: 'markdown' | 'json' | 'html' | 'structured';
+    schema?: string;
+    token_budget?: {
+        target: number;
+        max: number;
+        guidance?: string;
+    };
+    section_order?: string[];
+    sections?: Array<{
+        id: string;
+        condition?: string;
+        template: string;
+    }>;
+    symbols?: Record<string, string>;
+    classification?: {
+        enabled: boolean;
+        allow_secondary?: boolean;
+        taxonomy_version?: string;
+    };
+    examples?: Array<{
+        scenario: string;
+        input_summary?: string;
+        output: string;
+    }>;
+}
+export interface AgentEdgeCase {
+    id: string;
+    condition: string;
+    condition_expression?: string;
+    behavior?: string[];
+    score_adjustment?: {
+        exclude_categories?: string[];
+        rescale?: boolean;
+        fixed_score?: number;
+    };
+    report_wording?: string;
+    judgment_rationale?: string;
+    decision_override?: {
+        affects_decision: boolean;
+        forced_decision?: string;
+        override_rationale?: string;
+    };
+}
+export interface AgentTone {
+    attributes?: string[];
+    guidelines?: string[];
+}
+/**
+ * Base agent result fields shared by both validator and executor results
+ */
+interface AgentResultBase {
+    /** Discriminator — always 'agent' for direct agent execution */
+    type: 'agent';
+    /** Agent type discriminator for result shape */
+    agentType: AgentType;
+    /** Agent definition name */
+    name: string;
+    /** Agent definition version */
+    version: string;
+    /** Content-addressed hash of the definition */
+    definitionHash: string;
+    /** Final decision */
+    decision: string;
+    /** All recommendations */
+    recommendations: Recommendation[];
+    /** Total execution duration in ms */
+    durationMs: number;
+    /** Dashboard URL (populated after validation submission) */
+    dashboardUrl?: string;
+    /** Execution metrics */
+    metrics: ExecutionMetrics;
+    /** Raw LLM output text (the agent's full report before parsing) */
+    rawOutput?: string;
+}
+/**
+ * Result from a validator agent execution
+ *
+ * Validators produce a numerical score, decision (PASS/WARN/FAIL),
+ * and scored categories.
+ */
+export interface ValidatorAgentResult extends AgentResultBase {
+    agentType: 'validator';
+    /** Decision for validators */
+    decision: 'PASS' | 'WARN' | 'FAIL';
+    /** Validator score (0-100) */
+    score: number;
+    /** Maximum possible score */
+    maxScore: number;
+    /** Pass threshold used */
+    threshold?: number;
+    /** Scored categories */
+    categories?: Array<{
+        name: string;
+        score: number;
+        maxScore: number;
+        findings: Finding[];
+    }>;
+}
+/**
+ * Result from an executor agent execution
+ *
+ * Executors produce artifacts and a completion decision
+ * (COMPLETE/PARTIAL/FAILED).
+ */
+export interface ExecutorAgentResult extends AgentResultBase {
+    agentType: 'executor';
+    /** Decision for executors */
+    decision: 'COMPLETE' | 'PARTIAL' | 'FAILED';
+    /** Score is optional for executors */
+    score?: number;
+    /** Generated artifacts */
+    artifacts?: ArtifactResult[];
+}
+/**
+ * Discriminated union of all agent result types
+ *
+ * Use `result.agentType` to narrow:
+ * ```typescript
+ * if (result.agentType === 'validator') {
+ *   console.log(result.score); // ValidatorAgentResult
+ * } else {
+ *   console.log(result.artifacts); // ExecutorAgentResult
+ * }
+ * ```
+ */
+export type AgentResult = ValidatorAgentResult | ExecutorAgentResult;
+export {};
+//# sourceMappingURL=agent.d.ts.map

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

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

package/dist/types/agent.js

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

package/dist/types/agent.js.map

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

package/dist/types/ai.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Token usage metrics (used across providers)
+ */
+export interface UsageMetrics {
+    input_tokens: number;
+    output_tokens: number;
+    cache_creation_input_tokens?: number;
+    cache_read_input_tokens?: number;
+    /** OpenAI reasoning model internal reasoning tokens (o1, o3, o4-mini) */
+    reasoning_tokens?: number;
+    /** Google Gemini thinking tokens (Gemini 2.5+ with thinkingConfig enabled) */
+    thinking_tokens?: number;
+}
+//# sourceMappingURL=ai.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../src/types/ai.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8EAA8E;IAC9E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/dist/types/ai.js

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

package/dist/types/ai.js.map

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

package/dist/types/command.d.ts

@@ -0,0 +1,153 @@
+import type { ExecutionResult, ExecutionMetrics, Domain, AgentType } from './execution.js';
+/**
+ * Command definition - Agent(s) + execution context
+ */
+export interface CommandDefinition {
+    command: {
+        /** Command metadata */
+        interface: {
+            name: string;
+            version: string;
+            displayName: string;
+            description: string;
+            domain: Domain;
+            subdomain?: string;
+        };
+        /** References to wrapped agent(s) as refs (name@version format) */
+        agents: string[];
+        /** Execution configuration */
+        execution: {
+            /** Model selection */
+            model: {
+                default: 'haiku' | 'sonnet' | 'opus';
+                allowed?: Array<'haiku' | 'sonnet' | 'opus'>;
+            };
+            /** Timeout in ms */
+            timeout?: number;
+            /** Sequential execution for multiple agents (default: true) */
+            sequential?: boolean;
+            /** Preflight checks */
+            preflight?: PreflightCheck[];
+            /** Postflight actions */
+            postflight?: PostflightAction[];
+            /** Thresholds for validators */
+            thresholds?: {
+                /** Score threshold for PASS decision */
+                pass: number;
+                /** Score threshold for WARN decision (optional) */
+                warn?: number;
+            };
+        };
+        /** Aggregation config (required when multiple validators) */
+        aggregation?: {
+            method: 'average' | 'weighted_average' | 'min' | 'max' | 'sum';
+            weights?: Record<string, number>;
+        };
+        /** Pipeline config (for mixed validator -> executor commands) */
+        pipeline?: Array<{
+            agent: string;
+            output_as?: string;
+            input_from?: string;
+            filter?: string;
+        }>;
+        /** Output schema override (optional) */
+        output?: {
+            schema: string;
+        };
+    };
+}
+/**
+ * Preflight check definition
+ */
+export interface PreflightCheck {
+    /** Check type */
+    check: 'file_exists' | 'command' | 'env_var' | 'git_clean';
+    /** Path for file_exists check */
+    path?: string;
+    /** Command for command check */
+    command?: string;
+    /** Environment variable name for env_var check */
+    var?: string;
+    /** Error message shown when check fails */
+    message?: string;
+}
+/**
+ * Postflight action definition
+ */
+export interface PostflightAction {
+    type: 'report' | 'notify' | 'custom';
+    config: Record<string, unknown>;
+}
+/**
+ * Command execution result
+ */
+export interface CommandResult extends ExecutionResult {
+    type: 'command';
+    /** Agent type that was executed */
+    agentType: AgentType;
+    /** Maximum possible score (validators only) */
+    maxScore?: number;
+    /** Threshold for pass/fail (validators only) */
+    threshold?: number;
+    /** Per-category breakdown (validators only) */
+    categories?: CategoryResult[];
+    /** Generated artifacts (executors only) */
+    artifacts?: ArtifactResult[];
+    /** Command-specific metrics */
+    metrics: CommandMetrics;
+}
+/**
+ * Command-specific metrics (extends base)
+ */
+export interface CommandMetrics extends ExecutionMetrics {
+    /** Number of tool calls made */
+    toolCalls: number;
+}
+/**
+ * Category-level result (for validators)
+ */
+export interface CategoryResult {
+    /** Category name */
+    name: string;
+    /** Points earned */
+    score: number;
+    /** Maximum points possible */
+    maxPoints: number;
+    /** Findings within category */
+    findings: Finding[];
+}
+/**
+ * Finding within a category
+ */
+export interface Finding {
+    /** Criterion evaluated */
+    criterion: string;
+    /** Points earned */
+    pointsEarned: number;
+    /** Points possible */
+    pointsPossible: number;
+    /** Issues found */
+    issues: Issue[];
+}
+/**
+ * Individual issue (before flattening to Recommendation)
+ */
+export interface Issue {
+    title: string;
+    priority: 'critical' | 'suggested' | 'backlog';
+    severity: 'critical' | 'high' | 'medium' | 'low' | 'info';
+    failureCode?: string;
+    filePath?: string;
+    lineNumber?: number;
+    description: string;
+}
+/**
+ * Artifact result (for executors)
+ */
+export interface ArtifactResult {
+    name: string;
+    path: string;
+    size?: number;
+    contentType?: string;
+}
+//# sourceMappingURL=command.d.ts.map

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

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

package/dist/types/command.js

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

package/dist/types/command.js.map

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