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

package/dist/interfaces/chat/response.d.ts

@@ -1,6 +1,7 @@
 import type { ChatError } from "../../errors/endpoints/chat/index.js";
 import type { IllaToolErrorJSON } from "../../internal.js";
 import type { MessageHistoryType, PendingToolCallType } from "../../types/messages.js";
+import type { ExecutionPlan } from "../../types/planning.js";
 import type { BaseApiSuccessResponse } from "../base.js";
 /**
  * Success response for chat endpoint
@@ -12,6 +13,13 @@ export interface CoreApiChatSuccessResponse extends BaseApiSuccessResponse {
     readonly toolErrors?: ReadonlyArray<IllaToolErrorJSON>;
     /** Request ID for subscribing to telemetry events */
     readonly requestId?: string;
+    /** Planning agent output, present when the request involved plan generation or execution */
+    readonly planning?: {
+        readonly plan: ExecutionPlan;
+        readonly requiresApproval: boolean;
+        readonly replanReason?: string;
+        readonly dryRun?: boolean;
+    };
 }
 /**
  * Union type of all possible chat error responses

package/dist/interfaces/chat/response.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../../src/interfaces/chat/response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACvF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,sBAAsB;IACtE,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,CAAC,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAC3D,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;IACvD,qDAAqD;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,SAAS,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,0BAA0B,GAAG,wBAAwB,CAAC"}
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../../src/interfaces/chat/response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACvF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,sBAAsB;IACtE,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,CAAC,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAC3D,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;IACvD,qDAAqD;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,4FAA4F;IAC5F,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAChB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;QAC7B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;QACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;KAC7B,CAAC;CACL;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,SAAS,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,0BAA0B,GAAG,wBAAwB,CAAC"}

package/dist/schemas/chatContext.d.ts

@@ -195,6 +195,326 @@ export declare const ChatContextSchema: z.ZodObject<Pick<{
         channel: "text" | "voice";
     }>>>;
     requestId: z.ZodOptional<z.ZodString>;
+    agentPlanningConfig: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        cacheEnabled: z.ZodOptional<z.ZodBoolean>;
+        cacheTTL: z.ZodOptional<z.ZodNumber>;
+        forceRefresh: z.ZodOptional<z.ZodBoolean>;
+        planningModel: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        enabled?: boolean | undefined;
+        cacheEnabled?: boolean | undefined;
+        cacheTTL?: number | undefined;
+        forceRefresh?: boolean | undefined;
+        planningModel?: string | undefined;
+    }, {
+        enabled?: boolean | undefined;
+        cacheEnabled?: boolean | undefined;
+        cacheTTL?: number | undefined;
+        forceRefresh?: boolean | undefined;
+        planningModel?: string | undefined;
+    }>>;
+    acceptedPlan: z.ZodOptional<z.ZodObject<{
+        planId: z.ZodString;
+        version: z.ZodNumber;
+        isExecutable: z.ZodBoolean;
+        autoExecutable: z.ZodBoolean;
+        userSummary: z.ZodObject<{
+            title: z.ZodString;
+            description: z.ZodString;
+            steps: z.ZodArray<z.ZodObject<{
+                number: z.ZodNumber;
+                description: z.ZodString;
+                status: z.ZodEnum<["pending", "in_progress", "completed", "failed", "skipped"]>;
+                requiresApproval: z.ZodBoolean;
+            }, "strict", z.ZodTypeAny, {
+                number: number;
+                status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+                description: string;
+                requiresApproval: boolean;
+            }, {
+                number: number;
+                status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+                description: string;
+                requiresApproval: boolean;
+            }>, "many">;
+            warnings: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strict", z.ZodTypeAny, {
+            description: string;
+            title: string;
+            steps: {
+                number: number;
+                status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+                description: string;
+                requiresApproval: boolean;
+            }[];
+            warnings?: string[] | undefined;
+        }, {
+            description: string;
+            title: string;
+            steps: {
+                number: number;
+                status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+                description: string;
+                requiresApproval: boolean;
+            }[];
+            warnings?: string[] | undefined;
+        }>;
+        executionSchema: z.ZodObject<{
+            steps: z.ZodArray<z.ZodObject<{
+                stepNumber: z.ZodNumber;
+                description: z.ZodString;
+                operationType: z.ZodEnum<["read", "write"]>;
+                requiresUserApproval: z.ZodBoolean;
+                dependsOn: z.ZodArray<z.ZodNumber, "many">;
+                status: z.ZodEnum<["pending", "in_progress", "completed", "failed", "skipped"]>;
+                result: z.ZodOptional<z.ZodUnknown>;
+                toolName: z.ZodOptional<z.ZodString>;
+                executionInstructions: z.ZodObject<{
+                    objective: z.ZodString;
+                    inputSource: z.ZodRecord<z.ZodString, z.ZodString>;
+                    expectedOutput: z.ZodString;
+                    errorHandling: z.ZodString;
+                    constraints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                }, "strict", z.ZodTypeAny, {
+                    objective: string;
+                    inputSource: Record<string, string>;
+                    expectedOutput: string;
+                    errorHandling: string;
+                    constraints?: string[] | undefined;
+                }, {
+                    objective: string;
+                    inputSource: Record<string, string>;
+                    expectedOutput: string;
+                    errorHandling: string;
+                    constraints?: string[] | undefined;
+                }>;
+            }, "strict", z.ZodTypeAny, {
+                status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+                description: string;
+                stepNumber: number;
+                operationType: "read" | "write";
+                requiresUserApproval: boolean;
+                dependsOn: number[];
+                executionInstructions: {
+                    objective: string;
+                    inputSource: Record<string, string>;
+                    expectedOutput: string;
+                    errorHandling: string;
+                    constraints?: string[] | undefined;
+                };
+                result?: unknown;
+                toolName?: string | undefined;
+            }, {
+                status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+                description: string;
+                stepNumber: number;
+                operationType: "read" | "write";
+                requiresUserApproval: boolean;
+                dependsOn: number[];
+                executionInstructions: {
+                    objective: string;
+                    inputSource: Record<string, string>;
+                    expectedOutput: string;
+                    errorHandling: string;
+                    constraints?: string[] | undefined;
+                };
+                result?: unknown;
+                toolName?: string | undefined;
+            }>, "many">;
+            complexity: z.ZodEnum<["low", "medium", "high"]>;
+            recommendedModel: z.ZodString;
+            toolSequence: z.ZodArray<z.ZodString, "many">;
+            readOperations: z.ZodArray<z.ZodString, "many">;
+            writeOperations: z.ZodArray<z.ZodString, "many">;
+            pendingApprovals: z.ZodNumber;
+            availableTools: z.ZodArray<z.ZodString, "many">;
+        }, "strict", z.ZodTypeAny, {
+            steps: {
+                status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+                description: string;
+                stepNumber: number;
+                operationType: "read" | "write";
+                requiresUserApproval: boolean;
+                dependsOn: number[];
+                executionInstructions: {
+                    objective: string;
+                    inputSource: Record<string, string>;
+                    expectedOutput: string;
+                    errorHandling: string;
+                    constraints?: string[] | undefined;
+                };
+                result?: unknown;
+                toolName?: string | undefined;
+            }[];
+            complexity: "low" | "medium" | "high";
+            recommendedModel: string;
+            toolSequence: string[];
+            readOperations: string[];
+            writeOperations: string[];
+            pendingApprovals: number;
+            availableTools: string[];
+        }, {
+            steps: {
+                status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+                description: string;
+                stepNumber: number;
+                operationType: "read" | "write";
+                requiresUserApproval: boolean;
+                dependsOn: number[];
+                executionInstructions: {
+                    objective: string;
+                    inputSource: Record<string, string>;
+                    expectedOutput: string;
+                    errorHandling: string;
+                    constraints?: string[] | undefined;
+                };
+                result?: unknown;
+                toolName?: string | undefined;
+            }[];
+            complexity: "low" | "medium" | "high";
+            recommendedModel: string;
+            toolSequence: string[];
+            readOperations: string[];
+            writeOperations: string[];
+            pendingApprovals: number;
+            availableTools: string[];
+        }>;
+        conflicts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<["conflicting_intent", "impossible_task", "missing_tool", "missing_context", "unsupported_operation"]>;
+            message: z.ZodString;
+            suggestion: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            message: string;
+            type: "conflicting_intent" | "impossible_task" | "missing_tool" | "missing_context" | "unsupported_operation";
+            suggestion?: string | undefined;
+        }, {
+            message: string;
+            type: "conflicting_intent" | "impossible_task" | "missing_tool" | "missing_context" | "unsupported_operation";
+            suggestion?: string | undefined;
+        }>, "many">>;
+        replanContext: z.ZodOptional<z.ZodObject<{
+            previousPlanId: z.ZodString;
+            replanReason: z.ZodString;
+            preservedSteps: z.ZodArray<z.ZodNumber, "many">;
+        }, "strict", z.ZodTypeAny, {
+            previousPlanId: string;
+            replanReason: string;
+            preservedSteps: number[];
+        }, {
+            previousPlanId: string;
+            replanReason: string;
+            preservedSteps: number[];
+        }>>;
+        createdAt: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        planId: string;
+        version: number;
+        isExecutable: boolean;
+        autoExecutable: boolean;
+        userSummary: {
+            description: string;
+            title: string;
+            steps: {
+                number: number;
+                status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+                description: string;
+                requiresApproval: boolean;
+            }[];
+            warnings?: string[] | undefined;
+        };
+        executionSchema: {
+            steps: {
+                status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+                description: string;
+                stepNumber: number;
+                operationType: "read" | "write";
+                requiresUserApproval: boolean;
+                dependsOn: number[];
+                executionInstructions: {
+                    objective: string;
+                    inputSource: Record<string, string>;
+                    expectedOutput: string;
+                    errorHandling: string;
+                    constraints?: string[] | undefined;
+                };
+                result?: unknown;
+                toolName?: string | undefined;
+            }[];
+            complexity: "low" | "medium" | "high";
+            recommendedModel: string;
+            toolSequence: string[];
+            readOperations: string[];
+            writeOperations: string[];
+            pendingApprovals: number;
+            availableTools: string[];
+        };
+        createdAt: string;
+        conflicts?: {
+            message: string;
+            type: "conflicting_intent" | "impossible_task" | "missing_tool" | "missing_context" | "unsupported_operation";
+            suggestion?: string | undefined;
+        }[] | undefined;
+        replanContext?: {
+            previousPlanId: string;
+            replanReason: string;
+            preservedSteps: number[];
+        } | undefined;
+    }, {
+        planId: string;
+        version: number;
+        isExecutable: boolean;
+        autoExecutable: boolean;
+        userSummary: {
+            description: string;
+            title: string;
+            steps: {
+                number: number;
+                status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+                description: string;
+                requiresApproval: boolean;
+            }[];
+            warnings?: string[] | undefined;
+        };
+        executionSchema: {
+            steps: {
+                status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+                description: string;
+                stepNumber: number;
+                operationType: "read" | "write";
+                requiresUserApproval: boolean;
+                dependsOn: number[];
+                executionInstructions: {
+                    objective: string;
+                    inputSource: Record<string, string>;
+                    expectedOutput: string;
+                    errorHandling: string;
+                    constraints?: string[] | undefined;
+                };
+                result?: unknown;
+                toolName?: string | undefined;
+            }[];
+            complexity: "low" | "medium" | "high";
+            recommendedModel: string;
+            toolSequence: string[];
+            readOperations: string[];
+            writeOperations: string[];
+            pendingApprovals: number;
+            availableTools: string[];
+        };
+        createdAt: string;
+        conflicts?: {
+            message: string;
+            type: "conflicting_intent" | "impossible_task" | "missing_tool" | "missing_context" | "unsupported_operation";
+            suggestion?: string | undefined;
+        }[] | undefined;
+        replanContext?: {
+            previousPlanId: string;
+            replanReason: string;
+            preservedSteps: number[];
+        } | undefined;
+    }>>;
+    dryRun: z.ZodOptional<z.ZodBoolean>;
 }, "messages"> & {
     toolsConfig: z.ZodObject<{
         autoRouter: z.ZodOptional<z.ZodObject<{

package/dist/schemas/chatContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chatContext.d.ts","sourceRoot":"","sources":["../../src/schemas/chatContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAI7B,CAAC"}
+{"version":3,"file":"chatContext.d.ts","sourceRoot":"","sources":["../../src/schemas/chatContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAI7B,CAAC"}