@narumitw/pi-subagents 2.1.3 → 3.0.0

package/dist/chunks/chunk-NTRPLF46.ts

@@ -1,63 +0,0 @@
-// @generated by scripts/build-runtime.mjs; do not edit.
-// @ts-nocheck -- generated JavaScript uses a .ts extension for Pi's Jiti loader.
-import {
-  formatTimeoutCheckpoint
-} from "./chunk-RTCVYIZA.ts";
-import {
-  appendResultInstruction
-} from "./chunk-RSUXZD6S.ts";
-import {
-  DEFAULT_MAX_CONTEXT_BYTES,
-  redactPrivateText,
-  truncateUtf8
-} from "./chunk-H3FP6DLR.ts";
-
-// src/timeout-finalization.ts
-var DEFAULT_TIMEOUT_FINALIZATION_MS = 45e3;
-function resolveTimeoutFinalizationMs(workTimeoutMs, override) {
-  const requested = override ?? Math.min(workTimeoutMs, DEFAULT_TIMEOUT_FINALIZATION_MS);
-  if (!Number.isFinite(requested) || requested < 1) {
-    throw new Error("Timeout finalization deadline must be a positive finite number");
-  }
-  return Math.min(Math.floor(requested), DEFAULT_TIMEOUT_FINALIZATION_MS);
-}
-function buildTimeoutFinalizationPrompt(evidence, maxBytes = DEFAULT_MAX_CONTEXT_BYTES) {
-  const activity = (evidence.recentActivity ?? []).slice(-10).map(
-    (item) => item.type === "text" ? `- Assistant note: ${redactPrivateText(item.text)}` : `- Tool activity: ${redactPrivateText(item.name)}`
-  ).join("\n");
-  const prompt = [
-    terminationHeading(evidence.terminationReason),
-    "Do not continue investigating, call tools, modify files, or retry the original task.",
-    "Return a concise summary of only verified findings and completed evidence already available.",
-    "Explicitly label unfinished or unverified areas.",
-    `Original task:
-${redactPrivateText(evidence.task)}`,
-    evidence.partialOutput ? `Partial assistant output:
-${redactPrivateText(evidence.partialOutput)}` : "Partial assistant output: (none)",
-    evidence.checkpoint ? `Deterministic progress checkpoint:
-${formatTimeoutCheckpoint(evidence.checkpoint)}` : void 0,
-    activity ? `Recent bounded activity:
-${activity}` : "Recent bounded activity: (none)"
-  ].filter((value) => Boolean(value)).join("\n\n");
-  return truncateUtf8(appendResultInstruction(prompt, evidence.resultFormat, maxBytes), maxBytes).text;
-}
-function terminationHeading(reason) {
-  switch (reason) {
-    case "idle_timeout":
-      return "The idle deadline expired and the active work was aborted.";
-    case "turn_limit":
-      return "The assistant-turn budget was exhausted and the active work was aborted.";
-    case "tool_call_limit":
-      return "The tool-call budget was exhausted and the active work was aborted.";
-    case "orchestration_timeout":
-      return "The orchestration deadline expired and the active work was aborted.";
-    default:
-      return "Work deadline expired and the active work was aborted.";
-  }
-}
-
-export {
-  resolveTimeoutFinalizationMs,
-  buildTimeoutFinalizationPrompt
-};
-//# sourceMappingURL=chunk-NTRPLF46.ts.map

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

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/timeout-finalization.ts"],
-  "sourcesContent": ["import { redactPrivateText } from \"./context.js\";\nimport { DEFAULT_MAX_CONTEXT_BYTES, truncateUtf8 } from \"./limits.js\";\nimport { appendResultInstruction, type SubagentResultFormat } from \"./result-contract.js\";\nimport type { RecentActivityItem } from \"./runner-types.js\";\nimport {\n\tformatTimeoutCheckpoint,\n\ttype TimeoutCheckpoint,\n\ttype TurnTerminationReason,\n} from \"./timeout-checkpoint.js\";\n\nexport const DEFAULT_TIMEOUT_FINALIZATION_MS = 45_000;\n\nexport interface TimeoutFinalizationEvidence {\n\ttask: string;\n\tpartialOutput?: string;\n\trecentActivity?: readonly RecentActivityItem[];\n\tcheckpoint?: TimeoutCheckpoint;\n\tterminationReason?: TurnTerminationReason;\n\tresultFormat?: SubagentResultFormat;\n}\n\nexport function resolveTimeoutFinalizationMs(workTimeoutMs: number, override?: number): number {\n\tconst requested = override ?? Math.min(workTimeoutMs, DEFAULT_TIMEOUT_FINALIZATION_MS);\n\tif (!Number.isFinite(requested) || requested < 1) {\n\t\tthrow new Error(\"Timeout finalization deadline must be a positive finite number\");\n\t}\n\treturn Math.min(Math.floor(requested), DEFAULT_TIMEOUT_FINALIZATION_MS);\n}\n\nexport function buildTimeoutFinalizationPrompt(\n\tevidence: TimeoutFinalizationEvidence,\n\tmaxBytes = DEFAULT_MAX_CONTEXT_BYTES,\n): string {\n\tconst activity = (evidence.recentActivity ?? [])\n\t\t.slice(-10)\n\t\t.map((item) =>\n\t\t\titem.type === \"text\"\n\t\t\t\t? `- Assistant note: ${redactPrivateText(item.text)}`\n\t\t\t\t: `- Tool activity: ${redactPrivateText(item.name)}`,\n\t\t)\n\t\t.join(\"\\n\");\n\tconst prompt = [\n\t\tterminationHeading(evidence.terminationReason),\n\t\t\"Do not continue investigating, call tools, modify files, or retry the original task.\",\n\t\t\"Return a concise summary of only verified findings and completed evidence already available.\",\n\t\t\"Explicitly label unfinished or unverified areas.\",\n\t\t`Original task:\\n${redactPrivateText(evidence.task)}`,\n\t\tevidence.partialOutput\n\t\t\t? `Partial assistant output:\\n${redactPrivateText(evidence.partialOutput)}`\n\t\t\t: \"Partial assistant output: (none)\",\n\t\tevidence.checkpoint\n\t\t\t? `Deterministic progress checkpoint:\\n${formatTimeoutCheckpoint(evidence.checkpoint)}`\n\t\t\t: undefined,\n\t\tactivity ? `Recent bounded activity:\\n${activity}` : \"Recent bounded activity: (none)\",\n\t]\n\t\t.filter((value): value is string => Boolean(value))\n\t\t.join(\"\\n\\n\");\n\treturn truncateUtf8(appendResultInstruction(prompt, evidence.resultFormat, maxBytes), maxBytes)\n\t\t.text;\n}\n\nfunction terminationHeading(reason: TurnTerminationReason | undefined): string {\n\tswitch (reason) {\n\t\tcase \"idle_timeout\":\n\t\t\treturn \"The idle deadline expired and the active work was aborted.\";\n\t\tcase \"turn_limit\":\n\t\t\treturn \"The assistant-turn budget was exhausted and the active work was aborted.\";\n\t\tcase \"tool_call_limit\":\n\t\t\treturn \"The tool-call budget was exhausted and the active work was aborted.\";\n\t\tcase \"orchestration_timeout\":\n\t\t\treturn \"The orchestration deadline expired and the active work was aborted.\";\n\t\tdefault:\n\t\t\treturn \"Work deadline expired and the active work was aborted.\";\n\t}\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;AAUO,IAAM,kCAAkC;AAWxC,SAAS,6BAA6B,eAAuB,UAA2B;AAC9F,QAAM,YAAY,YAAY,KAAK,IAAI,eAAe,+BAA+B;AACrF,MAAI,CAAC,OAAO,SAAS,SAAS,KAAK,YAAY,GAAG;AACjD,UAAM,IAAI,MAAM,gEAAgE;AAAA,EACjF;AACA,SAAO,KAAK,IAAI,KAAK,MAAM,SAAS,GAAG,+BAA+B;AACvE;AAEO,SAAS,+BACf,UACA,WAAW,2BACF;AACT,QAAM,YAAY,SAAS,kBAAkB,CAAC,GAC5C,MAAM,GAAG,EACT;AAAA,IAAI,CAAC,SACL,KAAK,SAAS,SACX,qBAAqB,kBAAkB,KAAK,IAAI,CAAC,KACjD,oBAAoB,kBAAkB,KAAK,IAAI,CAAC;AAAA,EACpD,EACC,KAAK,IAAI;AACX,QAAM,SAAS;AAAA,IACd,mBAAmB,SAAS,iBAAiB;AAAA,IAC7C;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAmB,kBAAkB,SAAS,IAAI,CAAC;AAAA,IACnD,SAAS,gBACN;AAAA,EAA8B,kBAAkB,SAAS,aAAa,CAAC,KACvE;AAAA,IACH,SAAS,aACN;AAAA,EAAuC,wBAAwB,SAAS,UAAU,CAAC,KACnF;AAAA,IACH,WAAW;AAAA,EAA6B,QAAQ,KAAK;AAAA,EACtD,EACE,OAAO,CAAC,UAA2B,QAAQ,KAAK,CAAC,EACjD,KAAK,MAAM;AACb,SAAO,aAAa,wBAAwB,QAAQ,SAAS,cAAc,QAAQ,GAAG,QAAQ,EAC5F;AACH;AAEA,SAAS,mBAAmB,QAAmD;AAC9E,UAAQ,QAAQ;AAAA,IACf,KAAK;AACJ,aAAO;AAAA,IACR,KAAK;AACJ,aAAO;AAAA,IACR,KAAK;AACJ,aAAO;AAAA,IACR,KAAK;AACJ,aAAO;AAAA,IACR;AACC,aAAO;AAAA,EACT;AACD;",
-  "names": []
-}

