@teammy/server 0.1.12 → 0.1.14

package/dist/native-pi-entry.js

@@ -1,5 +1,5 @@
 // apps/server/ai/native-pi-entry.ts
-import { InMemoryCredentialStore, InMemoryModelsStore, Type as Type2 } from "@earendil-works/pi-ai";
+import { InMemoryCredentialStore, InMemoryModelsStore, Type as Type3 } from "@earendil-works/pi-ai";
 import { createAssistantMessageEventStream } from "@earendil-works/pi-ai/utils/event-stream";
 import {
   createAgentSession,
@@ -8,7 +8,7 @@ import {
   SessionManager,
   SettingsManager
 } from "@earendil-works/pi-coding-agent";
-import { z as z2 } from "zod";
+import { z as z4 } from "zod";
 
 // apps/server/ai/agent-channel.ts
 import { createInterface } from "node:readline";
@@ -60,6 +60,20 @@ import { createModels, createProvider, Type } from "@earendil-works/pi-ai";
 import { openAICompletionsApi } from "@earendil-works/pi-ai/api/openai-completions.lazy";
 import { openAIResponsesApi } from "@earendil-works/pi-ai/api/openai-responses.lazy";
 import { anthropicMessagesApi } from "@earendil-works/pi-ai/api/anthropic-messages.lazy";
+
+// apps/server/errors.ts
+var HubError = class extends Error {
+  constructor(statusCode, code, message) {
+    super(message);
+    this.statusCode = statusCode;
+    this.code = code;
+    this.name = "HubError";
+  }
+  statusCode;
+  code;
+};
+
+// apps/server/ai/models.ts
 function modelAccess(profile, key, reasoning = false) {
   const model = {
     id: profile.model,
@@ -109,6 +123,196 @@ function loadAgentSkills(directory = `${agentResourcesPath}/skills`) {
   return existsSync(directory) ? loadSkillsFromDir({ dir: directory, source: "teammy-deployment" }) : { skills: [], diagnostics: [] };
 }
 
+// apps/server/ai/context-content.ts
+import { createHash, randomUUID } from "node:crypto";
+import { link, mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { z as z2 } from "zod";
+var CONTENT_BYTES = 32 * 1024;
+var CONTENT_LINES = 500;
+var json = (value) => JSON.stringify(value) ?? "null";
+function contentFits(value, bytes = CONTENT_BYTES) {
+  const text = json(value);
+  return Buffer.byteLength(text) <= bytes && (text.match(/\\n|\n/g)?.length ?? 0) < CONTENT_LINES;
+}
+var ReadToolResultSchema = z2.object({
+  id: z2.string().regex(/^[a-f0-9]{64}$/),
+  path: z2.array(z2.union([z2.string().max(512), z2.number().int().nonnegative()])).max(32).refine((path) => Buffer.byteLength(JSON.stringify(path)) <= 4096, "path \u8FC7\u957F").default([]),
+  offset: z2.number().int().nonnegative().default(0),
+  limit: z2.number().int().positive().max(16e3).optional()
+}).strict();
+var kind = (value) => value === null ? "null" : Array.isArray(value) ? "array" : typeof value;
+var length = (value) => typeof value === "string" || Array.isArray(value) ? value.length : value && typeof value === "object" ? Object.keys(value).length : 1;
+function textPrefix(text, end) {
+  if (end < text.length && /[\uD800-\uDBFF]/.test(text[end - 1] ?? "")) end--;
+  return text.slice(0, end);
+}
+function overview(value) {
+  if (contentFits(value, 1024)) return value;
+  if (typeof value === "string")
+    return { kind: "string", length: value.length, preview: textPrefix(value, 300) };
+  if (Array.isArray(value)) return { kind: "array", length: value.length };
+  if (value && typeof value === "object")
+    return {
+      kind: "object",
+      fields: Object.entries(value).slice(0, 12).map(([key, item]) => ({
+        key: textPrefix(key, 80),
+        kind: kind(item),
+        length: length(item),
+        ...typeof item === "string" ? { preview: textPrefix(item, 120) } : {}
+      })),
+      totalFields: Object.keys(value).length
+    };
+  return value;
+}
+var ContextContent = class {
+  constructor(directory) {
+    this.directory = directory;
+  }
+  directory;
+  async present(value, source) {
+    if (contentFits(value)) return value;
+    const body = json({ source, value }), id = createHash("sha256").update(body).digest("hex");
+    await mkdir(this.directory, { recursive: true, mode: 448 });
+    const temporary = join(this.directory, randomUUID() + ".tmp");
+    try {
+      await writeFile(temporary, body, { flag: "wx", mode: 384 });
+      try {
+        await link(temporary, join(this.directory, id + ".json"));
+      } catch (error) {
+        if (error.code !== "EEXIST") throw error;
+      }
+    } finally {
+      await rm(temporary, { force: true });
+    }
+    return {
+      folded: true,
+      note: "\u5185\u5BB9\u8FC7\u957F\uFF0C\u5DF2\u6298\u53E0\uFF1B\u4E0B\u65B9\u4EC5\u4E3A\u6982\u89C8\uFF0C\u4E0D\u80FD\u89C6\u4E3A\u5DF2\u8BFB\u5168\u6587\u3002\u7528 read_tool_result \u6309 path \u548C offset \u8BFB\u53D6\u539F\u59CB\u7ED3\u679C\uFF0C\u4E0D\u5FC5\u91CD\u590D\u6267\u884C\u539F\u5DE5\u5177\u3002",
+      source,
+      id,
+      bytes: Buffer.byteLength(json(value)),
+      overview: overview(value),
+      read: { tool: "read_tool_result", arguments: { id } }
+    };
+  }
+  async input(text) {
+    const value = await this.present(text, "\u672C\u8F6E\u8F93\u5165");
+    return typeof value === "string" ? value : "\u672C\u8F6E\u8F93\u5165\u8F83\u957F\uFF0C\u539F\u6587\u5DF2\u5B8C\u6574\u4FDD\u5B58\u3002\u5148\u5206\u6BB5\u8BFB\u53D6\uFF0C\u786E\u8BA4\u7528\u6237\u7684\u76EE\u6807\u3001\u6761\u4EF6\u548C\u9650\u5236\u540E\u518D\u884C\u52A8\uFF1B\u6982\u89C8\u4E0D\u662F\u5168\u90E8\u8F93\u5165\u3002\n" + json(value);
+  }
+  async read(input) {
+    const { id, path, offset, limit } = ReadToolResultSchema.parse(input);
+    let body;
+    try {
+      body = await readFile(join(this.directory, id + ".json"), "utf8");
+    } catch {
+      throw new HubError(
+        404,
+        "TOOL_RESULT_NOT_FOUND",
+        "\u6B64\u7ED3\u679C\u4E0D\u5728\u5F53\u524D\u4F1A\u8BDD\u6216\u5DF2\u4E0D\u53EF\u7528\uFF0C\u8BF7\u91CD\u65B0\u67E5\u8BE2\u539F\u59CB\u8D44\u6599\u3002"
+      );
+    }
+    if (createHash("sha256").update(body).digest("hex") !== id)
+      throw new HubError(409, "TOOL_RESULT_CHANGED", "\u7ED3\u679C\u5FEB\u7167\u5DF2\u6539\u53D8\uFF0C\u8BF7\u91CD\u65B0\u67E5\u8BE2\u539F\u59CB\u8D44\u6599\u3002");
+    const saved = JSON.parse(body);
+    let value = saved.value;
+    for (const key of path) {
+      if (!value || typeof value !== "object" || !Object.hasOwn(value, key))
+        throw new HubError(400, "TOOL_RESULT_PATH", "\u7ED3\u679C\u4E2D\u4E0D\u5B58\u5728\u8BE5 path\u3002");
+      value = value[key];
+    }
+    const total = length(value);
+    if (offset > total) throw new HubError(400, "TOOL_RESULT_OFFSET", "offset \u8D85\u51FA\u7ED3\u679C\u8303\u56F4\u3002");
+    const base = { id, source: saved.source, path, kind: kind(value), total, offset };
+    if (typeof value === "string") {
+      if (/[\uDC00-\uDFFF]/.test(value[offset] ?? "") && /[\uD800-\uDBFF]/.test(value[offset - 1] ?? ""))
+        throw new HubError(400, "TOOL_RESULT_OFFSET", "\u8BF7\u6CBF\u7528\u4E0A\u6B21\u8FD4\u56DE\u7684 nextOffset\u3002");
+      const tail = value.slice(offset);
+      let lo = 0, hi = Math.min(tail.length, limit ?? 16e3);
+      while (lo < hi) {
+        const mid = Math.ceil((lo + hi) / 2);
+        if (contentFits({ ...base, text: textPrefix(tail, mid), nextOffset: offset + mid }))
+          lo = mid;
+        else hi = mid - 1;
+      }
+      let text = textPrefix(tail, lo);
+      if (!text && tail) text = textPrefix(tail, 2);
+      return {
+        ...base,
+        text,
+        nextOffset: offset + text.length < total ? offset + text.length : null
+      };
+    }
+    if (!value || typeof value !== "object") return { ...base, value, nextOffset: null };
+    const entries = [];
+    const keys = Array.isArray(value) ? value.map((_, i) => i) : Object.keys(value);
+    for (const key of keys.slice(offset, offset + Math.min(limit ?? 50, 100))) {
+      const item = value[key];
+      const folded = !contentFits(item, 2048);
+      const entry = { path: [...path, key], folded, value: folded ? overview(item) : item };
+      if (!contentFits({
+        ...base,
+        entries: [...entries, entry],
+        nextOffset: offset + entries.length + 1
+      }))
+        break;
+      entries.push(entry);
+    }
+    if (!entries.length && offset < total)
+      throw new HubError(413, "TOOL_RESULT_KEY_TOO_LONG", "\u7ED3\u679C\u5B57\u6BB5\u540D\u8FC7\u957F\uFF0C\u65E0\u6CD5\u751F\u6210\u5B89\u5168\u7684\u5206\u9875\u3002");
+    return {
+      ...base,
+      entries,
+      nextOffset: offset + entries.length < total ? offset + entries.length : null
+    };
+  }
+};
+
+// apps/server/ai/content-tools.ts
+import { Type as Type2 } from "@earendil-works/pi-ai";
+import { z as z3 } from "zod";
+var readToolResultDescription = "\u8BFB\u53D6\u5F53\u524D\u8303\u56F4\u5185\u5DF2\u6298\u53E0\u7684\u539F\u59CB\u7ED3\u679C\uFF0C\u4E0D\u91CD\u8DD1\u539F\u5DE5\u5177\u3002\u5148\u7528 id \u67E5\u770B\u5B57\u6BB5/\u6761\u76EE\uFF1B\u6CBF\u8FD4\u56DE\u7684 path \u8BFB\u53D6\u5177\u4F53\u5B57\u6BB5\u6216\u6587\u4EF6\u5DEE\u5F02\uFF0CnextOffset \u975E\u7A7A\u65F6\u7EE7\u7EED\u3002folded=true \u7684\u6761\u76EE\u53EA\u663E\u793A\u6982\u89C8\uFF0C\u4E0D\u80FD\u5F53\u4F5C\u5B8C\u6574\u6B63\u6587\uFF1B\u5B57\u7B26\u4E32 offset \u4E3A\u8FD4\u56DE\u7684 UTF-16 \u4F4D\u7F6E\u3002\u5FEB\u7167\u56FA\u5B9A\u5728\u539F\u67E5\u8BE2\u7248\u672C\u3002";
+function contentTools(content, tools) {
+  return [
+    ...tools.map((tool) => ({
+      ...tool,
+      async execute(...args) {
+        const result = await tool.execute(...args);
+        const blocks = [];
+        for (const block of result.content) {
+          if (block.type !== "text") {
+            blocks.push(block);
+            continue;
+          }
+          let value;
+          try {
+            value = JSON.parse(block.text);
+          } catch {
+            value = block.text;
+          }
+          const bounded = await content.present(value, tool.name);
+          blocks.push({
+            type: "text",
+            text: bounded === value && contentFits(block.text) ? block.text : JSON.stringify(bounded)
+          });
+        }
+        return { content: blocks, details: {} };
+      }
+    })),
+    {
+      name: "read_tool_result",
+      label: "\u8BFB\u53D6\u6298\u53E0\u5185\u5BB9",
+      description: readToolResultDescription,
+      parameters: Type2.Unsafe(z3.toJSONSchema(ReadToolResultSchema, { io: "input" })),
+      async execute(_id, input) {
+        return {
+          content: [{ type: "text", text: JSON.stringify(await content.read(input)) }],
+          details: {}
+        };
+      }
+    }
+  ];
+}
+
 // apps/server/ai/native-pi-entry.ts
 var channel = new AgentChannel(process.stdin, process.stdout);
 var sequence = 0;
@@ -123,6 +327,7 @@ function rpc(request) {
 async function run(config) {
   const { model, runtime } = config;
   const cwd = "/workspaces", agentDir = "/tmp/pi";
+  const content = new ContextContent("/tmp/teammy-content");
   const modelRuntime = await ModelRuntime.create({
     credentials: new InMemoryCredentialStore(),
     modelsStore: new InMemoryModelsStore(),
@@ -163,7 +368,7 @@ async function run(config) {
   const query = {
     name: "query_tasks",
     ...runtime.toolText.query_tasks,
-    parameters: Type2.Unsafe(z2.toJSONSchema(TaskQuerySchema)),
+    parameters: Type3.Unsafe(z4.toJSONSchema(TaskQuerySchema)),
     async execute(_id, params) {
       const value = await rpc({ method: "query_tasks", input: TaskQuerySchema.parse(params) });
       return { content: [{ type: "text", text: JSON.stringify(value) }], details: {} };
@@ -182,8 +387,8 @@ async function run(config) {
       retry: { enabled: false, maxRetries: 0 },
       cacheWarming: "off"
     }),
-    tools: runtime.config.tools,
-    customTools: runtime.config.tools.includes("query_tasks") ? [query] : []
+    tools: [...runtime.config.tools, "read_tool_result"],
+    customTools: contentTools(content, runtime.config.tools.includes("query_tasks") ? [query] : [])
   });
   session.agent.streamFunction = (_model, context) => {
     const stream = createAssistantMessageEventStream();
@@ -227,7 +432,7 @@ async function run(config) {
       });
   });
   try {
-    await session.prompt(config.input);
+    await session.prompt(await content.input(config.input));
     const last = session.messages.filter((message) => message.role === "assistant").at(-1);
     if (!last || last.stopReason === "error" || last.stopReason === "aborted")
       throw new Error("Analysis failed.");

package/dist/project-pi-entry.js

@@ -1,9 +1,9 @@
 // apps/server/agents/pi-entry.ts
 import { spawn } from "node:child_process";
 import { existsSync as existsSync2 } from "node:fs";
-import { mkdir, readFile } from "node:fs/promises";
-import { join, basename } from "node:path";
-import { InMemoryCredentialStore, InMemoryModelsStore, Type as Type2 } from "@earendil-works/pi-ai";
+import { mkdir as mkdir2, readFile as readFile2 } from "node:fs/promises";
+import { join as join2, basename } from "node:path";
+import { InMemoryCredentialStore, InMemoryModelsStore, Type as Type3 } from "@earendil-works/pi-ai";
 import { createAssistantMessageEventStream } from "@earendil-works/pi-ai/utils/event-stream";
 import {
   createAgentSession,
@@ -54,6 +54,20 @@ import { createModels, createProvider, Type } from "@earendil-works/pi-ai";
 import { openAICompletionsApi } from "@earendil-works/pi-ai/api/openai-completions.lazy";
 import { openAIResponsesApi } from "@earendil-works/pi-ai/api/openai-responses.lazy";
 import { anthropicMessagesApi } from "@earendil-works/pi-ai/api/anthropic-messages.lazy";
+
+// apps/server/errors.ts
+var HubError = class extends Error {
+  constructor(statusCode, code, message) {
+    super(message);
+    this.statusCode = statusCode;
+    this.code = code;
+    this.name = "HubError";
+  }
+  statusCode;
+  code;
+};
+
+// apps/server/ai/models.ts
 function modelAccess(profile, key, reasoning = false) {
   const model = {
     id: profile.model,
@@ -103,6 +117,196 @@ function loadAgentSkills(directory = `${agentResourcesPath}/skills`) {
   return existsSync(directory) ? loadSkillsFromDir({ dir: directory, source: "teammy-deployment" }) : { skills: [], diagnostics: [] };
 }
 
+// apps/server/ai/context-content.ts
+import { createHash, randomUUID } from "node:crypto";
+import { link, mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { z } from "zod";
+var CONTENT_BYTES = 32 * 1024;
+var CONTENT_LINES = 500;
+var json = (value) => JSON.stringify(value) ?? "null";
+function contentFits(value, bytes = CONTENT_BYTES) {
+  const text = json(value);
+  return Buffer.byteLength(text) <= bytes && (text.match(/\\n|\n/g)?.length ?? 0) < CONTENT_LINES;
+}
+var ReadToolResultSchema = z.object({
+  id: z.string().regex(/^[a-f0-9]{64}$/),
+  path: z.array(z.union([z.string().max(512), z.number().int().nonnegative()])).max(32).refine((path) => Buffer.byteLength(JSON.stringify(path)) <= 4096, "path \u8FC7\u957F").default([]),
+  offset: z.number().int().nonnegative().default(0),
+  limit: z.number().int().positive().max(16e3).optional()
+}).strict();
+var kind = (value) => value === null ? "null" : Array.isArray(value) ? "array" : typeof value;
+var length = (value) => typeof value === "string" || Array.isArray(value) ? value.length : value && typeof value === "object" ? Object.keys(value).length : 1;
+function textPrefix(text, end) {
+  if (end < text.length && /[\uD800-\uDBFF]/.test(text[end - 1] ?? "")) end--;
+  return text.slice(0, end);
+}
+function overview(value) {
+  if (contentFits(value, 1024)) return value;
+  if (typeof value === "string")
+    return { kind: "string", length: value.length, preview: textPrefix(value, 300) };
+  if (Array.isArray(value)) return { kind: "array", length: value.length };
+  if (value && typeof value === "object")
+    return {
+      kind: "object",
+      fields: Object.entries(value).slice(0, 12).map(([key, item]) => ({
+        key: textPrefix(key, 80),
+        kind: kind(item),
+        length: length(item),
+        ...typeof item === "string" ? { preview: textPrefix(item, 120) } : {}
+      })),
+      totalFields: Object.keys(value).length
+    };
+  return value;
+}
+var ContextContent = class {
+  constructor(directory) {
+    this.directory = directory;
+  }
+  directory;
+  async present(value, source) {
+    if (contentFits(value)) return value;
+    const body = json({ source, value }), id = createHash("sha256").update(body).digest("hex");
+    await mkdir(this.directory, { recursive: true, mode: 448 });
+    const temporary = join(this.directory, randomUUID() + ".tmp");
+    try {
+      await writeFile(temporary, body, { flag: "wx", mode: 384 });
+      try {
+        await link(temporary, join(this.directory, id + ".json"));
+      } catch (error) {
+        if (error.code !== "EEXIST") throw error;
+      }
+    } finally {
+      await rm(temporary, { force: true });
+    }
+    return {
+      folded: true,
+      note: "\u5185\u5BB9\u8FC7\u957F\uFF0C\u5DF2\u6298\u53E0\uFF1B\u4E0B\u65B9\u4EC5\u4E3A\u6982\u89C8\uFF0C\u4E0D\u80FD\u89C6\u4E3A\u5DF2\u8BFB\u5168\u6587\u3002\u7528 read_tool_result \u6309 path \u548C offset \u8BFB\u53D6\u539F\u59CB\u7ED3\u679C\uFF0C\u4E0D\u5FC5\u91CD\u590D\u6267\u884C\u539F\u5DE5\u5177\u3002",
+      source,
+      id,
+      bytes: Buffer.byteLength(json(value)),
+      overview: overview(value),
+      read: { tool: "read_tool_result", arguments: { id } }
+    };
+  }
+  async input(text) {
+    const value = await this.present(text, "\u672C\u8F6E\u8F93\u5165");
+    return typeof value === "string" ? value : "\u672C\u8F6E\u8F93\u5165\u8F83\u957F\uFF0C\u539F\u6587\u5DF2\u5B8C\u6574\u4FDD\u5B58\u3002\u5148\u5206\u6BB5\u8BFB\u53D6\uFF0C\u786E\u8BA4\u7528\u6237\u7684\u76EE\u6807\u3001\u6761\u4EF6\u548C\u9650\u5236\u540E\u518D\u884C\u52A8\uFF1B\u6982\u89C8\u4E0D\u662F\u5168\u90E8\u8F93\u5165\u3002\n" + json(value);
+  }
+  async read(input) {
+    const { id, path, offset, limit } = ReadToolResultSchema.parse(input);
+    let body;
+    try {
+      body = await readFile(join(this.directory, id + ".json"), "utf8");
+    } catch {
+      throw new HubError(
+        404,
+        "TOOL_RESULT_NOT_FOUND",
+        "\u6B64\u7ED3\u679C\u4E0D\u5728\u5F53\u524D\u4F1A\u8BDD\u6216\u5DF2\u4E0D\u53EF\u7528\uFF0C\u8BF7\u91CD\u65B0\u67E5\u8BE2\u539F\u59CB\u8D44\u6599\u3002"
+      );
+    }
+    if (createHash("sha256").update(body).digest("hex") !== id)
+      throw new HubError(409, "TOOL_RESULT_CHANGED", "\u7ED3\u679C\u5FEB\u7167\u5DF2\u6539\u53D8\uFF0C\u8BF7\u91CD\u65B0\u67E5\u8BE2\u539F\u59CB\u8D44\u6599\u3002");
+    const saved = JSON.parse(body);
+    let value = saved.value;
+    for (const key of path) {
+      if (!value || typeof value !== "object" || !Object.hasOwn(value, key))
+        throw new HubError(400, "TOOL_RESULT_PATH", "\u7ED3\u679C\u4E2D\u4E0D\u5B58\u5728\u8BE5 path\u3002");
+      value = value[key];
+    }
+    const total = length(value);
+    if (offset > total) throw new HubError(400, "TOOL_RESULT_OFFSET", "offset \u8D85\u51FA\u7ED3\u679C\u8303\u56F4\u3002");
+    const base = { id, source: saved.source, path, kind: kind(value), total, offset };
+    if (typeof value === "string") {
+      if (/[\uDC00-\uDFFF]/.test(value[offset] ?? "") && /[\uD800-\uDBFF]/.test(value[offset - 1] ?? ""))
+        throw new HubError(400, "TOOL_RESULT_OFFSET", "\u8BF7\u6CBF\u7528\u4E0A\u6B21\u8FD4\u56DE\u7684 nextOffset\u3002");
+      const tail = value.slice(offset);
+      let lo = 0, hi = Math.min(tail.length, limit ?? 16e3);
+      while (lo < hi) {
+        const mid = Math.ceil((lo + hi) / 2);
+        if (contentFits({ ...base, text: textPrefix(tail, mid), nextOffset: offset + mid }))
+          lo = mid;
+        else hi = mid - 1;
+      }
+      let text = textPrefix(tail, lo);
+      if (!text && tail) text = textPrefix(tail, 2);
+      return {
+        ...base,
+        text,
+        nextOffset: offset + text.length < total ? offset + text.length : null
+      };
+    }
+    if (!value || typeof value !== "object") return { ...base, value, nextOffset: null };
+    const entries = [];
+    const keys = Array.isArray(value) ? value.map((_, i) => i) : Object.keys(value);
+    for (const key of keys.slice(offset, offset + Math.min(limit ?? 50, 100))) {
+      const item = value[key];
+      const folded = !contentFits(item, 2048);
+      const entry = { path: [...path, key], folded, value: folded ? overview(item) : item };
+      if (!contentFits({
+        ...base,
+        entries: [...entries, entry],
+        nextOffset: offset + entries.length + 1
+      }))
+        break;
+      entries.push(entry);
+    }
+    if (!entries.length && offset < total)
+      throw new HubError(413, "TOOL_RESULT_KEY_TOO_LONG", "\u7ED3\u679C\u5B57\u6BB5\u540D\u8FC7\u957F\uFF0C\u65E0\u6CD5\u751F\u6210\u5B89\u5168\u7684\u5206\u9875\u3002");
+    return {
+      ...base,
+      entries,
+      nextOffset: offset + entries.length < total ? offset + entries.length : null
+    };
+  }
+};
+
+// apps/server/ai/content-tools.ts
+import { Type as Type2 } from "@earendil-works/pi-ai";
+import { z as z2 } from "zod";
+var readToolResultDescription = "\u8BFB\u53D6\u5F53\u524D\u8303\u56F4\u5185\u5DF2\u6298\u53E0\u7684\u539F\u59CB\u7ED3\u679C\uFF0C\u4E0D\u91CD\u8DD1\u539F\u5DE5\u5177\u3002\u5148\u7528 id \u67E5\u770B\u5B57\u6BB5/\u6761\u76EE\uFF1B\u6CBF\u8FD4\u56DE\u7684 path \u8BFB\u53D6\u5177\u4F53\u5B57\u6BB5\u6216\u6587\u4EF6\u5DEE\u5F02\uFF0CnextOffset \u975E\u7A7A\u65F6\u7EE7\u7EED\u3002folded=true \u7684\u6761\u76EE\u53EA\u663E\u793A\u6982\u89C8\uFF0C\u4E0D\u80FD\u5F53\u4F5C\u5B8C\u6574\u6B63\u6587\uFF1B\u5B57\u7B26\u4E32 offset \u4E3A\u8FD4\u56DE\u7684 UTF-16 \u4F4D\u7F6E\u3002\u5FEB\u7167\u56FA\u5B9A\u5728\u539F\u67E5\u8BE2\u7248\u672C\u3002";
+function contentTools(content, tools) {
+  return [
+    ...tools.map((tool) => ({
+      ...tool,
+      async execute(...args) {
+        const result = await tool.execute(...args);
+        const blocks = [];
+        for (const block of result.content) {
+          if (block.type !== "text") {
+            blocks.push(block);
+            continue;
+          }
+          let value;
+          try {
+            value = JSON.parse(block.text);
+          } catch {
+            value = block.text;
+          }
+          const bounded = await content.present(value, tool.name);
+          blocks.push({
+            type: "text",
+            text: bounded === value && contentFits(block.text) ? block.text : JSON.stringify(bounded)
+          });
+        }
+        return { content: blocks, details: {} };
+      }
+    })),
+    {
+      name: "read_tool_result",
+      label: "\u8BFB\u53D6\u6298\u53E0\u5185\u5BB9",
+      description: readToolResultDescription,
+      parameters: Type2.Unsafe(z2.toJSONSchema(ReadToolResultSchema, { io: "input" })),
+      async execute(_id, input) {
+        return {
+          content: [{ type: "text", text: JSON.stringify(await content.read(input)) }],
+          details: {}
+        };
+      }
+    }
+  ];
+}
+
 // apps/server/agents/pi-entry.ts
 async function piChild() {
   const channel = new AgentChannel(process.stdin, process.stdout);
@@ -128,7 +332,7 @@ async function piChild() {
     ]);
     if (session && key === configKey) return;
     session?.dispose();
-    await mkdir(input.sessionDir, { recursive: true });
+    await mkdir2(input.sessionDir, { recursive: true });
     manager = input.transient ? SessionManager.inMemory(input.cwd ?? "/project") : input.sessionFile && existsSync2(input.sessionFile) ? SessionManager.open(input.sessionFile, input.sessionDir, input.cwd ?? "/project") : SessionManager.create(input.cwd ?? "/project", input.sessionDir);
     const modelRuntime = await ModelRuntime.create({
       credentials: new InMemoryCredentialStore(),
@@ -170,23 +374,24 @@ async function piChild() {
       reload: async () => {
       }
     };
+    const content = new ContextContent(join2(input.sessionDir, "content"));
     const customTools = input.tools.map((tool) => ({
       name: tool.name,
       label: tool.label,
       description: tool.description,
-      parameters: Type2.Unsafe(tool.schema),
+      parameters: Type3.Unsafe(tool.schema),
       execute: async (_id, params) => {
         let input2 = params;
         if (tool.name === "save_material") {
           const source = params;
           input2 = {
             ...source,
-            ...source.contentFile ? { _content: await readFile(source.contentFile, "utf8") } : {},
+            ...source.contentFile ? { _content: await readFile2(source.contentFile, "utf8") } : {},
             ...source.originals ? {
               _files: await Promise.all(
                 source.originals.map(async (file) => ({
                   name: file.name ?? basename(file.path),
-                  base64: (await readFile(file.path)).toString("base64")
+                  base64: (await readFile2(file.path)).toString("base64")
                 }))
               )
             } : {}
@@ -198,7 +403,7 @@ async function piChild() {
     }));
     const created = await createAgentSession({
       cwd: input.cwd ?? "/project",
-      agentDir: join(input.sessionDir, "agent"),
+      agentDir: join2(input.sessionDir, "agent"),
       modelRuntime,
       model: input.model,
       thinkingLevel: "off",
@@ -216,9 +421,10 @@ async function piChild() {
         "find",
         "ls",
         ...input.cwd === "/work" ? ["write", "edit"] : [],
-        ...input.tools.map((tool) => tool.name)
+        ...input.tools.map((tool) => tool.name),
+        "read_tool_result"
       ],
-      customTools
+      customTools: contentTools(content, customTools)
     });
     session = created.session;
     configKey = key;
@@ -298,8 +504,10 @@ async function piChild() {
     });
     try {
       await native.prompt(
-        interrupted ? `\u6B64\u524D\u8FD9\u4E00\u8F6E\u6267\u884C\u4E2D\u65AD\u6216\u672A\u6210\u529F\uFF0C\u8BF7\u7ED3\u5408\u5DF2\u4FDD\u5B58\u7684\u4E0A\u4E0B\u6587\u7EE7\u7EED\u3002\u5DF2\u63D0\u4EA4\u64CD\u4F5C\u7684\u56DE\u6267\u4ECD\u6709\u6548\uFF0C\u4E0D\u8981\u91CD\u590D\u53D1\u9001\uFF1B\u6682\u5B58\u56DE\u7B54\u548C\u5B8C\u6210\u62A5\u544A\u5C1A\u672A\u63D0\u4EA4\uFF0C\u8BF7\u91CD\u65B0\u6838\u5BF9\u540E\u7ED9\u51FA\u672C\u8F6E\u7ED3\u8BBA\u3002\u539F\u8F93\u5165\uFF1A
+        await new ContextContent(join2(input.sessionDir, "content")).input(
+          interrupted ? `\u6B64\u524D\u8FD9\u4E00\u8F6E\u6267\u884C\u4E2D\u65AD\u6216\u672A\u6210\u529F\uFF0C\u8BF7\u7ED3\u5408\u5DF2\u4FDD\u5B58\u7684\u4E0A\u4E0B\u6587\u7EE7\u7EED\u3002\u5DF2\u63D0\u4EA4\u64CD\u4F5C\u7684\u56DE\u6267\u4ECD\u6709\u6548\uFF0C\u4E0D\u8981\u91CD\u590D\u53D1\u9001\uFF1B\u6682\u5B58\u56DE\u7B54\u548C\u5B8C\u6210\u62A5\u544A\u5C1A\u672A\u63D0\u4EA4\uFF0C\u8BF7\u91CD\u65B0\u6838\u5BF9\u540E\u7ED9\u51FA\u672C\u8F6E\u7ED3\u8BBA\u3002\u539F\u8F93\u5165\uFF1A
 ${input.text}` : input.text
+        )
       );
       await native.waitForIdle();
       const last = native.messages.filter((message) => message.role === "assistant").at(-1);

package/dist/runtime/README.md

@@ -8,9 +8,9 @@
 
 模型和密钥继续在现有接入点设置中配置。执行配置不能增加未注册工具或突破快照访问范围。`settleSeconds` 用于冷启动及后续版本维护的合并等待，从该成员最新一次有效发布开始计算。
 
-会话整理使用独立的 `session-overview` 和 `session-handoff` 资源，不加载文件探索的共享 system/tool 提示词。前者自动生成标题和短摘要，后者按需生成详细交接说明；二者分别调用 SDK。配置仅包含版本、合并等待、单次请求时限与推理级别，首次执行冻结资源，自动重试沿用。详见 [会话整理](../../../../docs/session-analysis.md)。
+会话整理使用独立的 `session-overview` 和 `session-handoff` 资源，不加载文件探索的共享 system/tool 提示词。前者自动生成标题和短摘要，后者自动生成详细交接说明；二者分别调用 SDK。配置仅包含版本、合并等待、单次请求时限与推理级别，首次执行冻结资源，自动重试沿用。详见 [会话整理](../../../../docs/session-analysis.md)。
 
-`task-bootstrap` v10 同时负责首次整理和后续维护，`directory-analysis` v3 复用原生沙箱。整个 Pi 进程在 Linux Bubblewrap 沙箱中运行，挂载只读成员工作区和可选历史基线。原生 read/bash/grep/find/ls 不由此目录改写描述，只有 query_tasks 是 Teammy 自定义工具，用于查询已有任务。业务提示词追加到 Pi 原生系统提示；最终输出 upsert / archive 与任务级 needsConfirmation，不生成分析级 uncertainties。旧冻结作业保留快照工具协议。详见 [任务维护设计](../../../../docs/task-agent-maintenance-v1.md)。
+`task-bootstrap` v12 同时负责首次整理和后续维护，`directory-analysis` v3 复用原生沙箱。整个 Pi 进程在 Linux Bubblewrap 沙箱中运行，挂载只读成员工作区和可选历史基线。原生 read/bash/grep/find/ls 不由此目录改写描述，只有 query_tasks 是 Teammy 自定义工具，用于查询已有任务。业务提示词追加到 Pi 原生系统提示；最终输出 upsert / archive 与任务级 needsConfirmation，不生成分析级 uncertainties。旧冻结作业保留快照工具协议。详见 [任务维护设计](../../../../docs/task-agent-maintenance-v1.md)。
 
 `thinkingLevel` 默认 off；设为其他级别时通过 Pi 的通用推理参数映射传给适配器，接入点需支持对应推理能力。上下文和输出限额由网关处理，Teammy 不配置或发送这些额度。
 
@@ -29,7 +29,7 @@
 - `query`：标题、目标、进展或来源路径的子串，不区分大小写。
 - `visibility`：`active`、`archived` 或 `all`。默认 `active`；指定 `id` 时默认 `all`。`active` 表示未归档，也包含已完成任务。
 
-返回 `{ items, total, omitted, note? }`。`total` 为匹配总数，`items` 最多 40 项，超出时给出省略数与提示，可缩小查询范围。每项包含 `taskId`、`title`、`goal`、`status`、`progress`、`needsConfirmation`、`sources`、`active`；来源包含 `path`、`sha256`、`revision` 与 `syncedAt`。任务表达已合并保存的人工修订。
+返回 `{ items, total, omitted, note? }`。`total` 为匹配总数，`items` 最多 40 项，超出时给出省略数与提示，可缩小查询范围。每项包含 `taskId`、`revision`、`lastEdit`、`title`、`goal`、`status`、`progress`、`needsConfirmation`、`sources`、`active`；来源包含 `path`、`sha256`、`revision` 与 `syncedAt`。任务表达就是当前内容，直接包含用户修改；lastEdit 记录最近一次人工或委托修改的时间及操作者（旧数据可未知）。后续分析依据新证据继续维护，没有永久覆盖字段。
 
 当前数据范围是**作业创建时冻结的单成员任务**，不是实时的全项目查询；参数不支持项目或成员切换。调用范围由宿主提供的 `TaskContext` 和成员身份决定，工具自身不访问数据库，也没有同名 HTTP 路由。
 

package/dist/runtime/shared/tools.json

@@ -17,6 +17,6 @@
   },
   "query_tasks": {
     "label": "查询已有任务",
-    "description": "Query existing tasks of the current member by id, source (path relative to workspaces), or query (title/goal/progress/source substring). visibility=active (default), archived or all; an exact id defaults to all. Returns taskId, task fields, sources and active flag. Long results are abbreviated with an omitted count; narrow the query as needed."
+    "description": "Query existing tasks of the current member by id, source (path relative to workspaces), or query (title/goal/progress/source substring). visibility=active (default), archived or all; an exact id defaults to all. Returns taskId, current task fields, revision, lastEdit (latest human/delegated edit, nullable time and actor), sources and active flag. Continue from these current values, including user edits, using new evidence; do not reconstruct a separate automatic version from old files. Long results are abbreviated with an omitted count; narrow the query as needed."
   }
 }

package/dist/runtime/workflows/session-handoff/config.json

@@ -1,6 +1,6 @@
 {
-  "version": 2,
-  "settleSeconds": 0,
+  "version": 3,
+  "settleSeconds": 60,
   "requestTimeoutMs": 300000,
   "thinkingLevel": "off"
 }

package/dist/runtime/workflows/task-bootstrap/config.json

@@ -1,5 +1,5 @@
 {
-  "version": 11,
+  "version": 12,
   "thinkingLevel": "off",
   "tools": ["read", "bash", "grep", "find", "ls", "query_tasks"],
   "maxRounds": 256,

package/dist/runtime/workflows/task-bootstrap/prompt.md

@@ -29,7 +29,7 @@
 
 - `title`：简洁的任务标题，普通进展变化时保持稳定。
 - `goal`：目标或完成边界，未明确时为 null。
-- `status`：planned（计划）、in_progress（进行中）、in_review（等待决策或验收）、completed（整体完成）；无法判断时为 null。
+- `status`：planned（计划）、in_progress（进行中）、in_review（待验收）、completed（整体完成）；无法判断时为 null。待验收仅用于任务约定的成果已经具备并提交，正在等待验收或最终确认；前置审批、方案选型等过程中的决策，尚未开展工作时归计划，已开展调研、设计或实施时归进行中。按任务自身目标判断：实现功能前的方案评审属于过程，但“交付设计方案”任务的方案提交后可以待验收。仍有影响交付的实质工作时保持进行中；验收要求返工可回到进行中，不强制逐阶段流转。
 - `progress`：面向看板，优先用一两句话概括当前成果、所处阶段和影响完成的剩余事项；实现细节与无关统计保留在来源中。
 - `needsConfirmation`：资料的歧义是否影响对任务目标、状态或进展的理解，需要人类确认；是为 true，否则为 false。已明确的待办或等待条件本身不构成歧义。仍正常填写该任务的其他字段。
 - `sources`：支撑判断的当前成员文件，路径相对于 `/workspaces`，包含成员目录前缀。
@@ -42,7 +42,9 @@
 
 更新关注任务表达和来源的实质变化，无需为了措辞或附带统计的变化重写任务。
 
-已有任务也可能由成员确认创建（origin 为 confirmed），来源中的 material 表示项目资料，不在本轮成员目录内。结合已有任务避免重复；不能因成员文件缺少对应记录而撤下这类任务。人工确认的字段由系统保留，本轮只补充工作区中的实际变化。
+query_tasks 返回任务的当前内容，已经包含用户保存的修改，是本轮分析的起点；没有独立的自动结果或永久锁定字段。lastEdit 记录最近一次人工或委托修改的时间和操作者（旧记录可能未知），revision 用于版本保护。结合当前内容、历史基线及后续新证据继续更新标题、目标、状态、进展和 needsConfirmation；没有实质新证据时保留当前内容，不因重复读到旧资料就撤销用户的判断。后续验收通过可更新为 completed，新的返工记录可更新为 in_progress；新的资料歧义仍可将 needsConfirmation 设为 true。
+
+已有任务也可能由成员确认创建（origin 为 confirmed），来源中的 material 表示项目资料，不在本轮成员目录内。结合已有任务避免重复，这些任务同样可以根据后续证据更新。归档必须有明确的合并、替代或撤下依据，不因来源缺失、工作完成、本轮未涉及或任务由人工修改过就归档。
 
 ## 分析范围与复核