@narumitw/pi-subagents 2.0.0 → 2.0.2

package/dist/chunks/chunk-I2FAK44T.ts.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/delegation-contract.ts"],
+  "sourcesContent": ["import { StringEnum } from \"@earendil-works/pi-ai\";\nimport { Type } from \"typebox\";\nimport { redactPrivateText } from \"./context.js\";\nimport { DEFAULT_MAX_CONTEXT_BYTES, MAX_SUBAGENT_TIMEOUT_MS, truncateUtf8 } from \"./limits.js\";\n\nexport const DELEGATION_CONTRACT_VERSION = \"pi-subagents:delegation:v2\" as const;\nexport const DELEGATION_CONTRACT_LEVELS = [\"minimal\", \"full\"] as const;\nexport const DELEGATION_ENFORCEMENT_MODES = [\"audit\", \"enforce\"] as const;\nexport const AUTHORITY_REQUIREMENTS = [\"unspecified\", \"denied\", \"required\"] as const;\nexport const DELEGATION_SIDE_EFFECT_POLICIES = [\"read-only\", \"idempotent\", \"mutating\"] as const;\n\nconst MAX_IDENTIFIER_BYTES = 256;\nconst MAX_TEXT_BYTES = 16 * 1024;\nconst MAX_ITEM_BYTES = 4 * 1024;\nconst MAX_ITEMS = 50;\nconst MAX_TURNS_OR_TOOLS = 1_000_000;\n\nconst BoundedString = Type.String({ maxLength: MAX_TEXT_BYTES });\nconst BoundedItem = Type.String({ maxLength: MAX_ITEM_BYTES });\nconst BoundedItems = Type.Array(BoundedItem, { maxItems: MAX_ITEMS });\nconst DependencySchema = Type.Object(\n\t{\n\t\ttaskId: Type.String({ minLength: 1, maxLength: MAX_IDENTIFIER_BYTES }),\n\t\tartifactId: Type.Optional(Type.String({ minLength: 1, maxLength: MAX_IDENTIFIER_BYTES })),\n\t\tversion: Type.Optional(Type.String({ minLength: 1, maxLength: MAX_IDENTIFIER_BYTES })),\n\t},\n\t{ additionalProperties: false },\n);\n\nexport const DelegationContractSchema = Type.Object(\n\t{\n\t\tversion: Type.Literal(DELEGATION_CONTRACT_VERSION),\n\t\tlevel: StringEnum(DELEGATION_CONTRACT_LEVELS),\n\t\ttaskId: Type.String({ minLength: 1, maxLength: MAX_IDENTIFIER_BYTES }),\n\t\tobjective: BoundedString,\n\t\tnonGoals: Type.Optional(BoundedItems),\n\t\tdependencies: Type.Optional(Type.Array(DependencySchema, { maxItems: MAX_ITEMS })),\n\t\trequiredInputs: Type.Optional(BoundedItems),\n\t\trequestedAuthority: Type.Optional(\n\t\t\tType.Object(\n\t\t\t\t{\n\t\t\t\t\tcapabilities: Type.Optional(BoundedItems),\n\t\t\t\t\ttools: Type.Optional(BoundedItems),\n\t\t\t\t\treadPaths: Type.Optional(BoundedItems),\n\t\t\t\t\twritePaths: Type.Optional(BoundedItems),\n\t\t\t\t\tnetwork: Type.Optional(StringEnum(AUTHORITY_REQUIREMENTS)),\n\t\t\t\t\tsecrets: Type.Optional(StringEnum(AUTHORITY_REQUIREMENTS)),\n\t\t\t\t},\n\t\t\t\t{ additionalProperties: false },\n\t\t\t),\n\t\t),\n\t\tacceptanceCriteria: Type.Optional(BoundedItems),\n\t\trequiredEvidence: Type.Optional(BoundedItems),\n\t\tbudget: Type.Optional(\n\t\t\tType.Object(\n\t\t\t\t{\n\t\t\t\t\ttimeoutMs: Type.Optional(Type.Integer({ minimum: 1, maximum: MAX_SUBAGENT_TIMEOUT_MS })),\n\t\t\t\t\tmaxTurns: Type.Optional(Type.Integer({ minimum: 1, maximum: MAX_TURNS_OR_TOOLS })),\n\t\t\t\t\tmaxToolCalls: Type.Optional(Type.Integer({ minimum: 1, maximum: MAX_TURNS_OR_TOOLS })),\n\t\t\t\t},\n\t\t\t\t{ additionalProperties: false },\n\t\t\t),\n\t\t),\n\t\tadmission: Type.Optional(\n\t\t\tType.Object(\n\t\t\t\t{\n\t\t\t\t\tcontextPressure: StringEnum([\"low\", \"medium\", \"high\"] as const),\n\t\t\t\t\tindependentWorkItems: Type.Integer({ minimum: 1, maximum: 2 }),\n\t\t\t\t\tcoupling: StringEnum([\"dense\", \"sparse\"] as const),\n\t\t\t\t\tverificationRequired: Type.Boolean(),\n\t\t\t\t\tverificationAvailable: Type.Boolean(),\n\t\t\t\t\tbudgetAllowsChildren: Type.Boolean(),\n\t\t\t\t\trequirementsComplete: Type.Boolean(),\n\t\t\t\t},\n\t\t\t\t{ additionalProperties: false },\n\t\t\t),\n\t\t),\n\t\tsideEffectPolicy: Type.Optional(StringEnum(DELEGATION_SIDE_EFFECT_POLICIES)),\n\t\tenforcement: Type.Optional(StringEnum(DELEGATION_ENFORCEMENT_MODES)),\n\t},\n\t{ additionalProperties: false },\n);\n\nexport interface DelegationDependency {\n\ttaskId: string;\n\tartifactId?: string;\n\tversion?: string;\n}\n\nexport interface DelegationAuthorityRequest {\n\tcapabilities?: string[];\n\ttools?: string[];\n\treadPaths?: string[];\n\twritePaths?: string[];\n\tnetwork?: (typeof AUTHORITY_REQUIREMENTS)[number];\n\tsecrets?: (typeof AUTHORITY_REQUIREMENTS)[number];\n}\n\nexport interface DelegationBudgetRequest {\n\ttimeoutMs?: number;\n\tmaxTurns?: number;\n\tmaxToolCalls?: number;\n}\n\nexport interface DelegationAdmissionRequest {\n\tcontextPressure: \"low\" | \"medium\" | \"high\";\n\tindependentWorkItems: number;\n\tcoupling: \"dense\" | \"sparse\";\n\tverificationRequired: boolean;\n\tverificationAvailable: boolean;\n\tbudgetAllowsChildren: boolean;\n\trequirementsComplete: boolean;\n}\n\nexport interface DelegationContract {\n\tversion: typeof DELEGATION_CONTRACT_VERSION;\n\tlevel: (typeof DELEGATION_CONTRACT_LEVELS)[number];\n\ttaskId: string;\n\tobjective: string;\n\tnonGoals: string[];\n\tdependencies: DelegationDependency[];\n\trequiredInputs: string[];\n\trequestedAuthority?: DelegationAuthorityRequest;\n\tacceptanceCriteria: string[];\n\trequiredEvidence: string[];\n\tbudget?: DelegationBudgetRequest;\n\tadmission?: DelegationAdmissionRequest;\n\tsideEffectPolicy: (typeof DELEGATION_SIDE_EFFECT_POLICIES)[number];\n\tenforcement: (typeof DELEGATION_ENFORCEMENT_MODES)[number];\n}\n\nexport interface AppendedDelegationContract {\n\ttext: string;\n\tcontract?: DelegationContract;\n\ttruncated: boolean;\n}\n\nexport function normalizeDelegationContract(value: unknown): DelegationContract | undefined {\n\tif (!isPlainObject(value)) return undefined;\n\tif (\n\t\t!hasOnlyKeys(value, [\n\t\t\t\"version\",\n\t\t\t\"level\",\n\t\t\t\"taskId\",\n\t\t\t\"objective\",\n\t\t\t\"nonGoals\",\n\t\t\t\"dependencies\",\n\t\t\t\"requiredInputs\",\n\t\t\t\"requestedAuthority\",\n\t\t\t\"acceptanceCriteria\",\n\t\t\t\"requiredEvidence\",\n\t\t\t\"budget\",\n\t\t\t\"admission\",\n\t\t\t\"sideEffectPolicy\",\n\t\t\t\"enforcement\",\n\t\t])\n\t) {\n\t\treturn undefined;\n\t}\n\tif (\n\t\tvalue.version !== DELEGATION_CONTRACT_VERSION ||\n\t\ttypeof value.level !== \"string\" ||\n\t\t!DELEGATION_CONTRACT_LEVELS.includes(\n\t\t\tvalue.level as (typeof DELEGATION_CONTRACT_LEVELS)[number],\n\t\t) ||\n\t\ttypeof value.taskId !== \"string\" ||\n\t\t!value.taskId.trim() ||\n\t\ttypeof value.objective !== \"string\"\n\t) {\n\t\treturn undefined;\n\t}\n\tconst taskId = bounded(value.taskId, MAX_IDENTIFIER_BYTES);\n\tconst objective = bounded(value.objective, MAX_TEXT_BYTES);\n\tif (!taskId || !objective) return undefined;\n\tconst nonGoals = normalizeStrings(value.nonGoals);\n\tconst requiredInputs = normalizeStrings(value.requiredInputs);\n\tconst acceptanceCriteria = normalizeStrings(value.acceptanceCriteria);\n\tconst requiredEvidence = normalizeStrings(value.requiredEvidence);\n\tif (!nonGoals || !requiredInputs || !acceptanceCriteria || !requiredEvidence) return undefined;\n\tconst dependencies = normalizeDependencies(value.dependencies);\n\tif (!dependencies) return undefined;\n\tconst authority = normalizeAuthority(value.requestedAuthority);\n\tif (authority === false) return undefined;\n\tconst budget = normalizeBudget(value.budget);\n\tif (budget === false) return undefined;\n\tconst admission = normalizeAdmission(value.admission);\n\tif (admission === false) return undefined;\n\tconst sideEffectPolicy = value.sideEffectPolicy ?? \"mutating\";\n\tif (\n\t\ttypeof sideEffectPolicy !== \"string\" ||\n\t\t!DELEGATION_SIDE_EFFECT_POLICIES.includes(\n\t\t\tsideEffectPolicy as (typeof DELEGATION_SIDE_EFFECT_POLICIES)[number],\n\t\t)\n\t) {\n\t\treturn undefined;\n\t}\n\tconst enforcement = value.enforcement ?? \"audit\";\n\tif (\n\t\ttypeof enforcement !== \"string\" ||\n\t\t!DELEGATION_ENFORCEMENT_MODES.includes(\n\t\t\tenforcement as (typeof DELEGATION_ENFORCEMENT_MODES)[number],\n\t\t)\n\t) {\n\t\treturn undefined;\n\t}\n\treturn {\n\t\tversion: DELEGATION_CONTRACT_VERSION,\n\t\tlevel: value.level as DelegationContract[\"level\"],\n\t\ttaskId,\n\t\tobjective,\n\t\tnonGoals,\n\t\tdependencies,\n\t\trequiredInputs,\n\t\t...(authority === undefined ? {} : { requestedAuthority: authority }),\n\t\tacceptanceCriteria,\n\t\trequiredEvidence,\n\t\t...(budget === undefined ? {} : { budget }),\n\t\t...(admission === undefined ? {} : { admission }),\n\t\tsideEffectPolicy: sideEffectPolicy as DelegationContract[\"sideEffectPolicy\"],\n\t\tenforcement: enforcement as DelegationContract[\"enforcement\"],\n\t};\n}\n\nexport function appendDelegationContract(\n\tprompt: string,\n\tvalue: unknown,\n\tmaxBytes = DEFAULT_MAX_CONTEXT_BYTES,\n): AppendedDelegationContract {\n\tconst contract = normalizeDelegationContract(value);\n\tif (!contract) return { text: prompt, truncated: false };\n\tconst suffix = [\n\t\t\"\",\n\t\t\"Delegation contract:\",\n\t\tJSON.stringify(contract),\n\t\t\"The requested authority is advisory until an executor-owned ExecutionPlan confirms which controls are enforceable and effective.\",\n\t\t\"Acknowledge missing inputs, authority, capabilities, or verification instead of guessing.\",\n\t].join(\"\\n\");\n\tconst suffixBytes = Buffer.byteLength(suffix, \"utf8\");\n\tconst boundedPrompt = truncateUtf8(\n\t\tredactPrivateText(prompt),\n\t\tMath.max(0, maxBytes - suffixBytes),\n\t);\n\tconst text = truncateUtf8(`${boundedPrompt.text}${suffix}`, maxBytes);\n\treturn {\n\t\ttext: text.text,\n\t\tcontract,\n\t\ttruncated: boundedPrompt.truncated || text.truncated,\n\t};\n}\n\nfunction normalizeAdmission(value: unknown): DelegationAdmissionRequest | undefined | false {\n\tif (value === undefined) return undefined;\n\tif (!isPlainObject(value)) return false;\n\tif (\n\t\t!hasOnlyKeys(value, [\n\t\t\t\"contextPressure\",\n\t\t\t\"independentWorkItems\",\n\t\t\t\"coupling\",\n\t\t\t\"verificationRequired\",\n\t\t\t\"verificationAvailable\",\n\t\t\t\"budgetAllowsChildren\",\n\t\t\t\"requirementsComplete\",\n\t\t]) ||\n\t\t![\"low\", \"medium\", \"high\"].includes(String(value.contextPressure)) ||\n\t\t!Number.isSafeInteger(value.independentWorkItems) ||\n\t\tNumber(value.independentWorkItems) < 1 ||\n\t\tNumber(value.independentWorkItems) > 2 ||\n\t\t![\"dense\", \"sparse\"].includes(String(value.coupling)) ||\n\t\ttypeof value.verificationRequired !== \"boolean\" ||\n\t\ttypeof value.verificationAvailable !== \"boolean\" ||\n\t\ttypeof value.budgetAllowsChildren !== \"boolean\" ||\n\t\ttypeof value.requirementsComplete !== \"boolean\"\n\t) {\n\t\treturn false;\n\t}\n\treturn {\n\t\tcontextPressure: value.contextPressure as DelegationAdmissionRequest[\"contextPressure\"],\n\t\tindependentWorkItems: Number(value.independentWorkItems),\n\t\tcoupling: value.coupling as DelegationAdmissionRequest[\"coupling\"],\n\t\tverificationRequired: value.verificationRequired,\n\t\tverificationAvailable: value.verificationAvailable,\n\t\tbudgetAllowsChildren: value.budgetAllowsChildren,\n\t\trequirementsComplete: value.requirementsComplete,\n\t};\n}\n\nfunction normalizeDependencies(value: unknown): DelegationDependency[] | undefined {\n\tif (value === undefined) return [];\n\tif (!Array.isArray(value) || value.length > MAX_ITEMS) return undefined;\n\tconst result: DelegationDependency[] = [];\n\tconst seen = new Set<string>();\n\tfor (const item of value) {\n\t\tif (\n\t\t\t!isPlainObject(item) ||\n\t\t\t!hasOnlyKeys(item, [\"taskId\", \"artifactId\", \"version\"]) ||\n\t\t\ttypeof item.taskId !== \"string\"\n\t\t) {\n\t\t\treturn undefined;\n\t\t}\n\t\tconst taskId = bounded(item.taskId, MAX_IDENTIFIER_BYTES);\n\t\tif (!taskId || seen.has(taskId)) return undefined;\n\t\tseen.add(taskId);\n\t\tconst artifactId = optionalString(item.artifactId, MAX_IDENTIFIER_BYTES);\n\t\tconst version = optionalString(item.version, MAX_IDENTIFIER_BYTES);\n\t\tif (artifactId === false || version === false) return undefined;\n\t\tresult.push({\n\t\t\ttaskId,\n\t\t\t...(artifactId === undefined ? {} : { artifactId }),\n\t\t\t...(version === undefined ? {} : { version }),\n\t\t});\n\t}\n\treturn result;\n}\n\nfunction normalizeAuthority(value: unknown): DelegationAuthorityRequest | undefined | false {\n\tif (value === undefined) return undefined;\n\tif (!isPlainObject(value)) return false;\n\tif (\n\t\t!hasOnlyKeys(value, [\"capabilities\", \"tools\", \"readPaths\", \"writePaths\", \"network\", \"secrets\"])\n\t) {\n\t\treturn false;\n\t}\n\tconst capabilities = normalizeOptionalStrings(value.capabilities);\n\tconst tools = normalizeOptionalStrings(value.tools);\n\tconst readPaths = normalizeOptionalStrings(value.readPaths);\n\tconst writePaths = normalizeOptionalStrings(value.writePaths);\n\tif (capabilities === false || tools === false || readPaths === false || writePaths === false) {\n\t\treturn false;\n\t}\n\tconst network = normalizeAuthorityRequirement(value.network);\n\tconst secrets = normalizeAuthorityRequirement(value.secrets);\n\tif (network === false || secrets === false) return false;\n\treturn {\n\t\t...(capabilities === undefined ? {} : { capabilities }),\n\t\t...(tools === undefined ? {} : { tools }),\n\t\t...(readPaths === undefined ? {} : { readPaths }),\n\t\t...(writePaths === undefined ? {} : { writePaths }),\n\t\t...(network === undefined ? {} : { network }),\n\t\t...(secrets === undefined ? {} : { secrets }),\n\t};\n}\n\nfunction normalizeBudget(value: unknown): DelegationBudgetRequest | undefined | false {\n\tif (value === undefined) return undefined;\n\tif (!isPlainObject(value) || !hasOnlyKeys(value, [\"timeoutMs\", \"maxTurns\", \"maxToolCalls\"])) {\n\t\treturn false;\n\t}\n\tconst timeoutMs = optionalInteger(value.timeoutMs, MAX_SUBAGENT_TIMEOUT_MS);\n\tconst maxTurns = optionalInteger(value.maxTurns, MAX_TURNS_OR_TOOLS);\n\tconst maxToolCalls = optionalInteger(value.maxToolCalls, MAX_TURNS_OR_TOOLS);\n\tif (timeoutMs === false || maxTurns === false || maxToolCalls === false) return false;\n\treturn {\n\t\t...(timeoutMs === undefined ? {} : { timeoutMs }),\n\t\t...(maxTurns === undefined ? {} : { maxTurns }),\n\t\t...(maxToolCalls === undefined ? {} : { maxToolCalls }),\n\t};\n}\n\nfunction normalizeStrings(value: unknown): string[] | undefined {\n\tif (value === undefined) return [];\n\tconst normalized = normalizeOptionalStrings(value);\n\treturn normalized === false ? undefined : normalized;\n}\n\nfunction normalizeOptionalStrings(value: unknown): string[] | undefined | false {\n\tif (value === undefined) return undefined;\n\tif (!Array.isArray(value) || value.length > MAX_ITEMS) return false;\n\tconst result: string[] = [];\n\tconst seen = new Set<string>();\n\tfor (const item of value) {\n\t\tif (typeof item !== \"string\") return false;\n\t\tconst normalized = bounded(item, MAX_ITEM_BYTES);\n\t\tif (!normalized || seen.has(normalized)) continue;\n\t\tseen.add(normalized);\n\t\tresult.push(normalized);\n\t}\n\treturn result;\n}\n\nfunction normalizeAuthorityRequirement(\n\tvalue: unknown,\n): (typeof AUTHORITY_REQUIREMENTS)[number] | undefined | false {\n\tif (value === undefined) return undefined;\n\tif (\n\t\ttypeof value !== \"string\" ||\n\t\t!AUTHORITY_REQUIREMENTS.includes(value as (typeof AUTHORITY_REQUIREMENTS)[number])\n\t) {\n\t\treturn false;\n\t}\n\treturn value as (typeof AUTHORITY_REQUIREMENTS)[number];\n}\n\nfunction optionalString(value: unknown, maxBytes: number): string | undefined | false {\n\tif (value === undefined) return undefined;\n\tif (typeof value !== \"string\") return false;\n\tconst normalized = bounded(value, maxBytes);\n\treturn normalized || false;\n}\n\nfunction optionalInteger(value: unknown, max: number): number | undefined | false {\n\tif (value === undefined) return undefined;\n\tif (!Number.isSafeInteger(value) || (value as number) < 1 || (value as number) > max)\n\t\treturn false;\n\treturn value as number;\n}\n\nfunction bounded(value: string, maxBytes: number): string {\n\treturn truncateUtf8(redactPrivateText(value), maxBytes).text.trim();\n}\n\nfunction hasOnlyKeys(value: Record<string, unknown>, allowed: readonly string[]): boolean {\n\treturn Object.keys(value).every((key) => allowed.includes(key));\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n\treturn Boolean(value) && typeof value === \"object\" && !Array.isArray(value);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/chunks/chunk-IGAMVWFN.ts

@@ -0,0 +1,139 @@
+// @generated by scripts/build-runtime.mjs; do not edit.
+// @ts-nocheck -- generated JavaScript uses a .ts extension for Pi's Jiti loader.
+
+// src/pi-invocation.ts
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { getPackageDir } from "@earendil-works/pi-coding-agent";
+var CORE_PACKAGE_NAME = "@earendil-works/pi-coding-agent";
+var MAX_DISPLAY_PATH_LENGTH = 500;
+var PiInvocationError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "PiInvocationError";
+  }
+};
+function displayPath(value) {
+  const suffix = value.length > MAX_DISPLAY_PATH_LENGTH ? "\u2026" : "";
+  return JSON.stringify(`${value.slice(0, MAX_DISPLAY_PATH_LENGTH)}${suffix}`);
+}
+function resolutionError(packageDir, reason) {
+  return new PiInvocationError(
+    `Unable to resolve the Pi CLI from the loaded ${CORE_PACKAGE_NAME} package at ${displayPath(packageDir)}: ${reason}. Reinstall the matching Pi core package before using the subprocess transport.`
+  );
+}
+function currentRuntime() {
+  let packageDir;
+  try {
+    packageDir = getPackageDir();
+  } catch {
+    throw resolutionError("<unavailable>", "Pi core did not provide its package directory");
+  }
+  const runtimeKind = process.versions.bun ? "bun" : process.release.name === "node" && !process.versions.electron ? "node" : "unsupported";
+  return {
+    execPath: process.execPath,
+    packageDir,
+    runtimeKind
+  };
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isWithinDirectory(parent, candidate) {
+  const relative2 = path.relative(parent, candidate);
+  return relative2 === "" || !relative2.startsWith(`..${path.sep}`) && relative2 !== ".." && !path.isAbsolute(relative2);
+}
+function readCoreManifest(packageDir) {
+  const manifestPath = path.join(packageDir, "package.json");
+  let source;
+  try {
+    source = fs.readFileSync(manifestPath, "utf8");
+  } catch {
+    throw resolutionError(packageDir, "the package manifest is unavailable");
+  }
+  let manifest;
+  try {
+    manifest = JSON.parse(source);
+  } catch {
+    throw resolutionError(packageDir, "the package manifest is invalid JSON");
+  }
+  if (!isRecord(manifest)) {
+    throw resolutionError(packageDir, "the package manifest is invalid");
+  }
+  if (manifest.name !== CORE_PACKAGE_NAME) {
+    throw resolutionError(packageDir, "the package manifest has an unexpected package name");
+  }
+  return manifest;
+}
+function resolveDeclaredBin(packageDir, manifest) {
+  const bin = manifest.bin;
+  const piBin = isRecord(bin) ? bin.pi : void 0;
+  if (typeof piBin !== "string" || !piBin.trim()) {
+    throw resolutionError(packageDir, "package.json bin.pi must be a non-empty string");
+  }
+  const candidate = path.resolve(packageDir, piBin);
+  if (path.isAbsolute(piBin) || !isWithinDirectory(packageDir, candidate)) {
+    throw resolutionError(packageDir, "the declared bin.pi target escapes the package directory");
+  }
+  return candidate;
+}
+function resolveExistingFile(packageDir, candidate, reason) {
+  let resolved;
+  try {
+    resolved = fs.realpathSync(candidate);
+    if (!fs.statSync(resolved).isFile()) throw new Error("not a file");
+  } catch {
+    throw resolutionError(packageDir, reason);
+  }
+  if (!isWithinDirectory(packageDir, resolved)) {
+    throw resolutionError(packageDir, "the declared bin.pi target escapes the package directory");
+  }
+  return resolved;
+}
+function resolveStandaloneExecutable(packageDir, runtime) {
+  if (runtime.runtimeKind !== "bun") return void 0;
+  const { execPath } = runtime;
+  if (!/^pi(?:\.exe)?$/i.test(path.basename(execPath))) return void 0;
+  let resolved;
+  let mode;
+  try {
+    resolved = fs.realpathSync(execPath);
+    const stat = fs.statSync(resolved);
+    if (!stat.isFile()) throw new Error("not a file");
+    mode = stat.mode;
+  } catch {
+    throw resolutionError(packageDir, "the standalone Pi executable is unavailable");
+  }
+  if (path.dirname(resolved) !== packageDir) return void 0;
+  if (process.platform !== "win32" && (mode & 73) === 0) {
+    throw resolutionError(packageDir, "the standalone Pi executable is not executable");
+  }
+  return resolved;
+}
+function resolvePiInvocation(args, runtime = currentRuntime()) {
+  let packageDir;
+  try {
+    packageDir = fs.realpathSync(runtime.packageDir);
+    if (!fs.statSync(packageDir).isDirectory()) throw new Error("not a directory");
+  } catch {
+    throw resolutionError(runtime.packageDir, "the package directory is unavailable");
+  }
+  const manifest = readCoreManifest(packageDir);
+  const declaredBin = resolveDeclaredBin(packageDir, manifest);
+  const standalone = resolveStandaloneExecutable(packageDir, runtime);
+  if (standalone) return { command: standalone, args: [...args] };
+  if (runtime.runtimeKind !== "node" && runtime.runtimeKind !== "bun") {
+    throw resolutionError(packageDir, "the host does not provide a supported Node or Bun runtime");
+  }
+  const cliPath = resolveExistingFile(
+    packageDir,
+    declaredBin,
+    "the declared bin.pi target is unavailable"
+  );
+  return { command: runtime.execPath, args: [cliPath, ...args] };
+}
+
+export {
+  resolvePiInvocation
+};
+//# sourceMappingURL=chunk-IGAMVWFN.ts.map

package/dist/chunks/chunk-IGAMVWFN.ts.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/pi-invocation.ts"],
+  "sourcesContent": ["import * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport { getPackageDir } from \"@earendil-works/pi-coding-agent\";\n\nconst CORE_PACKAGE_NAME = \"@earendil-works/pi-coding-agent\";\nconst MAX_DISPLAY_PATH_LENGTH = 500;\n\nexport interface PiInvocation {\n\tcommand: string;\n\targs: string[];\n}\n\nexport interface PiInvocationRuntime {\n\texecPath: string;\n\tpackageDir: string;\n\truntimeKind: \"node\" | \"bun\" | \"unsupported\";\n}\n\nexport class PiInvocationError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"PiInvocationError\";\n\t}\n}\n\nfunction displayPath(value: string): string {\n\tconst suffix = value.length > MAX_DISPLAY_PATH_LENGTH ? \"\u2026\" : \"\";\n\treturn JSON.stringify(`${value.slice(0, MAX_DISPLAY_PATH_LENGTH)}${suffix}`);\n}\n\nfunction resolutionError(packageDir: string, reason: string): PiInvocationError {\n\treturn new PiInvocationError(\n\t\t`Unable to resolve the Pi CLI from the loaded ${CORE_PACKAGE_NAME} package at ${displayPath(packageDir)}: ${reason}. Reinstall the matching Pi core package before using the subprocess transport.`,\n\t);\n}\n\nfunction currentRuntime(): PiInvocationRuntime {\n\tlet packageDir: string;\n\ttry {\n\t\tpackageDir = getPackageDir();\n\t} catch {\n\t\tthrow resolutionError(\"<unavailable>\", \"Pi core did not provide its package directory\");\n\t}\n\tconst runtimeKind = process.versions.bun\n\t\t? \"bun\"\n\t\t: process.release.name === \"node\" && !process.versions.electron\n\t\t\t? \"node\"\n\t\t\t: \"unsupported\";\n\treturn {\n\t\texecPath: process.execPath,\n\t\tpackageDir,\n\t\truntimeKind,\n\t};\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isWithinDirectory(parent: string, candidate: string): boolean {\n\tconst relative = path.relative(parent, candidate);\n\treturn (\n\t\trelative === \"\" ||\n\t\t(!relative.startsWith(`..${path.sep}`) && relative !== \"..\" && !path.isAbsolute(relative))\n\t);\n}\n\nfunction readCoreManifest(packageDir: string): Record<string, unknown> {\n\tconst manifestPath = path.join(packageDir, \"package.json\");\n\tlet source: string;\n\ttry {\n\t\tsource = fs.readFileSync(manifestPath, \"utf8\");\n\t} catch {\n\t\tthrow resolutionError(packageDir, \"the package manifest is unavailable\");\n\t}\n\tlet manifest: unknown;\n\ttry {\n\t\tmanifest = JSON.parse(source);\n\t} catch {\n\t\tthrow resolutionError(packageDir, \"the package manifest is invalid JSON\");\n\t}\n\tif (!isRecord(manifest)) {\n\t\tthrow resolutionError(packageDir, \"the package manifest is invalid\");\n\t}\n\tif (manifest.name !== CORE_PACKAGE_NAME) {\n\t\tthrow resolutionError(packageDir, \"the package manifest has an unexpected package name\");\n\t}\n\treturn manifest;\n}\n\nfunction resolveDeclaredBin(packageDir: string, manifest: Record<string, unknown>): string {\n\tconst bin = manifest.bin;\n\tconst piBin = isRecord(bin) ? bin.pi : undefined;\n\tif (typeof piBin !== \"string\" || !piBin.trim()) {\n\t\tthrow resolutionError(packageDir, \"package.json bin.pi must be a non-empty string\");\n\t}\n\tconst candidate = path.resolve(packageDir, piBin);\n\tif (path.isAbsolute(piBin) || !isWithinDirectory(packageDir, candidate)) {\n\t\tthrow resolutionError(packageDir, \"the declared bin.pi target escapes the package directory\");\n\t}\n\treturn candidate;\n}\n\nfunction resolveExistingFile(packageDir: string, candidate: string, reason: string): string {\n\tlet resolved: string;\n\ttry {\n\t\tresolved = fs.realpathSync(candidate);\n\t\tif (!fs.statSync(resolved).isFile()) throw new Error(\"not a file\");\n\t} catch {\n\t\tthrow resolutionError(packageDir, reason);\n\t}\n\tif (!isWithinDirectory(packageDir, resolved)) {\n\t\tthrow resolutionError(packageDir, \"the declared bin.pi target escapes the package directory\");\n\t}\n\treturn resolved;\n}\n\nfunction resolveStandaloneExecutable(\n\tpackageDir: string,\n\truntime: PiInvocationRuntime,\n): string | undefined {\n\tif (runtime.runtimeKind !== \"bun\") return undefined;\n\tconst { execPath } = runtime;\n\tif (!/^pi(?:\\.exe)?$/i.test(path.basename(execPath))) return undefined;\n\tlet resolved: string;\n\tlet mode: number;\n\ttry {\n\t\tresolved = fs.realpathSync(execPath);\n\t\tconst stat = fs.statSync(resolved);\n\t\tif (!stat.isFile()) throw new Error(\"not a file\");\n\t\tmode = stat.mode;\n\t} catch {\n\t\tthrow resolutionError(packageDir, \"the standalone Pi executable is unavailable\");\n\t}\n\tif (path.dirname(resolved) !== packageDir) return undefined;\n\tif (process.platform !== \"win32\" && (mode & 0o111) === 0) {\n\t\tthrow resolutionError(packageDir, \"the standalone Pi executable is not executable\");\n\t}\n\treturn resolved;\n}\n\nexport function resolvePiInvocation(\n\targs: string[],\n\truntime: PiInvocationRuntime = currentRuntime(),\n): PiInvocation {\n\tlet packageDir: string;\n\ttry {\n\t\tpackageDir = fs.realpathSync(runtime.packageDir);\n\t\tif (!fs.statSync(packageDir).isDirectory()) throw new Error(\"not a directory\");\n\t} catch {\n\t\tthrow resolutionError(runtime.packageDir, \"the package directory is unavailable\");\n\t}\n\n\tconst manifest = readCoreManifest(packageDir);\n\tconst declaredBin = resolveDeclaredBin(packageDir, manifest);\n\tconst standalone = resolveStandaloneExecutable(packageDir, runtime);\n\tif (standalone) return { command: standalone, args: [...args] };\n\n\tif (runtime.runtimeKind !== \"node\" && runtime.runtimeKind !== \"bun\") {\n\t\tthrow resolutionError(packageDir, \"the host does not provide a supported Node or Bun runtime\");\n\t}\n\tconst cliPath = resolveExistingFile(\n\t\tpackageDir,\n\t\tdeclaredBin,\n\t\t\"the declared bin.pi target is unavailable\",\n\t);\n\treturn { command: runtime.execPath, args: [cliPath, ...args] };\n}\n"],
+  "mappings": "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",
+  "names": ["relative"]
+}

