nolo-cli 0.149.0-alpha.1 → 0.151.0-alpha.2

package/{chunk-TB3MIBRC.js → chunk-T6X3D7NB.js}

@@ -1,46 +1,63 @@
 import {
   buildStaticUserPolicyContext,
   resolveSpaceContextPreloadPlan
-} from "./chunk-O2OWEFII.js";
+} from "./chunk-KFHQQ3NO.js";
 import {
   fetchReferenceContents,
   mergeReferences,
   resolveReferenceAssets,
   resolveToolsFromKeys
-} from "./chunk-HTVYCXBP.js";
+} from "./chunk-SMENBO3M.js";
 import {
+  UI_CARD_ENVELOPE_MAX_BYTES,
   getAllToolRuns,
+  parseUiCard,
   resolveAgentRecommendedSkillNames,
-  resolveAgentRequiredPackIds
-} from "./chunk-ATLTFRYJ.js";
-import {
-  getDocState
-} from "./chunk-TXH4IWJL.js";
+  resolveAgentRequiredPackIds,
+  selectAiRecentContentLimit,
+  selectGlobalPrompt,
+  selectKnowledgeCaptureLevel,
+  selectSpaceContextLevel,
+  selectUserTonePreset,
+  uiCardFallback
+} from "./chunk-ES633ZS5.js";
 import {
   resolveToolBaseUrl
-} from "./chunk-XPRWFQQK.js";
+} from "./chunk-CBHGZRCE.js";
 import {
-  getTableState
-} from "./chunk-36KZDDO5.js";
+  getFinalPrice,
+  getModelPricing,
+  getPrices,
+  hasExplicitAgentPricing
+} from "./chunk-RSHPU4PD.js";
 import {
-  getCurrentSpaceIdRaw,
-  getViewMode
-} from "./chunk-ZJ7UHBJS.js";
+  getDocState
+} from "./chunk-GQN2WLAI.js";
+import {
+  getTableState
+} from "./chunk-ZKZ5X2HS.js";
 import {
   PERSONALIZATION_DIALOG_CATEGORY,
   buildPersonalizationDialogPolicyContext,
   extractReferenceKeysFromMessage,
   selectAllMsgs
-} from "./chunk-ACQD6YI2.js";
+} from "./chunk-556RW72X.js";
+import {
+  getCurrentSpaceIdRaw,
+  getViewMode
+} from "./chunk-ZJ7UHBJS.js";
 import {
   selectPendingFiles
-} from "./chunk-B6SAMB33.js";
+} from "./chunk-OWYYDMGJ.js";
 import {
-  getFinalPrice,
-  getModelPricing,
-  getPrices,
-  hasExplicitAgentPricing
-} from "./chunk-4DPP773Q.js";
+  read,
+  selectById
+} from "./chunk-74RAWNQN.js";
+import {
+  getSessionSnapshotForState,
+  selectIdentityUserBalance,
+  selectIdentityUserId
+} from "./chunk-SEJ5OS6F.js";
 import {
   TOOL_PACKS,
   addDefaultSystemCapabilityTools,
@@ -50,72 +67,246 @@ import {
   expandEnabledPackPromptPatches,
   expandEnabledPacks,
   resolveEffectiveEnabledPacks
-} from "./chunk-6TPOEJMQ.js";
+} from "./chunk-JZX2XLKC.js";
 import {
   projectToolMessageContent
-} from "./chunk-PQWU42UQ.js";
+} from "./chunk-GCKHQECX.js";
 import {
-  getModelContextWindow
-} from "./chunk-AKG5W4LG.js";
+  attachmentKind,
+  normalizeAttachmentPart
+} from "./chunk-WJZOQR2J.js";
 import {
+  getModelContextWindow,
   planContextUsage
-} from "./chunk-RYZINGPM.js";
+} from "./chunk-BPMPOFWP.js";
 import {
-  estimateTokenCount
-} from "./chunk-PSCNXBYA.js";
-import {
-  getModelConfig,
-  getProviderByModelName
-} from "./chunk-3BXNTXYI.js";
+  asRecordOrEmpty
+} from "./chunk-KX6YBIHG.js";
 import {
-  buildLinkedSpacesSection,
-  buildSpaceContextLayer
-} from "./chunk-HDLLCBRF.js";
+  isAbortError
+} from "./chunk-7DPNBQSV.js";
 import {
   canonicalizeToolNames,
   prioritizeToolNames
-} from "./chunk-XUWRURDF.js";
-import {
-  selectAiRecentContentLimit,
-  selectGlobalPrompt,
-  selectKnowledgeCaptureLevel,
-  selectSpaceContextLevel,
-  selectUserTonePreset
-} from "./chunk-SONWNI3L.js";
-import {
-  asRecordOrEmpty
-} from "./chunk-KX6YBIHG.js";
+} from "./chunk-5EBLANFT.js";
 import {
-  read,
-  selectById
-} from "./chunk-HYZIYH2H.js";
+  extractCustomId
+} from "./chunk-M2EJHDJP.js";
 import {
-  asNonEmptyStringArray,
   metaKey
-} from "./chunk-3AH7LNUB.js";
+} from "./chunk-5EMSBTQ6.js";
+import {
+  asNonEmptyStringArray
+} from "./chunk-I42VC5KR.js";
 import {
   asOptionalFiniteNumber
 } from "./chunk-WWC7I6TA.js";
 import {
-  isAbortError
-} from "./chunk-QOKAKDPE.js";
+  estimateTokenCount
+} from "./chunk-PSCNXBYA.js";
 import {
-  getSessionSnapshotForState,
-  selectIdentityUserBalance,
-  selectIdentityUserId
-} from "./chunk-SEJ5OS6F.js";
+  getModelConfig,
+  getProviderByModelName
+} from "./chunk-I4SN4NUQ.js";
 import {
   isRecord
 } from "./chunk-KUG52IAP.js";
