@narumitw/pi-subagents 2.0.6 → 2.1.1

package/dist/chunks/chunk-N2T5IN4X.ts

@@ -0,0 +1,18 @@
+// @generated by scripts/build-runtime.mjs; do not edit.
+// @ts-nocheck -- generated JavaScript uses a .ts extension for Pi's Jiti loader.
+
+// src/usage-recording-config.ts
+var USAGE_RECORDING_DIRECTORY = "pi-subagents-usage";
+var USAGE_RECORDING_RETENTION_DAYS = 30;
+var USAGE_RECORDING_STUDY_ID = "pi-subagents-surface-v1";
+function resolveUsageRecordingEnabled(settings) {
+  return settings?.enabled === true;
+}
+
+export {
+  USAGE_RECORDING_DIRECTORY,
+  USAGE_RECORDING_RETENTION_DAYS,
+  USAGE_RECORDING_STUDY_ID,
+  resolveUsageRecordingEnabled
+};
+//# sourceMappingURL=chunk-N2T5IN4X.ts.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/usage-recording-config.ts"],
+  "sourcesContent": ["export const USAGE_RECORDING_DIRECTORY = \"pi-subagents-usage\";\nexport const USAGE_RECORDING_RETENTION_DAYS = 30;\nexport const USAGE_RECORDING_STUDY_ID = \"pi-subagents-surface-v1\";\n\nexport interface SubagentUsageRecordingSettings {\n\tenabled?: boolean;\n}\n\nexport function resolveUsageRecordingEnabled(\n\tsettings: SubagentUsageRecordingSettings | undefined,\n): boolean {\n\treturn settings?.enabled === true;\n}\n"],
+  "mappings": ";;;;AAAO,IAAM,4BAA4B;AAClC,IAAM,iCAAiC;AACvC,IAAM,2BAA2B;AAMjC,SAAS,6BACf,UACU;AACV,SAAO,UAAU,YAAY;AAC9B;",
+  "names": []
+}

package/dist/chunks/chunk-NLT67IZS.ts

