@llm-dev-ops/agentics-cli 1.4.53 → 1.4.55

package/dist/bundled-agents/copilot-agents/functions/lib/services/agents/contracts/decomposer-schemas.d.ts

@@ -0,0 +1,315 @@
+/**
+ * Decomposer Agent Schemas
+ *
+ * Purpose: Decompose complex objectives into manageable sub-objectives
+ * Classification: DECOMPOSITION, STRUCTURAL_SYNTHESIS
+ * decision_type: objective_decomposition
+ *
+ * Scope:
+ * - Break complex objectives into sub-objectives
+ * - Identify sub-objective relationships
+ * - Assess decomposition completeness
+ *
+ * Must Never:
+ * - Execute sub-objectives
+ * - Assign agents
+ * - Allocate resources
+ * - Schedule execution
+ */
+import { z } from 'zod';
+/**
+ * A single sub-objective produced by decomposition
+ */
+export declare const SubObjectiveSchema: z.ZodObject<{
+    /** Unique identifier for this sub-objective */
+    sub_objective_id: z.ZodString;
+    /** Human-readable title */
+    title: z.ZodString;
+    /** Detailed description of the sub-objective */
+    description: z.ZodString;
+    /** Parent sub-objective ID (null for top-level) */
+    parent_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    /** Depth level in the decomposition tree (0 = top-level) */
+    depth: z.ZodNumber;
+    /** Dependencies on other sub-objectives */
+    dependencies: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        depends_on: z.ZodString;
+        type: z.ZodEnum<["blocking", "data", "sequential"]>;
+    }, "strip", z.ZodTypeAny, {
+        type: "blocking" | "data" | "sequential";
+        depends_on: string;
+    }, {
+        type: "blocking" | "data" | "sequential";
+        depends_on: string;
+    }>, "many">>;
+    /** Classification tags */
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** Estimated complexity */
+    complexity: z.ZodDefault<z.ZodEnum<["trivial", "simple", "moderate", "complex", "very_complex"]>>;
+    /** Whether this sub-objective can be further decomposed */
+    is_atomic: z.ZodDefault<z.ZodBoolean>;
+    /** Acceptance criteria for this sub-objective */
+    acceptance_criteria: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    dependencies: {
+        type: "blocking" | "data" | "sequential";
+        depends_on: string;
+    }[];
+    tags: string[];
+    title: string;
+    complexity: "simple" | "moderate" | "complex" | "very_complex" | "trivial";
+    sub_objective_id: string;
+    parent_id: string | null;
+    depth: number;
+    is_atomic: boolean;
+    acceptance_criteria: string[];
+}, {
+    description: string;
+    title: string;
+    sub_objective_id: string;
+    depth: number;
+    dependencies?: {
+        type: "blocking" | "data" | "sequential";
+        depends_on: string;
+    }[] | undefined;
+    tags?: string[] | undefined;
+    complexity?: "simple" | "moderate" | "complex" | "very_complex" | "trivial" | undefined;
+    parent_id?: string | null | undefined;
+    is_atomic?: boolean | undefined;
+    acceptance_criteria?: string[] | undefined;
+}>;
+export type SubObjective = z.infer<typeof SubObjectiveSchema>;
+/**
+ * Decomposer Agent Input Schema
+ */
+export declare const DecomposerInputSchema: z.ZodObject<{
+    /** The complex objective to decompose */
+    objective: z.ZodString;
+    /** Optional context to aid decomposition */
+    context: z.ZodOptional<z.ZodObject<{
+        /** Domain/industry context */
+        domain: z.ZodOptional<z.ZodString>;
+        /** Existing components or systems */
+        existing_components: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** Known constraints */
+        constraints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** Maximum decomposition depth */
+        max_depth: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        constraints?: string[] | undefined;
+        domain?: string | undefined;
+        existing_components?: string[] | undefined;
+        max_depth?: number | undefined;
+    }, {
+        constraints?: string[] | undefined;
+        domain?: string | undefined;
+        existing_components?: string[] | undefined;
+        max_depth?: number | undefined;
+    }>>;
+    /** Configuration for decomposition */
+    config: z.ZodOptional<z.ZodObject<{
+        /** Target granularity for leaf sub-objectives */
+        target_granularity: z.ZodOptional<z.ZodEnum<["coarse", "medium", "fine"]>>;
+        /** Maximum number of sub-objectives to produce */
+        max_sub_objectives: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        target_granularity?: "medium" | "coarse" | "fine" | undefined;
+        max_sub_objectives?: number | undefined;
+    }, {
+        target_granularity?: "medium" | "coarse" | "fine" | undefined;
+        max_sub_objectives?: number | undefined;
+    }>>;
+    /** Request ID for tracing */
+    request_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    objective: string;
+    context?: {
+        constraints?: string[] | undefined;
+        domain?: string | undefined;
+        existing_components?: string[] | undefined;
+        max_depth?: number | undefined;
+    } | undefined;
+    request_id?: string | undefined;
+    config?: {
+        target_granularity?: "medium" | "coarse" | "fine" | undefined;
+        max_sub_objectives?: number | undefined;
+    } | undefined;
+}, {
+    objective: string;
+    context?: {
+        constraints?: string[] | undefined;
+        domain?: string | undefined;
+        existing_components?: string[] | undefined;
+        max_depth?: number | undefined;
+    } | undefined;
+    request_id?: string | undefined;
+    config?: {
+        target_granularity?: "medium" | "coarse" | "fine" | undefined;
+        max_sub_objectives?: number | undefined;
+    } | undefined;
+}>;
+export type DecomposerInput = z.infer<typeof DecomposerInputSchema>;
+/**
+ * Decomposer Agent Output Schema
+ */
+export declare const DecomposerOutputSchema: z.ZodObject<{
+    /** Unique decomposition identifier */
+    decomposition_id: z.ZodString;
+    /** Original objective (echoed for verification) */
+    original_objective: z.ZodString;
+    /** List of sub-objectives produced */
+    sub_objectives: z.ZodArray<z.ZodObject<{
+        /** Unique identifier for this sub-objective */
+        sub_objective_id: z.ZodString;
+        /** Human-readable title */
+        title: z.ZodString;
+        /** Detailed description of the sub-objective */
+        description: z.ZodString;
+        /** Parent sub-objective ID (null for top-level) */
+        parent_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        /** Depth level in the decomposition tree (0 = top-level) */
+        depth: z.ZodNumber;
+        /** Dependencies on other sub-objectives */
+        dependencies: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            depends_on: z.ZodString;
+            type: z.ZodEnum<["blocking", "data", "sequential"]>;
+        }, "strip", z.ZodTypeAny, {
+            type: "blocking" | "data" | "sequential";
+            depends_on: string;
+        }, {
+            type: "blocking" | "data" | "sequential";
+            depends_on: string;
+        }>, "many">>;
+        /** Classification tags */
+        tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        /** Estimated complexity */
+        complexity: z.ZodDefault<z.ZodEnum<["trivial", "simple", "moderate", "complex", "very_complex"]>>;
+        /** Whether this sub-objective can be further decomposed */
+        is_atomic: z.ZodDefault<z.ZodBoolean>;
+        /** Acceptance criteria for this sub-objective */
+        acceptance_criteria: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        dependencies: {
+            type: "blocking" | "data" | "sequential";
+            depends_on: string;
+        }[];
+        tags: string[];
+        title: string;
+        complexity: "simple" | "moderate" | "complex" | "very_complex" | "trivial";
+        sub_objective_id: string;
+        parent_id: string | null;
+        depth: number;
+        is_atomic: boolean;
+        acceptance_criteria: string[];
+    }, {
+        description: string;
+        title: string;
+        sub_objective_id: string;
+        depth: number;
+        dependencies?: {
+            type: "blocking" | "data" | "sequential";
+            depends_on: string;
+        }[] | undefined;
+        tags?: string[] | undefined;
+        complexity?: "simple" | "moderate" | "complex" | "very_complex" | "trivial" | undefined;
+        parent_id?: string | null | undefined;
+        is_atomic?: boolean | undefined;
+        acceptance_criteria?: string[] | undefined;
+    }>, "many">;
+    /** Tree structure as adjacency list (parent -> children) */
+    tree_structure: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>;
+    /** Dependency graph as adjacency list */
+    dependency_graph: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>;
+    /** Analysis metadata */
+    analysis: z.ZodObject<{
+        /** Total number of sub-objectives */
+        total_sub_objectives: z.ZodNumber;
+        /** Maximum decomposition depth reached */
+        max_depth_reached: z.ZodNumber;
+        /** Number of atomic (leaf) sub-objectives */
+        atomic_count: z.ZodNumber;
+        /** Coverage assessment */
+        coverage_score: z.ZodNumber;
+        /** Complexity distribution */
+        complexity_distribution: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        /** Assumptions made during decomposition */
+        assumptions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        assumptions: string[];
+        total_sub_objectives: number;
+        max_depth_reached: number;
+        atomic_count: number;
+        coverage_score: number;
+        complexity_distribution: Record<string, number>;
+    }, {
+        total_sub_objectives: number;
+        max_depth_reached: number;
+        atomic_count: number;
+        coverage_score: number;
+        complexity_distribution: Record<string, number>;
+        assumptions?: string[] | undefined;
+    }>;
+    /** Decomposition version */
+    version: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    version: string;
+    dependency_graph: Record<string, string[]>;
+    analysis: {
+        assumptions: string[];
+        total_sub_objectives: number;
+        max_depth_reached: number;
+        atomic_count: number;
+        coverage_score: number;
+        complexity_distribution: Record<string, number>;
+    };
+    original_objective: string;
+    decomposition_id: string;
+    sub_objectives: {
+        description: string;
+        dependencies: {
+            type: "blocking" | "data" | "sequential";
+            depends_on: string;
+        }[];
+        tags: string[];
+        title: string;
+        complexity: "simple" | "moderate" | "complex" | "very_complex" | "trivial";
+        sub_objective_id: string;
+        parent_id: string | null;
+        depth: number;
+        is_atomic: boolean;
+        acceptance_criteria: string[];
+    }[];
+    tree_structure: Record<string, string[]>;
+}, {
+    dependency_graph: Record<string, string[]>;
+    analysis: {
+        total_sub_objectives: number;
+        max_depth_reached: number;
+        atomic_count: number;
+        coverage_score: number;
+        complexity_distribution: Record<string, number>;
+        assumptions?: string[] | undefined;
+    };
+    original_objective: string;
+    decomposition_id: string;
+    sub_objectives: {
+        description: string;
+        title: string;
+        sub_objective_id: string;
+        depth: number;
+        dependencies?: {
+            type: "blocking" | "data" | "sequential";
+            depends_on: string;
+        }[] | undefined;
+        tags?: string[] | undefined;
+        complexity?: "simple" | "moderate" | "complex" | "very_complex" | "trivial" | undefined;
+        parent_id?: string | null | undefined;
+        is_atomic?: boolean | undefined;
+        acceptance_criteria?: string[] | undefined;
+    }[];
+    tree_structure: Record<string, string[]>;
+    version?: string | undefined;
+}>;
+export type DecomposerOutput = z.infer<typeof DecomposerOutputSchema>;

