@perstack/core 0.0.52 → 0.0.53

package/dist/src/index.js

@@ -143,7 +143,6 @@ const expertNameRegex = /^(@[a-z0-9][a-z0-9_-]*\/)?[a-z0-9][a-z0-9_-]*$/;
 const expertVersionRegex = /^(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)(?:-[\w.-]+)?(?:\+[\w.-]+)?$/;
 const tagNameRegex = /^[a-z0-9][a-z0-9_-]*$/;
 const maxExpertNameLength = 255;
-const defaultMaxSteps = 100;
 const defaultMaxRetries = 5;
 const defaultTimeout = 5 * 1e3 * 60;
 const maxSkillNameLength = 255;
@@ -688,7 +687,6 @@ const checkpointStatusSchema = z.enum([
 	"completed",
 	"stoppedByInteractiveTool",
 	"stoppedByDelegate",
-	"stoppedByExceededMaxSteps",
 	"stoppedByError",
 	"stoppedByCancellation"
 ]);
@@ -741,6 +739,73 @@ const checkpointSchema = z.object({
 	retryCount: z.number().optional()
 });
 
+//#endregion
+//#region src/utils/expert-type.ts
+function getExpertType(expertName) {
+	return expertName.startsWith("@") ? "delegate" : "coordinator";
+}
+function isCoordinatorExpert(expertName) {
+	return getExpertType(expertName) === "coordinator";
+}
+function isDelegateExpert(expertName) {
+	return getExpertType(expertName) === "delegate";
+}
+/**
+* Returns the scope of an expert.
+* - Coordinator "game-producer" -> "game-producer"
+* - Delegate "@game-producer/designer" -> "game-producer"
+*/
+function getExpertScope(expertName) {
+	if (isDelegateExpert(expertName)) {
+		const withoutAt = expertName.slice(1);
+		const slashIndex = withoutAt.indexOf("/");
+		return slashIndex === -1 ? withoutAt : withoutAt.slice(0, slashIndex);
+	}
+	return expertName;
+}
+/**
+* Returns the short name of an expert.
+* - Coordinator "game-producer" -> "game-producer"
+* - Delegate "@game-producer/designer" -> "designer"
+*/
+function getExpertShortName(expertName) {
+	if (isDelegateExpert(expertName)) {
+		const slashIndex = expertName.indexOf("/");
+		return slashIndex === -1 ? expertName : expertName.slice(slashIndex + 1);
+	}
+	return expertName;
+}
+/**
+* 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
+*/
+function validateDelegation(source, target) {
+	if (source === target) return `Expert "${source}" cannot delegate to itself`;
+	const sourceScope = getExpertScope(source);
+	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}"`;
+	return null;
+}
+/**
+* Validates all delegations for an expert.
+* Returns an array of error messages (empty if all valid).
+*/
+function validateAllDelegations(expertName, delegates) {
+	const errors = [];
+	for (const delegate of delegates) {
+		const error = validateDelegation(expertName, delegate);
+		if (error) errors.push(error);
+	}
+	return errors;
+}
+
 //#endregion
 //#region src/schemas/provider-tools.ts
 const anthropicProviderToolNameSchema = z.enum([
@@ -886,7 +951,11 @@ const skillSchema = z.discriminatedUnion("type", [
 
 //#endregion
 //#region src/schemas/expert.ts
-const expertSchema = z.object({
+/**
+* Base object schema for Expert. Use this for `.omit()` / `.pick()` operations.
+* For parsing with delegation validation, use `expertSchema` instead.
+*/
+const expertBaseSchema = z.object({
 	key: z.string().regex(expertKeyRegex).min(1),
 	name: z.string().regex(expertNameRegex).min(1).max(maxExpertNameLength),
 	version: z.string().regex(expertVersionRegex),
@@ -921,13 +990,24 @@ const expertSchema = z.object({
 	providerSkills: z.array(anthropicProviderSkillSchema).optional(),
 	providerToolOptions: providerToolOptionsSchema
 });
+/**
+* Expert schema with delegation rule validation.
+* Rejects self-delegation, out-of-scope delegates, and delegate-to-own-coordinator.
+*/
+const expertSchema = expertBaseSchema.superRefine((data, ctx) => {
+	const errors = validateAllDelegations(data.key, data.delegates);
+	for (const error of errors) ctx.addIssue({
+		code: z.ZodIssueCode.custom,
+		message: error,
+		path: ["delegates"]
+	});
+});
 
 //#endregion
 //#region src/schemas/job.ts
 const jobStatusSchema = z.enum([
 	"running",
 	"completed",
-	"stoppedByMaxSteps",
 	"stoppedByInteractiveTool",
 	"stoppedByError",
 	"stoppedByCancellation"
@@ -938,7 +1018,6 @@ const jobSchema = z.object({
 	coordinatorExpertKey: z.string(),
 	runtimeVersion: runtimeVersionSchema,
 	totalSteps: z.number(),
-	maxSteps: z.number().optional(),
 	usage: usageSchema,
 	startedAt: z.number(),
 	finishedAt: z.number().optional()
@@ -1149,7 +1228,6 @@ const perstackConfigSchema = z.object({
 	provider: providerTableSchema.optional(),
 	model: z.string().optional(),
 	reasoningBudget: reasoningBudgetSchema.optional(),
-	maxSteps: z.number().optional(),
 	maxRetries: z.number().optional(),
 	timeout: z.number().optional(),
 	experts: z.record(z.string(), z.object({
@@ -1219,12 +1297,6 @@ const commandOptionsSchema = z.object({
 		if (Number.isNaN(parsedValue)) return void 0;
 		return parsedValue;
 	}).pipe(reasoningBudgetSchema.optional()),
-	maxSteps: z.string().optional().transform((value) => {
-		if (value === void 0) return void 0;
-		const parsedValue = Number.parseInt(value, 10);
-		if (Number.isNaN(parsedValue)) return void 0;
-		return parsedValue;
-	}),
 	maxRetries: z.string().optional().transform((value) => {
 		if (value === void 0) return void 0;
 		const parsedValue = Number.parseInt(value, 10);
@@ -1293,7 +1365,6 @@ const runSettingSchema = z.object({
 	}),
 	experts: z.record(z.string(), expertSchema),
 	reasoningBudget: reasoningBudgetSchema.default(defaultReasoningBudget),
-	maxSteps: z.number().min(1).optional().default(defaultMaxSteps),
 	maxRetries: z.number().min(0),
 	timeout: z.number().min(0),
 	startedAt: z.number(),
@@ -1321,12 +1392,11 @@ const runParamsSchema = z.object({
 				text: z.string()
 			}).optional()
 		}),
-		experts: z.record(z.string().min(1).regex(expertKeyRegex), expertSchema.omit({ key: true })).optional().default({}).transform((experts) => Object.fromEntries(Object.entries(experts).map(([key, expertWithoutKey]) => [key, expertSchema.parse({
+		experts: z.record(z.string().min(1).regex(expertKeyRegex), expertBaseSchema.omit({ key: true })).optional().default({}).transform((experts) => Object.fromEntries(Object.entries(experts).map(([key, expertWithoutKey]) => [key, expertSchema.parse({
 			...expertWithoutKey,
 			key
 		})]))),
 		reasoningBudget: reasoningBudgetSchema.optional().default(defaultReasoningBudget),
-		maxSteps: z.number().min(1).optional().default(defaultMaxSteps),
 		maxRetries: z.number().min(0).optional().default(defaultMaxRetries),
 		timeout: z.number().min(0).optional().default(defaultTimeout),
 		startedAt: z.number().optional().default(Date.now()),
@@ -1382,7 +1452,6 @@ const resumeToolCalls = createEvent("resumeToolCalls");
 const completeRun = createEvent("completeRun");
 const stopRunByInteractiveTool = createEvent("stopRunByInteractiveTool");
 const stopRunByDelegate = createEvent("stopRunByDelegate");
-const stopRunByExceededMaxSteps = createEvent("stopRunByExceededMaxSteps");
 const stopRunByError = createEvent("stopRunByError");
 const continueToNextStep = createEvent("continueToNextStep");
 /** Factory function to create runtime events */
@@ -1414,7 +1483,6 @@ const EXPERT_STATE_EVENT_TYPES = new Set([
 	"continueToNextStep",
 	"stopRunByInteractiveTool",
 	"stopRunByDelegate",
-	"stopRunByExceededMaxSteps",
 	"stopRunByError",
 	"completeRun"
 ]);
@@ -1901,5 +1969,5 @@ function parseWithFriendlyError(schema, data, context) {
 }
 
 //#endregion
-export { BASE_SKILL_PREFIX, PerstackError, SAFE_ENV_VARS, 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 { BASE_SKILL_PREFIX, PerstackError, SAFE_ENV_VARS, 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.js.map