@yeaft/webchat-agent 1.0.351 → 1.0.352

package/yeaft/tools/list-tasks.js

@@ -21,6 +21,7 @@ export default defineTool({
   },
   isConcurrencySafe: () => true,
   isReadOnly: () => true,
+  cacheWithinQuery: false,
   async execute(input = {}, ctx = {}) {
     if (!ctx.taskManager) return JSON.stringify({ error: 'task manager unavailable' });
     const sessionId = input.sessionId || ctx.sessionId || null;

package/yeaft/tools/read-task-log.js

@@ -23,6 +23,7 @@ export default defineTool({
   },
   isConcurrencySafe: () => true,
   isReadOnly: () => true,
+  cacheWithinQuery: false,
   async execute(input = {}, ctx = {}) {
     if (!ctx.taskManager) return JSON.stringify({ error: 'task manager unavailable' });
     const taskId = input.taskId;

package/yeaft/tools/route-forward.js

@@ -104,6 +104,10 @@ Returns JSON: { ok, dispatched?, error?, detail? }.`,
   },
   isConcurrencySafe: () => false,
   isReadOnly: () => false,
+  // A handoff can start another VP on the shared workDir while this query
+  // still has queued tool calls. Conservatively disable reuse even when the
+  // dispatch is rejected; the cost is one fresh read, not stale workspace data.
+  mayMutateWorkspaceAfterReturn: () => true,
   async execute(input, ctx = {}) {
     const { to, text, reason } = input || {};
     if (!to || typeof to !== 'string') {

package/yeaft/tools/send-message.js

@@ -62,6 +62,9 @@ SpawnAgent -> (PromptAgent <-> WaitAgent)+ -> CloseAgent -> 最终回复给用
   },
   isConcurrencySafe: () => false,
   isReadOnly: () => false,
+  // Queueing a prompt can resume an existing writable child after this
+  // orchestration call returns, so parent filesystem snapshots are stale-risk.
+  mayMutateWorkspaceAfterReturn: () => true,
   async execute(input, ctx) {
     // NB: next_steps is the FIRST envelope field — the registry's
     // model-context tail truncation would eat it if it lived at the end.

package/yeaft/tools/types.js

@@ -68,6 +68,8 @@
  * @property {(input: object, ctx?: ToolContext) => Promise<string>} execute — execution function
  * @property {(input?: object) => boolean} [isConcurrencySafe] — can run in parallel?
  * @property {(input?: object) => boolean} [isReadOnly] — read-only operation?
+ * @property {boolean | ((input?: object) => boolean)} [cacheWithinQuery] — explicitly safe to reuse for identical calls in one query
+ * @property {boolean | ((input?: object) => boolean)} [mayMutateWorkspaceAfterReturn] — may keep changing the workspace after execute() resolves; disables same-query read reuse
  * @property {(input?: object) => boolean} [isDestructive] — destructive operation?
  * @property {'json-error-envelope' | null} [errorOutput] — explicit returned-output error contract; null means only thrown errors fail
  * @property {'external' | 'run'} [sideEffectScope] — whether mutations escape the current Run collector
@@ -83,6 +85,8 @@
  *   execute: (input: object, ctx?: ToolContext) => Promise<string>,
  *   isConcurrencySafe?: (input?: object) => boolean,
  *   isReadOnly?: (input?: object) => boolean,
+ *   cacheWithinQuery?: boolean | ((input?: object) => boolean),
+ *   mayMutateWorkspaceAfterReturn?: boolean | ((input?: object) => boolean),
  *   isDestructive?: (input?: object) => boolean,
  *   errorOutput?: 'json-error-envelope' | null,
  *   sideEffectScope?: 'external' | 'run',
@@ -98,6 +102,8 @@ export function defineTool({
   execute,
   isConcurrencySafe = () => false,
   isReadOnly = () => false,
+  cacheWithinQuery = false,
+  mayMutateWorkspaceAfterReturn = false,
   isDestructive = () => false,
   errorOutput = 'json-error-envelope',
   sideEffectScope = 'external',
@@ -113,6 +119,8 @@ export function defineTool({
     execute,
     isConcurrencySafe,
     isReadOnly,
+    cacheWithinQuery,
+    mayMutateWorkspaceAfterReturn,
     isDestructive,
     errorOutput,
     sideEffectScope,

package/yeaft/tools/wait-agent.js

@@ -246,6 +246,7 @@ notification 获取完成事件。`
   timeoutMs: 305000,
   isConcurrencySafe: () => true,
   isReadOnly: () => true,
+  cacheWithinQuery: false,
   async execute(input, ctx) {
     const { agent_id, timeout_ms = 5000 } = input;
     if (!agent_id) {

package/yeaft/utf8.js

@@ -0,0 +1,44 @@
+/**
+ * utf8.js — Small UTF-8 byte-budget helpers shared by Agent internals.
+ *
+ * JavaScript strings are UTF-16. Convert malformed lone surrogates before
+ * walking code points so a byte-limited preview is always well-formed Unicode.
+ */
+
+export function normalizeUtf8ByteBudget(value, fallback = 0) {
+  const parsed = Number(value);
+  return Number.isFinite(parsed)
+    ? Math.max(0, Math.floor(parsed))
+    : Math.max(0, Math.floor(Number(fallback) || 0));
+}
+
+export function toWellFormedText(value) {
+  return String(value ?? '').toWellFormed();
+}
+
+/**
+ * Return the longest well-formed UTF-8 prefix within maxBytes.
+ *
+ * This makes one code-point pass and one final slice. It deliberately does
+ * not repeatedly rescan successively shorter UTF-16 slices with
+ * Buffer.byteLength(), which becomes quadratic for oversized payloads.
+ */
+export function utf8PrefixWithinBytes(value, maxBytes) {
+  const text = toWellFormedText(value);
+  const limit = normalizeUtf8ByteBudget(maxBytes);
+  let end = 0;
+  let bytes = 0;
+
+  while (end < text.length) {
+    const codePoint = text.codePointAt(end);
+    const width = codePoint > 0xFFFF ? 2 : 1;
+    const byteLength = codePoint <= 0x7F
+      ? 1
+      : (codePoint <= 0x7FF ? 2 : (codePoint <= 0xFFFF ? 3 : 4));
+    if (bytes + byteLength > limit) break;
+    bytes += byteLength;
+    end += width;
+  }
+
+  return { text: text.slice(0, end), bytes };
+}

package/yeaft/web-bridge.js

@@ -192,6 +192,11 @@ export async function refreshLiveSessionConfig(options = {}) {
 
   const configRoot = liveConfigRoot();
   const freshConfig = loadConfig({ dir: configRoot });
+  // All bridge producers reference ctx.CONFIG. Keep it synchronized even
+  // when no live Session is loaded and refresh returns early below.
+  if (ctx.CONFIG && typeof ctx.CONFIG === 'object') {
+    ctx.CONFIG.telemetry = freshConfig.telemetry;
+  }
   const previousDefaultModel = options.previousDefaultModel
     || session?.config?.primaryModel
     || session?.config?.model
@@ -234,6 +239,7 @@ export async function refreshLiveSessionConfig(options = {}) {
   for (const key of Object.keys(currentConfig)) delete currentConfig[key];
   Object.assign(currentConfig, nextConfig);
   liveSession.engine?.refreshConfig?.(currentConfig);
+  liveSession.trace?.refreshConfig?.(currentConfig.telemetry || {});
   for (const { key, engine, config } of vpConfigSnapshots) {
     engine.refreshConfig?.(config);
     vpEngineConfigKeys.set(key, engineConfigKey(config));

package/yeaft/work-center/runner.js

@@ -823,6 +823,7 @@ export class WorkItemRunner {
     this.trace = options.trace || createTrace({
       enabled: options.debug === true && Boolean(options.yeaftDir),
       dirPath: options.yeaftDir || null,
+      textMaxBytes: options.config?.telemetry?.traceTextMaxBytes,
     });
     this.actionWorktreeRoot = options.actionWorktreeRoot || null;
     this.store = options.store;