-import {
-  extractCustomId
-} from "./chunk-M2EJHDJP.js";
 import {
   asTrimmedString
 } from "./chunk-3EUW3WEO.js";
 import {
   asOptionalTrimmedString
 } from "./chunk-G3SUCT4W.js";
+import {
+  buildLinkedSpacesSection,
+  buildSpaceContextLayer
+} from "./chunk-VEA7H5FG.js";
+
+// packages/ai/agent/foregroundTurnAdmissionFetch.ts
+var FOREGROUND_TURN_KEEPALIVE_MAX_BODY_BYTES = 60 * 1024;
+function getUtf8ByteLength(value) {
+  return new TextEncoder().encode(value).byteLength;
+}
+function shouldKeepForegroundTurnAdmissionAlive(serializedBody) {
+  return serializedBody.length > 0 && getUtf8ByteLength(serializedBody) <= FOREGROUND_TURN_KEEPALIVE_MAX_BODY_BYTES;
+}
+function buildForegroundTurnAdmissionFetchInit(args) {
+  return {
+    method: "POST",
+    headers: args.headers,
+    body: args.body,
+    ...args.signal ? { signal: args.signal } : {},
+    ...shouldKeepForegroundTurnAdmissionAlive(args.body) ? { keepalive: true } : {}
+  };
+}
+
+// packages/ai/agent/foregroundExecutionClientState.ts
+var stateByDialogId = /* @__PURE__ */ new Map();
+var MAX_TRACKED_DIALOGS = 256;
+function trimmed(value) {
+  return typeof value === "string" ? value.trim() : "";
+}
+function trimCache() {
+  while (stateByDialogId.size > MAX_TRACKED_DIALOGS) {
+    const oldest = stateByDialogId.keys().next().value;
+    if (!oldest) return;
+    stateByDialogId.delete(oldest);
+  }
+}
+function setForegroundExecutionClientState(args) {
+  const dialogId = trimmed(args.dialogId);
+  const executionId = trimmed(args.executionId);
+  if (!dialogId || !executionId) return;
+  stateByDialogId.delete(dialogId);
+  stateByDialogId.set(dialogId, { dialogId, executionId, status: "running" });
+  trimCache();
+}
+function clearForegroundExecutionClientState(dialogId, expectedExecutionId) {
+  const normalizedDialogId = trimmed(dialogId);
+  if (!normalizedDialogId) return;
+  if (expectedExecutionId) {
+    const current = stateByDialogId.get(normalizedDialogId);
+    if (current && current.executionId !== expectedExecutionId) return;
+  }
+  stateByDialogId.delete(normalizedDialogId);
+}
+function observeForegroundExecutionPayload(payload) {
+  if (!payload || typeof payload !== "object") return;
+  const event = payload;
+  const type = trimmed(event.type);
+  const dialogId = trimmed(event.dialogId);
+  const executionId = trimmed(event.executionId);
+  if ((type === "dialog" || type === "foreground_turn_status") && event.status === "running" && dialogId && executionId) {
+    setForegroundExecutionClientState({ dialogId, executionId });
+    return;
+  }
+  if (type === "foreground_turn_terminal" || type === "done" || type === "cancelled" || type === "error" || type === "failed") {
+    if (dialogId && executionId) {
+      clearForegroundExecutionClientState(dialogId, executionId);
+    }
+  }
+}
+
+// packages/ai/agent/streamTurnStreamConsumer.ts
+async function readAgentRunStreamChunk(reader, signal, isAborted) {
+  if (isAborted() || signal?.aborted) {
+    void reader.cancel().catch(() => {
+    });
+    throw new DOMException("The operation was aborted.", "AbortError");
+  }
+  if (!signal) {
+    return reader.read();
+  }
+  let settled = false;
+  return new Promise((resolve, reject) => {
+    const finish = (cb) => {
+      if (settled) return;
+      settled = true;
+      signal.removeEventListener("abort", onAbort);
+      cb();
+    };
+    const onAbort = () => {
+      void reader.cancel().catch(() => {
+      });
+      finish(
+        () => reject(new DOMException("The operation was aborted.", "AbortError"))
+      );
+    };
+    signal.addEventListener("abort", onAbort);
+    reader.read().then(
+      (result) => finish(() => resolve(result)),
+      (err) => finish(() => reject(err))
+    );
+  });
+}
+async function consumeAgentRunStream(handlers) {
+  const {
+    reader,
+    decoder,
+    parseChunk,
+    onPayload,
+    isDoneEvent,
+    isAborted,
+    signal,
+    onAbort
+  } = handlers;
+  let sawDone = false;
+  let observedDialogId = "";
+  let observedExecutionId = "";
+  const clearObservedExecution = () => {
+    if (!observedDialogId || !observedExecutionId) return;
+    clearForegroundExecutionClientState(
+      observedDialogId,
+      observedExecutionId
+    );
+  };
+  try {
+    while (true) {
+      let done;
+      let value;
+      try {
+        ({ done, value } = await readAgentRunStreamChunk(
+          reader,
+          signal,
+          isAborted
+        ));
+      } catch (error) {
+        if (isAbortError(error) || isAborted() || signal?.aborted) {
+          clearObservedExecution();
+          await onAbort();
+          return { outcome: "aborted" };
+        }
+        throw error;
+      }
+      if (isAborted() || signal?.aborted) {
+        clearObservedExecution();
+        await onAbort();
+        return { outcome: "aborted" };
+      }
+      if (done) {
+        clearObservedExecution();
+        return { outcome: "streamEnded", sawDone };
+      }
+      const payloads = parseChunk(
+        decoder.decode(value, { stream: true })
+      );
+      for (const payload of payloads) {
+        if (isAborted() || signal?.aborted) {
+          clearObservedExecution();
+          await onAbort();
+          return { outcome: "aborted" };
+        }
+        if (payload && typeof payload === "object") {
+          if (payload.type === "dialog" && typeof payload.dialogId === "string") {
+            observedDialogId = payload.dialogId.trim();
+            observedExecutionId = typeof payload.executionId === "string" ? payload.executionId.trim() : "";
+          }
+          observeForegroundExecutionPayload(payload);
+        }
+        const directive = await onPayload(payload);
+        if (directive?.reject !== void 0) {
+          clearObservedExecution();
+          return { outcome: "rejected", message: directive.reject };
+        }
+        if (directive?.abort) {
+          clearObservedExecution();
+          await onAbort();
+          return { outcome: "aborted" };
+        }
+        if (isDoneEvent(payload)) {
+          sawDone = true;
+        }
+      }
+    }
+  } catch (error) {
+    clearObservedExecution();
+    if (isAbortError(error) || isAborted() || signal?.aborted) {
+      await onAbort();
+      return { outcome: "aborted" };
+    }
+    throw error;
+  }
+}
 
 // packages/ai/agent/projectDesktopToolUiContent.ts
 var DESKTOP_TOOL_UI_CONTENT_MAX_CHARS = 48e3;
