@perstack/core 0.0.53 → 0.0.55

package/dist/src/index.d.ts

@@ -1212,13 +1212,13 @@ declare const expertBaseSchema: z.ZodObject<{
   instruction: z.ZodString;
   skills: z.ZodPipe<z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"mcpStdioSkill">;
+    args: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    command: 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">;
@@ -1229,8 +1229,6 @@ declare const expertBaseSchema: 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;
@@ -1244,6 +1242,8 @@ declare const expertBaseSchema: 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";
@@ -1279,10 +1279,10 @@ declare const expertBaseSchema: z.ZodObject<{
     };
   }, Record<string, {
     type: "mcpStdioSkill";
+    args: string[];
+    command: string;
     pick: string[];
     omit: string[];
-    command: string;
-    args: string[];
     requiredEnv: string[];
     description?: string | undefined;
     rule?: string | undefined;
@@ -1349,13 +1349,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">;
+    args: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    command: 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">;
@@ -1366,8 +1366,6 @@ 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;
@@ -1381,6 +1379,8 @@ 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";
@@ -1416,10 +1416,10 @@ declare const expertSchema: z.ZodObject<{
     };
   }, Record<string, {
     type: "mcpStdioSkill";
+    args: string[];
+    command: string;
     pick: string[];
     omit: string[];
-    command: string;
-    args: string[];
     requiredEnv: string[];
     description?: string | undefined;
     rule?: string | undefined;
@@ -2591,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">;
+      args: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+      command: 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">;
@@ -2608,8 +2608,6 @@ 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;
@@ -2623,6 +2621,8 @@ 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";
@@ -2658,10 +2658,10 @@ declare const runSettingSchema: z.ZodObject<{
       };
     }, Record<string, {
       type: "mcpStdioSkill";
+      args: string[];
+      command: string;
       pick: string[];
       omit: string[];
-      command: string;
-      args: string[];
       requiredEnv: string[];
       description?: string | undefined;
       rule?: string | undefined;
@@ -2798,6 +2798,9 @@ 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;
+      version: z.ZodString;
+      description: z.ZodOptional<z.ZodString>;
       providerToolOptions: z.ZodOptional<z.ZodObject<{
         webSearch: z.ZodOptional<z.ZodObject<{
           maxUses: z.ZodOptional<z.ZodNumber>;
@@ -2811,19 +2814,16 @@ 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">;
+        args: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+        command: 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">;
@@ -2834,8 +2834,6 @@ 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;
@@ -2849,6 +2847,8 @@ 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";
@@ -2884,10 +2884,10 @@ declare const runParamsSchema: z.ZodObject<{
         };
       }, Record<string, {
         type: "mcpStdioSkill";
+        args: string[];
+        command: string;
         pick: string[];
         omit: string[];
-        command: string;
-        args: string[];
         requiredEnv: string[];
         description?: string | undefined;
         rule?: string | undefined;
@@ -3036,6 +3036,7 @@ declare const runParamsSchema: z.ZodObject<{
       delegates: string[];
       tags: string[];
       minRuntimeVersion: `v${number}.${number}`;
+      description?: string | undefined;
       providerToolOptions?: {
         webSearch?: {
           maxUses?: number | undefined;
@@ -3049,7 +3050,6 @@ declare const runParamsSchema: z.ZodObject<{
           maxNumResults?: number | undefined;
         } | undefined;
       } | undefined;
-      description?: string | undefined;
       providerTools?: string[] | undefined;
       providerSkills?: ({
         type: "builtin";
@@ -3458,7 +3458,7 @@ declare const startRun: (setting: RunSetting, checkpoint: Checkpoint, data: Omit
 } & {
   initialCheckpoint: Checkpoint;
   inputMessages: (InstructionMessage | UserMessage | ToolMessage)[];
-}, "type" | "id" | "jobId" | "runId" | "stepNumber" | "expertKey" | "timestamp">) => BaseEvent & {
+}, "id" | "jobId" | "runId" | "stepNumber" | "type" | "expertKey" | "timestamp">) => BaseEvent & {
   type: "startRun";
 } & {
   initialCheckpoint: Checkpoint;
@@ -3468,7 +3468,7 @@ declare const resumeFromStop: (setting: RunSetting, checkpoint: Checkpoint, data
   type: "resumeFromStop";
 } & {
   checkpoint: Checkpoint;
-}, "type" | "id" | "jobId" | "runId" | "stepNumber" | "expertKey" | "timestamp">) => BaseEvent & {
+}, "id" | "jobId" | "runId" | "stepNumber" | "type" | "expertKey" | "timestamp">) => BaseEvent & {
   type: "resumeFromStop";
 } & {
   checkpoint: Checkpoint;
@@ -3478,7 +3478,7 @@ declare const proceedToInteractiveTools: (setting: RunSetting, checkpoint: Check
 } & {
   pendingToolCalls: ToolCall[];
   partialToolResults: ToolResult[];
-}, "type" | "id" | "jobId" | "runId" | "stepNumber" | "expertKey" | "timestamp">) => BaseEvent & {
+}, "id" | "jobId" | "runId" | "stepNumber" | "type" | "expertKey" | "timestamp">) => BaseEvent & {
   type: "proceedToInteractiveTools";
 } & {
   pendingToolCalls: ToolCall[];
@@ -3488,7 +3488,7 @@ declare const startGeneration: (setting: RunSetting, checkpoint: Checkpoint, dat
   type: "startGeneration";
 } & {
   messages: Message[];
-}, "type" | "id" | "jobId" | "runId" | "stepNumber" | "expertKey" | "timestamp">) => BaseEvent & {
+}, "id" | "jobId" | "runId" | "stepNumber" | "type" | "expertKey" | "timestamp">) => BaseEvent & {
   type: "startGeneration";
 } & {
   messages: Message[];
@@ -3501,7 +3501,7 @@ declare const retry: (setting: RunSetting, checkpoint: Checkpoint, data: Omit<Ba
   toolCalls?: ToolCall[];
   toolResults?: ToolResult[];
   usage: Usage;
-}, "type" | "id" | "jobId" | "runId" | "stepNumber" | "expertKey" | "timestamp">) => BaseEvent & {
+}, "id" | "jobId" | "runId" | "stepNumber" | "type" | "expertKey" | "timestamp">) => BaseEvent & {
   type: "retry";
 } & {
   reason: string;
@@ -3516,7 +3516,7 @@ declare const callTools: (setting: RunSetting, checkpoint: Checkpoint, data: Omi
   newMessage: ExpertMessage;
   toolCalls: ToolCall[];
   usage: Usage;
-}, "type" | "id" | "jobId" | "runId" | "stepNumber" | "expertKey" | "timestamp">) => BaseEvent & {
+}, "id" | "jobId" | "runId" | "stepNumber" | "type" | "expertKey" | "timestamp">) => BaseEvent & {
   type: "callTools";
 } & {
   newMessage: ExpertMessage;
@@ -3528,7 +3528,7 @@ declare const finishMcpTools: (setting: RunSetting, checkpoint: Checkpoint, data
 } & {
   partialToolResults: ToolResult[];
   pendingToolCalls: ToolCall[];
-}, "type" | "id" | "jobId" | "runId" | "stepNumber" | "expertKey" | "timestamp">) => BaseEvent & {
+}, "id" | "jobId" | "runId" | "stepNumber" | "type" | "expertKey" | "timestamp">) => BaseEvent & {
   type: "finishMcpTools";
 } & {
   partialToolResults: ToolResult[];
@@ -3536,14 +3536,14 @@ declare const finishMcpTools: (setting: RunSetting, checkpoint: Checkpoint, data
 };
 declare const skipDelegates: (setting: RunSetting, checkpoint: Checkpoint, data: Omit<BaseEvent & {
   type: "skipDelegates";
-} & object, "type" | "id" | "jobId" | "runId" | "stepNumber" | "expertKey" | "timestamp">) => BaseEvent & {
+} & object, "id" | "jobId" | "runId" | "stepNumber" | "type" | "expertKey" | "timestamp">) => BaseEvent & {
   type: "skipDelegates";
 } & object;
 declare const resolveToolResults: (setting: RunSetting, checkpoint: Checkpoint, data: Omit<BaseEvent & {
   type: "resolveToolResults";
 } & {
   toolResults: ToolResult[];
-}, "type" | "id" | "jobId" | "runId" | "stepNumber" | "expertKey" | "timestamp">) => BaseEvent & {
+}, "id" | "jobId" | "runId" | "stepNumber" | "type" | "expertKey" | "timestamp">) => BaseEvent & {
   type: "resolveToolResults";
 } & {
   toolResults: ToolResult[];
@@ -3552,7 +3552,7 @@ declare const finishToolCall: (setting: RunSetting, checkpoint: Checkpoint, data
   type: "finishToolCall";
 } & {
   newMessages: (UserMessage | ToolMessage)[];
-}, "type" | "id" | "jobId" | "runId" | "stepNumber" | "expertKey" | "timestamp">) => BaseEvent & {
+}, "id" | "jobId" | "runId" | "stepNumber" | "type" | "expertKey" | "timestamp">) => BaseEvent & {
   type: "finishToolCall";
 } & {
   newMessages: (UserMessage | ToolMessage)[];
@@ -3562,7 +3562,7 @@ declare const resumeToolCalls: (setting: RunSetting, checkpoint: Checkpoint, dat
 } & {
   pendingToolCalls: ToolCall[];
   partialToolResults: ToolResult[];
-}, "type" | "id" | "jobId" | "runId" | "stepNumber" | "expertKey" | "timestamp">) => BaseEvent & {
+}, "id" | "jobId" | "runId" | "stepNumber" | "type" | "expertKey" | "timestamp">) => BaseEvent & {
   type: "resumeToolCalls";
 } & {
   pendingToolCalls: ToolCall[];
@@ -3575,7 +3575,7 @@ declare const completeRun: (setting: RunSetting, checkpoint: Checkpoint, data: O
   step: Step;
   text: string;
   usage: Usage;
-}, "type" | "id" | "jobId" | "runId" | "stepNumber" | "expertKey" | "timestamp">) => BaseEvent & {
+}, "id" | "jobId" | "runId" | "stepNumber" | "type" | "expertKey" | "timestamp">) => BaseEvent & {
   type: "completeRun";
 } & {
   checkpoint: Checkpoint;
@@ -3588,7 +3588,7 @@ declare const stopRunByInteractiveTool: (setting: RunSetting, checkpoint: Checkp
 } & {
   checkpoint: Checkpoint;
   step: Step;
-}, "type" | "id" | "jobId" | "runId" | "stepNumber" | "expertKey" | "timestamp">) => BaseEvent & {
+}, "id" | "jobId" | "runId" | "stepNumber" | "type" | "expertKey" | "timestamp">) => BaseEvent & {
   type: "stopRunByInteractiveTool";
 } & {
   checkpoint: Checkpoint;
@@ -3599,7 +3599,7 @@ declare const stopRunByDelegate: (setting: RunSetting, checkpoint: Checkpoint, d
 } & {
   checkpoint: Checkpoint;
   step: Step;
-}, "type" | "id" | "jobId" | "runId" | "stepNumber" | "expertKey" | "timestamp">) => BaseEvent & {
+}, "id" | "jobId" | "runId" | "stepNumber" | "type" | "expertKey" | "timestamp">) => BaseEvent & {
   type: "stopRunByDelegate";
 } & {
   checkpoint: Checkpoint;
@@ -3616,7 +3616,7 @@ declare const stopRunByError: (setting: RunSetting, checkpoint: Checkpoint, data
     statusCode?: number;
     isRetryable: boolean;
   };
-}, "type" | "id" | "jobId" | "runId" | "stepNumber" | "expertKey" | "timestamp">) => BaseEvent & {
+}, "id" | "jobId" | "runId" | "stepNumber" | "type" | "expertKey" | "timestamp">) => BaseEvent & {
   type: "stopRunByError";
 } & {
   checkpoint: Checkpoint;
@@ -3634,7 +3634,7 @@ declare const continueToNextStep: (setting: RunSetting, checkpoint: Checkpoint,
   checkpoint: Checkpoint;
   step: Step;
   nextCheckpoint: Checkpoint;
-}, "type" | "id" | "jobId" | "runId" | "stepNumber" | "expertKey" | "timestamp">) => BaseEvent & {
+}, "id" | "jobId" | "runId" | "stepNumber" | "type" | "expertKey" | "timestamp">) => BaseEvent & {
   type: "continueToNextStep";
 } & {
   checkpoint: Checkpoint;
@@ -6324,14 +6324,20 @@ declare function isCoordinatorExpert(expertName: string): boolean;
 declare function isDelegateExpert(expertName: string): boolean;
 /**
  * Returns the scope of an expert.
+ * Handles both bare names and versioned keys (with @version/@tag suffix).
  * - Coordinator "game-producer" -> "game-producer"
+ * - Coordinator "game-producer@1.0.0" -> "game-producer"
  * - Delegate "@game-producer/designer" -> "game-producer"
+ * - Delegate "@game-producer/designer@1.0.0" -> "game-producer"
  */
 declare function getExpertScope(expertName: string): string;
 /**
  * Returns the short name of an expert.
+ * Handles both bare names and versioned keys (with @version/@tag suffix).
  * - Coordinator "game-producer" -> "game-producer"
+ * - Coordinator "game-producer@1.0.0" -> "game-producer"
  * - Delegate "@game-producer/designer" -> "designer"
+ * - Delegate "@game-producer/designer@1.0.0" -> "designer"
  */
 declare function getExpertShortName(expertName: string): string;
 /**

package/dist/src/index.js

@@ -752,8 +752,11 @@ function isDelegateExpert(expertName) {
 }
 /**
 * Returns the scope of an expert.
+* Handles both bare names and versioned keys (with @version/@tag suffix).
 * - Coordinator "game-producer" -> "game-producer"
+* - Coordinator "game-producer@1.0.0" -> "game-producer"
 * - Delegate "@game-producer/designer" -> "game-producer"
+* - Delegate "@game-producer/designer@1.0.0" -> "game-producer"
 */
 function getExpertScope(expertName) {
 	if (isDelegateExpert(expertName)) {
@@ -761,19 +764,26 @@ function getExpertScope(expertName) {
 		const slashIndex = withoutAt.indexOf("/");
 		return slashIndex === -1 ? withoutAt : withoutAt.slice(0, slashIndex);
 	}
-	return expertName;
+	const atIndex = expertName.indexOf("@");
+	return atIndex === -1 ? expertName : expertName.slice(0, atIndex);
 }
 /**
 * Returns the short name of an expert.
+* Handles both bare names and versioned keys (with @version/@tag suffix).
 * - Coordinator "game-producer" -> "game-producer"
+* - Coordinator "game-producer@1.0.0" -> "game-producer"
 * - Delegate "@game-producer/designer" -> "designer"
+* - Delegate "@game-producer/designer@1.0.0" -> "designer"
 */
 function getExpertShortName(expertName) {
 	if (isDelegateExpert(expertName)) {
 		const slashIndex = expertName.indexOf("/");
-		return slashIndex === -1 ? expertName : expertName.slice(slashIndex + 1);
+		const shortName = slashIndex === -1 ? expertName : expertName.slice(slashIndex + 1);
+		const atIndex = shortName.indexOf("@");
+		return atIndex === -1 ? shortName : shortName.slice(0, atIndex);
 	}
-	return expertName;
+	const atIndex = expertName.indexOf("@");
+	return atIndex === -1 ? expertName : expertName.slice(0, atIndex);
 }
 /**
 * Validates whether a delegation from source to target is allowed.
@@ -790,7 +800,7 @@ function validateDelegation(source, target) {
 	if (isDelegateExpert(target)) {
 		if (sourceScope !== getExpertScope(target)) return `Expert "${source}" cannot delegate to out-of-scope delegate "${target}"`;
 	}
-	if (isDelegateExpert(source) && isCoordinatorExpert(target) && target === sourceScope) return `Delegate "${source}" cannot delegate to its own coordinator "${target}"`;
+	if (isDelegateExpert(source) && isCoordinatorExpert(target) && getExpertScope(target) === sourceScope) return `Delegate "${source}" cannot delegate to its own coordinator "${target}"`;
 	return null;
 }
 /**