package/dist/chunks/chunk-KMGKCEO4.ts

@@ -0,0 +1,38 @@
+// @generated by scripts/build-runtime.mjs; do not edit.
+// @ts-nocheck -- generated JavaScript uses a .ts extension for Pi's Jiti loader.
+
+// src/agent-projection.ts
+function projectAgentRecords(agents, limits) {
+  const byId = new Map(agents.map((agent) => [agent.id, agent]));
+  const selected = /* @__PURE__ */ new Set();
+  const maxDepth = limits.maxDepth ?? Number.MAX_SAFE_INTEGER;
+  const newestFirst = agents.map((agent, index) => ({ agent, index })).sort(
+    (left, right) => right.agent.updatedAt - left.agent.updatedAt || right.index - left.index
+  );
+  for (const { agent } of newestFirst) {
+    const chain = ancestorChain(agent, byId);
+    if (!chain || chain.length - 1 > maxDepth) continue;
+    const missing = chain.filter((candidate) => !selected.has(candidate.id));
+    if (selected.size + missing.length > limits.maxAgents) continue;
+    for (const candidate of missing) selected.add(candidate.id);
+  }
+  return agents.filter((agent) => selected.has(agent.id));
+}
+function ancestorChain(agent, byId) {
+  const chain = [];
+  const seen = /* @__PURE__ */ new Set();
+  let current = agent;
+  while (current) {
+    if (seen.has(current.id)) return void 0;
+    seen.add(current.id);
+    chain.unshift(current);
+    if (!current.parentId) return chain;
+    current = byId.get(current.parentId);
+  }
+  return void 0;
+}
+
+export {
+  projectAgentRecords
+};
+//# sourceMappingURL=chunk-KMGKCEO4.ts.map

