@jun133/kitty 0.0.15 → 0.0.16

package/README.md

@@ -5,7 +5,7 @@
 官网：https://agentjz.github.io/kitty/
 
 <p align="center">
-  <strong>🐾 一个本地 agent 编程工作台：搜得到，看得懂，改得准，跑得通，记得住，能继续。</strong>
+  <strong>🐾 一个 agent 编程工作台：搜得到，看得懂，改得准，跑得通，记得住，能继续。</strong>
 </p>
 
 <p align="center">
@@ -29,7 +29,7 @@
 - 可恢复的 session 现场
 - CLI、TUI、Telegram 三种入口
 - 当前现场、后台任务、会话事件、memory 和 eval
-- 省 token 的上下文与输出治理
+- 省 token 的上下文、缓存事实和工具输出治理
 
 ## ⚡ 快速开始
 
@@ -101,14 +101,16 @@ kitty "检查这个仓库并修复失败测试"
 | `kitty events [sessionId]` | 查看最近会话或指定会话的机器事件 |
 | `kitty config show` | 查看从 `.kitty/.env` 解析出的当前运行配置 |
 | `kitty config path` | 查看当前项目 `.kitty/.env` 路径 |
-| `kitty status` | 查看当前项目现场：当前目标、下一步、阻塞、后台、恢复、成本、session、context budget、memory、skills、project map、execution、wake |
+| `kitty status` | 查看当前项目现场：先显示 Current scene，再显示 session、context budget、memory files、skills、project orientation、execution、wake 等 Runtime facts |
 | `kitty memory` | 创建、查看、读取、搜索、删除 runtime memory assets，或把 memory 沉淀到 skill references |
 | `kitty changes` | 查看记录的文件变更 |
 | `kitty undo [changeId]` | 撤销最近一次或指定变更 |
 | `kitty diff [path]` | 查看当前 git diff |
-| `kitty doctor` | 检查 `.kitty` 文件、env contract、provider preset、runtime、provider 连接和下一步 |
-| `kitty eval` | 查看产品验收场景；`kitty eval --run` 运行本地机器验收 |
-| `kitty telegram serve` | 启动 Telegram 私聊服务 |
+| `kitty doctor` | 检查 `.kitty` 文件、env contract、provider preset、runtime、provider 连接和下一步 |
+| `kitty eval` | 查看产品验收场景；`kitty eval --run-local` 运行本地机器验收；`kitty eval --run-production` 显式运行生产路径验收 |
+| `kitty telegram serve` | 启动 Telegram 私聊服务 |
+
+`npm.cmd test` 只跑日常确定性测试，不跑 eval。产品验收独立运行：`npm.cmd run test:eval` 验证 eval harness，`npm.cmd run eval:local` 跑本地验收，`npm.cmd run eval:production` 使用当前 `.kitty/.env` 显式跑生产路径验收。运行 eval 前先执行 `npm.cmd run build`。
 
 查看配置：
 

package/dist/{App-CBTIS4IK.mjs → App-K7CBA2FU.mjs}

@@ -2,7 +2,7 @@ import {
   TRANSCRIPT_OUTER_PADDING_X,
   TUI_COLORS,
   renderTranscriptLineViews
-} from "./chunk-NBKU7KA4.mjs";
+} from "./chunk-L27HOXD2.mjs";
 
 // src/shell/tui/layout.ts
 var TUI_MIN_WIDTH = 48;

package/dist/{chunk-7FDXKNTM.mjs → chunk-7FOTCUIH.mjs}

@@ -33,7 +33,7 @@ import {
   sliceCurrentUserInputFrame,
   takeLastUnique,
   updateSessionMemory
-} from "./chunk-S4QTRPZ7.mjs";
+} from "./chunk-C3MFBHV3.mjs";
 
 // src/context/projectContext.ts
 import fs6 from "fs/promises";
@@ -1535,133 +1535,7 @@ function toChatCompletionMessages(messages) {
   });
 }
 