@@ -174,10 +365,26 @@ function projectDesktopToolUiContent(args) {
   const toolName = asOptionalTrimmedString(args.toolName) || "tool";
   const metadata = isRecord(args.metadata) ? args.metadata : {};
   const rawContent = typeof args.content === "string" ? args.content : typeof args.summary === "string" ? args.summary : typeof args.message === "string" ? args.message : "";
-  if (toolName === "setTodoList") {
-    const existing = tryParseJsonRecord(rawContent);
-    if (existing && Array.isArray(existing.todos)) {
-      return clipUiText(JSON.stringify({ todos: existing.todos }));
+  if (toolName === "show_interaction") {
+    try {
+      const parsedContent = JSON.parse(rawContent);
+      const envelope = isRecord(parsedContent) && isRecord(parsedContent.rawData) ? parsedContent.rawData : parsedContent;
+      const candidate = isRecord(envelope) && envelope.type === "show_interaction" ? envelope.card : envelope;
+      const parsed = parseUiCard(candidate);
+      if (!parsed.ok) return `show_interaction failed: invalid card (${parsed.error})`;
+      const card = parsed.value;
+      const cardOnly = JSON.stringify({ type: "show_interaction", card });
+      if (new TextEncoder().encode(cardOnly).byteLength > UI_CARD_ENVELOPE_MAX_BYTES) {
+        return "show_interaction failed: projected card too large";
+      }
+      const canonical = JSON.stringify({
+        type: "show_interaction",
+        card,
+        fallbackText: uiCardFallback(card)
+      });
+      return new TextEncoder().encode(canonical).byteLength <= UI_CARD_ENVELOPE_MAX_BYTES ? canonical : cardOnly;
+    } catch {
+      return "show_interaction failed: invalid JSON card";
     }
   }
   if (toolName === "execShell") {
@@ -219,6 +426,105 @@ function projectDesktopToolUiContent(args) {
   return clipUiText(preferred);
 }
 
+// packages/ai/attachments/toolsForAttachments.ts
+var LEGACY_MEDIA_JOB_PART_TYPE = "media_job";
+var LEGACY_MEDIA_TEXT_PREFIX = "[\u5A92\u4F53\u9644\u4EF6]";
+var LEGACY_MEDIA_TEXT_FIELDS = ["fileId", "jobId", "\u6587\u4EF6", "\u65F6\u957F"];
+var LEGACY_MEDIA_TEXT_ID_FIELDS = ["fileId", "jobId"];
+var LEGACY_MEDIA_TEXT_STRICT_PATTERN = /^\[媒体附件\](?:\s+(?:fileId|jobId|文件|时长)=\S+)+$/;
+var parseLegacyMediaFields = (body) => {
+  const matcher = new RegExp(`(?:${LEGACY_MEDIA_TEXT_FIELDS.join("|")})=`, "g");
+  const starts = [];
+  for (let match = matcher.exec(body); match; match = matcher.exec(body)) {
+    starts.push({
+      key: match[0].slice(0, -1),
+      start: match.index,
+      end: match.index + match[0].length
+    });
+  }
+  if (starts.length === 0) return null;
+  if (body.slice(0, starts[0].start).trim() !== "") return null;
+  return starts.map((field, index) => ({
+    key: field.key,
+    value: body.slice(field.end, index + 1 < starts.length ? starts[index + 1].start : body.length)
+  }));
+};
+var hasLegacyMediaId = (fields) => fields.some(
+  (field) => LEGACY_MEDIA_TEXT_ID_FIELDS.includes(field.key) && /^\S+$/.test(field.value.trim())
+);
+var isLegacyMediaText = (text) => {
+  if (typeof text !== "string" || !text.startsWith(LEGACY_MEDIA_TEXT_PREFIX)) return false;
+  const rest = text.slice(LEGACY_MEDIA_TEXT_PREFIX.length);
+  if (rest !== "" && !/^\s/.test(rest)) return false;
+  const fields = parseLegacyMediaFields(rest);
+  if (!fields) return false;
+  if (fields.some((field) => field.value.trim() === "")) return false;
+  if (hasLegacyMediaId(fields)) return true;
+  return LEGACY_MEDIA_TEXT_STRICT_PATTERN.test(text);
+};
+var isLegacyMediaJobText = (part) => {
+  if (typeof part !== "object" || part === null) return false;
+  const record = part;
+  if (record.type !== "text" || typeof record.text !== "string") return false;
+  return isLegacyMediaText(record.text.trim());
+};
+var MEDIA_ATOMIC_TOOLS = [
+  "transcribe",
+  "translate",
+  "writeTranslations",
+  "exportDocument",
+  "readArtifact"
+];
+var TOOLS_BY_KIND = {
+  audio: MEDIA_ATOMIC_TOOLS,
+  video: MEDIA_ATOMIC_TOOLS,
+  image: [],
+  document: [],
+  text: [],
+  archive: [],
+  // P2：archive 目录清单 + 只读条目工具
+  binary: []
+};
+var toolsForAttachmentKinds = (kinds) => {
+  const names = /* @__PURE__ */ new Set();
+  for (const kind of kinds ?? []) {
+    for (const name of TOOLS_BY_KIND[kind] ?? []) {
+      names.add(name);
+    }
+  }
+  return Array.from(names);
+};
+var attachmentKindOfPart = (part) => {
+  if (typeof part !== "object" || part === null) return null;
+  const record = part;
+  if (record.type === LEGACY_MEDIA_JOB_PART_TYPE) return "audio";
+  if (isLegacyMediaJobText(record)) return "audio";
+  const normalized = normalizeAttachmentPart(record);
+  return normalized.status === "valid" ? attachmentKind(normalized.attachment) : null;
+};
+var MAX_PART_DEPTH = 4;
+var collectParts = (input, out, depth) => {
+  if (depth > MAX_PART_DEPTH) return;
+  if (Array.isArray(input)) {
+    for (const item of input) collectParts(item, out, depth + 1);
+    return;
+  }
+  if (typeof input !== "object" || input === null) return;
+  const record = input;
+  out.push(record);
+  if (Array.isArray(record.children)) collectParts(record.children, out, depth + 1);
+};
+var attachmentKindsInContent = (content) => {
+  const parts = [];
+  collectParts(content, parts, 0);
+  const kinds = /* @__PURE__ */ new Set();
+  for (const part of parts) {
+    const kind = attachmentKindOfPart(part);
+    if (kind) kinds.add(kind);
+  }
+  return Array.from(kinds);
+};
+
 // packages/ai/agent/getFullChatContextKeys.ts
 var difference = (arrA, arrB) => {
   if (!arrA.length) return [];
@@ -284,11 +590,20 @@ var getFullChatContextKeys = async (state, dispatch, agentConfig, userInput, dia
       }
     }
   }
+  const attachmentKinds = /* @__PURE__ */ new Set();
+  for (const kind of attachmentKindsInContent(userInput)) attachmentKinds.add(kind);
+  for (const msg of msgs ?? []) {
+    for (const kind of attachmentKindsInContent(msg?.content)) attachmentKinds.add(kind);
+  }
+  const summaryMarkerId = dialogConfig?.summarizedBeforeId;
+  const attachmentKindsIncomplete = Boolean(summaryMarkerId) && !(msgs ?? []).some((msg) => msg?.id === summaryMarkerId);
   return {
     botInstructionKeys,
     currentInputKeys,
     historyKeys,
-    botKnowledgeKeys
+    botKnowledgeKeys,
+    attachmentKinds,
+    attachmentKindsIncomplete
   };
 };
 var deduplicateContextKeys = (keys) => {
@@ -320,197 +635,6 @@ var deduplicateContextKeys = (keys) => {
   };
 };
 
-// packages/ai/agent/turnToolContext.ts
-var KNOWN_MENTION_RESOURCE_TYPES = /* @__PURE__ */ new Set([
-  "tool",
-  "page",
-  "agent",
-  "space"
-]);
-function extractMentionsWithSafety(userInput) {
-  const toolNames = [];
-  const mentionedPageKeys = [];
-  const unresolvedReasons = [];
-  let complete = true;
-  if (!Array.isArray(userInput)) {
-    return { toolNames, mentionedPageKeys, complete, unresolvedReasons };
-  }
-  const traverse = (nodes) => {
-    for (const node of nodes) {
-      if (!node || typeof node !== "object") continue;
-      if (node.type === "mention") {
-        const resourceType = asTrimmedString(node.resourceType);
-        const resourceId = asTrimmedString(node.resourceId);
-        if (!resourceType || !KNOWN_MENTION_RESOURCE_TYPES.has(resourceType)) {
-          complete = false;
-          unresolvedReasons.push(
-            `unknown or missing mention resourceType: "${resourceType || "empty"}"`
-          );
-        } else if (!resourceId) {
-          complete = false;
-          unresolvedReasons.push(
-            `missing mention resourceId for type "${resourceType}"`
-          );
-        } else {
-          switch (resourceType) {
-            case "tool":
-              toolNames.push(resourceId);
-              break;
-            case "page":
-              mentionedPageKeys.push(resourceId);
-              break;
-            case "agent":
-            case "space":
-              break;
-          }
-        }
-      }
-      if (typeof node.pageKey === "string" && node.pageKey.trim()) {
-        mentionedPageKeys.push(node.pageKey.trim());
-      }
-      if (Array.isArray(node.children)) {
-        traverse(node.children);
-      }
-    }
-  };
-  try {
-    traverse(userInput);
-  } catch (error) {
-    complete = false;
-    unresolvedReasons.push(`failed to traverse userInput mentions: ${error?.message || error}`);
-  }
-  return {
-    toolNames: [...new Set(toolNames)],
-    mentionedPageKeys: [...new Set(mentionedPageKeys)],
-    complete,
-    unresolvedReasons
-  };
-}
-async function resolveTurnToolContext(input) {
-  const unresolvedReasons = [];
-  let isComplete = true;
-  const mentionResult = extractMentionsWithSafety(input.userInput);
-  if (!mentionResult.complete) {
-    isComplete = false;
-    unresolvedReasons.push(...mentionResult.unresolvedReasons);
-  }
-  const mentionedToolNames = canonicalizeToolNames(mentionResult.toolNames);
-  const agentRefs = Array.isArray(input.agentConfig?.references) ? input.agentConfig.references : [];
-  const dialogExtraRefs = Array.isArray(input.dialogConfig?.extraReferences) ? input.dialogConfig.extraReferences : [];
-  const mergedReferences = mergeReferences(agentRefs, dialogExtraRefs);
-  let refAssets = {
-    references: [],
-    referencedTools: [],
-    recommendedSkillTools: [],
-    recommendedSkillHints: [],
-    skillPromptPatches: [],
-    contentByKey: /* @__PURE__ */ new Map()
-  };
-  if (mergedReferences.length > 0) {
-    try {
-      refAssets = await resolveReferenceAssets(
-        mergedReferences,
-        input.dispatch
-      );
-      for (const ref of mergedReferences) {
-        if (ref?.dbKey && !refAssets.contentByKey.has(ref.dbKey)) {
-          isComplete = false;
-          unresolvedReasons.push(`failed to resolve reference content for "${ref.dbKey}"`);
-        }
-      }
-    } catch (error) {
-      isComplete = false;
-      unresolvedReasons.push(`failed to resolve reference assets: ${error?.message || error}`);
-    }
-  }
-  let contextToolsResult = {
-    tools: [],
-    recommendedSkillTools: [],
-    recommendedSkillHints: [],
-    skillPromptPatches: [],
-    contentByKey: /* @__PURE__ */ new Map()
-  };
-  const hasContextEngine = Boolean(
-    input.state && input.dispatch && input.state.message
-  );
-  if (hasContextEngine) {
-    try {
-      const agentConfigWithReferences = {
-        ...input.agentConfig ?? {},
-        references: refAssets.references,
-        referencedTools: refAssets.referencedTools,
-        recommendedSkillTools: refAssets.recommendedSkillTools,
-        recommendedSkillHints: refAssets.recommendedSkillHints,
-        skillPromptPatches: refAssets.skillPromptPatches
-      };
-      const keySets = await getFullChatContextKeys(
-        input.state,
-        input.dispatch,
-        agentConfigWithReferences,
-        input.userInput,
-        input.dialogConfig ?? void 0
-      );
-      for (const pk of mentionResult.mentionedPageKeys) {
-        keySets.currentInputKeys.add(pk);
-      }
-      const finalKeys = deduplicateContextKeys(keySets);
-      const allContextKeys = /* @__PURE__ */ new Set([
-        ...finalKeys.botInstructionsContext,
-        ...finalKeys.currentInputContext,
-        ...finalKeys.historyContext,
-        ...finalKeys.botKnowledgeContext
-      ]);
-      if (allContextKeys.size > 0) {
-        contextToolsResult = await resolveToolsFromKeys(
-          Array.from(allContextKeys),
-          input.dispatch,
-          refAssets.contentByKey
-        );
-      }
-    } catch (error) {
-      isComplete = false;
-      unresolvedReasons.push(`failed to resolve context keys: ${error?.message || error}`);
-    }
-  } else if (mentionResult.mentionedPageKeys.length > 0) {
-    isComplete = false;
-    unresolvedReasons.push("cannot inspect mentioned pages without store dispatch");
-  }
-  const allReferencedTools = [
-    ...refAssets.referencedTools ?? [],
-    ...contextToolsResult.tools ?? []
-  ];
-  const referencedToolNames = canonicalizeToolNames(allReferencedTools);
-  const recommendedSkillTools = [
-    ...refAssets.recommendedSkillTools ?? [],
-    ...contextToolsResult.recommendedSkillTools ?? []
-  ];
-  const recommendedSkillHints = [
-    ...refAssets.recommendedSkillHints ?? [],
-    ...contextToolsResult.recommendedSkillHints ?? []
-  ];
-  const skillPromptPatches = [
-    ...refAssets.skillPromptPatches ?? [],
-    ...contextToolsResult.skillPromptPatches ?? []
-  ];
-  return {
-    referencedToolNames,
-    mentionedToolNames,
-    complete: isComplete,
-    ...unresolvedReasons.length > 0 ? { unresolvedReasons } : {},
-    resolvedReferences: refAssets.references,
-    referencedTools: refAssets.referencedTools,
-    contextTools: contextToolsResult.tools,
-    recommendedSkillTools,
-    recommendedSkillHints,
-    skillPromptPatches,
-    referenceContentCache: refAssets.contentByKey,
-    mergedContentCache: new Map([
-      ...refAssets.contentByKey,
-      ...contextToolsResult.contentByKey
-    ])
-  };
-}
-
 // packages/ai/agent/canvasEditingContext.ts
 function buildCanvasNodeEditingContextSummary(runtimeOptions) {
   if (runtimeOptions?.editingTarget?.kind !== "canvas_node") return null;
@@ -1513,195 +1637,214 @@ var resolveImageGenerationStreamingState = (agentConfig, args) => {
   };
 };
 
-// packages/ai/agent/foregroundTurnAdmissionFetch.ts
-var FOREGROUND_TURN_KEEPALIVE_MAX_BODY_BYTES = 60 * 1024;
-function getUtf8ByteLength(value) {
-  return new TextEncoder().encode(value).byteLength;
-}
-function shouldKeepForegroundTurnAdmissionAlive(serializedBody) {
-  return serializedBody.length > 0 && getUtf8ByteLength(serializedBody) <= FOREGROUND_TURN_KEEPALIVE_MAX_BODY_BYTES;
-}
-function buildForegroundTurnAdmissionFetchInit(args) {
-  return {
-    method: "POST",
-    headers: args.headers,
-    body: args.body,
-    ...args.signal ? { signal: args.signal } : {},
-    ...shouldKeepForegroundTurnAdmissionAlive(args.body) ? { keepalive: true } : {}
-  };
-}
-
-// packages/ai/agent/foregroundExecutionClientState.ts
-var stateByDialogId = /* @__PURE__ */ new Map();
-var MAX_TRACKED_DIALOGS = 256;
-function trimmed(value) {
-  return typeof value === "string" ? value.trim() : "";
-}
-function trimCache() {
-  while (stateByDialogId.size > MAX_TRACKED_DIALOGS) {
-    const oldest = stateByDialogId.keys().next().value;
-    if (!oldest) return;
-    stateByDialogId.delete(oldest);
+// packages/ai/agent/turnToolContext.ts
+var KNOWN_MENTION_RESOURCE_TYPES = /* @__PURE__ */ new Set([
+  "tool",
+  "page",
+  "agent",
+  "space"
+]);
+function extractMentionsWithSafety(userInput) {
+  const toolNames = [];
+  const mentionedPageKeys = [];
+  const unresolvedReasons = [];
+  let complete = true;
+  if (!Array.isArray(userInput)) {
+    return { toolNames, mentionedPageKeys, complete, unresolvedReasons };
   }
-}
-function setForegroundExecutionClientState(args) {
-  const dialogId = trimmed(args.dialogId);
-  const executionId = trimmed(args.executionId);
-  if (!dialogId || !executionId) return;
-  stateByDialogId.delete(dialogId);
-  stateByDialogId.set(dialogId, { dialogId, executionId, status: "running" });
-  trimCache();
-}
-function clearForegroundExecutionClientState(dialogId, expectedExecutionId) {
-  const normalizedDialogId = trimmed(dialogId);
-  if (!normalizedDialogId) return;
-  if (expectedExecutionId) {
-    const current = stateByDialogId.get(normalizedDialogId);
-    if (current && current.executionId !== expectedExecutionId) return;
-  }
-  stateByDialogId.delete(normalizedDialogId);
-}
-function observeForegroundExecutionPayload(payload) {
-  if (!payload || typeof payload !== "object") return;
-  const event = payload;
-  const type = trimmed(event.type);
-  const dialogId = trimmed(event.dialogId);
-  const executionId = trimmed(event.executionId);
-  if ((type === "dialog" || type === "foreground_turn_status") && event.status === "running" && dialogId && executionId) {
-    setForegroundExecutionClientState({ dialogId, executionId });
-    return;
-  }
-  if (type === "foreground_turn_terminal" || type === "done" || type === "cancelled" || type === "error" || type === "failed") {
-    if (dialogId && executionId) {
-      clearForegroundExecutionClientState(dialogId, executionId);
+  const traverse = (nodes) => {
+    for (const node of nodes) {
+      if (!node || typeof node !== "object") continue;
+      if (node.type === "mention") {
+        const resourceType = asTrimmedString(node.resourceType);
+        const resourceId = asTrimmedString(node.resourceId);
+        if (!resourceType || !KNOWN_MENTION_RESOURCE_TYPES.has(resourceType)) {
+          complete = false;
+          unresolvedReasons.push(
+            `unknown or missing mention resourceType: "${resourceType || "empty"}"`
+          );
+        } else if (!resourceId) {
+          complete = false;
+          unresolvedReasons.push(
+            `missing mention resourceId for type "${resourceType}"`
+          );
+        } else {
+          switch (resourceType) {
+            case "tool":
+              toolNames.push(resourceId);
+              break;
+            case "page":
+              mentionedPageKeys.push(resourceId);
+              break;
+            case "agent":
+            case "space":
+              break;
+          }
+        }
+      }
+      if (typeof node.pageKey === "string" && node.pageKey.trim()) {
+        mentionedPageKeys.push(node.pageKey.trim());
+      }
+      if (Array.isArray(node.children)) {
+        traverse(node.children);
+      }
     }
+  };
+  try {
+    traverse(userInput);
+  } catch (error) {
+    complete = false;
+    unresolvedReasons.push(`failed to traverse userInput mentions: ${error?.message || error}`);
   }
+  return {
+    toolNames: [...new Set(toolNames)],
+    mentionedPageKeys: [...new Set(mentionedPageKeys)],
+    complete,
+    unresolvedReasons
+  };
 }
-
-// packages/ai/agent/streamTurnStreamConsumer.ts
-async function readAgentRunStreamChunk(reader, signal, isAborted) {
-  if (isAborted() || signal?.aborted) {
-    void reader.cancel().catch(() => {
-    });
-    throw new DOMException("The operation was aborted.", "AbortError");
-  }
-  if (!signal) {
-    return reader.read();
+async function resolveTurnToolContext(input) {
+  const unresolvedReasons = [];
+  let isComplete = true;
+  const mentionResult = extractMentionsWithSafety(input.userInput);
+  if (!mentionResult.complete) {
+    isComplete = false;
+    unresolvedReasons.push(...mentionResult.unresolvedReasons);
   }
-  let settled = false;
-  return new Promise((resolve, reject) => {
-    const finish = (cb) => {
-      if (settled) return;
-      settled = true;
-      signal.removeEventListener("abort", onAbort);
-      cb();
-    };
-    const onAbort = () => {
-      void reader.cancel().catch(() => {
-      });
-      finish(
-        () => reject(new DOMException("The operation was aborted.", "AbortError"))
-      );
-    };
-    signal.addEventListener("abort", onAbort);
-    reader.read().then(
-      (result) => finish(() => resolve(result)),
-      (err) => finish(() => reject(err))
-    );
-  });
-}
-async function consumeAgentRunStream(handlers) {
-  const {
-    reader,
-    decoder,
-    parseChunk,
-    onPayload,
-    isDoneEvent,
-    isAborted,
-    signal,
-    onAbort
-  } = handlers;
-  let sawDone = false;
-  let observedDialogId = "";
-  let observedExecutionId = "";
-  const clearObservedExecution = () => {
-    if (!observedDialogId || !observedExecutionId) return;
-    clearForegroundExecutionClientState(
-      observedDialogId,
-      observedExecutionId
-    );
+  const mentionedToolNames = canonicalizeToolNames(mentionResult.toolNames);
+  const agentRefs = Array.isArray(input.agentConfig?.references) ? input.agentConfig.references : [];
+  const dialogExtraRefs = Array.isArray(input.dialogConfig?.extraReferences) ? input.dialogConfig.extraReferences : [];
+  const mergedReferences = mergeReferences(agentRefs, dialogExtraRefs);
+  let refAssets = {
+    references: [],
+    referencedTools: [],
+    recommendedSkillTools: [],
+    recommendedSkillHints: [],
+    skillPromptPatches: [],
+    contentByKey: /* @__PURE__ */ new Map()
   };
-  try {
-    while (true) {
-      let done;
-      let value;
-      try {
-        ({ done, value } = await readAgentRunStreamChunk(
-          reader,
-          signal,
-          isAborted
-        ));
-      } catch (error) {
-        if (isAbortError(error) || isAborted() || signal?.aborted) {
-          clearObservedExecution();
-          await onAbort();
-          return { outcome: "aborted" };
-        }
-        throw error;
-      }
-      if (isAborted() || signal?.aborted) {
-        clearObservedExecution();
-        await onAbort();
-        return { outcome: "aborted" };
-      }
-      if (done) {
-        clearObservedExecution();
-        return { outcome: "streamEnded", sawDone };
-      }
-      const payloads = parseChunk(
-        decoder.decode(value, { stream: true })
+  if (mergedReferences.length > 0) {
+    try {
+      refAssets = await resolveReferenceAssets(
+        mergedReferences,
+        input.dispatch
       );
-      for (const payload of payloads) {
-        if (isAborted() || signal?.aborted) {
-          clearObservedExecution();
-          await onAbort();
-          return { outcome: "aborted" };
-        }
-        if (payload && typeof payload === "object") {
-          if (payload.type === "dialog" && typeof payload.dialogId === "string") {
-            observedDialogId = payload.dialogId.trim();
-            observedExecutionId = typeof payload.executionId === "string" ? payload.executionId.trim() : "";
-          }
-          observeForegroundExecutionPayload(payload);
-        }
-        const directive = await onPayload(payload);
-        if (directive?.reject !== void 0) {
-          clearObservedExecution();
-          return { outcome: "rejected", message: directive.reject };
-        }
-        if (directive?.abort) {
-          clearObservedExecution();
-          await onAbort();
-          return { outcome: "aborted" };
-        }
-        if (isDoneEvent(payload)) {
-          sawDone = true;
+      for (const ref of mergedReferences) {
+        if (ref?.dbKey && !refAssets.contentByKey.has(ref.dbKey)) {
+          isComplete = false;
+          unresolvedReasons.push(`failed to resolve reference content for "${ref.dbKey}"`);
         }
       }
+    } catch (error) {
+      isComplete = false;
+      unresolvedReasons.push(`failed to resolve reference assets: ${error?.message || error}`);
     }
-  } catch (error) {
-    clearObservedExecution();
-    if (isAbortError(error) || isAborted() || signal?.aborted) {
-      await onAbort();
-      return { outcome: "aborted" };
+  }
+  let attachmentKinds = attachmentKindsInContent(input.userInput);
+  let attachmentKindsIncomplete = false;
+  let contextToolsResult = {
+    tools: [],
+    recommendedSkillTools: [],
+    recommendedSkillHints: [],
+    skillPromptPatches: [],
+    contentByKey: /* @__PURE__ */ new Map()
+  };
+  const hasContextEngine = Boolean(
+    input.state && input.dispatch && input.state.message
+  );
+  if (hasContextEngine) {
+    try {
+      const agentConfigWithReferences = {
+        ...input.agentConfig ?? {},
+        references: refAssets.references,
+        referencedTools: refAssets.referencedTools,
+        recommendedSkillTools: refAssets.recommendedSkillTools,
+        recommendedSkillHints: refAssets.recommendedSkillHints,
+        skillPromptPatches: refAssets.skillPromptPatches
+      };
+      const keySets = await getFullChatContextKeys(
+        input.state,
+        input.dispatch,
+        agentConfigWithReferences,
+        input.userInput,
+        input.dialogConfig ?? void 0
+      );
+      attachmentKinds = [...keySets.attachmentKinds ?? []];
+      attachmentKindsIncomplete = keySets.attachmentKindsIncomplete === true;
+      for (const pk of mentionResult.mentionedPageKeys) {
+        keySets.currentInputKeys.add(pk);
+      }
+      const finalKeys = deduplicateContextKeys(keySets);
+      const allContextKeys = /* @__PURE__ */ new Set([
+        ...finalKeys.botInstructionsContext,
+        ...finalKeys.currentInputContext,
+        ...finalKeys.historyContext,
+        ...finalKeys.botKnowledgeContext
+      ]);
+      if (allContextKeys.size > 0) {
+        contextToolsResult = await resolveToolsFromKeys(
+          Array.from(allContextKeys),
+          input.dispatch,
+          refAssets.contentByKey
+        );
+      }
+    } catch (error) {
+      isComplete = false;
+      unresolvedReasons.push(`failed to resolve context keys: ${error?.message || error}`);
     }
-    throw error;
+  } else if (mentionResult.mentionedPageKeys.length > 0) {
+    isComplete = false;
+    unresolvedReasons.push("cannot inspect mentioned pages without store dispatch");
   }
+  if (attachmentKindsIncomplete) {
+    isComplete = false;
+    unresolvedReasons.push(
+      "attachment kinds before summarization are not in memory (pending discovery)"
+    );
+  }
+  const attachmentToolNames = toolsForAttachmentKinds(attachmentKinds);
+  const allReferencedTools = [
+    ...refAssets.referencedTools ?? [],
+    ...contextToolsResult.tools ?? [],
+    ...attachmentToolNames
+  ];
+  const referencedToolNames = canonicalizeToolNames(allReferencedTools);
+  const recommendedSkillTools = [
+    ...refAssets.recommendedSkillTools ?? [],
+    ...contextToolsResult.recommendedSkillTools ?? []
+  ];
+  const recommendedSkillHints = [
+    ...refAssets.recommendedSkillHints ?? [],
+    ...contextToolsResult.recommendedSkillHints ?? []
+  ];
+  const skillPromptPatches = [
+    ...refAssets.skillPromptPatches ?? [],
+    ...contextToolsResult.skillPromptPatches ?? []
+  ];
+  return {
+    referencedToolNames,
+    attachmentToolNames,
+    mentionedToolNames,
+    complete: isComplete,
+    ...unresolvedReasons.length > 0 ? { unresolvedReasons } : {},
+    resolvedReferences: refAssets.references,
+    referencedTools: refAssets.referencedTools,
+    contextTools: contextToolsResult.tools,
+    recommendedSkillTools,
+    recommendedSkillHints,
+    skillPromptPatches,
+    referenceContentCache: refAssets.contentByKey,
+    mergedContentCache: new Map([
+      ...refAssets.contentByKey,
+      ...contextToolsResult.contentByKey
+    ])
+  };
 }
 
 export {
+  buildForegroundTurnAdmissionFetchInit,
+  consumeAgentRunStream,
   projectDesktopToolUiContent,
-  resolveTurnToolContext,
   compressOldToolResults,
   trimMessagesWithSummary,
   validateAccessAndBalance,
@@ -1711,6 +1854,5 @@ export {
   mergeAgentToolsWithRuntime,
   applyImageConfigRuntimeOverride,
   resolveImageGenerationStreamingState,
-  buildForegroundTurnAdmissionFetchInit,
-  consumeAgentRunStream
+  resolveTurnToolContext
 };