package/dist/chunks/chunk-KMGKCEO4.ts.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/agent-projection.ts"],
+  "sourcesContent": ["import type { ManagedAgent } from \"./registry.js\";\n\nexport interface AgentProjectionLimits {\n\tmaxAgents: number;\n\tmaxDepth?: number;\n}\n\n/**\n * Select the newest restorable agent trees without orphaning child records.\n *\n * Complete ancestor chains are selected together, then returned in their original\n * order so persistence and restore behavior stay deterministic.\n */\nexport function projectAgentRecords(\n\tagents: readonly ManagedAgent[],\n\tlimits: AgentProjectionLimits,\n): ManagedAgent[] {\n\tconst byId = new Map(agents.map((agent) => [agent.id, agent]));\n\tconst selected = new Set<string>();\n\tconst maxDepth = limits.maxDepth ?? Number.MAX_SAFE_INTEGER;\n\tconst newestFirst = agents\n\t\t.map((agent, index) => ({ agent, index }))\n\t\t.sort(\n\t\t\t(left, right) => right.agent.updatedAt - left.agent.updatedAt || right.index - left.index,\n\t\t);\n\n\tfor (const { agent } of newestFirst) {\n\t\tconst chain = ancestorChain(agent, byId);\n\t\tif (!chain || chain.length - 1 > maxDepth) continue;\n\t\tconst missing = chain.filter((candidate) => !selected.has(candidate.id));\n\t\tif (selected.size + missing.length > limits.maxAgents) continue;\n\t\tfor (const candidate of missing) selected.add(candidate.id);\n\t}\n\n\treturn agents.filter((agent) => selected.has(agent.id));\n}\n\nfunction ancestorChain(\n\tagent: ManagedAgent,\n\tbyId: ReadonlyMap<string, ManagedAgent>,\n): ManagedAgent[] | undefined {\n\tconst chain: ManagedAgent[] = [];\n\tconst seen = new Set<string>();\n\tlet current: ManagedAgent | undefined = agent;\n\twhile (current) {\n\t\tif (seen.has(current.id)) return undefined;\n\t\tseen.add(current.id);\n\t\tchain.unshift(current);\n\t\tif (!current.parentId) return chain;\n\t\tcurrent = byId.get(current.parentId);\n\t}\n\treturn undefined;\n}\n"],
+  "mappings": ";;;;AAaO,SAAS,oBACf,QACA,QACiB;AACjB,QAAM,OAAO,IAAI,IAAI,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC;AAC7D,QAAM,WAAW,oBAAI,IAAY;AACjC,QAAM,WAAW,OAAO,YAAY,OAAO;AAC3C,QAAM,cAAc,OAClB,IAAI,CAAC,OAAO,WAAW,EAAE,OAAO,MAAM,EAAE,EACxC;AAAA,IACA,CAAC,MAAM,UAAU,MAAM,MAAM,YAAY,KAAK,MAAM,aAAa,MAAM,QAAQ,KAAK;AAAA,EACrF;AAED,aAAW,EAAE,MAAM,KAAK,aAAa;AACpC,UAAM,QAAQ,cAAc,OAAO,IAAI;AACvC,QAAI,CAAC,SAAS,MAAM,SAAS,IAAI,SAAU;AAC3C,UAAM,UAAU,MAAM,OAAO,CAAC,cAAc,CAAC,SAAS,IAAI,UAAU,EAAE,CAAC;AACvE,QAAI,SAAS,OAAO,QAAQ,SAAS,OAAO,UAAW;AACvD,eAAW,aAAa,QAAS,UAAS,IAAI,UAAU,EAAE;AAAA,EAC3D;AAEA,SAAO,OAAO,OAAO,CAAC,UAAU,SAAS,IAAI,MAAM,EAAE,CAAC;AACvD;AAEA,SAAS,cACR,OACA,MAC6B;AAC7B,QAAM,QAAwB,CAAC;AAC/B,QAAM,OAAO,oBAAI,IAAY;AAC7B,MAAI,UAAoC;AACxC,SAAO,SAAS;AACf,QAAI,KAAK,IAAI,QAAQ,EAAE,EAAG,QAAO;AACjC,SAAK,IAAI,QAAQ,EAAE;AACnB,UAAM,QAAQ,OAAO;AACrB,QAAI,CAAC,QAAQ,SAAU,QAAO;AAC9B,cAAU,KAAK,IAAI,QAAQ,QAAQ;AAAA,EACpC;AACA,SAAO;AACR;",
+  "names": []
+}