package/dist/bundled-agents/copilot-agents/functions/lib/services/agents/contracts/decomposer-schemas.js

@@ -0,0 +1,110 @@
+"use strict";
+/**
+ * Decomposer Agent Schemas
+ *
+ * Purpose: Decompose complex objectives into manageable sub-objectives
+ * Classification: DECOMPOSITION, STRUCTURAL_SYNTHESIS
+ * decision_type: objective_decomposition
+ *
+ * Scope:
+ * - Break complex objectives into sub-objectives
+ * - Identify sub-objective relationships
+ * - Assess decomposition completeness
+ *
+ * Must Never:
+ * - Execute sub-objectives
+ * - Assign agents
+ * - Allocate resources
+ * - Schedule execution
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DecomposerOutputSchema = exports.DecomposerInputSchema = exports.SubObjectiveSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * A single sub-objective produced by decomposition
+ */
+exports.SubObjectiveSchema = zod_1.z.object({
+    /** Unique identifier for this sub-objective */
+    sub_objective_id: zod_1.z.string().min(1),
+    /** Human-readable title */
+    title: zod_1.z.string().min(1).max(200),
+    /** Detailed description of the sub-objective */
+    description: zod_1.z.string().min(1),
+    /** Parent sub-objective ID (null for top-level) */
+    parent_id: zod_1.z.string().nullable().default(null),
+    /** Depth level in the decomposition tree (0 = top-level) */
+    depth: zod_1.z.number().int().nonnegative(),
+    /** Dependencies on other sub-objectives */
+    dependencies: zod_1.z.array(zod_1.z.object({
+        depends_on: zod_1.z.string(),
+        type: zod_1.z.enum(['blocking', 'data', 'sequential']),
+    })).default([]),
+    /** Classification tags */
+    tags: zod_1.z.array(zod_1.z.string()).default([]),
+    /** Estimated complexity */
+    complexity: zod_1.z.enum(['trivial', 'simple', 'moderate', 'complex', 'very_complex']).default('moderate'),
+    /** Whether this sub-objective can be further decomposed */
+    is_atomic: zod_1.z.boolean().default(false),
+    /** Acceptance criteria for this sub-objective */
+    acceptance_criteria: zod_1.z.array(zod_1.z.string()).default([]),
+});
+/**
+ * Decomposer Agent Input Schema
+ */
+exports.DecomposerInputSchema = zod_1.z.object({
+    /** The complex objective to decompose */
+    objective: zod_1.z.string().min(1).max(50000),
+    /** Optional context to aid decomposition */
+    context: zod_1.z.object({
+        /** Domain/industry context */
+        domain: zod_1.z.string().optional(),
+        /** Existing components or systems */
+        existing_components: zod_1.z.array(zod_1.z.string()).optional(),
+        /** Known constraints */
+        constraints: zod_1.z.array(zod_1.z.string()).optional(),
+        /** Maximum decomposition depth */
+        max_depth: zod_1.z.number().int().positive().max(10).optional(),
+    }).optional(),
+    /** Configuration for decomposition */
+    config: zod_1.z.object({
+        /** Target granularity for leaf sub-objectives */
+        target_granularity: zod_1.z.enum(['coarse', 'medium', 'fine']).optional(),
+        /** Maximum number of sub-objectives to produce */
+        max_sub_objectives: zod_1.z.number().int().positive().max(50).optional(),
+    }).optional(),
+    /** Request ID for tracing */
+    request_id: zod_1.z.string().uuid().optional(),
+});
+/**
+ * Decomposer Agent Output Schema
+ */
+exports.DecomposerOutputSchema = zod_1.z.object({
+    /** Unique decomposition identifier */
+    decomposition_id: zod_1.z.string().uuid(),
+    /** Original objective (echoed for verification) */
+    original_objective: zod_1.z.string(),
+    /** List of sub-objectives produced */
+    sub_objectives: zod_1.z.array(exports.SubObjectiveSchema).min(1),
+    /** Tree structure as adjacency list (parent -> children) */
+    tree_structure: zod_1.z.record(zod_1.z.array(zod_1.z.string())),
+    /** Dependency graph as adjacency list */
+    dependency_graph: zod_1.z.record(zod_1.z.array(zod_1.z.string())),
+    /** Analysis metadata */
+    analysis: zod_1.z.object({
+        /** Total number of sub-objectives */
+        total_sub_objectives: zod_1.z.number().int().nonnegative(),
+        /** Maximum decomposition depth reached */
+        max_depth_reached: zod_1.z.number().int().nonnegative(),
+        /** Number of atomic (leaf) sub-objectives */
+        atomic_count: zod_1.z.number().int().nonnegative(),
+        /** Coverage assessment */
+        coverage_score: zod_1.z.number().min(0).max(1),
+        /** Complexity distribution */
+        complexity_distribution: zod_1.z.record(zod_1.z.number().int().nonnegative()),
+        /** Assumptions made during decomposition */
+        assumptions: zod_1.z.array(zod_1.z.string()).default([]),
+    }),
+    /** Decomposition version */
+    version: zod_1.z.string().default('1.0.0'),
+});
+//# sourceMappingURL=decomposer-schemas.js.map