package/dist/chunks/chunk-ONDTY4EL.ts

@@ -1,91 +0,0 @@
-// @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_TIMEOUT_MS
-} from "./chunk-H3FP6DLR.ts";
-
-// src/turn-budget.ts
-var MAX_SUBAGENT_TURNS = 1e6;
-var MAX_SUBAGENT_TOOL_CALLS = 1e6;
-var TERMINAL_STOP_REASONS = /* @__PURE__ */ new Set(["stop", "length", "error", "aborted"]);
-function validateTurnLimits(limits) {
-  validateOptionalInteger("idleTimeoutMs", limits.idleTimeoutMs, MAX_SUBAGENT_TIMEOUT_MS);
-  validateOptionalInteger("maxTurns", limits.maxTurns, MAX_SUBAGENT_TURNS);
-  validateOptionalInteger("maxToolCalls", limits.maxToolCalls, MAX_SUBAGENT_TOOL_CALLS);
-  return { ...limits };
-}
-var TurnBudgetMonitor = class {
-  limits;
-  onExceeded;
-  idleTimer;
-  assistantTurns = 0;
-  toolCalls = 0;
-  stopped = false;
-  constructor(options) {
-    this.limits = validateTurnLimits({
-      idleTimeoutMs: options.idleTimeoutMs,
-      maxTurns: options.maxTurns,
-      maxToolCalls: options.maxToolCalls
-    });
-    this.onExceeded = options.onExceeded;
-    this.resetIdleTimer();
-  }
-  recordActivity() {
-    if (this.stopped) return;
-    this.resetIdleTimer();
-  }
-  recordAssistantTurn(stopReason) {
-    if (this.stopped) return;
-    this.assistantTurns++;
-    this.recordActivity();
-    if (this.limits.maxTurns !== void 0 && this.assistantTurns >= this.limits.maxTurns && !TERMINAL_STOP_REASONS.has(stopReason ?? "")) {
-      this.exceed({ reason: "turn_limit", limit: this.limits.maxTurns });
-    }
-  }
-  recordToolCalls(count = 1) {
-    if (this.stopped || count < 1) return;
-    this.toolCalls += count;
-    if (this.limits.maxToolCalls !== void 0 && this.toolCalls > this.limits.maxToolCalls) {
-      this.exceed({ reason: "tool_call_limit", limit: this.limits.maxToolCalls });
-    }
-  }
-  dispose() {
-    this.stopped = true;
-    if (this.idleTimer) clearTimeout(this.idleTimer);
-    this.idleTimer = void 0;
-  }
-  resetIdleTimer() {
-    if (this.idleTimer) clearTimeout(this.idleTimer);
-    const idleTimeoutMs = this.limits.idleTimeoutMs;
-    if (idleTimeoutMs === void 0 || this.stopped) {
-      this.idleTimer = void 0;
-      return;
-    }
-    this.idleTimer = setTimeout(
-      () => this.exceed({ reason: "idle_timeout", limit: idleTimeoutMs }),
-      idleTimeoutMs
-    );
-    this.idleTimer.unref?.();
-  }
-  exceed(stop) {
-    if (this.stopped) return;
-    this.stopped = true;
-    if (this.idleTimer) clearTimeout(this.idleTimer);
-    this.idleTimer = void 0;
-    this.onExceeded(stop);
-  }
-};
-function validateOptionalInteger(name, value, maximum) {
-  if (value === void 0) return;
-  if (!Number.isSafeInteger(value) || value < 1 || value > maximum) {
-    throw new Error(`${name} must be an integer between 1 and ${maximum}`);
-  }
-}
-
-export {
-  MAX_SUBAGENT_TURNS,
-  MAX_SUBAGENT_TOOL_CALLS,
-  validateTurnLimits,
-  TurnBudgetMonitor
-};
-//# sourceMappingURL=chunk-ONDTY4EL.ts.map

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

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../src/turn-budget.ts"],
-  "sourcesContent": ["import { MAX_SUBAGENT_TIMEOUT_MS } from \"./limits.js\";\nimport type { TurnTerminationReason } from \"./timeout-checkpoint.js\";\n\nexport const MAX_SUBAGENT_TURNS = 1_000_000;\nexport const MAX_SUBAGENT_TOOL_CALLS = 1_000_000;\n\nexport interface TurnLimits {\n\tidleTimeoutMs?: number;\n\tmaxTurns?: number;\n\tmaxToolCalls?: number;\n}\n\nexport interface TurnBudgetStop {\n\treason: Extract<TurnTerminationReason, \"idle_timeout\" | \"turn_limit\" | \"tool_call_limit\">;\n\tlimit: number;\n}\n\nexport interface TurnBudgetMonitorOptions extends TurnLimits {\n\tonExceeded(stop: TurnBudgetStop): void;\n}\n\nconst TERMINAL_STOP_REASONS = new Set([\"stop\", \"length\", \"error\", \"aborted\"]);\n\nexport function validateTurnLimits(limits: TurnLimits): TurnLimits {\n\tvalidateOptionalInteger(\"idleTimeoutMs\", limits.idleTimeoutMs, MAX_SUBAGENT_TIMEOUT_MS);\n\tvalidateOptionalInteger(\"maxTurns\", limits.maxTurns, MAX_SUBAGENT_TURNS);\n\tvalidateOptionalInteger(\"maxToolCalls\", limits.maxToolCalls, MAX_SUBAGENT_TOOL_CALLS);\n\treturn { ...limits };\n}\n\nexport class TurnBudgetMonitor {\n\tprivate readonly limits: TurnLimits;\n\tprivate readonly onExceeded: (stop: TurnBudgetStop) => void;\n\tprivate idleTimer?: NodeJS.Timeout;\n\tprivate assistantTurns = 0;\n\tprivate toolCalls = 0;\n\tprivate stopped = false;\n\n\tconstructor(options: TurnBudgetMonitorOptions) {\n\t\tthis.limits = validateTurnLimits({\n\t\t\tidleTimeoutMs: options.idleTimeoutMs,\n\t\t\tmaxTurns: options.maxTurns,\n\t\t\tmaxToolCalls: options.maxToolCalls,\n\t\t});\n\t\tthis.onExceeded = options.onExceeded;\n\t\tthis.resetIdleTimer();\n\t}\n\n\trecordActivity(): void {\n\t\tif (this.stopped) return;\n\t\tthis.resetIdleTimer();\n\t}\n\n\trecordAssistantTurn(stopReason?: string): void {\n\t\tif (this.stopped) return;\n\t\tthis.assistantTurns++;\n\t\tthis.recordActivity();\n\t\tif (\n\t\t\tthis.limits.maxTurns !== undefined &&\n\t\t\tthis.assistantTurns >= this.limits.maxTurns &&\n\t\t\t!TERMINAL_STOP_REASONS.has(stopReason ?? \"\")\n\t\t) {\n\t\t\tthis.exceed({ reason: \"turn_limit\", limit: this.limits.maxTurns });\n\t\t}\n\t}\n\n\trecordToolCalls(count = 1): void {\n\t\tif (this.stopped || count < 1) return;\n\t\tthis.toolCalls += count;\n\t\tif (this.limits.maxToolCalls !== undefined && this.toolCalls > this.limits.maxToolCalls) {\n\t\t\tthis.exceed({ reason: \"tool_call_limit\", limit: this.limits.maxToolCalls });\n\t\t}\n\t}\n\n\tdispose(): void {\n\t\tthis.stopped = true;\n\t\tif (this.idleTimer) clearTimeout(this.idleTimer);\n\t\tthis.idleTimer = undefined;\n\t}\n\n\tprivate resetIdleTimer(): void {\n\t\tif (this.idleTimer) clearTimeout(this.idleTimer);\n\t\tconst idleTimeoutMs = this.limits.idleTimeoutMs;\n\t\tif (idleTimeoutMs === undefined || this.stopped) {\n\t\t\tthis.idleTimer = undefined;\n\t\t\treturn;\n\t\t}\n\t\tthis.idleTimer = setTimeout(\n\t\t\t() => this.exceed({ reason: \"idle_timeout\", limit: idleTimeoutMs }),\n\t\t\tidleTimeoutMs,\n\t\t);\n\t\tthis.idleTimer.unref?.();\n\t}\n\n\tprivate exceed(stop: TurnBudgetStop): void {\n\t\tif (this.stopped) return;\n\t\tthis.stopped = true;\n\t\tif (this.idleTimer) clearTimeout(this.idleTimer);\n\t\tthis.idleTimer = undefined;\n\t\tthis.onExceeded(stop);\n\t}\n}\n\nfunction validateOptionalInteger(name: string, value: number | undefined, maximum: number): void {\n\tif (value === undefined) return;\n\tif (!Number.isSafeInteger(value) || value < 1 || value > maximum) {\n\t\tthrow new Error(`${name} must be an integer between 1 and ${maximum}`);\n\t}\n}\n"],
-  "mappings": ";;;;;;;AAGO,IAAM,qBAAqB;AAC3B,IAAM,0BAA0B;AAiBvC,IAAM,wBAAwB,oBAAI,IAAI,CAAC,QAAQ,UAAU,SAAS,SAAS,CAAC;AAErE,SAAS,mBAAmB,QAAgC;AAClE,0BAAwB,iBAAiB,OAAO,eAAe,uBAAuB;AACtF,0BAAwB,YAAY,OAAO,UAAU,kBAAkB;AACvE,0BAAwB,gBAAgB,OAAO,cAAc,uBAAuB;AACpF,SAAO,EAAE,GAAG,OAAO;AACpB;AAEO,IAAM,oBAAN,MAAwB;AAAA,EACb;AAAA,EACA;AAAA,EACT;AAAA,EACA,iBAAiB;AAAA,EACjB,YAAY;AAAA,EACZ,UAAU;AAAA,EAElB,YAAY,SAAmC;AAC9C,SAAK,SAAS,mBAAmB;AAAA,MAChC,eAAe,QAAQ;AAAA,MACvB,UAAU,QAAQ;AAAA,MAClB,cAAc,QAAQ;AAAA,IACvB,CAAC;AACD,SAAK,aAAa,QAAQ;AAC1B,SAAK,eAAe;AAAA,EACrB;AAAA,EAEA,iBAAuB;AACtB,QAAI,KAAK,QAAS;AAClB,SAAK,eAAe;AAAA,EACrB;AAAA,EAEA,oBAAoB,YAA2B;AAC9C,QAAI,KAAK,QAAS;AAClB,SAAK;AACL,SAAK,eAAe;AACpB,QACC,KAAK,OAAO,aAAa,UACzB,KAAK,kBAAkB,KAAK,OAAO,YACnC,CAAC,sBAAsB,IAAI,cAAc,EAAE,GAC1C;AACD,WAAK,OAAO,EAAE,QAAQ,cAAc,OAAO,KAAK,OAAO,SAAS,CAAC;AAAA,IAClE;AAAA,EACD;AAAA,EAEA,gBAAgB,QAAQ,GAAS;AAChC,QAAI,KAAK,WAAW,QAAQ,EAAG;AAC/B,SAAK,aAAa;AAClB,QAAI,KAAK,OAAO,iBAAiB,UAAa,KAAK,YAAY,KAAK,OAAO,cAAc;AACxF,WAAK,OAAO,EAAE,QAAQ,mBAAmB,OAAO,KAAK,OAAO,aAAa,CAAC;AAAA,IAC3E;AAAA,EACD;AAAA,EAEA,UAAgB;AACf,SAAK,UAAU;AACf,QAAI,KAAK,UAAW,cAAa,KAAK,SAAS;AAC/C,SAAK,YAAY;AAAA,EAClB;AAAA,EAEQ,iBAAuB;AAC9B,QAAI,KAAK,UAAW,cAAa,KAAK,SAAS;AAC/C,UAAM,gBAAgB,KAAK,OAAO;AAClC,QAAI,kBAAkB,UAAa,KAAK,SAAS;AAChD,WAAK,YAAY;AACjB;AAAA,IACD;AACA,SAAK,YAAY;AAAA,MAChB,MAAM,KAAK,OAAO,EAAE,QAAQ,gBAAgB,OAAO,cAAc,CAAC;AAAA,MAClE;AAAA,IACD;AACA,SAAK,UAAU,QAAQ;AAAA,EACxB;AAAA,EAEQ,OAAO,MAA4B;AAC1C,QAAI,KAAK,QAAS;AAClB,SAAK,UAAU;AACf,QAAI,KAAK,UAAW,cAAa,KAAK,SAAS;AAC/C,SAAK,YAAY;AACjB,SAAK,WAAW,IAAI;AAAA,EACrB;AACD;AAEA,SAAS,wBAAwB,MAAc,OAA2B,SAAuB;AAChG,MAAI,UAAU,OAAW;AACzB,MAAI,CAAC,OAAO,cAAc,KAAK,KAAK,QAAQ,KAAK,QAAQ,SAAS;AACjE,UAAM,IAAI,MAAM,GAAG,IAAI,qCAAqC,OAAO,EAAE;AAAA,EACtE;AACD;",
-  "names": []
-}