-// src/provider/responsesAdapter.ts
-var responsesAdapter = {
-  wireApi: "responses",
-  async fetchStreaming(client, request) {
-    const startedAt = Date.now();
-    let usage;
-    throwIfAborted(request.abortSignal, "Streaming request aborted");
-    try {
-      const stream = await client.responses.create(
-        {
-          ...buildResponsesRequestBody(request),
-          stream: true
-        },
-        {
-          signal: request.abortSignal
-        }
-      );
-      if (request.abortSignal?.aborted) {
-        abortStream2(stream);
-        throw createAbortError("Streaming aborted");
-      }
-      let content = "";
-      let reasoningContent = "";
-      const toolCalls = /* @__PURE__ */ new Map();
-      for await (const event of stream) {
-        if (request.abortSignal?.aborted) {
-          abortStream2(stream);
-          throw createAbortError("Streaming aborted");
-        }
-        usage = normalizeProviderUsage(event.response?.usage) ?? usage;
-        if (event.type === "response.output_text.delta" && typeof event.delta === "string") {
-          content += event.delta;
-          request.callbacks?.onAssistantDelta?.(event.delta);
-          continue;
-        }
-        if ((event.type === "response.reasoning_text.delta" || event.type === "response.reasoning_summary_text.delta") && typeof event.delta === "string") {
-          reasoningContent += event.delta;
-          request.callbacks?.onReasoningDelta?.(event.delta);
-          continue;
-        }
-        if (event.type === "response.function_call_arguments.delta" && typeof event.delta === "string") {
-          const index = typeof event.output_index === "number" ? event.output_index : 0;
-          const existing = toolCalls.get(index) ?? {
-            id: event.item_id ?? `tool-${index}`,
-            name: "",
-            arguments: ""
-          };
-          existing.arguments += event.delta;
-          toolCalls.set(index, existing);
-          continue;
-        }
-        if (event.type === "response.function_call_arguments.done") {
-          const index = typeof event.output_index === "number" ? event.output_index : 0;
-          const existing = toolCalls.get(index) ?? {
-            id: event.item_id ?? `tool-${index}`,
-            name: "",
-            arguments: ""
-          };
-          if (typeof event.name === "string") {
-            existing.name = event.name;
-          }
-          if (typeof event.arguments === "string" && event.arguments.length > 0) {
-            existing.arguments = event.arguments;
-          }
-          toolCalls.set(index, existing);
-          continue;
-        }
-        if (event.type === "response.output_item.done" && event.item?.type === "function_call") {
-          const index = typeof event.output_index === "number" ? event.output_index : 0;
-          toolCalls.set(index, {
-            id: event.item.call_id ?? event.item.id ?? `tool-${index}`,
-            name: event.item.name ?? "",
-            arguments: event.item.arguments ?? ""
-          });
-        }
-      }
-      return {
-        content: content.length > 0 ? content : null,
-        reasoningContent: reasoningContent.length > 0 ? reasoningContent : void 0,
-        streamedAssistantContent: content.length > 0,
-        streamedReasoningContent: reasoningContent.length > 0,
-        toolCalls: [...toolCalls.entries()].sort((left, right) => left[0] - right[0]).map(([, toolCall]) => ({
-          id: toolCall.id,
-          type: "function",
-          function: {
-            name: toolCall.name,
-            arguments: toolCall.arguments
-          }
-        }))
-      };
-    } finally {
-      request.onRequestMetric?.({
-        durationMs: Date.now() - startedAt,
-        usage
-      });
-    }
-  },
-  async fetchNonStreaming(client, request) {
-    const startedAt = Date.now();
-    let usage;
-    throwIfAborted(request.abortSignal, "Request aborted");
-    try {
-      const response = await client.responses.create(
-        {
-          ...buildResponsesRequestBody(request),
-          stream: false
-        },
-        {
-          signal: request.abortSignal
-        }
-      );
-      usage = normalizeProviderUsage(response.usage);
-      return {
-        content: normalizeOutputText(response),
-        reasoningContent: readResponseReasoning(response),
-        streamedAssistantContent: false,
-        streamedReasoningContent: false,
-        toolCalls: readResponseToolCalls(response)
-      };
-    } finally {
-      request.onRequestMetric?.({
-        durationMs: Date.now() - startedAt,
-        usage
-      });
-    }
-  }
-};
+// src/provider/responsesRequest.ts
 function buildResponsesRequestBody(request) {
   const capabilities = resolveProviderCapabilities({
     provider: request.provider,
@@ -1745,7 +1619,9 @@ function toResponsesInput(messages) {
   }
   return items;
 }
-function normalizeOutputText(response) {
+
+// src/provider/responsesResponse.ts
+function normalizeResponsesOutputText(response) {
   const outputText = response.output_text;
   if (typeof outputText === "string" && outputText.trim().length > 0) {
     return outputText;
@@ -1771,7 +1647,7 @@ function normalizeOutputText(response) {
   });
   return fragments.length > 0 ? fragments.join("") : null;
 }
-function readResponseToolCalls(response) {
+function readResponsesToolCalls(response) {
   const output = response.output;
   if (!Array.isArray(output)) {
     return [];
@@ -1785,7 +1661,7 @@ function readResponseToolCalls(response) {
     }
   }));
 }
-function readResponseReasoning(response) {
+function readResponsesReasoning(response) {
   const output = response.output;
   if (!Array.isArray(output)) {
     return void 0;
@@ -1801,6 +1677,134 @@ function readResponseReasoning(response) {
   });
   return fragments.length > 0 ? fragments.join("") : void 0;
 }
+
+// src/provider/responsesAdapter.ts
+var responsesAdapter = {
+  wireApi: "responses",
+  async fetchStreaming(client, request) {
+    const startedAt = Date.now();
+    let usage;
+    throwIfAborted(request.abortSignal, "Streaming request aborted");
+    try {
+      const stream = await client.responses.create(
+        {
+          ...buildResponsesRequestBody(request),
+          stream: true
+        },
+        {
+          signal: request.abortSignal
+        }
+      );
+      if (request.abortSignal?.aborted) {
+        abortStream2(stream);
+        throw createAbortError("Streaming aborted");
+      }
+      let content = "";
+      let reasoningContent = "";
+      const toolCalls = /* @__PURE__ */ new Map();
+      for await (const event of stream) {
+        if (request.abortSignal?.aborted) {
+          abortStream2(stream);
+          throw createAbortError("Streaming aborted");
+        }
+        usage = normalizeProviderUsage(event.response?.usage) ?? usage;
+        if (event.type === "response.output_text.delta" && typeof event.delta === "string") {
+          content += event.delta;
+          request.callbacks?.onAssistantDelta?.(event.delta);
+          continue;
+        }
+        if ((event.type === "response.reasoning_text.delta" || event.type === "response.reasoning_summary_text.delta") && typeof event.delta === "string") {
+          reasoningContent += event.delta;
+          request.callbacks?.onReasoningDelta?.(event.delta);
+          continue;
+        }
+        if (event.type === "response.function_call_arguments.delta" && typeof event.delta === "string") {
+          const index = typeof event.output_index === "number" ? event.output_index : 0;
+          const existing = toolCalls.get(index) ?? {
+            id: event.item_id ?? `tool-${index}`,
+            name: "",
+            arguments: ""
+          };
+          existing.arguments += event.delta;
+          toolCalls.set(index, existing);
+          continue;
+        }
+        if (event.type === "response.function_call_arguments.done") {
+          const index = typeof event.output_index === "number" ? event.output_index : 0;
+          const existing = toolCalls.get(index) ?? {
+            id: event.item_id ?? `tool-${index}`,
+            name: "",
+            arguments: ""
+          };
+          if (typeof event.name === "string") {
+            existing.name = event.name;
+          }
+          if (typeof event.arguments === "string" && event.arguments.length > 0) {
+            existing.arguments = event.arguments;
+          }
+          toolCalls.set(index, existing);
+          continue;
+        }
+        if (event.type === "response.output_item.done" && event.item?.type === "function_call") {
+          const index = typeof event.output_index === "number" ? event.output_index : 0;
+          toolCalls.set(index, {
+            id: event.item.call_id ?? event.item.id ?? `tool-${index}`,
+            name: event.item.name ?? "",
+            arguments: event.item.arguments ?? ""
+          });
+        }
+      }
+      return {
+        content: content.length > 0 ? content : null,
+        reasoningContent: reasoningContent.length > 0 ? reasoningContent : void 0,
+        streamedAssistantContent: content.length > 0,
+        streamedReasoningContent: reasoningContent.length > 0,
+        toolCalls: [...toolCalls.entries()].sort((left, right) => left[0] - right[0]).map(([, toolCall]) => ({
+          id: toolCall.id,
+          type: "function",
+          function: {
+            name: toolCall.name,
+            arguments: toolCall.arguments
+          }
+        }))
+      };
+    } finally {
+      request.onRequestMetric?.({
+        durationMs: Date.now() - startedAt,
+        usage
+      });
+    }
+  },
+  async fetchNonStreaming(client, request) {
+    const startedAt = Date.now();
+    let usage;
+    throwIfAborted(request.abortSignal, "Request aborted");
+    try {
+      const response = await client.responses.create(
+        {
+          ...buildResponsesRequestBody(request),
+          stream: false
+        },
+        {
+          signal: request.abortSignal
+        }
+      );
+      usage = normalizeProviderUsage(response.usage);
+      return {
+        content: normalizeResponsesOutputText(response),
+        reasoningContent: readResponsesReasoning(response),
+        streamedAssistantContent: false,
+        streamedReasoningContent: false,
+        toolCalls: readResponsesToolCalls(response)
+      };
+    } finally {
+      request.onRequestMetric?.({
+        durationMs: Date.now() - startedAt,
+        usage
+      });
+    }
+  }
+};
 function abortStream2(stream) {
   try {
     stream?.controller?.abort();
@@ -2254,25 +2258,25 @@ function buildSessionConversationBriefBlock(brief) {
   if (!brief?.modelSummary) {
     return void 0;
   }
-  return buildFieldBlock("Internal continuity state", [
+  return buildFieldBlock("Conversation continuity evidence", [
     {
       label: "Purpose",
       value: "Use these facts as private continuity state. Answer the current request directly. Quote prior turns only when the user asks."
     },
     brief.modelSummary ? {
-      label: "Session memory",
+      label: "Model-written session memory",
       value: brief.modelSummary
-    } : { label: "Session memory", value: void 0 },
+    } : { label: "Model-written session memory", value: void 0 },
     brief.modelSummaryUpdatedAt ? {
-      label: "Memory updated at",
+      label: "Updated",
       value: brief.modelSummaryUpdatedAt
-    } : { label: "Memory updated at", value: void 0 },
+    } : { label: "Updated", value: void 0 },
     {
-      label: "Visible turns",
+      label: "Near-field visible turns",
       value: `${brief.userTurnCount} user turn(s) with current input / ${brief.assistantTurnCount} assistant response(s)`
     },
     {
-      label: "Tool activity",
+      label: "Recent tool activity",
       value: formatSignals(brief.toolActivity)
     }
   ]);
@@ -2400,7 +2404,7 @@ function buildHistoryBoundaryBlock(memory) {
   return buildFieldBlock("History boundary", [
     {
       label: "Policy",
-      value: "Raw session history stays out of the current request. Internal continuity state and current workset are automatic facts for judgment, not text to narrate."
+      value: "Raw session history stays out of the current request. Conversation continuity evidence and current workset are automatic facts for judgment, not text to narrate."
     }
   ]);
 }
@@ -2643,6 +2647,10 @@ function buildTaskLifecyclePromptBlock(lifecycle) {
     return void 0;
   }
   const fields = [
+    {
+      label: "Purpose",
+      value: "Current task-state evidence. Use it to orient the next action; do not treat it as a new user request."
+    },
     { label: "Stage", value: lifecycle.stage },
     lifecycle.scope ? { label: "Scope", value: lifecycle.scope } : void 0,
     lifecycle.boundary ? { label: "Boundary", value: lifecycle.boundary } : void 0,
@@ -2653,14 +2661,14 @@ function buildTaskLifecyclePromptBlock(lifecycle) {
     lifecycle.completionFacts.length > 0 ? { label: "Completion facts", value: formatLimitedList(lifecycle.completionFacts, 4) } : void 0,
     { label: "Updated", value: lifecycle.updatedAt }
   ];
-  return buildFieldBlock("Task lifecycle", fields.filter((field) => Boolean(field)));
+  return buildFieldBlock("Current task scene evidence", fields.filter((field) => Boolean(field)));
 }
 function buildProjectMapPromptBlock(projectMap) {
   if (!projectMap) {
     return void 0;
   }
   const fields = [
-    { label: "Purpose", value: "Machine facts for orientation. Use as evidence, not as a route command." },
+    { label: "Purpose", value: "Project orientation evidence. Use as facts for the current turn; do not treat this block as a task route." },
     { label: "Root", value: projectMap.rootDir },
     { label: "Top-level dirs", value: formatLimitedList(projectMap.topLevelDirectories, 10) },
     { label: "Entries", value: formatLimitedList(projectMap.entryFiles, 8) },
@@ -2674,7 +2682,7 @@ function buildProjectMapPromptBlock(projectMap) {
     projectMap.git.recentChanges.length > 0 ? { label: "Recent changes", value: formatLimitedList(projectMap.git.recentChanges, 6) } : void 0,
     { label: "Updated", value: projectMap.updatedAt }
   ];
-  return buildFieldBlock("Project map", fields.filter((field) => Boolean(field)));
+  return buildFieldBlock("Project orientation evidence", fields.filter((field) => Boolean(field)));
 }
 
 // src/agent/prompt/metrics.ts
@@ -5117,7 +5125,7 @@ function pathDepth(relativePath) {
   return relativePath.split("/").filter(Boolean).length;
 }
 
-// src/tools/outputKernel/classifier.ts
+// src/tools/outputGovernance/classifier.ts
 function classifyToolOutput(source) {
   const output = source.output.trim();
   if (!output) {
@@ -5158,7 +5166,7 @@ function looksLikeBuild(command, text) {
   return /\b(build|compile|cargo check|cargo clippy|npm run build|pnpm build)\b/.test(command) || /\b(compilation failed|build failed|compiled successfully|error\[e\d+\])\b/.test(text);
 }
 
-// src/tools/outputKernel/metrics.ts
+// src/tools/outputGovernance/metrics.ts
 function estimateTextTokens(value) {
   const trimmed = value.trim();
   if (!trimmed) {
@@ -5183,7 +5191,7 @@ function computeSavings(input) {
   };
 }
 
-// src/tools/outputKernel/projectors/shared.ts
+// src/tools/outputGovernance/projectors/shared.ts
 function buildHeader(source, label) {
   return [
     `${source.toolName}: ${label}`,
@@ -5209,7 +5217,7 @@ function dedupeProjectedLines(lines) {
   return result;
 }
 
-// src/tools/outputKernel/projectors/diagnostic.ts
+// src/tools/outputGovernance/projectors/diagnostic.ts
 var STRUCTURED_MAX_LINES = 28;
 function buildDiagnosticProjection(source, label) {
   const lines = splitOutputLines(source.output);
@@ -5228,7 +5236,7 @@ function isSummaryLine(line) {
   return /\b(\d+\s+(passed|failed|skipped|errors?|warnings?)|test result|found \d+ errors?|failed tests?|build failed|compiled successfully)\b/i.test(line);
 }
 
-// src/tools/outputKernel/projectors/gitDiff.ts
+// src/tools/outputGovernance/projectors/gitDiff.ts
 var DIFF_MAX_FILES = 24;
 function buildGitDiffProjection(source) {
   const lines = splitOutputLines(source.output);
@@ -5243,7 +5251,7 @@ function buildGitDiffProjection(source) {
   ].filter((line) => Boolean(line)).join("\n");
 }
 
-// src/tools/outputKernel/projectors/generic.ts
+// src/tools/outputGovernance/projectors/generic.ts
 var GENERIC_MAX_CHARS = 1500;
 function projectEmptyOutput(source) {
   return {
@@ -5285,7 +5293,7 @@ function buildGenericPreview(source) {
   ].filter(Boolean).join("\n");
 }
 
-// src/tools/outputKernel/projectors/search.ts
+// src/tools/outputGovernance/projectors/search.ts
 var SEARCH_MAX_MATCHES = 24;
 function buildSearchProjection(source) {
   const nonEmptyLines = splitOutputLines(source.output).filter((line) => line.trim().length > 0);
@@ -5298,7 +5306,7 @@ function buildSearchProjection(source) {
   ].join("\n");
 }
 
-// src/tools/outputKernel/projectors/recovery.ts
+// src/tools/outputGovernance/projectors/recovery.ts
 function appendRecoveryHint(projection, governance) {
   if (!governance.recoveryHint) {
     return projection;
@@ -5310,7 +5318,7 @@ function appendRecoveryHint(projection, governance) {
 ${governance.recoveryHint}`;
 }
 
-// src/tools/outputKernel/projectors.ts
+// src/tools/outputGovernance/projectors.ts
 function projectOutputByKind(kind, source) {
   switch (kind) {
     case "empty":
@@ -5330,7 +5338,7 @@ function projectOutputByKind(kind, source) {
   }
 }
 
-// src/tools/outputKernel/index.ts
+// src/tools/outputGovernance/index.ts
 function governToolOutput(source) {
   const kind = classifyToolOutput(source);
   const projected = projectOutputByKind(kind, source);
@@ -10156,6 +10164,53 @@ function looksLikeToolProtocolText(content) {
   return text.includes("<\uFF5C\uFF5CDSML\uFF5C\uFF5Ctool_calls>") || text.includes("<tool_call>") || text.includes('"tool_calls"');
 }
 
+// src/host/delegatedCloseout.ts
+async function completeExactDelegatedCloseout(input) {
+  const answer = resolveExactDelegatedAnswer(input.executions);
+  if (!answer) {
+    return void 0;
+  }
+  const transition = createFinalizeTransition({
+    changedPaths: []
+  });
+  const sessionWithAnswer = await input.sessionStore.appendMessages(input.session, [
+    createMessage("assistant", answer)
+  ]);
+  const session = await input.sessionStore.save(noteCheckpointCompleted(sessionWithAnswer, transition));
+  const ledger = new ControlPlaneLedger(input.stateRootDir);
+  try {
+    ledger.taskLifecycle.complete({
+      sessionId: session.id,
+      reason: "finalize.delegated_exact_output",
+      completionFacts: [answer]
+    });
+  } finally {
+    ledger.close();
+  }
+  input.callbacks?.onAssistantText?.(answer);
+  input.callbacks?.onAssistantDone?.(answer);
+  return buildRunTurnResult({
+    session,
+    changedPaths: [],
+    transition
+  });
+}
+function resolveExactDelegatedAnswer(executions) {
+  if (executions.length !== 1) {
+    return void 0;
+  }
+  const [execution] = executions;
+  if (!execution || execution.status !== "completed") {
+    return void 0;
+  }
+  const expected = execution.assignment?.expectedOutput?.trim();
+  const output = execution.output?.trim();
+  if (!expected || !output || expected !== output) {
+    return void 0;
+  }
+  return output;
+}
+
 // src/observability/crashRecorder.ts
 import fs24 from "fs";
 import path26 from "path";
@@ -10432,51 +10487,6 @@ async function runHostTurn(options, dependencies = {}) {
     await toolRegistry?.close?.().catch(() => void 0);
   }
 }
-async function completeExactDelegatedCloseout(input) {
-  const answer = resolveExactDelegatedAnswer(input.executions);
-  if (!answer) {
-    return void 0;
-  }
-  const transition = createFinalizeTransition({
-    changedPaths: []
-  });
-  const sessionWithAnswer = await input.sessionStore.appendMessages(input.session, [
-    createMessage("assistant", answer)
-  ]);
-  const session = await input.sessionStore.save(noteCheckpointCompleted(sessionWithAnswer, transition));
-  const ledger = new ControlPlaneLedger(input.stateRootDir);
-  try {
-    ledger.taskLifecycle.complete({
-      sessionId: session.id,
-      reason: "finalize.delegated_exact_output",
-      completionFacts: [answer]
-    });
-  } finally {
-    ledger.close();
-  }
-  input.callbacks?.onAssistantText?.(answer);
-  input.callbacks?.onAssistantDone?.(answer);
-  return buildRunTurnResult({
-    session,
-    changedPaths: [],
-    transition
-  });
-}
-function resolveExactDelegatedAnswer(executions) {
-  if (executions.length !== 1) {
-    return void 0;
-  }
-  const [execution] = executions;
-  if (!execution || execution.status !== "completed") {
-    return void 0;
-  }
-  const expected = execution.assignment?.expectedOutput?.trim();
-  const output = execution.output?.trim();
-  if (!expected || !output || expected !== output) {
-    return void 0;
-  }
-  return output;
-}
 function createToollessRegistry(registry) {
   return {
     ...registry,