package/dist/chunks/chunk-N7BLVXKK.ts

@@ -0,0 +1,73 @@
+// @generated by scripts/build-runtime.mjs; do not edit.
+// @ts-nocheck -- generated JavaScript uses a .ts extension for Pi's Jiti loader.
+
+// src/task-path.ts
+import { createHash } from "node:crypto";
+var ROOT_TASK_PATH = "/root";
+var MAX_TASK_NAME_LENGTH = 128;
+var MAX_TASK_PATH_LENGTH = 2048;
+var TASK_NAME_PATTERN = /^[a-z0-9_]+$/u;
+function validateTaskName(value) {
+  if (!value) throw new Error("Subagent taskName must not be empty");
+  if (value === "root" || value === "." || value === "..") {
+    throw new Error(`Subagent taskName ${JSON.stringify(value)} is reserved`);
+  }
+  if (value.length > MAX_TASK_NAME_LENGTH) {
+    throw new Error(`Subagent taskName cannot exceed ${MAX_TASK_NAME_LENGTH} characters`);
+  }
+  if (value.includes("/")) throw new Error("Subagent taskName must not contain `/`");
+  if (!TASK_NAME_PATTERN.test(value)) {
+    throw new Error(
+      "Subagent taskName must use only lowercase ASCII letters, digits, and underscores"
+    );
+  }
+  return value;
+}
+function validateTaskPath(value) {
+  if (!value.startsWith(`${ROOT_TASK_PATH}/`) && value !== ROOT_TASK_PATH) {
+    throw new Error("Canonical subagent task paths must start with `/root`");
+  }
+  if (value.length > MAX_TASK_PATH_LENGTH) {
+    throw new Error(
+      `Canonical subagent task paths cannot exceed ${MAX_TASK_PATH_LENGTH} characters`
+    );
+  }
+  if (value.endsWith("/") || value.includes("//")) {
+    throw new Error("Canonical subagent task paths must not contain empty segments");
+  }
+  for (const segment of value.slice(ROOT_TASK_PATH.length + 1).split("/")) {
+    if (segment) validateTaskName(segment);
+  }
+  return value;
+}
+function joinTaskPath(parentPath, taskName) {
+  const parent = validateTaskPath(parentPath);
+  const name = validateTaskName(taskName);
+  return validateTaskPath(`${parent}/${name}`);
+}
+function resolveTaskPath(senderPath, reference) {
+  if (!reference) throw new Error("Subagent task path reference must not be empty");
+  if (reference.startsWith("/")) return validateTaskPath(reference);
+  const sender = validateTaskPath(senderPath);
+  if (reference.endsWith("/")) {
+    throw new Error("Relative subagent task paths must not end with `/`");
+  }
+  let path = sender;
+  for (const segment of reference.split("/")) path = joinTaskPath(path, segment);
+  return path;
+}
+function deriveTaskName(agentId) {
+  const digest = createHash("sha256").update(agentId).digest("hex").slice(0, 32);
+  return `agent_${digest}`;
+}
+
+export {
+  ROOT_TASK_PATH,
+  MAX_TASK_NAME_LENGTH,
+  validateTaskName,
+  validateTaskPath,
+  joinTaskPath,
+  resolveTaskPath,
+  deriveTaskName
+};
+//# sourceMappingURL=chunk-N7BLVXKK.ts.map

