perstack 0.0.130 → 0.0.132

package/dist/bin/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { a as __toCommonJS, i as __require, n as __esmMin, o as __toESM, r as __exportAll, t as __commonJSMin } from "../chunk-DORXReHP.js";
-import { $ as discriminatedUnion, A as stopRunByInteractiveTool, At as $constructor, B as knownModels, C as runParamsSchema, Ct as parse$1, D as startRun, Dt as clone, E as startGeneration, Et as safeParseAsync$1, F as jobSchema, Ft as createId, G as ZodOptional$1, H as resolveModelTierWithFallback, I as expertSchema, J as _null, K as _enum, L as isCoordinatorExpert, M as startCommandInputSchema, Mt as PerstackError, N as perstackConfigSchema, O as stopRunByDelegate, Ot as defineLazy, P as lockfileSchema, Q as custom, R as validateDelegation, S as retry, St as $ZodType, T as skipDelegates, Tt as safeParse$1, U as number$1, V as resolveModelTier, W as ZodIssueCode$1, X as array$1, Y as any, Z as boolean, _ as finishToolCall, _t as datetime, a as createFilteredEventListener, at as number, b as resolveToolResults, ct as preprocess, d as callTools, dt as string, et as intersection, f as completeRun, ft as tuple, g as finishMcpTools, gt as safeParseAsync$2, h as createStreamingEvent, ht as url, i as truncateText$1, it as never, j as runCommandInputSchema, jt as NEVER, k as stopRunByError, kt as normalizeParams, l as createBaseToolActivity, lt as record, m as createRuntimeEvent, mt as unknown, n as formatZodError, nt as literal, o as validateEventFilter, ot as object$2, p as continueToNextStep, pt as union, q as _instanceof, r as parseWithFriendlyError, rt as looseObject, s as getFilteredEnv, st as optional, t as createApiClient, tt as lazy, u as createGeneralToolActivity, ut as strictObject, v as parseExpertKey, vt as toJSONSchema, w as runSettingSchema, wt as parseAsync, x as resumeFromStop, xt as $ZodObject, y as proceedToInteractiveTools, z as checkpointSchema } from "../dist-C1wXMdbD.js";
+import { $ as discriminatedUnion, A as stopRunByInteractiveTool, At as $constructor, B as knownModels, C as runParamsSchema, Ct as parse$1, D as startRun, Dt as clone, E as startGeneration, Et as safeParseAsync$1, F as jobSchema, Ft as createId, G as ZodOptional$1, H as resolveModelTierWithFallback, I as expertSchema, J as _null, K as _enum, L as isCoordinatorExpert, M as startCommandInputSchema, Mt as PerstackError, N as perstackConfigSchema, O as stopRunByDelegate, Ot as defineLazy, P as lockfileSchema, Q as custom, R as validateDelegation, S as retry, St as $ZodType, T as skipDelegates, Tt as safeParse$1, U as number$1, V as resolveModelTier, W as ZodIssueCode$1, X as array$1, Y as any, Z as boolean, _ as finishToolCall, _t as datetime, a as createFilteredEventListener, at as number, b as resolveToolResults, ct as preprocess, d as callTools, dt as string, et as intersection, f as completeRun, ft as tuple, g as finishMcpTools, gt as safeParseAsync$2, h as createStreamingEvent, ht as url, i as truncateText$1, it as never, j as runCommandInputSchema, jt as NEVER, k as stopRunByError, kt as normalizeParams, l as createBaseToolActivity, lt as record, m as createRuntimeEvent, mt as unknown, n as formatZodError, nt as literal, o as validateEventFilter, ot as object$2, p as continueToNextStep, pt as union, q as _instanceof, r as parseWithFriendlyError, rt as looseObject, s as getFilteredEnv, st as optional, t as createApiClient, tt as lazy, u as createGeneralToolActivity, ut as strictObject, v as parseExpertKey, vt as toJSONSchema, w as runSettingSchema, wt as parseAsync, x as resumeFromStop, xt as $ZodObject, y as proceedToInteractiveTools, z as checkpointSchema } from "../dist-CEw_KzeI.js";
 import { t as require_token_error } from "../token-error-Bru5BVnt.js";
 import fs, { constants, lstat, mkdir, open, readFile, stat, writeFile } from "node:fs/promises";
 import path, { dirname, extname } from "node:path";
