@ai-setting/roy-agent-core 1.7.59 → 1.7.62

package/dist/shared/@ai-setting/{roy-agent-core-e1w17tht.js → roy-agent-core-9qgrc9dy.js}

@@ -7,16 +7,168 @@ import {
   embedResultFilter,
   init_decorator,
   init_trace_filters
-} from "./roy-agent-core-8p63s836.js";
+} from "./roy-agent-core-386wa4wy.js";
 import {
   createLogger,
   init_logger
-} from "./roy-agent-core-rt115qfc.js";
+} from "./roy-agent-core-6awgfh3x.js";
 import {
   __legacyDecorateClassTS,
   __require
 } from "./roy-agent-core-fs0mn2jk.js";
 
+// src/env/llm/tool-args-parser.ts
+init_logger();
+var logger = createLogger("llm:tool-args-parser");
+var ARG_KEY_RE = /<arg_key>([\s\S]*?)<\/arg_key>\s*<arg_value>([\s\S]*?)<\/arg_value>/g;
+function salvageTextualToolArgs(raw) {
+  if (!raw.includes("<arg_key>"))
+    return;
+  const out = {};
+  let matched = false;
+  ARG_KEY_RE.lastIndex = 0;
+  let m;
+  while ((m = ARG_KEY_RE.exec(raw)) !== null) {
+    const key = m[1].trim();
+    if (!key)
+      continue;
+    const value = m[2];
+    try {
+      out[key] = JSON.parse(value);
+    } catch {
+      out[key] = value;
+    }
+    matched = true;
+  }
+  return matched ? out : undefined;
+}
+function stripTextualToolArgsMarkers(raw) {
+  return raw.replace(/<\/?arg_key>/g, "").replace(/<\/?arg_value>/g, "").replace(/<\/?tool_call>/g, "");
+}
+function parseToolArgsStrict(args) {
+  if (args && typeof args === "object" && !Array.isArray(args)) {
+    return { ok: true, args };
+  }
+  if (typeof args !== "string") {
+    return {
+      ok: false,
+      args: {},
+      error: `tool arguments must be a JSON object, got ${args === null ? "null" : typeof args}`
+    };
+  }
+  const raw = args.trim();
+  if (raw.length === 0) {
+    return { ok: true, args: {} };
+  }
+  const direct = tryParseObject(raw);
+  if (direct.ok) {
+    if (raw.includes("<arg_key>") || raw.includes("<arg_value>") || raw.includes("<tool_call>")) {
+      logger.warn("[parseToolArgsStrict] arguments 里出现上游文本工具调用标记，已清洗值中的 marker");
+      return { ok: true, args: sanitizeArgValues(direct.args), salvaged: true };
+    }
+    return { ok: true, args: direct.args };
+  }
+  if (raw.includes("<arg_key>") || raw.includes("<arg_value>")) {
+    const stripped = stripTextualToolArgsMarkers(raw);
+    const afterStrip = tryParseObject(stripped);
+    if (afterStrip.ok) {
+      logger.warn("[parseToolArgsStrict] 上游把文本工具调用标记混进了 arguments，已剥离 marker 后恢复");
+      return { ok: true, args: afterStrip.args, salvaged: true };
+    }
+    const salvaged = salvageTextualToolArgs(raw);
+    if (salvaged) {
+      logger.warn("[parseToolArgsStrict] 上游输出的是文本工具调用格式，已按 <arg_key>/<arg_value> 重建参数", { keys: Object.keys(salvaged).join(",") });
+      return { ok: true, args: salvaged, salvaged: true };
+    }
+  }
+  const nested = tryParseObject(raw);
+  if (!nested.ok && raw.length > 1) {
+    const rec = safeParseToolArgs(raw);
+    if (Object.keys(rec).length > 0) {
+      return { ok: true, args: rec, salvaged: true };
+    }
+  }
+  return {
+    ok: false,
+    args: {},
+    error: "tool arguments 不是合法 JSON（上游模型输出可能已损坏）。请重新调用该工具，确保 arguments 是合法 JSON 对象。" + ` 原始片段：${raw.slice(0, 200)}`
+  };
+}
+function sanitizeArgValues(args) {
+  const clean = (v) => {
+    if (typeof v === "string")
+      return stripTextualToolArgsMarkers(v);
+    if (Array.isArray(v))
+      return v.map(clean);
+    if (v && typeof v === "object") {
+      const out = {};
+      for (const [k, val] of Object.entries(v)) {
+        out[k] = clean(val);
+      }
+      return out;
+    }
+    return v;
+  };
+  return clean(args);
+}
+function tryParseObject(raw) {
+  try {
+    const parsed = JSON.parse(raw);
+    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+      return { ok: true, args: parsed };
+    }
+    if (typeof parsed === "string") {
+      const twice = JSON.parse(parsed);
+      if (twice && typeof twice === "object" && !Array.isArray(twice)) {
+        return { ok: true, args: twice };
+      }
+    }
+    return { ok: false };
+  } catch {
+    return { ok: false };
+  }
+}
+var MAX_SAFE_DEPTH = 5;
+function safeParseToolArgs(args, depth = 0) {
+  if (depth >= MAX_SAFE_DEPTH) {
+    logger.warn(`[safeParseToolArgs] Max recursion depth (${MAX_SAFE_DEPTH}) exceeded at depth ${depth}. ` + "Input may be malicious or abnormally deeply nested. Returning empty object.", { depth, argsType: typeof args });
+    return {};
+  }
+  if (typeof args === "object" && args !== null && !Array.isArray(args)) {
+    return args;
+  }
+  if (Array.isArray(args)) {
+    logger.debug(`[safeParseToolArgs] Input is an array. Tool arguments should be objects. Returning empty object.`, { depth, arrayLength: args.length });
+    return {};
+  }
+  if (typeof args === "string") {
+    try {
+      const parsed = JSON.parse(args);
+      if (typeof parsed === "string") {
+        logger.debug(`[safeParseToolArgs] Detected double/multi-stringified JSON at depth ${depth}. ` + "LLM may be double-stringifying tool arguments. Parsing recursively.", { depth, parsedLength: parsed.length });
+        return safeParseToolArgs(parsed, depth + 1);
+      }
+      if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) {
+        return parsed;
+      }
+      if (Array.isArray(parsed)) {
+        logger.debug(`[safeParseToolArgs] Parsed result is an array at depth ${depth}. ` + "Tool arguments should be objects, not arrays. Returning empty object.", { depth, parsedLength: parsed.length });
+        return {};
+      }
+      return { value: parsed };
+    } catch (e) {
+      logger.warn(`[safeParseToolArgs] JSON.parse failed at depth ${depth}`, {
+        parse_failed: true,
+        input_length: args.length,
+        depth,
+        error: e.message
+      });
+      return {};
+    }
+  }
+  return {};
+}
+
 // src/env/llm/opencode-session.ts
 var OPENCODE_SESSION_ID_CACHE_MAX = 1000;
 var opencodeSessionIdCache = new Map;