package/dist/chunks/chunk-N7BLVXKK.ts.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/task-path.ts"],
+  "sourcesContent": ["import { createHash } from \"node:crypto\";\n\nexport const ROOT_TASK_PATH = \"/root\";\nexport const MAX_TASK_NAME_LENGTH = 128;\nexport const MAX_TASK_PATH_LENGTH = 2_048;\n\nconst TASK_NAME_PATTERN = /^[a-z0-9_]+$/u;\n\nexport function validateTaskName(value: string): string {\n\tif (!value) throw new Error(\"Subagent taskName must not be empty\");\n\tif (value === \"root\" || value === \".\" || value === \"..\") {\n\t\tthrow new Error(`Subagent taskName ${JSON.stringify(value)} is reserved`);\n\t}\n\tif (value.length > MAX_TASK_NAME_LENGTH) {\n\t\tthrow new Error(`Subagent taskName cannot exceed ${MAX_TASK_NAME_LENGTH} characters`);\n\t}\n\tif (value.includes(\"/\")) throw new Error(\"Subagent taskName must not contain `/`\");\n\tif (!TASK_NAME_PATTERN.test(value)) {\n\t\tthrow new Error(\n\t\t\t\"Subagent taskName must use only lowercase ASCII letters, digits, and underscores\",\n\t\t);\n\t}\n\treturn value;\n}\n\nexport function validateTaskPath(value: string): string {\n\tif (!value.startsWith(`${ROOT_TASK_PATH}/`) && value !== ROOT_TASK_PATH) {\n\t\tthrow new Error(\"Canonical subagent task paths must start with `/root`\");\n\t}\n\tif (value.length > MAX_TASK_PATH_LENGTH) {\n\t\tthrow new Error(\n\t\t\t`Canonical subagent task paths cannot exceed ${MAX_TASK_PATH_LENGTH} characters`,\n\t\t);\n\t}\n\tif (value.endsWith(\"/\") || value.includes(\"//\")) {\n\t\tthrow new Error(\"Canonical subagent task paths must not contain empty segments\");\n\t}\n\tfor (const segment of value.slice(ROOT_TASK_PATH.length + 1).split(\"/\")) {\n\t\tif (segment) validateTaskName(segment);\n\t}\n\treturn value;\n}\n\nexport function joinTaskPath(parentPath: string, taskName: string): string {\n\tconst parent = validateTaskPath(parentPath);\n\tconst name = validateTaskName(taskName);\n\treturn validateTaskPath(`${parent}/${name}`);\n}\n\nexport function resolveTaskPath(senderPath: string, reference: string): string {\n\tif (!reference) throw new Error(\"Subagent task path reference must not be empty\");\n\tif (reference.startsWith(\"/\")) return validateTaskPath(reference);\n\tconst sender = validateTaskPath(senderPath);\n\tif (reference.endsWith(\"/\")) {\n\t\tthrow new Error(\"Relative subagent task paths must not end with `/`\");\n\t}\n\tlet path = sender;\n\tfor (const segment of reference.split(\"/\")) path = joinTaskPath(path, segment);\n\treturn path;\n}\n\nexport function deriveTaskName(agentId: string): string {\n\tconst digest = createHash(\"sha256\").update(agentId).digest(\"hex\").slice(0, 32);\n\treturn `agent_${digest}`;\n}\n"],
+  "mappings": ";;;;AAAA,SAAS,kBAAkB;AAEpB,IAAM,iBAAiB;AACvB,IAAM,uBAAuB;AAC7B,IAAM,uBAAuB;AAEpC,IAAM,oBAAoB;AAEnB,SAAS,iBAAiB,OAAuB;AACvD,MAAI,CAAC,MAAO,OAAM,IAAI,MAAM,qCAAqC;AACjE,MAAI,UAAU,UAAU,UAAU,OAAO,UAAU,MAAM;AACxD,UAAM,IAAI,MAAM,qBAAqB,KAAK,UAAU,KAAK,CAAC,cAAc;AAAA,EACzE;AACA,MAAI,MAAM,SAAS,sBAAsB;AACxC,UAAM,IAAI,MAAM,mCAAmC,oBAAoB,aAAa;AAAA,EACrF;AACA,MAAI,MAAM,SAAS,GAAG,EAAG,OAAM,IAAI,MAAM,wCAAwC;AACjF,MAAI,CAAC,kBAAkB,KAAK,KAAK,GAAG;AACnC,UAAM,IAAI;AAAA,MACT;AAAA,IACD;AAAA,EACD;AACA,SAAO;AACR;AAEO,SAAS,iBAAiB,OAAuB;AACvD,MAAI,CAAC,MAAM,WAAW,GAAG,cAAc,GAAG,KAAK,UAAU,gBAAgB;AACxE,UAAM,IAAI,MAAM,uDAAuD;AAAA,EACxE;AACA,MAAI,MAAM,SAAS,sBAAsB;AACxC,UAAM,IAAI;AAAA,MACT,+CAA+C,oBAAoB;AAAA,IACpE;AAAA,EACD;AACA,MAAI,MAAM,SAAS,GAAG,KAAK,MAAM,SAAS,IAAI,GAAG;AAChD,UAAM,IAAI,MAAM,+DAA+D;AAAA,EAChF;AACA,aAAW,WAAW,MAAM,MAAM,eAAe,SAAS,CAAC,EAAE,MAAM,GAAG,GAAG;AACxE,QAAI,QAAS,kBAAiB,OAAO;AAAA,EACtC;AACA,SAAO;AACR;AAEO,SAAS,aAAa,YAAoB,UAA0B;AAC1E,QAAM,SAAS,iBAAiB,UAAU;AAC1C,QAAM,OAAO,iBAAiB,QAAQ;AACtC,SAAO,iBAAiB,GAAG,MAAM,IAAI,IAAI,EAAE;AAC5C;AAEO,SAAS,gBAAgB,YAAoB,WAA2B;AAC9E,MAAI,CAAC,UAAW,OAAM,IAAI,MAAM,gDAAgD;AAChF,MAAI,UAAU,WAAW,GAAG,EAAG,QAAO,iBAAiB,SAAS;AAChE,QAAM,SAAS,iBAAiB,UAAU;AAC1C,MAAI,UAAU,SAAS,GAAG,GAAG;AAC5B,UAAM,IAAI,MAAM,oDAAoD;AAAA,EACrE;AACA,MAAI,OAAO;AACX,aAAW,WAAW,UAAU,MAAM,GAAG,EAAG,QAAO,aAAa,MAAM,OAAO;AAC7E,SAAO;AACR;AAEO,SAAS,eAAe,SAAyB;AACvD,QAAM,SAAS,WAAW,QAAQ,EAAE,OAAO,OAAO,EAAE,OAAO,KAAK,EAAE,MAAM,GAAG,EAAE;AAC7E,SAAO,SAAS,MAAM;AACvB;",
+  "names": []
+}

