@illalabs/interfaces 0.3.0 → 0.4.0-canary-beta-52713059

package/dist/schemas/planning.js

@@ -0,0 +1,153 @@
+import { z } from "zod";
+/**
+ * Plan step status values
+ */
+export const planStepStatusValues = [
+    "pending",
+    "in_progress",
+    "completed",
+    "failed",
+    "skipped",
+];
+/**
+ * Plan complexity levels
+ */
+export const planComplexityValues = ["low", "medium", "high"];
+/**
+ * Operation types for plan steps
+ */
+export const operationTypeValues = ["read", "write"];
+/**
+ * Conflict types for plan validation
+ */
+export const planConflictTypeValues = [
+    "conflicting_intent",
+    "impossible_task",
+    "missing_tool",
+    "missing_context",
+    "unsupported_operation",
+];
+/**
+ * Plan execution status values
+ */
+export const planExecutionStatusValues = ["success", "partial", "failed"];
+/**
+ * Schema for plan step execution instructions
+ */
+export const PlanStepExecutionInstructionsSchema = z
+    .object({
+    objective: z.string(),
+    /** Maps input parameter names to their source references (e.g., "from_context.userContext.address") */
+    inputSource: z.record(z.string(), z.string()),
+    expectedOutput: z.string(),
+    errorHandling: z.string(),
+    constraints: z.array(z.string()).optional(),
+})
+    .strict();
+/**
+ * Schema for individual plan steps
+ */
+export const PlanStepSchema = z
+    .object({
+    stepNumber: z.number().int().positive(),
+    description: z.string(),
+    operationType: z.enum(operationTypeValues),
+    requiresUserApproval: z.boolean(),
+    dependsOn: z.array(z.number().int().positive()),
+    status: z.enum(planStepStatusValues),
+    /** Step execution result. Structure varies by tool - typically contains tool-specific output data. */
+    result: z.unknown().optional(),
+    toolName: z.string().optional(),
+    executionInstructions: PlanStepExecutionInstructionsSchema,
+})
+    .strict();
+/**
+ * Schema for user-readable summary step
+ */
+export const PlanUserSummaryStepSchema = z
+    .object({
+    number: z.number().int().positive(),
+    description: z.string(),
+    status: z.enum(planStepStatusValues),
+    requiresApproval: z.boolean(),
+})
+    .strict();
+/**
+ * Schema for human-readable plan summary
+ */
+export const PlanUserSummarySchema = z
+    .object({
+    title: z.string(),
+    description: z.string(),
+    steps: z.array(PlanUserSummaryStepSchema),
+    warnings: z.array(z.string()).optional(),
+})
+    .strict();
+/**
+ * Schema for machine-readable execution details
+ */
+export const PlanExecutionDetailsSchema = z
+    .object({
+    steps: z.array(PlanStepSchema),
+    complexity: z.enum(planComplexityValues),
+    recommendedModel: z.string(),
+    /** Ordered tool names for execution — may differ from steps[].toolName when steps run in parallel or tools are reused */
+    toolSequence: z.array(z.string()),
+    /** Descriptions of read operations for quick plan summary (derived from read-type steps) */
+    readOperations: z.array(z.string()),
+    /** Descriptions of write operations for quick plan summary (derived from write-type steps) */
+    writeOperations: z.array(z.string()),
+    pendingApprovals: z.number().int().nonnegative(),
+    /** All tools the plan may invoke, including conditional/fallback tools not tied to specific steps */
+    availableTools: z.array(z.string()),
+})
+    .strict();
+/**
+ * Schema for plan conflicts
+ */
+export const PlanConflictSchema = z
+    .object({
+    type: z.enum(planConflictTypeValues),
+    message: z.string(),
+    suggestion: z.string().optional(),
+})
+    .strict();
+/**
+ * Schema for re-plan context
+ */
+export const ReplanContextSchema = z
+    .object({
+    previousPlanId: z.string().uuid(),
+    replanReason: z.string(),
+    preservedSteps: z.array(z.number().int().positive()),
+})
+    .strict();
+/**
+ * Schema for complete execution plan
+ */
+export const ExecutionPlanSchema = z
+    .object({
+    planId: z.string().uuid(),
+    version: z.number().int().positive(),
+    isExecutable: z.boolean(),
+    autoExecutable: z.boolean(),
+    userSummary: PlanUserSummarySchema,
+    executionSchema: PlanExecutionDetailsSchema,
+    conflicts: z.array(PlanConflictSchema).optional(),
+    replanContext: ReplanContextSchema.optional(),
+    createdAt: z.string().datetime(),
+})
+    .strict();
+/**
+ * Schema for planning configuration
+ */
+export const AgentPlanningConfigSchema = z
+    .object({
+    enabled: z.boolean().optional(),
+    cacheEnabled: z.boolean().optional(),
+    cacheTTL: z.number().int().positive().optional(),
+    forceRefresh: z.boolean().optional(),
+    planningModel: z.string().optional(),
+})
+    .strict();
+//# sourceMappingURL=planning.js.map

package/dist/schemas/planning.js.map

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