@perstack/core 0.0.52 → 0.0.53

package/dist/src/index.d.ts

@@ -601,14 +601,13 @@ declare const usageSchema: z.ZodObject<{
 //#endregion
 //#region src/schemas/checkpoint.d.ts
 /** Status of a checkpoint in the execution lifecycle */
-type CheckpointStatus = "init" | "proceeding" | "completed" | "stoppedByInteractiveTool" | "stoppedByDelegate" | "stoppedByExceededMaxSteps" | "stoppedByError" | "stoppedByCancellation";
+type CheckpointStatus = "init" | "proceeding" | "completed" | "stoppedByInteractiveTool" | "stoppedByDelegate" | "stoppedByError" | "stoppedByCancellation";
 declare const checkpointStatusSchema: z.ZodEnum<{
-  completed: "completed";
   init: "init";
   proceeding: "proceeding";
+  completed: "completed";
   stoppedByInteractiveTool: "stoppedByInteractiveTool";
   stoppedByDelegate: "stoppedByDelegate";
-  stoppedByExceededMaxSteps: "stoppedByExceededMaxSteps";
   stoppedByError: "stoppedByError";
   stoppedByCancellation: "stoppedByCancellation";
 }>;
@@ -699,12 +698,11 @@ declare const checkpointSchema: z.ZodObject<{
   jobId: z.ZodString;
   runId: z.ZodString;
   status: z.ZodEnum<{
-    completed: "completed";
     init: "init";
     proceeding: "proceeding";
+    completed: "completed";
     stoppedByInteractiveTool: "stoppedByInteractiveTool";
     stoppedByDelegate: "stoppedByDelegate";
-    stoppedByExceededMaxSteps: "stoppedByExceededMaxSteps";
     stoppedByError: "stoppedByError";
     stoppedByCancellation: "stoppedByCancellation";
   }>;
@@ -1202,7 +1200,11 @@ interface Expert {
   /** Provider tool options (e.g., webSearch maxUses, allowedDomains) */
   providerToolOptions?: ProviderToolOptions;
 }
-declare const expertSchema: z.ZodObject<{
+/**
+ * Base object schema for Expert. Use this for `.omit()` / `.pick()` operations.
+ * For parsing with delegation validation, use `expertSchema` instead.
+ */
+declare const expertBaseSchema: z.ZodObject<{
   key: z.ZodString;
   name: z.ZodString;
   version: z.ZodString;
@@ -1210,13 +1212,13 @@ declare const expertSchema: z.ZodObject<{
   instruction: z.ZodString;
   skills: z.ZodPipe<z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"mcpStdioSkill">;
-    command: z.ZodString;
-    args: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
     description: z.ZodOptional<z.ZodString>;
     rule: z.ZodOptional<z.ZodString>;
     pick: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
     omit: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    command: z.ZodString;
     packageName: z.ZodOptional<z.ZodString>;
+    args: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
     requiredEnv: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
   }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"mcpSseSkill">;
@@ -1227,6 +1229,8 @@ declare const expertSchema: z.ZodObject<{
     endpoint: z.ZodString;
   }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"interactiveSkill">;
+    description: z.ZodOptional<z.ZodString>;
+    rule: z.ZodOptional<z.ZodString>;
     tools: z.ZodPipe<z.ZodRecord<z.ZodString, z.ZodObject<{
       description: z.ZodOptional<z.ZodString>;
       inputJsonSchema: z.ZodString;
@@ -1240,8 +1244,6 @@ declare const expertSchema: z.ZodObject<{
       inputJsonSchema: string;
       description?: string | undefined;
     }>>>;
-    description: z.ZodOptional<z.ZodString>;
-    rule: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>], "type">>>>, z.ZodTransform<{
     [k: string]: {
       type: "mcpStdioSkill";
@@ -1277,10 +1279,147 @@ declare const expertSchema: z.ZodObject<{
     };
   }, Record<string, {
     type: "mcpStdioSkill";
+    pick: string[];
+    omit: string[];
     command: string;
     args: string[];
+    requiredEnv: string[];
+    description?: string | undefined;
+    rule?: string | undefined;
+    packageName?: string | undefined;
+  } | {
+    type: "mcpSseSkill";
     pick: string[];
     omit: string[];
+    endpoint: string;
+    description?: string | undefined;
+    rule?: string | undefined;
+  } | {
+    type: "interactiveSkill";
+    tools: {
+      [k: string]: {
+        name: string;
+        inputJsonSchema: string;
+        description?: string | undefined;
+      };
+    };
+    description?: string | undefined;
+    rule?: string | undefined;
+  }>>>;
+  delegates: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+  tags: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+  minRuntimeVersion: z.ZodDefault<z.ZodPipe<z.ZodString, z.ZodTransform<`v${number}.${number}`, string>>>;
+  providerTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  providerSkills: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"builtin">;
+    skillId: z.ZodEnum<{
+      pdf: "pdf";
+      docx: "docx";
+      pptx: "pptx";
+      xlsx: "xlsx";
+    }>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"custom">;
+    name: z.ZodString;
+    definition: z.ZodString;
+  }, z.core.$strip>], "type">>>;
+  providerToolOptions: z.ZodOptional<z.ZodObject<{
+    webSearch: z.ZodOptional<z.ZodObject<{
+      maxUses: z.ZodOptional<z.ZodNumber>;
+      allowedDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    webFetch: z.ZodOptional<z.ZodObject<{
+      maxUses: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    fileSearch: z.ZodOptional<z.ZodObject<{
+      vectorStoreIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      maxNumResults: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Expert schema with delegation rule validation.
+ * Rejects self-delegation, out-of-scope delegates, and delegate-to-own-coordinator.
+ */
+declare const expertSchema: z.ZodObject<{
+  key: z.ZodString;
+  name: z.ZodString;
+  version: z.ZodString;
+  description: z.ZodOptional<z.ZodString>;
+  instruction: z.ZodString;
+  skills: z.ZodPipe<z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"mcpStdioSkill">;
+    description: z.ZodOptional<z.ZodString>;
+    rule: z.ZodOptional<z.ZodString>;
+    pick: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    omit: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    command: z.ZodString;
+    packageName: z.ZodOptional<z.ZodString>;
+    args: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    requiredEnv: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"mcpSseSkill">;
+    description: z.ZodOptional<z.ZodString>;
+    rule: z.ZodOptional<z.ZodString>;
+    pick: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    omit: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    endpoint: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"interactiveSkill">;
+    description: z.ZodOptional<z.ZodString>;
+    rule: z.ZodOptional<z.ZodString>;
+    tools: z.ZodPipe<z.ZodRecord<z.ZodString, z.ZodObject<{
+      description: z.ZodOptional<z.ZodString>;
+      inputJsonSchema: z.ZodString;
+    }, z.core.$strip>>, z.ZodTransform<{
+      [k: string]: {
+        name: string;
+        inputJsonSchema: string;
+        description?: string | undefined;
+      };
+    }, Record<string, {
+      inputJsonSchema: string;
+      description?: string | undefined;
+    }>>>;
+  }, z.core.$strip>], "type">>>>, z.ZodTransform<{
+    [k: string]: {
+      type: "mcpStdioSkill";
+      name: string;
+      pick: string[];
+      omit: string[];
+      command: string;
+      args: string[];
+      requiredEnv: string[];
+      description?: string | undefined;
+      rule?: string | undefined;
+      packageName?: string | undefined;
+    } | {
+      type: "mcpSseSkill";
+      name: string;
+      pick: string[];
+      omit: string[];
+      endpoint: string;
+      description?: string | undefined;
+      rule?: string | undefined;
+    } | {
+      type: "interactiveSkill";
+      name: string;
+      tools: {
+        [k: string]: {
+          name: string;
+          inputJsonSchema: string;
+          description?: string | undefined;
+        };
+      };
+      description?: string | undefined;
+      rule?: string | undefined;
+    };
+  }, Record<string, {
+    type: "mcpStdioSkill";
+    pick: string[];
+    omit: string[];
+    command: string;
+    args: string[];
     requiredEnv: string[];
     description?: string | undefined;
     rule?: string | undefined;
@@ -1552,8 +1691,6 @@ interface PerstackConfig {
   model?: string;
   /** Reasoning budget for native LLM reasoning (extended thinking) */
   reasoningBudget?: ReasoningBudget;
-  /** Maximum steps per run */
-  maxSteps?: number;
   /** Maximum retries on generation failure */
   maxRetries?: number;
   /** Timeout per generation in milliseconds */
@@ -1632,7 +1769,6 @@ declare const perstackConfigSchema: z.ZodObject<{
     medium: "medium";
     high: "high";
   }>, z.ZodNumber]>>;
-  maxSteps: z.ZodOptional<z.ZodNumber>;
   maxRetries: z.ZodOptional<z.ZodNumber>;
   timeout: z.ZodOptional<z.ZodNumber>;
   experts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -2323,8 +2459,6 @@ interface RunSetting {
   experts: Record<string, Expert>;
   /** Reasoning budget for native LLM reasoning (extended thinking). Defaults to "low". Use "none" or 0 to disable. */
   reasoningBudget: ReasoningBudget;
-  /** Maximum steps before stopping (applies to Job's totalSteps) */
-  maxSteps: number;
   /** Maximum retries on generation failure */
   maxRetries: number;
   /** Timeout per generation in milliseconds */
@@ -2374,7 +2508,6 @@ type RunParamsInput = {
     input: RunInput;
     experts?: Record<string, ExpertInput>;
     reasoningBudget?: ReasoningBudget;
-    maxSteps?: number;
     maxRetries?: number;
     timeout?: number;
     startedAt?: number;
@@ -2458,13 +2591,13 @@ declare const runSettingSchema: z.ZodObject<{
     instruction: z.ZodString;
     skills: z.ZodPipe<z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
       type: z.ZodLiteral<"mcpStdioSkill">;
-      command: z.ZodString;
-      args: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
       description: z.ZodOptional<z.ZodString>;
       rule: z.ZodOptional<z.ZodString>;
       pick: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
       omit: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+      command: z.ZodString;
       packageName: z.ZodOptional<z.ZodString>;
+      args: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
       requiredEnv: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
     }, z.core.$strip>, z.ZodObject<{
       type: z.ZodLiteral<"mcpSseSkill">;
@@ -2475,6 +2608,8 @@ declare const runSettingSchema: z.ZodObject<{
       endpoint: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
       type: z.ZodLiteral<"interactiveSkill">;
+      description: z.ZodOptional<z.ZodString>;
+      rule: z.ZodOptional<z.ZodString>;
       tools: z.ZodPipe<z.ZodRecord<z.ZodString, z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
         inputJsonSchema: z.ZodString;
@@ -2488,8 +2623,6 @@ declare const runSettingSchema: z.ZodObject<{
         inputJsonSchema: string;
         description?: string | undefined;
       }>>>;
-      description: z.ZodOptional<z.ZodString>;
-      rule: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>], "type">>>>, z.ZodTransform<{
       [k: string]: {
         type: "mcpStdioSkill";
@@ -2525,10 +2658,10 @@ declare const runSettingSchema: z.ZodObject<{
       };
     }, Record<string, {
       type: "mcpStdioSkill";
-      command: string;
-      args: string[];
       pick: string[];
       omit: string[];
+      command: string;
+      args: string[];
       requiredEnv: string[];
       description?: string | undefined;
       rule?: string | undefined;
@@ -2590,7 +2723,6 @@ declare const runSettingSchema: z.ZodObject<{
     medium: "medium";
     high: "high";
   }>, z.ZodNumber]>>;
-  maxSteps: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
   maxRetries: z.ZodNumber;
   timeout: z.ZodNumber;
   startedAt: z.ZodNumber;
@@ -2666,9 +2798,6 @@ declare const runParamsSchema: z.ZodObject<{
       }, z.core.$strip>>;
     }, z.core.$strip>;
     experts: z.ZodPipe<z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-      name: z.ZodString;
-      description: z.ZodOptional<z.ZodString>;
-      version: z.ZodString;
       providerToolOptions: z.ZodOptional<z.ZodObject<{
         webSearch: z.ZodOptional<z.ZodObject<{
           maxUses: z.ZodOptional<z.ZodNumber>;
@@ -2682,16 +2811,19 @@ declare const runParamsSchema: z.ZodObject<{
           maxNumResults: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
       }, z.core.$strip>>;
+      name: z.ZodString;
+      version: z.ZodString;
+      description: z.ZodOptional<z.ZodString>;
       instruction: z.ZodString;
       skills: z.ZodPipe<z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<"mcpStdioSkill">;
-        command: z.ZodString;
-        args: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
         description: z.ZodOptional<z.ZodString>;
         rule: z.ZodOptional<z.ZodString>;
         pick: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
         omit: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+        command: z.ZodString;
         packageName: z.ZodOptional<z.ZodString>;
+        args: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
         requiredEnv: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
       }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"mcpSseSkill">;
@@ -2702,6 +2834,8 @@ declare const runParamsSchema: z.ZodObject<{
         endpoint: z.ZodString;
       }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"interactiveSkill">;
+        description: z.ZodOptional<z.ZodString>;
+        rule: z.ZodOptional<z.ZodString>;
         tools: z.ZodPipe<z.ZodRecord<z.ZodString, z.ZodObject<{
           description: z.ZodOptional<z.ZodString>;
           inputJsonSchema: z.ZodString;
@@ -2715,8 +2849,6 @@ declare const runParamsSchema: z.ZodObject<{
           inputJsonSchema: string;
           description?: string | undefined;
         }>>>;
-        description: z.ZodOptional<z.ZodString>;
-        rule: z.ZodOptional<z.ZodString>;
       }, z.core.$strip>], "type">>>>, z.ZodTransform<{
         [k: string]: {
           type: "mcpStdioSkill";
@@ -2752,10 +2884,10 @@ declare const runParamsSchema: z.ZodObject<{
         };
       }, Record<string, {
         type: "mcpStdioSkill";
-        command: string;
-        args: string[];
         pick: string[];
         omit: string[];
+        command: string;
+        args: string[];
         requiredEnv: string[];
         description?: string | undefined;
         rule?: string | undefined;
@@ -2904,7 +3036,6 @@ declare const runParamsSchema: z.ZodObject<{
       delegates: string[];
       tags: string[];
       minRuntimeVersion: `v${number}.${number}`;
-      description?: string | undefined;
       providerToolOptions?: {
         webSearch?: {
           maxUses?: number | undefined;
@@ -2918,6 +3049,7 @@ declare const runParamsSchema: z.ZodObject<{
           maxNumResults?: number | undefined;
         } | undefined;
       } | undefined;
+      description?: string | undefined;
       providerTools?: string[] | undefined;
       providerSkills?: ({
         type: "builtin";
@@ -2935,7 +3067,6 @@ declare const runParamsSchema: z.ZodObject<{
       medium: "medium";
       high: "high";
     }>, z.ZodNumber]>>>;
-    maxSteps: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     maxRetries: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     startedAt: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -2952,12 +3083,11 @@ declare const runParamsSchema: z.ZodObject<{
     jobId: z.ZodString;
     runId: z.ZodString;
     status: z.ZodEnum<{
-      completed: "completed";
       init: "init";
       proceeding: "proceeding";
+      completed: "completed";
       stoppedByInteractiveTool: "stoppedByInteractiveTool";
       stoppedByDelegate: "stoppedByDelegate";
-      stoppedByExceededMaxSteps: "stoppedByExceededMaxSteps";
       stoppedByError: "stoppedByError";
       stoppedByCancellation: "stoppedByCancellation";
     }>;
@@ -3239,10 +3369,6 @@ type ExpertStatePayloads = {
     checkpoint: Checkpoint;
     step: Step;
   };
-  stopRunByExceededMaxSteps: {
-    checkpoint: Checkpoint;
-    step: Step;
-  };
   stopRunByError: {
     checkpoint: Checkpoint;
     step: Step;
@@ -3332,7 +3458,7 @@ declare const startRun: (setting: RunSetting, checkpoint: Checkpoint, data: Omit
 } & {
   initialCheckpoint: Checkpoint;
   inputMessages: (InstructionMessage | UserMessage | ToolMessage)[];
-}, "id" | "expertKey" | "runId" | "type" | "jobId" | "stepNumber" | "timestamp">) => BaseEvent & {
+}, "type" | "id" | "jobId" | "runId" | "stepNumber" | "expertKey" | "timestamp">) => BaseEvent & {
   type: "startRun";
 } & {
   initialCheckpoint: Checkpoint;
@@ -3342,7 +3468,7 @@ declare const resumeFromStop: (setting: RunSetting, checkpoint: Checkpoint, data
   type: "resumeFromStop";
 } & {
   checkpoint: Checkpoint;
-}, "id" | "expertKey" | "runId" | "type" | "jobId" | "stepNumber" | "timestamp">) => BaseEvent & {
+}, "type" | "id" | "jobId" | "runId" | "stepNumber" | "expertKey" | "timestamp">) => BaseEvent & {
   type: "resumeFromStop";
 } & {
   checkpoint: Checkpoint;
@@ -3352,7 +3478,7 @@ declare const proceedToInteractiveTools: (setting: RunSetting, checkpoint: Check
 } & {
   pendingToolCalls: ToolCall[];
   partialToolResults: ToolResult[];
-}, "id" | "expertKey" | "runId" | "type" | "jobId" | "stepNumber" | "timestamp">) => BaseEvent & {
+}, "type" | "id" | "jobId" | "runId" | "stepNumber" | "expertKey" | "timestamp">) => BaseEvent & {
   type: "proceedToInteractiveTools";
 } & {
   pendingToolCalls: ToolCall[];
@@ -3362,7 +3488,7 @@ declare const startGeneration: (setting: RunSetting, checkpoint: Checkpoint, dat
   type: "startGeneration";
 } & {
   messages: Message[];
-}, "id" | "expertKey" | "runId" | "type" | "jobId" | "stepNumber" | "timestamp">) => BaseEvent & {
+}, "type" | "id" | "jobId" | "runId" | "stepNumber" | "expertKey" | "timestamp">) => BaseEvent & {
   type: "startGeneration";
 } & {
   messages: Message[];
@@ -3375,7 +3501,7 @@ declare const retry: (setting: RunSetting, checkpoint: Checkpoint, data: Omit<Ba
   toolCalls?: ToolCall[];
   toolResults?: ToolResult[];
   usage: Usage;
-}, "id" | "expertKey" | "runId" | "type" | "jobId" | "stepNumber" | "timestamp">) => BaseEvent & {
+}, "type" | "id" | "jobId" | "runId" | "stepNumber" | "expertKey" | "timestamp">) => BaseEvent & {
   type: "retry";
 } & {
   reason: string;
@@ -3390,7 +3516,7 @@ declare const callTools: (setting: RunSetting, checkpoint: Checkpoint, data: Omi
   newMessage: ExpertMessage;
   toolCalls: ToolCall[];
   usage: Usage;
-}, "id" | "expertKey" | "runId" | "type" | "jobId" | "stepNumber" | "timestamp">) => BaseEvent & {
+}, "type" | "id" | "jobId" | "runId" | "stepNumber" | "expertKey" | "timestamp">) => BaseEvent & {
   type: "callTools";
 } & {
   newMessage: ExpertMessage;
@@ -3402,7 +3528,7 @@ declare const finishMcpTools: (setting: RunSetting, checkpoint: Checkpoint, data
 } & {
   partialToolResults: ToolResult[];
   pendingToolCalls: ToolCall[];
-}, "id" | "expertKey" | "runId" | "type" | "jobId" | "stepNumber" | "timestamp">) => BaseEvent & {
+}, "type" | "id" | "jobId" | "runId" | "stepNumber" | "expertKey" | "timestamp">) => BaseEvent & {
   type: "finishMcpTools";
 } & {
   partialToolResults: ToolResult[];
@@ -3410,14 +3536,14 @@ declare const finishMcpTools: (setting: RunSetting, checkpoint: Checkpoint, data
 };
 declare const skipDelegates: (setting: RunSetting, checkpoint: Checkpoint, data: Omit<BaseEvent & {
   type: "skipDelegates";
-} & object, "id" | "expertKey" | "runId" | "type" | "jobId" | "stepNumber" | "timestamp">) => BaseEvent & {
+} & object, "type" | "id" | "jobId" | "runId" | "stepNumber" | "expertKey" | "timestamp">) => BaseEvent & {
   type: "skipDelegates";
 } & object;
 declare const resolveToolResults: (setting: RunSetting, checkpoint: Checkpoint, data: Omit<BaseEvent & {
   type: "resolveToolResults";
 } & {
   toolResults: ToolResult[];
-}, "id" | "expertKey" | "runId" | "type" | "jobId" | "stepNumber" | "timestamp">) => BaseEvent & {
+}, "type" | "id" | "jobId" | "runId" | "stepNumber" | "expertKey" | "timestamp">) => BaseEvent & {
   type: "resolveToolResults";
 } & {
   toolResults: ToolResult[];
@@ -3426,7 +3552,7 @@ declare const finishToolCall: (setting: RunSetting, checkpoint: Checkpoint, data
   type: "finishToolCall";
 } & {
   newMessages: (UserMessage | ToolMessage)[];
-}, "id" | "expertKey" | "runId" | "type" | "jobId" | "stepNumber" | "timestamp">) => BaseEvent & {
+}, "type" | "id" | "jobId" | "runId" | "stepNumber" | "expertKey" | "timestamp">) => BaseEvent & {
   type: "finishToolCall";
 } & {
   newMessages: (UserMessage | ToolMessage)[];
@@ -3436,7 +3562,7 @@ declare const resumeToolCalls: (setting: RunSetting, checkpoint: Checkpoint, dat
 } & {
   pendingToolCalls: ToolCall[];
   partialToolResults: ToolResult[];
-}, "id" | "expertKey" | "runId" | "type" | "jobId" | "stepNumber" | "timestamp">) => BaseEvent & {
+}, "type" | "id" | "jobId" | "runId" | "stepNumber" | "expertKey" | "timestamp">) => BaseEvent & {
   type: "resumeToolCalls";
 } & {
   pendingToolCalls: ToolCall[];
@@ -3449,7 +3575,7 @@ declare const completeRun: (setting: RunSetting, checkpoint: Checkpoint, data: O
   step: Step;
   text: string;
   usage: Usage;
-}, "id" | "expertKey" | "runId" | "type" | "jobId" | "stepNumber" | "timestamp">) => BaseEvent & {
+}, "type" | "id" | "jobId" | "runId" | "stepNumber" | "expertKey" | "timestamp">) => BaseEvent & {
   type: "completeRun";
 } & {
   checkpoint: Checkpoint;
@@ -3462,7 +3588,7 @@ declare const stopRunByInteractiveTool: (setting: RunSetting, checkpoint: Checkp
 } & {
   checkpoint: Checkpoint;
   step: Step;
-}, "id" | "expertKey" | "runId" | "type" | "jobId" | "stepNumber" | "timestamp">) => BaseEvent & {
+}, "type" | "id" | "jobId" | "runId" | "stepNumber" | "expertKey" | "timestamp">) => BaseEvent & {
   type: "stopRunByInteractiveTool";
 } & {
   checkpoint: Checkpoint;
@@ -3473,23 +3599,12 @@ declare const stopRunByDelegate: (setting: RunSetting, checkpoint: Checkpoint, d
 } & {
   checkpoint: Checkpoint;
   step: Step;
-}, "id" | "expertKey" | "runId" | "type" | "jobId" | "stepNumber" | "timestamp">) => BaseEvent & {
+}, "type" | "id" | "jobId" | "runId" | "stepNumber" | "expertKey" | "timestamp">) => BaseEvent & {
   type: "stopRunByDelegate";
 } & {
   checkpoint: Checkpoint;
   step: Step;
 };
-declare const stopRunByExceededMaxSteps: (setting: RunSetting, checkpoint: Checkpoint, data: Omit<BaseEvent & {
-  type: "stopRunByExceededMaxSteps";
-} & {
-  checkpoint: Checkpoint;
-  step: Step;
-}, "id" | "expertKey" | "runId" | "type" | "jobId" | "stepNumber" | "timestamp">) => BaseEvent & {
-  type: "stopRunByExceededMaxSteps";
-} & {
-  checkpoint: Checkpoint;
-  step: Step;
-};
 declare const stopRunByError: (setting: RunSetting, checkpoint: Checkpoint, data: Omit<BaseEvent & {
   type: "stopRunByError";
 } & {
@@ -3501,7 +3616,7 @@ declare const stopRunByError: (setting: RunSetting, checkpoint: Checkpoint, data
     statusCode?: number;
     isRetryable: boolean;
   };
-}, "id" | "expertKey" | "runId" | "type" | "jobId" | "stepNumber" | "timestamp">) => BaseEvent & {
+}, "type" | "id" | "jobId" | "runId" | "stepNumber" | "expertKey" | "timestamp">) => BaseEvent & {
   type: "stopRunByError";
 } & {
   checkpoint: Checkpoint;
@@ -3519,7 +3634,7 @@ declare const continueToNextStep: (setting: RunSetting, checkpoint: Checkpoint,
   checkpoint: Checkpoint;
   step: Step;
   nextCheckpoint: Checkpoint;
-}, "id" | "expertKey" | "runId" | "type" | "jobId" | "stepNumber" | "timestamp">) => BaseEvent & {
+}, "type" | "id" | "jobId" | "runId" | "stepNumber" | "expertKey" | "timestamp">) => BaseEvent & {
   type: "continueToNextStep";
 } & {
   checkpoint: Checkpoint;
@@ -3544,7 +3659,6 @@ type RuntimeEventPayloads = {
     expertName: string;
     experts: string[];
     model: string;
-    maxSteps?: number;
     maxRetries: number;
     timeout: number;
     query?: string;
@@ -3626,7 +3740,6 @@ declare const expertNameRegex: RegExp;
 declare const expertVersionRegex: RegExp;
 declare const tagNameRegex: RegExp;
 declare const maxExpertNameLength = 255;
-declare const defaultMaxSteps = 100;
 declare const defaultMaxRetries = 5;
 declare const defaultTimeout: number;
 declare const maxSkillNameLength = 255;
@@ -5805,14 +5918,13 @@ declare const activityOrGroupSchema: z.ZodUnion<readonly [z.ZodDiscriminatedUnio
 }, z.core.$strip>]>;
 //#endregion
 //#region src/schemas/job.d.ts
-type JobStatus = "running" | "completed" | "stoppedByMaxSteps" | "stoppedByInteractiveTool" | "stoppedByError" | "stoppedByCancellation";
+type JobStatus = "running" | "completed" | "stoppedByInteractiveTool" | "stoppedByError" | "stoppedByCancellation";
 declare const jobStatusSchema: z.ZodEnum<{
   completed: "completed";
   stoppedByInteractiveTool: "stoppedByInteractiveTool";
   stoppedByError: "stoppedByError";
   stoppedByCancellation: "stoppedByCancellation";
   running: "running";
-  stoppedByMaxSteps: "stoppedByMaxSteps";
 }>;
 interface Job {
   id: string;
@@ -5820,7 +5932,6 @@ interface Job {
   coordinatorExpertKey: string;
   runtimeVersion: RuntimeVersion;
   totalSteps: number;
-  maxSteps?: number;
   usage: Usage;
   startedAt: number;
   finishedAt?: number;
@@ -5833,12 +5944,10 @@ declare const jobSchema: z.ZodObject<{
     stoppedByError: "stoppedByError";
     stoppedByCancellation: "stoppedByCancellation";
     running: "running";
-    stoppedByMaxSteps: "stoppedByMaxSteps";
   }>;
   coordinatorExpertKey: z.ZodString;
   runtimeVersion: z.ZodPipe<z.ZodString, z.ZodTransform<`v${number}.${number}`, string>>;
   totalSteps: z.ZodNumber;
-  maxSteps: z.ZodOptional<z.ZodNumber>;
   usage: z.ZodObject<{
     inputTokens: z.ZodNumber;
     outputTokens: z.ZodNumber;
@@ -6003,8 +6112,6 @@ interface CommandOptions {
   model?: string;
   /** Reasoning budget for native LLM reasoning (extended thinking) */
   reasoningBudget?: ReasoningBudget;
-  /** Maximum steps */
-  maxSteps?: number;
   /** Maximum retries */
   maxRetries?: number;
   /** Timeout in milliseconds */
@@ -6060,7 +6167,6 @@ declare const runCommandInputSchema: z.ZodObject<{
       medium: "medium";
       high: "high";
     }>, z.ZodNumber]>>>;
-    maxSteps: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<number | undefined, string | undefined>>;
     maxRetries: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<number | undefined, string | undefined>>;
     timeout: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<number | undefined, string | undefined>>;
     jobId: z.ZodOptional<z.ZodString>;
@@ -6106,7 +6212,6 @@ declare const startCommandInputSchema: z.ZodObject<{
       medium: "medium";
       high: "high";
     }>, z.ZodNumber]>>>;
-    maxSteps: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<number | undefined, string | undefined>>;
     maxRetries: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<number | undefined, string | undefined>>;
     timeout: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<number | undefined, string | undefined>>;
     jobId: z.ZodOptional<z.ZodString>;
@@ -6212,9 +6317,42 @@ declare function validateEventFilter(filter: string[]): string[];
  */
 declare function createFilteredEventListener(listener: (event: PerstackEvent) => void, allowedTypes: Set<string>): (event: PerstackEvent) => void;
 //#endregion
+//#region src/utils/expert-type.d.ts
+type ExpertType = "coordinator" | "delegate";
+declare function getExpertType(expertName: string): ExpertType;
+declare function isCoordinatorExpert(expertName: string): boolean;
+declare function isDelegateExpert(expertName: string): boolean;
+/**
+ * Returns the scope of an expert.
+ * - Coordinator "game-producer" -> "game-producer"
+ * - Delegate "@game-producer/designer" -> "game-producer"
+ */
+declare function getExpertScope(expertName: string): string;
+/**
+ * Returns the short name of an expert.
+ * - Coordinator "game-producer" -> "game-producer"
+ * - Delegate "@game-producer/designer" -> "designer"
+ */
+declare function getExpertShortName(expertName: string): string;
+/**
+ * Validates whether a delegation from source to target is allowed.
+ * Returns null if valid, an error message string if invalid.
+ *
+ * Rules:
+ * - No self-delegation
+ * - If target is a delegate (@scope/name), source must be in the same scope
+ * - A delegate cannot delegate to its own coordinator
+ */
+declare function validateDelegation(source: string, target: string): string | null;
+/**
+ * Validates all delegations for an expert.
+ * Returns an array of error messages (empty if all valid).
+ */
+declare function validateAllDelegations(expertName: string, delegates: string[]): string[];
+//#endregion
 //#region src/utils/zod-error.d.ts
 declare function formatZodError(error: ZodError): string;
 declare function parseWithFriendlyError<T>(schema: ZodSchema<T>, data: unknown, context?: string): T;
 //#endregion
-export { Activity, ActivityOrGroup, ActivityType, AddDelegateActivity, AddSkillActivity, AmazonBedrockProviderConfig, AnthropicProviderConfig, AnthropicProviderSkill, AnthropicProviderToolName, AttemptCompletionActivity, AzureOpenAIProviderToolName, AzureOpenAiProviderConfig, BASE_SKILL_PREFIX, BaseEvent, BasePart, BuiltinAnthropicSkill, CallToolResultContent, Checkpoint, CheckpointStatus, ClearTodoActivity, CommandOptions, CompleteActivity, type CreateCheckpointParams, CreateExpertActivity, CustomAnthropicSkill, DeepseekProviderConfig, DelegateActivity, DelegateSkillManagerParams, DelegationCompleteActivity, DelegationTarget, EditTextFileActivity, ErrorActivity, EventForType, EventType, ExecActivity, Expert, ExpertMessage, ExpertStateEvent, ExpertStateEventType, FileBinaryPart, FileInlinePart, FileUrlPart, GeneralToolActivity, GetActivitiesParams, GoogleGenerativeAiProviderConfig, GoogleProviderToolName, GoogleVertexProviderConfig, Headers, ImageBinaryPart, ImageInlinePart, ImageUrlPart, InstructionMessage, InteractiveSkill, InteractiveSkillManagerParams, InteractiveTool, InteractiveToolActivity, Job, JobStatus, Lockfile, LockfileExpert, LockfileToolDefinition, McpSkillManagerParams, McpSseSkill, McpStdioSkill, Message, MessagePart, OllamaProviderConfig, OpenAIProviderToolName, OpenAiProviderConfig, ParallelActivitiesGroup, PerstackConfig, PerstackConfigExpert, PerstackConfigSkill, PerstackError, PerstackEvent, ProviderConfig, ProviderName, ProviderTable, ProviderToolOptions, QueryActivity, ReadImageFileActivity, ReadPdfFileActivity, ReadTextFileActivity, ReasoningBudget, RemoveDelegateActivity, RemoveSkillActivity, Resource, RetryActivity, RunCommandInput, RunEvent, RunInput, RunParams, RunParamsInput, RunSetting, RuntimeEvent, RuntimeEventForType, RuntimeEventType, RuntimeVersion, SAFE_ENV_VARS, Skill, SkillManagerParams, SkillType, StartCommandInput, Step, StreamingEvent, StreamingEventType, TextPart, ThinkingPart, TodoActivity, ToolCall, ToolCallPart, ToolDefinition, ToolMessage, ToolResult, ToolResultPart, Usage, UserMessage, VertexProviderToolName, WriteTextFileActivity, activityOrGroupSchema, activitySchema, addDelegateActivitySchema, addSkillActivitySchema, amazonBedrockProviderConfigSchema, anthropicProviderConfigSchema, anthropicProviderSkillSchema, anthropicProviderToolNameSchema, attemptCompletionActivitySchema, azureOpenAIProviderToolNameSchema, azureOpenAiProviderConfigSchema, basePartSchema, builtinAnthropicSkillSchema, callTools, checkpointSchema, checkpointStatusSchema, clearTodoActivitySchema, completeActivitySchema, completeRun, continueToNextStep, createBaseToolActivity, createCallToolsEvent, createCompleteRunEvent, createEmptyUsage, createEvent, createExpertActivitySchema, createFilteredEventListener, createGeneralToolActivity, createNormalizedCheckpoint, createResolveToolResultsEvent, createRuntimeEvent, createRuntimeInitEvent, createStartRunEvent, createStreamingEvent, createToolMessage, customAnthropicSkillSchema, deepseekProviderConfigSchema, defaultMaxRetries, defaultMaxSteps, defaultPerstackApiBaseUrl, defaultReasoningBudget, defaultTimeout, delegateActivitySchema, delegationCompleteActivitySchema, delegationTargetSchema, domainPatternSchema, editTextFileActivitySchema, errorActivitySchema, execActivitySchema, expertKeyRegex, expertMessageSchema, expertNameRegex, expertSchema, expertVersionRegex, fileBinaryPartSchema, fileInlinePartSchema, fileSearchOptionsSchema, fileUrlPartSchema, finishMcpTools, finishToolCall, formatZodError, generalToolActivitySchema, getActivities, getFilteredEnv, googleGenerativeAiProviderConfigSchema, googleProviderToolNameSchema, googleVertexProviderConfigSchema, headersSchema, imageBinaryPartSchema, imageInlinePartSchema, imageUrlPartSchema, instructionMessageSchema, interactiveSkillSchema, interactiveToolActivitySchema, interactiveToolSchema, isPrivateOrLocalIP, isValidEventType, isValidRuntimeEventType, jobSchema, jobStatusSchema, knownModels, lockfileExpertSchema, lockfileSchema, lockfileToolDefinitionSchema, maxExpertNameLength, maxSkillNameLength, maxSkillToolNameLength, mcpSseSkillSchema, mcpStdioSkillSchema, messagePartSchema, messageSchema, ollamaProviderConfigSchema, openAiProviderConfigSchema, openaiProviderToolNameSchema, parallelActivitiesGroupSchema, parseExpertKey, parseWithFriendlyError, perstackConfigSchema, proceedToInteractiveTools, providerConfigSchema, providerNameSchema, providerTableSchema, providerToolOptionsSchema, queryActivitySchema, readImageFileActivitySchema, readPdfFileActivitySchema, readTextFileActivitySchema, reasoningBudgetSchema, removeDelegateActivitySchema, removeSkillActivitySchema, resolveToolResults, resumeFromStop, resumeToolCalls, retry, retryActivitySchema, runCommandInputSchema, runParamsSchema, runSettingSchema, runtimeVersionSchema, skillSchema, skipDelegates, startCommandInputSchema, startGeneration, startRun, stepSchema, stopRunByDelegate, stopRunByError, stopRunByExceededMaxSteps, stopRunByInteractiveTool, tagNameRegex, textPartSchema, thinkingPartSchema, todoActivitySchema, toolCallPartSchema, toolCallSchema, toolMessageSchema, toolResultPartSchema, toolResultSchema, usageSchema, userMessageSchema, validateEventFilter, vertexProviderToolNameSchema, webFetchOptionsSchema, webSearchOptionsSchema, writeTextFileActivitySchema };
+export { Activity, ActivityOrGroup, ActivityType, AddDelegateActivity, AddSkillActivity, AmazonBedrockProviderConfig, AnthropicProviderConfig, AnthropicProviderSkill, AnthropicProviderToolName, AttemptCompletionActivity, AzureOpenAIProviderToolName, AzureOpenAiProviderConfig, BASE_SKILL_PREFIX, BaseEvent, BasePart, BuiltinAnthropicSkill, CallToolResultContent, Checkpoint, CheckpointStatus, ClearTodoActivity, CommandOptions, CompleteActivity, type CreateCheckpointParams, CreateExpertActivity, CustomAnthropicSkill, DeepseekProviderConfig, DelegateActivity, DelegateSkillManagerParams, DelegationCompleteActivity, DelegationTarget, EditTextFileActivity, ErrorActivity, EventForType, EventType, ExecActivity, Expert, ExpertMessage, ExpertStateEvent, ExpertStateEventType, ExpertType, FileBinaryPart, FileInlinePart, FileUrlPart, GeneralToolActivity, GetActivitiesParams, GoogleGenerativeAiProviderConfig, GoogleProviderToolName, GoogleVertexProviderConfig, Headers, ImageBinaryPart, ImageInlinePart, ImageUrlPart, InstructionMessage, InteractiveSkill, InteractiveSkillManagerParams, InteractiveTool, InteractiveToolActivity, Job, JobStatus, Lockfile, LockfileExpert, LockfileToolDefinition, McpSkillManagerParams, McpSseSkill, McpStdioSkill, Message, MessagePart, OllamaProviderConfig, OpenAIProviderToolName, OpenAiProviderConfig, ParallelActivitiesGroup, PerstackConfig, PerstackConfigExpert, PerstackConfigSkill, PerstackError, PerstackEvent, ProviderConfig, ProviderName, ProviderTable, ProviderToolOptions, QueryActivity, ReadImageFileActivity, ReadPdfFileActivity, ReadTextFileActivity, ReasoningBudget, RemoveDelegateActivity, RemoveSkillActivity, Resource, RetryActivity, RunCommandInput, RunEvent, RunInput, RunParams, RunParamsInput, RunSetting, RuntimeEvent, RuntimeEventForType, RuntimeEventType, RuntimeVersion, SAFE_ENV_VARS, Skill, SkillManagerParams, SkillType, StartCommandInput, Step, StreamingEvent, StreamingEventType, TextPart, ThinkingPart, TodoActivity, ToolCall, ToolCallPart, ToolDefinition, ToolMessage, ToolResult, ToolResultPart, Usage, UserMessage, VertexProviderToolName, WriteTextFileActivity, activityOrGroupSchema, activitySchema, addDelegateActivitySchema, addSkillActivitySchema, amazonBedrockProviderConfigSchema, anthropicProviderConfigSchema, anthropicProviderSkillSchema, anthropicProviderToolNameSchema, attemptCompletionActivitySchema, azureOpenAIProviderToolNameSchema, azureOpenAiProviderConfigSchema, basePartSchema, builtinAnthropicSkillSchema, callTools, checkpointSchema, checkpointStatusSchema, clearTodoActivitySchema, completeActivitySchema, completeRun, continueToNextStep, createBaseToolActivity, createCallToolsEvent, createCompleteRunEvent, createEmptyUsage, createEvent, createExpertActivitySchema, createFilteredEventListener, createGeneralToolActivity, createNormalizedCheckpoint, createResolveToolResultsEvent, createRuntimeEvent, createRuntimeInitEvent, createStartRunEvent, createStreamingEvent, createToolMessage, customAnthropicSkillSchema, deepseekProviderConfigSchema, defaultMaxRetries, defaultPerstackApiBaseUrl, defaultReasoningBudget, defaultTimeout, delegateActivitySchema, delegationCompleteActivitySchema, delegationTargetSchema, domainPatternSchema, editTextFileActivitySchema, errorActivitySchema, execActivitySchema, expertBaseSchema, expertKeyRegex, expertMessageSchema, expertNameRegex, expertSchema, expertVersionRegex, fileBinaryPartSchema, fileInlinePartSchema, fileSearchOptionsSchema, fileUrlPartSchema, finishMcpTools, finishToolCall, formatZodError, generalToolActivitySchema, getActivities, getExpertScope, getExpertShortName, getExpertType, getFilteredEnv, googleGenerativeAiProviderConfigSchema, googleProviderToolNameSchema, googleVertexProviderConfigSchema, headersSchema, imageBinaryPartSchema, imageInlinePartSchema, imageUrlPartSchema, instructionMessageSchema, interactiveSkillSchema, interactiveToolActivitySchema, interactiveToolSchema, isCoordinatorExpert, isDelegateExpert, isPrivateOrLocalIP, isValidEventType, isValidRuntimeEventType, jobSchema, jobStatusSchema, knownModels, lockfileExpertSchema, lockfileSchema, lockfileToolDefinitionSchema, maxExpertNameLength, maxSkillNameLength, maxSkillToolNameLength, mcpSseSkillSchema, mcpStdioSkillSchema, messagePartSchema, messageSchema, ollamaProviderConfigSchema, openAiProviderConfigSchema, openaiProviderToolNameSchema, parallelActivitiesGroupSchema, parseExpertKey, parseWithFriendlyError, perstackConfigSchema, proceedToInteractiveTools, providerConfigSchema, providerNameSchema, providerTableSchema, providerToolOptionsSchema, queryActivitySchema, readImageFileActivitySchema, readPdfFileActivitySchema, readTextFileActivitySchema, reasoningBudgetSchema, removeDelegateActivitySchema, removeSkillActivitySchema, resolveToolResults, resumeFromStop, resumeToolCalls, retry, retryActivitySchema, runCommandInputSchema, runParamsSchema, runSettingSchema, runtimeVersionSchema, skillSchema, skipDelegates, startCommandInputSchema, startGeneration, startRun, stepSchema, stopRunByDelegate, stopRunByError, stopRunByInteractiveTool, tagNameRegex, textPartSchema, thinkingPartSchema, todoActivitySchema, toolCallPartSchema, toolCallSchema, toolMessageSchema, toolResultPartSchema, toolResultSchema, usageSchema, userMessageSchema, validateAllDelegations, validateDelegation, validateEventFilter, vertexProviderToolNameSchema, webFetchOptionsSchema, webSearchOptionsSchema, writeTextFileActivitySchema };
 //# sourceMappingURL=index.d.ts.map