package/dist/chunks/chunk-NIF42QMF.ts

@@ -0,0 +1,297 @@
+// @generated by scripts/build-runtime.mjs; do not edit.
+// @ts-nocheck -- generated JavaScript uses a .ts extension for Pi's Jiti loader.
+import {
+  MAX_SUBAGENT_TOOL_CALLS,
+  MAX_SUBAGENT_TURNS
+} from "./chunk-ONDTY4EL.js";
+import {
+  SUBAGENT_RESULT_FORMATS
+} from "./chunk-RSUXZD6S.js";
+import {
+  THINKING_LEVELS
+} from "./chunk-DPPVEQAM.js";
+import {
+  DelegationContractSchema
+} from "./chunk-I2FAK44T.js";
+import {
+  MAX_CONFIGURABLE_PARALLEL_TASKS,
+  MAX_SUBAGENT_TIMEOUT_MS
+} from "./chunk-H3FP6DLR.js";
+
+// src/params.ts
+import { StringEnum as StringEnum2 } from "@earendil-works/pi-ai";
+import { Type as Type2 } from "typebox";
+
+// src/panel-presets.ts
+var PANEL_PRESETS = ["code-review", "research", "security-review", "custom"];
+
+// src/verified-execution-schema.ts
+import { StringEnum } from "@earendil-works/pi-ai";
+import { Type } from "typebox";
+var VerificationCheckSchema = Type.Object(
+  {
+    id: Type.String({
+      minLength: 1,
+      maxLength: 256,
+      pattern: "^[A-Za-z0-9][A-Za-z0-9._:-]{0,255}$"
+    }),
+    command: StringEnum(["git", "node", "npm", "npx"]),
+    args: Type.Optional(Type.Array(Type.String({ maxLength: 4096 }), { maxItems: 64 })),
+    cwd: Type.Optional(Type.String({ minLength: 1, maxLength: 4096 })),
+    timeoutMs: Type.Optional(Type.Integer({ minimum: 1, maximum: 6e5 }))
+  },
+  { additionalProperties: false }
+);
+var VerifiedExecutionContractSchema = Type.Object(
+  {
+    verifierAgent: Type.String({ minLength: 1, maxLength: 256 }),
+    maxReworkCycles: Type.Optional(Type.Integer({ minimum: 0, maximum: 1, default: 1 })),
+    checks: Type.Optional(Type.Array(VerificationCheckSchema, { maxItems: 32 }))
+  },
+  {
+    additionalProperties: false,
+    description: "Explicitly gate mutating workflow success on executor-owned deterministic checks, one least-authority independent verifier, exact submitted-state identity, and managed integration acceptance."
+  }
+);
+
+// src/params.ts
+var TimeoutMs = Type2.Number({
+  description: "Work deadline in milliseconds selected for the task difficulty. On expiry, Pi aborts the work and makes one separately bounded summary attempt. Defaults to PI_SUBAGENT_TIMEOUT_MS or 600000.",
+  minimum: 1,
+  maximum: MAX_SUBAGENT_TIMEOUT_MS
+});
+var TurnLimitFields = {
+  idleTimeoutMs: Type2.Optional(
+    Type2.Integer({
+      description: "Maximum milliseconds without a completed assistant turn or tool result before Pi aborts work and preserves a checkpoint.",
+      minimum: 1,
+      maximum: MAX_SUBAGENT_TIMEOUT_MS
+    })
+  ),
+  maxTurns: Type2.Optional(
+    Type2.Integer({
+      description: "Maximum assistant turns before unfinished work is stopped and checkpointed.",
+      minimum: 1,
+      maximum: MAX_SUBAGENT_TURNS
+    })
+  ),
+  maxToolCalls: Type2.Optional(
+    Type2.Integer({
+      description: "Maximum tool calls before additional tool work is stopped and checkpointed.",
+      minimum: 1,
+      maximum: MAX_SUBAGENT_TOOL_CALLS
+    })
+  )
+};
+var ThinkingLevelSchema = StringEnum2(THINKING_LEVELS, {
+  description: "Pi thinking level for the subagent process: off, minimal, low, medium, high, xhigh, or max."
+});
+var ResultFormatSchema = StringEnum2(SUBAGENT_RESULT_FORMATS, {
+  description: "Optional completion contract. Text preserves ordinary output; structured-v1 and structured-v2 request versioned JSON with bounded text fallback."
+});
+var ContractFields = {
+  contract: Type2.Optional(DelegationContractSchema),
+  resultFormat: Type2.Optional(ResultFormatSchema),
+  retryPolicy: Type2.Optional(
+    Type2.Object(
+      {
+        maxAttempts: Type2.Integer({ minimum: 1, maximum: 3 }),
+        backoffMs: Type2.Optional(Type2.Integer({ minimum: 0, maximum: 3e4 }))
+      },
+      { additionalProperties: false }
+    )
+  ),
+  hedgeAfterMs: Type2.Optional(Type2.Integer({ minimum: 1, maximum: 3e4 }))
+};
+var TaskItem = Type2.Object({
+  agent: Type2.String({ description: "Name of the agent to invoke" }),
+  task: Type2.String({ description: "Task to delegate to the agent" }),
+  cwd: Type2.Optional(Type2.String({ description: "Working directory for the agent process" })),
+  timeoutMs: Type2.Optional(TimeoutMs),
+  ...TurnLimitFields,
+  thinkingLevel: Type2.Optional(ThinkingLevelSchema),
+  ...ContractFields
+});
+var WorkflowTaskItem = Type2.Object({
+  id: Type2.String({ minLength: 1, maxLength: 256 }),
+  agent: Type2.Optional(
+    Type2.String({ description: "Optional explicit agent; omit to route by capability manifest" })
+  ),
+  requiredCapabilities: Type2.Optional(
+    Type2.Array(Type2.String({ minLength: 1, maxLength: 256 }), { maxItems: 50 })
+  ),
+  requiredTools: Type2.Optional(
+    Type2.Array(Type2.String({ minLength: 1, maxLength: 256 }), { maxItems: 50 })
+  ),
+  requiredVerificationRole: Type2.Optional(Type2.String({ minLength: 1, maxLength: 256 })),
+  preferredCostHint: Type2.Optional(StringEnum2(["low", "medium", "high"])),
+  preferredLatencyHint: Type2.Optional(StringEnum2(["low", "medium", "high"])),
+  task: Type2.String({ description: "Task to delegate to the agent" }),
+  dependsOn: Type2.Optional(
+    Type2.Array(Type2.String({ minLength: 1, maxLength: 256 }), { maxItems: 64 })
+  ),
+  inputArtifacts: Type2.Optional(
+    Type2.Array(Type2.String({ minLength: 1, maxLength: 256 }), { maxItems: 50 })
+  ),
+  inputArtifactVersions: Type2.Optional(
+    Type2.Record(
+      Type2.String({ minLength: 1, maxLength: 256 }),
+      Type2.String({ minLength: 1, maxLength: 256 })
+    )
+  ),
+  readPaths: Type2.Optional(Type2.Array(Type2.String({ maxLength: 4096 }), { maxItems: 50 })),
+  writePaths: Type2.Optional(Type2.Array(Type2.String({ maxLength: 4096 }), { maxItems: 50 })),
+  ownershipKeys: Type2.Optional(Type2.Array(Type2.String({ maxLength: 256 }), { maxItems: 50 })),
+  acceptanceCriteria: Type2.Optional(Type2.Array(Type2.String({ maxLength: 4096 }), { maxItems: 50 })),
+  integrationOwner: Type2.Optional(Type2.Boolean()),
+  verifierFor: Type2.Optional(
+    Type2.String({
+      minLength: 1,
+      maxLength: 256,
+      description: "Target task ID for one distinct direct-dependent structured-v2 verifier. The executor gates target acceptance on a current exact-tree receipt."
+    })
+  ),
+  cwd: Type2.Optional(Type2.String({ description: "Working directory for the agent process" })),
+  timeoutMs: Type2.Optional(TimeoutMs),
+  ...TurnLimitFields,
+  thinkingLevel: Type2.Optional(ThinkingLevelSchema),
+  ...ContractFields
+});
+var ChainItem = Type2.Object({
+  agent: Type2.String({ description: "Name of the agent to invoke" }),
+  task: Type2.String({ description: "Task with optional {previous} placeholder for prior output" }),
+  cwd: Type2.Optional(Type2.String({ description: "Working directory for the agent process" })),
+  timeoutMs: Type2.Optional(TimeoutMs),
+  ...TurnLimitFields,
+  thinkingLevel: Type2.Optional(ThinkingLevelSchema),
+  ...ContractFields
+});
+var AggregatorItem = Type2.Object(
+  {
+    agent: Type2.String({
+      description: "Name of the fan-in agent to invoke after parallel tasks complete"
+    }),
+    task: Type2.String({
+      description: "Fan-in task. Use {previous} to include all parallel outputs."
+    }),
+    cwd: Type2.Optional(
+      Type2.String({ description: "Working directory for the aggregator process" })
+    ),
+    timeoutMs: Type2.Optional(TimeoutMs),
+    ...TurnLimitFields,
+    thinkingLevel: Type2.Optional(ThinkingLevelSchema),
+    ...ContractFields
+  },
+  {
+    description: "Optional fan-in step for parallel mode. Omit this key entirely when no aggregation is needed; empty or whitespace-only agent/task values are treated as absent."
+  }
+);
+var PanelReviewerItem = Type2.Object(
+  {
+    id: Type2.String({ minLength: 1, maxLength: 256 }),
+    agent: Type2.String({ minLength: 1 }),
+    focus: Type2.Optional(Type2.String({ maxLength: 8 * 1024 })),
+    timeoutMs: Type2.Optional(TimeoutMs),
+    ...TurnLimitFields,
+    thinkingLevel: Type2.Optional(ThinkingLevelSchema)
+  },
+  { additionalProperties: false }
+);
+var PanelSynthesizerItem = Type2.Object(
+  {
+    agent: Type2.String({ minLength: 1 }),
+    timeoutMs: Type2.Optional(TimeoutMs),
+    ...TurnLimitFields,
+    thinkingLevel: Type2.Optional(ThinkingLevelSchema)
+  },
+  { additionalProperties: false }
+);
+var PanelItem = Type2.Object(
+  {
+    id: Type2.Optional(Type2.String({ minLength: 1, maxLength: 256 })),
+    preset: Type2.Optional(StringEnum2(PANEL_PRESETS, { default: "custom" })),
+    task: Type2.String({ minLength: 1, maxLength: 50 * 1024 }),
+    context: Type2.Optional(Type2.String({ maxLength: 50 * 1024 })),
+    reviewers: Type2.Array(PanelReviewerItem, {
+      minItems: 2,
+      maxItems: MAX_CONFIGURABLE_PARALLEL_TASKS
+    }),
+    synthesizer: PanelSynthesizerItem,
+    minValidReviews: Type2.Optional(Type2.Integer({ minimum: 2 }))
+  },
+  {
+    additionalProperties: false,
+    description: "One bounded independent review round followed by one evidence-preserving synthesis when enough valid reviews remain."
+  }
+);
+var AgentScopeSchema = StringEnum2(["user", "project", "both"], {
+  description: 'Per-invocation custom agent scope. Default: "user". Use "project" for project-local agents or "both" for user and project agents; this is a tool argument, not a pi-subagents.json setting.',
+  default: "user"
+});
+var SubagentParams = Type2.Object({
+  agent: Type2.Optional(
+    Type2.String({ description: "Name of the agent to invoke (for single mode)" })
+  ),
+  task: Type2.Optional(Type2.String({ description: "Task to delegate (for single mode)" })),
+  tasks: Type2.Optional(
+    Type2.Array(TaskItem, {
+      description: "Array of {agent, task} for parallel execution",
+      maxItems: MAX_CONFIGURABLE_PARALLEL_TASKS
+    })
+  ),
+  chain: Type2.Optional(
+    Type2.Array(ChainItem, { description: "Array of {agent, task} for sequential execution" })
+  ),
+  aggregator: Type2.Optional(AggregatorItem),
+  panel: Type2.Optional(PanelItem),
+  workflow: Type2.Optional(
+    Type2.Object(
+      {
+        id: Type2.Optional(Type2.String({ minLength: 1, maxLength: 256 })),
+        verifiedExecution: Type2.Optional(VerifiedExecutionContractSchema),
+        honorAdmission: Type2.Optional(
+          Type2.Boolean({
+            description: "Opt in to declining workflow tasks whose explicit audit metadata recommends parent-owned work or abstention."
+          })
+        ),
+        tasks: Type2.Array(WorkflowTaskItem, {
+          minItems: 1,
+          maxItems: MAX_CONFIGURABLE_PARALLEL_TASKS
+        })
+      },
+      { additionalProperties: false }
+    )
+  ),
+  agentScope: Type2.Optional(AgentScopeSchema),
+  confirmProjectAgents: Type2.Optional(
+    Type2.Boolean({
+      description: "Prompt before running project-local agents. Default: true.",
+      default: true
+    })
+  ),
+  cwd: Type2.Optional(
+    Type2.String({ description: "Working directory for the agent process (single mode)" })
+  ),
+  timeoutMs: Type2.Optional(TimeoutMs),
+  totalTimeoutMs: Type2.Optional(
+    Type2.Number({
+      description: "Overall blocking-workflow deadline in milliseconds, including queued work, workflow tasks, panel phases, chain steps, and fan-in.",
+      minimum: 1,
+      maximum: MAX_SUBAGENT_TIMEOUT_MS
+    })
+  ),
+  ...TurnLimitFields,
+  thinkingLevel: Type2.Optional(ThinkingLevelSchema),
+  ...ContractFields
+});
+function hasUsableAggregator(aggregator) {
+  if (!aggregator || typeof aggregator !== "object") return false;
+  const candidate = aggregator;
+  return typeof candidate.agent === "string" && candidate.agent.trim().length > 0 && typeof candidate.task === "string" && candidate.task.trim().length > 0;
+}
+
+export {
+  SubagentParams,
+  hasUsableAggregator
+};
+//# sourceMappingURL=chunk-NIF42QMF.ts.map