perstack 0.0.120 → 0.0.122

package/dist/bin/cli.js

@@ -21327,7 +21327,7 @@ async function expertVersionsHandler(scopeName, options) {
 
 //#endregion
 //#region ../../packages/runtime/package.json
-var version$1 = "0.0.133";
+var version$1 = "0.0.134";
 
 //#endregion
 //#region ../../packages/runtime/src/helpers/usage.ts
@@ -89359,6 +89359,8 @@ const PROVIDERS_WITHOUT_REASONING_HISTORY = [
 	"deepseek",
 	"ollama"
 ];
+/** Providers that don't handle multiple consecutive system messages well */
+const PROVIDERS_REQUIRING_MERGED_SYSTEM_MESSAGES = ["openai", "azure-openai"];
 /**
 * Filter out reasoning parts from messages for providers that don't support them.
 * This prevents "Non-OpenAI reasoning parts are not supported" warnings from AI SDK.
@@ -89377,6 +89379,43 @@ function filterReasoningPartsForProvider(messages, providerName) {
 		};
 	});
 }
+/**
+* Merge consecutive system messages into a single message for providers that
+* don't support multiple system/developer messages (e.g., OpenAI reasoning models).
+* Preserves providerOptions from the last message in each group.
+*/
+function mergeConsecutiveSystemMessages(messages, providerName) {
+	if (!PROVIDERS_REQUIRING_MERGED_SYSTEM_MESSAGES.includes(providerName)) return messages;
+	const result = [];
+	let systemGroup = [];
+	const flushSystemGroup = () => {
+		if (systemGroup.length === 0) return;
+		if (systemGroup.length === 1) result.push({
+			role: "system",
+			content: systemGroup[0].content,
+			providerOptions: systemGroup[0].providerOptions
+		});
+		else {
+			const lastOptions = systemGroup[systemGroup.length - 1].providerOptions;
+			result.push({
+				role: "system",
+				content: systemGroup.map((m) => m.content).join("\n\n"),
+				providerOptions: lastOptions
+			});
+		}
+		systemGroup = [];
+	};
+	for (const message of messages) if (message.role === "system") systemGroup.push({
+		content: message.content,
+		providerOptions: message.providerOptions
+	});
+	else {
+		flushSystemGroup();
+		result.push(message);
+	}
+	flushSystemGroup();
+	return result;
+}
 var LLMExecutor = class {
 	constructor(adapter, model) {
 		this.adapter = adapter;
@@ -89387,7 +89426,7 @@ var LLMExecutor = class {
 		const baseProviderOptions = this.adapter.getProviderOptions(params.providerOptionsConfig);
 		const reasoningOptions = shouldEnableReasoning(params.reasoningBudget) && params.reasoningBudget ? this.adapter.getReasoningOptions(params.reasoningBudget) : void 0;
 		const providerOptions = this.mergeProviderOptions(baseProviderOptions, reasoningOptions);
-		const messages = filterReasoningPartsForProvider(params.messages, this.adapter.providerName);
+		const messages = mergeConsecutiveSystemMessages(filterReasoningPartsForProvider(params.messages, this.adapter.providerName), this.adapter.providerName);
 		try {
 			return {
 				success: true,
@@ -89426,7 +89465,7 @@ var LLMExecutor = class {
 		const baseProviderOptions = this.adapter.getProviderOptions(params.providerOptionsConfig);
 		const reasoningOptions = shouldEnableReasoning(params.reasoningBudget) && params.reasoningBudget ? this.adapter.getReasoningOptions(params.reasoningBudget) : void 0;
 		const providerOptions = this.mergeProviderOptions(baseProviderOptions, reasoningOptions);
-		const messages = filterReasoningPartsForProvider(params.messages, this.adapter.providerName);
+		const messages = mergeConsecutiveSystemMessages(filterReasoningPartsForProvider(params.messages, this.adapter.providerName), this.adapter.providerName);
 		try {
 			return {
 				success: true,
@@ -89451,7 +89490,7 @@ var LLMExecutor = class {
 		const baseProviderOptions = this.adapter.getProviderOptions(params.providerOptionsConfig);
 		const reasoningOptions = shouldEnableReasoning(params.reasoningBudget) && params.reasoningBudget ? this.adapter.getReasoningOptions(params.reasoningBudget) : void 0;
 		const providerOptions = this.mergeProviderOptions(baseProviderOptions, reasoningOptions);
-		const messages = filterReasoningPartsForProvider(params.messages, this.adapter.providerName);
+		const messages = mergeConsecutiveSystemMessages(filterReasoningPartsForProvider(params.messages, this.adapter.providerName), this.adapter.providerName);
 		const streamResult = streamText({
 			model: this.model,
 			messages,
@@ -92621,49 +92660,8 @@ async function callingInteractiveToolsLogic({ setting, checkpoint, step }) {
 	});
 }
 
-//#endregion
-//#region ../../node_modules/.bun/ts-dedent@2.2.0/node_modules/ts-dedent/dist/index.js
-var require_dist = /* @__PURE__ */ __commonJSMin(((exports) => {
-	Object.defineProperty(exports, "__esModule", { value: true });
-	exports.dedent = void 0;
-	function dedent(templ) {
-		var values = [];
-		for (var _i = 1; _i < arguments.length; _i++) values[_i - 1] = arguments[_i];
-		var strings = Array.from(typeof templ === "string" ? [templ] : templ);
-		strings[strings.length - 1] = strings[strings.length - 1].replace(/\r?\n([\t ]*)$/, "");
-		var indentLengths = strings.reduce(function(arr, str) {
-			var matches = str.match(/\n([\t ]+|(?!\s).)/g);
-			if (matches) return arr.concat(matches.map(function(match) {
-				var _a, _b;
-				return (_b = (_a = match.match(/[\t ]/g)) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0;
-			}));
-			return arr;
-		}, []);
-		if (indentLengths.length) {
-			var pattern_1 = new RegExp("\n[	 ]{" + Math.min.apply(Math, indentLengths) + "}", "g");
-			strings = strings.map(function(str) {
-				return str.replace(pattern_1, "\n");
-			});
-		}
-		strings[0] = strings[0].replace(/^\r?\n/, "");
-		var string = strings[0];
-		values.forEach(function(value, i) {
-			var endentations = string.match(/(?:^|\n)( *)$/);
-			var endentation = endentations ? endentations[1] : "";
-			var indentedValue = value;
-			if (typeof value === "string" && value.includes("\n")) indentedValue = String(value).split("\n").map(function(str, i) {
-				return i === 0 ? str : "" + endentation + str;
-			}).join("\n");
-			string += indentedValue + strings[i + 1];
-		});
-		return string;
-	}
-	exports.dedent = dedent;
-}));
-
 //#endregion
 //#region ../../packages/runtime/src/messages/message.ts
-var import_dist = require_dist();
 function createUserMessage(contents) {
 	return {
 		type: "userMessage",
@@ -92700,36 +92698,31 @@ function createToolMessage(contents) {
 }
 function messageToCoreMessage(message) {
 	switch (message.type) {
-		case "instructionMessage": return {
-			role: "system",
-			content: instructionContentsToCoreContent(message.contents),
-			providerOptions: message.cache ? { anthropic: { cacheControl: { type: "ephemeral" } } } : void 0
-		};
-		case "userMessage": return {
+		case "instructionMessage": {
+			const { contents, cache } = message;
+			return contents.map((part, index) => ({
+				role: "system",
+				content: part.text,
+				providerOptions: cache && index === contents.length - 1 ? { anthropic: { cacheControl: { type: "ephemeral" } } } : void 0
+			}));
+		}
+		case "userMessage": return [{
 			role: "user",
 			content: userContentsToCoreContent(message.contents),
 			providerOptions: message.cache ? { anthropic: { cacheControl: { type: "ephemeral" } } } : void 0
-		};
-		case "expertMessage": return {
+		}];
+		case "expertMessage": return [{
 			role: "assistant",
 			content: expertContentsToCoreContent(message.contents),
 			providerOptions: message.cache ? { anthropic: { cacheControl: { type: "ephemeral" } } } : void 0
-		};
-		case "toolMessage": return {
+		}];
+		case "toolMessage": return [{
 			role: "tool",
 			content: toolContentsToCoreContent(message.contents),
 			providerOptions: message.cache ? { anthropic: { cacheControl: { type: "ephemeral" } } } : void 0
-		};
+		}];
 	}
 }
-function instructionContentsToCoreContent(contents) {
-	return contents.reduce((acc, part) => {
-		return import_dist.dedent`
-      ${acc}
-      ${part.text}
-    `.trim();
-	}, "");
-}
 function userContentsToCoreContent(contents) {
 	return contents.map((part) => {
 		switch (part.type) {
@@ -93032,7 +93025,7 @@ async function generatingToolCallLogic({ setting, checkpoint, step, skillManager
 	const { messages } = checkpoint;
 	let reasoningCompletedViaCallback = false;
 	const executionResult = await llmExecutor.streamText({
-		messages: messages.map(messageToCoreMessage),
+		messages: messages.flatMap(messageToCoreMessage),
 		maxRetries: setting.maxRetries,
 		tools: getToolSet(skillManager),
 		toolChoice: "auto",
@@ -93252,12 +93245,51 @@ async function generatingToolCallLogic({ setting, checkpoint, step, skillManager
 	throw new Error(`Unexpected finish reason: ${finishReason}`);
 }
 
+//#endregion
+//#region ../../node_modules/.bun/ts-dedent@2.2.0/node_modules/ts-dedent/dist/index.js
+var require_dist = /* @__PURE__ */ __commonJSMin(((exports) => {
+	Object.defineProperty(exports, "__esModule", { value: true });
+	exports.dedent = void 0;
+	function dedent(templ) {
+		var values = [];
+		for (var _i = 1; _i < arguments.length; _i++) values[_i - 1] = arguments[_i];
+		var strings = Array.from(typeof templ === "string" ? [templ] : templ);
+		strings[strings.length - 1] = strings[strings.length - 1].replace(/\r?\n([\t ]*)$/, "");
+		var indentLengths = strings.reduce(function(arr, str) {
+			var matches = str.match(/\n([\t ]+|(?!\s).)/g);
+			if (matches) return arr.concat(matches.map(function(match) {
+				var _a, _b;
+				return (_b = (_a = match.match(/[\t ]/g)) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0;
+			}));
+			return arr;
+		}, []);
+		if (indentLengths.length) {
+			var pattern_1 = new RegExp("\n[	 ]{" + Math.min.apply(Math, indentLengths) + "}", "g");
+			strings = strings.map(function(str) {
+				return str.replace(pattern_1, "\n");
+			});
+		}
+		strings[0] = strings[0].replace(/^\r?\n/, "");
+		var string = strings[0];
+		values.forEach(function(value, i) {
+			var endentations = string.match(/(?:^|\n)( *)$/);
+			var endentation = endentations ? endentations[1] : "";
+			var indentedValue = value;
+			if (typeof value === "string" && value.includes("\n")) indentedValue = String(value).split("\n").map(function(str, i) {
+				return i === 0 ? str : "" + endentation + str;
+			}).join("\n");
+			string += indentedValue + strings[i + 1];
+		});
+		return string;
+	}
+	exports.dedent = dedent;
+}));
+
 //#endregion
 //#region ../../packages/runtime/src/messages/instruction-message.ts
+var import_dist = require_dist();
 function getDelegateMetaInstruction(startedAt) {
 	return import_dist.dedent`
-    Call tools iteratively to complete the user's task.
-
     Before starting work, investigate the workspace and understand the current state. Then use the todo tool to create a plan of action. Work through the todos step by step, marking each completed as you go.
 
     When the task is complete, call attemptCompletion with a result parameter containing your final response.
@@ -93270,14 +93302,36 @@ function getDelegateMetaInstruction(startedAt) {
 }
 function getCoordinatorMetaInstruction(startedAt) {
 	return import_dist.dedent`
-    You are a Coordinator. Your role is to plan, split tasks, and delegate. Never execute concrete tasks yourself.
+    Your role:
+    - Act as the coordinator for the given task: define the task, set goals, and delegate.
+    - Decompose tasks and delegate subtasks to delegate experts.
+    - Review and aggregate deliverables from delegates.
+    - Determine whether the task meets the completion criteria.
+
+    Rules:
+    - Never produce deliverables yourself. You are a thin coordinator — route all production work to delegates.
+    - Always verify delegate outputs yourself. You are the gatekeeper: run code to confirm it works, read documents to confirm content quality, call APIs to confirm data was persisted, and cross-check research claims with independent sources. Never trust delegate results at face value.
+    - Delegates receive only the query string, not your conversation history. Use workspace files to exchange data between delegates (e.g., have delegate A write results to a file, then instruct delegate B to read that file).
+
+    Workflow:
+    1. Investigate the workspace and understand the current state.
+    2. Decompose the task into fine-grained subtasks and create todos.
+    3. Delegate subtasks to experts in parallel. Maximize parallelism — delegate to multiple types of experts and run multiple experts of the same type concurrently.
+    4. Review delegate outputs: verify deliverables exist, check consistency across outputs, and validate against the original request.
+    5. If a delegate fails, assess the error and decide: retry the same delegate, delegate to a different expert, or report the failure.
+    6. Aggregate results and ensure the workspace contains only clean deliverables.
 
     Delegation best practices:
-    - Parallelism: When there are N independent tasks, delegate them simultaneously in a single response.
-    - Task splitting: Distribute N tasks across M Experts. Do not send all tasks to a single Expert.
-    - Specificity: Include context, constraints, and expected output format in every delegation. No vague delegations.
-    - Planning as delegation: If planning is needed, delegate to a planner Expert. If none exists, create one with createExpert, then addDelegate, then delegate.
-    - Creating Experts: If no suitable delegate exists, use createExpert to create a specialized Expert, then addDelegate, then delegate to it.
+    - Delegate experts are purpose-specialized, so they handle individual tasks better than you.
+    - To avoid context explosion, do not assign one large subtask to a single delegate. Instead, decompose it into fine-grained subtasks and assign them to multiple delegates.
+    - Higher parallelism leads to faster task completion and improved accuracy.
+    - Specificity: Include context, file paths, constraints, and expected output format in every delegation. No vague delegations.
+    - If no suitable delegate exists for a given purpose, use createExpert to create a purpose-specialized expert, then addDelegate to make it available as a delegate.
+
+    Task completion criteria:
+    - The user's request has been fully fulfilled.
+    - The task deliverables are confirmed to be high quality: high-quality deliverables are defined as those that are verifiable by the user, available, and professional.
+    - Cleanup is complete and only pure deliverables remain in the workspace: specifically, no duplicate files, notes, or loosely related files created by delegates should remain.
 
     When the task is complete, call attemptCompletion with a result parameter containing your final response.
     When you cannot help, call attemptCompletion without a result.
@@ -93288,26 +93342,29 @@ function getCoordinatorMetaInstruction(startedAt) {
   `;
 }
 function createInstructionMessage(expert, startedAt) {
-	const instruction = import_dist.dedent`
+	const preamble = import_dist.dedent`
     You are Perstack, an AI expert that tackles tasks requested by users by utilizing all available tools.
 
     ${isCoordinatorExpert(expert.name) ? getCoordinatorMetaInstruction(startedAt) : getDelegateMetaInstruction(startedAt)}
-
-    ---
-
-    ${expert.instruction}
-
-    ---
-
-    ${getSkillRules(expert)}
   `;
+	const contents = [{
+		id: createId(),
+		type: "textPart",
+		text: preamble
+	}, {
+		id: createId(),
+		type: "textPart",
+		text: expert.instruction
+	}];
+	const skillRules = getSkillRules(expert);
+	if (skillRules) contents.push({
+		id: createId(),
+		type: "textPart",
+		text: skillRules
+	});
 	return {
 		type: "instructionMessage",
-		contents: [{
-			id: createId(),
-			type: "textPart",
-			text: instruction
-		}],
+		contents,
 		id: createId()
 	};
 }
@@ -122888,7 +122945,7 @@ async function startHandler(expertKey, query, options, handlerOptions) {
 //#endregion
 //#region package.json
 var name = "perstack";
-var version = "0.0.120";
+var version = "0.0.122";
 var description = "PerStack CLI";
 
 //#endregion