@@ -1172,6 +1172,51 @@ function printPerstackSchema() {
 	sections.push("- Delegates must be in-scope (same coordinator prefix)");
 	sections.push("- Delegates cannot delegate to their own coordinator");
 	sections.push("");
+	sections.push("## Example");
+	sections.push("");
+	sections.push("```toml");
+	sections.push("[experts.\"my-team\"]");
+	sections.push("version = \"1.0.0\"");
+	sections.push("defaultModelTier = \"high\"");
+	sections.push("description = \"Coordinates task execution and delegates to specialists\"");
+	sections.push("instruction = \"\"\"");
+	sections.push("Domain-specific constraints and coordination rules here.");
+	sections.push("\"\"\"");
+	sections.push("delegates = [\"@my-team/build\", \"@my-team/verify\"]");
+	sections.push("");
+	sections.push("[experts.\"my-team\".skills.\"@perstack/base\"]");
+	sections.push("type = \"mcpStdioSkill\"");
+	sections.push("command = \"npx\"");
+	sections.push("packageName = \"@perstack/base\"");
+	sections.push("pick = [\"readTextFile\", \"exec\", \"attemptCompletion\"]");
+	sections.push("");
+	sections.push("[experts.\"@my-team/build\"]");
+	sections.push("version = \"1.0.0\"");
+	sections.push("defaultModelTier = \"middle\"");
+	sections.push("description = \"Implements the core deliverable\"");
+	sections.push("instruction = \"\"\"");
+	sections.push("Domain constraints for this specialist.");
+	sections.push("\"\"\"");
+	sections.push("");
+	sections.push("[experts.\"@my-team/build\".skills.\"@perstack/base\"]");
+	sections.push("type = \"mcpStdioSkill\"");
+	sections.push("command = \"npx\"");
+	sections.push("packageName = \"@perstack/base\"");
+	sections.push("pick = [\"readTextFile\", \"writeTextFile\", \"editTextFile\", \"exec\", \"todo\", \"attemptCompletion\"]");
+	sections.push("```");
+	sections.push("");
+	sections.push("## Best Practices");
+	sections.push("");
+	sections.push("- Always set version, defaultModelTier, and description on every expert");
+	sections.push("- Always set an explicit pick list — omitting it grants ALL tools");
+	sections.push("- Instructions should contain only domain constraints the LLM cannot derive on its own");
+	sections.push("- Do not put implementation procedures, file paths, or data schemas in instructions");
+	sections.push("- Shorter instructions outperform longer ones — every line must earn its place");
+	sections.push("- Delegate names should describe function, not persona (/build, /verify, not /builder)");
+	sections.push("- Coordinators should have minimal pick lists (readTextFile, exec, attemptCompletion)");
+	sections.push("- Leaf experts doing file I/O need: readTextFile, writeTextFile, editTextFile, exec, todo, attemptCompletion");
+	sections.push("- Experts managing delegation need: addDelegateFromConfig, addDelegate, removeDelegate");
+	sections.push("");
 	return sections.join("\n");
 }
 //#endregion
@@ -16193,7 +16238,7 @@ const EMPTY_COMPLETION_RESULT = { completion: {
 //#endregion
 //#region ../base/package.json
 var name$6 = "@perstack/base";
-var version$2 = "0.0.79";
+var version$2 = "0.0.81";
 //#endregion
 //#region ../base/src/tools/todo.ts
 var Todo = class {
@@ -21225,7 +21270,7 @@ async function expertVersionsHandler(scopeName, options) {
 }
 //#endregion
 //#region ../../packages/runtime/package.json
-var version$1 = "0.0.140";
+var version$1 = "0.0.143";
 //#endregion
 //#region ../../packages/runtime/src/helpers/usage.ts
 function createEmptyUsage() {
@@ -79710,7 +79755,7 @@ function validateRuntimeVersion(experts) {
 //#endregion
 //#region ../../packages/runtime/src/helpers/setup-experts.ts
 async function setupExperts(setting, resolveExpertToRun) {
-	const resolveFn = resolveExpertToRun ?? (await import("../resolve-expert-JQOam2_2.js")).resolveExpertToRun;
+	const resolveFn = resolveExpertToRun ?? (await import("../resolve-expert-DyZJOPWX.js")).resolveExpertToRun;
 	const { expertKey } = setting;
 	const experts = { ...setting.experts };
 	const clientOptions = {
@@ -92649,8 +92694,8 @@ function getCoordinatorMetaInstruction() {
     6. Aggregate results and clean up the workspace.
 
     Delegation guidelines:
-    - Be specific: include context, file paths, constraints, and expected output format. No vague delegations.
-    - Break large subtasks into focused units rather than overloading a single delegate.
+    - Be specific: include context, constraints, and expected output format. No vague delegations.
+    - A single delegate can handle a broad task if the role is straightforward. Only split into multiple delegates when responsibilities are genuinely distinct — unnecessary subdivision adds overhead without improving quality.
     - If no suitable delegate exists, use createExpert to create one, then addDelegate to register it.
 
     Workspace cleanup:
@@ -124645,7 +124690,7 @@ async function startHandler(expertKey, query, options, handlerOptions) {
 //#endregion
 //#region package.json
 var name = "perstack";
-var version = "0.0.130";
+var version = "0.0.132";
 var description = "PerStack CLI";
 //#endregion
 //#region bin/cli.ts