@downcity/agent 1.1.63 → 1.1.66

package/bin/types/sdk/AgentSessionEvent.d.ts

@@ -133,6 +133,27 @@ export interface AgentSessionAssistantStepEvent {
      */
     visibility?: SessionAssistantStepVisibility;
 }
+/**
+ * Session 标题更新事件。
+ */
+export interface AgentSessionTitleEvent {
+    /**
+     * 当前事件类型。
+     */
+    type: "session-title";
+    /**
+     * 当前 session 唯一标识。
+     */
+    sessionId: string;
+    /**
+     * 当前 session 最新标题。
+     *
+     * 说明（中文）
+     * - 标题已持久化到 session meta。
+     * - 新 session 通常在首条 user message 落盘后生成标题。
+     */
+    title: string;
+}
 /**
  * 单个 turn 完成事件。
  */
@@ -174,7 +195,7 @@ export interface AgentSessionErrorEvent {
 /**
  * Session 订阅可见事件联合类型。
  */
-export type AgentSessionEvent = AgentSessionTurnStartEvent | AgentSessionTextDeltaEvent | AgentSessionReasoningDeltaEvent | AgentSessionToolCallEvent | AgentSessionToolResultEvent | AgentSessionAssistantStepEvent | AgentSessionTurnFinishEvent | AgentSessionErrorEvent;
+export type AgentSessionEvent = AgentSessionTurnStartEvent | AgentSessionTextDeltaEvent | AgentSessionReasoningDeltaEvent | AgentSessionToolCallEvent | AgentSessionToolResultEvent | AgentSessionAssistantStepEvent | AgentSessionTitleEvent | AgentSessionTurnFinishEvent | AgentSessionErrorEvent;
 /**
  * Session 事件订阅回调。
  */

package/bin/types/sdk/AgentSessionEvent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentSessionEvent.d.ts","sourceRoot":"","sources":["../../../src/types/sdk/AgentSessionEvent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC;AAErF;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,IAAI,EAAE,YAAY,CAAC;IAEnB;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,IAAI,EAAE,YAAY,CAAC;IAEnB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C;;OAEG;IACH,IAAI,EAAE,iBAAiB,CAAC;IAExB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,IAAI,EAAE,WAAW,CAAC;IAElB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,EAAE,SAAS,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,IAAI,EAAE,aAAa,CAAC;IAEpB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,SAAS,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,IAAI,EAAE,gBAAgB,CAAC;IAEvB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,UAAU,CAAC,EAAE,8BAA8B,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,IAAI,EAAE,aAAa,CAAC;IAEpB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC;IAEd;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,0BAA0B,GAC1B,0BAA0B,GAC1B,+BAA+B,GAC/B,yBAAyB,GACzB,2BAA2B,GAC3B,8BAA8B,GAC9B,2BAA2B,GAC3B,sBAAsB,CAAC;AAE3B;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;AAExE;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,MAAM,IAAI,CAAC"}
+{"version":3,"file":"AgentSessionEvent.d.ts","sourceRoot":"","sources":["../../../src/types/sdk/AgentSessionEvent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC;AAErF;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,IAAI,EAAE,YAAY,CAAC;IAEnB;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,IAAI,EAAE,YAAY,CAAC;IAEnB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C;;OAEG;IACH,IAAI,EAAE,iBAAiB,CAAC;IAExB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,IAAI,EAAE,WAAW,CAAC;IAElB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,EAAE,SAAS,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,IAAI,EAAE,aAAa,CAAC;IAEpB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,SAAS,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,IAAI,EAAE,gBAAgB,CAAC;IAEvB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,UAAU,CAAC,EAAE,8BAA8B,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,IAAI,EAAE,eAAe,CAAC;IAEtB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;;;;OAMG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,IAAI,EAAE,aAAa,CAAC;IAEpB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC;IAEd;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,0BAA0B,GAC1B,0BAA0B,GAC1B,+BAA+B,GAC/B,yBAAyB,GACzB,2BAA2B,GAC3B,8BAA8B,GAC9B,sBAAsB,GACtB,2BAA2B,GAC3B,sBAAsB,CAAC;AAE3B;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;AAExE;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,MAAM,IAAI,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@downcity/agent",
-  "version": "1.1.63",
+  "version": "1.1.66",
   "type": "module",
   "description": "Downcity Agent 运行时 — 单 Agent 执行壳与 HTTP 服务能力",
   "main": "./bin/index.js",
@@ -16,6 +16,7 @@
     }
   },
   "dependencies": {
+    "@ai-sdk/openai-compatible": "^2.0.48",
     "@larksuiteoapi/node-sdk": "^1.66.0",
     "ai": "^6.0.193",
     "commander": "^15.0.0",
@@ -28,7 +29,7 @@
     "node-cron": "^4.2.1",
     "ws": "^8.21.0",
     "zod": "^4.4.3",
-    "@downcity/type": "0.1.7"
+    "@downcity/type": "0.1.9"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",

package/scripts/city-model-tool-loop.test.mjs

@@ -1,9 +1,10 @@
 /**
- * @file 验证 CityModel 适配层会把本地 tool result 带回下一轮请求。
+ * @file 验证 CityModel 会优先走 OpenAI-compatible LanguageModel 并完成 tool loop。
  *
  * 关键点（中文）
  * - 这里直接走编译后的 Agent / City 产物，避免测试只覆盖源码级辅助函数。
- * - 重点锁住 CityModelAdapter 的 tool-call -> 本地执行 -> tool-result 回传链路。
+ * - 重点锁住 CityModel -> LanguageModel -> tool-call -> 本地执行 -> tool-result 回传链路。
+ * - 新路径不应再调用 `/v1/ai/stream`，避免 UIMessage stream 反向适配丢失 finish 语义。
  */
 
 import test from "node:test";
@@ -17,15 +18,15 @@ import { City } from "../../city/bin/index.js";
 import { tool } from "ai";
 import { z } from "zod";
 
-function write_sse(res, chunks) {
+function write_openai_sse(res, chunks) {
   res.writeHead(200, {
     "content-type": "text/event-stream; charset=utf-8",
     "cache-control": "no-cache",
     connection: "keep-alive",
-    "x-vercel-ai-ui-message-stream": "v1",
   });
   for (const chunk of chunks) {
-    res.write(`data: ${JSON.stringify(chunk)}\n\n`);
+    const payload = typeof chunk === "string" ? chunk : JSON.stringify(chunk);
+    res.write(`data: ${payload}\n\n`);
   }
   res.end();
 }
@@ -42,8 +43,10 @@ async function read_json_body(req) {
   return JSON.parse(String(raw || "{}"));
 }
 
-test("CityModel sends tool result back on the next round", async () => {
+test("CityModel uses direct LanguageModel path and sends tool result back", async () => {
   const requests = [];
+  const agent_requests = [];
+  let stream_requests = 0;
   let tool_executed = false;
 
   const server = http.createServer(async (req, res) => {
@@ -68,30 +71,149 @@ test("CityModel sends tool result back on the next round", async () => {
     }
 
     if (req.method === "POST" && url.pathname === "/v1/ai/stream") {
+      stream_requests += 1;
+      res.writeHead(500, { "content-type": "application/json" });
+      res.end(JSON.stringify({ error: "legacy stream endpoint should not be called" }));
+      return;
+    }
+
+    if (req.method === "POST" && url.pathname === "/v1/ai/chat/completions") {
       const body = await read_json_body(req);
       requests.push(body);
 
-      if (requests.length === 1) {
-        write_sse(res, [
-          { type: "start", messageId: "msg_1" },
-          { type: "tool-input-start", toolCallId: "call_1", toolName: "ping" },
+      if (!Array.isArray(body.tools)) {
+        write_openai_sse(res, [
+          {
+            id: "chatcmpl_title",
+            object: "chat.completion.chunk",
+            created: 1,
+            model: "mock-model",
+            choices: [
+              {
+                index: 0,
+                delta: { role: "assistant", content: "Tool loop" },
+                finish_reason: null,
+              },
+            ],
+          },
+          {
+            id: "chatcmpl_title",
+            object: "chat.completion.chunk",
+            created: 1,
+            model: "mock-model",
+            choices: [
+              {
+                index: 0,
+                delta: {},
+                finish_reason: "stop",
+              },
+            ],
+          },
+          "[DONE]",
+        ]);
+        return;
+      }
+
+      agent_requests.push(body);
+      if (agent_requests.length === 1) {
+        write_openai_sse(res, [
+          {
+            id: "chatcmpl_1",
+            object: "chat.completion.chunk",
+            created: 1,
+            model: "mock-model",
+            choices: [
+              {
+                index: 0,
+                delta: { role: "assistant" },
+                finish_reason: null,
+              },
+            ],
+          },
+          {
+            id: "chatcmpl_1",
+            object: "chat.completion.chunk",
+            created: 1,
+            model: "mock-model",
+            choices: [
+              {
+                index: 0,
+                delta: {
+                  tool_calls: [
+                    {
+                      index: 0,
+                      id: "call_1",
+                      type: "function",
+                      function: {
+                        name: "ping",
+                        arguments: "{\"value\":\"hello\"}",
+                      },
+                    },
+                  ],
+                },
+                finish_reason: null,
+              },
+            ],
+          },
           {
-            type: "tool-input-available",
-            toolCallId: "call_1",
-            toolName: "ping",
-            input: { value: "hello" },
+            id: "chatcmpl_1",
+            object: "chat.completion.chunk",
+            created: 1,
+            model: "mock-model",
+            choices: [
+              {
+                index: 0,
+                delta: {},
+                finish_reason: "tool_calls",
+              },
+            ],
           },
-          { type: "finish", finishReason: "tool-calls" },
+          "[DONE]",
         ]);
         return;
       }
 
-      write_sse(res, [
-        { type: "start", messageId: "msg_2" },
-        { type: "text-start", id: "text_2" },
-        { type: "text-delta", id: "text_2", delta: "done" },
-        { type: "text-end", id: "text_2" },
-        { type: "finish", finishReason: "stop" },
+      write_openai_sse(res, [
+        {
+          id: "chatcmpl_2",
+          object: "chat.completion.chunk",
+          created: 1,
+          model: "mock-model",
+          choices: [
+            {
+              index: 0,
+              delta: { role: "assistant" },
+              finish_reason: null,
+            },
+          ],
+        },
+        {
+          id: "chatcmpl_2",
+          object: "chat.completion.chunk",
+          created: 1,
+          model: "mock-model",
+          choices: [
+            {
+              index: 0,
+              delta: { content: "done" },
+              finish_reason: null,
+            },
+          ],
+        },
+        {
+          id: "chatcmpl_2",
+          object: "chat.completion.chunk",
+          created: 1,
+          model: "mock-model",
+          choices: [
+            {
+              index: 0,
+              delta: {},
+              finish_reason: "stop",
+            },
+          ],
+        },
+        "[DONE]",
       ]);
       return;
     }
@@ -142,31 +264,19 @@ test("CityModel sends tool result back on the next round", async () => {
 
     assert.equal(result.success, true);
     assert.equal(tool_executed, true);
-    assert.equal(requests.length, 2);
+    assert.equal(stream_requests, 0);
+    assert.equal(agent_requests.length, 2);
+    assert.equal(requests.every((request) => request?.town_id === "town_demo"), true);
+    assert.equal(agent_requests[0]?.model, "mock-model");
 
-    const second_request_messages = Array.isArray(requests[1]?.messages)
-      ? requests[1].messages
+    const second_request_messages = Array.isArray(agent_requests[1]?.messages)
+      ? agent_requests[1].messages
       : [];
-    const second_assistant_message = second_request_messages.find(
-      (message) => message && message.role === "assistant",
-    );
-    assert.ok(second_assistant_message);
-    const second_assistant_parts = Array.isArray(second_assistant_message.parts)
-      ? second_assistant_message.parts
-      : [];
-
-    const tool_call_part = second_assistant_parts.find(
-      (part) => part && part.type === "dynamic-tool" && part.state === "output-available",
-    );
-    assert.deepEqual(tool_call_part, {
-      type: "dynamic-tool",
-      toolName: "ping",
-      toolCallId: "call_1",
-      state: "output-available",
-      input: { value: "hello" },
-      output: { echoed: "hello" },
-      providerExecuted: false,
-    });
+    const serialized_second_messages = JSON.stringify(second_request_messages);
+    assert.match(serialized_second_messages, /"role":"tool"/);
+    assert.match(serialized_second_messages, /call_1/);
+    assert.match(serialized_second_messages, /echoed/);
+    assert.match(serialized_second_messages, /hello/);
   } finally {
     await new Promise((resolve, reject) => {
       server.close((error) => {

package/scripts/session-prompt-runtime.test.mjs

@@ -9,7 +9,7 @@
 import test from "node:test";
 import assert from "node:assert/strict";
 
-import { SessionPromptRuntime } from "../bin/sdk/session/runtime/SessionPromptRuntime.js";
+import { SessionPromptRuntime } from "../bin/session/runtime/SessionPromptRuntime.js";
 
 function createDeferred() {
   let resolve;

package/scripts/session-title-event.test.mjs

@@ -0,0 +1,51 @@
+/**
+ * @file 验证 Session 标题会进入 subscribe 事件与 history session 信息。
+ *
+ * 关键点（中文）
+ * - 这里走编译后的公开 SDK，锁住调用方实际可见行为。
+ * - 使用 appendUserMessage 触发 fallback 标题，避免测试依赖真实模型。
+ */
+
+import test from "node:test";
+import assert from "node:assert/strict";
+import os from "node:os";
+import path from "node:path";
+import fs from "node:fs/promises";
+
+import { Agent } from "../bin/index.js";
+
+test("Session publishes title event and exposes title in history", async () => {
+  const agent_path = await fs.mkdtemp(
+    path.join(os.tmpdir(), "downcity-agent-session-title-"),
+  );
+  const agent = new Agent({
+    id: "title_agent",
+    path: agent_path,
+  });
+  const session = await agent.createSession();
+  const events = [];
+  const unsubscribe = session.subscribe((event) => {
+    events.push(event);
+  });
+
+  try {
+    await session.appendUserMessage({
+      text: "Use shell tools to inspect the current workspace",
+    });
+
+    const title_event = events.find((event) => event.type === "session-title");
+    assert.deepEqual(title_event, {
+      type: "session-title",
+      sessionId: session.id,
+      title: "Use shell tools to inspect the current workspace",
+    });
+
+    const history = await session.history();
+    assert.equal(
+      history.session.title,
+      "Use shell tools to inspect the current workspace",
+    );
+  } finally {
+    unsubscribe();
+  }
+});