@llm-dev-ops/agentics-cli 1.4.52 → 1.4.54

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

@@ -0,0 +1,136 @@
+"use strict";
+/**
+ * Planner Agent Schemas
+ *
+ * Purpose: Translate clarified objectives into structured execution plans
+ * Classification: PLANNING, STRUCTURAL_SYNTHESIS
+ * decision_type: plan_generation
+ *
+ * Scope:
+ * - Generate ordered plan steps
+ * - Identify dependencies
+ * - Define sequencing
+ *
+ * Must Never:
+ * - Execute steps
+ * - Assign agents
+ * - Allocate resources
+ * - Schedule execution
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlannerOutputSchema = exports.PlannerInputSchema = exports.PlanStepSchema = exports.DependencySchema = void 0;
+const zod_1 = require("zod");
+const pipeline_schemas_1 = require("./pipeline-schemas");
+/**
+ * Dependency between plan steps
+ */
+exports.DependencySchema = zod_1.z.object({
+    /** ID of the step this depends on */
+    depends_on: zod_1.z.string(),
+    /** Type of dependency */
+    type: zod_1.z.enum([
+        'blocking', // Must complete before this step starts
+        'data', // Requires output data from dependency
+        'resource', // Shares resource that can't be concurrent
+        'sequential', // Must follow in sequence (order matters)
+    ]),
+    /** Optional: specific output field required from dependency */
+    required_output: zod_1.z.string().optional(),
+});
+/**
+ * Single step in an execution plan
+ */
+exports.PlanStepSchema = zod_1.z.object({
+    /** Unique step identifier within the plan */
+    step_id: zod_1.z.string().min(1),
+    /** Human-readable step name */
+    name: zod_1.z.string().min(1).max(200),
+    /** Detailed description of what this step accomplishes */
+    description: zod_1.z.string().min(1),
+    /** Order in sequence (0-indexed) */
+    sequence_order: zod_1.z.number().int().nonnegative(),
+    /** Dependencies on other steps */
+    dependencies: zod_1.z.array(exports.DependencySchema).default([]),
+    /** Expected inputs for this step */
+    expected_inputs: zod_1.z.array(zod_1.z.object({
+        name: zod_1.z.string(),
+        type: zod_1.z.string(),
+        description: zod_1.z.string(),
+        required: zod_1.z.boolean().default(true),
+    })).default([]),
+    /** Expected outputs from this step */
+    expected_outputs: zod_1.z.array(zod_1.z.object({
+        name: zod_1.z.string(),
+        type: zod_1.z.string(),
+        description: zod_1.z.string(),
+    })).default([]),
+    /** Classification tags for the step */
+    tags: zod_1.z.array(zod_1.z.string()).default([]),
+    /** Constraints that apply to this step (informational only) */
+    constraints: zod_1.z.array(zod_1.z.string()).default([]),
+    /** Whether this step can be parallelized with siblings */
+    parallelizable: zod_1.z.boolean().default(false),
+    /** Criticality level */
+    criticality: zod_1.z.enum(['low', 'medium', 'high', 'critical']).default('medium'),
+});
+/**
+ * Planner Agent Input Schema
+ */
+exports.PlannerInputSchema = zod_1.z.object({
+    /** The clarified objective to plan for */
+    objective: zod_1.z.string().min(1).max(10000),
+    /** Optional context about the domain/system */
+    context: zod_1.z.object({
+        domain: zod_1.z.string().optional(),
+        existing_components: zod_1.z.array(zod_1.z.string()).optional(),
+        constraints: zod_1.z.array(zod_1.z.string()).optional(),
+        preferences: zod_1.z.record(zod_1.z.string()).optional(),
+    }).optional(),
+    /** Optional hints about expected complexity */
+    hints: zod_1.z.object({
+        expected_step_count: zod_1.z.number().int().positive().optional(),
+        max_depth: zod_1.z.number().int().positive().optional(),
+        focus_areas: zod_1.z.array(zod_1.z.string()).optional(),
+    }).optional(),
+    /** Request ID for tracing */
+    request_id: zod_1.z.string().uuid().optional(),
+    /** Optional pipeline context for multi-agent orchestration */
+    pipeline_context: pipeline_schemas_1.PipelineContextSchema.optional(),
+});
+/**
+ * Planner Agent Output Schema
+ */
+exports.PlannerOutputSchema = zod_1.z.object({
+    /** Generated plan identifier */
+    plan_id: zod_1.z.string().uuid(),
+    /** The original objective (echoed for verification) */
+    objective_summary: zod_1.z.string(),
+    /** Ordered list of plan steps */
+    steps: zod_1.z.array(exports.PlanStepSchema).min(1),
+    /** Dependency graph as adjacency list */
+    dependency_graph: zod_1.z.record(zod_1.z.array(zod_1.z.string())),
+    /** Critical path through the plan (longest dependency chain) */
+    critical_path: zod_1.z.array(zod_1.z.string()),
+    /** Steps that can execute in parallel at each phase */
+    parallel_groups: zod_1.z.array(zod_1.z.array(zod_1.z.string())),
+    /** Analysis metadata */
+    analysis: zod_1.z.object({
+        /** Total number of steps */
+        total_steps: zod_1.z.number().int().nonnegative(),
+        /** Maximum dependency depth */
+        max_depth: zod_1.z.number().int().nonnegative(),
+        /** Number of parallelizable groups */
+        parallel_opportunities: zod_1.z.number().int().nonnegative(),
+        /** Identified risks or concerns (informational) */
+        risks: zod_1.z.array(zod_1.z.object({
+            description: zod_1.z.string(),
+            severity: zod_1.z.enum(['low', 'medium', 'high']),
+            affected_steps: zod_1.z.array(zod_1.z.string()),
+        })).default([]),
+        /** Assumptions made during planning */
+        assumptions: zod_1.z.array(zod_1.z.string()).default([]),
+    }),
+    /** Plan version for tracking iterations */
+    version: zod_1.z.string().default('1.0.0'),
+});
+//# sourceMappingURL=planner-schemas.js.map

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

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