@@ -200,7 +352,7 @@ function createReasoningDefenseHook(target) {
 }
 
 // src/env/llm/adapter-pi-ai.ts
-var logger = createLogger("llm:adapter-pi-ai");
+var logger2 = createLogger("llm:adapter-pi-ai");
 var KNOWN_PROVIDER_APIS = {
   anthropic: {
     api: "anthropic-messages",
@@ -311,7 +463,7 @@ function resolveApiProtocol(provider, baseURL, explicitProtocol) {
   if (baseURL?.includes("/responses"))
     return "openai-responses";
   if (baseURL?.includes("anthropic")) {
-    logger.warn(`[adapter-pi-ai] provider "${provider}" 的协议靠 baseURL 含 "anthropic" 推断为 anthropic-messages；` + `建议在 KNOWN_PROVIDER_APIS 或调用处显式声明 apiProtocol（Task #4383 P1）`, { provider, inferred_api_protocol: "anthropic-messages", base_url: baseURL });
+    logger2.warn(`[adapter-pi-ai] provider "${provider}" 的协议靠 baseURL 含 "anthropic" 推断为 anthropic-messages；` + `建议在 KNOWN_PROVIDER_APIS 或调用处显式声明 apiProtocol（Task #4383 P1）`, { provider, inferred_api_protocol: "anthropic-messages", base_url: baseURL });
     return "anthropic-messages";
   }
   return KNOWN_PROVIDER_APIS[provider]?.api || "openai-completions";
@@ -334,7 +486,7 @@ function resolveModelReasoning(provider, modelId, capabilities, apiProtocol) {
     const key = `${provider}:${apiProtocol ?? "<unresolved>"}`;
     if (!warnedReasoningRefusals.has(key)) {
       warnedReasoningRefusals.add(key);
-      logger.warn(`[adapter-pi-ai] provider "${provider}" (${apiProtocol ?? "unresolved"}) 的 capabilities.reasoning=true 被忽略：` + `该协议无法通过 compat pin 保持请求体字节一致，打开会破坏 prompt cache 前缀（Task #4403）`, { provider, model_id: modelId, api_protocol: apiProtocol });
+      logger2.warn(`[adapter-pi-ai] provider "${provider}" (${apiProtocol ?? "unresolved"}) 的 capabilities.reasoning=true 被忽略：` + `该协议无法通过 compat pin 保持请求体字节一致，打开会破坏 prompt cache 前缀（Task #4403）`, { provider, model_id: modelId, api_protocol: apiProtocol });
     }
     return false;
   }
@@ -423,7 +575,7 @@ function safeJson(s) {
   try {
     return JSON.parse(s);
   } catch (e) {
-    logger.warn(`[safeJson] JSON.parse failed`, {
+    logger2.warn(`[safeJson] JSON.parse failed`, {
       parse_failed: true,
       input_length: s.length,
       error: e.message
@@ -635,158 +787,6 @@ import { createGoogleGenerativeAI } from "@ai-sdk/google";
 import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
 init_logger();
 
-// src/env/llm/tool-args-parser.ts
-init_logger();
-var logger2 = createLogger("llm:tool-args-parser");
-var ARG_KEY_RE = /<arg_key>([\s\S]*?)<\/arg_key>\s*<arg_value>([\s\S]*?)<\/arg_value>/g;
-function salvageTextualToolArgs(raw) {
-  if (!raw.includes("<arg_key>"))
-    return;
-  const out = {};
-  let matched = false;
-  ARG_KEY_RE.lastIndex = 0;
-  let m;
-  while ((m = ARG_KEY_RE.exec(raw)) !== null) {
-    const key = m[1].trim();
-    if (!key)
-      continue;
-    const value = m[2];
-    try {
-      out[key] = JSON.parse(value);
-    } catch {
-      out[key] = value;
-    }
-    matched = true;
-  }
-  return matched ? out : undefined;
-}
-function stripTextualToolArgsMarkers(raw) {
-  return raw.replace(/<\/?arg_key>/g, "").replace(/<\/?arg_value>/g, "").replace(/<\/?tool_call>/g, "");
-}
-function parseToolArgsStrict(args) {
-  if (args && typeof args === "object" && !Array.isArray(args)) {
-    return { ok: true, args };
-  }
-  if (typeof args !== "string") {
-    return {
-      ok: false,
-      args: {},
-      error: `tool arguments must be a JSON object, got ${args === null ? "null" : typeof args}`
-    };
-  }
-  const raw = args.trim();
-  if (raw.length === 0) {
-    return { ok: true, args: {} };
-  }
-  const direct = tryParseObject(raw);
-  if (direct.ok) {
-    if (raw.includes("<arg_key>") || raw.includes("<arg_value>") || raw.includes("<tool_call>")) {
-      logger2.warn("[parseToolArgsStrict] arguments 里出现上游文本工具调用标记，已清洗值中的 marker");
-      return { ok: true, args: sanitizeArgValues(direct.args), salvaged: true };
-    }
-    return { ok: true, args: direct.args };
-  }
-  if (raw.includes("<arg_key>") || raw.includes("<arg_value>")) {
-    const stripped = stripTextualToolArgsMarkers(raw);
-    const afterStrip = tryParseObject(stripped);
-    if (afterStrip.ok) {
-      logger2.warn("[parseToolArgsStrict] 上游把文本工具调用标记混进了 arguments，已剥离 marker 后恢复");
-      return { ok: true, args: afterStrip.args, salvaged: true };
-    }
-    const salvaged = salvageTextualToolArgs(raw);
-    if (salvaged) {
-      logger2.warn("[parseToolArgsStrict] 上游输出的是文本工具调用格式，已按 <arg_key>/<arg_value> 重建参数", { keys: Object.keys(salvaged).join(",") });
-      return { ok: true, args: salvaged, salvaged: true };
-    }
-  }
-  const nested = tryParseObject(raw);
-  if (!nested.ok && raw.length > 1) {
-    const rec = safeParseToolArgs(raw);
-    if (Object.keys(rec).length > 0) {
-      return { ok: true, args: rec, salvaged: true };
-    }
-  }
-  return {
-    ok: false,
-    args: {},
-    error: "tool arguments 不是合法 JSON（上游模型输出可能已损坏）。请重新调用该工具，确保 arguments 是合法 JSON 对象。" + ` 原始片段：${raw.slice(0, 200)}`
-  };
-}
-function sanitizeArgValues(args) {
-  const clean = (v) => {
-    if (typeof v === "string")
-      return stripTextualToolArgsMarkers(v);
-    if (Array.isArray(v))
-      return v.map(clean);
-    if (v && typeof v === "object") {
-      const out = {};
-      for (const [k, val] of Object.entries(v)) {
-        out[k] = clean(val);
-      }
-      return out;
-    }
-    return v;
-  };
-  return clean(args);
-}
-function tryParseObject(raw) {
-  try {
-    const parsed = JSON.parse(raw);
-    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
-      return { ok: true, args: parsed };
-    }
-    if (typeof parsed === "string") {
-      const twice = JSON.parse(parsed);
-      if (twice && typeof twice === "object" && !Array.isArray(twice)) {
-        return { ok: true, args: twice };
-      }
-    }
-    return { ok: false };
-  } catch {
-    return { ok: false };
-  }
-}
-var MAX_SAFE_DEPTH = 5;
-function safeParseToolArgs(args, depth = 0) {
-  if (depth >= MAX_SAFE_DEPTH) {
-    logger2.warn(`[safeParseToolArgs] Max recursion depth (${MAX_SAFE_DEPTH}) exceeded at depth ${depth}. ` + "Input may be malicious or abnormally deeply nested. Returning empty object.", { depth, argsType: typeof args });
-    return {};
-  }
-  if (typeof args === "object" && args !== null && !Array.isArray(args)) {
-    return args;
-  }
-  if (Array.isArray(args)) {
-    logger2.debug(`[safeParseToolArgs] Input is an array. Tool arguments should be objects. Returning empty object.`, { depth, arrayLength: args.length });
-    return {};
-  }
-  if (typeof args === "string") {
-    try {
-      const parsed = JSON.parse(args);
-      if (typeof parsed === "string") {
-        logger2.debug(`[safeParseToolArgs] Detected double/multi-stringified JSON at depth ${depth}. ` + "LLM may be double-stringifying tool arguments. Parsing recursively.", { depth, parsedLength: parsed.length });
-        return safeParseToolArgs(parsed, depth + 1);
-      }
-      if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) {
-        return parsed;
-      }
-      if (Array.isArray(parsed)) {
-        logger2.debug(`[safeParseToolArgs] Parsed result is an array at depth ${depth}. ` + "Tool arguments should be objects, not arrays. Returning empty object.", { depth, parsedLength: parsed.length });
-        return {};
-      }
-      return { value: parsed };
-    } catch (e) {
-      logger2.warn(`[safeParseToolArgs] JSON.parse failed at depth ${depth}`, {
-        parse_failed: true,
-        input_length: args.length,
-        depth,
-        error: e.message
-      });
-      return {};
-    }
-  }
-  return {};
-}
-
 // src/env/llm/llm-cache.ts
 function isOpenAICompatibleProvider(providerName) {
   return providerName === "openai-compatible" || providerName === "openai" || providerName.startsWith("minimax") || providerName === "deepseek" || providerName.startsWith("deepseek") || providerName === "glm" || providerName.startsWith("glm");

package/dist/shared/@ai-setting/{roy-agent-core-2ctyjy62.js → roy-agent-core-a08dpf71.js}

@@ -1,7 +1,7 @@
 import {
   TracedAs,
   init_decorator
-} from "./roy-agent-core-8p63s836.js";
+} from "./roy-agent-core-386wa4wy.js";
 import {
   __legacyDecorateClassTS,
   __require
@@ -32,6 +32,21 @@ function createCompatibleDatabase(path) {
   }
   return db;
 }
+var SCHEMA_SQL = `
+CREATE TABLE IF NOT EXISTS event_store (
+  event_id   TEXT PRIMARY KEY,
+  es_type    TEXT NOT NULL,
+  sender_id  TEXT NOT NULL,
+  text       TEXT,
+  metadata   TEXT NOT NULL,
+  raw_event  TEXT,
+  created_at INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_es_sender_time
+  ON event_store (es_type, sender_id, created_at DESC);
+`;
+
 class EventStoreImpl {
   db;
   insertStmt;
@@ -156,4 +171,4 @@ function resetSharedEventStore() {
   sharedEventStore = null;
 }
 
-export { EventStoreImpl, setSharedEventStore, getSharedEventStore, resetSharedEventStore };
+export { SCHEMA_SQL, EventStoreImpl, setSharedEventStore, getSharedEventStore, resetSharedEventStore };

package/dist/shared/@ai-setting/{roy-agent-core-e250355z.js → roy-agent-core-a6cz4d23.js}

@@ -1,8 +1,8 @@
 import {
   TagRepository
-} from "./roy-agent-core-rcgvmtms.js";
-import"./roy-agent-core-8p63s836.js";
-import"./roy-agent-core-rt115qfc.js";
+} from "./roy-agent-core-gc6wcd7z.js";
+import"./roy-agent-core-386wa4wy.js";
+import"./roy-agent-core-6awgfh3x.js";
 import"./roy-agent-core-jnszp0jq.js";
 import"./roy-agent-core-fs0mn2jk.js";
 export {

package/dist/shared/@ai-setting/{roy-agent-core-tze5596n.js → roy-agent-core-anb53t3v.js}

@@ -3,11 +3,11 @@ import {
 } from "./roy-agent-core-7hh0brvs.js";
 import {
   BaseComponent
-} from "./roy-agent-core-0kn3zt1t.js";
+} from "./roy-agent-core-gtdtzbs7.js";
 import {
   init_decorator,
   init_trace_filters
-} from "./roy-agent-core-8p63s836.js";
+} from "./roy-agent-core-386wa4wy.js";
 import {
   createLogger,
   getTracerProvider,
@@ -18,7 +18,7 @@ import {
   propagation,
   setConfigComponent,
   setQuietMode
-} from "./roy-agent-core-rt115qfc.js";
+} from "./roy-agent-core-6awgfh3x.js";
 import {
   SQLiteSpanStorage,
   init_span_storage

package/dist/shared/@ai-setting/{roy-agent-core-caevk7xd.js → roy-agent-core-arx535cs.js}

@@ -97,23 +97,45 @@ function findLastCallMessage(messages) {
 }
 function parseNodeOutputs(messages) {
   const outputs = new Map;
-  let lastStartNodeId = null;
+  const startedNodes = new Set;
   for (const msg of messages) {
     const metadata = msg.metadata;
     const msgType = metadata?.type;
     if (msgType === "workflow.node.start" || msgType === "workflow.node.call") {
-      lastStartNodeId = getWorkflowNodeIdFromMetadata(metadata) ?? null;
-    } else if ((msgType === "workflow.node.end" || msgType === "workflow.node.result") && lastStartNodeId) {
-      try {
-        outputs.set(lastStartNodeId, JSON.parse(msg.content));
-      } catch {
-        outputs.set(lastStartNodeId, msg.content);
+      const startedId = getWorkflowNodeIdFromMetadata(metadata);
+      if (startedId) {
+        startedNodes.add(startedId);
       }
-      lastStartNodeId = null;
+      continue;
     }
+    if (msgType !== "workflow.node.end" && msgType !== "workflow.node.result") {
+      continue;
+    }
+    const nodeId = getWorkflowNodeIdFromMetadata(metadata);
+    if (!nodeId) {
+      continue;
+    }
+    if (msgType === "workflow.node.result" && !startedNodes.has(nodeId)) {
+      continue;
+    }
+    outputs.set(nodeId, extractNodeOutputValue(msg));
   }
   return outputs;
 }
+function extractNodeOutputValue(msg) {
+  const parts = msg.parts;
+  if (Array.isArray(parts)) {
+    const part = parts.find((p) => p && p["type"] === "workflow-node-end" && ("output" in p));
+    if (part && part["output"] !== undefined) {
+      return part["output"];
+    }
+  }
+  try {
+    return JSON.parse(msg.content);
+  } catch {
+    return msg.content;
+  }
+}
 function hasPendingAskUser(messages) {
   if (messages.length === 0)
     return false;

package/dist/shared/@ai-setting/{roy-agent-core-vh0qzb24.js → roy-agent-core-as0dd70m.js}

@@ -2,14 +2,33 @@ import {
   getEnvContextOrEmpty,
   init_env_context,
   setCurrentTaskId
-} from "./roy-agent-core-syyw58p9.js";
+} from "./roy-agent-core-hfyxv2kx.js";
 import {
   createLogger,
   init_logger
-} from "./roy-agent-core-rt115qfc.js";
+} from "./roy-agent-core-6awgfh3x.js";
 
 // src/env/task/tools/task-types.ts
 import { z } from "zod";
+var UNKNOWN_PROJECT_PATH = "unknown";
+var UNKNOWN_TASK_CONTEXT = '{"type":"unknown"}';
+function taskIdShape() {
+  return {
+    task_id: z.number().describe("Task ID")
+  };
+}
+function normaliseLegacyTaskId(raw) {
+  if (typeof raw !== "object" || raw === null || Array.isArray(raw))
+    return raw;
+  const obj = raw;
+  if (obj.task_id === undefined && obj.id !== undefined) {
+    return { ...obj, task_id: obj.id };
+  }
+  return obj;
+}
+function withLegacyTaskId(shape) {
+  return z.preprocess(normaliseLegacyTaskId, z.object({ ...taskIdShape(), ...shape }));
+}
 var CreateTaskToolSchema = z.object({
   title: z.string().describe("Task title"),
   description: z.string().optional().describe("Task description"),
@@ -18,7 +37,7 @@ var CreateTaskToolSchema = z.object({
   goals_and_expected_deliverables: z.string().optional().describe("Goals and expected deliverables"),
   due_date: z.string().optional().describe("Due date (ISO format)"),
   tags: z.array(z.string()).optional().describe("Task tags (for search, stored in task.tags JSON field)"),
-  project_path: z.string().describe("Project root path for task positioning. " + "Used to locate the project space for this task. " + "Use 'unknown' if unknown."),
+  project_path: z.string().default("unknown").describe("Project root path for task positioning. " + "Used to locate the project space for this task. " + "Use 'unknown' if unknown. (Defaults to 'unknown'.)"),
   parent_task_id: z.union([z.number(), z.null()]).optional().describe(`父任务 ID（可选）。不传或传 null 时，创建根任务（root task）。
 ` + `如需将任务挂载到某个父任务下，传入对应父任务 ID。
 ` + `**调用前必须先调用 task_tree(depth=2)** 查看现有任务树结构，避免重复创建根任务、避免孤儿任务。
@@ -28,11 +47,10 @@ var CreateTaskToolSchema = z.object({
 ` + `  C. 新建根任务 → 省略 parent_task_id（让树根 ≤10）
 ` + `如何找到 parent_task_id：使用 task_tree(depth=2) 获取的树形结构，
 ` + "根据节点 id 选择合适的父任务 ID（来自 tree 输出，**不要硬编码**数字）。"),
-  context: z.string().describe("JSON string with time-space positioning information for task continuity. " + "This field is crucial for Agent task handoff. " + "Core fields: worktree_path (git worktree path), branch (current branch), type (feature/bug/refactor/chore). " + 'Example for coding: {"worktree_path": "/path/worktree", "branch": "feature/xyz", "type": "feature"}. ' + 'Example for other: {"type": "general"}. ' + `If unknown, use '{}' or '{"type":"unknown"}'. ` + "IMPORTANT: Must be a valid JSON string!")
+  context: z.string().default('{"type":"unknown"}').describe("JSON string with time-space positioning information for task continuity. " + "This field is crucial for Agent task handoff. " + "Core fields: worktree_path (git worktree path), branch (current branch), type (feature/bug/refactor/chore). " + 'Example for coding: {"worktree_path": "/path/worktree", "branch": "feature/xyz", "type": "feature"}. ' + 'Example for other: {"type": "general"}. ' + `If unknown, use '{}' or '{"type":"unknown"}'. ` + "IMPORTANT: Must be a valid JSON string!")
 });
-var GetTaskToolSchema = z.object({
-  task_id: z.number().describe("Task ID"),
-  include_operations: z.boolean().optional().default(false).describe("Include operation records")
+var GetTaskToolSchema = withLegacyTaskId({
+  include_operations: z.boolean().optional().default(true).describe("Include operation records (milestones / process log) with the task. " + "Defaults to true — the task's operation history is part of its detail. " + "Pass false for a lean task-only response.")
 });
 var ListTasksToolSchema = z.object({
   status: z.enum(["todo", "active", "completed", "paused", "cancelled", "archived"]).optional(),
@@ -54,8 +72,7 @@ var SearchTasksToolSchema = z.object({
   depth: z.number().optional().describe("检索层级深度：0=只根任务，1=根+一层子任务，2=根+二层子任务，-1 或忽略=全部"),
   include_archived: z.boolean().optional().default(false).describe("是否包含已归档任务（status=archived 的任务默认被排除）")
 });
-var UpdateTaskToolSchema = z.object({
-  task_id: z.number().describe("Task ID"),
+var UpdateTaskToolSchema = withLegacyTaskId({
   title: z.string().optional(),
   description: z.string().optional(),
   status: z.enum(["todo", "active", "completed", "paused", "cancelled", "archived"]).optional(),
@@ -73,8 +90,7 @@ var UpdateTaskToolSchema = z.object({
 var DeleteTaskToolSchema = z.object({
   task_id: z.number().describe("Task ID")
 });
-var CompleteTaskToolSchema = z.object({
-  task_id: z.number().describe("Task ID"),
+var CompleteTaskToolSchema = withLegacyTaskId({
   deliverable_storage_path: z.string().optional().describe("交付物的寻址地址（路径 / URL / 分支名等）。" + "调用本工具前，请先读取任务的 goal（description）和 delivery（goals_and_expected_deliverables）栏位，" + "建议验证目标和交付物是否符合预期，然后将实际交付物的寻址地址填入此参数。")
 });
 var BatchArchiveToolSchema = z.object({
@@ -362,7 +378,9 @@ function createTaskTool(taskComponent) {
       let enrichedContext = params.context;
       const envParentTaskId = getEnvContextOrEmpty().parentTaskId;
       const effectiveParentTaskId = params.parent_task_id !== undefined && params.parent_task_id !== null ? params.parent_task_id : envParentTaskId !== undefined && envParentTaskId !== null && Number.isInteger(envParentTaskId) && envParentTaskId > 0 ? envParentTaskId : undefined;
-      let inheritedProjectPath = params.project_path && params.project_path.trim() !== "" ? params.project_path : undefined;
+      const callerProjectPath = params.project_path && params.project_path.trim() !== "" ? params.project_path : undefined;
+      const callerProjectPathIsExplicit = callerProjectPath !== undefined && callerProjectPath !== UNKNOWN_PROJECT_PATH;
+      let inheritedProjectPath = callerProjectPathIsExplicit ? callerProjectPath : undefined;
       let inheritedTags = params.tags;
       let inheritedContext;
       if (effectiveParentTaskId !== undefined) {
@@ -396,7 +414,8 @@ function createTaskTool(taskComponent) {
         }
       }
       try {
-        const ctxObj = params.context ? JSON.parse(params.context) : {};
+        const rawContext = params.context === UNKNOWN_TASK_CONTEXT ? undefined : params.context;
+        const ctxObj = rawContext ? JSON.parse(rawContext) : {};
         const obj = typeof ctxObj === "object" && ctxObj !== null && !Array.isArray(ctxObj) ? ctxObj : {};
         if (inheritedContext) {
           try {
@@ -430,7 +449,7 @@ function createTaskTool(taskComponent) {
           due_date: params.due_date,
           tags: inheritedTags,
           sessionId,
-          project_path: inheritedProjectPath ?? params.project_path,
+          project_path: inheritedProjectPath ?? (callerProjectPathIsExplicit ? callerProjectPath : UNKNOWN_PROJECT_PATH),
           context: enrichedContext
         });
         setCurrentTaskId(task.id);
@@ -475,9 +494,11 @@ function getTaskTool(taskComponent) {
               metadata: { execution_time_ms: 0 }
             };
           }
+          const nested = result.task;
+          const flat = nested && typeof nested === "object" ? { ...nested, operations: result.operations } : result;
           return {
             success: true,
-            output: JSON.stringify(result, null, 2),
+            output: JSON.stringify(flat, null, 2),
             metadata: { execution_time_ms: 0 }
           };
         } else {