@@ -0,0 +1,322 @@
+// @generated by scripts/build-runtime.mjs; do not edit.
+// @ts-nocheck -- generated JavaScript uses a .ts extension for Pi's Jiti loader.
+import {
+  DEFAULT_MAX_CONTEXT_BYTES,
+  truncateUtf8
+} from "./chunk-H3FP6DLR.ts";
+
+// src/completion-requirement.ts
+import { StringEnum } from "@earendil-works/pi-ai";
+var COMPLETION_REQUIREMENT_MODES = ["background", "required"];
+var CompletionRequirementModeSchema = StringEnum(COMPLETION_REQUIREMENT_MODES, {
+  description: "Mark this exact turn as background (default) or required for the parent final answer. Required results are tracked until their exact completion becomes visible, but current Pi versions do not provide a hard pre-display final-answer barrier.",
+  default: "background"
+});
+var COMPLETION_REQUIREMENT_VERSION = "pi-subagents:completion-requirement:v1";
+var COMPLETION_REQUIREMENT_CONTEXT_TYPE = "pi-subagent-required-completions";
+var COMPLETION_REQUIREMENT_TRANSITION_TYPE = "pi-subagent-required-completion-transition";
+var COMPLETION_REQUIREMENT_TRANSITION_VERSION = "pi-subagents:completion-requirement-transition:v1";
+var MAX_REQUIREMENTS_PER_AGENT = 20;
+var MAX_UNRESOLVED_REQUIRED_COMPLETIONS = 64;
+function beginCompletionRequirement(records, input) {
+  const retained = (records ?? []).filter(
+    (record) => record.runId !== input.runId || record.generation !== input.generation
+  );
+  retained.push({
+    version: COMPLETION_REQUIREMENT_VERSION,
+    runId: input.runId,
+    generation: input.generation,
+    state: "pending",
+    createdAt: input.createdAt,
+    updatedAt: input.createdAt
+  });
+  return retained.slice(-MAX_REQUIREMENTS_PER_AGENT);
+}
+function makeCompletionAvailable(records, input) {
+  return updateExact(records, input.runId, input.generation, (record) => ({
+    ...record,
+    state: "available",
+    completionId: input.completionId,
+    terminalState: input.terminalState,
+    updatedAt: input.updatedAt
+  }));
+}
+function makeCompletionVisible(records, completionId, updatedAt) {
+  if (!records?.some((record) => record.completionId === completionId)) {
+    return records?.map((record) => ({ ...record }));
+  }
+  return records.map(
+    (record) => record.completionId === completionId ? { ...record, state: "visible", updatedAt } : { ...record }
+  );
+}
+function cancelPendingCompletionRequirements(records, terminalState, updatedAt) {
+  if (!records?.some((record) => record.state === "pending")) {
+    return records?.map((record) => ({ ...record }));
+  }
+  return records.map(
+    (record) => record.state === "pending" ? {
+      ...record,
+      state: "cancelled",
+      terminalState,
+      updatedAt
+    } : { ...record }
+  );
+}
+function requirementForCompletion(agent, completionId) {
+  return agent.completionRequirements?.find((record) => record.completionId === completionId);
+}
+function completionRequirementKey(record) {
+  return `${record.runId}\0${record.generation}`;
+}
+function completionRequirementsFromBranch(entries) {
+  const records = /* @__PURE__ */ new Map();
+  let observedState = false;
+  for (const entry of entries) {
+    if (!entry || typeof entry !== "object" || Array.isArray(entry)) continue;
+    const candidate = entry;
+    const message = candidate.type === "message" && candidate.message && typeof candidate.message === "object" ? candidate.message : candidate;
+    if (message.role === "toolResult" && ["subagent_spawn", "subagent_send", "subagent_await", "subagent_manage"].includes(
+      String(message.toolName)
+    )) {
+      observedState = true;
+      const details2 = message.details;
+      if (!details2 || typeof details2 !== "object" || Array.isArray(details2)) continue;
+      const detailsRecord = details2;
+      const agents = [
+        detailsRecord.agent,
+        ...Array.isArray(detailsRecord.agents) ? detailsRecord.agents : []
+      ];
+      for (const agent of agents) {
+        if (!agent || typeof agent !== "object" || Array.isArray(agent)) continue;
+        const requirements = agent.completionRequirements;
+        if (!Array.isArray(requirements)) continue;
+        for (const requirement of requirements) {
+          if (isCompletionRequirementRecord(requirement)) {
+            records.set(completionRequirementKey(requirement), { ...requirement });
+          }
+        }
+      }
+      continue;
+    }
+    if (message.role === "custom" && message.customType === COMPLETION_REQUIREMENT_TRANSITION_TYPE) {
+      const details2 = message.details;
+      if (!details2 || typeof details2 !== "object" || Array.isArray(details2)) continue;
+      const detailRecord2 = details2;
+      if (detailRecord2.version !== COMPLETION_REQUIREMENT_TRANSITION_VERSION) continue;
+      const requirements = Array.isArray(detailRecord2.records) ? detailRecord2.records : [];
+      for (const requirement of requirements) {
+        if (!isCompletionRequirementRecord(requirement) || requirement.state !== "cancelled") {
+          continue;
+        }
+        observedState = true;
+        records.set(completionRequirementKey(requirement), { ...requirement });
+      }
+      continue;
+    }
+    if (message.role !== "custom" || message.customType !== "pi-subagent-completion") continue;
+    const details = message.details;
+    if (!details || typeof details !== "object" || Array.isArray(details)) continue;
+    const detailRecord = details;
+    const completionRecords = Array.isArray(detailRecord.completions) ? detailRecord.completions : [detailRecord];
+    for (const completion of completionRecords) {
+      if (!completion || typeof completion !== "object" || Array.isArray(completion)) continue;
+      const requirement = completion.completionRequirement;
+      if (!isCompletionRequirementRecord(requirement)) continue;
+      records.set(completionRequirementKey(requirement), {
+        ...requirement,
+        state: "visible"
+      });
+    }
+  }
+  return { observedState, records, keys: new Set(records.keys()) };
+}
+function pendingRequiredCompletionCount(agent) {
+  return (agent.completionRequirements ?? []).filter(
+    (record) => record.state === "pending" || record.state === "available"
+  ).length;
+}
+function createRequiredCompletionTransition(messages, agents) {
+  const summarized = leadingSummaryBoundary(messages) > 0;
+  const state = modelRequirementState(agents);
+  const visible = completionRequirementsFromBranch(messages).records;
+  const records = state.records.filter((record) => {
+    if (record.state !== "cancelled") return false;
+    const retained = visible.get(completionRequirementKey(record));
+    if (modelRequirementStateMatches(retained, record)) return false;
+    return !summarized || retained !== void 0;
+  });
+  if (records.length === 0) return void 0;
+  return {
+    role: "custom",
+    customType: COMPLETION_REQUIREMENT_TRANSITION_TYPE,
+    content: requiredCompletionTransitionContent(records, state.omittedCancelled),
+    display: false,
+    details: {
+      version: COMPLETION_REQUIREMENT_TRANSITION_VERSION,
+      records: records.map((record) => ({ ...record }))
+    },
+    timestamp: 0
+  };
+}
+function reconcileRequiredCompletionContext(messages, agents, restorationPredecessors = [], restoredBoundaryContent) {
+  const existing = messages.filter(isRequiredCompletionContextMessage);
+  const withoutPrior = messages.filter((message) => !isRequiredCompletionContextMessage(message));
+  const state = modelRequirementState(agents);
+  const summaryBoundary = leadingSummaryBoundary(withoutPrior);
+  const currentContent = state.records.length > 0 && !hasModelVisibleRequirementState(withoutPrior, state.records) ? requiredCompletionContextContent(state.records, state.omittedCancelled) : void 0;
+  const content = summaryBoundary > 0 ? restoredBoundaryContent ?? currentContent : void 0;
+  let insertionBoundary = summaryBoundary;
+  while (insertionBoundary < withoutPrior.length) {
+    const predecessor = withoutPrior[insertionBoundary];
+    if (predecessor?.role !== "custom" || !restorationPredecessors.includes(predecessor.customType)) {
+      break;
+    }
+    insertionBoundary += 1;
+  }
+  if (content !== void 0 && existing.length === 1 && messages[insertionBoundary] === existing[0] && existing[0]?.content === content && hasCompletionRequirementContextVersion(existing[0])) {
+    return messages;
+  }
+  if (existing.length === 0 && content === void 0) return messages;
+  if (content === void 0) return withoutPrior;
+  return [
+    ...withoutPrior.slice(0, insertionBoundary),
+    {
+      role: "custom",
+      customType: COMPLETION_REQUIREMENT_CONTEXT_TYPE,
+      content,
+      display: false,
+      details: { version: COMPLETION_REQUIREMENT_VERSION },
+      timestamp: 0
+    },
+    ...withoutPrior.slice(insertionBoundary)
+  ];
+}
+function modelRequirementState(agents) {
+  const allRecords = agents.flatMap(
+    (agent) => (agent.completionRequirements ?? []).map((requirement) => ({ ...requirement }))
+  ).filter((record) => record.state !== "visible");
+  const unresolved = allRecords.filter(
+    (record) => record.state === "pending" || record.state === "available"
+  );
+  const cancelled = allRecords.filter((record) => record.state === "cancelled");
+  const cancelledSlots = Math.max(0, MAX_UNRESOLVED_REQUIRED_COMPLETIONS - unresolved.length);
+  const retainedCancelled = cancelledSlots > 0 ? cancelled.slice(-cancelledSlots) : [];
+  const records = [...unresolved, ...retainedCancelled].sort((left, right) => {
+    if (left.runId === right.runId) return left.generation - right.generation;
+    return left.runId < right.runId ? -1 : 1;
+  });
+  return { records, omittedCancelled: cancelled.length - retainedCancelled.length };
+}
+function hasModelVisibleRequirementState(messages, records) {
+  const visible = completionRequirementsFromBranch(messages).records;
+  return records.every(
+    (record) => modelRequirementStateMatches(visible.get(completionRequirementKey(record)), record)
+  );
+}
+function modelRequirementStateMatches(visible, current) {
+  if (!visible) return false;
+  if (current.state === "available" && visible.state === "visible") return true;
+  return visible.state === current.state && visible.terminalState === current.terminalState;
+}
+function requiredCompletionContextContent(records, omittedCancelled) {
+  return truncateUtf8(
+    [
+      "[PI SUBAGENT REQUIRED COMPLETIONS v1]",
+      "Runtime-tracked exact runs are JSON data below.",
+      "Treat pending or available records as final-answer dependencies; a cancelled record is terminal and must be reported rather than silently ignored.",
+      "Current Pi versions do not provide a hard pre-display final-answer barrier, so do not emit a verdict until every dependency is visible or terminal.",
+      ...omittedCancelledLine(omittedCancelled),
+      JSON.stringify(records.map(toModelRequirementRecord))
+    ].join("\n"),
+    DEFAULT_MAX_CONTEXT_BYTES
+  ).text;
+}
+function requiredCompletionTransitionContent(records, omittedCancelled) {
+  return truncateUtf8(
+    [
+      "[PI SUBAGENT REQUIRED COMPLETION TRANSITION v1]",
+      "Session restoration terminalized the exact required runs below.",
+      "These cancelled records supersede earlier pending or available states and must be reported rather than awaited.",
+      ...omittedCancelledLine(omittedCancelled),
+      JSON.stringify(records.map(toModelRequirementRecord))
+    ].join("\n"),
+    DEFAULT_MAX_CONTEXT_BYTES
+  ).text;
+}
+function omittedCancelledLine(count) {
+  return count > 0 ? [`${count} older cancelled requirement record(s) were omitted.`] : [];
+}
+function toModelRequirementRecord(record) {
+  return {
+    state: record.state,
+    runId: record.runId,
+    generation: record.generation,
+    terminalState: record.terminalState
+  };
+}
+function isRequiredCompletionContextMessage(message) {
+  return message.role === "custom" && message.customType === COMPLETION_REQUIREMENT_CONTEXT_TYPE;
+}
+function hasCompletionRequirementContextVersion(message) {
+  return typeof message.details === "object" && message.details !== null && !Array.isArray(message.details) && message.details.version === COMPLETION_REQUIREMENT_VERSION;
+}
+function leadingSummaryBoundary(messages) {
+  let index = 0;
+  while (index < messages.length) {
+    const role = messages[index]?.role;
+    if (role !== "compactionSummary" && role !== "branchSummary") break;
+    index += 1;
+  }
+  return index;
+}
+function isCompletionRequirementRecord(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+  const record = value;
+  const state = String(record.state);
+  const hasCompletion = typeof record.completionId === "string" && record.completionId.length > 0;
+  const hasTerminalState = isAgentLifecycleState(record.terminalState);
+  const transitionShapeValid = state === "pending" ? record.completionId === void 0 && record.terminalState === void 0 : state === "available" || state === "visible" ? hasCompletion && hasTerminalState : state === "cancelled" && record.completionId === void 0 && hasTerminalState;
+  return transitionShapeValid && record.version === COMPLETION_REQUIREMENT_VERSION && typeof record.runId === "string" && record.runId.length > 0 && record.runId.length <= 256 && typeof record.generation === "number" && Number.isSafeInteger(record.generation) && record.generation >= 1 && ["pending", "available", "visible", "cancelled"].includes(state) && typeof record.createdAt === "number" && Number.isFinite(record.createdAt) && typeof record.updatedAt === "number" && Number.isFinite(record.updatedAt) && record.updatedAt >= record.createdAt && (record.completionId === void 0 || typeof record.completionId === "string" && record.completionId.length <= 256) && (record.terminalState === void 0 || isAgentLifecycleState(record.terminalState));
+}
+function updateExact(records, runId, generation, update) {
+  if (!records?.some((record) => record.runId === runId && record.generation === generation)) {
+    return records?.map((record) => ({ ...record }));
+  }
+  return records.map(
+    (record) => record.runId === runId && record.generation === generation ? update(record) : { ...record }
+  );
+}
+function isAgentLifecycleState(value) {
+  return [
+    "starting",
+    "running",
+    "idle",
+    "completed",
+    "partial",
+    "blocked",
+    "needs-input",
+    "abstained",
+    "stale",
+    "interrupted",
+    "failed",
+    "closed"
+  ].includes(String(value));
+}
+
+export {
+  CompletionRequirementModeSchema,
+  COMPLETION_REQUIREMENT_CONTEXT_TYPE,
+  MAX_UNRESOLVED_REQUIRED_COMPLETIONS,
+  beginCompletionRequirement,
+  makeCompletionAvailable,
+  makeCompletionVisible,
+  cancelPendingCompletionRequirements,
+  requirementForCompletion,
+  completionRequirementKey,
+  completionRequirementsFromBranch,
+  pendingRequiredCompletionCount,
+  createRequiredCompletionTransition,
+  reconcileRequiredCompletionContext,
+  isCompletionRequirementRecord
+};
+//# sourceMappingURL=chunk-NLT67IZS.ts.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/completion-requirement.ts"],
+  "sourcesContent": ["import { StringEnum } from \"@earendil-works/pi-ai\";\nimport type { ContextEvent } from \"@earendil-works/pi-coding-agent\";\nimport { DEFAULT_MAX_CONTEXT_BYTES, truncateUtf8 } from \"./limits.js\";\nimport type { AgentLifecycleState, ManagedAgent } from \"./registry-types.js\";\n\nexport const COMPLETION_REQUIREMENT_MODES = [\"background\", \"required\"] as const;\nexport type CompletionRequirementMode = (typeof COMPLETION_REQUIREMENT_MODES)[number];\n\nexport const CompletionRequirementModeSchema = StringEnum(COMPLETION_REQUIREMENT_MODES, {\n\tdescription:\n\t\t\"Mark this exact turn as background (default) or required for the parent final answer. Required results are tracked until their exact completion becomes visible, but current Pi versions do not provide a hard pre-display final-answer barrier.\",\n\tdefault: \"background\",\n});\n\nexport const COMPLETION_REQUIREMENT_VERSION = \"pi-subagents:completion-requirement:v1\" as const;\nexport const COMPLETION_REQUIREMENT_CONTEXT_TYPE = \"pi-subagent-required-completions\";\nexport const COMPLETION_REQUIREMENT_TRANSITION_TYPE = \"pi-subagent-required-completion-transition\";\nexport const COMPLETION_REQUIREMENT_TRANSITION_VERSION =\n\t\"pi-subagents:completion-requirement-transition:v1\" as const;\nconst MAX_REQUIREMENTS_PER_AGENT = 20;\nexport const MAX_UNRESOLVED_REQUIRED_COMPLETIONS = 64;\n\nexport type CompletionRequirementState = \"pending\" | \"available\" | \"visible\" | \"cancelled\";\n\nexport interface CompletionRequirementRecord {\n\tversion: typeof COMPLETION_REQUIREMENT_VERSION;\n\trunId: string;\n\tgeneration: number;\n\tstate: CompletionRequirementState;\n\tcreatedAt: number;\n\tupdatedAt: number;\n\tcompletionId?: string;\n\tterminalState?: AgentLifecycleState;\n}\n\nexport function beginCompletionRequirement(\n\trecords: readonly CompletionRequirementRecord[] | undefined,\n\tinput: { runId: string; generation: number; createdAt: number },\n): CompletionRequirementRecord[] {\n\tconst retained = (records ?? []).filter(\n\t\t(record) => record.runId !== input.runId || record.generation !== input.generation,\n\t);\n\tretained.push({\n\t\tversion: COMPLETION_REQUIREMENT_VERSION,\n\t\trunId: input.runId,\n\t\tgeneration: input.generation,\n\t\tstate: \"pending\",\n\t\tcreatedAt: input.createdAt,\n\t\tupdatedAt: input.createdAt,\n\t});\n\treturn retained.slice(-MAX_REQUIREMENTS_PER_AGENT);\n}\n\nexport function makeCompletionAvailable(\n\trecords: readonly CompletionRequirementRecord[] | undefined,\n\tinput: {\n\t\trunId: string;\n\t\tgeneration: number;\n\t\tcompletionId: string;\n\t\tterminalState: AgentLifecycleState;\n\t\tupdatedAt: number;\n\t},\n): CompletionRequirementRecord[] | undefined {\n\treturn updateExact(records, input.runId, input.generation, (record) => ({\n\t\t...record,\n\t\tstate: \"available\",\n\t\tcompletionId: input.completionId,\n\t\tterminalState: input.terminalState,\n\t\tupdatedAt: input.updatedAt,\n\t}));\n}\n\nexport function makeCompletionVisible(\n\trecords: readonly CompletionRequirementRecord[] | undefined,\n\tcompletionId: string,\n\tupdatedAt: number,\n): CompletionRequirementRecord[] | undefined {\n\tif (!records?.some((record) => record.completionId === completionId)) {\n\t\treturn records?.map((record) => ({ ...record }));\n\t}\n\treturn records.map((record) =>\n\t\trecord.completionId === completionId\n\t\t\t? { ...record, state: \"visible\" as const, updatedAt }\n\t\t\t: { ...record },\n\t);\n}\n\nexport function cancelPendingCompletionRequirements(\n\trecords: readonly CompletionRequirementRecord[] | undefined,\n\tterminalState: AgentLifecycleState,\n\tupdatedAt: number,\n): CompletionRequirementRecord[] | undefined {\n\tif (!records?.some((record) => record.state === \"pending\")) {\n\t\treturn records?.map((record) => ({ ...record }));\n\t}\n\treturn records.map((record) =>\n\t\trecord.state === \"pending\"\n\t\t\t? {\n\t\t\t\t\t...record,\n\t\t\t\t\tstate: \"cancelled\" as const,\n\t\t\t\t\tterminalState,\n\t\t\t\t\tupdatedAt,\n\t\t\t\t}\n\t\t\t: { ...record },\n\t);\n}\n\nexport function requirementForCompletion(\n\tagent: Pick<ManagedAgent, \"completionRequirements\">,\n\tcompletionId: string,\n): CompletionRequirementRecord | undefined {\n\treturn agent.completionRequirements?.find((record) => record.completionId === completionId);\n}\n\nexport interface BranchCompletionRequirementState {\n\tobservedState: boolean;\n\trecords: Map<string, CompletionRequirementRecord>;\n\tkeys: Set<string>;\n}\n\nexport function completionRequirementKey(\n\trecord: Pick<CompletionRequirementRecord, \"runId\" | \"generation\">,\n): string {\n\treturn `${record.runId}\\u0000${record.generation}`;\n}\n\nexport function completionRequirementsFromBranch(\n\tentries: readonly unknown[],\n): BranchCompletionRequirementState {\n\tconst records = new Map<string, CompletionRequirementRecord>();\n\tlet observedState = false;\n\tfor (const entry of entries) {\n\t\tif (!entry || typeof entry !== \"object\" || Array.isArray(entry)) continue;\n\t\tconst candidate = entry as Record<string, unknown>;\n\t\tconst message =\n\t\t\tcandidate.type === \"message\" && candidate.message && typeof candidate.message === \"object\"\n\t\t\t\t? (candidate.message as Record<string, unknown>)\n\t\t\t\t: candidate;\n\t\tif (\n\t\t\tmessage.role === \"toolResult\" &&\n\t\t\t[\"subagent_spawn\", \"subagent_send\", \"subagent_await\", \"subagent_manage\"].includes(\n\t\t\t\tString(message.toolName),\n\t\t\t)\n\t\t) {\n\t\t\tobservedState = true;\n\t\t\tconst details = message.details;\n\t\t\tif (!details || typeof details !== \"object\" || Array.isArray(details)) continue;\n\t\t\tconst detailsRecord = details as Record<string, unknown>;\n\t\t\tconst agents = [\n\t\t\t\tdetailsRecord.agent,\n\t\t\t\t...(Array.isArray(detailsRecord.agents) ? detailsRecord.agents : []),\n\t\t\t];\n\t\t\tfor (const agent of agents) {\n\t\t\t\tif (!agent || typeof agent !== \"object\" || Array.isArray(agent)) continue;\n\t\t\t\tconst requirements = (agent as Record<string, unknown>).completionRequirements;\n\t\t\t\tif (!Array.isArray(requirements)) continue;\n\t\t\t\tfor (const requirement of requirements) {\n\t\t\t\t\tif (isCompletionRequirementRecord(requirement)) {\n\t\t\t\t\t\trecords.set(completionRequirementKey(requirement), { ...requirement });\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\t\tif (\n\t\t\tmessage.role === \"custom\" &&\n\t\t\tmessage.customType === COMPLETION_REQUIREMENT_TRANSITION_TYPE\n\t\t) {\n\t\t\tconst details = message.details;\n\t\t\tif (!details || typeof details !== \"object\" || Array.isArray(details)) continue;\n\t\t\tconst detailRecord = details as Record<string, unknown>;\n\t\t\tif (detailRecord.version !== COMPLETION_REQUIREMENT_TRANSITION_VERSION) continue;\n\t\t\tconst requirements = Array.isArray(detailRecord.records) ? detailRecord.records : [];\n\t\t\tfor (const requirement of requirements) {\n\t\t\t\tif (!isCompletionRequirementRecord(requirement) || requirement.state !== \"cancelled\") {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tobservedState = true;\n\t\t\t\trecords.set(completionRequirementKey(requirement), { ...requirement });\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\t\tif (message.role !== \"custom\" || message.customType !== \"pi-subagent-completion\") continue;\n\t\tconst details = message.details;\n\t\tif (!details || typeof details !== \"object\" || Array.isArray(details)) continue;\n\t\tconst detailRecord = details as Record<string, unknown>;\n\t\tconst completionRecords = Array.isArray(detailRecord.completions)\n\t\t\t? detailRecord.completions\n\t\t\t: [detailRecord];\n\t\tfor (const completion of completionRecords) {\n\t\t\tif (!completion || typeof completion !== \"object\" || Array.isArray(completion)) continue;\n\t\t\tconst requirement = (completion as Record<string, unknown>).completionRequirement;\n\t\t\tif (!isCompletionRequirementRecord(requirement)) continue;\n\t\t\trecords.set(completionRequirementKey(requirement), {\n\t\t\t\t...requirement,\n\t\t\t\tstate: \"visible\",\n\t\t\t});\n\t\t}\n\t}\n\treturn { observedState, records, keys: new Set(records.keys()) };\n}\n\nexport function pendingRequiredCompletionCount(\n\tagent: Pick<ManagedAgent, \"completionRequirements\">,\n): number {\n\treturn (agent.completionRequirements ?? []).filter(\n\t\t(record) => record.state === \"pending\" || record.state === \"available\",\n\t).length;\n}\n\nexport function createRequiredCompletionTransition(\n\tmessages: ContextEvent[\"messages\"],\n\tagents: readonly ManagedAgent[],\n) {\n\tconst summarized = leadingSummaryBoundary(messages) > 0;\n\tconst state = modelRequirementState(agents);\n\tconst visible = completionRequirementsFromBranch(messages).records;\n\tconst records = state.records.filter((record) => {\n\t\tif (record.state !== \"cancelled\") return false;\n\t\tconst retained = visible.get(completionRequirementKey(record));\n\t\tif (modelRequirementStateMatches(retained, record)) return false;\n\t\treturn !summarized || retained !== undefined;\n\t});\n\tif (records.length === 0) return undefined;\n\treturn {\n\t\trole: \"custom\" as const,\n\t\tcustomType: COMPLETION_REQUIREMENT_TRANSITION_TYPE,\n\t\tcontent: requiredCompletionTransitionContent(records, state.omittedCancelled),\n\t\tdisplay: false,\n\t\tdetails: {\n\t\t\tversion: COMPLETION_REQUIREMENT_TRANSITION_VERSION,\n\t\t\trecords: records.map((record) => ({ ...record })),\n\t\t},\n\t\ttimestamp: 0,\n\t};\n}\n\nexport function reconcileRequiredCompletionContext(\n\tmessages: ContextEvent[\"messages\"],\n\tagents: readonly ManagedAgent[],\n\trestorationPredecessors: readonly string[] = [],\n\trestoredBoundaryContent?: string,\n): ContextEvent[\"messages\"] {\n\tconst existing = messages.filter(isRequiredCompletionContextMessage);\n\tconst withoutPrior = messages.filter((message) => !isRequiredCompletionContextMessage(message));\n\tconst state = modelRequirementState(agents);\n\tconst summaryBoundary = leadingSummaryBoundary(withoutPrior);\n\tconst currentContent =\n\t\tstate.records.length > 0 && !hasModelVisibleRequirementState(withoutPrior, state.records)\n\t\t\t? requiredCompletionContextContent(state.records, state.omittedCancelled)\n\t\t\t: undefined;\n\tconst content = summaryBoundary > 0 ? (restoredBoundaryContent ?? currentContent) : undefined;\n\tlet insertionBoundary = summaryBoundary;\n\twhile (insertionBoundary < withoutPrior.length) {\n\t\tconst predecessor = withoutPrior[insertionBoundary];\n\t\tif (\n\t\t\tpredecessor?.role !== \"custom\" ||\n\t\t\t!restorationPredecessors.includes(predecessor.customType)\n\t\t) {\n\t\t\tbreak;\n\t\t}\n\t\tinsertionBoundary += 1;\n\t}\n\tif (\n\t\tcontent !== undefined &&\n\t\texisting.length === 1 &&\n\t\tmessages[insertionBoundary] === existing[0] &&\n\t\texisting[0]?.content === content &&\n\t\thasCompletionRequirementContextVersion(existing[0])\n\t) {\n\t\treturn messages;\n\t}\n\tif (existing.length === 0 && content === undefined) return messages;\n\tif (content === undefined) return withoutPrior;\n\treturn [\n\t\t...withoutPrior.slice(0, insertionBoundary),\n\t\t{\n\t\t\trole: \"custom\",\n\t\t\tcustomType: COMPLETION_REQUIREMENT_CONTEXT_TYPE,\n\t\t\tcontent,\n\t\t\tdisplay: false,\n\t\t\tdetails: { version: COMPLETION_REQUIREMENT_VERSION },\n\t\t\ttimestamp: 0,\n\t\t},\n\t\t...withoutPrior.slice(insertionBoundary),\n\t];\n}\n\ninterface ModelRequirementRecord {\n\tstate: CompletionRequirementState;\n\trunId: string;\n\tgeneration: number;\n\tterminalState: AgentLifecycleState | undefined;\n}\n\nfunction modelRequirementState(agents: readonly ManagedAgent[]): {\n\trecords: CompletionRequirementRecord[];\n\tomittedCancelled: number;\n} {\n\tconst allRecords = agents\n\t\t.flatMap((agent) =>\n\t\t\t(agent.completionRequirements ?? []).map((requirement) => ({ ...requirement })),\n\t\t)\n\t\t.filter((record) => record.state !== \"visible\");\n\tconst unresolved = allRecords.filter(\n\t\t(record) => record.state === \"pending\" || record.state === \"available\",\n\t);\n\tconst cancelled = allRecords.filter((record) => record.state === \"cancelled\");\n\tconst cancelledSlots = Math.max(0, MAX_UNRESOLVED_REQUIRED_COMPLETIONS - unresolved.length);\n\tconst retainedCancelled = cancelledSlots > 0 ? cancelled.slice(-cancelledSlots) : [];\n\tconst records = [...unresolved, ...retainedCancelled].sort((left, right) => {\n\t\tif (left.runId === right.runId) return left.generation - right.generation;\n\t\treturn left.runId < right.runId ? -1 : 1;\n\t});\n\treturn { records, omittedCancelled: cancelled.length - retainedCancelled.length };\n}\n\nfunction hasModelVisibleRequirementState(\n\tmessages: ContextEvent[\"messages\"],\n\trecords: readonly CompletionRequirementRecord[],\n): boolean {\n\tconst visible = completionRequirementsFromBranch(messages).records;\n\treturn records.every((record) =>\n\t\tmodelRequirementStateMatches(visible.get(completionRequirementKey(record)), record),\n\t);\n}\n\nfunction modelRequirementStateMatches(\n\tvisible: CompletionRequirementRecord | undefined,\n\tcurrent: CompletionRequirementRecord,\n): boolean {\n\tif (!visible) return false;\n\tif (current.state === \"available\" && visible.state === \"visible\") return true;\n\treturn visible.state === current.state && visible.terminalState === current.terminalState;\n}\n\nfunction requiredCompletionContextContent(\n\trecords: readonly CompletionRequirementRecord[],\n\tomittedCancelled: number,\n): string {\n\treturn truncateUtf8(\n\t\t[\n\t\t\t\"[PI SUBAGENT REQUIRED COMPLETIONS v1]\",\n\t\t\t\"Runtime-tracked exact runs are JSON data below.\",\n\t\t\t\"Treat pending or available records as final-answer dependencies; a cancelled record is terminal and must be reported rather than silently ignored.\",\n\t\t\t\"Current Pi versions do not provide a hard pre-display final-answer barrier, so do not emit a verdict until every dependency is visible or terminal.\",\n\t\t\t...omittedCancelledLine(omittedCancelled),\n\t\t\tJSON.stringify(records.map(toModelRequirementRecord)),\n\t\t].join(\"\\n\"),\n\t\tDEFAULT_MAX_CONTEXT_BYTES,\n\t).text;\n}\n\nfunction requiredCompletionTransitionContent(\n\trecords: readonly CompletionRequirementRecord[],\n\tomittedCancelled: number,\n): string {\n\treturn truncateUtf8(\n\t\t[\n\t\t\t\"[PI SUBAGENT REQUIRED COMPLETION TRANSITION v1]\",\n\t\t\t\"Session restoration terminalized the exact required runs below.\",\n\t\t\t\"These cancelled records supersede earlier pending or available states and must be reported rather than awaited.\",\n\t\t\t...omittedCancelledLine(omittedCancelled),\n\t\t\tJSON.stringify(records.map(toModelRequirementRecord)),\n\t\t].join(\"\\n\"),\n\t\tDEFAULT_MAX_CONTEXT_BYTES,\n\t).text;\n}\n\nfunction omittedCancelledLine(count: number): string[] {\n\treturn count > 0 ? [`${count} older cancelled requirement record(s) were omitted.`] : [];\n}\n\nfunction toModelRequirementRecord(record: CompletionRequirementRecord): ModelRequirementRecord {\n\treturn {\n\t\tstate: record.state,\n\t\trunId: record.runId,\n\t\tgeneration: record.generation,\n\t\tterminalState: record.terminalState,\n\t};\n}\n\ntype RequiredCompletionContextMessage = Extract<\n\tContextEvent[\"messages\"][number],\n\t{ role: \"custom\" }\n> & { content: string };\n\nfunction isRequiredCompletionContextMessage(\n\tmessage: ContextEvent[\"messages\"][number],\n): message is RequiredCompletionContextMessage {\n\treturn message.role === \"custom\" && message.customType === COMPLETION_REQUIREMENT_CONTEXT_TYPE;\n}\n\nfunction hasCompletionRequirementContextVersion(\n\tmessage: RequiredCompletionContextMessage,\n): boolean {\n\treturn (\n\t\ttypeof message.details === \"object\" &&\n\t\tmessage.details !== null &&\n\t\t!Array.isArray(message.details) &&\n\t\t(message.details as Record<string, unknown>).version === COMPLETION_REQUIREMENT_VERSION\n\t);\n}\n\nfunction leadingSummaryBoundary(messages: ContextEvent[\"messages\"]): number {\n\tlet index = 0;\n\twhile (index < messages.length) {\n\t\tconst role = messages[index]?.role;\n\t\tif (role !== \"compactionSummary\" && role !== \"branchSummary\") break;\n\t\tindex += 1;\n\t}\n\treturn index;\n}\n\nexport function isCompletionRequirementRecord(\n\tvalue: unknown,\n): value is CompletionRequirementRecord {\n\tif (!value || typeof value !== \"object\" || Array.isArray(value)) return false;\n\tconst record = value as Record<string, unknown>;\n\tconst state = String(record.state);\n\tconst hasCompletion = typeof record.completionId === \"string\" && record.completionId.length > 0;\n\tconst hasTerminalState = isAgentLifecycleState(record.terminalState);\n\tconst transitionShapeValid =\n\t\tstate === \"pending\"\n\t\t\t? record.completionId === undefined && record.terminalState === undefined\n\t\t\t: state === \"available\" || state === \"visible\"\n\t\t\t\t? hasCompletion && hasTerminalState\n\t\t\t\t: state === \"cancelled\" && record.completionId === undefined && hasTerminalState;\n\treturn (\n\t\ttransitionShapeValid &&\n\t\trecord.version === COMPLETION_REQUIREMENT_VERSION &&\n\t\ttypeof record.runId === \"string\" &&\n\t\trecord.runId.length > 0 &&\n\t\trecord.runId.length <= 256 &&\n\t\ttypeof record.generation === \"number\" &&\n\t\tNumber.isSafeInteger(record.generation) &&\n\t\trecord.generation >= 1 &&\n\t\t[\"pending\", \"available\", \"visible\", \"cancelled\"].includes(state) &&\n\t\ttypeof record.createdAt === \"number\" &&\n\t\tNumber.isFinite(record.createdAt) &&\n\t\ttypeof record.updatedAt === \"number\" &&\n\t\tNumber.isFinite(record.updatedAt) &&\n\t\trecord.updatedAt >= record.createdAt &&\n\t\t(record.completionId === undefined ||\n\t\t\t(typeof record.completionId === \"string\" && record.completionId.length <= 256)) &&\n\t\t(record.terminalState === undefined || isAgentLifecycleState(record.terminalState))\n\t);\n}\n\nfunction updateExact(\n\trecords: readonly CompletionRequirementRecord[] | undefined,\n\trunId: string,\n\tgeneration: number,\n\tupdate: (record: CompletionRequirementRecord) => CompletionRequirementRecord,\n): CompletionRequirementRecord[] | undefined {\n\tif (!records?.some((record) => record.runId === runId && record.generation === generation)) {\n\t\treturn records?.map((record) => ({ ...record }));\n\t}\n\treturn records.map((record) =>\n\t\trecord.runId === runId && record.generation === generation ? update(record) : { ...record },\n\t);\n}\n\nfunction isAgentLifecycleState(value: unknown): value is AgentLifecycleState {\n\treturn [\n\t\t\"starting\",\n\t\t\"running\",\n\t\t\"idle\",\n\t\t\"completed\",\n\t\t\"partial\",\n\t\t\"blocked\",\n\t\t\"needs-input\",\n\t\t\"abstained\",\n\t\t\"stale\",\n\t\t\"interrupted\",\n\t\t\"failed\",\n\t\t\"closed\",\n\t].includes(String(value));\n}\n"],
+  "mappings": "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",
+  "names": ["details", "detailRecord"]
+}

package/dist/chunks/{chunk-G3RSMSXJ.ts → chunk-NTRPLF46.ts}

@@ -60,4 +60,4 @@ export {
   resolveTimeoutFinalizationMs,
   buildTimeoutFinalizationPrompt
 };
-//# sourceMappingURL=chunk-G3RSMSXJ.ts.map
+//# sourceMappingURL=chunk-NTRPLF46.ts.map

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

@@ -0,0 +1,7 @@
+{
+  "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": []
+}