package/dist/bundled-agents/copilot-agents/functions/lib/services/agents/contracts/decomposer-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decomposer-schemas.js","sourceRoot":"","sources":["../../../../../services/agents/contracts/decomposer-schemas.ts"],"names":[],"mappings":"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"}

package/dist/bundled-agents/copilot-agents/functions/lib/services/agents/contracts/execution-graph.d.ts

@@ -0,0 +1,250 @@
+/**
+ * Agentics Execution Graph - Foundational Execution Unit instrumentation.
+ *
+ * Defines the hierarchical execution span model that integrates this
+ * repository into the Agentics ExecutionGraph system.
+ *
+ * Invariant: Core → Repo (copilot-agent) → Agent (one or more)
+ */
+import { z } from 'zod';
+/** The name of this repository in the Agentics execution graph. */
+export declare const REPO_NAME = "copilot-agent";
+export declare const SpanTypeSchema: z.ZodEnum<["core", "repo", "agent"]>;
+export type SpanType = z.infer<typeof SpanTypeSchema>;
+export declare const ExecutionStatusSchema: z.ZodEnum<["running", "completed", "failed"]>;
+export type ExecutionStatus = z.infer<typeof ExecutionStatusSchema>;
+export declare const ArtifactSchema: z.ZodObject<{
+    name: z.ZodString;
+    artifact_type: z.ZodString;
+    reference: z.ZodString;
+    data: z.ZodUnknown;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    artifact_type: string;
+    reference: string;
+    data?: unknown;
+}, {
+    name: string;
+    artifact_type: string;
+    reference: string;
+    data?: unknown;
+}>;
+export type Artifact = z.infer<typeof ArtifactSchema>;
+export declare const ExecutionSpanSchema: z.ZodObject<{
+    span_id: z.ZodString;
+    parent_span_id: z.ZodString;
+    trace_id: z.ZodString;
+    span_type: z.ZodEnum<["core", "repo", "agent"]>;
+    repo_name: z.ZodOptional<z.ZodString>;
+    agent_name: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<["running", "completed", "failed"]>;
+    start_time: z.ZodString;
+    end_time: z.ZodOptional<z.ZodString>;
+    failure_reason: z.ZodOptional<z.ZodString>;
+    artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        artifact_type: z.ZodString;
+        reference: z.ZodString;
+        data: z.ZodUnknown;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        artifact_type: string;
+        reference: string;
+        data?: unknown;
+    }, {
+        name: string;
+        artifact_type: string;
+        reference: string;
+        data?: unknown;
+    }>, "many">>;
+    attributes: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    status: "completed" | "running" | "failed";
+    artifacts: {
+        name: string;
+        artifact_type: string;
+        reference: string;
+        data?: unknown;
+    }[];
+    span_id: string;
+    parent_span_id: string;
+    trace_id: string;
+    span_type: "core" | "repo" | "agent";
+    start_time: string;
+    attributes: Record<string, string>;
+    repo_name?: string | undefined;
+    agent_name?: string | undefined;
+    end_time?: string | undefined;
+    failure_reason?: string | undefined;
+}, {
+    status: "completed" | "running" | "failed";
+    span_id: string;
+    parent_span_id: string;
+    trace_id: string;
+    span_type: "core" | "repo" | "agent";
+    start_time: string;
+    artifacts?: {
+        name: string;
+        artifact_type: string;
+        reference: string;
+        data?: unknown;
+    }[] | undefined;
+    repo_name?: string | undefined;
+    agent_name?: string | undefined;
+    end_time?: string | undefined;
+    failure_reason?: string | undefined;
+    attributes?: Record<string, string> | undefined;
+}>;
+export type ExecutionSpan = z.infer<typeof ExecutionSpanSchema>;
+export declare const ExecutionGraphSchema: z.ZodObject<{
+    execution_id: z.ZodString;
+    repo_span_id: z.ZodString;
+    spans: z.ZodArray<z.ZodObject<{
+        span_id: z.ZodString;
+        parent_span_id: z.ZodString;
+        trace_id: z.ZodString;
+        span_type: z.ZodEnum<["core", "repo", "agent"]>;
+        repo_name: z.ZodOptional<z.ZodString>;
+        agent_name: z.ZodOptional<z.ZodString>;
+        status: z.ZodEnum<["running", "completed", "failed"]>;
+        start_time: z.ZodString;
+        end_time: z.ZodOptional<z.ZodString>;
+        failure_reason: z.ZodOptional<z.ZodString>;
+        artifacts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            artifact_type: z.ZodString;
+            reference: z.ZodString;
+            data: z.ZodUnknown;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            artifact_type: string;
+            reference: string;
+            data?: unknown;
+        }, {
+            name: string;
+            artifact_type: string;
+            reference: string;
+            data?: unknown;
+        }>, "many">>;
+        attributes: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        status: "completed" | "running" | "failed";
+        artifacts: {
+            name: string;
+            artifact_type: string;
+            reference: string;
+            data?: unknown;
+        }[];
+        span_id: string;
+        parent_span_id: string;
+        trace_id: string;
+        span_type: "core" | "repo" | "agent";
+        start_time: string;
+        attributes: Record<string, string>;
+        repo_name?: string | undefined;
+        agent_name?: string | undefined;
+        end_time?: string | undefined;
+        failure_reason?: string | undefined;
+    }, {
+        status: "completed" | "running" | "failed";
+        span_id: string;
+        parent_span_id: string;
+        trace_id: string;
+        span_type: "core" | "repo" | "agent";
+        start_time: string;
+        artifacts?: {
+            name: string;
+            artifact_type: string;
+            reference: string;
+            data?: unknown;
+        }[] | undefined;
+        repo_name?: string | undefined;
+        agent_name?: string | undefined;
+        end_time?: string | undefined;
+        failure_reason?: string | undefined;
+        attributes?: Record<string, string> | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    spans: {
+        status: "completed" | "running" | "failed";
+        artifacts: {
+            name: string;
+            artifact_type: string;
+            reference: string;
+            data?: unknown;
+        }[];
+        span_id: string;
+        parent_span_id: string;
+        trace_id: string;
+        span_type: "core" | "repo" | "agent";
+        start_time: string;
+        attributes: Record<string, string>;
+        repo_name?: string | undefined;
+        agent_name?: string | undefined;
+        end_time?: string | undefined;
+        failure_reason?: string | undefined;
+    }[];
+    execution_id: string;
+    repo_span_id: string;
+}, {
+    spans: {
+        status: "completed" | "running" | "failed";
+        span_id: string;
+        parent_span_id: string;
+        trace_id: string;
+        span_type: "core" | "repo" | "agent";
+        start_time: string;
+        artifacts?: {
+            name: string;
+            artifact_type: string;
+            reference: string;
+            data?: unknown;
+        }[] | undefined;
+        repo_name?: string | undefined;
+        agent_name?: string | undefined;
+        end_time?: string | undefined;
+        failure_reason?: string | undefined;
+        attributes?: Record<string, string> | undefined;
+    }[];
+    execution_id: string;
+    repo_span_id: string;
+}>;
+export type ExecutionGraphData = z.infer<typeof ExecutionGraphSchema>;
+/**
+ * Builds an ExecutionGraph for a single invocation of this repository.
+ *
+ * Usage:
+ * 1. Create via constructor (auto-creates repo span)
+ * 2. Call startAgentSpan() before each agent runs
+ * 3. Call completeAgentSpan() or failAgentSpan() when done
+ * 4. Call completeRepo() or failRepo() at the end
+ * 5. Call toJSON() to get the serialized graph
+ */
+export declare class ExecutionGraphBuilder {
+    private readonly executionId;
+    private readonly repoSpanId;
+    private readonly spans;
+    constructor(executionId: string, parentSpanId: string, traceId: string);
+    /** Start a new agent-level span as a child of the repo span. */
+    startAgentSpan(agentName: string): string;
+    /** Complete an agent-level span with optional artifacts. */
+    completeAgentSpan(spanId: string, artifacts?: Artifact[]): void;
+    /** Mark an agent-level span as failed. */
+    failAgentSpan(spanId: string, reason: string): void;
+    /**
+     * Complete the repo-level span.
+     * Throws if no agent-level spans were emitted.
+     */
+    completeRepo(): void;
+    /** Mark the repo-level span as failed, preserving all emitted spans. */
+    failRepo(reason: string): void;
+    /** Validate that at least one agent span exists. */
+    validate(): void;
+    /** Check if any agent spans exist. */
+    hasAgentSpans(): boolean;
+    /** Add an attribute to the repo-level span. */
+    setRepoAttribute(key: string, value: string): void;
+    /** Serialize the graph to a plain JSON-serializable object. */
+    toJSON(): ExecutionGraphData;
+    private findSpan;
+}